@bilig/xlsx 0.164.0

package/dist/streaming-native-workbook-core.js

@@ -0,0 +1,110 @@
+import { createFileXlsxSourceReader } from './file-source.js';
+import { workbookSheetPathEntriesForSource } from './workbook-sheet-paths.js';
+import { forEachInflatedXlsxZipEntryChunk, getZipText, readXlsxZipEntriesLazyFromByteSource, readXlsxZipEntryMetadata, } from './zip-reader.js';
+export class StreamingNativeWorkbookOpenError extends Error {
+    reason;
+    inputBytes;
+    constructor(message, reason, inputBytes) {
+        super(message);
+        this.name = 'StreamingNativeWorkbookOpenError';
+        this.reason = reason;
+        this.inputBytes = inputBytes;
+    }
+}
+export function openStreamingNativeWorkbookCore(inputPath, options = {}) {
+    const source = createFileXlsxSourceReader(inputPath);
+    const inputBytes = source.byteLength;
+    try {
+        const phaseInfo = { inputBytes };
+        options.onPhase?.('open-source', phaseInfo);
+        const entryMetadata = readXlsxZipEntryMetadata(source);
+        const zip = readXlsxZipEntriesLazyFromByteSource(source);
+        if (!zip) {
+            throw new StreamingNativeWorkbookOpenError('XLSX native streaming core requires a ZIP central directory it can read lazily', 'invalid-or-zip64-xlsx', inputBytes);
+        }
+        options.onPhase?.('zip-central-directory', phaseInfo);
+        const sheetEntries = workbookSheetPathEntriesForSource(zip);
+        options.onPhase?.('workbook-metadata', phaseInfo);
+        return {
+            inputPath,
+            inputBytes,
+            source,
+            zip,
+            sheetEntries,
+            sheetNames: sheetEntries.map((sheet) => sheet.name),
+            entryMetadata: entryMetadata ?? [],
+        };
+    }
+    catch (error) {
+        source.release?.();
+        throw error;
+    }
+}
+export function closeStreamingNativeWorkbookCore(core) {
+    core.source.release?.();
+}
+export function withStreamingNativeWorkbookCore(inputPath, options, callback) {
+    const core = openStreamingNativeWorkbookCore(inputPath, options);
+    try {
+        return callback(core);
+    }
+    finally {
+        closeStreamingNativeWorkbookCore(core);
+    }
+}
+const textDecoder = new TextDecoder();
+const worksheetCellStartTagPattern = /<(?:[A-Za-z_][\w.-]*:)?c\b/gu;
+const worksheetCellStartCarryLength = 128;
+export function scanStreamingNativeWorkbookCellStats(core) {
+    let nonEmptyCellCount = 0;
+    for (const sheet of core.sheetEntries) {
+        nonEmptyCellCount += countStreamingNativeWorksheetCellElements(core.zip, sheet.path);
+    }
+    return {
+        sheetNames: core.sheetEntries.map((sheet) => sheet.name),
+        nonEmptyCellCount,
+    };
+}
+export function scanStreamingNativeWorkbookPackageParts(input) {
+    const entryMetadata = input.entryMetadata ?? [];
+    const paths = entryMetadata.length > 0 ? entryMetadata.map((entry) => entry.path) : Object.keys(input.zip);
+    const metadataByPath = new Map(entryMetadata.map((entry) => [entry.path, entry]));
+    const workbookXml = getZipText(input.zip, 'xl/workbook.xml') ?? '';
+    const externalReferenceCount = workbookXml.match(/<(?:[A-Za-z_][\w.-]*:)?externalReference\b/gu)?.length ?? 0;
+    const externalLinkPartCount = paths.filter((path) => /^xl\/externalLinks\/externalLink[0-9]+\.xml$/u.test(path)).length;
+    const macroPaths = paths.filter((path) => /(?:^|\/)vbaProject\.bin$/iu.test(path));
+    return {
+        definedNameCount: workbookXml.match(/<(?:[A-Za-z_][\w.-]*:)?definedName\b/gu)?.length ?? 0,
+        tableCount: paths.filter((path) => /^xl\/tables\/[^/]+\.xml$/u.test(path)).length,
+        pivotTableCount: paths.filter((path) => /^xl\/pivotTables\/[^/]+\.xml$/u.test(path)).length,
+        chartCount: paths.filter((path) => /^xl\/charts\/[^/]+\.xml$/u.test(path) || /^xl\/chartsheets\/[^/]+\.xml$/u.test(path)).length,
+        macroModuleCount: macroPaths.length,
+        macroByteLength: macroPaths.reduce((sum, path) => sum + (metadataByPath.get(path)?.uncompressedSize ?? input.zip[path]?.byteLength ?? 0), 0),
+        externalLinkCount: Math.max(externalReferenceCount, externalLinkPartCount),
+    };
+}
+function countStreamingNativeWorksheetCellElements(zip, sheetPath) {
+    let count = 0;
+    let buffer = '';
+    const processBuffer = (final) => {
+        const safeEnd = final ? buffer.length : Math.max(0, buffer.length - worksheetCellStartCarryLength);
+        if (safeEnd === 0 && !final) {
+            return;
+        }
+        for (const _match of buffer.slice(0, safeEnd).matchAll(worksheetCellStartTagPattern)) {
+            count += 1;
+        }
+        buffer = buffer.slice(safeEnd);
+    };
+    const streamed = forEachInflatedXlsxZipEntryChunk(zip, sheetPath, (chunk) => {
+        buffer += textDecoder.decode(chunk, { stream: true });
+        processBuffer(false);
+    }, { chunkSize: 64 * 1024, forceStreamingInflate: true });
+    if (!streamed) {
+        return 0;
+    }
+    buffer += textDecoder.decode();
+    processBuffer(true);
+    return count;
+}
+//# sourceMappingURL=streaming-native-workbook-core.js.map

package/dist/streaming-native-workbook-core.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"streaming-native-workbook-core.js","sourceRoot":"","sources":["../src/streaming-native-workbook-core.ts"],"names":[],"mappings":"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"}

package/dist/targeted-cell-reader.d.ts

@@ -0,0 +1,11 @@
+import { type XlsxZipSource } from './zip-reader.js';
+export type XlsxTargetCellValue = string | number | boolean;
+export interface XlsxTargetCellReadback {
+    readonly address: string;
+    readonly formula: string | null;
+    readonly rawValue: string | null;
+    readonly styleIndex: number | null;
+    readonly type: string | null;
+    readonly value: XlsxTargetCellValue | null;
+}
+export declare function readXlsxTargetCell(source: XlsxZipSource, sheetName: string, address: string): XlsxTargetCellReadback | null;

package/dist/targeted-cell-reader.js

@@ -0,0 +1,92 @@
+import { normalizeCellAddress } from './address.js';
+import { workbookSheetPathEntriesFromSource } from './workbook-sheet-paths.js';
+import { decodeXmlText, getXmlElementText, readXmlAttribute, worksheetCellElementPattern } from './xml.js';
+import { getZipText, readXlsxZipEntries } from './zip-reader.js';
+export function readXlsxTargetCell(source, sheetName, address) {
+    const zip = readXlsxZipEntries(source);
+    const sheetPath = workbookSheetPathEntriesFromSource(zip, [sheetName])[0]?.path;
+    if (!sheetPath) {
+        throw new Error(`XLSX workbook is missing sheet: ${sheetName}`);
+    }
+    const sheetXml = getZipText(zip, sheetPath);
+    if (!sheetXml) {
+        throw new Error(`XLSX workbook is missing worksheet XML for sheet: ${sheetName}`);
+    }
+    const normalizedAddress = normalizeCellAddress(address);
+    const cellXml = readWorksheetCellXml(sheetXml, normalizedAddress);
+    if (!cellXml) {
+        return null;
+    }
+    return readTargetCellXml(cellXml, normalizedAddress, (index) => readSharedStringAt(zip, index));
+}
+function readTargetCellXml(cellXml, normalizedAddress, sharedStringAt) {
+    const openingTag = /^<[^>]+>/u.exec(cellXml)?.[0] ?? '';
+    const type = readXmlAttribute(openingTag, 't');
+    const rawValue = getXmlElementText(cellXml, 'v');
+    const styleIndex = readCellStyleIndex(openingTag);
+    const formulaText = getXmlElementText(cellXml, 'f');
+    return {
+        address: normalizedAddress,
+        formula: formulaText === null ? null : decodeXmlText(formulaText),
+        rawValue: rawValue === null ? null : decodeXmlText(rawValue),
+        styleIndex,
+        type,
+        value: readTargetCellValue(cellXml, type, rawValue, sharedStringAt),
+    };
+}
+function readWorksheetCellXml(sheetXml, normalizedAddress) {
+    for (const match of sheetXml.matchAll(worksheetCellElementPattern)) {
+        const cellXml = match[0];
+        const openingTag = /^<[^>]+>/u.exec(cellXml)?.[0] ?? '';
+        if (readXmlAttribute(openingTag, 'r') === normalizedAddress) {
+            return cellXml;
+        }
+    }
+    return null;
+}
+function readTargetCellValue(cellXml, type, rawValue, sharedStringAt) {
+    if (type === 'inlineStr') {
+        const inlineText = readRichTextValue(cellXml);
+        return inlineText.length > 0 ? inlineText : null;
+    }
+    if (rawValue === null) {
+        return null;
+    }
+    const value = decodeXmlText(rawValue);
+    if (type === 's') {
+        const sharedStringIndex = Number(value);
+        return Number.isSafeInteger(sharedStringIndex) && sharedStringIndex >= 0 ? sharedStringAt(sharedStringIndex) : null;
+    }
+    if (type === 'b') {
+        return value === '1' || value.toLowerCase() === 'true';
+    }
+    if (type === 'str' || type === 'e') {
+        return value;
+    }
+    const numericValue = Number(value);
+    return Number.isFinite(numericValue) ? numericValue : value;
+}
+function readSharedStringAt(zip, index) {
+    const xml = getZipText(readXlsxZipEntries(zip), 'xl/sharedStrings.xml');
+    if (!xml) {
+        return null;
+    }
+    let currentIndex = 0;
+    for (const match of xml.matchAll(/<si\b(?:[^>"']|"[^"]*"|'[^']*')*>[\s\S]*?<\/si>/gu)) {
+        if (currentIndex === index) {
+            return readRichTextValue(match[0]);
+        }
+        currentIndex += 1;
+    }
+    return null;
+}
+function readRichTextValue(xml) {
+    return [...xml.matchAll(/<(?:[A-Za-z_][\w.-]*:)?t\b(?:[^>"']|"[^"]*"|'[^']*')*>([\s\S]*?)<\/(?:[A-Za-z_][\w.-]*:)?t>/gu)]
+        .map((match) => decodeXmlText(match[1] ?? ''))
+        .join('');
+}
+function readCellStyleIndex(openingTag) {
+    const styleIndex = Number(readXmlAttribute(openingTag, 's'));
+    return Number.isInteger(styleIndex) && styleIndex >= 0 ? styleIndex : null;
+}
+//# sourceMappingURL=targeted-cell-reader.js.map

package/dist/targeted-cell-reader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"targeted-cell-reader.js","sourceRoot":"","sources":["../src/targeted-cell-reader.ts"],"names":[],"mappings":"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"}

package/dist/workbook-cell-reader.d.ts

@@ -0,0 +1,29 @@
+import { type XlsxCellRange } from './address.js';
+import { type XlsxZipSource } from './zip-reader.js';
+export type XlsxWorkbookCellValue = string | number | boolean;
+export interface XlsxWorkbookCell {
+    readonly address: string;
+    readonly row: number;
+    readonly col: number;
+    readonly formula: string | null;
+    readonly hasValue: boolean;
+    readonly rawValue: string | null;
+    readonly styleIndex: number | null;
+    readonly type: string | null;
+    readonly value: XlsxWorkbookCellValue | null;
+}
+export interface XlsxWorkbookSheetCells {
+    readonly name: string;
+    readonly index: number;
+    readonly path: string;
+    readonly cells: readonly XlsxWorkbookCell[];
+    readonly range: XlsxCellRange;
+    readonly rowCount: number;
+    readonly columnCount: number;
+}
+export interface XlsxWorkbookCells {
+    readonly sheets: readonly XlsxWorkbookSheetCells[];
+    readonly hasFormulaMarkup: boolean;
+    readonly hasUnresolvedFormulaMarkup: boolean;
+}
+export declare function readXlsxWorkbookCells(source: XlsxZipSource): XlsxWorkbookCells;

package/dist/workbook-cell-reader.js

@@ -0,0 +1,200 @@
+import { decodeCellAddress, decodeCellRange, encodeCellAddress, normalizeCellAddress } from './address.js';
+import { workbookSheetPathEntriesForSource } from './workbook-sheet-paths.js';
+import { decodeXmlText, getXmlElementText, readXmlAttribute, worksheetCellElementPattern, worksheetCellOpeningTagPattern } from './xml.js';
+import { getZipText, readXlsxZipEntries, readXlsxZipEntriesLazy } from './zip-reader.js';
+const worksheetRowElementPattern = /<(?:[A-Za-z_][\w.-]*:)?row\b(?:[^>"']|"[^"]*"|'[^']*')*\/>|<((?:[A-Za-z_][\w.-]*:)?row)\b(?:[^>"']|"[^"]*"|'[^']*')*>[\s\S]*?<\/\1>/gu;
+const worksheetRowOpeningTagPattern = /<(?:[A-Za-z_][\w.-]*:)?row\b(?:[^>"']|"[^"]*"|'[^']*')*(?:\/>|>)/u;
+export function readXlsxWorkbookCells(source) {
+    const zip = source instanceof Uint8Array ? readXlsxZipEntriesLazy(source) : readXlsxZipEntries(source);
+    let workbookHasFormulaMarkup = false;
+    let workbookHasUnresolvedFormulaMarkup = false;
+    const sharedStringAt = lazySharedStringReader(zip);
+    const sheets = workbookSheetPathEntriesForSource(zip).map((sheet) => {
+        const sheetXml = getZipText(zip, sheet.path) ?? '';
+        const cells = readWorksheetCells(sheetXml, sharedStringAt);
+        const formulaElementCount = sheetXml.match(/<f\b/gu)?.length ?? 0;
+        const cellFormulaCount = cells.filter((cell) => cell.formula !== null).length;
+        if (cellFormulaCount > 0 || formulaElementCount > 0) {
+            workbookHasFormulaMarkup = true;
+        }
+        if (formulaElementCount > cellFormulaCount || cells.some((cell) => cell.formula !== null && cell.formula.trim().length === 0)) {
+            workbookHasUnresolvedFormulaMarkup = true;
+        }
+        const observedRange = rangeFromCells(cells);
+        const range = readWorksheetDimension(sheetXml) ?? observedRange;
+        const rowCount = Math.max(observedRange.e.r + 1, 1);
+        const columnCount = Math.max(observedRange.e.c + 1, 1);
+        return {
+            name: sheet.name,
+            index: sheet.index,
+            path: sheet.path,
+            cells,
+            range,
+            rowCount,
+            columnCount,
+        };
+    });
+    return {
+        sheets,
+        hasFormulaMarkup: workbookHasFormulaMarkup,
+        hasUnresolvedFormulaMarkup: workbookHasUnresolvedFormulaMarkup,
+    };
+}
+function readWorksheetCells(sheetXml, sharedStringAt) {
+    const cells = [];
+    let sawRows = false;
+    let fallbackRow = 0;
+    for (const rowMatch of sheetXml.matchAll(worksheetRowElementPattern)) {
+        sawRows = true;
+        const rowXml = rowMatch[0];
+        const rowOpeningTag = worksheetRowOpeningTagPattern.exec(rowXml)?.[0] ?? '';
+        const explicitRow = decodePositiveRowIndex(readXmlAttribute(rowOpeningTag, 'r'));
+        const rowIndex = explicitRow ?? fallbackRow;
+        let fallbackCol = 0;
+        for (const cellMatch of rowXml.matchAll(worksheetCellElementPattern)) {
+            const cell = readWorkbookCellXml(cellMatch[0], rowIndex, fallbackCol, sharedStringAt);
+            if (cell) {
+                cells.push(cell);
+                fallbackCol = cell.col + 1;
+            }
+            else {
+                fallbackCol += 1;
+            }
+        }
+        fallbackRow = rowIndex + 1;
+    }
+    if (sawRows) {
+        return cells;
+    }
+    let fallbackCol = 0;
+    for (const cellMatch of sheetXml.matchAll(worksheetCellElementPattern)) {
+        const cell = readWorkbookCellXml(cellMatch[0], 0, fallbackCol, sharedStringAt);
+        if (cell) {
+            cells.push(cell);
+            fallbackCol = cell.col + 1;
+        }
+        else {
+            fallbackCol += 1;
+        }
+    }
+    return cells;
+}
+function readWorkbookCellXml(cellXml, fallbackRow, fallbackCol, sharedStringAt) {
+    const openingTag = worksheetCellOpeningTagPattern.exec(cellXml)?.[0] ?? '';
+    const explicitAddress = readXmlAttribute(openingTag, 'r');
+    const decodedAddress = explicitAddress ? decodeCellAddressOrNull(explicitAddress) : { r: fallbackRow, c: fallbackCol };
+    if (!decodedAddress) {
+        return null;
+    }
+    const address = explicitAddress ? normalizeCellAddress(explicitAddress) : encodeCellAddress(decodedAddress);
+    const type = readXmlAttribute(openingTag, 't');
+    const rawValueText = getXmlElementText(cellXml, 'v');
+    const rawValue = rawValueText === null ? null : decodeXmlText(rawValueText);
+    const formulaText = getXmlElementText(cellXml, 'f');
+    const formula = formulaText === null ? null : decodeXmlText(formulaText);
+    const value = readCellValue(cellXml, type, rawValue, sharedStringAt);
+    return {
+        address,
+        row: decodedAddress.r,
+        col: decodedAddress.c,
+        formula,
+        hasValue: rawValue !== null || type === 'inlineStr',
+        rawValue,
+        styleIndex: readCellStyleIndex(openingTag),
+        type,
+        value,
+    };
+}
+function readCellValue(cellXml, type, rawValue, sharedStringAt) {
+    if (type === 'inlineStr') {
+        return readRichTextValue(cellXml);
+    }
+    if (rawValue === null) {
+        return null;
+    }
+    if (type === 's') {
+        const sharedStringIndex = Number(rawValue);
+        return Number.isSafeInteger(sharedStringIndex) && sharedStringIndex >= 0 ? sharedStringAt(sharedStringIndex) : null;
+    }
+    if (type === 'b') {
+        return rawValue === '1' || rawValue.toLowerCase() === 'true';
+    }
+    if (type === 'str' || type === 'e') {
+        return rawValue;
+    }
+    if (rawValue.length === 0) {
+        return null;
+    }
+    const numericValue = Number(rawValue);
+    return Number.isFinite(numericValue) ? numericValue : rawValue;
+}
+function lazySharedStringReader(zip) {
+    let sharedStrings;
+    return (index) => {
+        sharedStrings ??= readSharedStrings(zip);
+        return sharedStrings[index] ?? null;
+    };
+}
+function readSharedStrings(zip) {
+    const xml = getZipText(readXlsxZipEntries(zip), 'xl/sharedStrings.xml');
+    if (!xml) {
+        return [];
+    }
+    return [...xml.matchAll(/<si\b(?:[^>"']|"[^"]*"|'[^']*')*>[\s\S]*?<\/si>/gu)].map((match) => readRichTextValue(match[0]));
+}
+function readRichTextValue(xml) {
+    return [...xml.matchAll(/<(?:[A-Za-z_][\w.-]*:)?t\b(?:[^>"']|"[^"]*"|'[^']*')*>([\s\S]*?)<\/(?:[A-Za-z_][\w.-]*:)?t>/gu)]
+        .map((match) => decodeXmlText(match[1] ?? ''))
+        .join('');
+}
+function readCellStyleIndex(openingTag) {
+    const styleIndex = Number(readXmlAttribute(openingTag, 's'));
+    return Number.isInteger(styleIndex) && styleIndex >= 0 ? styleIndex : null;
+}
+function readWorksheetDimension(sheetXml) {
+    const tag = /<(?:[A-Za-z_][\w.-]*:)?dimension\b(?:[^>"']|"[^"]*"|'[^']*')*\/?>/u.exec(sheetXml)?.[0] ?? '';
+    const ref = readXmlAttribute(tag, 'ref');
+    if (!ref) {
+        return null;
+    }
+    try {
+        return decodeCellRange(ref.replaceAll('$', ''));
+    }
+    catch {
+        return null;
+    }
+}
+function rangeFromCells(cells) {
+    if (cells.length === 0) {
+        return { s: { r: 0, c: 0 }, e: { r: 0, c: 0 } };
+    }
+    return cells.reduce((range, cell) => ({
+        s: {
+            r: Math.min(range.s.r, cell.row),
+            c: Math.min(range.s.c, cell.col),
+        },
+        e: {
+            r: Math.max(range.e.r, cell.row),
+            c: Math.max(range.e.c, cell.col),
+        },
+    }), {
+        s: { r: cells[0].row, c: cells[0].col },
+        e: { r: cells[0].row, c: cells[0].col },
+    });
+}
+function decodePositiveRowIndex(value) {
+    if (!value) {
+        return null;
+    }
+    const row = Number.parseInt(value, 10);
+    return Number.isSafeInteger(row) && row > 0 ? row - 1 : null;
+}
+function decodeCellAddressOrNull(address) {
+    try {
+        return decodeCellAddress(address.replaceAll('$', ''));
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=workbook-cell-reader.js.map

package/dist/workbook-cell-reader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workbook-cell-reader.js","sourceRoot":"","sources":["../src/workbook-cell-reader.ts"],"names":[],"mappings":"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"}

package/dist/workbook-compatibility-report.d.ts

@@ -0,0 +1,101 @@
+import type { LiteralInput } from '@bilig/protocol';
+import type { XlsxExternalWorkbookInput } from './external-workbook-types.js';
+import type { XlsxFormulaRecalcNativeDiagnostics } from './streaming-native-recalc.js';
+export declare const workbookCompatibilityReportSchemaVersion = "bilig-workbook-compatibility-report.v1";
+export type XlsxCacheInspectionLimit = number | 'all';
+export type WorkbookCompatibilityRiskLevel = 'low' | 'medium' | 'high';
+export interface WorkbookCompatibilityNamedCount {
+    readonly name: string;
+    readonly count: number;
+}
+export interface WorkbookCompatibilityReportOptions {
+    readonly fileName?: string;
+    readonly externalWorkbooks?: readonly XlsxExternalWorkbookInput[];
+    readonly edits?: readonly WorkbookCompatibilityReportEdit[];
+    readonly inspectLimit?: XlsxCacheInspectionLimit;
+    readonly maxRssBytes?: number;
+}
+export interface WorkbookCompatibilityReportFileOptions extends WorkbookCompatibilityReportOptions {
+    readonly fileName?: string;
+}
+export interface WorkbookCompatibilityReportEdit {
+    readonly target: string;
+    readonly value: LiteralInput;
+}
+export interface WorkbookCompatibilityReport {
+    readonly schemaVersion: typeof workbookCompatibilityReportSchemaVersion;
+    readonly verified: true;
+    readonly input: {
+        readonly fileName: string;
+        readonly externalWorkbookCount: number;
+        readonly inspectLimit: XlsxCacheInspectionLimit;
+    };
+    readonly workbook: {
+        readonly sheetCount: number;
+        readonly sheetNames: readonly string[];
+        readonly nonEmptyCellCount: number;
+        readonly formulaCellCount: number;
+        readonly definedNameCount: number;
+        readonly tableCount: number;
+        readonly pivotTableCount: number;
+        readonly chartCount: number;
+        readonly macroModuleCount: number;
+    };
+    readonly findings: {
+        readonly unsupportedFunctions: readonly WorkbookCompatibilityNamedCount[];
+        readonly externalLinks: {
+            readonly count: number;
+            readonly unresolvedCount: number;
+            readonly refreshedCount: number;
+        };
+        readonly macroModules: {
+            readonly count: number;
+            readonly byteLength: number;
+        };
+        readonly volatileFunctions: readonly WorkbookCompatibilityNamedCount[];
+        readonly pivotTables: {
+            readonly count: number;
+            readonly unsupportedCount: number;
+            readonly cacheOnlyCount: number;
+        };
+        readonly staleCachedFormulas: {
+            readonly count: number;
+        };
+        readonly missingCachedFormulaValues: {
+            readonly count: number;
+        };
+        readonly unsupportedRecalculations: {
+            readonly count: number;
+        };
+        readonly warnings: readonly string[];
+    };
+    readonly risk: {
+        readonly level: WorkbookCompatibilityRiskLevel;
+        readonly reasons: readonly string[];
+    };
+    readonly cacheInspection: {
+        readonly inspectedFormulaCellCount: number;
+        readonly uninspectedFormulaCellCount: number;
+        readonly inspectionLimit: XlsxCacheInspectionLimit;
+        readonly suggestedReads: readonly string[];
+    };
+    readonly diagnostics: XlsxFormulaRecalcNativeDiagnostics;
+    readonly commandSucceeded: true;
+    readonly inspectionCompleted: true;
+    readonly recalculationCompleted: boolean;
+    readonly excelParity: 'not_proven';
+    readonly limitations: readonly string[];
+    readonly next: {
+        readonly docs: string;
+        readonly command: string;
+    };
+}
+export interface WorkbookCompatibilityReportCliContext {
+    readonly commandName?: string;
+    readonly stdout?: (text: string) => void;
+    readonly stderr?: (text: string) => void;
+}
+export declare function buildWorkbookCompatibilityReport(input: Uint8Array | ArrayBuffer | Buffer, options?: WorkbookCompatibilityReportOptions): WorkbookCompatibilityReport;
+export declare function buildWorkbookCompatibilityReportFromFile(inputPath: string, options?: WorkbookCompatibilityReportFileOptions): WorkbookCompatibilityReport;
+export declare function runWorkbookCompatibilityReportCli(args: readonly string[], context?: WorkbookCompatibilityReportCliContext): number;
+export declare function buildWorkbookCompatibilityDemoBytes(): Uint8Array;