@lotics/cli 0.111.0 → 0.113.0

package/README.md

@@ -156,12 +156,15 @@ The CLI bundles Lotics's own xlsx and docx engines so you can read, write, and e
 ```bash
 # .xlsx
 lotics xlsx read ./report.xlsx                                  # → JSON of sheets, cells, merges
+lotics xlsx read ./report.xlsx --with-format                    # …plus each cell's resolved style
 lotics xlsx write ./out.xlsx '{"sheets":[{"name":"S1","cells":{"A1":"Hi","B1":42}}]}'
 # A cell is a bare value, or an object with numFmt / style / formula:
-lotics xlsx write ./out.xlsx '{"sheets":[{"name":"S1","cells":{
-  "A1":{"value":"Tổng","style":{"fontBold":true}},
-  "B1":{"value":1234567,"numFmt":"#,##0"},
-  "B2":{"formula":"B1*0.1","numFmt":"#,##0"}}}]}'   # unknown cell keys are rejected, not ignored
+lotics xlsx write ./out.xlsx '{"sheets":[{"name":"S1",
+  "colWidths":{"A":34,"B":14}, "rowHeights":{"1":28},
+  "cells":{
+    "A1":{"value":"Tổng","style":{"fontBold":true}},
+    "B1":{"value":1234567,"numFmt":"#,##0"},
+    "B2":{"formula":"B1*0.1","numFmt":"#,##0"}}}]}'  # unknown keys are rejected, not ignored
 lotics xlsx set-cell ./report.xlsx 'Sheet1!A1' '=SUM(B:B)'
 lotics xlsx add-sheet ./report.xlsx 'Summary'
 lotics xlsx merge ./report.xlsx 'Sheet1!A1:C1'

package/dist/render_page.js

@@ -50248,6 +50248,10 @@ ${e.toString()}`);
     const { row, col } = unpackRowCol(packed);
     return rowColToRef(row, col);
   }
+  function stripNsPrefix(tag) {
+    const colon = tag.indexOf(":");
+    return colon === -1 ? tag : tag.slice(colon + 1);
+  }
 
   // ../xlsx/node_modules/fast-xml-parser/src/util.js
   var nameStartChar2 = ":A-Za-z_\\u00C0-\\u00D6\\u00D8-\\u00F6\\u00F8-\\u02FF\\u0370-\\u037D\\u037F-\\u1FFF\\u200C-\\u200D\\u2070-\\u218F\\u2C00-\\u2FEF\\u3001-\\uD7FF\\uF900-\\uFDCF\\uFDF0-\\uFFFD";
@@ -52246,6 +52250,16 @@ ${e.toString()}`);
     return { type: "plain", text: displayValue };
   }
 
+  // ../xlsx/src/malformed_part_error.ts
+  var MalformedPartError = class extends Error {
+    constructor(reason) {
+      super(
+        `${reason} \u2014 the file is not a readable spreadsheet. If it opens in Excel, the reader is at fault: report the producer that wrote it.`
+      );
+      this.name = "MalformedPartError";
+    }
+  };
+
   // ../../node_modules/fflate/esm/browser.js
   var u8 = Uint8Array;
   var u16 = Uint16Array;
@@ -52846,7 +52860,11 @@ ${e.toString()}`);
     ignoreAttributes: false,
     attributeNamePrefix: "@_",
     processEntities: false,
-    isArray: (tagName) => tagName === "row" || tagName === "c" || tagName === "col" || tagName === "mergeCell" || tagName === "conditionalFormatting" || tagName === "cfRule" || tagName === "cfvo" || tagName === "color" || tagName === "hyperlink" || tagName === "Relationship" || tagName === "sheetView" || tagName === "xdr:twoCellAnchor" || tagName === "xdr:oneCellAnchor" || tagName === "dataValidation" || tagName === "filterColumn" || tagName === "filter" || tagName === "brk" || tagName === "ext",
+    // A producer may bind spreadsheetml to a prefix (`<x:worksheet>`) instead of
+    // making it the default namespace. The prefix carries no meaning, so it is
+    // dropped before anything looks a tag up — see `stripNsPrefix`.
+    transformTagName: stripNsPrefix,
+    isArray: (tagName) => tagName === "row" || tagName === "c" || tagName === "col" || tagName === "mergeCell" || tagName === "conditionalFormatting" || tagName === "cfRule" || tagName === "cfvo" || tagName === "color" || tagName === "hyperlink" || tagName === "Relationship" || tagName === "sheetView" || tagName === "dataValidation" || tagName === "filterColumn" || tagName === "filter" || tagName === "brk" || tagName === "ext",
     // Preserve whitespace in cell values
     trimValues: false
   });
@@ -52865,7 +52883,7 @@ ${e.toString()}`);
   function parseSheet(sheetXml, sheetRelsXml, styles, sharedStrings, theme, indexedColors, zipEntries, date1904, maxRows = MAX_ROWS_PER_SHEET) {
     const doc3 = xmlParser2.parse(sheetXml);
     const worksheet = doc3?.["worksheet"];
-    if (!worksheet) return emptySheet("Sheet");
+    if (!worksheet) throw new MalformedPartError("A worksheet part has no <worksheet> root");
     const rels = sheetRelsXml ? parseSheetRels(sheetRelsXml) : /* @__PURE__ */ new Map();
     const sheetFormatPr = worksheet["sheetFormatPr"];
     const defaultRowHeight = sheetFormatPr?.["@_defaultRowHeight"] ? parseFloat(sheetFormatPr["@_defaultRowHeight"]) : 15;
@@ -64560,6 +64578,10 @@ ${e.toString()}`);
   var xmlParser3 = new XMLParser2({
     ignoreAttributes: false,
     attributeNamePrefix: "@_",
+    // A producer may bind spreadsheetml to a prefix (`<x:styleSheet>`) rather than
+    // making it the default namespace; the prefix carries no meaning, so it is
+    // dropped before anything looks a tag up — see `stripNsPrefix`.
+    transformTagName: stripNsPrefix,
     processEntities: false,
     isArray: (tagName) => tagName === "numFmt" || tagName === "font" || tagName === "fill" || tagName === "border" || tagName === "xf" || tagName === "rgbColor" || tagName === "stop"
   });
@@ -64893,6 +64915,10 @@ ${e.toString()}`);
   var xmlParser4 = new XMLParser2({
     ignoreAttributes: false,
     attributeNamePrefix: "@_",
+    // A producer may bind spreadsheetml to a prefix (`<x:workbook>`) rather than
+    // making it the default namespace; the prefix carries no meaning, so it is
+    // dropped before anything looks a tag up — see `stripNsPrefix`.
+    transformTagName: stripNsPrefix,
     // Shared-string and workbook text is textual BY DEFINITION (tax IDs, phone
     // numbers, account codes, sheet/defined names). fast-xml-parser's default tag
     // coercion would parse `<t>0312345678</t>` as the number 312345678 — silently
@@ -64906,7 +64932,7 @@ ${e.toString()}`);
   function parseWorkbook(workbookXml) {
     const doc3 = xmlParser4.parse(workbookXml);
     const wb = doc3?.["workbook"];
-    if (!wb) return { sheets: [], activeSheetIndex: 0, date1904: false, namedRanges: /* @__PURE__ */ new Map(), printTitlesBySheet: /* @__PURE__ */ new Map(), fullCalcOnLoad: false };
+    if (!wb) throw new MalformedPartError("xl/workbook.xml has no <workbook> root");
     const sheetsEl = wb["sheets"];
     const sheetArr = sheetsEl?.["sheet"];
     const sheets = (sheetArr ?? []).map((s) => ({
@@ -66220,9 +66246,7 @@ ${e.toString()}`);
     const stylesEntry = findEntry(zip, "xl/styles.xml");
     const styles = stylesEntry ? parseStyles(decodeUtf8(stylesEntry), theme) : emptyStyleResolver();
     const wbEntry = findEntry(zip, "xl/workbook.xml");
-    if (!wbEntry) {
-      return { sheets: [emptySheet("Sheet1")], activeSheetIndex: 0 };
-    }
+    if (!wbEntry) throw new MalformedPartError("The package has no xl/workbook.xml");
     const workbookInfo = parseWorkbook(decodeUtf8(wbEntry));
     const wbRelsEntry = findEntry(zip, "xl/_rels/workbook.xml.rels");
     const wbRels = wbRelsEntry ? parseWorkbookRels(decodeUtf8(wbRelsEntry)) : /* @__PURE__ */ new Map();
@@ -66236,22 +66260,20 @@ ${e.toString()}`);
     });
     const parseXmlDoc = (xml) => xmlParser5.parse(xml);
     const pivotCaches = /* @__PURE__ */ new Map();
-    if (wbEntry) {
-      const wbDoc = parseXmlDoc(decodeUtf8(wbEntry));
-      const wbCacheMap = extractWorkbookPivotCaches(wbDoc);
-      for (const [cacheId, rId] of wbCacheMap) {
-        const cacheTarget = wbRels.get(rId);
-        if (!cacheTarget) continue;
-        const cachePath = cacheTarget.startsWith("/") ? cacheTarget.slice(1) : `xl/${cacheTarget}`;
-        const cacheEntry = findEntry(zip, cachePath);
-        if (!cacheEntry) continue;
-        try {
-          pivotCaches.set(
-            cacheId,
-            parsePivotCacheDefinitionXml(decodeUtf8(cacheEntry), cacheId, parseXmlDoc)
-          );
-        } catch {
-        }
+    const wbDoc = parseXmlDoc(decodeUtf8(wbEntry));
+    const wbCacheMap = extractWorkbookPivotCaches(wbDoc);
+    for (const [cacheId, rId] of wbCacheMap) {
+      const cacheTarget = wbRels.get(rId);
+      if (!cacheTarget) continue;
+      const cachePath = cacheTarget.startsWith("/") ? cacheTarget.slice(1) : `xl/${cacheTarget}`;
+      const cacheEntry = findEntry(zip, cachePath);
+      if (!cacheEntry) continue;
+      try {
+        pivotCaches.set(
+          cacheId,
+          parsePivotCacheDefinitionXml(decodeUtf8(cacheEntry), cacheId, parseXmlDoc)
+        );
+      } catch {
       }
     }
     const sheets = [];
@@ -66375,6 +66397,11 @@ ${e.toString()}`);
       }
       visibleIndex++;
     }
+    if (sheets.length === 0 && workbookInfo.sheets.length > 0) {
+      throw new MalformedPartError(
+        `xl/workbook.xml declares ${workbookInfo.sheets.length} sheet(s) and none of their parts could be resolved`
+      );
+    }
     if (sheets.length === 0) {
       return { sheets: [emptySheet("Sheet1")], activeSheetIndex: 0 };
     }