web-doc 0.3.0

package/LICENSE-APACHE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!) The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright 2026 Zrimo contributors
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/LICENSE-MIT

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Zrimo contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,148 @@
+# web-doc
+
+**Any document. One canvas.**
+
+[Website](https://bnku.github.io/zrimo/) ·
+[Live React demo](https://bnku.github.io/zrimo/demo/) ·
+[Documentation](https://bnku.github.io/zrimo/getting-started) ·
+[GitHub](https://github.com/leonidkuznetsov18/web-doc)
+
+> web-doc is a fork of [Zrimo](https://github.com/bnku/zrimo) maintained at
+> [leonidkuznetsov18/web-doc](https://github.com/leonidkuznetsov18/web-doc).
+> It adds page-scoped search (`SearchOptions.pageRange`) and is released
+> independently; the runtime API, CSS hooks (`.zrimo-ui`, `--zrimo-*`) and
+> asset layout are the same as upstream's `@zrimo/viewer`.
+
+## Why web-doc?
+
+- **One viewer for common business formats.** Open DOCX, XLSX, PPTX, legacy
+  Office, PDF, images, SVG, CSV and TSV through one TypeScript API.
+- **Use our interface or bring your own.** Mount the built-in toolbar, hide it
+  behind React controls, or render headlessly to your own canvas.
+- **Real document interactions.** Pan, zoom, fit, search, selectable text,
+  thumbnails, sheet navigation, multi-cell selection and TSV clipboard output.
+- **International documents.** Latin, Cyrillic, CJK, Arabic and supported Indic
+  scripts use application fonts, system fonts or lazy self-hosted fallbacks.
+- **Browser-private by design.** Parsers, renderers and legacy converters run
+  locally; format-specific Rust/WASM modules load only when needed.
+
+## Install
+
+```bash
+npm install web-doc
+npx web-doc-copy-assets public/zrimo
+```
+
+The second command copies workers, WASM modules and optional font assets into
+your application's public directory. Until a version is on npm, every
+[GitHub release](https://github.com/leonidkuznetsov18/web-doc/releases) carries
+the same tarball (`web-doc-x.y.z.tgz`, with `SHA256SUMS`), which can be
+pinned by URL instead.
+
+## Quick start
+
+```ts
+import { ViewerClient } from "web-doc";
+import "web-doc/styles.css";
+
+const client = ViewerClient.create({
+  assetBaseUrl: new URL("/zrimo/", location.href),
+});
+
+const viewer = client.createViewer({
+  container: document.querySelector("#viewer")!,
+  ui: true,
+  fit: "width",
+});
+
+await viewer.load(file, { fileName: file.name });
+
+// When the host component unmounts:
+await viewer.destroy();
+await client.destroy();
+```
+
+Give the host element an explicit size:
+
+```css
+#viewer {
+  width: 100%;
+  height: 100%;
+  min-height: 320px;
+}
+```
+
+See the [installation guide](https://bnku.github.io/zrimo/getting-started) for
+framework setup, asset paths and production MIME configuration.
+
+## Choose your integration
+
+| Approach    | Configuration                            | Best for                                              |
+| ----------- | ---------------------------------------- | ----------------------------------------------------- |
+| Built-in UI | `createViewer({ container, ui: true })`  | A complete viewer with minimal host code              |
+| Custom UI   | `createViewer({ container, ui: false })` | React/Vue/Svelte controls around the managed viewport |
+| Headless    | `web-doc/headless`                       | Custom canvas rendering and application-owned layout  |
+
+The [live React demo](https://bnku.github.io/zrimo/demo/) shows the built-in UI,
+a fully custom React toolbar and the headless API side by side.
+
+## Supported formats
+
+| Family               | Formats                                              |
+| -------------------- | ---------------------------------------------------- |
+| Modern Office        | DOCX, DOCM, XLSX, XLSM, PPTX, PPTM, PPSX             |
+| Legacy Office        | Word 97–2003 DOC, BIFF8 XLS, PPT                     |
+| Documents and images | PDF, PNG, JPEG, WebP, GIF, BMP, multi-page TIFF, SVG |
+| Structured data      | CSV, TSV                                             |
+
+Macros and document scripts never execute. Spreadsheet formulas display their
+stored cached values. Images are rendered without OCR. Password-protected
+documents are not currently supported, and complex legacy Office objects may
+render with reduced fidelity. The maintained details live in the
+[compatibility guide](https://bnku.github.io/zrimo/compatibility).
+
+## Public entry points
+
+- `web-doc` — complete API and optional built-in UI;
+- `web-doc/headless` — UI-free runtime and adapters;
+- `web-doc/worker` — worker adapter and RPC contracts;
+- `web-doc/styles.css` — built-in UI styles;
+- `web-doc/assets/*`, `/workers/*`, `/fonts/*` — explicit runtime assets.
+
+Start with the [API reference](https://bnku.github.io/zrimo/api/reference),
+[UI guide](https://bnku.github.io/zrimo/ui) or
+[framework integrations](https://bnku.github.io/zrimo/integrations).
+
+## Browser support
+
+Zrimo targets Safari 16.4+ and the latest two stable Chrome, Edge, Firefox and
+Safari releases. Automated browser coverage runs in Chromium, Firefox and
+WebKit.
+
+## Built on open source
+
+Zrimo exists thanks to the maintainers and contributors behind these projects:
+
+| Project                                                                                                                                              | License                   | Used for                                                              |
+| ---------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------- | --------------------------------------------------------------------- |
+| [Office Open XML Viewer (`@silurus/ooxml`)](https://github.com/yukiyokotani/office-open-xml-viewer)                                                  | MIT                       | Rust/WASM parsing and Canvas rendering for DOCX, XLSX and PPTX        |
+| [`office_oxide`](https://github.com/yfedoseev/office_oxide)                                                                                          | MIT OR Apache-2.0         | Compound files, shared Office utilities and legacy XLS/PPT conversion |
+| [Mozilla PDF.js](https://github.com/mozilla/pdf.js)                                                                                                  | Apache-2.0                | PDF parsing, fonts, Canvas rendering, links and selectable text       |
+| [`@napi-rs/canvas`](https://github.com/Brooooooklyn/canvas)                                                                                          | MIT                       | Optional PDF.js Node dependency; not bundled into the browser runtime |
+| [`image`](https://github.com/image-rs/image) and [`tiff`](https://github.com/image-rs/image-tiff)                                                    | MIT OR Apache-2.0 / MIT   | Multi-page TIFF decoding and image output                             |
+| [`wasm-bindgen`](https://github.com/wasm-bindgen/wasm-bindgen)                                                                                       | MIT OR Apache-2.0         | JavaScript and TypeScript bindings for Rust/WASM modules              |
+| [`zip`](https://github.com/zip-rs/zip2)                                                                                                              | MIT                       | Bounded in-memory ZIP and OOXML package handling                      |
+| [Serde](https://github.com/serde-rs/serde), [`serde_json`](https://github.com/serde-rs/json) and [`thiserror`](https://github.com/dtolnay/thiserror) | MIT OR Apache-2.0         | Serialization and structured Rust errors                              |
+| [`core-js`](https://github.com/zloirock/core-js)                                                                                                     | MIT                       | Compatibility modules used by the PDF.js legacy browser build         |
+| [Noto Sans](https://github.com/notofonts/noto-fonts) and [Noto Sans CJK](https://github.com/notofonts/noto-cjk)                                      | SIL Open Font License 1.1 | Lazy self-hosted multilingual fallback fonts                          |
+
+Third-party components retain their own licenses. The npm package includes
+`THIRD_PARTY_NOTICES.md` and its font notices. The complete pinned inventory is
+available as the repository's
+[generated SPDX SBOM](https://github.com/bnku/zrimo/blob/main/artifacts/sbom.spdx.json).
+
+## License
+
+Zrimo's original source code and documentation are dual-licensed, at your
+option, under the [MIT License](LICENSE-MIT) or the
+[Apache License 2.0](LICENSE-APACHE). Copyright (c) 2026 Zrimo contributors.

package/THIRD_PARTY_NOTICES.md

@@ -0,0 +1,20 @@
+# Third-party notices
+
+The release artifact contains or depends on the following principal components. The generated SPDX SBOM in `artifacts/sbom.spdx.json` is the complete machine-readable inventory for the pinned lockfiles.
+
+- [`@silurus/ooxml`](https://github.com/yukiyokotani/office-open-xml-viewer) — MIT; modern Office parsing/rendering.
+- [`office_oxide`](https://github.com/yfedoseev/office_oxide) — MIT OR Apache-2.0; compound-file handling, Office IR/writer utilities and legacy XLS/PPT conversion.
+- [`pdfjs-dist` / Mozilla PDF.js](https://github.com/mozilla/pdf.js) — Apache-2.0; browser PDF parsing,
+  font/CMap handling, canvas rendering, and text extraction. The packaged
+  standard-font, ICC, CMap, OpenJPEG, JBIG2, and QCMS assets retain the license
+  files distributed with PDF.js under `dist/assets/pdfjs/`.
+- [`core-js`](https://github.com/zloirock/core-js) compatibility modules embedded in the PDF.js legacy browser build —
+  MIT; polyfills required by the supported browser matrix, including the PDF
+  worker realm.
+- [`@napi-rs/canvas`](https://github.com/Brooooooklyn/canvas) — MIT; optional Node canvas backend pulled by PDF.js and excluded from Zrimo's browser bundle.
+- [`image`](https://github.com/image-rs/image) and [`tiff`](https://github.com/image-rs/image-tiff) Rust crates — MIT OR Apache-2.0 / MIT; multi-page TIFF decoding and PNG output.
+- [`wasm-bindgen`](https://github.com/wasm-bindgen/wasm-bindgen) — MIT OR Apache-2.0; browser bindings for project-owned Rust/WASM modules.
+- [`zip`](https://github.com/zip-rs/zip2) — MIT; bounded in-memory ZIP/OOXML package manipulation.
+- [Serde](https://github.com/serde-rs/serde), [`serde_json`](https://github.com/serde-rs/json) and [`thiserror`](https://github.com/dtolnay/thiserror) — MIT OR Apache-2.0; serialization and structured Rust errors.
+- [Noto Sans](https://github.com/notofonts/noto-fonts) and [Noto Sans CJK](https://github.com/notofonts/noto-cjk) subset fonts — SIL Open Font License 1.1. The font manifest, complete OFL text, pinned source commits and SHA-256 hashes are included in `dist/fonts/`.
+  No Microsoft proprietary font or copyleft runtime component is bundled. Transitive notices and license expressions are verified by `npm run licenses`.

package/bin/copy-assets.mjs

@@ -0,0 +1,27 @@
+#!/usr/bin/env node
+
+import { cp, mkdir } from "node:fs/promises";
+import { resolve } from "node:path";
+
+const packageRoot = resolve(import.meta.dirname, "..");
+const destination = process.argv[2];
+
+if (!destination || destination === "--help" || destination === "-h") {
+  console.log("Usage: web-doc-copy-assets <public-directory>");
+  console.log("Copies Zrimo workers, WASM/PDF assets, and optional fonts.");
+  process.exit(destination ? 0 : 1);
+}
+
+const output = resolve(process.cwd(), destination);
+await mkdir(output, { recursive: true });
+for (const directory of ["assets", "fonts", "workers"]) {
+  await cp(
+    resolve(packageRoot, "dist", directory),
+    resolve(output, directory),
+    {
+      recursive: true,
+      force: true,
+    },
+  );
+}
+console.log(`Zrimo runtime assets copied to ${output}`);

package/dist/abort.d.ts

@@ -0,0 +1 @@
+export declare function linkedAbortController(...signals: readonly (AbortSignal | undefined)[]): AbortController;

package/dist/abort.js

@@ -0,0 +1,18 @@
+import { abortError } from "./errors.js";
+export function linkedAbortController(...signals) {
+    const controller = new AbortController();
+    const abort = () => controller.abort(abortError());
+    for (const signal of signals) {
+        if (!signal)
+            continue;
+        if (signal.aborted) {
+            abort();
+            break;
+        }
+        signal.addEventListener("abort", abort, {
+            once: true,
+            signal: controller.signal,
+        });
+    }
+    return controller;
+}

package/dist/adapters/bitmap.d.ts

@@ -0,0 +1,9 @@
+export declare function drawEncodedImage(data: Uint8Array, mimeType: string, target: HTMLCanvasElement | OffscreenCanvas, options: {
+    readonly dpr: number;
+    readonly cssWidth?: number;
+    readonly cssHeight?: number;
+    readonly scale?: number;
+}): Promise<{
+    width: number;
+    height: number;
+}>;

package/dist/adapters/bitmap.js

@@ -0,0 +1,63 @@
+import { ViewerError } from "../errors.js";
+export async function drawEncodedImage(data, mimeType, target, options) {
+    const blob = new Blob([data.slice()], { type: mimeType });
+    const decoded = await decodeImage(blob);
+    try {
+        const naturalWidth = decoded.width;
+        const naturalHeight = decoded.height;
+        const dpr = Math.max(1, options.dpr);
+        const scale = options.scale ?? 1 / dpr;
+        const cssWidth = options.cssWidth ?? naturalWidth * scale;
+        const cssHeight = options.cssHeight ?? naturalHeight * scale;
+        target.width = Math.max(1, Math.ceil(cssWidth * dpr));
+        target.height = Math.max(1, Math.ceil(cssHeight * dpr));
+        if ("style" in target) {
+            target.style.width = `${cssWidth}px`;
+            target.style.height = `${cssHeight}px`;
+        }
+        const context = target.getContext("2d");
+        if (!context)
+            throw new ViewerError("render-failed", "Canvas 2D context is unavailable");
+        context.setTransform(dpr, 0, 0, dpr, 0, 0);
+        context.clearRect(0, 0, cssWidth, cssHeight);
+        context.drawImage(decoded.source, 0, 0, cssWidth, cssHeight);
+        return { width: naturalWidth, height: naturalHeight };
+    }
+    finally {
+        decoded.close();
+    }
+}
+async function decodeImage(blob) {
+    if (typeof createImageBitmap === "function") {
+        const bitmap = await createImageBitmap(blob, {
+            imageOrientation: "from-image",
+        });
+        return {
+            source: bitmap,
+            width: bitmap.width,
+            height: bitmap.height,
+            close: () => bitmap.close(),
+        };
+    }
+    if (typeof document === "undefined")
+        throw new ViewerError("render-failed", "No browser image decoder is available");
+    const url = URL.createObjectURL(blob);
+    try {
+        const image = new Image();
+        image.decoding = "async";
+        image.src = url;
+        await image.decode();
+        return {
+            source: image,
+            width: image.naturalWidth,
+            height: image.naturalHeight,
+            close: () => URL.revokeObjectURL(url),
+        };
+    }
+    catch (error) {
+        URL.revokeObjectURL(url);
+        throw new ViewerError("invalid-file", "Browser image decode failed", {
+            cause: error,
+        });
+    }
+}

package/dist/adapters/csv-parser.d.ts

@@ -0,0 +1,7 @@
+export interface ParsedDelimitedText {
+    readonly delimiter: string;
+    readonly encoding: string;
+    readonly rows: readonly (readonly string[])[];
+}
+export declare function parseDelimitedBytes(data: Uint8Array, format: "csv" | "tsv", maxCells?: number): ParsedDelimitedText;
+export declare function parseDelimitedText(text: string, delimiter: string, maxCells?: number): readonly (readonly string[])[];

package/dist/adapters/csv-parser.js

@@ -0,0 +1,124 @@
+import { ViewerError } from "../errors.js";
+export function parseDelimitedBytes(data, format, maxCells = 1_000_000) {
+    const decoded = decodeDelimitedBytes(data);
+    const delimiter = format === "tsv" ? "\t" : detectDelimiter(decoded.text, [",", "\t", ";"]);
+    return {
+        delimiter,
+        encoding: decoded.encoding,
+        rows: parseDelimitedText(decoded.text, delimiter, maxCells),
+    };
+}
+export function parseDelimitedText(text, delimiter, maxCells = 1_000_000) {
+    const rows = [];
+    let row = [];
+    let field = "";
+    let quoted = false;
+    let cells = 0;
+    const pushField = () => {
+        cells += 1;
+        if (cells > maxCells)
+            throw new ViewerError("resource-limit", "Delimited data exceeds cell limit", {
+                details: { maxCells },
+            });
+        row.push(field);
+        field = "";
+    };
+    const pushRow = () => {
+        pushField();
+        rows.push(row);
+        row = [];
+    };
+    for (let index = 0; index < text.length; index += 1) {
+        const character = text[index];
+        if (quoted) {
+            if (character === '"') {
+                if (text[index + 1] === '"') {
+                    field += '"';
+                    index += 1;
+                }
+                else
+                    quoted = false;
+            }
+            else
+                field += character;
+            continue;
+        }
+        if (character === '"' && field.length === 0)
+            quoted = true;
+        else if (character === delimiter)
+            pushField();
+        else if (character === "\n")
+            pushRow();
+        else if (character !== "\r")
+            field += character;
+    }
+    if (quoted)
+        throw new ViewerError("invalid-file", "Unterminated quoted field in delimited data");
+    if (field.length > 0 || row.length > 0)
+        pushRow();
+    return rows;
+}
+function decodeDelimitedBytes(data) {
+    if (data[0] === 0xef && data[1] === 0xbb && data[2] === 0xbf)
+        return {
+            text: new TextDecoder("utf-8", { fatal: true }).decode(data.subarray(3)),
+            encoding: "utf-8",
+        };
+    if (data[0] === 0xff && data[1] === 0xfe)
+        return {
+            text: new TextDecoder("utf-16le", { fatal: true }).decode(data.subarray(2)),
+            encoding: "utf-16le",
+        };
+    if (data[0] === 0xfe && data[1] === 0xff) {
+        const swapped = data.subarray(2).slice();
+        for (let index = 0; index + 1 < swapped.length; index += 2)
+            [swapped[index], swapped[index + 1]] = [
+                swapped[index + 1],
+                swapped[index],
+            ];
+        return {
+            text: new TextDecoder("utf-16le", { fatal: true }).decode(swapped),
+            encoding: "utf-16be",
+        };
+    }
+    try {
+        return {
+            text: new TextDecoder("utf-8", { fatal: true }).decode(data),
+            encoding: "utf-8",
+        };
+    }
+    catch {
+        return {
+            text: new TextDecoder("windows-1252").decode(data),
+            encoding: "windows-1252",
+        };
+    }
+}
+function detectDelimiter(text, candidates) {
+    const sample = text.slice(0, 64 * 1024);
+    let best = ",";
+    let bestScore = -1;
+    for (const candidate of candidates) {
+        let quoted = false;
+        let count = 0;
+        let lines = 0;
+        for (let index = 0; index < sample.length && lines < 20; index += 1) {
+            const character = sample[index];
+            if (character === '"') {
+                if (quoted && sample[index + 1] === '"')
+                    index += 1;
+                else
+                    quoted = !quoted;
+            }
+            else if (!quoted && character === candidate)
+                count += 1;
+            else if (!quoted && character === "\n")
+                lines += 1;
+        }
+        if (count > bestScore) {
+            best = candidate;
+            bestScore = count;
+        }
+    }
+    return best;
+}