officeparser 7.5.0 → 7.5.1

package/dist/sbom.cdx.json

@@ -3,9 +3,9 @@
   "bomFormat": "CycloneDX",
   "specVersion": "1.6",
   "version": 1,
-  "serialNumber": "urn:uuid:4832bfe4-dc86-401c-8c62-0a7874c8251b",
+  "serialNumber": "urn:uuid:30a1956c-acfa-497a-bf1c-b6d265b11bc0",
   "metadata": {
-    "timestamp": "2026-07-26T22:11:00.652Z",
+    "timestamp": "2026-07-30T21:00:33.153Z",
     "tools": {
       "components": [
         {
@@ -82,8 +82,8 @@
     "component": {
       "type": "application",
       "name": "officeparser",
-      "version": "7.5.0",
-      "bom-ref": "officeparser@7.5.0",
+      "version": "7.5.1",
+      "bom-ref": "officeparser@7.5.1",
       "author": "Harsh Ankur",
       "description": "A robust, strictly-typed Node.js and Browser library for parsing office files (.docx, .pptx, .xlsx, .odt, .odp, .ods, .pdf, .rtf, .csv, .md, .html, .epub) and generating high-fidelity outputs in Markdown, HTML, CSV, RTF, PDF, EPUB, and RAG-focused chunks.",
       "licenses": [
@@ -94,7 +94,7 @@
           }
         }
       ],
-      "purl": "pkg:npm/officeparser@7.5.0?vcs_url=git%2Bhttps%3A%2F%2Fgithub.com%2Fharshankur%2FofficeParser.git",
+      "purl": "pkg:npm/officeparser@7.5.1?vcs_url=git%2Bhttps%3A%2F%2Fgithub.com%2Fharshankur%2FofficeParser.git",
       "externalReferences": [
         {
           "url": "git+https://github.com/harshankur/officeParser.git",
@@ -126,7 +126,7 @@
       "name": "xmldom",
       "group": "@xmldom",
       "version": "0.9.10",
-      "bom-ref": "officeparser@7.5.0|@xmldom/xmldom@0.9.10",
+      "bom-ref": "officeparser@7.5.1|@xmldom/xmldom@0.9.10",
       "description": "A pure JavaScript W3C standard-based (XML DOM Level 2 Core) DOMParser and XMLSerializer module.",
       "licenses": [
         {
@@ -176,7 +176,7 @@
       "type": "library",
       "name": "fflate",
       "version": "0.8.3",
-      "bom-ref": "officeparser@7.5.0|fflate@0.8.3",
+      "bom-ref": "officeparser@7.5.1|fflate@0.8.3",
       "author": "Arjun Barrett",
       "description": "High performance (de)compression in an 8kB package",
       "licenses": [
@@ -227,7 +227,7 @@
       "type": "library",
       "name": "file-type",
       "version": "22.0.1",
-      "bom-ref": "officeparser@7.5.0|file-type@22.0.1",
+      "bom-ref": "officeparser@7.5.1|file-type@22.0.1",
       "author": "Sindre Sorhus",
       "description": "Detect the file type of a file, stream, or data",
       "licenses": [
@@ -278,7 +278,7 @@
       "type": "library",
       "name": "pdfjs-dist",
       "version": "6.1.200",
-      "bom-ref": "officeparser@7.5.0|pdfjs-dist@6.1.200",
+      "bom-ref": "officeparser@7.5.1|pdfjs-dist@6.1.200",
       "description": "Generic build of Mozilla's PDF.js library.",
       "licenses": [
         {
@@ -328,7 +328,7 @@
       "type": "library",
       "name": "tesseract.js",
       "version": "7.0.0",
-      "bom-ref": "officeparser@7.5.0|tesseract.js@7.0.0",
+      "bom-ref": "officeparser@7.5.1|tesseract.js@7.0.0",
       "description": "Pure Javascript Multilingual OCR",
       "licenses": [
         {
@@ -379,7 +379,7 @@
       "name": "inflate",
       "group": "@tokenizer",
       "version": "0.4.1",
-      "bom-ref": "officeparser@7.5.0|@tokenizer/inflate@0.4.1",
+      "bom-ref": "officeparser@7.5.1|@tokenizer/inflate@0.4.1",
       "author": "Borewit",
       "description": "Tokenized zip support",
       "licenses": [
@@ -430,7 +430,7 @@
       "type": "library",
       "name": "strtok3",
       "version": "10.3.5",
-      "bom-ref": "officeparser@7.5.0|strtok3@10.3.5",
+      "bom-ref": "officeparser@7.5.1|strtok3@10.3.5",
       "author": "Borewit",
       "description": "A promise based streaming tokenizer",
       "licenses": [
@@ -481,7 +481,7 @@
       "type": "library",
       "name": "token-types",
       "version": "6.1.2",
-      "bom-ref": "officeparser@7.5.0|token-types@6.1.2",
+      "bom-ref": "officeparser@7.5.1|token-types@6.1.2",
       "author": "Borewit",
       "description": "Common token types for decoding and encoding numeric and string values",
       "licenses": [
@@ -532,7 +532,7 @@
       "type": "library",
       "name": "uint8array-extras",
       "version": "1.5.0",
-      "bom-ref": "officeparser@7.5.0|uint8array-extras@1.5.0",
+      "bom-ref": "officeparser@7.5.1|uint8array-extras@1.5.0",
       "author": "Sindre Sorhus",
       "description": "Useful utilities for working with Uint8Array (and Buffer)",
       "licenses": [
@@ -584,7 +584,7 @@
       "name": "canvas",
       "group": "@napi-rs",
       "version": "1.0.1",
-      "bom-ref": "officeparser@7.5.0|@napi-rs/canvas@1.0.1",
+      "bom-ref": "officeparser@7.5.1|@napi-rs/canvas@1.0.1",
       "description": "Canvas for Node.js with skia backend",
       "scope": "optional",
       "licenses": [
@@ -635,7 +635,7 @@
       "type": "library",
       "name": "bmp-js",
       "version": "0.1.0",
-      "bom-ref": "officeparser@7.5.0|bmp-js@0.1.0",
+      "bom-ref": "officeparser@7.5.1|bmp-js@0.1.0",
       "author": "shaozilee",
       "description": "A pure javascript BMP encoder and decoder",
       "licenses": [
@@ -686,7 +686,7 @@
       "type": "library",
       "name": "idb-keyval",
       "version": "6.2.2",
-      "bom-ref": "officeparser@7.5.0|idb-keyval@6.2.2",
+      "bom-ref": "officeparser@7.5.1|idb-keyval@6.2.2",
       "author": "Jake Archibald",
       "description": "A super-simple-small keyval store built on top of IndexedDB",
       "licenses": [
@@ -737,7 +737,7 @@
       "type": "library",
       "name": "is-url",
       "version": "1.2.4",
-      "bom-ref": "officeparser@7.5.0|is-url@1.2.4",
+      "bom-ref": "officeparser@7.5.1|is-url@1.2.4",
       "description": "Check whether a string is a URL.",
       "licenses": [
         {
@@ -787,7 +787,7 @@
       "type": "library",
       "name": "node-fetch",
       "version": "2.7.0",
-      "bom-ref": "officeparser@7.5.0|node-fetch@2.7.0",
+      "bom-ref": "officeparser@7.5.1|node-fetch@2.7.0",
       "author": "David Frank",
       "description": "A light-weight module that brings window.fetch to node.js",
       "licenses": [
@@ -838,7 +838,7 @@
       "type": "library",
       "name": "opencollective-postinstall",
       "version": "2.0.3",
-      "bom-ref": "officeparser@7.5.0|opencollective-postinstall@2.0.3",
+      "bom-ref": "officeparser@7.5.1|opencollective-postinstall@2.0.3",
       "author": "Xavier Damman",
       "description": "Lightweight npm postinstall message to invite people to donate to your collective",
       "licenses": [
@@ -889,7 +889,7 @@
       "type": "library",
       "name": "regenerator-runtime",
       "version": "0.13.11",
-      "bom-ref": "officeparser@7.5.0|regenerator-runtime@0.13.11",
+      "bom-ref": "officeparser@7.5.1|regenerator-runtime@0.13.11",
       "author": "Ben Newman",
       "description": "Runtime for Regenerator-compiled generator and async functions.",
       "licenses": [
@@ -940,7 +940,7 @@
       "type": "library",
       "name": "tesseract.js-core",
       "version": "7.0.0",
-      "bom-ref": "officeparser@7.5.0|tesseract.js-core@7.0.0",
+      "bom-ref": "officeparser@7.5.1|tesseract.js-core@7.0.0",
       "author": "antimatter15",
       "description": "Tesseract C++ API in Pure Javascript",
       "licenses": [
@@ -991,7 +991,7 @@
       "type": "library",
       "name": "wasm-feature-detect",
       "version": "1.8.0",
-      "bom-ref": "officeparser@7.5.0|wasm-feature-detect@1.8.0",
+      "bom-ref": "officeparser@7.5.1|wasm-feature-detect@1.8.0",
       "author": "Surma",
       "description": "A small library to detect which features of WebAssembly are supported in your current browser.",
       "licenses": [
@@ -1042,7 +1042,7 @@
       "type": "library",
       "name": "zlibjs",
       "version": "0.3.1",
-      "bom-ref": "officeparser@7.5.0|zlibjs@0.3.1",
+      "bom-ref": "officeparser@7.5.1|zlibjs@0.3.1",
       "author": "Yuta Imaya",
       "description": "zlib, gzip and zip implementation in JavaScript",
       "licenses": [
@@ -1093,7 +1093,7 @@
       "type": "library",
       "name": "debug",
       "version": "4.4.3",
-      "bom-ref": "officeparser@7.5.0|debug@4.4.3",
+      "bom-ref": "officeparser@7.5.1|debug@4.4.3",
       "author": "Josh Junon",
       "description": "Lightweight debugging utility for Node.js and the browser",
       "licenses": [
@@ -1145,7 +1145,7 @@
       "name": "token",
       "group": "@tokenizer",
       "version": "0.3.0",
-      "bom-ref": "officeparser@7.5.0|@tokenizer/token@0.3.0",
+      "bom-ref": "officeparser@7.5.1|@tokenizer/token@0.3.0",
       "author": "Borewit",
       "description": "TypeScript definition for strtok3 token",
       "licenses": [
@@ -1197,7 +1197,7 @@
       "name": "text-codec",
       "group": "@borewit",
       "version": "0.2.2",
-      "bom-ref": "officeparser@7.5.0|@borewit/text-codec@0.2.2",
+      "bom-ref": "officeparser@7.5.1|@borewit/text-codec@0.2.2",
       "author": "Borewit",
       "description": "Text Decoder",
       "licenses": [
@@ -1248,7 +1248,7 @@
       "type": "library",
       "name": "ieee754",
       "version": "1.2.1",
-      "bom-ref": "officeparser@7.5.0|ieee754@1.2.1",
+      "bom-ref": "officeparser@7.5.1|ieee754@1.2.1",
       "author": "Feross Aboukhadijeh",
       "description": "Read/write IEEE754 floating point numbers from/to a Buffer or array-like object",
       "licenses": [
@@ -1300,7 +1300,7 @@
       "name": "canvas-linux-x64-gnu",
       "group": "@napi-rs",
       "version": "1.0.1",
-      "bom-ref": "officeparser@7.5.0|@napi-rs/canvas-linux-x64-gnu@1.0.1",
+      "bom-ref": "officeparser@7.5.1|@napi-rs/canvas-linux-x64-gnu@1.0.1",
       "description": "Canvas for Node.js with skia backend",
       "scope": "optional",
       "licenses": [
@@ -1351,7 +1351,7 @@
       "type": "library",
       "name": "whatwg-url",
       "version": "5.0.0",
-      "bom-ref": "officeparser@7.5.0|whatwg-url@5.0.0",
+      "bom-ref": "officeparser@7.5.1|whatwg-url@5.0.0",
       "author": "Sebastian Mayr",
       "description": "An implementation of the WHATWG URL Standard's URL API and parsing machinery",
       "licenses": [
@@ -1402,7 +1402,7 @@
       "type": "library",
       "name": "ms",
       "version": "2.1.3",
-      "bom-ref": "officeparser@7.5.0|ms@2.1.3",
+      "bom-ref": "officeparser@7.5.1|ms@2.1.3",
       "description": "Tiny millisecond conversion utility",
       "licenses": [
         {
@@ -1452,7 +1452,7 @@
       "type": "library",
       "name": "tr46",
       "version": "0.0.3",
-      "bom-ref": "officeparser@7.5.0|tr46@0.0.3",
+      "bom-ref": "officeparser@7.5.1|tr46@0.0.3",
       "author": "Sebastian Mayr",
       "description": "An implementation of the Unicode TR46 spec",
       "licenses": [
@@ -1503,7 +1503,7 @@
       "type": "library",
       "name": "webidl-conversions",
       "version": "3.0.1",
-      "bom-ref": "officeparser@7.5.0|webidl-conversions@3.0.1",
+      "bom-ref": "officeparser@7.5.1|webidl-conversions@3.0.1",
       "author": "Domenic Denicola",
       "description": "Implements the WebIDL algorithms for converting to and from JavaScript values",
       "licenses": [
@@ -1553,143 +1553,143 @@
   ],
   "dependencies": [
     {
-      "ref": "officeparser@7.5.0",
+      "ref": "officeparser@7.5.1",
       "dependsOn": [
-        "officeparser@7.5.0|@xmldom/xmldom@0.9.10",
-        "officeparser@7.5.0|fflate@0.8.3",
-        "officeparser@7.5.0|file-type@22.0.1",
-        "officeparser@7.5.0|pdfjs-dist@6.1.200",
-        "officeparser@7.5.0|tesseract.js@7.0.0"
+        "officeparser@7.5.1|@xmldom/xmldom@0.9.10",
+        "officeparser@7.5.1|fflate@0.8.3",
+        "officeparser@7.5.1|file-type@22.0.1",
+        "officeparser@7.5.1|pdfjs-dist@6.1.200",
+        "officeparser@7.5.1|tesseract.js@7.0.0"
       ]
     },
     {
-      "ref": "officeparser@7.5.0|@xmldom/xmldom@0.9.10"
+      "ref": "officeparser@7.5.1|@xmldom/xmldom@0.9.10"
     },
     {
-      "ref": "officeparser@7.5.0|fflate@0.8.3"
+      "ref": "officeparser@7.5.1|fflate@0.8.3"
     },
     {
-      "ref": "officeparser@7.5.0|file-type@22.0.1",
+      "ref": "officeparser@7.5.1|file-type@22.0.1",
       "dependsOn": [
-        "officeparser@7.5.0|@tokenizer/inflate@0.4.1",
-        "officeparser@7.5.0|strtok3@10.3.5",
-        "officeparser@7.5.0|token-types@6.1.2",
-        "officeparser@7.5.0|uint8array-extras@1.5.0"
+        "officeparser@7.5.1|@tokenizer/inflate@0.4.1",
+        "officeparser@7.5.1|strtok3@10.3.5",
+        "officeparser@7.5.1|token-types@6.1.2",
+        "officeparser@7.5.1|uint8array-extras@1.5.0"
       ]
     },
     {
-      "ref": "officeparser@7.5.0|pdfjs-dist@6.1.200",
+      "ref": "officeparser@7.5.1|pdfjs-dist@6.1.200",
       "dependsOn": [
-        "officeparser@7.5.0|@napi-rs/canvas@1.0.1"
+        "officeparser@7.5.1|@napi-rs/canvas@1.0.1"
       ]
     },
     {
-      "ref": "officeparser@7.5.0|tesseract.js@7.0.0",
+      "ref": "officeparser@7.5.1|tesseract.js@7.0.0",
       "dependsOn": [
-        "officeparser@7.5.0|bmp-js@0.1.0",
-        "officeparser@7.5.0|idb-keyval@6.2.2",
-        "officeparser@7.5.0|is-url@1.2.4",
-        "officeparser@7.5.0|node-fetch@2.7.0",
-        "officeparser@7.5.0|opencollective-postinstall@2.0.3",
-        "officeparser@7.5.0|regenerator-runtime@0.13.11",
-        "officeparser@7.5.0|tesseract.js-core@7.0.0",
-        "officeparser@7.5.0|wasm-feature-detect@1.8.0",
-        "officeparser@7.5.0|zlibjs@0.3.1"
+        "officeparser@7.5.1|bmp-js@0.1.0",
+        "officeparser@7.5.1|idb-keyval@6.2.2",
+        "officeparser@7.5.1|is-url@1.2.4",
+        "officeparser@7.5.1|node-fetch@2.7.0",
+        "officeparser@7.5.1|opencollective-postinstall@2.0.3",
+        "officeparser@7.5.1|regenerator-runtime@0.13.11",
+        "officeparser@7.5.1|tesseract.js-core@7.0.0",
+        "officeparser@7.5.1|wasm-feature-detect@1.8.0",
+        "officeparser@7.5.1|zlibjs@0.3.1"
       ]
     },
     {
-      "ref": "officeparser@7.5.0|@tokenizer/inflate@0.4.1",
+      "ref": "officeparser@7.5.1|@tokenizer/inflate@0.4.1",
       "dependsOn": [
-        "officeparser@7.5.0|debug@4.4.3",
-        "officeparser@7.5.0|token-types@6.1.2"
+        "officeparser@7.5.1|debug@4.4.3",
+        "officeparser@7.5.1|token-types@6.1.2"
       ]
     },
     {
-      "ref": "officeparser@7.5.0|strtok3@10.3.5",
+      "ref": "officeparser@7.5.1|strtok3@10.3.5",
       "dependsOn": [
-        "officeparser@7.5.0|@tokenizer/token@0.3.0"
+        "officeparser@7.5.1|@tokenizer/token@0.3.0"
       ]
     },
     {
-      "ref": "officeparser@7.5.0|token-types@6.1.2",
+      "ref": "officeparser@7.5.1|token-types@6.1.2",
       "dependsOn": [
-        "officeparser@7.5.0|@borewit/text-codec@0.2.2",
-        "officeparser@7.5.0|@tokenizer/token@0.3.0",
-        "officeparser@7.5.0|ieee754@1.2.1"
+        "officeparser@7.5.1|@borewit/text-codec@0.2.2",
+        "officeparser@7.5.1|@tokenizer/token@0.3.0",
+        "officeparser@7.5.1|ieee754@1.2.1"
       ]
     },
     {
-      "ref": "officeparser@7.5.0|uint8array-extras@1.5.0"
+      "ref": "officeparser@7.5.1|uint8array-extras@1.5.0"
     },
     {
-      "ref": "officeparser@7.5.0|@napi-rs/canvas@1.0.1",
+      "ref": "officeparser@7.5.1|@napi-rs/canvas@1.0.1",
       "dependsOn": [
-        "officeparser@7.5.0|@napi-rs/canvas-linux-x64-gnu@1.0.1"
+        "officeparser@7.5.1|@napi-rs/canvas-linux-x64-gnu@1.0.1"
       ]
     },
     {
-      "ref": "officeparser@7.5.0|bmp-js@0.1.0"
+      "ref": "officeparser@7.5.1|bmp-js@0.1.0"
     },
     {
-      "ref": "officeparser@7.5.0|idb-keyval@6.2.2"
+      "ref": "officeparser@7.5.1|idb-keyval@6.2.2"
     },
     {
-      "ref": "officeparser@7.5.0|is-url@1.2.4"
+      "ref": "officeparser@7.5.1|is-url@1.2.4"
     },
     {
-      "ref": "officeparser@7.5.0|node-fetch@2.7.0",
+      "ref": "officeparser@7.5.1|node-fetch@2.7.0",
       "dependsOn": [
-        "officeparser@7.5.0|whatwg-url@5.0.0"
+        "officeparser@7.5.1|whatwg-url@5.0.0"
       ]
     },
     {
-      "ref": "officeparser@7.5.0|opencollective-postinstall@2.0.3"
+      "ref": "officeparser@7.5.1|opencollective-postinstall@2.0.3"
     },
     {
-      "ref": "officeparser@7.5.0|regenerator-runtime@0.13.11"
+      "ref": "officeparser@7.5.1|regenerator-runtime@0.13.11"
     },
     {
-      "ref": "officeparser@7.5.0|tesseract.js-core@7.0.0"
+      "ref": "officeparser@7.5.1|tesseract.js-core@7.0.0"
     },
     {
-      "ref": "officeparser@7.5.0|wasm-feature-detect@1.8.0"
+      "ref": "officeparser@7.5.1|wasm-feature-detect@1.8.0"
     },
     {
-      "ref": "officeparser@7.5.0|zlibjs@0.3.1"
+      "ref": "officeparser@7.5.1|zlibjs@0.3.1"
     },
     {
-      "ref": "officeparser@7.5.0|debug@4.4.3",
+      "ref": "officeparser@7.5.1|debug@4.4.3",
       "dependsOn": [
-        "officeparser@7.5.0|ms@2.1.3"
+        "officeparser@7.5.1|ms@2.1.3"
       ]
     },
     {
-      "ref": "officeparser@7.5.0|@tokenizer/token@0.3.0"
+      "ref": "officeparser@7.5.1|@tokenizer/token@0.3.0"
     },
     {
-      "ref": "officeparser@7.5.0|@borewit/text-codec@0.2.2"
+      "ref": "officeparser@7.5.1|@borewit/text-codec@0.2.2"
     },
     {
-      "ref": "officeparser@7.5.0|ieee754@1.2.1"
+      "ref": "officeparser@7.5.1|ieee754@1.2.1"
     },
     {
-      "ref": "officeparser@7.5.0|@napi-rs/canvas-linux-x64-gnu@1.0.1"
+      "ref": "officeparser@7.5.1|@napi-rs/canvas-linux-x64-gnu@1.0.1"
     },
     {
-      "ref": "officeparser@7.5.0|whatwg-url@5.0.0",
+      "ref": "officeparser@7.5.1|whatwg-url@5.0.0",
       "dependsOn": [
-        "officeparser@7.5.0|tr46@0.0.3",
-        "officeparser@7.5.0|webidl-conversions@3.0.1"
+        "officeparser@7.5.1|tr46@0.0.3",
+        "officeparser@7.5.1|webidl-conversions@3.0.1"
       ]
     },
     {
-      "ref": "officeparser@7.5.0|ms@2.1.3"
+      "ref": "officeparser@7.5.1|ms@2.1.3"
     },
     {
-      "ref": "officeparser@7.5.0|tr46@0.0.3"
+      "ref": "officeparser@7.5.1|tr46@0.0.3"
     },
     {
-      "ref": "officeparser@7.5.0|webidl-conversions@3.0.1"
+      "ref": "officeparser@7.5.1|webidl-conversions@3.0.1"
     }
   ]
 }

package/dist/types.d.ts

@@ -39,6 +39,12 @@ export declare enum OfficeErrorType {
     ZIP_ENTRY_INVALID_SIZE = "ZIP_ENTRY_INVALID_SIZE",
     /** ZIP uncompressed size limit exceeded */
     ZIP_SIZE_LIMIT_EXCEEDED = "ZIP_SIZE_LIMIT_EXCEEDED",
+    /** ZIP data yielded no readable entries (corrupt, truncated, or not a ZIP archive) */
+    ZIP_NO_ENTRIES_FOUND = "ZIP_NO_ENTRIES_FOUND",
+    /** ZIP data is truncated: the End of Central Directory record is absent */
+    ZIP_TRUNCATED = "ZIP_TRUNCATED",
+    /** A readable ZIP archive is missing the part its document format requires */
+    REQUIRED_PART_MISSING = "REQUIRED_PART_MISSING",
     /** Document element/structure nesting exceeded the safe recursion depth */
     MAX_NESTING_DEPTH_EXCEEDED = "MAX_NESTING_DEPTH_EXCEEDED",
     /** Embedding call timed out */
@@ -88,7 +94,11 @@ export declare enum OfficeWarningType {
     /** A metadata override could not be represented in the destination format's vocabulary */
     METADATA_NOT_REPRESENTABLE = "METADATA_NOT_REPRESENTABLE",
     /** A styleMap output.tag was not an allowed element name and was ignored */
-    INVALID_STYLE_MAP_TAG = "INVALID_STYLE_MAP_TAG"
+    INVALID_STYLE_MAP_TAG = "INVALID_STYLE_MAP_TAG",
+    /** A workbook archive contains no worksheet parts (chartsheet-only workbooks are legitimate) */
+    NO_WORKSHEETS_FOUND = "NO_WORKSHEETS_FOUND",
+    /** A presentation archive contains no slides (a zero-slide presentation is legitimate) */
+    NO_SLIDES_FOUND = "NO_SLIDES_FOUND"
 }
 /**
  * Consolidated timeout settings for OCR operations.
@@ -466,6 +476,29 @@ export interface OfficeIssue {
     /** Optional additional context or original error object. */
     details?: any;
 }
+/**
+ * An Error thrown by OfficeParser, carrying the structured issue that produced it.
+ *
+ * Catching code can branch on `error.officeIssue.code`, the same stable enum used for warnings,
+ * instead of matching against message text. Errors that originate outside the library (and
+ * `AbortError`, which is deliberately re-thrown untouched so cancellation stays detectable via
+ * `error.name`) do not carry this property, hence the optional marker.
+ *
+ * @example
+ * ```typescript
+ * try {
+ *     await parseOffice(buffer, { fileType: 'docx' });
+ * } catch (err) {
+ *     if ((err as OfficeError).officeIssue?.code === OfficeErrorType.REQUIRED_PART_MISSING) {
+ *         // the archive is readable, but it is not a docx
+ *     }
+ * }
+ * ```
+ */
+export interface OfficeError extends Error {
+    /** The structured issue this error was created from. */
+    officeIssue?: OfficeIssue;
+}
 /**
  * The result of a document conversion operation.
  */

package/dist/types.js

@@ -43,6 +43,12 @@ var OfficeErrorType;
     OfficeErrorType["ZIP_ENTRY_INVALID_SIZE"] = "ZIP_ENTRY_INVALID_SIZE";
     /** ZIP uncompressed size limit exceeded */
     OfficeErrorType["ZIP_SIZE_LIMIT_EXCEEDED"] = "ZIP_SIZE_LIMIT_EXCEEDED";
+    /** ZIP data yielded no readable entries (corrupt, truncated, or not a ZIP archive) */
+    OfficeErrorType["ZIP_NO_ENTRIES_FOUND"] = "ZIP_NO_ENTRIES_FOUND";
+    /** ZIP data is truncated: the End of Central Directory record is absent */
+    OfficeErrorType["ZIP_TRUNCATED"] = "ZIP_TRUNCATED";
+    /** A readable ZIP archive is missing the part its document format requires */
+    OfficeErrorType["REQUIRED_PART_MISSING"] = "REQUIRED_PART_MISSING";
     /** Document element/structure nesting exceeded the safe recursion depth */
     OfficeErrorType["MAX_NESTING_DEPTH_EXCEEDED"] = "MAX_NESTING_DEPTH_EXCEEDED";
     /** Embedding call timed out */
@@ -94,4 +100,8 @@ var OfficeWarningType;
     OfficeWarningType["METADATA_NOT_REPRESENTABLE"] = "METADATA_NOT_REPRESENTABLE";
     /** A styleMap output.tag was not an allowed element name and was ignored */
     OfficeWarningType["INVALID_STYLE_MAP_TAG"] = "INVALID_STYLE_MAP_TAG";
+    /** A workbook archive contains no worksheet parts (chartsheet-only workbooks are legitimate) */
+    OfficeWarningType["NO_WORKSHEETS_FOUND"] = "NO_WORKSHEETS_FOUND";
+    /** A presentation archive contains no slides (a zero-slide presentation is legitimate) */
+    OfficeWarningType["NO_SLIDES_FOUND"] = "NO_SLIDES_FOUND";
 })(OfficeWarningType || (exports.OfficeWarningType = OfficeWarningType = {}));

package/dist/utils/configUtils.d.ts

@@ -10,18 +10,31 @@ export declare function isFullParserConfig(config: any): config is FullOfficePar
 /**
  * Resolves a full parser configuration by merging defaults and user-provided overrides.
  *
+ * The returned object always belongs solely to the caller of this function. That matters
+ * because a parse installs per-call state on the config it is handed, such as the collector
+ * that gathers warnings for one document's `ast.warnings`. Returning the caller's own object
+ * would attach that state to an object they may reuse, so a second parse would append its
+ * warnings to the first document's already-returned AST, and each parse would retain the
+ * previous one's state for as long as the config lived.
+ *
+ * Only the configuration containers are copied. Callbacks and `abortSignal` keep their
+ * identity, since a copy of an `AbortSignal` would no longer be tied to its controller.
+ *
  * @param userConfig - Optional configuration provided by the user
- * @returns A fully populated configuration object
+ * @returns A fully populated configuration object, owned by the caller
  */
 export declare function resolveParserConfig(userConfig?: OfficeParserConfig | FullOfficeParserConfig): FullOfficeParserConfig;
 /**
  * Resolves a full, destination-specific configuration by merging defaults,
  * AST-level settings, and user-provided overrides.
  *
+ * As with {@link resolveParserConfig}, the returned object belongs solely to the caller of this
+ * function, so that per-run normalization cannot edit a config the caller still holds.
+ *
  * @param destination - The target format
  * @param userConfig - Optional configuration provided by the user
  * @param astConfig - Optional configuration from the source AST (for inheritance)
- * @returns A fully populated configuration object
+ * @returns A fully populated configuration object, owned by the caller
  */
 export declare function resolveGeneratorConfig<D extends string>(destination: D, astConfig?: OfficeParserConfig, userConfig?: GeneratorConfig<D> | FullGeneratorConfig): FullGeneratorConfig;
 /**