@rowsncolumns/toolkit 24.4.2 → 24.4.4

package/dist/esm/print-settings.js

@@ -0,0 +1,422 @@
+import { addressToSelection, alpha2number, number2Alpha, } from "@rowsncolumns/utils";
+/**
+ * Shared helpers for the sheet `printSettings` facet: the builtin
+ * `_xlnm.Print_Area` / `_xlnm.Print_Titles` defined-name formulas (XLSX), the
+ * Excel header/footer code language (`&L&P of &N`), and the ODS page-layout
+ * equivalents (paper sizes, `style:print` tokens, `<text:*>` fields).
+ */
+export const PRINT_AREA_NAME = "_xlnm.Print_Area";
+export const PRINT_TITLES_NAME = "_xlnm.Print_Titles";
+export const isBuiltinPrintName = (name) => name === PRINT_AREA_NAME || name === PRINT_TITLES_NAME;
+/** Wrap a sheet name in single quotes when a formula reference requires it. */
+export const quoteSheetNameForRef = (name) => /^[A-Za-z_][A-Za-z0-9_.]*$/.test(name)
+    ? name
+    : `'${name.replace(/'/g, "''")}'`;
+/** Split a defined-name formula on top-level commas (quote aware). */
+export const splitDefinedNameAreas = (formula) => {
+    const parts = [];
+    let current = "";
+    let inQuote = false;
+    for (const ch of formula) {
+        if (ch === "'")
+            inQuote = !inQuote;
+        if (ch === "," && !inQuote) {
+            parts.push(current);
+            current = "";
+            continue;
+        }
+        current += ch;
+    }
+    parts.push(current);
+    return parts.map((part) => part.trim()).filter(Boolean);
+};
+/** `'My Sheet'!$A$1:$B$2` → `{ sheetName: "My Sheet", ref: "$A$1:$B$2" }`. */
+export const splitSheetQualifiedRef = (part) => {
+    const bang = part.lastIndexOf("!");
+    if (bang === -1)
+        return { ref: part };
+    let sheetName = part.slice(0, bang);
+    if (sheetName.startsWith("'") && sheetName.endsWith("'")) {
+        sheetName = sheetName.slice(1, -1).replace(/''/g, "'");
+    }
+    return { sheetName, ref: part.slice(bang + 1) };
+};
+const ROW_BAND = /^\$?(\d+):\$?(\d+)$/;
+const COLUMN_BAND = /^\$?([A-Za-z]{1,3}):\$?([A-Za-z]{1,3})$/;
+/**
+ * Parse a `_xlnm.Print_Area` formula into 1-based inclusive rectangles.
+ * Bands (`$1:$2`, `$A:$B`) and non-rectangular parts are rejected; the sheet
+ * name is taken from the first qualified part.
+ */
+export const parsePrintAreaFormula = (formula) => {
+    const ranges = [];
+    let sheetName;
+    for (const part of splitDefinedNameAreas(formula)) {
+        const split = splitSheetQualifiedRef(part);
+        sheetName ??= split.sheetName;
+        const ref = split.ref.replace(/\$/g, "");
+        if (ROW_BAND.test(ref) || COLUMN_BAND.test(ref))
+            return undefined;
+        if (!/^[A-Za-z]{1,3}\d+(:[A-Za-z]{1,3}\d+)?$/.test(ref))
+            return undefined;
+        const selection = addressToSelection(ref);
+        if (!selection)
+            return undefined;
+        ranges.push({ ...selection.range });
+    }
+    if (!ranges.length)
+        return undefined;
+    return { sheetName, ranges };
+};
+/**
+ * Parse a `_xlnm.Print_Titles` formula (`'Sheet'!$A:$B,'Sheet'!$1:$2` — any
+ * order, either band alone) into the repeated row / column bands.
+ */
+export const parsePrintTitlesFormula = (formula) => {
+    const titles = {};
+    let sheetName;
+    for (const part of splitDefinedNameAreas(formula)) {
+        const split = splitSheetQualifiedRef(part);
+        sheetName ??= split.sheetName;
+        const rowMatch = ROW_BAND.exec(split.ref);
+        if (rowMatch) {
+            const a = parseInt(rowMatch[1], 10);
+            const b = parseInt(rowMatch[2], 10);
+            titles.rowStart = Math.min(a, b);
+            titles.rowEnd = Math.max(a, b);
+            continue;
+        }
+        const colMatch = COLUMN_BAND.exec(split.ref);
+        if (colMatch) {
+            const a = alpha2number(colMatch[1].toUpperCase());
+            const b = alpha2number(colMatch[2].toUpperCase());
+            titles.columnStart = Math.min(a, b);
+            titles.columnEnd = Math.max(a, b);
+            continue;
+        }
+        return undefined;
+    }
+    if (titles.rowStart == null && titles.columnStart == null)
+        return undefined;
+    return { sheetName, titles };
+};
+// `number2Alpha` is 0-based (0 → "A"); grid column indices are 1-based.
+const columnLetters = (columnIndex) => number2Alpha(columnIndex - 1);
+const absoluteRangeRef = (range) => `$${columnLetters(range.startColumnIndex)}$${range.startRowIndex}:$${columnLetters(range.endColumnIndex)}$${range.endRowIndex}`;
+/** `'Sheet'!$A$1:$D$10,'Sheet'!$F$2:$G$5` (Excel's own multi-area shape). */
+export const buildPrintAreaFormula = (sheetName, ranges) => {
+    const valid = ranges.filter(isValidPrintRange);
+    if (!valid.length)
+        return undefined;
+    const quoted = quoteSheetNameForRef(sheetName);
+    return valid.map((range) => `${quoted}!${absoluteRangeRef(range)}`).join(",");
+};
+/** Columns first, then rows — the order Excel writes. */
+export const buildPrintTitlesFormula = (sheetName, titles) => {
+    const quoted = quoteSheetNameForRef(sheetName);
+    const parts = [];
+    const { columnStart, columnEnd, rowStart, rowEnd } = titles;
+    if (columnStart != null &&
+        columnEnd != null &&
+        columnStart >= 1 &&
+        columnEnd >= columnStart) {
+        parts.push(`${quoted}!$${columnLetters(columnStart)}:$${columnLetters(columnEnd)}`);
+    }
+    if (rowStart != null &&
+        rowEnd != null &&
+        rowStart >= 1 &&
+        rowEnd >= rowStart) {
+        parts.push(`${quoted}!$${rowStart}:$${rowEnd}`);
+    }
+    return parts.length ? parts.join(",") : undefined;
+};
+export const isValidPrintRange = (range) => range.startRowIndex >= 1 &&
+    range.endRowIndex >= range.startRowIndex &&
+    range.startColumnIndex >= 1 &&
+    range.endColumnIndex >= range.startColumnIndex;
+const hasAnyValue = (value) => !!value && Object.values(value).some((v) => v !== undefined && v !== null);
+/**
+ * Drop empty sub-objects / empty arrays; returns `undefined` when nothing
+ * is left so callers can omit the facet entirely.
+ */
+export const compactPrintSettings = (settings) => {
+    if (!settings)
+        return undefined;
+    const out = {};
+    if (hasAnyValue(settings.pageSetup))
+        out.pageSetup = settings.pageSetup;
+    if (hasAnyValue(settings.pageMargins))
+        out.pageMargins = settings.pageMargins;
+    if (hasAnyValue(settings.printOptions))
+        out.printOptions = settings.printOptions;
+    if (hasAnyValue(settings.headerFooter))
+        out.headerFooter = settings.headerFooter;
+    if (settings.printArea?.length)
+        out.printArea = settings.printArea;
+    if (hasAnyValue(settings.printTitles))
+        out.printTitles = settings.printTitles;
+    if (settings.rowBreaks?.length)
+        out.rowBreaks = settings.rowBreaks;
+    if (settings.columnBreaks?.length)
+        out.columnBreaks = settings.columnBreaks;
+    return Object.keys(out).length ? out : undefined;
+};
+/**
+ * Split an Excel header/footer code into its `&L` / `&C` / `&R` zones. Text
+ * before any zone marker belongs to the centre zone (Excel's rule). `&&`
+ * escapes are left untouched inside each zone.
+ */
+export const splitHeaderFooterZones = (code) => {
+    const zones = {};
+    let current = "center";
+    let buffer = "";
+    const flush = () => {
+        if (buffer)
+            zones[current] = (zones[current] ?? "") + buffer;
+        buffer = "";
+    };
+    for (let i = 0; i < code.length; i++) {
+        const ch = code[i];
+        if (ch === "&" && i + 1 < code.length) {
+            const next = code[i + 1];
+            if (next === "&") {
+                buffer += "&&";
+                i += 1;
+                continue;
+            }
+            if (next === "L" || next === "C" || next === "R") {
+                flush();
+                current = next === "L" ? "left" : next === "C" ? "center" : "right";
+                i += 1;
+                continue;
+            }
+        }
+        buffer += ch;
+    }
+    flush();
+    return zones;
+};
+export const joinHeaderFooterZones = (zones) => {
+    let out = "";
+    if (zones.left)
+        out += `&L${zones.left}`;
+    if (zones.center)
+        out += `&C${zones.center}`;
+    if (zones.right)
+        out += `&R${zones.right}`;
+    return out;
+};
+const FIELD_BY_CODE = {
+    P: "page",
+    N: "pages",
+    D: "date",
+    T: "time",
+    A: "sheet",
+    F: "file",
+    Z: "path",
+};
+const CODE_BY_FIELD = {
+    page: "&P",
+    pages: "&N",
+    date: "&D",
+    time: "&T",
+    sheet: "&A",
+    file: "&F",
+    path: "&Z",
+};
+/**
+ * Tokenize one zone of header/footer code into literal text and field
+ * macros. Formatting codes (`&"Font,Style"`, `&12`, `&B`, `&Kff0000`, `&G`…)
+ * have no ODS counterpart and are dropped.
+ */
+export const tokenizeHeaderFooterZone = (zone) => {
+    const tokens = [];
+    let text = "";
+    const pushText = () => {
+        if (text)
+            tokens.push({ type: "text", text });
+        text = "";
+    };
+    for (let i = 0; i < zone.length; i++) {
+        const ch = zone[i];
+        if (ch !== "&" || i + 1 >= zone.length) {
+            text += ch;
+            continue;
+        }
+        const next = zone[i + 1];
+        if (next === "&") {
+            text += "&";
+            i += 1;
+            continue;
+        }
+        if (next === '"') {
+            const close = zone.indexOf('"', i + 2);
+            i = close === -1 ? zone.length : close;
+            continue;
+        }
+        if (/\d/.test(next)) {
+            let j = i + 1;
+            while (j < zone.length && /\d/.test(zone[j]))
+                j++;
+            i = j - 1;
+            continue;
+        }
+        if (next === "K") {
+            // `&Kff0000` (6 hex) or `&K01+000` (theme + tint) — both 6 chars.
+            i += 7;
+            continue;
+        }
+        const field = FIELD_BY_CODE[next];
+        if (field) {
+            pushText();
+            tokens.push({ type: "field", field });
+            i += 1;
+            continue;
+        }
+        // Any other single-letter code is a formatting toggle.
+        i += 1;
+    }
+    pushText();
+    return tokens;
+};
+export const headerFooterZoneFromTokens = (tokens) => tokens
+    .map((token) => token.type === "text"
+    ? token.text.replace(/&/g, "&&")
+    : CODE_BY_FIELD[token.field])
+    .join("");
+/** Every header/footer text on the facet is empty / absent. */
+export const isHeaderFooterEmpty = (hf) => !hf ||
+    (!hf.oddHeader &&
+        !hf.oddFooter &&
+        !hf.evenHeader &&
+        !hf.evenFooter &&
+        !hf.firstHeader &&
+        !hf.firstFooter &&
+        hf.differentOddEven == null &&
+        hf.differentFirst == null &&
+        hf.scaleWithDoc == null &&
+        hf.alignWithMargins == null);
+// ── ODS equivalents ───────────────────────────────────────────────────────
+export const INCH_TO_CM = 2.54;
+/** ECMA-376 paper-size codes → sheet size in inches (width × height, portrait). */
+const PAPER_SIZES_IN = {
+    1: [8.5, 11], // Letter
+    3: [11, 17], // Tabloid
+    5: [8.5, 14], // Legal
+    7: [7.25, 10.5], // Executive
+    8: [11.69, 16.54], // A3
+    9: [8.27, 11.69], // A4
+    11: [5.83, 8.27], // A5
+    // ECMA-376 ST_PaperSize: 12 = "B4 paper (250 mm by 354 mm)",
+    // 13 = "B5 paper (182 mm by 257 mm)" — the JIS B5, not ISO B5 (176 × 250).
+    12: [9.84, 13.9], // B4
+    13: [7.17, 10.12], // B5 (JIS)
+};
+/** Portrait page size in centimetres for a paper-size code. */
+export const paperSizeToCm = (code) => {
+    const size = PAPER_SIZES_IN[code ?? -1];
+    if (!size)
+        return undefined;
+    return { width: size[0] * INCH_TO_CM, height: size[1] * INCH_TO_CM };
+};
+/** Nearest paper-size code for a page (either orientation), or undefined. */
+export const paperSizeFromCm = (widthCm, heightCm) => {
+    const w = Math.min(widthCm, heightCm) / INCH_TO_CM;
+    const h = Math.max(widthCm, heightCm) / INCH_TO_CM;
+    for (const [code, [pw, ph]] of Object.entries(PAPER_SIZES_IN)) {
+        if (Math.abs(pw - w) < 0.05 && Math.abs(ph - h) < 0.05) {
+            return Number(code);
+        }
+    }
+    return undefined;
+};
+/** Parse an ODF length (`2.54cm`, `1in`, `72pt`, `25.4mm`) to inches. */
+export const odsLengthToInches = (value) => {
+    if (!value)
+        return undefined;
+    const match = /^(-?[\d.]+)\s*(cm|mm|in|pt|pc|px)?$/.exec(value.trim());
+    if (!match)
+        return undefined;
+    const n = parseFloat(match[1]);
+    if (!Number.isFinite(n))
+        return undefined;
+    switch (match[2] ?? "cm") {
+        case "cm":
+            return n / INCH_TO_CM;
+        case "mm":
+            return n / (INCH_TO_CM * 10);
+        case "in":
+            return n;
+        case "pt":
+            return n / 72;
+        case "pc":
+            return n / 6;
+        case "px":
+            return n / 96;
+        default:
+            return undefined;
+    }
+};
+export const inchesToOdsCm = (inches) => `${(inches * INCH_TO_CM).toFixed(3).replace(/\.?0+$/, "")}cm`;
+/**
+ * `style:print` token list. LibreOffice's default (attribute absent) is
+ * `objects charts drawings zero-values`; `grid` / `headers` map to
+ * `<printOptions gridLines headings>`.
+ */
+export const buildOdsPrintTokens = (options) => {
+    const tokens = ["objects", "charts", "drawings", "zero-values"];
+    if (options?.gridLines)
+        tokens.push("grid");
+    if (options?.headings)
+        tokens.push("headers");
+    return tokens.join(" ");
+};
+export const parseOdsPrintTokens = (value) => {
+    if (value == null)
+        return undefined;
+    const tokens = new Set(value.split(/\s+/));
+    const options = {};
+    if (tokens.has("grid"))
+        options.gridLines = true;
+    if (tokens.has("headers"))
+        options.headings = true;
+    return hasAnyValue(options) ? options : undefined;
+};
+export const odsTableCentering = (options) => {
+    if (options?.horizontalCentered && options?.verticalCentered)
+        return "both";
+    if (options?.horizontalCentered)
+        return "horizontal";
+    if (options?.verticalCentered)
+        return "vertical";
+    return undefined;
+};
+export const parseOdsTableCentering = (value) => {
+    switch (value) {
+        case "both":
+            return { horizontalCentered: true, verticalCentered: true };
+        case "horizontal":
+            return { horizontalCentered: true };
+        case "vertical":
+            return { verticalCentered: true };
+        default:
+            return {};
+    }
+};
+export const isPageSetupEmpty = (setup) => !hasAnyValue(setup);
+export const isPageMarginsEmpty = (margins) => !hasAnyValue(margins);
+/** Excel's "Normal" margins — what every untouched worksheet carries. */
+export const DEFAULT_PAGE_MARGINS_IN = {
+    left: 0.7,
+    right: 0.7,
+    top: 0.75,
+    bottom: 0.75,
+    header: 0.3,
+    footer: 0.3,
+};
+/** `true` when the margins are exactly Excel's defaults (nothing to keep). */
+export const isDefaultPageMargins = (margins) => !!margins &&
+    Object.keys(DEFAULT_PAGE_MARGINS_IN).every((key) => {
+        const value = margins[key];
+        return (value == null || Math.abs(value - DEFAULT_PAGE_MARGINS_IN[key]) < 1e-9);
+    });

package/dist/esm/tsconfig.esm.tsbuildinfo

@@ -1 +1 @@
-{"root":["../../autofilter-condition.ts","../../csv-export.ts","../../csv-import-worker.ts","../../csv-import.ts","../../excel-export.ts","../../excel-import-session.ts","../../excel-import-worker.ts","../../helpers.ts","../../index.ts","../../indexed-colors.ts","../../ods-export.ts","../../parse.ts","../../power-query.ts","../../server.ts","../../theme1.ts","../../types.ts","../../vitest.config.ts","../../xlsx.d.ts","../../csv-parser/helpers.ts","../../csv-parser/types.ts","../../csv-parser/worker.ts","../../excel-parser/builtin-numfmts.ts","../../excel-parser/cfb-decryptor.ts","../../excel-parser/cfb-encryptor.ts","../../excel-parser/dv-cell-stamp.ts","../../excel-parser/helpers.ts","../../excel-parser/interface.ts","../../excel-parser/registry.ts","../../excel-parser/style-registry.ts","../../excel-parser/theme-default.ts","../../excel-parser/types.ts","../../excel-parser/utils.ts","../../excel-parser/workbook.ts","../../excel-parser/worker.ts","../../excel-parser/zip-parser-streaming.ts","../../excel-parser/zip-parser.ts","../../excel-parser/plugins/base/index.ts","../../excel-parser/plugins/ods/conditional-formatting.ts","../../excel-parser/plugins/ods/data-validations.ts","../../excel-parser/plugins/ods/formula.ts","../../excel-parser/plugins/ods/index.ts","../../excel-parser/plugins/ods/sparklines.ts","../../excel-parser/plugins/ods/styles.ts","../../excel-parser/plugins/ods/types.ts","../../excel-parser/plugins/xls/index.ts","../../excel-parser/plugins/xlsb/biff-record-reader.ts","../../excel-parser/plugins/xlsb/index.ts","../../excel-parser/plugins/xlsb/rgce-parser.ts","../../excel-parser/plugins/xlsm/index.ts","../../excel-parser/plugins/xlsx/charts.ts","../../excel-parser/plugins/xlsx/conditional-formatting.ts","../../excel-parser/plugins/xlsx/data-validations.ts","../../excel-parser/plugins/xlsx/drawing.ts","../../excel-parser/plugins/xlsx/index.ts","../../excel-parser/plugins/xlsx/numfmt.ts","../../excel-parser/plugins/xlsx/pivots.ts","../../excel-parser/plugins/xlsx/relationships.ts","../../excel-parser/plugins/xlsx/sheet-views.ts","../../excel-parser/plugins/xlsx/styles.ts","../../excel-parser/plugins/xlsx/theme.ts","../../excel-parser/plugins/xlsx/threaded-comments.ts","../../excel-parser/plugins/xlsx/value-type-detection.ts","../../exporter/invalid-data-validation.ts","../../exporter/ods/ods-export.ts","../../exporter/ods/sparkline-builder.ts","../../exporter/xlsx/chart-builder.ts","../../exporter/xlsx/chart-templates.ts","../../exporter/xlsx/future-functions.ts","../../exporter/xlsx/pivot-builder.ts","../../exporter/xlsx/power-query-builder.ts","../../exporter/xlsx/slicer-builder.ts","../../exporter/xlsx/sparkline-builder.ts","../../exporter/xlsx/style-builder.ts","../../exporter/xlsx/threaded-comments-builder.ts","../../exporter/xlsx/xlsx-export.ts","../../helpers/theme-xml-generator.ts"],"version":"5.8.3"}
+{"root":["../../autofilter-condition.ts","../../csv-export.ts","../../csv-import-worker.ts","../../csv-import.ts","../../excel-export.ts","../../excel-import-session.ts","../../excel-import-worker.ts","../../helpers.ts","../../index.ts","../../indexed-colors.ts","../../ods-export.ts","../../parse.ts","../../power-query.ts","../../print-settings.ts","../../server.ts","../../theme1.ts","../../types.ts","../../vitest.config.ts","../../xlsx.d.ts","../../csv-parser/helpers.ts","../../csv-parser/types.ts","../../csv-parser/worker.ts","../../excel-parser/builtin-numfmts.ts","../../excel-parser/cfb-decryptor.ts","../../excel-parser/cfb-encryptor.ts","../../excel-parser/dv-cell-stamp.ts","../../excel-parser/helpers.ts","../../excel-parser/interface.ts","../../excel-parser/registry.ts","../../excel-parser/style-registry.ts","../../excel-parser/theme-default.ts","../../excel-parser/types.ts","../../excel-parser/utils.ts","../../excel-parser/workbook.ts","../../excel-parser/worker.ts","../../excel-parser/zip-parser-streaming.ts","../../excel-parser/zip-parser.ts","../../excel-parser/plugins/base/index.ts","../../excel-parser/plugins/ods/conditional-formatting.ts","../../excel-parser/plugins/ods/data-validations.ts","../../excel-parser/plugins/ods/formula.ts","../../excel-parser/plugins/ods/index.ts","../../excel-parser/plugins/ods/sparklines.ts","../../excel-parser/plugins/ods/styles.ts","../../excel-parser/plugins/ods/types.ts","../../excel-parser/plugins/xls/index.ts","../../excel-parser/plugins/xlsb/biff-record-reader.ts","../../excel-parser/plugins/xlsb/index.ts","../../excel-parser/plugins/xlsb/rgce-parser.ts","../../excel-parser/plugins/xlsm/index.ts","../../excel-parser/plugins/xlsx/chartex.ts","../../excel-parser/plugins/xlsx/charts.ts","../../excel-parser/plugins/xlsx/conditional-formatting.ts","../../excel-parser/plugins/xlsx/data-validations.ts","../../excel-parser/plugins/xlsx/drawing.ts","../../excel-parser/plugins/xlsx/form-controls.ts","../../excel-parser/plugins/xlsx/index.ts","../../excel-parser/plugins/xlsx/numfmt.ts","../../excel-parser/plugins/xlsx/pivots.ts","../../excel-parser/plugins/xlsx/relationships.ts","../../excel-parser/plugins/xlsx/sheet-views.ts","../../excel-parser/plugins/xlsx/styles.ts","../../excel-parser/plugins/xlsx/theme.ts","../../excel-parser/plugins/xlsx/threaded-comments.ts","../../excel-parser/plugins/xlsx/value-type-detection.ts","../../exporter/invalid-data-validation.ts","../../exporter/ods/ods-export.ts","../../exporter/ods/sparkline-builder.ts","../../exporter/xlsx/chart-builder.ts","../../exporter/xlsx/chart-templates.ts","../../exporter/xlsx/chartex-builder.ts","../../exporter/xlsx/form-controls-builder.ts","../../exporter/xlsx/future-functions.ts","../../exporter/xlsx/pivot-builder.ts","../../exporter/xlsx/power-query-builder.ts","../../exporter/xlsx/slicer-builder.ts","../../exporter/xlsx/sparkline-builder.ts","../../exporter/xlsx/style-builder.ts","../../exporter/xlsx/threaded-comments-builder.ts","../../exporter/xlsx/xlsx-export.ts","../../helpers/implicit-intersection.ts","../../helpers/theme-xml-generator.ts"],"version":"5.8.3"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rowsncolumns/toolkit",
-  "version": "24.4.2",
+  "version": "24.4.4",
   "author": "Vinay M",
   "license": "SEE LICENSE IN LICENSE.md",
   "main": "./dist/cjs/index.js",
@@ -43,14 +43,14 @@
     "url": "https://github.com/rowsncolumns/spreadsheet/issues"
   },
   "devDependencies": {
-    "@rowsncolumns/utils": ">=9.2.37",
+    "@rowsncolumns/utils": ">=9.2.41",
     "@types/lodash-es": "^4.17.12"
   },
   "peerDependencies": {},
   "dependencies": {
     "@noble/ciphers": "^0.5.3",
     "@noble/hashes": "^1.4.0",
-    "@rowsncolumns/calculator": ">=7.2.30",
+    "@rowsncolumns/calculator": ">=7.2.32",
     "@zip.js/zip.js": "^2.8.17",
     "fast-xml-parser": "^5.8.0",
     "fflate": "^0.8.2",

package/xlsx.d.ts

@@ -1,4 +1,18 @@
 declare module "xlsx/xlsx.mjs" {
+  import type * as SheetJs from "xlsx";
+
+  /** SheetJS workbook reader — used for the BIFF8 (`.xls`) plugin. */
+  export const read: typeof SheetJs.read;
+  /** SheetJS workbook writer (tests build BIFF8 fixtures with it). */
+  export const write: typeof SheetJs.write;
+  export const utils: typeof SheetJs.utils;
+  export type WorkBook = SheetJs.WorkBook;
+  export type WorkSheet = SheetJs.WorkSheet;
+  export type CellObject = SheetJs.CellObject;
+  export type ColInfo = SheetJs.ColInfo;
+  export type RowInfo = SheetJs.RowInfo;
+  export type DefinedName = SheetJs.DefinedName;
+
   export namespace CFB {
     interface CFBEntry {
       name: string;