@computationalpathologygroup/openslide-js 1.0.0-beta.2

package/dist/esm/index.js

@@ -0,0 +1,19 @@
+// Core classes
+export { OpenSlide } from './openslide.js';
+export { Slide } from './slide.js';
+export { DeepZoomGenerator } from './deep-zoom.js';
+// Errors
+export { OpenSlideError, OpenSlideUnsupportedFormatError } from './errors.js';
+// Property name constants (matching OpenSlide C library)
+export const PROPERTY_NAME_COMMENT = 'openslide.comment';
+export const PROPERTY_NAME_VENDOR = 'openslide.vendor';
+export const PROPERTY_NAME_QUICKHASH1 = 'openslide.quickhash-1';
+export const PROPERTY_NAME_BACKGROUND_COLOR = 'openslide.background-color';
+export const PROPERTY_NAME_OBJECTIVE_POWER = 'openslide.objective-power';
+export const PROPERTY_NAME_MPP_X = 'openslide.mpp-x';
+export const PROPERTY_NAME_MPP_Y = 'openslide.mpp-y';
+export const PROPERTY_NAME_BOUNDS_X = 'openslide.bounds-x';
+export const PROPERTY_NAME_BOUNDS_Y = 'openslide.bounds-y';
+export const PROPERTY_NAME_BOUNDS_WIDTH = 'openslide.bounds-width';
+export const PROPERTY_NAME_BOUNDS_HEIGHT = 'openslide.bounds-height';
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,eAAe;AACf,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAGnD,SAAS;AACT,OAAO,EAAE,cAAc,EAAE,+BAA+B,EAAE,MAAM,aAAa,CAAC;AAY9E,yDAAyD;AACzD,MAAM,CAAC,MAAM,qBAAqB,GAAG,mBAAmB,CAAC;AACzD,MAAM,CAAC,MAAM,oBAAoB,GAAG,kBAAkB,CAAC;AACvD,MAAM,CAAC,MAAM,wBAAwB,GAAG,uBAAuB,CAAC;AAChE,MAAM,CAAC,MAAM,8BAA8B,GAAG,4BAA4B,CAAC;AAC3E,MAAM,CAAC,MAAM,6BAA6B,GAAG,2BAA2B,CAAC;AACzE,MAAM,CAAC,MAAM,mBAAmB,GAAG,iBAAiB,CAAC;AACrD,MAAM,CAAC,MAAM,mBAAmB,GAAG,iBAAiB,CAAC;AACrD,MAAM,CAAC,MAAM,sBAAsB,GAAG,oBAAoB,CAAC;AAC3D,MAAM,CAAC,MAAM,sBAAsB,GAAG,oBAAoB,CAAC;AAC3D,MAAM,CAAC,MAAM,0BAA0B,GAAG,wBAAwB,CAAC;AACnE,MAAM,CAAC,MAAM,2BAA2B,GAAG,yBAAyB,CAAC"}

package/dist/esm/openslide.d.ts

@@ -0,0 +1,47 @@
+/**
+ * openslide.ts
+ *
+ * Main entry point for the library. Manages a pool of Web Workers,
+ * each running an independent WASM instance. Distributes work
+ * across workers for parallel tile reads.
+ */
+import type { OpenSlideOptions, SlideSource } from './types.js';
+import { Slide } from './slide.js';
+export declare class OpenSlide {
+    private workers;
+    private nextId;
+    private terminated;
+    private constructor();
+    /**
+     * Create and initialize an OpenSlide instance with a worker pool.
+     *
+     * @param options.workerCount - Number of workers (default: hardwareConcurrency or 4).
+     * @param options.wasmUrl - Custom URL to the WASM module JS loader.
+     */
+    static initialize(options?: OpenSlideOptions): Promise<OpenSlide>;
+    /**
+     * Open a whole-slide image.
+     *
+     * Accepts:
+     * - A single File (dropped or from file input)
+     * - An array of Files (for multi-file formats like MIRAX)
+     * - An array of VirtualFile objects (files with relative paths)
+     * - A URL object or string URL (fetched via HTTP range requests)
+     */
+    open(source: SlideSource): Promise<Slide>;
+    /**
+     * Detect the vendor of a slide file without fully opening it.
+     * Returns the vendor string (e.g., "aperio", "hamamatsu") or null.
+     */
+    detectVendor(source: SlideSource): Promise<string | null>;
+    /** Get the OpenSlide library version string. */
+    getVersion(): Promise<string>;
+    /** Terminate all workers. The instance cannot be used after this. */
+    terminate(): void;
+    private leastBusy;
+    private sendTo;
+    private createSendFn;
+    private generateMountId;
+    private ensureAlive;
+}
+//# sourceMappingURL=openslide.d.ts.map

package/dist/esm/openslide.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openslide.d.ts","sourceRoot":"","sources":["../../src/openslide.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACV,gBAAgB,EAChB,WAAW,EAIZ,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAcnC,qBAAa,SAAS;IACpB,OAAO,CAAC,OAAO,CAAuB;IACtC,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,UAAU,CAAS;IAE3B,OAAO;IAEP;;;;;OAKG;WACU,UAAU,CAAC,OAAO,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,SAAS,CAAC;IAmDvE;;;;;;;;OAQG;IACG,IAAI,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC;IAyC/C;;;OAGG;IACG,YAAY,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAsB/D,gDAAgD;IAC1C,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC;IAKnC,qEAAqE;IACrE,SAAS,IAAI,IAAI;IAcjB,OAAO,CAAC,SAAS;IAWjB,OAAO,CAAC,MAAM;IASd,OAAO,CAAC,YAAY;IAIpB,OAAO,CAAC,eAAe;IAIvB,OAAO,CAAC,WAAW;CAKpB"}

package/dist/esm/openslide.js

@@ -0,0 +1,187 @@
+/**
+ * openslide.ts
+ *
+ * Main entry point for the library. Manages a pool of Web Workers,
+ * each running an independent WASM instance. Distributes work
+ * across workers for parallel tile reads.
+ */
+import { OpenSlideError } from './errors.js';
+import { Slide } from './slide.js';
+export class OpenSlide {
+    workers = [];
+    nextId = 1;
+    terminated = false;
+    constructor() { }
+    /**
+     * Create and initialize an OpenSlide instance with a worker pool.
+     *
+     * @param options.workerCount - Number of workers (default: hardwareConcurrency or 4).
+     * @param options.wasmUrl - Custom URL to the WASM module JS loader.
+     */
+    static async initialize(options) {
+        const instance = new OpenSlide();
+        const count = options?.workerCount ?? (typeof navigator !== 'undefined' ? navigator.hardwareConcurrency : 4) ?? 4;
+        let workerUrl;
+        if (options?.workerUrl) {
+            workerUrl = new URL(options.workerUrl);
+        }
+        else {
+            // @ts-ignore - import.meta.url is valid in ESM; CJS users must pass workerUrl
+            workerUrl = new URL('./worker.js', import.meta.url);
+        }
+        const initPromises = [];
+        for (let i = 0; i < count; i++) {
+            const worker = new Worker(workerUrl, { type: 'module' });
+            const managed = { worker, pending: new Map(), activeTasks: 0 };
+            worker.onmessage = (e) => {
+                const resp = e.data;
+                const req = managed.pending.get(resp.id);
+                if (!req)
+                    return;
+                managed.pending.delete(resp.id);
+                managed.activeTasks--;
+                if (resp.ok) {
+                    req.resolve(resp.result);
+                }
+                else {
+                    req.reject(new OpenSlideError(resp.error));
+                }
+            };
+            worker.onerror = (e) => {
+                // Reject all pending requests on this worker
+                for (const [, req] of managed.pending) {
+                    req.reject(new OpenSlideError(`Worker error: ${e.message}`));
+                }
+                managed.pending.clear();
+                managed.activeTasks = 0;
+            };
+            instance.workers.push(managed);
+            initPromises.push(instance.sendTo(managed, { cmd: 'init', wasmUrl: options?.wasmUrl }));
+        }
+        await Promise.all(initPromises);
+        return instance;
+    }
+    /**
+     * Open a whole-slide image.
+     *
+     * Accepts:
+     * - A single File (dropped or from file input)
+     * - An array of Files (for multi-file formats like MIRAX)
+     * - An array of VirtualFile objects (files with relative paths)
+     * - A URL object or string URL (fetched via HTTP range requests)
+     */
+    async open(source) {
+        this.ensureAlive();
+        const worker = this.leastBusy();
+        const send = this.createSendFn(worker);
+        const mountId = this.generateMountId();
+        let slidePath;
+        if (typeof source === 'string') {
+            slidePath = await send({ cmd: 'mountUrl', url: source, mountId });
+        }
+        else if (source instanceof URL) {
+            slidePath = await send({ cmd: 'mountUrl', url: source.href, mountId });
+        }
+        else if (source instanceof File) {
+            slidePath = await send({ cmd: 'mountFile', files: [source], mountId });
+        }
+        else if (Array.isArray(source)) {
+            if (source.length > 0 && 'file' in source[0]) {
+                // VirtualFile[] — multi-file format with directory structure
+                const entries = source;
+                // Find the index file (the .mrxs, .vms, etc.)
+                const indexEntry = entries.find(e => !e.path.includes('/')) ?? entries[0];
+                slidePath = await send({ cmd: 'mountDir', entries, indexFile: indexEntry.path, mountId });
+            }
+            else {
+                // File[] — flat list of files
+                slidePath = await send({ cmd: 'mountFile', files: source, mountId });
+            }
+        }
+        else {
+            throw new OpenSlideError('Invalid slide source');
+        }
+        const handle = await send({ cmd: 'open', mountId: slidePath });
+        const info = await send({ cmd: 'getSlideInfo', handle });
+        // Reconstruct the Map from the serialized data (postMessage turns Map into plain object)
+        const props = info.properties instanceof Map
+            ? info.properties
+            : new Map(Object.entries(info.properties));
+        const normalizedInfo = { ...info, properties: props };
+        return new Slide(send, handle, mountId, normalizedInfo);
+    }
+    /**
+     * Detect the vendor of a slide file without fully opening it.
+     * Returns the vendor string (e.g., "aperio", "hamamatsu") or null.
+     */
+    async detectVendor(source) {
+        this.ensureAlive();
+        const worker = this.leastBusy();
+        const send = this.createSendFn(worker);
+        const mountId = this.generateMountId();
+        let slidePath;
+        if (typeof source === 'string') {
+            slidePath = await send({ cmd: 'mountUrl', url: source, mountId });
+        }
+        else if (source instanceof URL) {
+            slidePath = await send({ cmd: 'mountUrl', url: source.href, mountId });
+        }
+        else if (source instanceof File) {
+            slidePath = await send({ cmd: 'mountFile', files: [source], mountId });
+        }
+        else {
+            throw new OpenSlideError('detectVendor requires a single file or URL');
+        }
+        const vendor = await send({ cmd: 'detectVendor', mountId: slidePath });
+        await send({ cmd: 'unmount', mountId });
+        return vendor;
+    }
+    /** Get the OpenSlide library version string. */
+    async getVersion() {
+        this.ensureAlive();
+        return await this.sendTo(this.workers[0], { cmd: 'getVersion' });
+    }
+    /** Terminate all workers. The instance cannot be used after this. */
+    terminate() {
+        this.terminated = true;
+        for (const { worker, pending } of this.workers) {
+            for (const [, req] of pending) {
+                req.reject(new OpenSlideError('OpenSlide terminated'));
+            }
+            pending.clear();
+            worker.terminate();
+        }
+        this.workers = [];
+    }
+    // --- Internal ---
+    leastBusy() {
+        let best = this.workers[0];
+        for (let i = 1; i < this.workers.length; i++) {
+            if (this.workers[i].activeTasks < best.activeTasks) {
+                best = this.workers[i];
+            }
+        }
+        return best;
+    }
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    sendTo(managed, cmd) {
+        const id = this.nextId++;
+        return new Promise((resolve, reject) => {
+            managed.pending.set(id, { resolve, reject });
+            managed.activeTasks++;
+            managed.worker.postMessage({ ...cmd, id });
+        });
+    }
+    createSendFn(managed) {
+        return (cmd) => this.sendTo(managed, cmd);
+    }
+    generateMountId() {
+        return `m${Date.now()}_${Math.random().toString(36).slice(2, 8)}`;
+    }
+    ensureAlive() {
+        if (this.terminated) {
+            throw new OpenSlideError('OpenSlide has been terminated');
+        }
+    }
+}
+//# sourceMappingURL=openslide.js.map

package/dist/esm/openslide.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openslide.js","sourceRoot":"","sources":["../../src/openslide.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AASH,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAcnC,MAAM,OAAO,SAAS;IACZ,OAAO,GAAoB,EAAE,CAAC;IAC9B,MAAM,GAAG,CAAC,CAAC;IACX,UAAU,GAAG,KAAK,CAAC;IAE3B,gBAAuB,CAAC;IAExB;;;;;OAKG;IACH,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,OAA0B;QAChD,MAAM,QAAQ,GAAG,IAAI,SAAS,EAAE,CAAC;QACjC,MAAM,KAAK,GAAG,OAAO,EAAE,WAAW,IAAI,CACpC,OAAO,SAAS,KAAK,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,CACrE,IAAI,CAAC,CAAC;QAEP,IAAI,SAAc,CAAC;QACnB,IAAI,OAAO,EAAE,SAAS,EAAE,CAAC;YACvB,SAAS,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QACzC,CAAC;aAAM,CAAC;YACN,8EAA8E;YAC9E,SAAS,GAAG,IAAI,GAAG,CAAC,aAAa,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACtD,CAAC;QAED,MAAM,YAAY,GAAoB,EAAE,CAAC;QACzC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC;YAC/B,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;YACzD,MAAM,OAAO,GAAkB,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,GAAG,EAAE,EAAE,WAAW,EAAE,CAAC,EAAE,CAAC;YAE9E,MAAM,CAAC,SAAS,GAAG,CAAC,CAA+B,EAAE,EAAE;gBACrD,MAAM,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC;gBACpB,MAAM,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;gBACzC,IAAI,CAAC,GAAG;oBAAE,OAAO;gBACjB,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;gBAChC,OAAO,CAAC,WAAW,EAAE,CAAC;gBACtB,IAAI,IAAI,CAAC,EAAE,EAAE,CAAC;oBACZ,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;gBAC3B,CAAC;qBAAM,CAAC;oBACN,GAAG,CAAC,MAAM,CAAC,IAAI,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;gBAC7C,CAAC;YACH,CAAC,CAAC;YAEF,MAAM,CAAC,OAAO,GAAG,CAAC,CAAC,EAAE,EAAE;gBACrB,6CAA6C;gBAC7C,KAAK,MAAM,CAAC,EAAE,GAAG,CAAC,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;oBACtC,GAAG,CAAC,MAAM,CAAC,IAAI,cAAc,CAAC,iBAAiB,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;gBAC/D,CAAC;gBACD,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;gBACxB,OAAO,CAAC,WAAW,GAAG,CAAC,CAAC;YAC1B,CAAC,CAAC;YAEF,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAC/B,YAAY,CAAC,IAAI,CACf,QAAQ,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,CAAsC,CAC1G,CAAC;QACJ,CAAC;QAED,MAAM,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;QAChC,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,IAAI,CAAC,MAAmB;QAC5B,IAAI,CAAC,WAAW,EAAE,CAAC;QACnB,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;QAChC,MAAM,IAAI,GAAG,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;QACvC,MAAM,OAAO,GAAG,IAAI,CAAC,eAAe,EAAE,CAAC;QAEvC,IAAI,SAAiB,CAAC;QAEtB,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;YAC/B,SAAS,GAAG,MAAM,IAAI,CAAC,EAAE,GAAG,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,CAAW,CAAC;QAC9E,CAAC;aAAM,IAAI,MAAM,YAAY,GAAG,EAAE,CAAC;YACjC,SAAS,GAAG,MAAM,IAAI,CAAC,EAAE,GAAG,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,CAAC,IAAI,EAAE,OAAO,EAAE,CAAW,CAAC;QACnF,CAAC;aAAM,IAAI,MAAM,YAAY,IAAI,EAAE,CAAC;YAClC,SAAS,GAAG,MAAM,IAAI,CAAC,EAAE,GAAG,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAW,CAAC;QACnF,CAAC;aAAM,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YACjC,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,IAAI,MAAM,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC7C,6DAA6D;gBAC7D,MAAM,OAAO,GAAG,MAAuB,CAAC;gBACxC,8CAA8C;gBAC9C,MAAM,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC,CAAC,CAAC;gBAC1E,SAAS,GAAG,MAAM,IAAI,CAAC,EAAE,GAAG,EAAE,UAAU,EAAE,OAAO,EAAE,SAAS,EAAE,UAAU,CAAC,IAAI,EAAE,OAAO,EAAE,CAAW,CAAC;YACtG,CAAC;iBAAM,CAAC;gBACN,8BAA8B;gBAC9B,SAAS,GAAG,MAAM,IAAI,CAAC,EAAE,GAAG,EAAE,WAAW,EAAE,KAAK,EAAE,MAAgB,EAAE,OAAO,EAAE,CAAW,CAAC;YAC3F,CAAC;QACH,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,cAAc,CAAC,sBAAsB,CAAC,CAAC;QACnD,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,CAAW,CAAC;QACzE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,EAAE,GAAG,EAAE,cAAc,EAAE,MAAM,EAAE,CAAc,CAAC;QAEtE,yFAAyF;QACzF,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,YAAY,GAAG;YAC1C,CAAC,CAAC,IAAI,CAAC,UAAU;YACjB,CAAC,CAAC,IAAI,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,UAA+C,CAAC,CAAC,CAAC;QAClF,MAAM,cAAc,GAAc,EAAE,GAAG,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC;QAEjE,OAAO,IAAI,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,CAAC,CAAC;IAC1D,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,YAAY,CAAC,MAAmB;QACpC,IAAI,CAAC,WAAW,EAAE,CAAC;QACnB,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;QAChC,MAAM,IAAI,GAAG,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;QACvC,MAAM,OAAO,GAAG,IAAI,CAAC,eAAe,EAAE,CAAC;QAEvC,IAAI,SAAiB,CAAC;QACtB,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;YAC/B,SAAS,GAAG,MAAM,IAAI,CAAC,EAAE,GAAG,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,CAAW,CAAC;QAC9E,CAAC;aAAM,IAAI,MAAM,YAAY,GAAG,EAAE,CAAC;YACjC,SAAS,GAAG,MAAM,IAAI,CAAC,EAAE,GAAG,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,CAAC,IAAI,EAAE,OAAO,EAAE,CAAW,CAAC;QACnF,CAAC;aAAM,IAAI,MAAM,YAAY,IAAI,EAAE,CAAC;YAClC,SAAS,GAAG,MAAM,IAAI,CAAC,EAAE,GAAG,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAW,CAAC;QACnF,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,cAAc,CAAC,4CAA4C,CAAC,CAAC;QACzE,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,EAAE,GAAG,EAAE,cAAc,EAAE,OAAO,EAAE,SAAS,EAAE,CAAkB,CAAC;QACxF,MAAM,IAAI,CAAC,EAAE,GAAG,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,CAAC;QACxC,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,gDAAgD;IAChD,KAAK,CAAC,UAAU;QACd,IAAI,CAAC,WAAW,EAAE,CAAC;QACnB,OAAO,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,GAAG,EAAE,YAAY,EAAE,CAAW,CAAC;IAC7E,CAAC;IAED,qEAAqE;IACrE,SAAS;QACP,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;QACvB,KAAK,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YAC/C,KAAK,MAAM,CAAC,EAAE,GAAG,CAAC,IAAI,OAAO,EAAE,CAAC;gBAC9B,GAAG,CAAC,MAAM,CAAC,IAAI,cAAc,CAAC,sBAAsB,CAAC,CAAC,CAAC;YACzD,CAAC;YACD,OAAO,CAAC,KAAK,EAAE,CAAC;YAChB,MAAM,CAAC,SAAS,EAAE,CAAC;QACrB,CAAC;QACD,IAAI,CAAC,OAAO,GAAG,EAAE,CAAC;IACpB,CAAC;IAED,mBAAmB;IAEX,SAAS;QACf,IAAI,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QAC3B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAC7C,IAAI,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;gBACnD,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;YACzB,CAAC;QACH,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,8DAA8D;IACtD,MAAM,CAAC,OAAsB,EAAE,GAAwB;QAC7D,MAAM,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;QACzB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;YAC7C,OAAO,CAAC,WAAW,EAAE,CAAC;YACtB,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE,GAAG,GAAG,EAAE,EAAE,EAAE,CAAC,CAAC;QAC7C,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,YAAY,CAAC,OAAsB;QACzC,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IAC5C,CAAC;IAEO,eAAe;QACrB,OAAO,IAAI,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;IACpE,CAAC;IAEO,WAAW;QACjB,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACpB,MAAM,IAAI,cAAc,CAAC,+BAA+B,CAAC,CAAC;QAC5D,CAAC;IACH,CAAC;CACF"}

package/dist/esm/slide.d.ts

@@ -0,0 +1,70 @@
+/**
+ * slide.ts
+ *
+ * Represents an opened whole-slide image. Created by OpenSlide.open().
+ * Metadata properties are synchronous (eagerly loaded), while pixel
+ * operations are async (delegated to a worker).
+ */
+import type { Dimensions, SlideInfo } from './types.js';
+/** Function type for sending a command to a worker and awaiting the response. */
+export type SendCommand = (cmd: Record<string, any>) => Promise<unknown>;
+export declare class Slide {
+    /** @internal */ private _send;
+    /** @internal */ private _handle;
+    /** @internal */ private _mountId;
+    /** @internal */ private _info;
+    /** @internal */ private _closed;
+    /** @internal */
+    constructor(send: SendCommand, handle: number, mountId: string, info: SlideInfo);
+    /** Number of pyramid levels in the slide. */
+    get levelCount(): number;
+    /** Dimensions of level 0 (full resolution). */
+    get dimensions(): Dimensions;
+    /** Dimensions of each pyramid level. */
+    get levelDimensions(): readonly Dimensions[];
+    /** Downsample factor for each pyramid level. */
+    get levelDownsamples(): readonly number[];
+    /** Slide metadata properties (vendor, MPP, objective power, etc.). */
+    get properties(): ReadonlyMap<string, string>;
+    /** Names of associated images (e.g., "label", "thumbnail", "macro"). */
+    get associatedImageNames(): readonly string[];
+    /**
+     * Find the best pyramid level for a given downsample factor.
+     * Returns the level index whose downsample is closest to (but not
+     * exceeding) the requested factor.
+     */
+    getBestLevelForDownsample(downsample: number): number;
+    /**
+     * Read a region of pixel data from the slide.
+     *
+     * @param x - Top-left x coordinate in level-0 reference frame.
+     * @param y - Top-left y coordinate in level-0 reference frame.
+     * @param level - Pyramid level to read from.
+     * @param width - Width in pixels at the target level.
+     * @param height - Height in pixels at the target level.
+     * @returns ImageData containing RGBA pixel data.
+     */
+    readRegion(x: number, y: number, level: number, width: number, height: number): Promise<ImageData>;
+    /**
+     * Read an associated image (e.g., slide label or macro image).
+     *
+     * @param name - Name of the associated image.
+     * @returns ImageData containing RGBA pixel data.
+     */
+    readAssociatedImage(name: string): Promise<ImageData>;
+    /**
+     * Get the dimensions of an associated image.
+     */
+    getAssociatedImageDimensions(name: string): Promise<Dimensions>;
+    /**
+     * Read the ICC color profile embedded in the slide, if any.
+     * @returns Raw ICC profile bytes, or null if none.
+     */
+    getIccProfile(): Promise<ArrayBuffer | null>;
+    /** Close the slide and release WASM resources. */
+    close(): Promise<void>;
+    /** Support for `await using slide = ...` (explicit resource management). */
+    [Symbol.asyncDispose](): Promise<void>;
+    private ensureOpen;
+}
+//# sourceMappingURL=slide.d.ts.map

package/dist/esm/slide.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slide.d.ts","sourceRoot":"","sources":["../../src/slide.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAGxD,iFAAiF;AAEjF,MAAM,MAAM,WAAW,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;AAEzE,qBAAa,KAAK;IAChB,gBAAgB,CAAC,OAAO,CAAC,KAAK,CAAc;IAC5C,gBAAgB,CAAC,OAAO,CAAC,OAAO,CAAS;IACzC,gBAAgB,CAAC,OAAO,CAAC,QAAQ,CAAS;IAC1C,gBAAgB,CAAC,OAAO,CAAC,KAAK,CAAY;IAC1C,gBAAgB,CAAC,OAAO,CAAC,OAAO,CAAS;IAEzC,gBAAgB;gBACJ,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS;IAO/E,6CAA6C;IAC7C,IAAI,UAAU,IAAI,MAAM,CAEvB;IAED,+CAA+C;IAC/C,IAAI,UAAU,IAAI,UAAU,CAE3B;IAED,wCAAwC;IACxC,IAAI,eAAe,IAAI,SAAS,UAAU,EAAE,CAE3C;IAED,gDAAgD;IAChD,IAAI,gBAAgB,IAAI,SAAS,MAAM,EAAE,CAExC;IAED,sEAAsE;IACtE,IAAI,UAAU,IAAI,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAE5C;IAED,wEAAwE;IACxE,IAAI,oBAAoB,IAAI,SAAS,MAAM,EAAE,CAE5C;IAED;;;;OAIG;IACH,yBAAyB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM;IAOrD;;;;;;;;;OASG;IACG,UAAU,CACd,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,SAAS,CAAC;IAarB;;;;;OAKG;IACG,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IAY3D;;OAEG;IACG,4BAA4B,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IASrE;;;OAGG;IACG,aAAa,IAAI,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAQlD,kDAAkD;IAC5C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAO5B,4EAA4E;IACtE,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5C,OAAO,CAAC,UAAU;CAKnB"}

package/dist/esm/slide.js

@@ -0,0 +1,135 @@
+/**
+ * slide.ts
+ *
+ * Represents an opened whole-slide image. Created by OpenSlide.open().
+ * Metadata properties are synchronous (eagerly loaded), while pixel
+ * operations are async (delegated to a worker).
+ */
+import { OpenSlideError } from './errors.js';
+export class Slide {
+    /** @internal */ _send;
+    /** @internal */ _handle;
+    /** @internal */ _mountId;
+    /** @internal */ _info;
+    /** @internal */ _closed = false;
+    /** @internal */
+    constructor(send, handle, mountId, info) {
+        this._send = send;
+        this._handle = handle;
+        this._mountId = mountId;
+        this._info = info;
+    }
+    /** Number of pyramid levels in the slide. */
+    get levelCount() {
+        return this._info.levelCount;
+    }
+    /** Dimensions of level 0 (full resolution). */
+    get dimensions() {
+        return this._info.levelDimensions[0];
+    }
+    /** Dimensions of each pyramid level. */
+    get levelDimensions() {
+        return this._info.levelDimensions;
+    }
+    /** Downsample factor for each pyramid level. */
+    get levelDownsamples() {
+        return this._info.levelDownsamples;
+    }
+    /** Slide metadata properties (vendor, MPP, objective power, etc.). */
+    get properties() {
+        return this._info.properties;
+    }
+    /** Names of associated images (e.g., "label", "thumbnail", "macro"). */
+    get associatedImageNames() {
+        return this._info.associatedImageNames;
+    }
+    /**
+     * Find the best pyramid level for a given downsample factor.
+     * Returns the level index whose downsample is closest to (but not
+     * exceeding) the requested factor.
+     */
+    getBestLevelForDownsample(downsample) {
+        for (let i = this._info.levelDownsamples.length - 1; i >= 0; i--) {
+            if (this._info.levelDownsamples[i] <= downsample)
+                return i;
+        }
+        return 0;
+    }
+    /**
+     * Read a region of pixel data from the slide.
+     *
+     * @param x - Top-left x coordinate in level-0 reference frame.
+     * @param y - Top-left y coordinate in level-0 reference frame.
+     * @param level - Pyramid level to read from.
+     * @param width - Width in pixels at the target level.
+     * @param height - Height in pixels at the target level.
+     * @returns ImageData containing RGBA pixel data.
+     */
+    async readRegion(x, y, level, width, height) {
+        this.ensureOpen();
+        const buffer = await this._send({
+            cmd: 'readRegion',
+            handle: this._handle,
+            x, y, level,
+            w: width, h: height,
+        });
+        const data = new Uint8ClampedArray(buffer);
+        return new ImageData(data, width, height);
+    }
+    /**
+     * Read an associated image (e.g., slide label or macro image).
+     *
+     * @param name - Name of the associated image.
+     * @returns ImageData containing RGBA pixel data.
+     */
+    async readAssociatedImage(name) {
+        this.ensureOpen();
+        const result = await this._send({
+            cmd: 'readAssociatedImage',
+            handle: this._handle,
+            name,
+        });
+        const data = new Uint8ClampedArray(result.buffer);
+        return new ImageData(data, result.width, result.height);
+    }
+    /**
+     * Get the dimensions of an associated image.
+     */
+    async getAssociatedImageDimensions(name) {
+        this.ensureOpen();
+        return await this._send({
+            cmd: 'getAssociatedImageDimensions',
+            handle: this._handle,
+            name,
+        });
+    }
+    /**
+     * Read the ICC color profile embedded in the slide, if any.
+     * @returns Raw ICC profile bytes, or null if none.
+     */
+    async getIccProfile() {
+        this.ensureOpen();
+        return await this._send({
+            cmd: 'getIccProfile',
+            handle: this._handle,
+        });
+    }
+    /** Close the slide and release WASM resources. */
+    async close() {
+        if (this._closed)
+            return;
+        this._closed = true;
+        await this._send({ cmd: 'close', handle: this._handle });
+        await this._send({ cmd: 'unmount', mountId: this._mountId });
+    }
+    /** Support for `await using slide = ...` (explicit resource management). */
+    async [Symbol.asyncDispose]() {
+        await this.close();
+    }
+    ensureOpen() {
+        if (this._closed) {
+            throw new OpenSlideError('Slide has been closed');
+        }
+    }
+}
+//# sourceMappingURL=slide.js.map

package/dist/esm/slide.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slide.js","sourceRoot":"","sources":["../../src/slide.ts"],"names":[],"mappings":"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"}

package/dist/esm/types.d.ts

@@ -0,0 +1,150 @@
+/** Width and height in pixels. */
+export interface Dimensions {
+    readonly width: number;
+    readonly height: number;
+}
+/** Complete metadata returned when a slide is opened. */
+export interface SlideInfo {
+    readonly levelCount: number;
+    readonly levelDimensions: readonly Dimensions[];
+    readonly levelDownsamples: readonly number[];
+    readonly properties: ReadonlyMap<string, string>;
+    readonly associatedImageNames: readonly string[];
+}
+/** Deep Zoom Image descriptor info. */
+export interface DziInfo {
+    readonly tileSize: number;
+    readonly overlap: number;
+    readonly format: string;
+    readonly width: number;
+    readonly height: number;
+}
+/** Options for OpenSlide.initialize(). */
+export interface OpenSlideOptions {
+    /** Number of Web Workers to spawn (default: navigator.hardwareConcurrency or 4). */
+    workerCount?: number;
+    /** Custom URL to the WASM module loader JS file. */
+    wasmUrl?: string;
+    /** Custom URL to the worker JS file (required for CJS/non-ESM environments). */
+    workerUrl?: string;
+}
+/** Source that can be opened as a slide. */
+export type SlideSource = File | File[] | VirtualFile[] | URL | string;
+/** A file with a relative path, used for multi-file formats (MIRAX, VMS, DICOM). */
+export interface VirtualFile {
+    readonly path: string;
+    readonly file: File;
+}
+/**
+ * Messages sent from the main thread to a worker.
+ * Each command has a unique `id` so responses can be matched.
+ */
+export type WorkerCommand = {
+    id: number;
+    cmd: 'init';
+    wasmUrl?: string;
+} | {
+    id: number;
+    cmd: 'open';
+    mountId: string;
+} | {
+    id: number;
+    cmd: 'close';
+    handle: number;
+} | {
+    id: number;
+    cmd: 'getSlideInfo';
+    handle: number;
+} | {
+    id: number;
+    cmd: 'readRegion';
+    handle: number;
+    x: number;
+    y: number;
+    level: number;
+    w: number;
+    h: number;
+} | {
+    id: number;
+    cmd: 'readAssociatedImage';
+    handle: number;
+    name: string;
+} | {
+    id: number;
+    cmd: 'getAssociatedImageDimensions';
+    handle: number;
+    name: string;
+} | {
+    id: number;
+    cmd: 'detectVendor';
+    mountId: string;
+} | {
+    id: number;
+    cmd: 'getVersion';
+} | {
+    id: number;
+    cmd: 'getIccProfile';
+    handle: number;
+} | {
+    id: number;
+    cmd: 'mountFile';
+    files: File[];
+    mountId: string;
+} | {
+    id: number;
+    cmd: 'mountDir';
+    entries: VirtualFile[];
+    indexFile: string;
+    mountId: string;
+} | {
+    id: number;
+    cmd: 'mountUrl';
+    url: string;
+    mountId: string;
+} | {
+    id: number;
+    cmd: 'unmount';
+    mountId: string;
+};
+/** Messages sent from a worker back to the main thread. */
+export type WorkerResponse = {
+    id: number;
+    ok: true;
+    result: unknown;
+} | {
+    id: number;
+    ok: false;
+    error: string;
+};
+/**
+ * Emscripten module shape we expect after createOpenSlideModule() resolves.
+ * Only the parts we use are typed here.
+ */
+export interface OpenSlideWasmModule {
+    cwrap: (name: string, returnType: string | null, argTypes: string[], opts?: {
+        async?: boolean;
+    }) => (...args: unknown[]) => unknown;
+    UTF8ToString: (ptr: number) => string;
+    HEAPU8: Uint8Array;
+    HEAP32: Int32Array;
+    HEAP64: BigInt64Array;
+    _malloc: (size: number) => number;
+    _free: (ptr: number) => void;
+    FS: EmscriptenFS;
+    MEMFS: unknown;
+    WORKERFS: unknown;
+}
+export interface EmscriptenFS {
+    mkdir: (path: string) => void;
+    rmdir: (path: string) => void;
+    unlink: (path: string) => void;
+    mount: (type: unknown, opts: Record<string, unknown>, mountpoint: string) => unknown;
+    unmount: (mountpoint: string) => void;
+    readdir: (path: string) => string[];
+    readFile: (path: string, opts?: {
+        encoding?: string;
+    }) => Uint8Array;
+    writeFile: (path: string, data: Uint8Array) => void;
+    createLazyFile: (parent: string, name: string, url: string, canRead: boolean, canWrite: boolean) => unknown;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/esm/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA,kCAAkC;AAClC,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,yDAAyD;AACzD,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,eAAe,EAAE,SAAS,UAAU,EAAE,CAAC;IAChD,QAAQ,CAAC,gBAAgB,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7C,QAAQ,CAAC,UAAU,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjD,QAAQ,CAAC,oBAAoB,EAAE,SAAS,MAAM,EAAE,CAAC;CAClD;AAED,uCAAuC;AACvC,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,0CAA0C;AAC1C,MAAM,WAAW,gBAAgB;IAC/B,oFAAoF;IACpF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oDAAoD;IACpD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gFAAgF;IAChF,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,4CAA4C;AAC5C,MAAM,MAAM,WAAW,GAAG,IAAI,GAAG,IAAI,EAAE,GAAG,WAAW,EAAE,GAAG,GAAG,GAAG,MAAM,CAAC;AAEvE,oFAAoF;AACpF,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;CACrB;AAED;;;GAGG;AACH,MAAM,MAAM,aAAa,GACrB;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GAC7C;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAC5C;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAC5C;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,cAAc,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACnD;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,YAAY,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,GAC5G;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,qBAAqB,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACxE;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,8BAA8B,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACjF;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,cAAc,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACpD;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,YAAY,CAAA;CAAE,GACjC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,eAAe,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACpD;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,WAAW,CAAC;IAAC,KAAK,EAAE,IAAI,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAChE;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,UAAU,CAAC;IAAC,OAAO,EAAE,WAAW,EAAE,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAC3F;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,UAAU,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAC7D;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAEpD,2DAA2D;AAC3D,MAAM,MAAM,cAAc,GACtB;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,GACzC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAE7C;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,KAAK,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC;IACpI,YAAY,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAAC;IACtC,MAAM,EAAE,UAAU,CAAC;IACnB,MAAM,EAAE,UAAU,CAAC;IACnB,MAAM,EAAE,aAAa,CAAC;IACtB,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;IAClC,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7B,EAAE,EAAE,YAAY,CAAC;IACjB,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9B,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9B,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B,KAAK,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC;IACrF,OAAO,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,IAAI,CAAC;IACtC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,EAAE,CAAC;IACpC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,UAAU,CAAC;IACrE,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,KAAK,IAAI,CAAC;IACpD,cAAc,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,KAAK,OAAO,CAAC;CAC7G"}

package/dist/esm/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/esm/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":""}