@build-qube/papyra 0.4.0 → 0.5.0

package/dist/index.js

@@ -14,20 +14,11 @@
  * onScroll(() => job.setPriority(0));
  * ```
  */
-export { attachmentMediaType, isInvoiceAttachment, } from './attachments.js';
-export { paintToCanvas, toImageData } from './canvas.js';
-export { CellWindow, columnName } from './cells.js';
+export * from './core.js';
 export { Document, open } from './document.js';
-export { encode, encodedImage, mimeType, PageImage, svgPage, } from './encode.js';
-export { EncryptedWorkbookError, IncorrectPasswordError, PasswordError, PasswordRequiredError, } from './errors.js';
-export { buildOutlineTree, walkOutline } from './outline.js';
+export { encode, PageImage } from './encode.js';
+export { defaultPdfEngine, PapyraEngine } from './papyra-engine.js';
 export { backend, currentRuntime, hardwareConcurrency, init, } from './runtime.js';
-export { AbortError, DEFAULT_PRIORITY } from './scheduler.js';
-export { findRanges, searchPageText } from './search.js';
-export { buildStructTree, readingOrder, structuredPageString, walkStructTree, } from './structure.js';
-export { cssColor } from './styles.js';
-export { lineQuad, pageString, quadBounds, scaleQuad, scaleRect, } from './text.js';
 export { openTiff, TIFF_MAX_PIXELS, TiffImage } from './tiff.js';
-export { rotatePage, rotateSize, viewport, viewportQuad, viewportRect, } from './viewport.js';
 export { openWorkbook, Sheet, Workbook } from './workbook.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,EACL,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAazD,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAEpD,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAQ/C,OAAO,EACL,MAAM,EACN,YAAY,EACZ,QAAQ,EACR,SAAS,EACT,OAAO,GACR,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,sBAAsB,EACtB,sBAAsB,EACtB,aAAa,EACb,qBAAqB,GACtB,MAAM,aAAa,CAAC;AAOrB,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE7D,OAAO,EACL,OAAO,EACP,cAAc,EACd,mBAAmB,EACnB,IAAI,GACL,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAE9D,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAMzD,OAAO,EACL,eAAe,EACf,YAAY,EACZ,oBAAoB,EACpB,cAAc,GACf,MAAM,gBAAgB,CAAC;AAWxB,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEvC,OAAO,EACL,QAAQ,EACR,UAAU,EACV,UAAU,EACV,SAAS,EACT,SAAS,GACV,MAAM,WAAW,CAAC;AAMnB,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAcjE,OAAO,EACL,UAAU,EACV,UAAU,EACV,QAAQ,EACR,YAAY,EACZ,YAAY,GACb,MAAM,eAAe,CAAC;AASvB,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,cAAc,WAAW,CAAC;AAE1B,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEpE,OAAO,EACL,OAAO,EACP,cAAc,EACd,mBAAmB,EACnB,IAAI,GACL,MAAM,cAAc,CAAC;AAMtB,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AASjE,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC"}

package/dist/links.d.ts

@@ -48,6 +48,11 @@ export interface PageLink {
     /** The annotation's tooltip, when it has one. */
     readonly alt: string | null;
 }
-/** @internal */
+/**
+ * A link as the bindings report it, as a {@link PageLink}; null when it has no target.
+ *
+ * Exported for engines whose host answers in the native bindings' shapes, as
+ * `tauri-plugin-papyra` does, so they normalise exactly as papyra's own engine does.
+ */
 export declare function toPageLink(native: NativePageLink): PageLink | null;
 //# sourceMappingURL=links.d.ts.map

package/dist/links.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"links.d.ts","sourceRoot":"","sources":["../src/links.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,IAAI,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC5E,OAAO,EAAE,KAAK,kBAAkB,EAAiB,MAAM,cAAc,CAAC;AACtE,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEtC;;;;;;;;;;GAUG;AACH,MAAM,MAAM,UAAU,GAClB;IACE,kDAAkD;IAClD,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,sEAAsE;IACtE,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAC;CACnC,GACD;IACE;;;;;;OAMG;IACH,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IACrB,iDAAiD;IACjD,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB,CAAC;AAEN;;;;;;GAMG;AACH,MAAM,WAAW,QAAQ;IACvB;;;;OAIG;IACH,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,+DAA+D;IAC/D,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,iDAAiD;IACjD,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,gBAAgB;AAChB,wBAAgB,UAAU,CAAC,MAAM,EAAE,cAAc,GAAG,QAAQ,GAAG,IAAI,CAelE"}
+{"version":3,"file":"links.d.ts","sourceRoot":"","sources":["../src/links.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,IAAI,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC5E,OAAO,EAAE,KAAK,kBAAkB,EAAiB,MAAM,cAAc,CAAC;AACtE,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEtC;;;;;;;;;;GAUG;AACH,MAAM,MAAM,UAAU,GAClB;IACE,kDAAkD;IAClD,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,sEAAsE;IACtE,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAC;CACnC,GACD;IACE;;;;;;OAMG;IACH,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IACrB,iDAAiD;IACjD,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB,CAAC;AAEN;;;;;;GAMG;AACH,MAAM,WAAW,QAAQ;IACvB;;;;OAIG;IACH,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,+DAA+D;IAC/D,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,iDAAiD;IACjD,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,cAAc,GAAG,QAAQ,GAAG,IAAI,CAelE"}

package/dist/links.js

@@ -1,5 +1,10 @@
 import { toDestination } from './outline.js';
-/** @internal */
+/**
+ * A link as the bindings report it, as a {@link PageLink}; null when it has no target.
+ *
+ * Exported for engines whose host answers in the native bindings' shapes, as
+ * `tauri-plugin-papyra` does, so they normalise exactly as papyra's own engine does.
+ */
 export function toPageLink(native) {
     const target = linkTarget(native);
     // The bindings only emit a link with one target or the other, so this is

package/dist/links.js.map

@@ -1 +1 @@
-{"version":3,"file":"links.js","sourceRoot":"","sources":["../src/links.ts"],"names":[],"mappings":"AACA,OAAO,EAA2B,aAAa,EAAE,MAAM,cAAc,CAAC;AAsDtE,gBAAgB;AAChB,MAAM,UAAU,UAAU,CAAC,MAAsB;IAC/C,MAAM,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;IAClC,yEAAyE;IACzE,mFAAmF;IACnF,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IACzB,OAAO;QACL,IAAI,EAAE;YACJ,CAAC,EAAE,MAAM,CAAC,EAAE;YACZ,CAAC,EAAE,MAAM,CAAC,EAAE;YACZ,KAAK,EAAE,MAAM,CAAC,EAAE,GAAG,MAAM,CAAC,EAAE;YAC5B,MAAM,EAAE,MAAM,CAAC,EAAE,GAAG,MAAM,CAAC,EAAE;SAC9B;QACD,MAAM;QACN,GAAG,EAAE,MAAM,CAAC,GAAG,IAAI,IAAI;KACxB,CAAC;AACJ,CAAC;AAED,SAAS,UAAU,CAAC,MAAsB;IACxC,IAAI,MAAM,CAAC,GAAG,KAAK,SAAS;QAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,EAAE,CAAC;IACtE,MAAM,IAAI,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACxC,OAAO,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AAClD,CAAC"}
+{"version":3,"file":"links.js","sourceRoot":"","sources":["../src/links.ts"],"names":[],"mappings":"AACA,OAAO,EAA2B,aAAa,EAAE,MAAM,cAAc,CAAC;AAsDtE;;;;;GAKG;AACH,MAAM,UAAU,UAAU,CAAC,MAAsB;IAC/C,MAAM,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;IAClC,yEAAyE;IACzE,mFAAmF;IACnF,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IACzB,OAAO;QACL,IAAI,EAAE;YACJ,CAAC,EAAE,MAAM,CAAC,EAAE;YACZ,CAAC,EAAE,MAAM,CAAC,EAAE;YACZ,KAAK,EAAE,MAAM,CAAC,EAAE,GAAG,MAAM,CAAC,EAAE;YAC5B,MAAM,EAAE,MAAM,CAAC,EAAE,GAAG,MAAM,CAAC,EAAE;SAC9B;QACD,MAAM;QACN,GAAG,EAAE,MAAM,CAAC,GAAG,IAAI,IAAI;KACxB,CAAC;AACJ,CAAC;AAED,SAAS,UAAU,CAAC,MAAsB;IACxC,IAAI,MAAM,CAAC,GAAG,KAAK,SAAS;QAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,EAAE,CAAC;IACtE,MAAM,IAAI,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACxC,OAAO,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AAClD,CAAC"}

package/dist/office.d.ts

@@ -0,0 +1,85 @@
+import type { OfficeDocument as NativeOfficeDocument } from '@build-qube/papyra-office-native';
+import { type Availability, type BackendRenderOptions, type PagedBackend, type PagedDoc, PagedEngine } from './engine.js';
+import type { OpenOptions, PageSize, PdfSource, RenderedPage } from './types.js';
+/** What an office file is: a Word document, or a PowerPoint deck. */
+export type OfficeKind = 'word' | 'slides';
+/** An open Word document or PowerPoint deck. Get one from {@link PapyraOfficeEngine.open}. */
+export interface OfficeDoc extends PagedDoc {
+    /** `'word'` or `'slides'`. Pages in a document, slides in a deck — hidden ones too. */
+    readonly kind: OfficeKind;
+}
+/** The addon's document, as a {@link PagedBackend}. */
+declare class OfficeBackend implements PagedBackend {
+    #private;
+    readonly kind: OfficeKind;
+    readonly pageCount: number;
+    readonly capabilities: import("./engine.js").Capabilities;
+    readonly concurrency = 4;
+    constructor(native: NativeOfficeDocument);
+    /**
+     * Page size in points (1/72 inch). Every slide in a deck shares one size; a Word
+     * document's sections may each set their own.
+     */
+    pageSize(index: number): PageSize;
+    /** `annotations` does not apply: an office page has none to switch off. */
+    renderPage(index: number, { dpi }: BackendRenderOptions): Promise<RenderedPage>;
+    /**
+     * Free the laid-out document in the wasm heap now, not whenever the wrapper is
+     * collected: a deck's model can be large, and growing a shared heap while workers
+     * run is the trap the addon pre-grows its heap to avoid.
+     */
+    close(): void;
+}
+/**
+ * Word documents (`.docx`, `.docm`, `.dotx`, `.dotm`) and PowerPoint decks (`.pptx`,
+ * `.potx`, `.ppsx` and their macro-enabled twins), laid out and drawn by papyra in
+ * Rust over WordCraft and DeckCraft.
+ *
+ * A {@link PagedEngine}, so renders get the same priority queue, coalescing,
+ * byte-bounded cache and `fitWidth` sizing a PDF's do, and a page column written for
+ * PDFs shows these unchanged. Pages only: no text, links or outline.
+ *
+ * A file is recognised by its declared main part, not its name, so a renamed
+ * workbook or plain zip is refused. A Word document is paginated once, while
+ * opening. The office addon is its own wasm module — about 5.7 MB gzipped — fetched
+ * by the first open or font, so importing `/office` costs nothing until then.
+ *
+ * Experimental: the engines are young, and a real-world file may lay out differently
+ * from Office.
+ *
+ * @example
+ * ```ts
+ * await officeEngine.addFont(await (await fetch('/fonts/Carlito-Regular.ttf')).bytes());
+ * const doc = await officeEngine.open(file);
+ * paintToCanvas(await officeEngine.render(doc, 0, { fitWidth: 1200 }).promise, canvas);
+ * ```
+ */
+export declare class PapyraOfficeEngine extends PagedEngine<OfficeDoc, OfficeBackend> {
+    readonly id = "papyra-office";
+    /**
+     * Make a TrueType or OpenType font available to the Word and PowerPoint layout,
+     * for every document opened **after** this call.
+     *
+     * A document names fonts like Calibri that cannot be shipped, so each engine
+     * substitutes — and a substitute with different widths moves every line break after
+     * it. Carlito, Caladea and Liberation Sans/Serif are metric-compatible with Calibri,
+     * Cambria and Arial/Times New Roman, and both engines already prefer them by name. A
+     * browser has no system fonts at all, so without this, Word text falls back to
+     * Source Sans and slide text to Ubuntu Light.
+     *
+     * On the engine because fonts belong to whatever runs the layout: this wasm module
+     * here, a host process for another engine. Fetches the module if no document has
+     * yet. Resolves to how many faces were added: 0 when the bytes are not a font, or
+     * when every face in them was already registered.
+     */
+    addFont(source: PdfSource): Promise<number>;
+    availability(): Availability;
+    /** @internal Its backend type is private to this file, as is `handle`'s. */
+    protected load(source: PdfSource, _options: OpenOptions): Promise<OfficeBackend>;
+    /** @internal */
+    protected handle(backend: OfficeBackend): OfficeDoc;
+}
+/** The office engine, shared so every view opens into one queue per document. */
+export declare const officeEngine: PapyraOfficeEngine;
+export {};
+//# sourceMappingURL=office.d.ts.map

package/dist/office.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"office.d.ts","sourceRoot":"","sources":["../src/office.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,IAAI,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AAC/F,OAAO,EACL,KAAK,YAAY,EACjB,KAAK,oBAAoB,EACzB,KAAK,YAAY,EACjB,KAAK,QAAQ,EACb,WAAW,EAEZ,MAAM,aAAa,CAAC;AAErB,OAAO,KAAK,EACV,WAAW,EACX,QAAQ,EACR,SAAS,EACT,YAAY,EACb,MAAM,YAAY,CAAC;AAEpB,qEAAqE;AACrE,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,QAAQ,CAAC;AAE3C,8FAA8F;AAC9F,MAAM,WAAW,SAAU,SAAQ,QAAQ;IACzC,uFAAuF;IACvF,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;CAC3B;AAuBD,uDAAuD;AACvD,cAAM,aAAc,YAAW,YAAY;;IACzC,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,YAAY,qCAAe;IACpC,QAAQ,CAAC,WAAW,KAAe;IAGnC,YAAY,MAAM,EAAE,oBAAoB,EAIvC;IAED;;;OAGG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,CAEhC;IAED,2EAA2E;IAC3E,UAAU,CACR,KAAK,EAAE,MAAM,EACb,EAAE,GAAG,EAAE,EAAE,oBAAoB,GAC5B,OAAO,CAAC,YAAY,CAAC,CAEvB;IAED;;;;OAIG;IACH,KAAK,IAAI,IAAI,CAEZ;CACF;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBAAa,kBAAmB,SAAQ,WAAW,CAAC,SAAS,EAAE,aAAa,CAAC;IAC3E,QAAQ,CAAC,EAAE,mBAAmB;IAE9B;;;;;;;;;;;;;;;OAeG;IACG,OAAO,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,CAMhD;IAED,YAAY,IAAI,YAAY,CAY3B;IAED,4EAA4E;IAC5E,UAAgB,IAAI,CAClB,MAAM,EAAE,SAAS,EACjB,QAAQ,EAAE,WAAW,GACpB,OAAO,CAAC,aAAa,CAAC,CAMxB;IAED,gBAAgB;IAChB,SAAS,CAAC,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,SAAS,CAQlD;CACF;AAED,iFAAiF;AACjF,eAAO,MAAM,YAAY,EAAE,kBACe,CAAC"}

package/dist/office.js

@@ -0,0 +1,135 @@
+import { PagedEngine, RENDER_ONLY, } from './engine.js';
+import { toBytes } from './source.js';
+/**
+ * Renders in flight at once. napi-rs runs an addon's async work on a pool of four in
+ * the browser, so more only queues inside the glue, where priority cannot reach it.
+ */
+const CONCURRENCY = 4;
+/** The addon once loaded. Process-wide, like the addon itself. */
+let native;
+function loadNative() {
+    native ??= import('@build-qube/papyra-office-native').catch((e) => {
+        // A failed fetch of a 5.7 MB module is often transient: let the next open retry
+        // rather than leave office disabled until a reload.
+        native = undefined;
+        throw e;
+    });
+    return native;
+}
+/** The addon's document, as a {@link PagedBackend}. */
+class OfficeBackend {
+    kind;
+    pageCount;
+    capabilities = RENDER_ONLY;
+    concurrency = CONCURRENCY;
+    #native;
+    constructor(native) {
+        this.#native = native;
+        this.kind = native.kind;
+        this.pageCount = native.pageCount;
+    }
+    /**
+     * Page size in points (1/72 inch). Every slide in a deck shares one size; a Word
+     * document's sections may each set their own.
+     */
+    pageSize(index) {
+        return this.#native.pageSize(index);
+    }
+    /** `annotations` does not apply: an office page has none to switch off. */
+    renderPage(index, { dpi }) {
+        return this.#native.renderPage(index, dpi / 72);
+    }
+    /**
+     * Free the laid-out document in the wasm heap now, not whenever the wrapper is
+     * collected: a deck's model can be large, and growing a shared heap while workers
+     * run is the trap the addon pre-grows its heap to avoid.
+     */
+    close() {
+        this.#native.close();
+    }
+}
+/**
+ * Word documents (`.docx`, `.docm`, `.dotx`, `.dotm`) and PowerPoint decks (`.pptx`,
+ * `.potx`, `.ppsx` and their macro-enabled twins), laid out and drawn by papyra in
+ * Rust over WordCraft and DeckCraft.
+ *
+ * A {@link PagedEngine}, so renders get the same priority queue, coalescing,
+ * byte-bounded cache and `fitWidth` sizing a PDF's do, and a page column written for
+ * PDFs shows these unchanged. Pages only: no text, links or outline.
+ *
+ * A file is recognised by its declared main part, not its name, so a renamed
+ * workbook or plain zip is refused. A Word document is paginated once, while
+ * opening. The office addon is its own wasm module — about 5.7 MB gzipped — fetched
+ * by the first open or font, so importing `/office` costs nothing until then.
+ *
+ * Experimental: the engines are young, and a real-world file may lay out differently
+ * from Office.
+ *
+ * @example
+ * ```ts
+ * await officeEngine.addFont(await (await fetch('/fonts/Carlito-Regular.ttf')).bytes());
+ * const doc = await officeEngine.open(file);
+ * paintToCanvas(await officeEngine.render(doc, 0, { fitWidth: 1200 }).promise, canvas);
+ * ```
+ */
+export class PapyraOfficeEngine extends PagedEngine {
+    id = 'papyra-office';
+    /**
+     * Make a TrueType or OpenType font available to the Word and PowerPoint layout,
+     * for every document opened **after** this call.
+     *
+     * A document names fonts like Calibri that cannot be shipped, so each engine
+     * substitutes — and a substitute with different widths moves every line break after
+     * it. Carlito, Caladea and Liberation Sans/Serif are metric-compatible with Calibri,
+     * Cambria and Arial/Times New Roman, and both engines already prefer them by name. A
+     * browser has no system fonts at all, so without this, Word text falls back to
+     * Source Sans and slide text to Ubuntu Light.
+     *
+     * On the engine because fonts belong to whatever runs the layout: this wasm module
+     * here, a host process for another engine. Fetches the module if no document has
+     * yet. Resolves to how many faces were added: 0 when the bytes are not a font, or
+     * when every face in them was already registered.
+     */
+    async addFont(source) {
+        const [{ addFont }, bytes] = await Promise.all([
+            loadNative(),
+            toBytes(source),
+        ]);
+        return addFont(bytes);
+    }
+    availability() {
+        // `undefined` outside a browser (Node, Bun), where the native addon needs nothing.
+        if (globalThis.crossOriginIsolated !== false)
+            return { ok: true };
+        return {
+            ok: false,
+            title: 'This page is not cross-origin isolated',
+            reason: 'papyra renders Word and PowerPoint in WebAssembly with shared memory, ' +
+                'which needs SharedArrayBuffer. Serve this page with ' +
+                'Cross-Origin-Opener-Policy: same-origin and ' +
+                'Cross-Origin-Embedder-Policy: require-corp, then reload.',
+        };
+    }
+    /** @internal Its backend type is private to this file, as is `handle`'s. */
+    async load(source, _options) {
+        const [{ loadOffice }, bytes] = await Promise.all([
+            loadNative(),
+            toBytes(source),
+        ]);
+        return new OfficeBackend(await loadOffice(bytes));
+    }
+    /** @internal */
+    handle(backend) {
+        return {
+            engine: this.id,
+            kind: backend.kind,
+            pageCount: backend.pageCount,
+            pageSize: (index) => backend.pageSize(index),
+            capabilities: backend.capabilities,
+        };
+    }
+}
+/** The office engine, shared so every view opens into one queue per document. */
+export const officeEngine = 
+/* @__PURE__ */ new PapyraOfficeEngine();
+//# sourceMappingURL=office.js.map

package/dist/office.js.map

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

package/dist/papyra-engine.d.ts

@@ -0,0 +1,68 @@
+import type { PdfDocument as NativeDocument } from '@build-qube/papyra-native';
+import { type Attachment } from './attachments.js';
+import type { Document } from './document.js';
+import { type Availability, type BackendRenderOptions, type Capabilities, type PdfBackend, PdfEngine } from './engine.js';
+import { type PageLink } from './links.js';
+import { type OutlineNode } from './outline.js';
+import { type StructNode } from './structure.js';
+import { type PageText } from './text.js';
+import type { DocumentMetadata, OpenOptions, PageSize, PdfSource, RenderedPage } from './types.js';
+/**
+ * papyra's own engine: hayro, compiled into the native addon in Node and into wasm in
+ * a browser. Imported from `@build-qube/papyra/engine` (or the main entry), never from
+ * `/core`, so an app that never names it ships none of its wasm.
+ *
+ * Constructing one loads nothing. The addon — in a browser, a wasm module of about
+ * 2.5 MB — is fetched by the first {@link PagedEngine.open}, which is what lets a
+ * bundle that names this engine as a default still cost nothing until a PDF opens.
+ *
+ * In a browser it needs a cross-origin-isolated page: the wasm build uses shared
+ * memory, and so needs `SharedArrayBuffer`. {@link availability} says so.
+ */
+export declare class PapyraEngine extends PdfEngine {
+    readonly id = "papyra";
+    availability(): Availability;
+    /**
+     * Opens to a `Document`, which is a `PdfDoc` like any engine's handle and
+     * also carries papyra's extras — `renderImage`, `renderSvg`, `cache` — so code that
+     * knows it has papyra's engine can reach them with an `instanceof` check.
+     */
+    open(source: PdfSource, options?: OpenOptions): Promise<Document>;
+    protected load(source: PdfSource, options: OpenOptions): Promise<PdfBackend>;
+}
+/**
+ * The engine `open()` and `Document` go through, and the one a viewer falls back
+ * to when the app names none. Being one instance is the point: a document belongs to
+ * the engine that opened it, so a `Document` from `open()` and a viewer's default
+ * engine have to be the same object for the viewer's commands to accept it.
+ *
+ * Costs nothing until a document opens, like any {@link PapyraEngine}.
+ */
+export declare const defaultPdfEngine: PapyraEngine;
+/**
+ * The addon's document, as a {@link PdfBackend}. Every napi shape is normalised
+ * here, so nothing past this class sees one.
+ *
+ * @internal Exported for `Document`, whose export-only methods call the addon
+ * directly.
+ */
+export declare class PapyraBackend implements PdfBackend {
+    readonly native: NativeDocument;
+    readonly fingerprint: string;
+    readonly concurrency: number;
+    readonly capabilities: Capabilities;
+    constructor(native: NativeDocument, fingerprint: string, concurrency: number);
+    get pageCount(): number;
+    pageSize(index: number): PageSize;
+    renderPage(index: number, options: BackendRenderOptions): Promise<RenderedPage>;
+    metadata(): DocumentMetadata;
+    pdfVersion(): string | null;
+    pageText(index: number): Promise<PageText>;
+    outline(): Promise<OutlineNode[]>;
+    links(index: number): Promise<readonly PageLink[]>;
+    pageLabels(): Promise<readonly string[]>;
+    attachments(): Promise<readonly Attachment[]>;
+    attachmentData(index: number): Promise<Uint8Array>;
+    structTree(): Promise<StructNode[]>;
+}
+//# sourceMappingURL=papyra-engine.d.ts.map

package/dist/papyra-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"papyra-engine.d.ts","sourceRoot":"","sources":["../src/papyra-engine.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,IAAI,cAAc,EAE9B,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,KAAK,UAAU,EAAgB,MAAM,kBAAkB,CAAC;AACjE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EACL,KAAK,YAAY,EACjB,KAAK,oBAAoB,EACzB,KAAK,YAAY,EACjB,KAAK,UAAU,EACf,SAAS,EACV,MAAM,aAAa,CAAC;AAGrB,OAAO,EAAE,KAAK,QAAQ,EAAc,MAAM,YAAY,CAAC;AACvD,OAAO,EAAoB,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AAElE,OAAO,EAAmB,KAAK,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAClE,OAAO,EAAE,KAAK,QAAQ,EAAc,MAAM,WAAW,CAAC;AACtD,OAAO,KAAK,EACV,gBAAgB,EAChB,WAAW,EACX,QAAQ,EACR,SAAS,EACT,YAAY,EACb,MAAM,YAAY,CAAC;AAgDpB;;;;;;;;;;;GAWG;AACH,qBAAa,YAAa,SAAQ,SAAS;IACzC,QAAQ,CAAC,EAAE,YAAY;IAEvB,YAAY,IAAI,YAAY,CAY3B;IAED;;;;OAIG;IACY,IAAI,CACjB,MAAM,EAAE,SAAS,EACjB,OAAO,GAAE,WAAgB,GACxB,OAAO,CAAC,QAAQ,CAAC,CAKnB;IAED,UAAgB,IAAI,CAClB,MAAM,EAAE,SAAS,EACjB,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,UAAU,CAAC,CAmBrB;CACF;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,gBAAgB,EAAE,YACK,CAAC;AAErC;;;;;;GAMG;AACH,qBAAa,aAAc,YAAW,UAAU;IAI5C,QAAQ,CAAC,MAAM,EAAE,cAAc;IAC/B,QAAQ,CAAC,WAAW,EAAE,MAAM;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM;IAL9B,QAAQ,CAAC,YAAY,eAAc;IAEnC,YACW,MAAM,EAAE,cAAc,EACtB,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,EAC1B;IAEJ,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,CAEhC;IAED,UAAU,CACR,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,YAAY,CAAC,CAMvB;IAED,QAAQ,IAAI,gBAAgB,CAE3B;IAED,UAAU,IAAI,MAAM,GAAG,IAAI,CAE1B;IAEK,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAE/C;IAED,OAAO,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC,CAEhC;IAED,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,QAAQ,EAAE,CAAC,CAWjD;IAED,UAAU,IAAI,OAAO,CAAC,SAAS,MAAM,EAAE,CAAC,CAEvC;IAED,WAAW,IAAI,OAAO,CAAC,SAAS,UAAU,EAAE,CAAC,CAE5C;IAED,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAEjD;IAED,UAAU,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC,CAElC;CACF"}

package/dist/papyra-engine.js

@@ -0,0 +1,173 @@
+import { toAttachment } from './attachments.js';
+import { PdfEngine, } from './engine.js';
+import { rethrowLoadError } from './errors.js';
+import { fingerprint } from './fingerprint.js';
+import { toPageLink } from './links.js';
+import { buildOutlineTree } from './outline.js';
+import { toBytes } from './source.js';
+import { buildStructTree } from './structure.js';
+import { toPageText } from './text.js';
+const EVERYTHING = {
+    text: true,
+    outline: true,
+    links: true,
+    attachments: true,
+    structure: true,
+    pageLabels: true,
+    annotationsToggle: true,
+};
+/** napi omits absent strings rather than nulling them; normalise to one shape. */
+function toMetadata(info) {
+    return {
+        title: info.title ?? null,
+        author: info.author ?? null,
+        subject: info.subject ?? null,
+        keywords: info.keywords ?? null,
+        creator: info.creator ?? null,
+        producer: info.producer ?? null,
+        created: info.created ?? null,
+        modified: info.modified ?? null,
+    };
+}
+/** The addon once loaded. Process-wide, like the addon itself. */
+let addon;
+async function loadAddon() {
+    const [native, runtime, { Document }] = await Promise.all([
+        import('@build-qube/papyra-native'),
+        import('./runtime.js'),
+        // With the addon, not before: `Document`'s export methods call it directly.
+        import('./document.js'),
+    ]);
+    // Before any document loads: the wasm thread pool has to exist before rayon does.
+    runtime.init();
+    addon = { native, runtime, Document };
+    return addon;
+}
+/**
+ * papyra's own engine: hayro, compiled into the native addon in Node and into wasm in
+ * a browser. Imported from `@build-qube/papyra/engine` (or the main entry), never from
+ * `/core`, so an app that never names it ships none of its wasm.
+ *
+ * Constructing one loads nothing. The addon — in a browser, a wasm module of about
+ * 2.5 MB — is fetched by the first {@link PagedEngine.open}, which is what lets a
+ * bundle that names this engine as a default still cost nothing until a PDF opens.
+ *
+ * In a browser it needs a cross-origin-isolated page: the wasm build uses shared
+ * memory, and so needs `SharedArrayBuffer`. {@link availability} says so.
+ */
+export class PapyraEngine extends PdfEngine {
+    id = 'papyra';
+    availability() {
+        // `undefined` outside a browser (Node, Bun), where the native addon needs nothing.
+        if (globalThis.crossOriginIsolated !== false)
+            return { ok: true };
+        return {
+            ok: false,
+            title: 'This page is not cross-origin isolated',
+            reason: 'papyra renders in WebAssembly with shared memory, which needs ' +
+                'SharedArrayBuffer. Serve this page with ' +
+                'Cross-Origin-Opener-Policy: same-origin and ' +
+                'Cross-Origin-Embedder-Policy: require-corp, then reload.',
+        };
+    }
+    /**
+     * Opens to a `Document`, which is a `PdfDoc` like any engine's handle and
+     * also carries papyra's extras — `renderImage`, `renderSvg`, `cache` — so code that
+     * knows it has papyra's engine can reach them with an `instanceof` check.
+     */
+    async open(source, options = {}) {
+        const doc = await super.open(source, options);
+        // Loaded by now: `super.open` went through `load`.
+        const { Document } = addon ?? (await loadAddon());
+        return new Document(doc, this);
+    }
+    async load(source, options) {
+        // Only the first open waits on the import; after that `open` costs what it did
+        // before engines existed (measured: two `import()`s per open were +6µs).
+        const { native, runtime } = addon ?? (await loadAddon());
+        const bytes = await toBytes(source);
+        let inner;
+        try {
+            inner =
+                options.password === undefined
+                    ? native.PdfDocument.load(bytes)
+                    : native.PdfDocument.loadWithPassword(bytes, options.password);
+        }
+        catch (e) {
+            rethrowLoadError(e);
+        }
+        return new PapyraBackend(inner, fingerprint(bytes), runtime.defaultConcurrency());
+    }
+}
+/**
+ * The engine `open()` and `Document` go through, and the one a viewer falls back
+ * to when the app names none. Being one instance is the point: a document belongs to
+ * the engine that opened it, so a `Document` from `open()` and a viewer's default
+ * engine have to be the same object for the viewer's commands to accept it.
+ *
+ * Costs nothing until a document opens, like any {@link PapyraEngine}.
+ */
+export const defaultPdfEngine = 
+/* @__PURE__ */ new PapyraEngine();
+/**
+ * The addon's document, as a {@link PdfBackend}. Every napi shape is normalised
+ * here, so nothing past this class sees one.
+ *
+ * @internal Exported for `Document`, whose export-only methods call the addon
+ * directly.
+ */
+export class PapyraBackend {
+    native;
+    fingerprint;
+    concurrency;
+    capabilities = EVERYTHING;
+    constructor(native, fingerprint, concurrency) {
+        this.native = native;
+        this.fingerprint = fingerprint;
+        this.concurrency = concurrency;
+    }
+    get pageCount() {
+        return this.native.pageCount;
+    }
+    pageSize(index) {
+        return this.native.pageSize(index);
+    }
+    renderPage(index, options) {
+        return this.native.renderPageAsync(index, options.dpi, options.annotations);
+    }
+    metadata() {
+        return toMetadata(this.native.info());
+    }
+    pdfVersion() {
+        return this.native.pdfVersion ?? null;
+    }
+    async pageText(index) {
+        return toPageText(index, await this.native.pageTextAsync(index));
+    }
+    outline() {
+        return this.native.outline().then(buildOutlineTree);
+    }
+    links(index) {
+        // `toPageLink` only returns null for a link with no resolvable target, which the
+        // bindings do not emit — the filter is here so a future one cannot leak a null
+        // into the array.
+        return this.native
+            .pageLinks(index)
+            .then((native) => native
+            .map(toPageLink)
+            .filter((link) => link !== null));
+    }
+    pageLabels() {
+        return this.native.pageLabels();
+    }
+    attachments() {
+        return this.native.attachments().then((files) => files.map(toAttachment));
+    }
+    attachmentData(index) {
+        return this.native.attachmentData(index);
+    }
+    structTree() {
+        return this.native.structTree().then(buildStructTree);
+    }
+}
+//# sourceMappingURL=papyra-engine.js.map

package/dist/papyra-engine.js.map

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

package/dist/runtime.d.ts

@@ -30,4 +30,11 @@ export declare function backend(): string;
 export declare function init(options?: {
     threads?: number;
 }): void;
+/**
+ * Renders in flight at once when the caller does not say: the runtime's own
+ * concurrency natively, and {@link MAX_WASM_CONCURRENCY} on wasm.
+ *
+ * @internal
+ */
+export declare function defaultConcurrency(): number;
 //# sourceMappingURL=runtime.d.ts.map

package/dist/runtime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAMA;;;;;GAKG;AACH,MAAM,MAAM,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAC;AAExC;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,IAAI,CAAC;AAItC,0EAA0E;AAC1E,wBAAgB,mBAAmB,IAAI,MAAM,CAY5C;AAED,kDAAkD;AAClD,wBAAgB,cAAc,IAAI,OAAO,CAExC;AAED,2FAA2F;AAC3F,wBAAgB,OAAO,IAAI,MAAM,CAEhC;AAED;;;;;;;GAOG;AACH,wBAAgB,IAAI,CAAC,OAAO,GAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,IAAI,CAS7D"}
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAMA;;;;;GAKG;AACH,MAAM,MAAM,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAC;AAExC;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,IAAI,CAAC;AAItC,0EAA0E;AAC1E,wBAAgB,mBAAmB,IAAI,MAAM,CAY5C;AAED,kDAAkD;AAClD,wBAAgB,cAAc,IAAI,OAAO,CAExC;AAED,2FAA2F;AAC3F,wBAAgB,OAAO,IAAI,MAAM,CAEhC;AAED;;;;;;;GAOG;AACH,wBAAgB,IAAI,CAAC,OAAO,GAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,IAAI,CAS7D;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAI3C"}

package/dist/runtime.js

@@ -51,4 +51,15 @@ export function init(options = {}) {
         // Already built (another copy of the library got there first). Harmless.
     }
 }
+/**
+ * Renders in flight at once when the caller does not say: the runtime's own
+ * concurrency natively, and {@link MAX_WASM_CONCURRENCY} on wasm.
+ *
+ * @internal
+ */
+export function defaultConcurrency() {
+    return currentRuntime() === 'wasm'
+        ? MAX_WASM_CONCURRENCY
+        : hardwareConcurrency();
+}
 //# sourceMappingURL=runtime.js.map

package/dist/runtime.js.map

@@ -1 +1 @@
-{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,EACX,mBAAmB,EACnB,OAAO,GACR,MAAM,2BAA2B,CAAC;AAUnC;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC;AAEtC,IAAI,WAAW,GAAG,KAAK,CAAC;AAExB,0EAA0E;AAC1E,MAAM,UAAU,mBAAmB;IACjC,MAAM,GAAG,GAAI,UAA+D;SACzE,SAAS,CAAC;IACb,IAAI,OAAO,GAAG,EAAE,mBAAmB,KAAK,QAAQ,EAAE,CAAC;QACjD,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC,mBAAmB,CAAC,CAAC;IAC9C,CAAC;IACD,4EAA4E;IAC5E,kBAAkB;IAClB,MAAM,IAAI,GAAI,UAA6D;SACxE,OAAO,CAAC;IACX,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,EAAE,GAAG,EAAE,cAAc,CAAC,CAAC;IAClD,OAAO,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;AAC/D,CAAC;AAED,kDAAkD;AAClD,MAAM,UAAU,cAAc;IAC5B,OAAO,OAAO,EAAE,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC;AAClD,CAAC;AAED,2FAA2F;AAC3F,MAAM,UAAU,OAAO;IACrB,OAAO,WAAW,EAAE,CAAC;AACvB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,IAAI,CAAC,OAAO,GAAyB,EAAE;IACrD,IAAI,WAAW;QAAE,OAAO;IACxB,WAAW,GAAG,IAAI,CAAC;IACnB,IAAI,cAAc,EAAE,KAAK,MAAM;QAAE,OAAO;IACxC,IAAI,CAAC;QACH,mBAAmB,CAAC,OAAO,CAAC,OAAO,IAAI,mBAAmB,EAAE,EAAE,SAAS,CAAC,CAAC;IAC3E,CAAC;IAAC,MAAM,CAAC;QACP,yEAAyE;IAC3E,CAAC;AACH,CAAC"}
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,EACX,mBAAmB,EACnB,OAAO,GACR,MAAM,2BAA2B,CAAC;AAUnC;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC;AAEtC,IAAI,WAAW,GAAG,KAAK,CAAC;AAExB,0EAA0E;AAC1E,MAAM,UAAU,mBAAmB;IACjC,MAAM,GAAG,GAAI,UAA+D;SACzE,SAAS,CAAC;IACb,IAAI,OAAO,GAAG,EAAE,mBAAmB,KAAK,QAAQ,EAAE,CAAC;QACjD,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC,mBAAmB,CAAC,CAAC;IAC9C,CAAC;IACD,4EAA4E;IAC5E,kBAAkB;IAClB,MAAM,IAAI,GAAI,UAA6D;SACxE,OAAO,CAAC;IACX,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,EAAE,GAAG,EAAE,cAAc,CAAC,CAAC;IAClD,OAAO,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;AAC/D,CAAC;AAED,kDAAkD;AAClD,MAAM,UAAU,cAAc;IAC5B,OAAO,OAAO,EAAE,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC;AAClD,CAAC;AAED,2FAA2F;AAC3F,MAAM,UAAU,OAAO;IACrB,OAAO,WAAW,EAAE,CAAC;AACvB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,IAAI,CAAC,OAAO,GAAyB,EAAE;IACrD,IAAI,WAAW;QAAE,OAAO;IACxB,WAAW,GAAG,IAAI,CAAC;IACnB,IAAI,cAAc,EAAE,KAAK,MAAM;QAAE,OAAO;IACxC,IAAI,CAAC;QACH,mBAAmB,CAAC,OAAO,CAAC,OAAO,IAAI,mBAAmB,EAAE,EAAE,SAAS,CAAC,CAAC;IAC3E,CAAC;IAAC,MAAM,CAAC;QACP,yEAAyE;IAC3E,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB;IAChC,OAAO,cAAc,EAAE,KAAK,MAAM;QAChC,CAAC,CAAC,oBAAoB;QACtB,CAAC,CAAC,mBAAmB,EAAE,CAAC;AAC5B,CAAC"}

package/dist/scheduler.d.ts

@@ -17,7 +17,14 @@ export interface SchedulerJob<T> {
     /** Identity for coalescing. Two live requests with the same key share one render. */
     key: string;
     priority: number;
-    run: () => Promise<T>;
+    /** The work. `signal` aborts when an `abortable` job loses its last waiter. */
+    run: (signal?: AbortSignal) => Promise<T>;
+    /**
+     * Whether `run` stops early on its signal. Only then is a started job aborted when
+     * nobody waits on it any more; otherwise it runs to the end, and a new request for
+     * the same key joins it rather than starting a second.
+     */
+    abortable?: boolean;
 }
 /** Where a job's wall-clock time actually went. */
 export interface JobTiming {
@@ -44,7 +51,8 @@ export interface JobHandle<T> {
     readonly promise: Promise<T>;
     /**
      * Detach from this job. If nothing else is waiting on it and it has not started,
-     * it is dropped from the queue; if it is already running it is left to finish.
+     * it is dropped from the queue; if it is already running it is left to finish,
+     * unless it was submitted `abortable`, in which case its signal aborts.
      */
     cancel(reason?: string): void;
 }

package/dist/scheduler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scheduler.d.ts","sourceRoot":"","sources":["../src/scheduler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,6EAA6E;AAC7E,eAAO,MAAM,gBAAgB,IAAI,CAAC;AAElC,MAAM,WAAW,YAAY,CAAC,CAAC;IAC7B,qFAAqF;IACrF,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,CAAC;CACvB;AAED,mDAAmD;AACnD,MAAM,WAAW,SAAS;IACxB,mDAAmD;IACnD,MAAM,EAAE,MAAM,CAAC;IACf,iCAAiC;IACjC,KAAK,EAAE,MAAM,CAAC;CACf;AAED,qFAAqF;AACrF,MAAM,WAAW,SAAS,CAAC,CAAC;IAC1B,2EAA2E;IAC3E,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB;;;;;;OAMG;IACH,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAAC;IAClC,mFAAmF;IACnF,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,uFAAuF;IACvF,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IAC7B;;;OAGG;IACH,MAAM,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAkBD;;;;;GAKG;AACH,qBAAa,UAAW,SAAQ,KAAK;IACnC,6BAA6B;IAC7B,SAAkB,IAAI,gBAAgB;IACtC,YAAY,MAAM,SAAc,EAE/B;CACF;AAED,MAAM,WAAW,gBAAgB;IAC/B;;;;;;;;;;OAUG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED;;;;;;;GAOG;AACH,qBAAa,SAAS;;IAOpB,YAAY,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,gBAAqB,EAGxD;IAED,IAAI,YAAY,IAAI,MAAM,CAEzB;IAED,IAAI,YAAY,IAAI,MAAM,CAEzB;IASD,gEAAgE;IAChE,IAAI,YAAY,IAAI,MAAM,CAOzB;IAED,MAAM,CAAC,CAAC,EAAE,GAAG,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,CAkC5C;CAgFF"}
+{"version":3,"file":"scheduler.d.ts","sourceRoot":"","sources":["../src/scheduler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,6EAA6E;AAC7E,eAAO,MAAM,gBAAgB,IAAI,CAAC;AAElC,MAAM,WAAW,YAAY,CAAC,CAAC;IAC7B,qFAAqF;IACrF,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,+EAA+E;IAC/E,GAAG,EAAE,CAAC,MAAM,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;IAC1C;;;;OAIG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,mDAAmD;AACnD,MAAM,WAAW,SAAS;IACxB,mDAAmD;IACnD,MAAM,EAAE,MAAM,CAAC;IACf,iCAAiC;IACjC,KAAK,EAAE,MAAM,CAAC;CACf;AAED,qFAAqF;AACrF,MAAM,WAAW,SAAS,CAAC,CAAC;IAC1B,2EAA2E;IAC3E,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB;;;;;;OAMG;IACH,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAAC;IAClC,mFAAmF;IACnF,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,uFAAuF;IACvF,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IAC7B;;;;OAIG;IACH,MAAM,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAqBD;;;;;GAKG;AACH,qBAAa,UAAW,SAAQ,KAAK;IACnC,6BAA6B;IAC7B,SAAkB,IAAI,gBAAgB;IACtC,YAAY,MAAM,SAAc,EAE/B;CACF;AAED,MAAM,WAAW,gBAAgB;IAC/B;;;;;;;;;;OAUG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED;;;;;;;GAOG;AACH,qBAAa,SAAS;;IAapB,YAAY,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,gBAAqB,EAGxD;IAED,IAAI,YAAY,IAAI,MAAM,CAEzB;IAED,IAAI,YAAY,IAAI,MAAM,CAEzB;IASD,gEAAgE;IAChE,IAAI,YAAY,IAAI,MAAM,CAOzB;IAED,MAAM,CAAC,CAAC,EAAE,GAAG,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,CAoC5C;CAwFF"}