xls-codec 4.7.5 → 4.8.0

package/dist/workbook/chart.cjs

@@ -0,0 +1,230 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_biff_record_types = require("../biff/record-types.cjs");
+const require_biff_cursor = require("../biff/cursor.cjs");
+const require_biff_strings = require("../biff/strings.cjs");
+const require_biff_errors = require("../biff/errors.cjs");
+//#region src/workbook/chart.ts
+/** [MS-XLS] "BRAI" 2.4's own `id` enumeration: which data role a given AI record links. */
+const AI_ID_NAME = 0;
+const AI_ID_VALUES = 1;
+const AI_ID_CATEGORIES = 2;
+/** [MS-XLS] "BRAI" 2.4's own `rt` enumeration: 0 auto-generated (no formula/value at all), 1 a literal value/text carried directly in the formula's own token, 2 a genuine cell-range reference. */
+const AI_RT_LITERAL = 1;
+const AI_RT_RANGE = 2;
+/** [MS-XLS] "SIIndex" 2.4's own `numIndex` enumeration: which of the three SERIESDATA cache blocks follows. */
+const SIINDEX_VALUES = 1;
+const SIINDEX_CATEGORIES = 2;
+/** Reads one chart substream's records (BOF/EOF already stripped by splitSubstreams) into its flattened series table. */
+function readChartSeries(records, context) {
+	const seriesBuilders = [];
+	const cache = /* @__PURE__ */ new Map();
+	let currentCacheRole;
+	let pendingNameAiId;
+	for (const record of records) switch (record.type) {
+		case require_biff_record_types.RECORD_SERIES:
+			seriesBuilders.push(readSeriesHeader(record));
+			break;
+		case require_biff_record_types.RECORD_AI: {
+			const current = seriesBuilders[seriesBuilders.length - 1];
+			if (current !== void 0) readAiRecord(record, current, context);
+			pendingNameAiId = readAiId(record);
+			break;
+		}
+		case require_biff_record_types.RECORD_SERIESTEXT: {
+			const current = seriesBuilders[seriesBuilders.length - 1];
+			if (current !== void 0 && pendingNameAiId === AI_ID_NAME) current.cachedName = readSeriesText(record);
+			pendingNameAiId = void 0;
+			break;
+		}
+		case require_biff_record_types.RECORD_SIINDEX:
+			currentCacheRole = readCacheRole(record);
+			break;
+		case 515:
+		case 517:
+		case 513:
+		case 516: if (currentCacheRole !== void 0) addCacheEntry(cache, currentCacheRole, record);
+	}
+	return seriesBuilders.map((builder, seriesIndex) => ({
+		name: builder.cachedName ?? builder.literalName,
+		categories: resolvePoints(builder.categoryCount, seriesIndex, builder.categoriesRange, cache.get("categories"), context),
+		values: resolvePoints(builder.valueCount, seriesIndex, builder.valuesRange, cache.get("values"), context)
+	}));
+}
+/** [MS-OGRAPH] "Series" (https://learn.microsoft.com/en-us/openspecs/office_file_formats/ms-ograph/54527b2d-d529-4128-9a7f-a224cc575080): sdtX, sdtY (both a fixed, ignored data-type tag), cValx (category/point count), cValy (value count), sdtBSize (ignored), cValBSize (bubble-size count, not modelled). Only the two counts this reader actually resolves points against are kept. */
+function readSeriesHeader(record) {
+	const cursor = new require_biff_cursor.BlockCursor(record.blocks);
+	cursor.skip(2);
+	cursor.skip(2);
+	const categoryCount = cursor.u16();
+	return {
+		literalName: void 0,
+		cachedName: void 0,
+		valuesRange: void 0,
+		categoriesRange: void 0,
+		valueCount: cursor.u16(),
+		categoryCount
+	};
+}
+function readAiId(record) {
+	return new require_biff_cursor.BlockCursor(record.blocks).u8();
+}
+/** [MS-XLS] "BRAI": id, rt, a flags/ifmt word this reader skips past, then a ChartParsedFormula (cce + rgce). Only id 0 (name)/1 (values)/2 (categories) are acted on; id 3 (bubble sizes) is read past like any other record this reader recognises but does not model further. */
+function readAiRecord(record, series, context) {
+	const cursor = new require_biff_cursor.BlockCursor(record.blocks);
+	const id = cursor.u8();
+	const rt = cursor.u8();
+	cursor.skip(2);
+	cursor.skip(2);
+	const cce = cursor.u16();
+	const rgce = cursor.take(cce);
+	if (id === AI_ID_NAME) {
+		if (rt === AI_RT_LITERAL) series.literalName = readLiteralToken(rgce);
+		else if (rt === AI_RT_RANGE) {
+			const range = readRangeToken(rgce, context);
+			if (range !== void 0) series.literalName = cellText(range.startRow, range.startColumn, context);
+		}
+		return;
+	}
+	if (rt !== AI_RT_RANGE) return;
+	const range = readRangeToken(rgce, context);
+	if (id === AI_ID_VALUES) series.valuesRange = range;
+	else if (id === AI_ID_CATEGORIES) series.categoriesRange = range;
+}
+/** [MS-XLS] "SeriesText": a reserved word then a ShortXLUnicodeString (one-byte length prefix -- unlike the double-byte-length XLUnicodeString most other BIFF8 strings use). */
+function readSeriesText(record) {
+	const cursor = new require_biff_cursor.BlockCursor(record.blocks);
+	cursor.skip(2);
+	return require_biff_strings.readShortXLUnicodeString(cursor);
+}
+function readCacheRole(record) {
+	const numIndex = new require_biff_cursor.BlockCursor(record.blocks).u16();
+	if (numIndex === SIINDEX_VALUES) return "values";
+	if (numIndex === SIINDEX_CATEGORIES) return "categories";
+}
+/** A cached Number/BoolErr/Blank/Label record ([MS-XLS] 2.4.180/2.4.24/2.4.20/2.4.148 -- the identical worksheet cell-record layout, reinterpreted here per "Chart Data Cache": `row` is the point's own 0-based position within its series, `col` the 0-based Series-record index it belongs to, rather than a worksheet cell address). A Blank adds nothing to the cache -- an explicit "no cached value at this point" the same way an absent cache entry already reads. */
+function addCacheEntry(cache, role, record) {
+	const cursor = new require_biff_cursor.BlockCursor(record.blocks);
+	const point = cursor.u16();
+	const series = cursor.u16();
+	cursor.skip(2);
+	let text;
+	switch (record.type) {
+		case 515:
+			text = String(cursor.f64());
+			break;
+		case 516:
+			text = require_biff_strings.readXLUnicodeString(cursor);
+			break;
+		case 517: {
+			const value = cursor.u8();
+			text = cursor.u8() !== 0 ? require_biff_errors.errorTextOf(value) : value !== 0 ? "TRUE" : "FALSE";
+			break;
+		}
+		default: return;
+	}
+	if (text === void 0) return;
+	let bySeries = cache.get(role);
+	if (bySeries === void 0) {
+		bySeries = /* @__PURE__ */ new Map();
+		cache.set(role, bySeries);
+	}
+	let byPoint = bySeries.get(series);
+	if (byPoint === void 0) {
+		byPoint = /* @__PURE__ */ new Map();
+		bySeries.set(series, byPoint);
+	}
+	byPoint.set(point, text);
+}
+function resolvePoints(count, seriesIndex, range, cacheForRole, context) {
+	const cachedForSeries = cacheForRole?.get(seriesIndex);
+	const points = [];
+	for (let index = 0; index < count; index += 1) {
+		const cached = cachedForSeries?.get(index);
+		if (cached !== void 0) {
+			points.push(cached);
+			continue;
+		}
+		if (range !== void 0) {
+			const cell = pointInRange(range, index);
+			points.push(cellText(cell.row, cell.column, context) ?? "");
+			continue;
+		}
+		points.push("");
+	}
+	return points;
+}
+/** The Nth cell of a range, in reading order -- a single row walks across its columns, a single column (the common vertical-series case) walks down its rows, and a genuine rectangular box walks row-major. */
+function pointInRange(range, index) {
+	const height = range.endRow - range.startRow + 1;
+	const width = range.endColumn - range.startColumn + 1;
+	if (height <= 1) return {
+		row: range.startRow,
+		column: range.startColumn + index
+	};
+	if (width <= 1) return {
+		row: range.startRow + index,
+		column: range.startColumn
+	};
+	return {
+		row: range.startRow + Math.floor(index / width),
+		column: range.startColumn + index % width
+	};
+}
+function cellText(row, column, context) {
+	return context.ownSheetCells.find((cell) => cell.row === row && cell.column === column)?.displayText;
+}
+/** A literal AI value/text -- id=0 (name) only meets this in practice, real files always resolving categories/values through a real range. Reads exactly one leading token (skipping a PtgParen display wrapper first, since a literal is sometimes wrapped in one), and only the literal-operand family: PtgInt/PtgNum/PtgStr. Anything else is a construct this reader does not resolve, exactly like a formula token this package's own biff/ptg.ts declines to resolve elsewhere. */
+function readLiteralToken(rgce) {
+	const cursor = new require_biff_cursor.BlockCursor([rgce]);
+	if (!cursor.hasMore()) return;
+	let opcode = cursor.u8();
+	if (opcode === 21 && cursor.hasMore()) opcode = cursor.u8();
+	switch (opcode) {
+		case 30: return String(cursor.u16());
+		case 31: return String(cursor.f64());
+		case 23: return require_biff_strings.readShortXLUnicodeString(cursor);
+		default: return;
+	}
+}
+/** A range-reference AI value: PtgRef3d/PtgArea3d only, restricted to a reference INTO THE CHART'S OWN OWNING SHEET (see this module's own top comment for why a cross-sheet reference has no shortcut here) -- every other token this restricted BRAI grammar permits (PtgUnion, PtgNameX, PtgMemFunc, the RefErr/AreaErr variants) is a construct this reader does not resolve, matching biff/ptg.ts's own "unsupported construct -> absent" convention for a worksheet cell's ordinary Formula record. */
+function readRangeToken(rgce, context) {
+	const cursor = new require_biff_cursor.BlockCursor([rgce]);
+	if (!cursor.hasMore()) return;
+	let opcode = cursor.u8();
+	if (opcode === 21 && cursor.hasMore()) opcode = cursor.u8();
+	const COLUMN_INDEX_MASK = 16383;
+	if (opcode === 58 || opcode === 90 || opcode === 122) {
+		const ixti = cursor.u16();
+		const row = cursor.u16();
+		const column = cursor.u16() & COLUMN_INDEX_MASK;
+		if (!isOwnSheetRef(ixti, context)) return;
+		return {
+			startRow: row,
+			endRow: row,
+			startColumn: column,
+			endColumn: column
+		};
+	}
+	if (opcode === 59 || opcode === 91 || opcode === 123) {
+		const ixti = cursor.u16();
+		const rowFirst = cursor.u16();
+		const rowLast = cursor.u16();
+		const columnFirst = cursor.u16() & COLUMN_INDEX_MASK;
+		const columnLast = cursor.u16() & COLUMN_INDEX_MASK;
+		if (!isOwnSheetRef(ixti, context)) return;
+		return {
+			startRow: Math.min(rowFirst, rowLast),
+			endRow: Math.max(rowFirst, rowLast),
+			startColumn: Math.min(columnFirst, columnLast),
+			endColumn: Math.max(columnFirst, columnLast)
+		};
+	}
+}
+/** Whether ixti resolves (through EXTERNSHEET/SupBook -- the identical resolution biff/ptg.ts's resolveSheetLabel performs for a worksheet formula's own 3D references) to a single-sheet range naming exactly the chart's own owning sheet -- the only case this reader has a cell table to resolve against at all. */
+function isOwnSheetRef(ixti, context) {
+	const range = context.formulaSheets.sheetRanges[ixti];
+	if (range === void 0 || "label" in range) return false;
+	return range.firstSheetIndex === range.lastSheetIndex && range.firstSheetIndex === context.ownSheetIndex;
+}
+//#endregion
+exports.readChartSeries = readChartSeries;

package/dist/workbook/chart.d.cts

@@ -0,0 +1,19 @@
+import { r as FormulaSheetContext } from "../ptg-CCBbJLZJ.cjs";
+import { t as RecordGroup } from "../substreams-XDNgDvRJ.cjs";
+import { ContentSheetCell } from "document-schema.js";
+//#region src/workbook/chart.d.ts
+/** One resolved series: its own name (undefined when neither a SeriesText cache nor a literal/same-sheet-resolvable AI id=0 named it) and its category/value points, in point order, verbatim source text (a cache or a resolved cell's own displayText) -- exactly what readChartTable's own ChartSeries carries for the xlsx/pptx case, so chartCells below can build the identical flattened-table shape. A point this reader cannot resolve at all -- a cross-sheet or external reference with no cache entry, an unsupported AI token -- is an empty string, matching readChartTable's own "absent or empty-text label/value reads as an empty cell" convention. */
+interface ChartSeries {
+  readonly name: string | undefined;
+  readonly categories: readonly string[];
+  readonly values: readonly string[];
+}
+interface ChartRangeContext {
+  readonly formulaSheets: FormulaSheetContext;
+  readonly ownSheetIndex: number;
+  readonly ownSheetCells: readonly ContentSheetCell[];
+}
+/** Reads one chart substream's records (BOF/EOF already stripped by splitSubstreams) into its flattened series table. */
+declare function readChartSeries(records: readonly RecordGroup[], context: ChartRangeContext): readonly ChartSeries[];
+//#endregion
+export { ChartRangeContext, ChartSeries, readChartSeries };

package/dist/workbook/chart.d.ts

@@ -0,0 +1,19 @@
+import { r as FormulaSheetContext } from "../ptg-CCBbJLZJ.js";
+import { t as RecordGroup } from "../substreams-CgTHx5kX.js";
+import { ContentSheetCell } from "document-schema.js";
+//#region src/workbook/chart.d.ts
+/** One resolved series: its own name (undefined when neither a SeriesText cache nor a literal/same-sheet-resolvable AI id=0 named it) and its category/value points, in point order, verbatim source text (a cache or a resolved cell's own displayText) -- exactly what readChartTable's own ChartSeries carries for the xlsx/pptx case, so chartCells below can build the identical flattened-table shape. A point this reader cannot resolve at all -- a cross-sheet or external reference with no cache entry, an unsupported AI token -- is an empty string, matching readChartTable's own "absent or empty-text label/value reads as an empty cell" convention. */
+interface ChartSeries {
+  readonly name: string | undefined;
+  readonly categories: readonly string[];
+  readonly values: readonly string[];
+}
+interface ChartRangeContext {
+  readonly formulaSheets: FormulaSheetContext;
+  readonly ownSheetIndex: number;
+  readonly ownSheetCells: readonly ContentSheetCell[];
+}
+/** Reads one chart substream's records (BOF/EOF already stripped by splitSubstreams) into its flattened series table. */
+declare function readChartSeries(records: readonly RecordGroup[], context: ChartRangeContext): readonly ChartSeries[];
+//#endregion
+export { ChartRangeContext, ChartSeries, readChartSeries };

package/dist/workbook/chart.js

@@ -0,0 +1,229 @@
+import { RECORD_AI, RECORD_SERIES, RECORD_SERIESTEXT, RECORD_SIINDEX } from "../biff/record-types.js";
+import { BlockCursor } from "../biff/cursor.js";
+import { readShortXLUnicodeString, readXLUnicodeString } from "../biff/strings.js";
+import { errorTextOf } from "../biff/errors.js";
+//#region src/workbook/chart.ts
+/** [MS-XLS] "BRAI" 2.4's own `id` enumeration: which data role a given AI record links. */
+const AI_ID_NAME = 0;
+const AI_ID_VALUES = 1;
+const AI_ID_CATEGORIES = 2;
+/** [MS-XLS] "BRAI" 2.4's own `rt` enumeration: 0 auto-generated (no formula/value at all), 1 a literal value/text carried directly in the formula's own token, 2 a genuine cell-range reference. */
+const AI_RT_LITERAL = 1;
+const AI_RT_RANGE = 2;
+/** [MS-XLS] "SIIndex" 2.4's own `numIndex` enumeration: which of the three SERIESDATA cache blocks follows. */
+const SIINDEX_VALUES = 1;
+const SIINDEX_CATEGORIES = 2;
+/** Reads one chart substream's records (BOF/EOF already stripped by splitSubstreams) into its flattened series table. */
+function readChartSeries(records, context) {
+	const seriesBuilders = [];
+	const cache = /* @__PURE__ */ new Map();
+	let currentCacheRole;
+	let pendingNameAiId;
+	for (const record of records) switch (record.type) {
+		case RECORD_SERIES:
+			seriesBuilders.push(readSeriesHeader(record));
+			break;
+		case RECORD_AI: {
+			const current = seriesBuilders[seriesBuilders.length - 1];
+			if (current !== void 0) readAiRecord(record, current, context);
+			pendingNameAiId = readAiId(record);
+			break;
+		}
+		case RECORD_SERIESTEXT: {
+			const current = seriesBuilders[seriesBuilders.length - 1];
+			if (current !== void 0 && pendingNameAiId === AI_ID_NAME) current.cachedName = readSeriesText(record);
+			pendingNameAiId = void 0;
+			break;
+		}
+		case RECORD_SIINDEX:
+			currentCacheRole = readCacheRole(record);
+			break;
+		case 515:
+		case 517:
+		case 513:
+		case 516: if (currentCacheRole !== void 0) addCacheEntry(cache, currentCacheRole, record);
+	}
+	return seriesBuilders.map((builder, seriesIndex) => ({
+		name: builder.cachedName ?? builder.literalName,
+		categories: resolvePoints(builder.categoryCount, seriesIndex, builder.categoriesRange, cache.get("categories"), context),
+		values: resolvePoints(builder.valueCount, seriesIndex, builder.valuesRange, cache.get("values"), context)
+	}));
+}
+/** [MS-OGRAPH] "Series" (https://learn.microsoft.com/en-us/openspecs/office_file_formats/ms-ograph/54527b2d-d529-4128-9a7f-a224cc575080): sdtX, sdtY (both a fixed, ignored data-type tag), cValx (category/point count), cValy (value count), sdtBSize (ignored), cValBSize (bubble-size count, not modelled). Only the two counts this reader actually resolves points against are kept. */
+function readSeriesHeader(record) {
+	const cursor = new BlockCursor(record.blocks);
+	cursor.skip(2);
+	cursor.skip(2);
+	const categoryCount = cursor.u16();
+	return {
+		literalName: void 0,
+		cachedName: void 0,
+		valuesRange: void 0,
+		categoriesRange: void 0,
+		valueCount: cursor.u16(),
+		categoryCount
+	};
+}
+function readAiId(record) {
+	return new BlockCursor(record.blocks).u8();
+}
+/** [MS-XLS] "BRAI": id, rt, a flags/ifmt word this reader skips past, then a ChartParsedFormula (cce + rgce). Only id 0 (name)/1 (values)/2 (categories) are acted on; id 3 (bubble sizes) is read past like any other record this reader recognises but does not model further. */
+function readAiRecord(record, series, context) {
+	const cursor = new BlockCursor(record.blocks);
+	const id = cursor.u8();
+	const rt = cursor.u8();
+	cursor.skip(2);
+	cursor.skip(2);
+	const cce = cursor.u16();
+	const rgce = cursor.take(cce);
+	if (id === AI_ID_NAME) {
+		if (rt === AI_RT_LITERAL) series.literalName = readLiteralToken(rgce);
+		else if (rt === AI_RT_RANGE) {
+			const range = readRangeToken(rgce, context);
+			if (range !== void 0) series.literalName = cellText(range.startRow, range.startColumn, context);
+		}
+		return;
+	}
+	if (rt !== AI_RT_RANGE) return;
+	const range = readRangeToken(rgce, context);
+	if (id === AI_ID_VALUES) series.valuesRange = range;
+	else if (id === AI_ID_CATEGORIES) series.categoriesRange = range;
+}
+/** [MS-XLS] "SeriesText": a reserved word then a ShortXLUnicodeString (one-byte length prefix -- unlike the double-byte-length XLUnicodeString most other BIFF8 strings use). */
+function readSeriesText(record) {
+	const cursor = new BlockCursor(record.blocks);
+	cursor.skip(2);
+	return readShortXLUnicodeString(cursor);
+}
+function readCacheRole(record) {
+	const numIndex = new BlockCursor(record.blocks).u16();
+	if (numIndex === SIINDEX_VALUES) return "values";
+	if (numIndex === SIINDEX_CATEGORIES) return "categories";
+}
+/** A cached Number/BoolErr/Blank/Label record ([MS-XLS] 2.4.180/2.4.24/2.4.20/2.4.148 -- the identical worksheet cell-record layout, reinterpreted here per "Chart Data Cache": `row` is the point's own 0-based position within its series, `col` the 0-based Series-record index it belongs to, rather than a worksheet cell address). A Blank adds nothing to the cache -- an explicit "no cached value at this point" the same way an absent cache entry already reads. */
+function addCacheEntry(cache, role, record) {
+	const cursor = new BlockCursor(record.blocks);
+	const point = cursor.u16();
+	const series = cursor.u16();
+	cursor.skip(2);
+	let text;
+	switch (record.type) {
+		case 515:
+			text = String(cursor.f64());
+			break;
+		case 516:
+			text = readXLUnicodeString(cursor);
+			break;
+		case 517: {
+			const value = cursor.u8();
+			text = cursor.u8() !== 0 ? errorTextOf(value) : value !== 0 ? "TRUE" : "FALSE";
+			break;
+		}
+		default: return;
+	}
+	if (text === void 0) return;
+	let bySeries = cache.get(role);
+	if (bySeries === void 0) {
+		bySeries = /* @__PURE__ */ new Map();
+		cache.set(role, bySeries);
+	}
+	let byPoint = bySeries.get(series);
+	if (byPoint === void 0) {
+		byPoint = /* @__PURE__ */ new Map();
+		bySeries.set(series, byPoint);
+	}
+	byPoint.set(point, text);
+}
+function resolvePoints(count, seriesIndex, range, cacheForRole, context) {
+	const cachedForSeries = cacheForRole?.get(seriesIndex);
+	const points = [];
+	for (let index = 0; index < count; index += 1) {
+		const cached = cachedForSeries?.get(index);
+		if (cached !== void 0) {
+			points.push(cached);
+			continue;
+		}
+		if (range !== void 0) {
+			const cell = pointInRange(range, index);
+			points.push(cellText(cell.row, cell.column, context) ?? "");
+			continue;
+		}
+		points.push("");
+	}
+	return points;
+}
+/** The Nth cell of a range, in reading order -- a single row walks across its columns, a single column (the common vertical-series case) walks down its rows, and a genuine rectangular box walks row-major. */
+function pointInRange(range, index) {
+	const height = range.endRow - range.startRow + 1;
+	const width = range.endColumn - range.startColumn + 1;
+	if (height <= 1) return {
+		row: range.startRow,
+		column: range.startColumn + index
+	};
+	if (width <= 1) return {
+		row: range.startRow + index,
+		column: range.startColumn
+	};
+	return {
+		row: range.startRow + Math.floor(index / width),
+		column: range.startColumn + index % width
+	};
+}
+function cellText(row, column, context) {
+	return context.ownSheetCells.find((cell) => cell.row === row && cell.column === column)?.displayText;
+}
+/** A literal AI value/text -- id=0 (name) only meets this in practice, real files always resolving categories/values through a real range. Reads exactly one leading token (skipping a PtgParen display wrapper first, since a literal is sometimes wrapped in one), and only the literal-operand family: PtgInt/PtgNum/PtgStr. Anything else is a construct this reader does not resolve, exactly like a formula token this package's own biff/ptg.ts declines to resolve elsewhere. */
+function readLiteralToken(rgce) {
+	const cursor = new BlockCursor([rgce]);
+	if (!cursor.hasMore()) return;
+	let opcode = cursor.u8();
+	if (opcode === 21 && cursor.hasMore()) opcode = cursor.u8();
+	switch (opcode) {
+		case 30: return String(cursor.u16());
+		case 31: return String(cursor.f64());
+		case 23: return readShortXLUnicodeString(cursor);
+		default: return;
+	}
+}
+/** A range-reference AI value: PtgRef3d/PtgArea3d only, restricted to a reference INTO THE CHART'S OWN OWNING SHEET (see this module's own top comment for why a cross-sheet reference has no shortcut here) -- every other token this restricted BRAI grammar permits (PtgUnion, PtgNameX, PtgMemFunc, the RefErr/AreaErr variants) is a construct this reader does not resolve, matching biff/ptg.ts's own "unsupported construct -> absent" convention for a worksheet cell's ordinary Formula record. */
+function readRangeToken(rgce, context) {
+	const cursor = new BlockCursor([rgce]);
+	if (!cursor.hasMore()) return;
+	let opcode = cursor.u8();
+	if (opcode === 21 && cursor.hasMore()) opcode = cursor.u8();
+	const COLUMN_INDEX_MASK = 16383;
+	if (opcode === 58 || opcode === 90 || opcode === 122) {
+		const ixti = cursor.u16();
+		const row = cursor.u16();
+		const column = cursor.u16() & COLUMN_INDEX_MASK;
+		if (!isOwnSheetRef(ixti, context)) return;
+		return {
+			startRow: row,
+			endRow: row,
+			startColumn: column,
+			endColumn: column
+		};
+	}
+	if (opcode === 59 || opcode === 91 || opcode === 123) {
+		const ixti = cursor.u16();
+		const rowFirst = cursor.u16();
+		const rowLast = cursor.u16();
+		const columnFirst = cursor.u16() & COLUMN_INDEX_MASK;
+		const columnLast = cursor.u16() & COLUMN_INDEX_MASK;
+		if (!isOwnSheetRef(ixti, context)) return;
+		return {
+			startRow: Math.min(rowFirst, rowLast),
+			endRow: Math.max(rowFirst, rowLast),
+			startColumn: Math.min(columnFirst, columnLast),
+			endColumn: Math.max(columnFirst, columnLast)
+		};
+	}
+}
+/** Whether ixti resolves (through EXTERNSHEET/SupBook -- the identical resolution biff/ptg.ts's resolveSheetLabel performs for a worksheet formula's own 3D references) to a single-sheet range naming exactly the chart's own owning sheet -- the only case this reader has a cell table to resolve against at all. */
+function isOwnSheetRef(ixti, context) {
+	const range = context.formulaSheets.sheetRanges[ixti];
+	if (range === void 0 || "label" in range) return false;
+	return range.firstSheetIndex === range.lastSheetIndex && range.firstSheetIndex === context.ownSheetIndex;
+}
+//#endregion
+export { readChartSeries };

package/dist/workbook/comments.cjs

@@ -24,7 +24,7 @@ function readNoteAnchor(group) {
 		idObj
 	};
 }
-/** [MS-XLS] 2.5.92 FtCmo, read only far enough to answer "is this a Note object, and if so, what id does its own TxO get associated through": ft/cb are fixed reserved values this reader does not validate, ot is the object type, id is what a Note record's idObj cross-references. */
+/** [MS-XLS] 2.5.92 FtCmo, read only far enough to answer "what kind of drawing object is this, and what id does a following TxO/other per-object record cross-reference": ft/cb are fixed reserved values this reader does not validate, ot is the object type, id is what a Note record's idObj (here) and workbook/drawing.ts's own shape pairing (there) both key on. Exported for workbook/drawing.ts, which pairs each MsoDrawing shape with the Obj record immediately naming it -- the identical FtCmo structure every Obj record carries, comment-anchored or not. */
 function readObjTypeAndId(group) {
 	const cursor = new require_biff_cursor.BlockCursor(group.blocks);
 	cursor.skip(4);
@@ -82,4 +82,5 @@ function readSheetComments(records) {
 	return comments;
 }
 //#endregion
+exports.readObjTypeAndId = readObjTypeAndId;
 exports.readSheetComments = readSheetComments;

package/dist/workbook/comments.d.cts

@@ -1,4 +1,4 @@
-import { t as RecordGroup } from "../substreams-CHv3oWmn.cjs";
+import { t as RecordGroup } from "../substreams-XDNgDvRJ.cjs";
 import { ContentSheetCellComment } from "document-schema.js";
 //#region src/workbook/comments.d.ts
 /** One comment, resolved to the cell position it is anchored to. */
@@ -7,7 +7,12 @@ interface SheetCellComment {
   readonly column: number;
   readonly comment: ContentSheetCellComment;
 }
+/** [MS-XLS] 2.5.92 FtCmo, read only far enough to answer "what kind of drawing object is this, and what id does a following TxO/other per-object record cross-reference": ft/cb are fixed reserved values this reader does not validate, ot is the object type, id is what a Note record's idObj (here) and workbook/drawing.ts's own shape pairing (there) both key on. Exported for workbook/drawing.ts, which pairs each MsoDrawing shape with the Obj record immediately naming it -- the identical FtCmo structure every Obj record carries, comment-anchored or not. */
+declare function readObjTypeAndId(group: RecordGroup): {
+  readonly ot: number;
+  readonly id: number;
+};
 /** Every cell comment a worksheet substream's records carry, keyed `${row}:${column}` to match ooxml.js's own readSheetCellComments convention. A Note record whose idObj resolves to no Obj+TxO pair (a malformed or unusually ordered file) is skipped rather than materialised with fabricated or missing text -- this reader is tolerant of unusual record ordering elsewhere in the substream (see workbook/sheet.ts's own top comment) but a comment with no recoverable text is not real content worth keeping. */
 declare function readSheetComments(records: readonly RecordGroup[]): ReadonlyMap<string, SheetCellComment>;
 //#endregion
-export { SheetCellComment, readSheetComments };
+export { SheetCellComment, readObjTypeAndId, readSheetComments };

package/dist/workbook/comments.d.ts

@@ -1,4 +1,4 @@
-import { t as RecordGroup } from "../substreams-Dp5cZoUo.js";
+import { t as RecordGroup } from "../substreams-CgTHx5kX.js";
 import { ContentSheetCellComment } from "document-schema.js";
 //#region src/workbook/comments.d.ts
 /** One comment, resolved to the cell position it is anchored to. */
@@ -7,7 +7,12 @@ interface SheetCellComment {
   readonly column: number;
   readonly comment: ContentSheetCellComment;
 }
+/** [MS-XLS] 2.5.92 FtCmo, read only far enough to answer "what kind of drawing object is this, and what id does a following TxO/other per-object record cross-reference": ft/cb are fixed reserved values this reader does not validate, ot is the object type, id is what a Note record's idObj (here) and workbook/drawing.ts's own shape pairing (there) both key on. Exported for workbook/drawing.ts, which pairs each MsoDrawing shape with the Obj record immediately naming it -- the identical FtCmo structure every Obj record carries, comment-anchored or not. */
+declare function readObjTypeAndId(group: RecordGroup): {
+  readonly ot: number;
+  readonly id: number;
+};
 /** Every cell comment a worksheet substream's records carry, keyed `${row}:${column}` to match ooxml.js's own readSheetCellComments convention. A Note record whose idObj resolves to no Obj+TxO pair (a malformed or unusually ordered file) is skipped rather than materialised with fabricated or missing text -- this reader is tolerant of unusual record ordering elsewhere in the substream (see workbook/sheet.ts's own top comment) but a comment with no recoverable text is not real content worth keeping. */
 declare function readSheetComments(records: readonly RecordGroup[]): ReadonlyMap<string, SheetCellComment>;
 //#endregion
-export { SheetCellComment, readSheetComments };
+export { SheetCellComment, readObjTypeAndId, readSheetComments };

package/dist/workbook/comments.js

@@ -23,7 +23,7 @@ function readNoteAnchor(group) {
 		idObj
 	};
 }
-/** [MS-XLS] 2.5.92 FtCmo, read only far enough to answer "is this a Note object, and if so, what id does its own TxO get associated through": ft/cb are fixed reserved values this reader does not validate, ot is the object type, id is what a Note record's idObj cross-references. */
+/** [MS-XLS] 2.5.92 FtCmo, read only far enough to answer "what kind of drawing object is this, and what id does a following TxO/other per-object record cross-reference": ft/cb are fixed reserved values this reader does not validate, ot is the object type, id is what a Note record's idObj (here) and workbook/drawing.ts's own shape pairing (there) both key on. Exported for workbook/drawing.ts, which pairs each MsoDrawing shape with the Obj record immediately naming it -- the identical FtCmo structure every Obj record carries, comment-anchored or not. */
 function readObjTypeAndId(group) {
 	const cursor = new BlockCursor(group.blocks);
 	cursor.skip(4);
@@ -81,4 +81,4 @@ function readSheetComments(records) {
 	return comments;
 }
 //#endregion
-export { readSheetComments };
+export { readObjTypeAndId, readSheetComments };

package/dist/workbook/conditional-format-12.d.cts

@@ -1,2 +1,2 @@
-import { a as RawConditionalFormat12, c as RawSimpleFilterFormat, d as RawTop10Format, f as readCondFmt12Group, i as RawColorScaleFormat, l as RawTimePeriod, n as RawAboveAverageFormat, o as RawDataBarFormat, r as RawCfColor, s as RawIconSetFormat, t as CondFmt12GroupResult, u as RawTimePeriodFormat } from "../conditional-format-12-DBhe7Zo6.cjs";
+import { a as RawConditionalFormat12, c as RawSimpleFilterFormat, d as RawTop10Format, f as readCondFmt12Group, i as RawColorScaleFormat, l as RawTimePeriod, n as RawAboveAverageFormat, o as RawDataBarFormat, r as RawCfColor, s as RawIconSetFormat, t as CondFmt12GroupResult, u as RawTimePeriodFormat } from "../conditional-format-12-CZ43-CR4.cjs";
 export { CondFmt12GroupResult, RawAboveAverageFormat, RawCfColor, RawColorScaleFormat, RawConditionalFormat12, RawDataBarFormat, RawIconSetFormat, RawSimpleFilterFormat, RawTimePeriod, RawTimePeriodFormat, RawTop10Format, readCondFmt12Group };

package/dist/workbook/conditional-format-12.d.ts

@@ -1,2 +1,2 @@
-import { a as RawConditionalFormat12, c as RawSimpleFilterFormat, d as RawTop10Format, f as readCondFmt12Group, i as RawColorScaleFormat, l as RawTimePeriod, n as RawAboveAverageFormat, o as RawDataBarFormat, r as RawCfColor, s as RawIconSetFormat, t as CondFmt12GroupResult, u as RawTimePeriodFormat } from "../conditional-format-12-D-X5g_O3.js";
+import { a as RawConditionalFormat12, c as RawSimpleFilterFormat, d as RawTop10Format, f as readCondFmt12Group, i as RawColorScaleFormat, l as RawTimePeriod, n as RawAboveAverageFormat, o as RawDataBarFormat, r as RawCfColor, s as RawIconSetFormat, t as CondFmt12GroupResult, u as RawTimePeriodFormat } from "../conditional-format-12-Xl52VBCj.js";
 export { CondFmt12GroupResult, RawAboveAverageFormat, RawCfColor, RawColorScaleFormat, RawConditionalFormat12, RawDataBarFormat, RawIconSetFormat, RawSimpleFilterFormat, RawTimePeriod, RawTimePeriodFormat, RawTop10Format, readCondFmt12Group };

package/dist/workbook/conditional-format.d.cts

@@ -1,2 +1,2 @@
-import { a as parseDxfStyle, i as RawConditionalFormatStyle, n as RawConditionalFormat, o as readCondFmtGroup, r as RawConditionalFormatFill, t as CondFmtGroupResult } from "../conditional-format-Czh2oTzQ.cjs";
+import { a as parseDxfStyle, i as RawConditionalFormatStyle, n as RawConditionalFormat, o as readCondFmtGroup, r as RawConditionalFormatFill, t as CondFmtGroupResult } from "../conditional-format-Bt1vRWgc.cjs";
 export { CondFmtGroupResult, RawConditionalFormat, RawConditionalFormatFill, RawConditionalFormatStyle, parseDxfStyle, readCondFmtGroup };

package/dist/workbook/conditional-format.d.ts

@@ -1,2 +1,2 @@
-import { a as parseDxfStyle, i as RawConditionalFormatStyle, n as RawConditionalFormat, o as readCondFmtGroup, r as RawConditionalFormatFill, t as CondFmtGroupResult } from "../conditional-format-DOdazxWe.js";
+import { a as parseDxfStyle, i as RawConditionalFormatStyle, n as RawConditionalFormat, o as readCondFmtGroup, r as RawConditionalFormatFill, t as CondFmtGroupResult } from "../conditional-format-Cqcjnm7O.js";
 export { CondFmtGroupResult, RawConditionalFormat, RawConditionalFormatFill, RawConditionalFormatStyle, parseDxfStyle, readCondFmtGroup };

package/dist/workbook/data-validation.d.cts

@@ -1,2 +1,2 @@
-import { n as readDv, t as RawDataValidation } from "../data-validation-DfpjUN-N.cjs";
+import { n as readDv, t as RawDataValidation } from "../data-validation-lJWM9-AP.cjs";
 export { RawDataValidation, readDv };

package/dist/workbook/data-validation.d.ts

@@ -1,2 +1,2 @@
-import { n as readDv, t as RawDataValidation } from "../data-validation-BXvIVU0e.js";
+import { n as readDv, t as RawDataValidation } from "../data-validation-BeYpL3Nb.js";
 export { RawDataValidation, readDv };