@qvac/harness 0.2.9 → 0.2.10

package/README.md

@@ -48,7 +48,7 @@ dir, ...) are the ones `worker/harness-sidecar.mjs` documents in this repo. The
 in-house hosts don't call this directly — they use the repo's library surface
 (`harnessChild` under bare-supervisor), which owns that argv contract.
 
-## DOCX extraction
+## Office extraction
 
 Hosts can supply the bundled Python extractor to their document pipeline:
 
@@ -57,19 +57,27 @@ including from source and compiled-package consumers. The worker seeds this
 cache from shipped wheels; without it, Pyodide can try downloading packages.
 
 ```js
-import { extractDocxText, closeDocxWorker } from '@qvac/harness/docx'
+import { extractOfficeText, closeOfficeWorker } from '@qvac/harness/office'
 
-const text = await extractDocxText(bytes, 'notes.docx', { signal })
+const text = await extractOfficeText(bytes, 'report.xlsx', { signal, mimeType })
 // At host shutdown, after outstanding extractions have settled:
-await closeDocxWorker()
+await closeOfficeWorker()
 ```
 
-The extractor preserves paragraph and table order, accepts up to 20 MiB, and
-requires the shipped Python wheels. With the cache configured, extraction uses
-those wheels offline. Bundled hosts also set `QVAC_PYODIDE_WORKER_ENTRY` and
+DOCX preserves paragraph and table order. XLSX includes sheet names, nonempty rows,
+cached formula results and formula text when no cached result exists. PPTX includes
+slide text, grouped shapes and tables in slide order; speaker notes, images and charts
+are not extracted. Legacy XLS/PPT formats are unsupported. File extensions select the
+format, with `mimeType` as a fallback when the name has no recognized Office extension.
+
+The extractor accepts up to 20 MiB and requires the shipped Python wheels. With the
+cache configured, extraction uses those wheels offline. Bundled hosts also set `QVAC_PYODIDE_WORKER_ENTRY` and
 `QVAC_PYTHON_WHEELS_DIR` to their staged worker and wheels paths.
 Source checkouts prepare wheels with `bun run vendor:wheels`.
 
+The existing `extractDocxText` and `closeDocxWorker` exports from `@qvac/harness/docx`
+remain available. Both entry points share the same Python worker and cache.
+
 ## Development
 
 ```