xls-codec 4.10.0 → 4.11.1

package/dist/index.js

@@ -15,11 +15,11 @@ import { decodeRkNumber } from "./biff/rk.js";
 import { readSheetRecords } from "./workbook/sheet.js";
 import { readXls, readXlsContent } from "./content.js";
 import { writeBofData } from "./biff/bof-writer.js";
-import { writeRichExtendedString, writeShortXLUnicodeString, writeXLUnicodeString } from "./biff/string-writer.js";
+import { writeRichExtendedString, writeShortXLUnicodeString, writeXLUnicodeString, writeXLUnicodeStringNoCch } from "./biff/string-writer.js";
 import { writeCellXfRecord, writeFontRecord, writeFormatRecord, writePaletteRecord, writeStyleRecord, writeStyleXfRecord } from "./biff/xf-writer.js";
 import { layoutMetadataToSummaryInformation } from "./metadata.js";
 import { GENERAL_CELL_XF_INDEX, buildWorkbookGlobals } from "./workbook/globals-writer.js";
 import { buildWorksheetSubstream } from "./workbook/sheet-writer.js";
 import { writeXls, writeXlsContent } from "./write.js";
 export * from "excel-number-format";
-export { BIFF8_VERSION, BOF_TYPE_CHART, BOF_TYPE_MACRO, BOF_TYPE_WORKBOOK, BOF_TYPE_WORKSHEET, BiffFormatError, BiffWriteError, BlockCursor, DEFAULT_COLUMN_WIDTH_CHARS, DEFAULT_ROW_HEIGHT_PT, GENERAL_CELL_XF_INDEX, HEADER_SIZE, MAX_RECORD_DATA_SIZE, RECORD_AI, RECORD_ARRAY, RECORD_BLANK, RECORD_BOF, RECORD_BOOLERR, RECORD_BOTTOMMARGIN, RECORD_BOUNDSHEET8, RECORD_CALCCOUNT, RECORD_CALCDELTA, RECORD_CALCITER, RECORD_CALCREFMODE, RECORD_CALCSAVERECALC, RECORD_CF, RECORD_CF12, RECORD_CFEX, RECORD_COLINFO, RECORD_CONDFMT, RECORD_CONDFMT12, RECORD_CONTINUE, RECORD_CONTINUEFRT12, RECORD_DATE1904, RECORD_DEFAULTROWHEIGHT, RECORD_DEFCOLWIDTH, RECORD_DIMENSIONS, RECORD_DV, RECORD_DVAL, RECORD_EOF, RECORD_EXTERNSHEET, RECORD_FILELOCK, RECORD_FILEPASS, RECORD_FONT, RECORD_FORMAT, RECORD_FORMULA, RECORD_HORIZONTALPAGEBREAKS, RECORD_INTERFACEHDR, RECORD_LABEL, RECORD_LABELSST, RECORD_LBL, RECORD_LEFTMARGIN, RECORD_MERGECELLS, RECORD_MSODRAWING, RECORD_MSODRAWINGGROUP, RECORD_MSODRAWINGSELECTION, RECORD_MULBLANK, RECORD_MULRK, RECORD_NOTE, RECORD_NUMBER, RECORD_OBJ, RECORD_PALETTE, RECORD_PRINTGRID, RECORD_PRINTROWCOL, RECORD_RIGHTMARGIN, RECORD_RK, RECORD_ROW, RECORD_RRDHEAD, RECORD_RRDINFO, RECORD_SERIES, RECORD_SERIESTEXT, RECORD_SETUP, RECORD_SHRFMLA, RECORD_SIINDEX, RECORD_SST, RECORD_STRING, RECORD_STYLE, RECORD_SUPBOOK, RECORD_TABLE, RECORD_TOPMARGIN, RECORD_TXO, RECORD_USREXCL, RECORD_VERTICALPAGEBREAKS, RECORD_WSBOOL, RECORD_XF, RecordBuilder, SUMMARY_INFORMATION_STREAM, buildWorkbookGlobals, buildWorksheetSubstream, columnWidthToPoints, concatRecords, decodeRkNumber, errorCodeOf, errorTextOf, formatCodeOf, groupRecords, inchesToPoints, isXlsFile, isoDateTimeToSerial, isoDateToSerial, isoTimeToSerial, layoutMetadataToSummaryInformation, millimetresToPoints, pointsToColumnWidth, pointsToInches, pointsToTwips, readRecords, readRichExtendedString, readSheetRecords, readShortXLUnicodeString, readWorkbookGlobals, readWorkbookStreams, readXLUnicodeString, readXLUnicodeStringNoCch, readXls, readXlsContent, recordByteLength, serialToIsoDate, serialToIsoDateTime, serialToIsoTime, splitSubstreams, twipsToPoints, writeBofData, writeCellXfRecord, writeFontRecord, writeFormatRecord, writePaletteRecord, writeRecord, writeRichExtendedString, writeShortXLUnicodeString, writeStyleRecord, writeStyleXfRecord, writeXLUnicodeString, writeXls, writeXlsContent };
+export { BIFF8_VERSION, BOF_TYPE_CHART, BOF_TYPE_MACRO, BOF_TYPE_WORKBOOK, BOF_TYPE_WORKSHEET, BiffFormatError, BiffWriteError, BlockCursor, DEFAULT_COLUMN_WIDTH_CHARS, DEFAULT_ROW_HEIGHT_PT, GENERAL_CELL_XF_INDEX, HEADER_SIZE, MAX_RECORD_DATA_SIZE, RECORD_AI, RECORD_ARRAY, RECORD_BLANK, RECORD_BOF, RECORD_BOOLERR, RECORD_BOTTOMMARGIN, RECORD_BOUNDSHEET8, RECORD_CALCCOUNT, RECORD_CALCDELTA, RECORD_CALCITER, RECORD_CALCREFMODE, RECORD_CALCSAVERECALC, RECORD_CF, RECORD_CF12, RECORD_CFEX, RECORD_COLINFO, RECORD_CONDFMT, RECORD_CONDFMT12, RECORD_CONTINUE, RECORD_CONTINUEFRT12, RECORD_DATE1904, RECORD_DEFAULTROWHEIGHT, RECORD_DEFCOLWIDTH, RECORD_DIMENSIONS, RECORD_DV, RECORD_DVAL, RECORD_EOF, RECORD_EXTERNSHEET, RECORD_FILELOCK, RECORD_FILEPASS, RECORD_FONT, RECORD_FORMAT, RECORD_FORMULA, RECORD_HORIZONTALPAGEBREAKS, RECORD_INTERFACEHDR, RECORD_LABEL, RECORD_LABELSST, RECORD_LBL, RECORD_LEFTMARGIN, RECORD_MERGECELLS, RECORD_MSODRAWING, RECORD_MSODRAWINGGROUP, RECORD_MSODRAWINGSELECTION, RECORD_MULBLANK, RECORD_MULRK, RECORD_NOTE, RECORD_NUMBER, RECORD_OBJ, RECORD_PALETTE, RECORD_PRINTGRID, RECORD_PRINTROWCOL, RECORD_RIGHTMARGIN, RECORD_RK, RECORD_ROW, RECORD_RRDHEAD, RECORD_RRDINFO, RECORD_SERIES, RECORD_SERIESTEXT, RECORD_SETUP, RECORD_SHRFMLA, RECORD_SIINDEX, RECORD_SST, RECORD_STRING, RECORD_STYLE, RECORD_SUPBOOK, RECORD_TABLE, RECORD_TOPMARGIN, RECORD_TXO, RECORD_USREXCL, RECORD_VERTICALPAGEBREAKS, RECORD_WSBOOL, RECORD_XF, RecordBuilder, SUMMARY_INFORMATION_STREAM, buildWorkbookGlobals, buildWorksheetSubstream, columnWidthToPoints, concatRecords, decodeRkNumber, errorCodeOf, errorTextOf, formatCodeOf, groupRecords, inchesToPoints, isXlsFile, isoDateTimeToSerial, isoDateToSerial, isoTimeToSerial, layoutMetadataToSummaryInformation, millimetresToPoints, pointsToColumnWidth, pointsToInches, pointsToTwips, readRecords, readRichExtendedString, readSheetRecords, readShortXLUnicodeString, readWorkbookGlobals, readWorkbookStreams, readXLUnicodeString, readXLUnicodeStringNoCch, readXls, readXlsContent, recordByteLength, serialToIsoDate, serialToIsoDateTime, serialToIsoTime, splitSubstreams, twipsToPoints, writeBofData, writeCellXfRecord, writeFontRecord, writeFormatRecord, writePaletteRecord, writeRecord, writeRichExtendedString, writeShortXLUnicodeString, writeStyleRecord, writeStyleXfRecord, writeXLUnicodeString, writeXLUnicodeStringNoCch, writeXls, writeXlsContent };

package/dist/workbook/comment-writer.cjs

@@ -0,0 +1,75 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+require("../biff/record-types.cjs");
+const require_biff_write_errors = require("../biff/write-errors.cjs");
+const require_biff_builder = require("../biff/builder.cjs");
+const require_biff_record_writer = require("../biff/record-writer.cjs");
+const require_biff_string_writer = require("../biff/string-writer.cjs");
+//#region src/workbook/comment-writer.ts
+/** [MS-XLS] 2.5.213 ObjId: the drawing-object type a comment's Obj record names -- workbook/comments.ts's own OBJECT_TYPE_NOTE, restated here since the two modules read/write the identical constant independently rather than sharing an import across the read/write boundary (matching this package's existing convention of one module per direction). */
+const OBJECT_TYPE_NOTE = 25;
+const FTCMO_FT = 21;
+const FTCMO_CB = 18;
+const FTNTS_FT = 13;
+const FTNTS_CB = 22;
+/** FtCmo ([MS-XLS] 2.5.92, 22 bytes): the common properties every Obj record opens with. Every flag bit beyond ot/id is either a UI concern (locked, default size, printed) this writer has no data for, or explicitly reserved -- so grbit and the three trailing "unused" fields are all written zero. */
+function writeFtCmo(objId) {
+	return new require_biff_builder.RecordBuilder().u16(FTCMO_FT).u16(FTCMO_CB).u16(OBJECT_TYPE_NOTE).u16(objId).u16(0).u32(0).u32(0).u32(0).build();
+}
+/** A pseudo-random 16-byte GUID for FtNts's own comment identifier -- [MS-XLS] requires the field to be present and does not require it to be globally unique across files, only present, so a fresh random value per comment (rather than a fixed or zero one) is what a real producer's own GUID allocation looks like without this package needing a GUID-formatting dependency. Worker-isomorphic: globalThis.crypto is available in both Node and a Cloudflare Workers isolate, unlike Node's own node:crypto module. */
+function randomGuidBytes() {
+	const bytes = /* @__PURE__ */ new Uint8Array(16);
+	globalThis.crypto.getRandomValues(bytes);
+	return bytes;
+}
+/** FtNts ([MS-XLS] 2.5.163... 2.5.b0991167, 26 bytes): the note-specific properties following FtCmo in a comment's own Obj record. fSharedNote is always written clear -- this writer has no shared-comment concept to express. */
+function writeFtNts() {
+	return new require_biff_builder.RecordBuilder().u16(FTNTS_FT).u16(FTNTS_CB).bytes(randomGuidBytes()).u16(0).u32(0).build();
+}
+/** Obj ([MS-XLS] 2.4.181) for a Note-type object: FtCmo, then FtNts (present if and only if cmo.ot is 0x19, which this writer's OBJECT_TYPE_NOTE always is), then the mandatory trailing 4-byte reserved field every Obj not naming a list-box/dropdown object (ot 0x12/0x14) carries. */
+function writeObjRecordForNote(objId) {
+	const data = new require_biff_builder.RecordBuilder().bytes(writeFtCmo(objId)).bytes(writeFtNts()).u32(0).build();
+	return require_biff_record_writer.writeRecord(93, data);
+}
+/** TxORuns' own minimal shape for plain, unformatted text ([MS-XLS] 2.5.31cd7d1e/d738ffef/6fb4c0e3): one Run (an all-default FormatRun -- ich 0, ifnt 0 -- plus its own six reserved bytes) followed by the mandatory TxOLastRun sentinel naming cchText again. 16 bytes total, the minimum [MS-XLS]'s own "cbRuns MUST be >= 16 and a multiple of 8" rule allows -- this writer never carries real per-character formatting for a comment's text (workbook/comments.ts's own read side does not model TxORuns either, for the identical reason). */
+function writeMinimalTxoRuns(cchText) {
+	return new require_biff_builder.RecordBuilder().u16(0).u16(0).u16(0).u16(0).u16(cchText).u16(0).u32(0).build();
+}
+/** TxO ([MS-XLS] 2.4.329) plus the one Continue record carrying its text and formatting-run trailer -- see this module's own top comment for why both text and runs can share a single Continue rather than needing one each. cchText is 0 for an empty comment, in which case [MS-XLS] itself requires cbRuns to be 0 too and no Continue record follows at all. */
+function writeTxoRecords(text) {
+	const cchText = text.length;
+	const cbRuns = cchText === 0 ? 0 : 16;
+	const txoData = new require_biff_builder.RecordBuilder().u16(18).u16(0).u16(0).u32(0).u16(cchText).u16(cbRuns).u16(0).u16(0).build();
+	const txo = require_biff_record_writer.writeRecord(438, txoData);
+	if (cchText === 0) return [txo];
+	const continueData = new require_biff_builder.RecordBuilder().bytes(require_biff_string_writer.writeXLUnicodeStringNoCch(text)).bytes(writeMinimalTxoRuns(cchText)).build();
+	return [txo, require_biff_record_writer.writeRecord(60, continueData)];
+}
+/**
+* Note ([MS-XLS] 2.4.179, wrapping a NoteSh structure): the comment's own cell anchor and author, naming the Obj record that carries its text through idObj. fShow/fRwHidden/fColHidden are always written clear -- this writer tracks none of the on-screen display state they carry.
+*
+* A comment with no recorded author writes stAuthor as an empty string, rather than a non-empty placeholder -- [MS-XLS] 2.5.163 itself documents stAuthor's own length as "MUST be greater than or equal to 1", but this reader (workbook/comments.ts's own readNoteAnchor) only ever promotes a NON-empty stAuthor to ContentSheetCellComment.author, meaning a placeholder would round-trip back as a fabricated author nobody wrote. An empty string is the one spelling that round-trips through this reader as "no author", matching every other lossless-round-trip choice this writer makes in favour of what its own reader reads back over strict textual conformance to a field length rule real producers routinely leave unenforced anyway.
+*/
+function writeNoteRecord(cell, objId) {
+	const data = new require_biff_builder.RecordBuilder().u16(cell.row).u16(cell.column).u16(0).u16(objId).bytes(require_biff_string_writer.writeXLUnicodeString(cell.comment?.author ?? "")).u8(0).build();
+	return require_biff_record_writer.writeRecord(28, data);
+}
+const MAX_OBJECT_ID = 65535;
+/**
+* Every Note/Obj/TxO record a sheet's own commented cells need, in the order described above -- for `cells` already filtered to exactly those carrying a `comment` (workbook/sheet-writer.ts's own caller does the filtering, since only it knows the sheet's full cell list).
+*
+* Object ids are assigned sequentially from 1: [MS-XLS] 2.5.92's own FtCmo.id must be unique "among all Obj records within ... Worksheet Substream ABNF", and this writer never emits any other kind of Obj record (no shapes, charts, or form controls yet -- see this package's README), so a per-sheet counter starting at 1 is already unique on its own.
+*/
+function writeSheetComments(commentedCells) {
+	if (commentedCells.length > MAX_OBJECT_ID) throw new require_biff_write_errors.BiffWriteError(`sheet carries ${commentedCells.length} cell comments, more than the ${MAX_OBJECT_ID} distinct object ids [MS-XLS] 2.5.92's own 16-bit FtCmo.id field can hold`);
+	const ordered = [...commentedCells].sort((a, b) => a.row !== b.row ? a.row - b.row : a.column - b.column);
+	const pieces = ordered.map((cell, index) => writeNoteRecord(cell, index + 1));
+	ordered.forEach((cell, index) => {
+		const objId = index + 1;
+		const comment = cell.comment;
+		if (comment === void 0) throw new require_biff_write_errors.BiffWriteError(`internal error: writeSheetComments was called with a cell at row ${cell.row}, column ${cell.column} carrying no comment`);
+		pieces.push(writeObjRecordForNote(objId), ...writeTxoRecords(comment.text));
+	});
+	return pieces;
+}
+//#endregion
+exports.writeSheetComments = writeSheetComments;

package/dist/workbook/comment-writer.d.cts

@@ -0,0 +1,10 @@
+import { ContentSheetCell } from "document-schema.js";
+//#region src/workbook/comment-writer.d.ts
+/**
+ * Every Note/Obj/TxO record a sheet's own commented cells need, in the order described above -- for `cells` already filtered to exactly those carrying a `comment` (workbook/sheet-writer.ts's own caller does the filtering, since only it knows the sheet's full cell list).
+ *
+ * Object ids are assigned sequentially from 1: [MS-XLS] 2.5.92's own FtCmo.id must be unique "among all Obj records within ... Worksheet Substream ABNF", and this writer never emits any other kind of Obj record (no shapes, charts, or form controls yet -- see this package's README), so a per-sheet counter starting at 1 is already unique on its own.
+ */
+declare function writeSheetComments(commentedCells: readonly ContentSheetCell[]): Uint8Array<ArrayBuffer>[];
+//#endregion
+export { writeSheetComments };

package/dist/workbook/comment-writer.d.ts

@@ -0,0 +1,10 @@
+import { ContentSheetCell } from "document-schema.js";
+//#region src/workbook/comment-writer.d.ts
+/**
+ * Every Note/Obj/TxO record a sheet's own commented cells need, in the order described above -- for `cells` already filtered to exactly those carrying a `comment` (workbook/sheet-writer.ts's own caller does the filtering, since only it knows the sheet's full cell list).
+ *
+ * Object ids are assigned sequentially from 1: [MS-XLS] 2.5.92's own FtCmo.id must be unique "among all Obj records within ... Worksheet Substream ABNF", and this writer never emits any other kind of Obj record (no shapes, charts, or form controls yet -- see this package's README), so a per-sheet counter starting at 1 is already unique on its own.
+ */
+declare function writeSheetComments(commentedCells: readonly ContentSheetCell[]): Uint8Array<ArrayBuffer>[];
+//#endregion
+export { writeSheetComments };

package/dist/workbook/comment-writer.js

@@ -0,0 +1,74 @@
+import "../biff/record-types.js";
+import { BiffWriteError } from "../biff/write-errors.js";
+import { RecordBuilder } from "../biff/builder.js";
+import { writeRecord } from "../biff/record-writer.js";
+import { writeXLUnicodeString, writeXLUnicodeStringNoCch } from "../biff/string-writer.js";
+//#region src/workbook/comment-writer.ts
+/** [MS-XLS] 2.5.213 ObjId: the drawing-object type a comment's Obj record names -- workbook/comments.ts's own OBJECT_TYPE_NOTE, restated here since the two modules read/write the identical constant independently rather than sharing an import across the read/write boundary (matching this package's existing convention of one module per direction). */
+const OBJECT_TYPE_NOTE = 25;
+const FTCMO_FT = 21;
+const FTCMO_CB = 18;
+const FTNTS_FT = 13;
+const FTNTS_CB = 22;
+/** FtCmo ([MS-XLS] 2.5.92, 22 bytes): the common properties every Obj record opens with. Every flag bit beyond ot/id is either a UI concern (locked, default size, printed) this writer has no data for, or explicitly reserved -- so grbit and the three trailing "unused" fields are all written zero. */
+function writeFtCmo(objId) {
+	return new RecordBuilder().u16(FTCMO_FT).u16(FTCMO_CB).u16(OBJECT_TYPE_NOTE).u16(objId).u16(0).u32(0).u32(0).u32(0).build();
+}
+/** A pseudo-random 16-byte GUID for FtNts's own comment identifier -- [MS-XLS] requires the field to be present and does not require it to be globally unique across files, only present, so a fresh random value per comment (rather than a fixed or zero one) is what a real producer's own GUID allocation looks like without this package needing a GUID-formatting dependency. Worker-isomorphic: globalThis.crypto is available in both Node and a Cloudflare Workers isolate, unlike Node's own node:crypto module. */
+function randomGuidBytes() {
+	const bytes = /* @__PURE__ */ new Uint8Array(16);
+	globalThis.crypto.getRandomValues(bytes);
+	return bytes;
+}
+/** FtNts ([MS-XLS] 2.5.163... 2.5.b0991167, 26 bytes): the note-specific properties following FtCmo in a comment's own Obj record. fSharedNote is always written clear -- this writer has no shared-comment concept to express. */
+function writeFtNts() {
+	return new RecordBuilder().u16(FTNTS_FT).u16(FTNTS_CB).bytes(randomGuidBytes()).u16(0).u32(0).build();
+}
+/** Obj ([MS-XLS] 2.4.181) for a Note-type object: FtCmo, then FtNts (present if and only if cmo.ot is 0x19, which this writer's OBJECT_TYPE_NOTE always is), then the mandatory trailing 4-byte reserved field every Obj not naming a list-box/dropdown object (ot 0x12/0x14) carries. */
+function writeObjRecordForNote(objId) {
+	const data = new RecordBuilder().bytes(writeFtCmo(objId)).bytes(writeFtNts()).u32(0).build();
+	return writeRecord(93, data);
+}
+/** TxORuns' own minimal shape for plain, unformatted text ([MS-XLS] 2.5.31cd7d1e/d738ffef/6fb4c0e3): one Run (an all-default FormatRun -- ich 0, ifnt 0 -- plus its own six reserved bytes) followed by the mandatory TxOLastRun sentinel naming cchText again. 16 bytes total, the minimum [MS-XLS]'s own "cbRuns MUST be >= 16 and a multiple of 8" rule allows -- this writer never carries real per-character formatting for a comment's text (workbook/comments.ts's own read side does not model TxORuns either, for the identical reason). */
+function writeMinimalTxoRuns(cchText) {
+	return new RecordBuilder().u16(0).u16(0).u16(0).u16(0).u16(cchText).u16(0).u32(0).build();
+}
+/** TxO ([MS-XLS] 2.4.329) plus the one Continue record carrying its text and formatting-run trailer -- see this module's own top comment for why both text and runs can share a single Continue rather than needing one each. cchText is 0 for an empty comment, in which case [MS-XLS] itself requires cbRuns to be 0 too and no Continue record follows at all. */
+function writeTxoRecords(text) {
+	const cchText = text.length;
+	const cbRuns = cchText === 0 ? 0 : 16;
+	const txoData = new RecordBuilder().u16(18).u16(0).u16(0).u32(0).u16(cchText).u16(cbRuns).u16(0).u16(0).build();
+	const txo = writeRecord(438, txoData);
+	if (cchText === 0) return [txo];
+	const continueData = new RecordBuilder().bytes(writeXLUnicodeStringNoCch(text)).bytes(writeMinimalTxoRuns(cchText)).build();
+	return [txo, writeRecord(60, continueData)];
+}
+/**
+* Note ([MS-XLS] 2.4.179, wrapping a NoteSh structure): the comment's own cell anchor and author, naming the Obj record that carries its text through idObj. fShow/fRwHidden/fColHidden are always written clear -- this writer tracks none of the on-screen display state they carry.
+*
+* A comment with no recorded author writes stAuthor as an empty string, rather than a non-empty placeholder -- [MS-XLS] 2.5.163 itself documents stAuthor's own length as "MUST be greater than or equal to 1", but this reader (workbook/comments.ts's own readNoteAnchor) only ever promotes a NON-empty stAuthor to ContentSheetCellComment.author, meaning a placeholder would round-trip back as a fabricated author nobody wrote. An empty string is the one spelling that round-trips through this reader as "no author", matching every other lossless-round-trip choice this writer makes in favour of what its own reader reads back over strict textual conformance to a field length rule real producers routinely leave unenforced anyway.
+*/
+function writeNoteRecord(cell, objId) {
+	const data = new RecordBuilder().u16(cell.row).u16(cell.column).u16(0).u16(objId).bytes(writeXLUnicodeString(cell.comment?.author ?? "")).u8(0).build();
+	return writeRecord(28, data);
+}
+const MAX_OBJECT_ID = 65535;
+/**
+* Every Note/Obj/TxO record a sheet's own commented cells need, in the order described above -- for `cells` already filtered to exactly those carrying a `comment` (workbook/sheet-writer.ts's own caller does the filtering, since only it knows the sheet's full cell list).
+*
+* Object ids are assigned sequentially from 1: [MS-XLS] 2.5.92's own FtCmo.id must be unique "among all Obj records within ... Worksheet Substream ABNF", and this writer never emits any other kind of Obj record (no shapes, charts, or form controls yet -- see this package's README), so a per-sheet counter starting at 1 is already unique on its own.
+*/
+function writeSheetComments(commentedCells) {
+	if (commentedCells.length > MAX_OBJECT_ID) throw new BiffWriteError(`sheet carries ${commentedCells.length} cell comments, more than the ${MAX_OBJECT_ID} distinct object ids [MS-XLS] 2.5.92's own 16-bit FtCmo.id field can hold`);
+	const ordered = [...commentedCells].sort((a, b) => a.row !== b.row ? a.row - b.row : a.column - b.column);
+	const pieces = ordered.map((cell, index) => writeNoteRecord(cell, index + 1));
+	ordered.forEach((cell, index) => {
+		const objId = index + 1;
+		const comment = cell.comment;
+		if (comment === void 0) throw new BiffWriteError(`internal error: writeSheetComments was called with a cell at row ${cell.row}, column ${cell.column} carrying no comment`);
+		pieces.push(writeObjRecordForNote(objId), ...writeTxoRecords(comment.text));
+	});
+	return pieces;
+}
+//#endregion
+export { writeSheetComments };

package/dist/workbook/sheet-writer.cjs

@@ -8,8 +8,11 @@ const require_serial = require("../serial.cjs");
 const require_biff_builder = require("../biff/builder.cjs");
 const require_biff_record_writer = require("../biff/record-writer.cjs");
 const require_biff_bof_writer = require("../biff/bof-writer.cjs");
+const require_biff_string_writer = require("../biff/string-writer.cjs");
 const require_workbook_globals_writer = require("./globals-writer.cjs");
+const require_biff_ptg_writer = require("../biff/ptg-writer.cjs");
 const require_written_cells = require("../written-cells.cjs");
+const require_workbook_comment_writer = require("./comment-writer.cjs");
 //#region src/workbook/sheet-writer.ts
 /** BIFF8's own 16-bit row index and 8-bit column index ceilings ([MS-XLS] 2.4.221's Rw structure and 2.4.53's Col256U structure): 65536 rows (0-65535), 256 columns (0-255) -- unlike xlsx's much larger grid. A cell outside this range cannot be expressed in BIFF8 at all, so it is refused rather than silently truncated into a wrapped index. */
 const MAX_ROW_INDEX = 65535;
@@ -241,7 +244,50 @@ function writeCellValueRecord(cell, xfIndex, ctx) {
 			return require_biff_record_writer.writeRecord(513, cellHeader(cell, xfIndex).build());
 	}
 }
-/** Builds one worksheet's own substream: BOF, the print-settings records, Dimensions, ColInfo per column, Row + value-cell records per populated or declared row (in ascending row then column order), MergeCells if the sheet declares any, EOF. */
+/** [MS-XLS] 2.4.127's own FormulaValue tag vocabulary, restated here from workbook/sheet.ts's own read-side constants (not shared across the read/write boundary, matching this package's existing per-direction module convention): a cached result that is not a plain number tags byte 6-7 as 0xFFFF and names its own kind in byte 0. */
+const FORMULA_VALUE_TAGGED = 65535;
+const FORMULA_VALUE_STRING = 0;
+const FORMULA_VALUE_BOOLEAN = 1;
+const FORMULA_VALUE_ERROR = 2;
+/** The 8-byte FormulaValue field for a cached result that is not a plain number: byte 0 names which of string/boolean/error it is, byte 2 carries a boolean's own 0/1 or an error's own BIFF8 code, and the trailing u16 is the FORMULA_VALUE_TAGGED marker every reader checks for before trusting the field as a literal IEEE 754 double. */
+function taggedFormulaValueBytes(tag, valueByte) {
+	return new require_biff_builder.RecordBuilder().u8(tag).u8(0).u8(valueByte).u8(0).u16(0).u16(FORMULA_VALUE_TAGGED).build();
+}
+/** The Formula record's own 8-byte FormulaValue field for `cell.value` -- a plain little-endian f64 of the cell's own numeric/temporal serial for every numeric-shaped kind, or one of the tagged shapes above for a string, boolean, or error result. `empty` has no BIFF8 encoding that this package's own reader reads back as `empty` (a tagged-blank result reads back as an empty STRING, not an empty cell -- see workbook/sheet.ts's own taggedFormulaValue), so a formula whose value resolves to `empty` is refused outright rather than written as something the round trip would silently change the kind of. */
+function formulaValueBytes(cell) {
+	const value = cell.value;
+	switch (value.kind) {
+		case "number":
+		case "percentage":
+		case "currency": return new require_biff_builder.RecordBuilder().f64(value.value).build();
+		case "date": return new require_biff_builder.RecordBuilder().f64(require_serial.isoDateToSerial(value.value, false)).build();
+		case "time": return new require_biff_builder.RecordBuilder().f64(require_serial.isoTimeToSerial(value.value)).build();
+		case "dateTime": return new require_biff_builder.RecordBuilder().f64(require_serial.isoDateTimeToSerial(value.value, false)).build();
+		case "boolean": return taggedFormulaValueBytes(FORMULA_VALUE_BOOLEAN, value.value ? 1 : 0);
+		case "error": {
+			const code = require_biff_errors.errorCodeOf(value.value);
+			if (code === void 0) throw new require_biff_write_errors.BiffWriteError(`cell at row ${cell.row}, column ${cell.column} carries a formula whose cached result is error text ${JSON.stringify(value.value)}, which is not one of the eight error values [MS-XLS] 2.5.10 defines`);
+			return taggedFormulaValueBytes(FORMULA_VALUE_ERROR, code);
+		}
+		case "string": return taggedFormulaValueBytes(FORMULA_VALUE_STRING, 0);
+		case "empty": throw new require_biff_write_errors.BiffWriteError(`cell at row ${cell.row}, column ${cell.column} carries a formula whose value resolves to an empty cell, which this writer cannot express as a Formula record's cached result`);
+	}
+}
+/** Formula ([MS-XLS] 2.4.127): a Cell, the 8-byte FormulaValue above, a flags word and a 4-byte calculation cache this writer has no data for (both written zero -- see the module comment on RECORD_CALCCOUNT and friends for the same "nothing this schema models" reasoning), then a CellParsedFormula -- a two-byte cce and that many bytes of compiled Ptg tokens from biff/ptg-writer.ts's own compileFormulaText. Never carries an RgbExtra trailer: this writer's formula compiler refuses any construct (an array-constant literal, a shared/array formula) that would need one, so cce always accounts for the whole of rgce. A string-kind result is followed by a String record ([MS-XLS] 2.4.268) carrying the cached text, exactly as workbook/sheet.ts's own reader expects to find it. */
+function writeFormulaRecords(cell, xfIndex) {
+	const formula = cell.formula;
+	if (formula === void 0) throw new require_biff_write_errors.BiffWriteError(`internal error: writeFormulaRecords was called for the cell at row ${cell.row}, column ${cell.column}, which carries no formula`);
+	const rgce = require_biff_ptg_writer.compileFormulaText(formula);
+	const data = cellHeader(cell, xfIndex).bytes(formulaValueBytes(cell)).u16(0).u32(0).u16(rgce.length).bytes(rgce).build();
+	const records = [require_biff_record_writer.writeRecord(6, data)];
+	if (cell.value.kind === "string") records.push(require_biff_record_writer.writeRecord(519, require_biff_string_writer.writeXLUnicodeString(cell.value.value)));
+	return records;
+}
+/** The one or two records one cell contributes to the worksheet substream's cell table -- a Formula record (plus its String result, for a string-kind cell) when the cell carries a formula, the plain value record from writeCellValueRecord otherwise. */
+function writeCellRecords(cell, xfIndex, ctx) {
+	return cell.formula !== void 0 ? writeFormulaRecords(cell, xfIndex) : [writeCellValueRecord(cell, xfIndex, ctx)];
+}
+/** Builds one worksheet's own substream: BOF, the print-settings records, Dimensions, ColInfo per column, Row + value-cell records per populated or declared row (in ascending row then column order), MergeCells if the sheet declares any, comment records for cells carrying one, EOF. */
 function buildWorksheetSubstream(sheet, ctx) {
 	for (const cell of sheet.cells) checkedCellPosition(cell);
 	const writtenCells = sheet.cells.filter(require_written_cells.writesCellRecord);
@@ -265,11 +311,13 @@ function buildWorksheetSubstream(sheet, ctx) {
 		pieces.push(writeRowRecord(rowIndex, cellsInRow, declaredRows.get(rowIndex)));
 		for (const cell of cellsInRow) {
 			const xfIndex = ctx.xfIndexForCell(cell);
-			pieces.push(writeCellValueRecord(cell, xfIndex, ctx));
+			pieces.push(...writeCellRecords(cell, xfIndex, ctx));
 		}
 	}
 	const merges = mergedRangesOf(sheet.cells);
 	if (merges.length > 0) pieces.push(writeMergeCellsRecord(merges));
+	const commentedCells = sheet.cells.filter((cell) => cell.comment !== void 0);
+	if (commentedCells.length > 0) pieces.push(...require_workbook_comment_writer.writeSheetComments(commentedCells));
 	pieces.push(require_biff_record_writer.writeRecord(10, /* @__PURE__ */ new Uint8Array(0)));
 	return require_biff_record_writer.concatRecords(...pieces);
 }

package/dist/workbook/sheet-writer.d.cts

@@ -6,7 +6,7 @@ interface SheetWriteContext {
   /** The shared string table index for a string cell's own text; every string a sheet writes must already be registered in the workbook-wide table before this is called. */
   sstIndexFor(text: string): number;
 }
-/** Builds one worksheet's own substream: BOF, the print-settings records, Dimensions, ColInfo per column, Row + value-cell records per populated or declared row (in ascending row then column order), MergeCells if the sheet declares any, EOF. */
+/** Builds one worksheet's own substream: BOF, the print-settings records, Dimensions, ColInfo per column, Row + value-cell records per populated or declared row (in ascending row then column order), MergeCells if the sheet declares any, comment records for cells carrying one, EOF. */
 declare function buildWorksheetSubstream(sheet: ContentSheet, ctx: SheetWriteContext): Uint8Array<ArrayBuffer>;
 //#endregion
 export { SheetWriteContext, buildWorksheetSubstream };

package/dist/workbook/sheet-writer.d.ts

@@ -6,7 +6,7 @@ interface SheetWriteContext {
   /** The shared string table index for a string cell's own text; every string a sheet writes must already be registered in the workbook-wide table before this is called. */
   sstIndexFor(text: string): number;
 }
-/** Builds one worksheet's own substream: BOF, the print-settings records, Dimensions, ColInfo per column, Row + value-cell records per populated or declared row (in ascending row then column order), MergeCells if the sheet declares any, EOF. */
+/** Builds one worksheet's own substream: BOF, the print-settings records, Dimensions, ColInfo per column, Row + value-cell records per populated or declared row (in ascending row then column order), MergeCells if the sheet declares any, comment records for cells carrying one, EOF. */
 declare function buildWorksheetSubstream(sheet: ContentSheet, ctx: SheetWriteContext): Uint8Array<ArrayBuffer>;
 //#endregion
 export { SheetWriteContext, buildWorksheetSubstream };

package/dist/workbook/sheet-writer.js

@@ -7,8 +7,11 @@ import { isoDateTimeToSerial, isoDateToSerial, isoTimeToSerial } from "../serial
 import { RecordBuilder } from "../biff/builder.js";
 import { concatRecords, writeRecord } from "../biff/record-writer.js";
 import { writeBofData } from "../biff/bof-writer.js";
+import { writeXLUnicodeString } from "../biff/string-writer.js";
 import { GENERAL_CELL_XF_INDEX } from "./globals-writer.js";
+import { compileFormulaText } from "../biff/ptg-writer.js";
 import { cellCarriesFormatting, writesCellRecord } from "../written-cells.js";
+import { writeSheetComments } from "./comment-writer.js";
 //#region src/workbook/sheet-writer.ts
 /** BIFF8's own 16-bit row index and 8-bit column index ceilings ([MS-XLS] 2.4.221's Rw structure and 2.4.53's Col256U structure): 65536 rows (0-65535), 256 columns (0-255) -- unlike xlsx's much larger grid. A cell outside this range cannot be expressed in BIFF8 at all, so it is refused rather than silently truncated into a wrapped index. */
 const MAX_ROW_INDEX = 65535;
@@ -240,7 +243,50 @@ function writeCellValueRecord(cell, xfIndex, ctx) {
 			return writeRecord(513, cellHeader(cell, xfIndex).build());
 	}
 }
-/** Builds one worksheet's own substream: BOF, the print-settings records, Dimensions, ColInfo per column, Row + value-cell records per populated or declared row (in ascending row then column order), MergeCells if the sheet declares any, EOF. */
+/** [MS-XLS] 2.4.127's own FormulaValue tag vocabulary, restated here from workbook/sheet.ts's own read-side constants (not shared across the read/write boundary, matching this package's existing per-direction module convention): a cached result that is not a plain number tags byte 6-7 as 0xFFFF and names its own kind in byte 0. */
+const FORMULA_VALUE_TAGGED = 65535;
+const FORMULA_VALUE_STRING = 0;
+const FORMULA_VALUE_BOOLEAN = 1;
+const FORMULA_VALUE_ERROR = 2;
+/** The 8-byte FormulaValue field for a cached result that is not a plain number: byte 0 names which of string/boolean/error it is, byte 2 carries a boolean's own 0/1 or an error's own BIFF8 code, and the trailing u16 is the FORMULA_VALUE_TAGGED marker every reader checks for before trusting the field as a literal IEEE 754 double. */
+function taggedFormulaValueBytes(tag, valueByte) {
+	return new RecordBuilder().u8(tag).u8(0).u8(valueByte).u8(0).u16(0).u16(FORMULA_VALUE_TAGGED).build();
+}
+/** The Formula record's own 8-byte FormulaValue field for `cell.value` -- a plain little-endian f64 of the cell's own numeric/temporal serial for every numeric-shaped kind, or one of the tagged shapes above for a string, boolean, or error result. `empty` has no BIFF8 encoding that this package's own reader reads back as `empty` (a tagged-blank result reads back as an empty STRING, not an empty cell -- see workbook/sheet.ts's own taggedFormulaValue), so a formula whose value resolves to `empty` is refused outright rather than written as something the round trip would silently change the kind of. */
+function formulaValueBytes(cell) {
+	const value = cell.value;
+	switch (value.kind) {
+		case "number":
+		case "percentage":
+		case "currency": return new RecordBuilder().f64(value.value).build();
+		case "date": return new RecordBuilder().f64(isoDateToSerial(value.value, false)).build();
+		case "time": return new RecordBuilder().f64(isoTimeToSerial(value.value)).build();
+		case "dateTime": return new RecordBuilder().f64(isoDateTimeToSerial(value.value, false)).build();
+		case "boolean": return taggedFormulaValueBytes(FORMULA_VALUE_BOOLEAN, value.value ? 1 : 0);
+		case "error": {
+			const code = errorCodeOf(value.value);
+			if (code === void 0) throw new BiffWriteError(`cell at row ${cell.row}, column ${cell.column} carries a formula whose cached result is error text ${JSON.stringify(value.value)}, which is not one of the eight error values [MS-XLS] 2.5.10 defines`);
+			return taggedFormulaValueBytes(FORMULA_VALUE_ERROR, code);
+		}
+		case "string": return taggedFormulaValueBytes(FORMULA_VALUE_STRING, 0);
+		case "empty": throw new BiffWriteError(`cell at row ${cell.row}, column ${cell.column} carries a formula whose value resolves to an empty cell, which this writer cannot express as a Formula record's cached result`);
+	}
+}
+/** Formula ([MS-XLS] 2.4.127): a Cell, the 8-byte FormulaValue above, a flags word and a 4-byte calculation cache this writer has no data for (both written zero -- see the module comment on RECORD_CALCCOUNT and friends for the same "nothing this schema models" reasoning), then a CellParsedFormula -- a two-byte cce and that many bytes of compiled Ptg tokens from biff/ptg-writer.ts's own compileFormulaText. Never carries an RgbExtra trailer: this writer's formula compiler refuses any construct (an array-constant literal, a shared/array formula) that would need one, so cce always accounts for the whole of rgce. A string-kind result is followed by a String record ([MS-XLS] 2.4.268) carrying the cached text, exactly as workbook/sheet.ts's own reader expects to find it. */
+function writeFormulaRecords(cell, xfIndex) {
+	const formula = cell.formula;
+	if (formula === void 0) throw new BiffWriteError(`internal error: writeFormulaRecords was called for the cell at row ${cell.row}, column ${cell.column}, which carries no formula`);
+	const rgce = compileFormulaText(formula);
+	const data = cellHeader(cell, xfIndex).bytes(formulaValueBytes(cell)).u16(0).u32(0).u16(rgce.length).bytes(rgce).build();
+	const records = [writeRecord(6, data)];
+	if (cell.value.kind === "string") records.push(writeRecord(519, writeXLUnicodeString(cell.value.value)));
+	return records;
+}
+/** The one or two records one cell contributes to the worksheet substream's cell table -- a Formula record (plus its String result, for a string-kind cell) when the cell carries a formula, the plain value record from writeCellValueRecord otherwise. */
+function writeCellRecords(cell, xfIndex, ctx) {
+	return cell.formula !== void 0 ? writeFormulaRecords(cell, xfIndex) : [writeCellValueRecord(cell, xfIndex, ctx)];
+}
+/** Builds one worksheet's own substream: BOF, the print-settings records, Dimensions, ColInfo per column, Row + value-cell records per populated or declared row (in ascending row then column order), MergeCells if the sheet declares any, comment records for cells carrying one, EOF. */
 function buildWorksheetSubstream(sheet, ctx) {
 	for (const cell of sheet.cells) checkedCellPosition(cell);
 	const writtenCells = sheet.cells.filter(writesCellRecord);
@@ -264,11 +310,13 @@ function buildWorksheetSubstream(sheet, ctx) {
 		pieces.push(writeRowRecord(rowIndex, cellsInRow, declaredRows.get(rowIndex)));
 		for (const cell of cellsInRow) {
 			const xfIndex = ctx.xfIndexForCell(cell);
-			pieces.push(writeCellValueRecord(cell, xfIndex, ctx));
+			pieces.push(...writeCellRecords(cell, xfIndex, ctx));
 		}
 	}
 	const merges = mergedRangesOf(sheet.cells);
 	if (merges.length > 0) pieces.push(writeMergeCellsRecord(merges));
+	const commentedCells = sheet.cells.filter((cell) => cell.comment !== void 0);
+	if (commentedCells.length > 0) pieces.push(...writeSheetComments(commentedCells));
 	pieces.push(writeRecord(10, /* @__PURE__ */ new Uint8Array(0)));
 	return concatRecords(...pieces);
 }

package/dist/written-cells.cjs

@@ -14,12 +14,12 @@ function cellCarriesFormatting(cell) {
 	return borders.left !== void 0 || borders.right !== void 0 || borders.top !== void 0 || borders.bottom !== void 0;
 }
 /**
-* Whether the writer emits a cell record for this cell: a value record for anything carrying a value, or a Blank record for an `empty`-kind cell whose formatting is the only thing it has to say.
+* Whether the writer emits a cell record for this cell: a value record for anything carrying a value, a Formula record for anything carrying a formula, or a Blank record for an `empty`-kind cell whose formatting is the only thing it has to say.
 *
-* An unformatted empty cell is written as nothing at all, which is what round-trips: content.ts's reader drops an unformatted blank cell, and a merged range's empty anchor is reconstructed from the MergeCells record alone. A formatted one is not that case -- its fill, borders, and alignment live only in the XF a cell record points at, so writing nothing for it discards them.
+* An unformatted empty cell with no formula is written as nothing at all, which is what round-trips: content.ts's reader drops an unformatted blank cell, and a merged range's empty anchor is reconstructed from the MergeCells record alone. A formatted one is not that case -- its fill, borders, and alignment live only in the XF a cell record points at, so writing nothing for it discards them. A formula is the identical case one level up: it lives only in a Formula record, so a cell carrying one is never dropped regardless of what its own cached `value` resolves to, even where that value alone would otherwise not have earned a record.
 */
 function writesCellRecord(cell) {
-	return cell.value.kind !== "empty" || cellCarriesFormatting(cell);
+	return cell.value.kind !== "empty" || cellCarriesFormatting(cell) || cell.formula !== void 0;
 }
 //#endregion
 exports.cellCarriesFormatting = cellCarriesFormatting;

package/dist/written-cells.d.cts

@@ -7,9 +7,9 @@ import { ContentSheetCell } from "document-schema.js";
  */
 declare function cellCarriesFormatting(cell: ContentSheetCell): boolean;
 /**
- * Whether the writer emits a cell record for this cell: a value record for anything carrying a value, or a Blank record for an `empty`-kind cell whose formatting is the only thing it has to say.
+ * Whether the writer emits a cell record for this cell: a value record for anything carrying a value, a Formula record for anything carrying a formula, or a Blank record for an `empty`-kind cell whose formatting is the only thing it has to say.
  *
- * An unformatted empty cell is written as nothing at all, which is what round-trips: content.ts's reader drops an unformatted blank cell, and a merged range's empty anchor is reconstructed from the MergeCells record alone. A formatted one is not that case -- its fill, borders, and alignment live only in the XF a cell record points at, so writing nothing for it discards them.
+ * An unformatted empty cell with no formula is written as nothing at all, which is what round-trips: content.ts's reader drops an unformatted blank cell, and a merged range's empty anchor is reconstructed from the MergeCells record alone. A formatted one is not that case -- its fill, borders, and alignment live only in the XF a cell record points at, so writing nothing for it discards them. A formula is the identical case one level up: it lives only in a Formula record, so a cell carrying one is never dropped regardless of what its own cached `value` resolves to, even where that value alone would otherwise not have earned a record.
  */
 declare function writesCellRecord(cell: ContentSheetCell): boolean;
 //#endregion

package/dist/written-cells.d.ts

@@ -7,9 +7,9 @@ import { ContentSheetCell } from "document-schema.js";
  */
 declare function cellCarriesFormatting(cell: ContentSheetCell): boolean;
 /**
- * Whether the writer emits a cell record for this cell: a value record for anything carrying a value, or a Blank record for an `empty`-kind cell whose formatting is the only thing it has to say.
+ * Whether the writer emits a cell record for this cell: a value record for anything carrying a value, a Formula record for anything carrying a formula, or a Blank record for an `empty`-kind cell whose formatting is the only thing it has to say.
  *
- * An unformatted empty cell is written as nothing at all, which is what round-trips: content.ts's reader drops an unformatted blank cell, and a merged range's empty anchor is reconstructed from the MergeCells record alone. A formatted one is not that case -- its fill, borders, and alignment live only in the XF a cell record points at, so writing nothing for it discards them.
+ * An unformatted empty cell with no formula is written as nothing at all, which is what round-trips: content.ts's reader drops an unformatted blank cell, and a merged range's empty anchor is reconstructed from the MergeCells record alone. A formatted one is not that case -- its fill, borders, and alignment live only in the XF a cell record points at, so writing nothing for it discards them. A formula is the identical case one level up: it lives only in a Formula record, so a cell carrying one is never dropped regardless of what its own cached `value` resolves to, even where that value alone would otherwise not have earned a record.
  */
 declare function writesCellRecord(cell: ContentSheetCell): boolean;
 //#endregion

package/dist/written-cells.js

@@ -13,12 +13,12 @@ function cellCarriesFormatting(cell) {
 	return borders.left !== void 0 || borders.right !== void 0 || borders.top !== void 0 || borders.bottom !== void 0;
 }
 /**
-* Whether the writer emits a cell record for this cell: a value record for anything carrying a value, or a Blank record for an `empty`-kind cell whose formatting is the only thing it has to say.
+* Whether the writer emits a cell record for this cell: a value record for anything carrying a value, a Formula record for anything carrying a formula, or a Blank record for an `empty`-kind cell whose formatting is the only thing it has to say.
 *
-* An unformatted empty cell is written as nothing at all, which is what round-trips: content.ts's reader drops an unformatted blank cell, and a merged range's empty anchor is reconstructed from the MergeCells record alone. A formatted one is not that case -- its fill, borders, and alignment live only in the XF a cell record points at, so writing nothing for it discards them.
+* An unformatted empty cell with no formula is written as nothing at all, which is what round-trips: content.ts's reader drops an unformatted blank cell, and a merged range's empty anchor is reconstructed from the MergeCells record alone. A formatted one is not that case -- its fill, borders, and alignment live only in the XF a cell record points at, so writing nothing for it discards them. A formula is the identical case one level up: it lives only in a Formula record, so a cell carrying one is never dropped regardless of what its own cached `value` resolves to, even where that value alone would otherwise not have earned a record.
 */
 function writesCellRecord(cell) {
-	return cell.value.kind !== "empty" || cellCarriesFormatting(cell);
+	return cell.value.kind !== "empty" || cellCarriesFormatting(cell) || cell.formula !== void 0;
 }
 //#endregion
 export { cellCarriesFormatting, writesCellRecord };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "xls-codec",
-  "version": "4.10.0",
+  "version": "4.11.1",
   "description": "Hand-written reader for the legacy Excel Binary File Format (.xls, BIFF8) as specified by [MS-XLS], mapping a workbook's record stream onto the shared document-schema.js spreadsheet model - the .xls codec for the documents.js family.",
   "type": "module",
   "repository": {
@@ -70,8 +70,8 @@
   },
   "packageManager": "pnpm@11.6.0",
   "dependencies": {
-    "archive-codec": "1.10.0",
-    "document-schema.js": "7.5.0",
+    "archive-codec": "1.10.1",
+    "document-schema.js": "7.5.1",
     "excel-number-format": "1.1.1"
   },
   "devDependencies": {