@bilig/excel-import 0.14.14

package/dist/xlsx-calculation-settings.js

@@ -0,0 +1,198 @@
+import { strFromU8, strToU8, unzipSync, zipSync } from 'fflate';
+import { XMLParser } from 'fast-xml-parser';
+import { escapeXmlAttribute } from './xlsx-export-xml.js';
+import { readXlsxZipEntries } from './xlsx-zip.js';
+const xmlParser = new XMLParser({
+    ignoreAttributes: false,
+    attributeNamePrefix: '',
+    parseAttributeValue: false,
+    removeNSPrefix: true,
+});
+const workbookCalcPrTailElements = [
+    'oleSize',
+    'customWorkbookViews',
+    'pivotCaches',
+    'smartTagPr',
+    'smartTagTypes',
+    'webPublishing',
+    'fileRecoveryPr',
+    'webPublishObjects',
+    'extLst',
+];
+export const precisionAsDisplayedCalculationWarning = 'Precision-as-displayed calculation is not supported during XLSX import.';
+export const manualCalculationModeWarning = 'Manual calculation mode is preserved during XLSX import; cached formula values may be stale.';
+function isRecord(value) {
+    return typeof value === 'object' && value !== null;
+}
+function recordChild(value, key) {
+    if (!isRecord(value)) {
+        return null;
+    }
+    const child = value[key];
+    return isRecord(child) ? child : null;
+}
+function stringValue(value) {
+    return typeof value === 'string' && value.trim().length > 0 ? value : null;
+}
+function booleanAttributeValue(value) {
+    const raw = stringValue(value);
+    if (raw === null) {
+        return undefined;
+    }
+    return raw === '1' || raw.toLowerCase() === 'true';
+}
+function finiteIntegerAttributeValue(value) {
+    const raw = stringValue(value);
+    if (raw === null) {
+        return undefined;
+    }
+    const number = Number(raw);
+    return Number.isSafeInteger(number) ? number : undefined;
+}
+function finiteNumericStringAttributeValue(value) {
+    const raw = stringValue(value);
+    if (raw === null) {
+        return undefined;
+    }
+    return Number.isFinite(Number(raw)) ? raw : undefined;
+}
+function formatBooleanAttribute(value) {
+    return value ? '1' : '0';
+}
+function calcPrAttribute(name, value) {
+    return value === undefined ? '' : ` ${name}="${escapeXmlAttribute(value)}"`;
+}
+function hasSemanticCalculationSettings(settings) {
+    return (settings.mode === 'manual' ||
+        settings.iterate !== undefined ||
+        settings.iterateCount !== undefined ||
+        settings.iterateDelta !== undefined ||
+        settings.fullPrecision === false ||
+        settings.fullCalcOnLoad !== undefined ||
+        settings.concurrentCalc !== undefined);
+}
+function buildWorkbookCalcPr(settings) {
+    if (!hasSemanticCalculationSettings(settings)) {
+        return null;
+    }
+    const attributes = [
+        calcPrAttribute('calcMode', settings.mode === 'manual' ? 'manual' : undefined),
+        calcPrAttribute('fullPrecision', settings.fullPrecision === false ? '0' : undefined),
+        calcPrAttribute('iterate', typeof settings.iterate === 'boolean' ? formatBooleanAttribute(settings.iterate) : undefined),
+        calcPrAttribute('iterateCount', Number.isSafeInteger(settings.iterateCount) ? String(settings.iterateCount) : undefined),
+        calcPrAttribute('iterateDelta', typeof settings.iterateDelta === 'string' ? settings.iterateDelta : undefined),
+        calcPrAttribute('fullCalcOnLoad', typeof settings.fullCalcOnLoad === 'boolean' ? formatBooleanAttribute(settings.fullCalcOnLoad) : undefined),
+        calcPrAttribute('concurrentCalc', typeof settings.concurrentCalc === 'boolean' ? formatBooleanAttribute(settings.concurrentCalc) : undefined),
+    ].join('');
+    return attributes.length > 0 ? `<calcPr${attributes}/>` : null;
+}
+function hasNonDefaultDateSystem(settings) {
+    return settings.dateSystem === '1904';
+}
+function normalizeZipPath(path) {
+    return path.replace(/^\/+/, '');
+}
+function getZipText(zip, path) {
+    const file = zip[normalizeZipPath(path)];
+    return file ? strFromU8(file) : null;
+}
+function setZipText(zip, path, text) {
+    zip[normalizeZipPath(path)] = strToU8(text);
+}
+function insertWorkbookCalcPr(workbookXml, calcPrXml) {
+    if (/<calcPr\b/u.test(workbookXml)) {
+        return workbookXml.replace(/<calcPr\b[^>]*(?:\/>|>[\s\S]*?<\/calcPr>)/u, calcPrXml);
+    }
+    let insertIndex = workbookXml.indexOf('</workbook>');
+    for (const elementName of workbookCalcPrTailElements) {
+        const elementIndex = workbookXml.search(new RegExp(`<${elementName}\\b`, 'u'));
+        if (elementIndex >= 0 && (insertIndex < 0 || elementIndex < insertIndex)) {
+            insertIndex = elementIndex;
+        }
+    }
+    if (insertIndex < 0) {
+        return workbookXml;
+    }
+    return `${workbookXml.slice(0, insertIndex)}${calcPrXml}${workbookXml.slice(insertIndex)}`;
+}
+function upsertWorkbookPrDateSystem(workbookXml, dateSystem) {
+    if (dateSystem !== '1904') {
+        return workbookXml.replace(/<workbookPr\b([^>]*)\sdate1904="(?:1|true)"([^>]*)\/>/iu, '<workbookPr$1$2/>');
+    }
+    if (/<workbookPr\b/u.test(workbookXml)) {
+        return workbookXml.replace(/<workbookPr\b([^>]*)\/>/u, (_match, attributes) => /\sdate1904="/u.test(attributes)
+            ? `<workbookPr${attributes.replace(/\sdate1904="[^"]*"/u, ' date1904="1"')}/>`
+            : `<workbookPr${attributes} date1904="1"/>`);
+    }
+    const sheetsIndex = workbookXml.search(/<sheets\b/u);
+    if (sheetsIndex < 0) {
+        return workbookXml;
+    }
+    return `${workbookXml.slice(0, sheetsIndex)}<workbookPr date1904="1"/>${workbookXml.slice(sheetsIndex)}`;
+}
+export function addExportCalculationSettingsToXlsxBytes(bytes, snapshot) {
+    const settings = snapshot.workbook.metadata?.calculationSettings;
+    const calcPrXml = settings ? buildWorkbookCalcPr(settings) : null;
+    if (!settings || (!calcPrXml && !hasNonDefaultDateSystem(settings))) {
+        return bytes;
+    }
+    const zip = unzipSync(bytes);
+    const workbookXml = getZipText(zip, 'xl/workbook.xml');
+    if (!workbookXml) {
+        return bytes;
+    }
+    let nextWorkbookXml = hasNonDefaultDateSystem(settings) ? upsertWorkbookPrDateSystem(workbookXml, settings.dateSystem) : workbookXml;
+    if (calcPrXml) {
+        nextWorkbookXml = insertWorkbookCalcPr(nextWorkbookXml, calcPrXml);
+    }
+    setZipText(zip, 'xl/workbook.xml', nextWorkbookXml);
+    return zipSync(zip);
+}
+export function readImportedWorkbookCalculationSettings(source) {
+    const zip = readXlsxZipEntries(source);
+    const workbookXml = getZipText(zip, 'xl/workbook.xml');
+    if (!workbookXml) {
+        return undefined;
+    }
+    const parsed = xmlParser.parse(workbookXml);
+    const workbook = recordChild(parsed, 'workbook');
+    const workbookPr = recordChild(workbook, 'workbookPr');
+    const calcPr = recordChild(workbook, 'calcPr');
+    const dateSystem = booleanAttributeValue(workbookPr?.['date1904']) === true ? '1904' : undefined;
+    if (!calcPr && !dateSystem) {
+        return undefined;
+    }
+    const mode = calcPr?.['calcMode'] === 'manual' ? 'manual' : 'automatic';
+    const iterate = booleanAttributeValue(calcPr?.['iterate']);
+    const iterateCount = finiteIntegerAttributeValue(calcPr?.['iterateCount']);
+    const iterateDelta = finiteNumericStringAttributeValue(calcPr?.['iterateDelta']);
+    const fullPrecision = booleanAttributeValue(calcPr?.['fullPrecision']);
+    const fullCalcOnLoad = booleanAttributeValue(calcPr?.['fullCalcOnLoad']);
+    const concurrentCalc = booleanAttributeValue(calcPr?.['concurrentCalc']);
+    const settings = {
+        mode,
+        compatibilityMode: 'excel-modern',
+        ...(dateSystem ? { dateSystem } : {}),
+        ...(iterate !== undefined ? { iterate } : {}),
+        ...(iterateCount !== undefined ? { iterateCount } : {}),
+        ...(iterateDelta !== undefined ? { iterateDelta } : {}),
+        ...(fullPrecision === false ? { fullPrecision } : {}),
+        ...(fullCalcOnLoad !== undefined ? { fullCalcOnLoad } : {}),
+        ...(concurrentCalc !== undefined ? { concurrentCalc } : {}),
+    };
+    return hasSemanticCalculationSettings(settings) || hasNonDefaultDateSystem(settings) ? settings : undefined;
+}
+export function readImportedWorkbookCalculationWarnings(source, options = {}) {
+    const zip = readXlsxZipEntries(source);
+    const workbookXml = getZipText(zip, 'xl/workbook.xml');
+    if (!workbookXml) {
+        return [];
+    }
+    const parsed = xmlParser.parse(workbookXml);
+    const calcPr = recordChild(recordChild(parsed, 'workbook'), 'calcPr');
+    return [
+        ...(calcPr?.['calcMode'] === 'manual' ? [manualCalculationModeWarning] : []),
+        ...(calcPr?.['fullPrecision'] === '0' && options.hasFormulaCells !== false ? [precisionAsDisplayedCalculationWarning] : []),
+    ];
+}
+//# sourceMappingURL=xlsx-calculation-settings.js.map

package/dist/xlsx-calculation-settings.js.map

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

package/dist/xlsx-cell-insertion.d.ts

@@ -0,0 +1,11 @@
+interface MissingCellXml {
+    readonly address: string;
+    readonly xml: string;
+}
+export declare function addMissingCellsToSheetXml(sheetXml: string, cells: readonly MissingCellXml[]): string;
+export declare function addMissingFormattedCells(sheetXml: string, cells: readonly {
+    readonly address: string;
+    readonly styleIndex: number;
+}[]): string;
+export declare function addMissingBlankCells(sheetXml: string, addresses: readonly string[]): string;
+export {};

package/dist/xlsx-cell-insertion.js

@@ -0,0 +1,164 @@
+import * as XLSX from 'xlsx';
+import { escapeXmlAttribute } from './xlsx-export-xml.js';
+const worksheetRowElementPattern = /<row\b[^>]*\/>|<row\b[^>]*>[\s\S]*?<\/row>/gu;
+const worksheetRowOpeningTagPattern = /^<row\b[^>]*(?:\/>|>)/u;
+function rowNumberForAddress(address) {
+    return XLSX.utils.decode_cell(address).r + 1;
+}
+function columnIndexForAddress(address) {
+    return XLSX.utils.decode_cell(address).c;
+}
+function updateRangeWithAddress(range, address) {
+    try {
+        const decoded = XLSX.utils.decode_cell(address);
+        return range
+            ? {
+                s: {
+                    r: Math.min(range.s.r, decoded.r),
+                    c: Math.min(range.s.c, decoded.c),
+                },
+                e: {
+                    r: Math.max(range.e.r, decoded.r),
+                    c: Math.max(range.e.c, decoded.c),
+                },
+            }
+            : {
+                s: { r: decoded.r, c: decoded.c },
+                e: { r: decoded.r, c: decoded.c },
+            };
+    }
+    catch {
+        return range;
+    }
+}
+function existingWorksheetDimensionRange(sheetXml) {
+    const ref = /<dimension\b[^>]*\bref="([^"]+)"[^>]*(?:\/>|>[\s\S]*?<\/dimension>)/u.exec(sheetXml)?.[1];
+    if (!ref) {
+        return null;
+    }
+    try {
+        return XLSX.utils.decode_range(ref);
+    }
+    catch {
+        return null;
+    }
+}
+function setWorksheetDimensionRef(sheetXml, range) {
+    const ref = escapeXmlAttribute(XLSX.utils.encode_range(range));
+    const dimensionPattern = /<dimension\b[^>]*(?:\/>|>[\s\S]*?<\/dimension>)/u;
+    if (dimensionPattern.test(sheetXml)) {
+        return sheetXml.replace(dimensionPattern, (dimensionXml) => {
+            if (/\bref="[^"]*"/u.test(dimensionXml)) {
+                return dimensionXml.replace(/\bref="[^"]*"/u, `ref="${ref}"`);
+            }
+            return `<dimension ref="${ref}"/>`;
+        });
+    }
+    return sheetXml.replace(/<worksheet\b[^>]*>/u, (openingTag) => `${openingTag}<dimension ref="${ref}"/>`);
+}
+function expandWorksheetDimensionForMissingCells(sheetXml, cells) {
+    let range = existingWorksheetDimensionRange(sheetXml);
+    const originalRange = range;
+    for (const cell of cells) {
+        range = updateRangeWithAddress(range, cell.address);
+    }
+    if (!range || (originalRange && XLSX.utils.encode_range(range) === XLSX.utils.encode_range(originalRange))) {
+        return sheetXml;
+    }
+    return setWorksheetDimensionRef(sheetXml, range);
+}
+function rowCellXml(rowCells) {
+    return rowCells
+        .toSorted((left, right) => columnIndexForAddress(left.address) - columnIndexForAddress(right.address))
+        .map((cell) => cell.xml);
+}
+function buildRowsXml(entries) {
+    return entries.map(([rowNumber, rowCells]) => `<row r="${String(rowNumber)}">${rowCellXml(rowCells).join('')}</row>`).join('');
+}
+function rowNumberForRowXml(rowXml) {
+    const rowTag = worksheetRowOpeningTagPattern.exec(rowXml)?.[0];
+    const rowNumber = rowTag ? Number(/\br="([0-9]+)"/u.exec(rowTag)?.[1] ?? NaN) : NaN;
+    return Number.isSafeInteger(rowNumber) && rowNumber > 0 ? rowNumber : null;
+}
+function appendCellsToRowXml(rowXml, cells) {
+    const cellsXml = rowCellXml(cells).join('');
+    return rowXml.endsWith('/>') ? rowXml.replace(/\/>$/u, `>${cellsXml}</row>`) : rowXml.replace('</row>', `${cellsXml}</row>`);
+}
+function addMissingCellsToSheetDataXml(sheetDataXml, rowEntries) {
+    const sheetDataOpeningTag = /^<sheetData\b[^>]*>/u.exec(sheetDataXml)?.[0];
+    if (!sheetDataOpeningTag || !sheetDataXml.endsWith('</sheetData>')) {
+        return sheetDataXml;
+    }
+    const bodyStart = sheetDataOpeningTag.length;
+    const bodyEnd = sheetDataXml.length - '</sheetData>'.length;
+    const sheetDataBody = sheetDataXml.slice(bodyStart, bodyEnd);
+    let outputBody = '';
+    let lastIndex = 0;
+    let missingIndex = 0;
+    for (const match of sheetDataBody.matchAll(worksheetRowElementPattern)) {
+        const rowXml = match[0];
+        const rowNumber = rowNumberForRowXml(rowXml);
+        outputBody += sheetDataBody.slice(lastIndex, match.index);
+        if (rowNumber === null) {
+            outputBody += rowXml;
+            lastIndex = match.index + rowXml.length;
+            continue;
+        }
+        while (missingIndex < rowEntries.length && rowEntries[missingIndex][0] < rowNumber) {
+            outputBody += buildRowsXml([rowEntries[missingIndex]]);
+            missingIndex += 1;
+        }
+        if (missingIndex < rowEntries.length && rowEntries[missingIndex][0] === rowNumber) {
+            outputBody += appendCellsToRowXml(rowXml, rowEntries[missingIndex][1]);
+            missingIndex += 1;
+        }
+        else {
+            outputBody += rowXml;
+        }
+        lastIndex = match.index + rowXml.length;
+    }
+    outputBody += sheetDataBody.slice(lastIndex);
+    while (missingIndex < rowEntries.length) {
+        outputBody += buildRowsXml([rowEntries[missingIndex]]);
+        missingIndex += 1;
+    }
+    return `${sheetDataOpeningTag}${outputBody}</sheetData>`;
+}
+export function addMissingCellsToSheetXml(sheetXml, cells) {
+    if (cells.length === 0) {
+        return sheetXml;
+    }
+    const byRow = new Map();
+    for (const cell of cells) {
+        const rowNumber = rowNumberForAddress(cell.address);
+        byRow.set(rowNumber, [...(byRow.get(rowNumber) ?? []), cell]);
+    }
+    const rowEntries = [...byRow.entries()].toSorted(([left], [right]) => left - right);
+    const selfClosingSheetData = /<sheetData\b([^>]*)\/>/u;
+    if (selfClosingSheetData.test(sheetXml)) {
+        const updatedSheetXml = sheetXml.replace(selfClosingSheetData, (_match, attributes) => `<sheetData${attributes}>${buildRowsXml(rowEntries)}</sheetData>`);
+        return expandWorksheetDimensionForMissingCells(updatedSheetXml, cells);
+    }
+    const sheetDataMatch = /<sheetData\b[^>]*>[\s\S]*?<\/sheetData>/u.exec(sheetXml);
+    if (sheetDataMatch) {
+        const updatedSheetXml = `${sheetXml.slice(0, sheetDataMatch.index)}${addMissingCellsToSheetDataXml(sheetDataMatch[0], rowEntries)}${sheetXml.slice(sheetDataMatch.index + sheetDataMatch[0].length)}`;
+        return expandWorksheetDimensionForMissingCells(updatedSheetXml, cells);
+    }
+    return expandWorksheetDimensionForMissingCells(sheetXml.replace('</worksheet>', `<sheetData>${buildRowsXml(rowEntries)}</sheetData></worksheet>`), cells);
+}
+export function addMissingFormattedCells(sheetXml, cells) {
+    return addMissingCellsToSheetXml(sheetXml, cells.map((cell) => {
+        const address = escapeXmlAttribute(cell.address);
+        return {
+            address: cell.address,
+            xml: `<c r="${address}" s="${String(cell.styleIndex)}"/>`,
+        };
+    }));
+}
+export function addMissingBlankCells(sheetXml, addresses) {
+    return addMissingCellsToSheetXml(sheetXml, addresses.map((address) => ({
+        address,
+        xml: `<c r="${escapeXmlAttribute(address)}"/>`,
+    })));
+}
+//# sourceMappingURL=xlsx-cell-insertion.js.map

package/dist/xlsx-cell-insertion.js.map

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

package/dist/xlsx-cell-metadata.d.ts

@@ -0,0 +1,15 @@
+import type { WorkbookCellMetadataReferenceSnapshot, WorkbookCellMetadataSnapshot, WorkbookSnapshot } from '@bilig/protocol';
+import { type XlsxZipSource } from './xlsx-zip.js';
+interface ImportedCellMetadataReference {
+    readonly address: string;
+    readonly cm?: string;
+    readonly vm?: string;
+}
+export interface ImportedWorkbookCellMetadata {
+    readonly workbookMetadata?: WorkbookCellMetadataSnapshot;
+    readonly refsBySheet: ReadonlyMap<string, readonly ImportedCellMetadataReference[]>;
+}
+export declare function readImportedWorkbookCellMetadata(source: XlsxZipSource, sheetNames: readonly string[]): ImportedWorkbookCellMetadata;
+export declare function buildImportedCellMetadataReferenceSnapshots(refs: readonly ImportedCellMetadataReference[] | undefined, cells: readonly WorkbookSnapshot['sheets'][number]['cells'][number][]): WorkbookCellMetadataReferenceSnapshot[] | undefined;
+export declare function addExportCellMetadataToXlsxBytes(bytes: Uint8Array, snapshot: WorkbookSnapshot): Uint8Array;
+export {};