xls-codec 1.0.2 → 2.0.1

package/dist/workbook/globals-writer.js

@@ -0,0 +1,120 @@
+import { RECORD_BOF } from "../biff/record-types.js";
+import { RecordBuilder } from "../biff/builder.js";
+import { concatRecords, writeRecord } from "../biff/record-writer.js";
+import { writePrintNameRecords } from "./print-names.js";
+import { writeBofData } from "../biff/bof-writer.js";
+import { writeRichExtendedString, writeShortXLUnicodeString } from "../biff/string-writer.js";
+import { writeCellXfRecord, writeFontRecord, writeFormatRecord, writePaletteRecord, writeStyleRecord, writeStyleXfRecord } from "../biff/xf-writer.js";
+//#region src/workbook/globals-writer.ts
+const GENERAL_FORMAT_ID = 0;
+const NORMAL_FONT_INDEX = 0;
+const NORMAL_FONT_NAME = "Arial";
+/** Excel 97-2003's own Normal-style default: 10pt, in twips (dyHeight's own unit, [MS-XLS] 2.4.122). */
+const NORMAL_FONT_HEIGHT_TWIPS = 200;
+/** [MS-XLS] "BuiltInStyle" istyBuiltIn values (ECMA-376 Part 1 18.8.7's cellStyle builtinId table): 0 Normal, 1 RowLevel, 2 ColLevel -- the only three this writer emits, since it never groups rows/columns into an outline. */
+const BUILTIN_STYLE_NORMAL = 0;
+const BUILTIN_STYLE_ROW_LEVEL = 1;
+const BUILTIN_STYLE_COL_LEVEL = 2;
+/** BuiltInStyle's own iLevel sentinel for a style other than RowLevel/ColLevel: "otherwise, this value MUST be 0xFF". */
+const NO_OUTLINE_LEVEL = 255;
+/** RowLevel/ColLevel each cover seven outline depths ([MS-XLS] "BuiltInStyle"'s own 0x00-0x06 iLevel table). */
+const OUTLINE_LEVEL_COUNT = 7;
+/** The fifteen built-in cell styles, XF index 0 through 14, in the order every real Excel-written workbook carries them: Normal, then RowLevel_1..7, then ColLevel_1..7. */
+const BUILTIN_STYLES = [
+	{
+		istyBuiltIn: BUILTIN_STYLE_NORMAL,
+		iLevel: NO_OUTLINE_LEVEL
+	},
+	...Array.from({ length: OUTLINE_LEVEL_COUNT }, (_unused, level) => ({
+		istyBuiltIn: BUILTIN_STYLE_ROW_LEVEL,
+		iLevel: level
+	})),
+	...Array.from({ length: OUTLINE_LEVEL_COUNT }, (_unused, level) => ({
+		istyBuiltIn: BUILTIN_STYLE_COL_LEVEL,
+		iLevel: level
+	}))
+];
+/** [MS-XLS] 2.1.7.20.3's own XFS production requires at least sixteen XF records before any cell can reference one: BUILTIN_STYLES.length built-in cell styles, then at least one cell XF -- the "General, no declared format" one every workbook needs unconditionally, written immediately after them. Derived from BUILTIN_STYLES's own length rather than restated as a literal, so the two can never drift apart. */
+const GENERAL_CELL_XF_INDEX = BUILTIN_STYLES.length;
+/** BoundSheet8 ([MS-XLS] 2.4.28) with lbPlyPos left at 0: a placeholder the caller patches in place, since the real value -- the byte offset of this sheet's own BOF within the finished workbook stream -- is only known once every substream's length has been measured. */
+function writeBoundSheet8Placeholder(name) {
+	const data = new RecordBuilder().u32(0).u8(0).u8(0).bytes(writeShortXLUnicodeString(name)).build();
+	return writeRecord(133, data);
+}
+/** [MS-XLS] 2.4.271's own cch table: the value a self-referencing SupBook -- this workbook itself, rather than another workbook, a DDE/OLE data source, or an add-in -- carries in place of a virtual path. The one kind of supporting link this package writes, and the one kind workbook/globals.ts's own reader resolves a 3D reference through. */
+const SUPBOOK_SELF_REFERENCING_CCH = 1025;
+/** SupBook ([MS-XLS] 2.4.271), self-referencing: a two-byte sheet count then that cch sentinel, and nothing else -- the virtPath/rgst payload a real external link would carry has no meaning for a link that names this same workbook. */
+function writeSupBookRecord(sheetCount) {
+	return writeRecord(430, new RecordBuilder().u16(sheetCount).u16(SUPBOOK_SELF_REFERENCING_CCH).build());
+}
+/**
+* ExternSheet ([MS-XLS] 2.4.106): a two-byte cXTI then that many XTI structures ([MS-XLS] 2.5.344), each an iSupBook and a signed itabFirst/itabLast sheet-scope pair -- the write-side mirror of workbook/globals.ts's own readSheetRanges.
+*
+* One XTI per sheet, each scoped to that one sheet and pointing at the single self-referencing SupBook above, so a print name's own PtgArea3d can name its sheet by using that sheet's index as its ixti. The 3D reference machinery exists here purely because [MS-XLS] gives a defined name no other way to say which sheet its range is on.
+*/
+function writeExternSheetRecord(sheetCount) {
+	const builder = new RecordBuilder().u16(sheetCount);
+	for (let sheetIndex = 0; sheetIndex < sheetCount; sheetIndex += 1) builder.u16(0).u16(sheetIndex).u16(sheetIndex);
+	return writeRecord(23, builder.build());
+}
+/** SST ([MS-XLS] 2.4.265): a total reference count, a unique-string count, then that many XLUnicodeRichExtendedStrings, packed with no offsets -- the write-side mirror of workbook/globals.ts's own readSharedStrings. */
+function writeSstRecord(strings, totalCount) {
+	const builder = new RecordBuilder().i32(totalCount).i32(strings.length);
+	for (const text of strings) builder.bytes(writeRichExtendedString(text));
+	return writeRecord(252, builder.build());
+}
+function buildWorkbookGlobals(plan) {
+	const pieces = [];
+	let offset = 0;
+	const push = (piece) => {
+		pieces.push(piece);
+		offset += piece.length;
+	};
+	push(writeRecord(RECORD_BOF, writeBofData(5)));
+	push(writeFontRecord(NORMAL_FONT_NAME, NORMAL_FONT_HEIGHT_TWIPS));
+	for (const code of plan.customFormats) push(writeFormatRecord(code.id, code.code));
+	BUILTIN_STYLES.forEach(() => {
+		push(writeStyleXfRecord({
+			fontIndex: NORMAL_FONT_INDEX,
+			formatId: GENERAL_FORMAT_ID
+		}));
+	});
+	push(writeCellXfRecord({
+		fontIndex: NORMAL_FONT_INDEX,
+		formatId: GENERAL_FORMAT_ID
+	}));
+	for (const entry of plan.cellXfEntries) push(writeCellXfRecord({
+		fontIndex: NORMAL_FONT_INDEX,
+		formatId: entry.formatId,
+		alignment: entry.alignment,
+		verticalAlignment: entry.verticalAlignment,
+		decoration: entry.decoration
+	}));
+	BUILTIN_STYLES.forEach((builtin, index) => {
+		push(writeStyleRecord({
+			xfIndex: index,
+			istyBuiltIn: builtin.istyBuiltIn,
+			iLevel: builtin.iLevel
+		}));
+	});
+	if (plan.paletteColors !== void 0) push(writePaletteRecord(plan.paletteColors));
+	const lbPlyPosOffsets = [];
+	for (const name of plan.sheetNames) {
+		const recordStart = offset;
+		lbPlyPosOffsets.push(recordStart + 4);
+		push(writeBoundSheet8Placeholder(name));
+	}
+	if (plan.printNames.length > 0) {
+		push(writeSupBookRecord(plan.sheetNames.length));
+		push(writeExternSheetRecord(plan.sheetNames.length));
+		for (const record of writePrintNameRecords(plan.printNames)) push(record);
+	}
+	if (plan.sharedStrings.length > 0) push(writeSstRecord(plan.sharedStrings, plan.sharedStringTotalCount));
+	push(writeRecord(10, /* @__PURE__ */ new Uint8Array(0)));
+	return {
+		bytes: concatRecords(...pieces),
+		lbPlyPosOffsets
+	};
+}
+//#endregion
+export { GENERAL_CELL_XF_INDEX, buildWorkbookGlobals };

package/dist/workbook/globals.cjs

@@ -1,9 +1,11 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_biff_record_types = require("../biff/record-types.cjs");
 const require_biff_records = require("../biff/records.cjs");
-const require_number_format = require("../number-format.cjs");
+const require_biff_xf_colors = require("../biff/xf-colors.cjs");
 const require_biff_cursor = require("../biff/cursor.cjs");
 const require_biff_strings = require("../biff/strings.cjs");
+const require_workbook_print_names = require("./print-names.cjs");
+let excel_number_format = require("excel-number-format");
 //#region src/workbook/globals.ts
 /** [MS-XLS] 2.4.28's own hsState values; 0x01 is Hidden and 0x02 Very Hidden. */
 const HIDDEN_STATE_MASK = 3;
@@ -17,8 +19,11 @@ function readWorkbookGlobals(records) {
 	const sheets = [];
 	const cellFormats = [];
 	const customFormats = /* @__PURE__ */ new Map();
+	const supBookSelfReferencing = [];
 	let sharedStrings = [];
 	let date1904 = false;
+	let externSheet;
+	let palette;
 	for (const record of records) switch (record.type) {
 		case 133:
 			sheets.push(readBoundSheet(record));
@@ -34,18 +39,55 @@ function readWorkbookGlobals(records) {
 		case 224:
 			cellFormats.push(readCellFormat(record));
 			break;
-		case 34: date1904 = readDate1904(record);
+		case 34:
+			date1904 = readDate1904(record);
+			break;
+		case 430:
+			supBookSelfReferencing.push(isSelfReferencingSupBook(record));
+			break;
+		case 23:
+			externSheet = record;
+			break;
+		case 146: palette = readPalette(record);
 	}
-	const numberFormats = new Map(require_number_format.BUILTIN_NUMBER_FORMATS);
+	const numberFormats = new Map(excel_number_format.BUILTIN_NUMBER_FORMATS);
 	for (const [id, code] of customFormats) numberFormats.set(id, code);
+	const sheetRanges = externSheet === void 0 ? [] : readSheetRanges(externSheet, supBookSelfReferencing);
 	return {
 		sheets,
 		sharedStrings,
 		cellFormats,
 		numberFormats,
-		date1904
+		date1904,
+		sheetRanges,
+		palette,
+		printNames: require_workbook_print_names.readPrintNames(records)
 	};
 }
+/** [MS-XLS] 2.4.271's own cch table: a SupBook whose cch is exactly this value is a self-referencing supporting link -- this workbook itself -- rather than another workbook, a DDE/OLE data source, or an add-in. This is the only kind of supporting link a 3D reference resolves through here; every other kind genuinely needs bytes from outside this file. */
+const SUPBOOK_SELF_REFERENCING_CCH = 1025;
+/** SupBook ([MS-XLS] 2.4.271): a two-byte ctab then a two-byte cch. Only cch is read here -- ctab is undefined for a self-referencing SupBook and unused for every other kind this reader does not resolve, and the virtPath/rgst payload that would follow for a non-self-referencing link is never reached. */
+function isSelfReferencingSupBook(record) {
+	const cursor = new require_biff_cursor.BlockCursor(record.blocks);
+	cursor.skip(2);
+	return cursor.u16() === SUPBOOK_SELF_REFERENCING_CCH;
+}
+/** ExternSheet ([MS-XLS] 2.4.106): a two-byte cXTI then that many XTI structures ([MS-XLS] 2.5.344) -- a two-byte iSupBook and two signed 16-bit sheet-scope bounds each. iSupBook indexes the SupBook collection positionally, in the order those records appeared. */
+function readSheetRanges(record, supBookSelfReferencing) {
+	const cursor = new require_biff_cursor.BlockCursor(record.blocks);
+	const count = cursor.u16();
+	const ranges = [];
+	for (let index = 0; index < count; index += 1) {
+		const iSupBook = cursor.u16();
+		const itabFirst = cursor.i16();
+		const itabLast = cursor.i16();
+		ranges.push((supBookSelfReferencing[iSupBook] ?? false) && itabFirst >= 0 && itabLast >= 0 ? {
+			firstSheetIndex: itabFirst,
+			lastSheetIndex: itabLast
+		} : void 0);
+	}
+	return ranges;
+}
 /** BoundSheet8 ([MS-XLS] 2.4.28): a four-byte stream position, a byte of hidden state, a byte of sheet type, then the name as a ShortXLUnicodeString. */
 function readBoundSheet(record) {
 	const cursor = new require_biff_cursor.BlockCursor(record.blocks);
@@ -79,15 +121,37 @@ function readFormat(record) {
 		code: require_biff_strings.readXLUnicodeString(cursor)
 	};
 }
-/** XF ([MS-XLS] 2.4.353): a font index, a number-format identifier, then a flags field whose fStyle bit says whether the trailing payload is a CellXF or a StyleXF. */
+/** XF ([MS-XLS] 2.4.353): a font index, a number-format identifier, a flags field whose fStyle bit says whether the trailing payload is a CellXF or a StyleXF, then that 14-byte trailing payload itself -- the leading alignment word xf-colors.ts's unpackXfAlignment resolves into this format's own `alignment`, then the border word, fill-pattern word, and fill-colour word its unpackXfDecoration resolves into this format's own `decoration`. CellXF and StyleXF share the identical alignment/border/fill bit layout ([MS-XLS] 2.4.353's own field table), so this reads both shapes uniformly regardless of isStyle -- a cell only ever references a CellXF entry by its own ixfe (workbook/sheet.ts's cell reading), so a StyleXF's alignment/decoration are parsed but never consulted downstream. */
 function readCellFormat(record) {
 	const cursor = new require_biff_cursor.BlockCursor(record.blocks);
+	const fontIndex = cursor.u16();
+	const formatId = cursor.u16();
+	const flags = cursor.u16();
+	const word1 = cursor.u32();
+	const word2 = cursor.u32();
+	const word3 = cursor.u32();
+	const word4 = cursor.u16();
 	return {
-		fontIndex: cursor.u16(),
-		formatId: cursor.u16(),
-		isStyle: (cursor.u16() & XF_FLAG_STYLE) !== 0
+		fontIndex,
+		formatId,
+		isStyle: (flags & XF_FLAG_STYLE) !== 0,
+		alignment: require_biff_xf_colors.unpackXfAlignment(word1),
+		decoration: require_biff_xf_colors.unpackXfDecoration(word2, word3, word4)
 	};
 }
+/**
+* Palette ([MS-XLS] 2.4.188): ccv, a signed colour count the spec states "MUST be 56", then that many LongRGB entries -- the write-side mirror is xf-writer.ts's own writePaletteRecord.
+*
+* A ccv that is not 56 is refused rather than honoured. This reader resolves every icv 8-63 positionally through this table, so a short (or zero, or negative) one does not degrade gracefully: every colour past its end silently becomes unresolvable, and a workbook's fills and borders all vanish at once with nothing to say why. A file declaring a count its own spec forbids is malformed, and saying so is the only honest answer.
+*/
+function readPalette(record) {
+	const cursor = new require_biff_cursor.BlockCursor(record.blocks);
+	const count = cursor.i16();
+	if (count !== 56) throw new require_biff_records.BiffFormatError(`Palette declares ${count} colour entries, but [MS-XLS] 2.4.188's own ccv field MUST be 56`);
+	const colors = [];
+	for (let index = 0; index < count; index += 1) colors.push(require_biff_xf_colors.readLongRgbColor(cursor));
+	return colors;
+}
 /** Date1904 ([MS-XLS] 2.4.77): a two-byte boolean. */
 function readDate1904(record) {
 	return new require_biff_cursor.BlockCursor(record.blocks).u16() !== 0;

package/dist/workbook/globals.d.cts

@@ -1,4 +1,8 @@
-import { RecordGroup } from "../biff/substreams.cjs";
+import { n as SheetRange } from "../ptg-B2K8t3js.cjs";
+import { t as RecordGroup } from "../substreams-Ddtvn_Vr.cjs";
+import { C as XfAlignmentFields, T as XfDecorationFields } from "../xf-colors-CehHZtBy.cjs";
+import { n as SheetPrintNames } from "../print-names-D-njuzVw.cjs";
+import { Color } from "document-schema.js";
 //#region src/workbook/globals.d.ts
 /** One sheet, as its BoundSheet8 record describes it ([MS-XLS] 2.4.28). */
 interface SheetEntry {
@@ -11,7 +15,7 @@ interface SheetEntry {
   /** lbPlyPos: the byte offset, within the workbook stream, of this sheet's own BOF record. */
   readonly bofPosition: number;
 }
-/** One XF record's fixed prefix ([MS-XLS] 2.4.353). Only the fields the value path needs are carried: the trailing CellXF/StyleXF payload holds alignment, fill, and border properties whose colours are palette indices needing the Palette record to resolve, which this package does not yet read. */
+/** One XF record's fixed prefix ([MS-XLS] 2.4.353) plus its trailing CellXF/StyleXF payload's own alignment and fill/border fields. */
 interface CellFormat {
   /** ifnt: the index of the Font record this format uses. */
   readonly fontIndex: number;
@@ -19,6 +23,10 @@ interface CellFormat {
   readonly formatId: number;
   /** fStyle: true when this record describes a cell STYLE rather than a cell format. */
   readonly isStyle: boolean;
+  /** The trailing payload's own leading word, resolved into document-schema.js's Alignment/verticalAlignment members directly (undefined already means what an absent ContentSheetCell.alignment/verticalAlignment means, so content.ts consumes this without a further resolution step). */
+  readonly alignment: XfAlignmentFields;
+  /** The trailing payload's own fill pattern/colour and per-side border fields, raw -- resolved into document-schema.js's Color/ContentCellBorders by content.ts, through this same globals object's own `palette`. */
+  readonly decoration: XfDecorationFields;
 }
 /** Everything the globals substream contributes to reading the sheets that follow it. */
 interface WorkbookGlobals {
@@ -32,6 +40,22 @@ interface WorkbookGlobals {
   readonly numberFormats: ReadonlyMap<number, string>;
   /** Whether serials count from the 1904 epoch rather than the 1900 one ([MS-XLS] 2.4.77). */
   readonly date1904: boolean;
+  /**
+   * A PtgRef3d/PtgArea3d's own ixti, resolved to the sheet range it names -- one entry per XTI in the EXTERNSHEET record's rgXTI array, in that array's own order (an ixti is an index into it).
+   *
+   * An entry is undefined when this reader does not resolve it: the XTI's own SupBook is not this same, self-referencing workbook (a genuine external-workbook, DDE, OLE, or add-in reference -- [MS-XLS] 2.4.271's own cch table, `0x0401` being the one this reader treats as resolvable), or its itabFirst/itabLast do not name a real sheet (`-1`, "sheet could not be found"). A formula whose 3D reference lands on an undefined entry is left with `formula` absent for that cell, exactly like the other unsupported-token cases -- this reader never resolves a genuinely external workbook's own sheet names, since that needs the external workbook's own bytes, not this one's.
+   */
+  readonly sheetRanges: readonly (SheetRange | undefined)[];
+  /**
+   * The workbook's own custom colour table, from a Palette record ([MS-XLS] 2.4.188) -- 56 entries, index 0 being icv 8. Undefined when the file carries no Palette record at all, which is common: a real file relying purely on the fixed default 8-colour-plus-56-entry table (this package's own `resolveIcvColor` falls back to that same default table, matching [MS-XLS] "Icv"'s own documented fallback) never needs one.
+   */
+  readonly palette: readonly Color[] | undefined;
+  /**
+   * The print range and repeated header bands each sheet's own built-in Print_Area/Print_Titles defined names declare, keyed by zero-based sheet index -- see workbook/print-names.ts for why a sheet's print settings are split between here and its own substream.
+   *
+   * A sheet with no entry declares neither, which is the common case: a workbook nobody has set a print area on carries no Lbl record at all.
+   */
+  readonly printNames: ReadonlyMap<number, SheetPrintNames>;
 }
 /** Reads the globals substream's records into the tables the sheet reader needs. */
 declare function readWorkbookGlobals(records: readonly RecordGroup[]): WorkbookGlobals;

package/dist/workbook/globals.d.ts

@@ -1,4 +1,8 @@
-import { RecordGroup } from "../biff/substreams.js";
+import { n as SheetRange } from "../ptg-B2K8t3js.js";
+import { t as RecordGroup } from "../substreams-D7dQiJbp.js";
+import { C as XfAlignmentFields, T as XfDecorationFields } from "../xf-colors-CpykR3B9.js";
+import { n as SheetPrintNames } from "../print-names-DUlpVE00.js";
+import { Color } from "document-schema.js";
 //#region src/workbook/globals.d.ts
 /** One sheet, as its BoundSheet8 record describes it ([MS-XLS] 2.4.28). */
 interface SheetEntry {
@@ -11,7 +15,7 @@ interface SheetEntry {
   /** lbPlyPos: the byte offset, within the workbook stream, of this sheet's own BOF record. */
   readonly bofPosition: number;
 }
-/** One XF record's fixed prefix ([MS-XLS] 2.4.353). Only the fields the value path needs are carried: the trailing CellXF/StyleXF payload holds alignment, fill, and border properties whose colours are palette indices needing the Palette record to resolve, which this package does not yet read. */
+/** One XF record's fixed prefix ([MS-XLS] 2.4.353) plus its trailing CellXF/StyleXF payload's own alignment and fill/border fields. */
 interface CellFormat {
   /** ifnt: the index of the Font record this format uses. */
   readonly fontIndex: number;
@@ -19,6 +23,10 @@ interface CellFormat {
   readonly formatId: number;
   /** fStyle: true when this record describes a cell STYLE rather than a cell format. */
   readonly isStyle: boolean;
+  /** The trailing payload's own leading word, resolved into document-schema.js's Alignment/verticalAlignment members directly (undefined already means what an absent ContentSheetCell.alignment/verticalAlignment means, so content.ts consumes this without a further resolution step). */
+  readonly alignment: XfAlignmentFields;
+  /** The trailing payload's own fill pattern/colour and per-side border fields, raw -- resolved into document-schema.js's Color/ContentCellBorders by content.ts, through this same globals object's own `palette`. */
+  readonly decoration: XfDecorationFields;
 }
 /** Everything the globals substream contributes to reading the sheets that follow it. */
 interface WorkbookGlobals {
@@ -32,6 +40,22 @@ interface WorkbookGlobals {
   readonly numberFormats: ReadonlyMap<number, string>;
   /** Whether serials count from the 1904 epoch rather than the 1900 one ([MS-XLS] 2.4.77). */
   readonly date1904: boolean;
+  /**
+   * A PtgRef3d/PtgArea3d's own ixti, resolved to the sheet range it names -- one entry per XTI in the EXTERNSHEET record's rgXTI array, in that array's own order (an ixti is an index into it).
+   *
+   * An entry is undefined when this reader does not resolve it: the XTI's own SupBook is not this same, self-referencing workbook (a genuine external-workbook, DDE, OLE, or add-in reference -- [MS-XLS] 2.4.271's own cch table, `0x0401` being the one this reader treats as resolvable), or its itabFirst/itabLast do not name a real sheet (`-1`, "sheet could not be found"). A formula whose 3D reference lands on an undefined entry is left with `formula` absent for that cell, exactly like the other unsupported-token cases -- this reader never resolves a genuinely external workbook's own sheet names, since that needs the external workbook's own bytes, not this one's.
+   */
+  readonly sheetRanges: readonly (SheetRange | undefined)[];
+  /**
+   * The workbook's own custom colour table, from a Palette record ([MS-XLS] 2.4.188) -- 56 entries, index 0 being icv 8. Undefined when the file carries no Palette record at all, which is common: a real file relying purely on the fixed default 8-colour-plus-56-entry table (this package's own `resolveIcvColor` falls back to that same default table, matching [MS-XLS] "Icv"'s own documented fallback) never needs one.
+   */
+  readonly palette: readonly Color[] | undefined;
+  /**
+   * The print range and repeated header bands each sheet's own built-in Print_Area/Print_Titles defined names declare, keyed by zero-based sheet index -- see workbook/print-names.ts for why a sheet's print settings are split between here and its own substream.
+   *
+   * A sheet with no entry declares neither, which is the common case: a workbook nobody has set a print area on carries no Lbl record at all.
+   */
+  readonly printNames: ReadonlyMap<number, SheetPrintNames>;
 }
 /** Reads the globals substream's records into the tables the sheet reader needs. */
 declare function readWorkbookGlobals(records: readonly RecordGroup[]): WorkbookGlobals;

package/dist/workbook/globals.js

@@ -1,8 +1,10 @@
 import { RECORD_FORMAT } from "../biff/record-types.js";
 import { BiffFormatError } from "../biff/records.js";
-import { BUILTIN_NUMBER_FORMATS } from "../number-format.js";
+import { readLongRgbColor, unpackXfAlignment, unpackXfDecoration } from "../biff/xf-colors.js";
 import { BlockCursor } from "../biff/cursor.js";
 import { readRichExtendedString, readShortXLUnicodeString, readXLUnicodeString } from "../biff/strings.js";
+import { readPrintNames } from "./print-names.js";
+import { BUILTIN_NUMBER_FORMATS } from "excel-number-format";
 //#region src/workbook/globals.ts
 /** [MS-XLS] 2.4.28's own hsState values; 0x01 is Hidden and 0x02 Very Hidden. */
 const HIDDEN_STATE_MASK = 3;
@@ -16,8 +18,11 @@ function readWorkbookGlobals(records) {
 	const sheets = [];
 	const cellFormats = [];
 	const customFormats = /* @__PURE__ */ new Map();
+	const supBookSelfReferencing = [];
 	let sharedStrings = [];
 	let date1904 = false;
+	let externSheet;
+	let palette;
 	for (const record of records) switch (record.type) {
 		case 133:
 			sheets.push(readBoundSheet(record));
@@ -33,18 +38,55 @@ function readWorkbookGlobals(records) {
 		case 224:
 			cellFormats.push(readCellFormat(record));
 			break;
-		case 34: date1904 = readDate1904(record);
+		case 34:
+			date1904 = readDate1904(record);
+			break;
+		case 430:
+			supBookSelfReferencing.push(isSelfReferencingSupBook(record));
+			break;
+		case 23:
+			externSheet = record;
+			break;
+		case 146: palette = readPalette(record);
 	}
 	const numberFormats = new Map(BUILTIN_NUMBER_FORMATS);
 	for (const [id, code] of customFormats) numberFormats.set(id, code);
+	const sheetRanges = externSheet === void 0 ? [] : readSheetRanges(externSheet, supBookSelfReferencing);
 	return {
 		sheets,
 		sharedStrings,
 		cellFormats,
 		numberFormats,
-		date1904
+		date1904,
+		sheetRanges,
+		palette,
+		printNames: readPrintNames(records)
 	};
 }
+/** [MS-XLS] 2.4.271's own cch table: a SupBook whose cch is exactly this value is a self-referencing supporting link -- this workbook itself -- rather than another workbook, a DDE/OLE data source, or an add-in. This is the only kind of supporting link a 3D reference resolves through here; every other kind genuinely needs bytes from outside this file. */
+const SUPBOOK_SELF_REFERENCING_CCH = 1025;
+/** SupBook ([MS-XLS] 2.4.271): a two-byte ctab then a two-byte cch. Only cch is read here -- ctab is undefined for a self-referencing SupBook and unused for every other kind this reader does not resolve, and the virtPath/rgst payload that would follow for a non-self-referencing link is never reached. */
+function isSelfReferencingSupBook(record) {
+	const cursor = new BlockCursor(record.blocks);
+	cursor.skip(2);
+	return cursor.u16() === SUPBOOK_SELF_REFERENCING_CCH;
+}
+/** ExternSheet ([MS-XLS] 2.4.106): a two-byte cXTI then that many XTI structures ([MS-XLS] 2.5.344) -- a two-byte iSupBook and two signed 16-bit sheet-scope bounds each. iSupBook indexes the SupBook collection positionally, in the order those records appeared. */
+function readSheetRanges(record, supBookSelfReferencing) {
+	const cursor = new BlockCursor(record.blocks);
+	const count = cursor.u16();
+	const ranges = [];
+	for (let index = 0; index < count; index += 1) {
+		const iSupBook = cursor.u16();
+		const itabFirst = cursor.i16();
+		const itabLast = cursor.i16();
+		ranges.push((supBookSelfReferencing[iSupBook] ?? false) && itabFirst >= 0 && itabLast >= 0 ? {
+			firstSheetIndex: itabFirst,
+			lastSheetIndex: itabLast
+		} : void 0);
+	}
+	return ranges;
+}
 /** BoundSheet8 ([MS-XLS] 2.4.28): a four-byte stream position, a byte of hidden state, a byte of sheet type, then the name as a ShortXLUnicodeString. */
 function readBoundSheet(record) {
 	const cursor = new BlockCursor(record.blocks);
@@ -78,15 +120,37 @@ function readFormat(record) {
 		code: readXLUnicodeString(cursor)
 	};
 }
-/** XF ([MS-XLS] 2.4.353): a font index, a number-format identifier, then a flags field whose fStyle bit says whether the trailing payload is a CellXF or a StyleXF. */
+/** XF ([MS-XLS] 2.4.353): a font index, a number-format identifier, a flags field whose fStyle bit says whether the trailing payload is a CellXF or a StyleXF, then that 14-byte trailing payload itself -- the leading alignment word xf-colors.ts's unpackXfAlignment resolves into this format's own `alignment`, then the border word, fill-pattern word, and fill-colour word its unpackXfDecoration resolves into this format's own `decoration`. CellXF and StyleXF share the identical alignment/border/fill bit layout ([MS-XLS] 2.4.353's own field table), so this reads both shapes uniformly regardless of isStyle -- a cell only ever references a CellXF entry by its own ixfe (workbook/sheet.ts's cell reading), so a StyleXF's alignment/decoration are parsed but never consulted downstream. */
 function readCellFormat(record) {
 	const cursor = new BlockCursor(record.blocks);
+	const fontIndex = cursor.u16();
+	const formatId = cursor.u16();
+	const flags = cursor.u16();
+	const word1 = cursor.u32();
+	const word2 = cursor.u32();
+	const word3 = cursor.u32();
+	const word4 = cursor.u16();
 	return {
-		fontIndex: cursor.u16(),
-		formatId: cursor.u16(),
-		isStyle: (cursor.u16() & XF_FLAG_STYLE) !== 0
+		fontIndex,
+		formatId,
+		isStyle: (flags & XF_FLAG_STYLE) !== 0,
+		alignment: unpackXfAlignment(word1),
+		decoration: unpackXfDecoration(word2, word3, word4)
 	};
 }
+/**
+* Palette ([MS-XLS] 2.4.188): ccv, a signed colour count the spec states "MUST be 56", then that many LongRGB entries -- the write-side mirror is xf-writer.ts's own writePaletteRecord.
+*
+* A ccv that is not 56 is refused rather than honoured. This reader resolves every icv 8-63 positionally through this table, so a short (or zero, or negative) one does not degrade gracefully: every colour past its end silently becomes unresolvable, and a workbook's fills and borders all vanish at once with nothing to say why. A file declaring a count its own spec forbids is malformed, and saying so is the only honest answer.
+*/
+function readPalette(record) {
+	const cursor = new BlockCursor(record.blocks);
+	const count = cursor.i16();
+	if (count !== 56) throw new BiffFormatError(`Palette declares ${count} colour entries, but [MS-XLS] 2.4.188's own ccv field MUST be 56`);
+	const colors = [];
+	for (let index = 0; index < count; index += 1) colors.push(readLongRgbColor(cursor));
+	return colors;
+}
 /** Date1904 ([MS-XLS] 2.4.77): a two-byte boolean. */
 function readDate1904(record) {
 	return new BlockCursor(record.blocks).u16() !== 0;