@build-qube/papyra 0.0.4 → 0.2.0

package/dist/outline.d.ts

@@ -0,0 +1,72 @@
+import type { OutlineDestination as NativeDestination, OutlineEntry as NativeEntry } from '@build-qube/papyra-native';
+/** How a destination positions the page in the window (PDF 32000-1, 12.3.2.2). */
+export type DestinationKind = 'XYZ' | 'Fit' | 'FitH' | 'FitV' | 'FitR' | 'FitB' | 'FitBH' | 'FitBV';
+/**
+ * Where an outline entry points.
+ *
+ * Coordinates are PDF points measured from the page's bottom-left corner — the same
+ * space as {@link PageSize} — so converting to rendered pixels is
+ * `(pt / 72) * dpi`. `null` means "leave this axis as it is", which is how the spec
+ * spells a destination that scrolls vertically but not horizontally.
+ */
+export interface OutlineDestination {
+    /** 0-based page index. */
+    readonly page: number;
+    /** Which of the eight positioning modes the destination uses. */
+    readonly kind: DestinationKind;
+    /** Left edge, for `'XYZ'`, `'FitV'`, `'FitBV'` and `'FitR'`. */
+    readonly left: number | null;
+    /** Top edge, for `'XYZ'`, `'FitH'`, `'FitBH'` and `'FitR'`. */
+    readonly top: number | null;
+    /** Right edge. Only ever set for `'FitR'`. */
+    readonly right: number | null;
+    /** Bottom edge. Only ever set for `'FitR'`. */
+    readonly bottom: number | null;
+    /** Only ever set for `'XYZ'`. A zoom of 0 means "unchanged" and reads as `null`. */
+    readonly zoom: number | null;
+}
+/** A node in the document outline. */
+export interface OutlineNode {
+    /** The entry's label, already decoded from UTF-16, UTF-8 or PDFDocEncoding. */
+    readonly title: string;
+    /**
+     * `null` for a container that groups children without pointing anywhere itself, and
+     * for entries whose action leaves this document (a URL, or another file).
+     */
+    readonly dest: OutlineDestination | null;
+    /** `dest.page`, hoisted — the only field most viewers need. */
+    readonly page: number | null;
+    /** The document asks for this title to be drawn bold. */
+    readonly bold: boolean;
+    /** The document asks for this title to be drawn italic. */
+    readonly italic: boolean;
+    /** The document asks for this node to start expanded. */
+    readonly open: boolean;
+    /** Nested entries, empty for a leaf. */
+    readonly children: OutlineNode[];
+}
+/**
+ * napi omits absent numbers rather than nulling them; normalise to one shape.
+ *
+ * Shared with the link reader, whose targets resolve to the same destinations.
+ *
+ * @internal
+ */
+export declare function toDestination(dest: NativeDestination | undefined): OutlineDestination | null;
+/**
+ * Rebuild the tree from the flat pre-order list the bindings return.
+ *
+ * A stack indexed by level is enough because pre-order guarantees a node's parent is
+ * the most recent node one level shallower. Levels that skip a step cannot come from
+ * our own walker, but are clamped rather than trusted — a malformed document should
+ * produce a flatter outline, not a crash.
+ */
+export declare function buildOutlineTree(entries: readonly NativeEntry[]): OutlineNode[];
+/** Walk an outline depth-first, yielding each node with its depth. */
+export declare function walkOutline(nodes: readonly OutlineNode[], depth?: number): Generator<{
+    /** The entry. */
+    node: OutlineNode;
+    /** How deep it sits, 0 for a root. Useful as an indent. */
+    depth: number;
+}>;
+//# sourceMappingURL=outline.d.ts.map

package/dist/outline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"outline.d.ts","sourceRoot":"","sources":["../src/outline.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,kBAAkB,IAAI,iBAAiB,EACvC,YAAY,IAAI,WAAW,EAC5B,MAAM,2BAA2B,CAAC;AAEnC,kFAAkF;AAClF,MAAM,MAAM,eAAe,GACvB,KAAK,GACL,KAAK,GACL,MAAM,GACN,MAAM,GACN,MAAM,GACN,MAAM,GACN,OAAO,GACP,OAAO,CAAC;AAEZ;;;;;;;GAOG;AACH,MAAM,WAAW,kBAAkB;IACjC,0BAA0B;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,iEAAiE;IACjE,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAC/B,gEAAgE;IAChE,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,+DAA+D;IAC/D,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,8CAA8C;IAC9C,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,+CAA+C;IAC/C,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,oFAAoF;IACpF,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED,sCAAsC;AACtC,MAAM,WAAW,WAAW;IAC1B,+EAA+E;IAC/E,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,QAAQ,CAAC,IAAI,EAAE,kBAAkB,GAAG,IAAI,CAAC;IACzC,+DAA+D;IAC/D,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,yDAAyD;IACzD,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,2DAA2D;IAC3D,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,yDAAyD;IACzD,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,wCAAwC;IACxC,QAAQ,CAAC,QAAQ,EAAE,WAAW,EAAE,CAAC;CAClC;AAaD;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,iBAAiB,GAAG,SAAS,GAClC,kBAAkB,GAAG,IAAI,CAa3B;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,SAAS,WAAW,EAAE,GAC9B,WAAW,EAAE,CAyBf;AAED,sEAAsE;AACtE,wBAAiB,WAAW,CAC1B,KAAK,EAAE,SAAS,WAAW,EAAE,EAC7B,KAAK,SAAI,GACR,SAAS,CAAC;IACX,iBAAiB;IACjB,IAAI,EAAE,WAAW,CAAC;IAClB,2DAA2D;IAC3D,KAAK,EAAE,MAAM,CAAC;CACf,CAAC,CAKD"}

package/dist/outline.js

@@ -0,0 +1,73 @@
+const KINDS = new Set([
+    'XYZ',
+    'Fit',
+    'FitH',
+    'FitV',
+    'FitR',
+    'FitB',
+    'FitBH',
+    'FitBV',
+]);
+/**
+ * napi omits absent numbers rather than nulling them; normalise to one shape.
+ *
+ * Shared with the link reader, whose targets resolve to the same destinations.
+ *
+ * @internal
+ */
+export function toDestination(dest) {
+    if (!dest)
+        return null;
+    return {
+        page: dest.page,
+        // Unknown view kinds are read as `Fit` in Rust, so this only guards against a
+        // binding and a wrapper that have drifted apart.
+        kind: (KINDS.has(dest.kind) ? dest.kind : 'Fit'),
+        left: dest.left ?? null,
+        top: dest.top ?? null,
+        right: dest.right ?? null,
+        bottom: dest.bottom ?? null,
+        zoom: dest.zoom ?? null,
+    };
+}
+/**
+ * Rebuild the tree from the flat pre-order list the bindings return.
+ *
+ * A stack indexed by level is enough because pre-order guarantees a node's parent is
+ * the most recent node one level shallower. Levels that skip a step cannot come from
+ * our own walker, but are clamped rather than trusted — a malformed document should
+ * produce a flatter outline, not a crash.
+ */
+export function buildOutlineTree(entries) {
+    const roots = [];
+    const stack = [];
+    for (const entry of entries) {
+        const dest = toDestination(entry.dest);
+        const node = {
+            title: entry.title,
+            dest,
+            page: dest?.page ?? null,
+            bold: entry.bold,
+            italic: entry.italic,
+            open: entry.open,
+            children: [],
+        };
+        const level = Math.min(entry.level, stack.length);
+        stack.length = level;
+        const parent = stack[level - 1];
+        if (parent)
+            parent.children.push(node);
+        else
+            roots.push(node);
+        stack.push(node);
+    }
+    return roots;
+}
+/** Walk an outline depth-first, yielding each node with its depth. */
+export function* walkOutline(nodes, depth = 0) {
+    for (const node of nodes) {
+        yield { node, depth };
+        yield* walkOutline(node.children, depth + 1);
+    }
+}
+//# sourceMappingURL=outline.js.map

package/dist/outline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"outline.js","sourceRoot":"","sources":["../src/outline.ts"],"names":[],"mappings":"AA8DA,MAAM,KAAK,GAAG,IAAI,GAAG,CAAS;IAC5B,KAAK;IACL,KAAK;IACL,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,OAAO;IACP,OAAO;CACR,CAAC,CAAC;AAEH;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAC3B,IAAmC;IAEnC,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IACvB,OAAO;QACL,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,8EAA8E;QAC9E,iDAAiD;QACjD,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAoB;QACnE,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,IAAI;QACvB,GAAG,EAAE,IAAI,CAAC,GAAG,IAAI,IAAI;QACrB,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,IAAI;QACzB,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,IAAI;QAC3B,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,IAAI;KACxB,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,gBAAgB,CAC9B,OAA+B;IAE/B,MAAM,KAAK,GAAkB,EAAE,CAAC;IAChC,MAAM,KAAK,GAAkB,EAAE,CAAC;IAEhC,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,IAAI,GAAG,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACvC,MAAM,IAAI,GAAgB;YACxB,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,IAAI;YACJ,IAAI,EAAE,IAAI,EAAE,IAAI,IAAI,IAAI;YACxB,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,QAAQ,EAAE,EAAE;SACb,CAAC;QAEF,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;QAClD,KAAK,CAAC,MAAM,GAAG,KAAK,CAAC;QACrB,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;QAChC,IAAI,MAAM;YAAE,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;;YAClC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACtB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACnB,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,sEAAsE;AACtE,MAAM,SAAS,CAAC,CAAC,WAAW,CAC1B,KAA6B,EAC7B,KAAK,GAAG,CAAC;IAOT,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;QACtB,KAAK,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;IAC/C,CAAC;AACH,CAAC"}

package/dist/runtime.d.ts

@@ -1,3 +1,9 @@
+/**
+ * Which build is loaded: the native addon, or wasm in a browser.
+ *
+ * Worth branching on only for concurrency and memory. The rendering API is identical
+ * on both, which is the point of the library.
+ */
 export type Runtime = 'native' | 'wasm';
 /**
  * Useful concurrency ceiling on wasm.
@@ -9,7 +15,9 @@ export type Runtime = 'native' | 'wasm';
 export declare const MAX_WASM_CONCURRENCY = 4;
 /** Best guess at how many renders this host can genuinely run at once. */
 export declare function hardwareConcurrency(): number;
+/** Which build is loaded. See {@link Runtime}. */
 export declare function currentRuntime(): Runtime;
+/** The rendering engine and version behind this build, for diagnostics and bug reports. */
 export declare function backend(): string;
 /**
  * Prepare the rendering thread pool. Idempotent, and called automatically by

package/dist/runtime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAMA,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,wBAAgB,cAAc,IAAI,OAAO,CAExC;AAED,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"}

package/dist/runtime.js

@@ -22,9 +22,11 @@ export function hardwareConcurrency() {
     const fromEnv = Number(proc?.env?.PAPYRA_THREADS);
     return Number.isFinite(fromEnv) && fromEnv > 0 ? fromEnv : 4;
 }
+/** Which build is loaded. See {@link Runtime}. */
 export function currentRuntime() {
     return runtime() === 'wasm' ? 'wasm' : 'native';
 }
+/** The rendering engine and version behind this build, for diagnostics and bug reports. */
 export function backend() {
     return backendName();
 }

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;AAInC;;;;;;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,MAAM,UAAU,cAAc;IAC5B,OAAO,OAAO,EAAE,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC;AAClD,CAAC;AAED,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"}

package/dist/scheduler.d.ts

@@ -26,7 +26,9 @@ export interface JobTiming {
     /** Started until it finished. */
     runMs: number;
 }
+/** A submitted job: its result, its timings, and the two ways to change its fate. */
 export interface JobHandle<T> {
+    /** The coalescing key. Two live requests sharing one render share this. */
     readonly key: string;
     /**
      * Populated once the job settles, `null` before that.
@@ -38,6 +40,7 @@ export interface JobHandle<T> {
     readonly timing: JobTiming | null;
     /** Reassign urgency while the job is still pending. A no-op once it is running. */
     setPriority(priority: number): void;
+    /** Resolves with the result, or rejects with {@link AbortError} if cancelled first. */
     readonly promise: Promise<T>;
     /**
      * Detach from this job. If nothing else is waiting on it and it has not started,
@@ -45,7 +48,14 @@ export interface JobHandle<T> {
      */
     cancel(reason?: string): void;
 }
+/**
+ * Rejection reason for a job dropped before it started.
+ *
+ * Named `'AbortError'` to match `DOMException`, so existing `err.name === 'AbortError'`
+ * checks keep working across the two runtimes without a papyra-specific branch.
+ */
 export declare class AbortError extends Error {
+    /** Always `'AbortError'`. */
     readonly name = "AbortError";
     constructor(reason?: string);
 }
@@ -63,13 +73,21 @@ export interface SchedulerOptions {
      */
     yieldToUrgent?: boolean;
 }
-export declare class Scheduler<T> {
+/**
+ * One queue for every kind of work a document does.
+ *
+ * Deliberately not parameterised by payload: renders and text extraction compete for
+ * the same cores, so they have to share a queue for priority to mean anything. Entries
+ * are stored opaquely and `submit` recovers the type — sound because coalescing is by
+ * key, and two jobs with the same key are by construction the same job.
+ */
+export declare class Scheduler {
     #private;
     constructor(limit: number, options?: SchedulerOptions);
     get pendingCount(): number;
     get runningCount(): number;
     /** How long the longest-waiting pending job has been queued. */
     get oldestWaitMs(): number;
-    submit(job: SchedulerJob<T>): JobHandle<T>;
+    submit<T>(job: SchedulerJob<T>): JobHandle<T>;
 }
 //# sourceMappingURL=scheduler.d.ts.map

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,MAAM,WAAW,SAAS,CAAC,CAAC;IAC1B,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,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IAC7B;;;OAGG;IACH,MAAM,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAkBD,qBAAa,UAAW,SAAQ,KAAK;IACnC,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,qBAAa,SAAS,CAAC,CAAC;;IAOtB,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,GAAG,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,CAkCzC;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,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"}

package/dist/scheduler.js

@@ -13,12 +13,27 @@
  */
 /** Runs first. Lower is more urgent; the default is the most urgent tier. */
 export const DEFAULT_PRIORITY = 0;
+/**
+ * Rejection reason for a job dropped before it started.
+ *
+ * Named `'AbortError'` to match `DOMException`, so existing `err.name === 'AbortError'`
+ * checks keep working across the two runtimes without a papyra-specific branch.
+ */
 export class AbortError extends Error {
+    /** Always `'AbortError'`. */
     name = 'AbortError';
     constructor(reason = 'cancelled') {
         super(reason);
     }
 }
+/**
+ * One queue for every kind of work a document does.
+ *
+ * Deliberately not parameterised by payload: renders and text extraction compete for
+ * the same cores, so they have to share a queue for priority to mean anything. Entries
+ * are stored opaquely and `submit` recovers the type — sound because coalescing is by
+ * key, and two jobs with the same key are by construction the same job.
+ */
 export class Scheduler {
     #limit;
     #yieldToUrgent;

package/dist/scheduler.js.map

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

package/dist/search.d.ts

@@ -0,0 +1,50 @@
+import { type PageText, type Quad, type Rect } from './text.js';
+/** How loosely a query is allowed to match. Shared by {@link findRanges} and search. */
+export interface MatchOptions {
+    /** Default `false`. */
+    caseSensitive?: boolean;
+    /**
+     * Treat `e` and `é` as the same letter. Default `true`.
+     *
+     * Users type what is on their keyboard, and a document written in French or German
+     * is otherwise unsearchable to most of them.
+     */
+    ignoreDiacritics?: boolean;
+    /** Require the match to start and end at a word boundary. Default `false`. */
+    wholeWords?: boolean;
+}
+/** One occurrence of the query on a page. */
+export interface SearchMatch {
+    /** 0-based index of the page the hit is on. */
+    readonly page: number;
+    /** The matched text exactly as the document writes it. */
+    readonly text: string;
+    /** Surrounding text, for showing the hit in a results list. */
+    readonly context: string;
+    /** Where the match sits inside {@link context}. */
+    readonly contextStart: number;
+    /** End of the match inside {@link context}, exclusive. */
+    readonly contextEnd: number;
+    /**
+     * One quadrilateral per line the match covers — more than one when a phrase runs
+     * over a line break. Coordinates are 72-DPI page space; see {@link PageText}.
+     */
+    readonly quads: readonly Quad[];
+    /** {@link quads}, as upright bounding boxes. */
+    readonly rects: readonly Rect[];
+}
+/**
+ * Where the query occurs in a page's text, as `[start, end)` in the *source* string.
+ *
+ * Exported for testing and for callers that hold their own page text.
+ */
+export declare function findRanges(source: string, query: string, options?: MatchOptions): Array<[number, number]>;
+/**
+ * Find `query` in one page's already-extracted text.
+ *
+ * Matching runs over the whole page rather than line by line, so a phrase broken
+ * across a line break still matches — and comes back with one quadrilateral per line
+ * it covers, which is what a highlight needs.
+ */
+export declare function searchPageText(text: PageText, query: string, options?: MatchOptions): SearchMatch[];
+//# sourceMappingURL=search.d.ts.map

package/dist/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../src/search.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,QAAQ,EACb,KAAK,IAAI,EAET,KAAK,IAAI,EAEV,MAAM,WAAW,CAAC;AAEnB,wFAAwF;AACxF,MAAM,WAAW,YAAY;IAC3B,uBAAuB;IACvB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB;;;;;OAKG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,8EAA8E;IAC9E,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,6CAA6C;AAC7C,MAAM,WAAW,WAAW;IAC1B,+CAA+C;IAC/C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,0DAA0D;IAC1D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,+DAA+D;IAC/D,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,mDAAmD;IACnD,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,0DAA0D;IAC1D,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B;;;OAGG;IACH,QAAQ,CAAC,KAAK,EAAE,SAAS,IAAI,EAAE,CAAC;IAChC,gDAAgD;IAChD,QAAQ,CAAC,KAAK,EAAE,SAAS,IAAI,EAAE,CAAC;CACjC;AAyFD;;;;GAIG;AACH,wBAAgB,UAAU,CACxB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,YAAiB,GACzB,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CA6BzB;AAoBD;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,QAAQ,EACd,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,YAAiB,GACzB,WAAW,EAAE,CAkCf"}

package/dist/search.js

@@ -0,0 +1,151 @@
+import { lineQuad, quadBounds, } from './text.js';
+/** How much of the surrounding line to keep either side of a hit. */
+const CONTEXT_PADDING = 40;
+/** Ligatures that carry no `ToUnicode` mapping arrive as a single character. */
+const LIGATURES = {
+    ff: 'ff',
+    fi: 'fi',
+    fl: 'fl',
+    ffi: 'ffi',
+    ffl: 'ffl',
+    ſt: 'st',
+    st: 'st',
+    Æ: 'AE',
+    æ: 'ae',
+    Œ: 'OE',
+    œ: 'oe',
+};
+const COMBINING = /\p{M}/gu;
+function fold(source, options) {
+    const { caseSensitive = false, ignoreDiacritics = true } = options;
+    let text = '';
+    const origin = [];
+    for (let i = 0; i < source.length; i++) {
+        let piece = source[i];
+        // A line break is a place where a phrase may continue, not a barrier. Searching
+        // for "dynamic languages" should find a title broken across two lines.
+        if (piece === '\n' || piece === '\t')
+            piece = ' ';
+        piece = LIGATURES[piece] ?? piece;
+        if (ignoreDiacritics) {
+            piece = piece.normalize('NFD').replace(COMBINING, '');
+            // A character that is *only* a combining mark folds away entirely.
+            if (piece === '')
+                continue;
+        }
+        if (!caseSensitive)
+            piece = piece.toLowerCase();
+        for (const c of piece) {
+            text += c;
+            origin.push(i);
+        }
+    }
+    return { text, origin };
+}
+/** Collapse runs of whitespace so "Hello  World" matches "Hello World". */
+function squash(folded) {
+    let text = '';
+    const origin = [];
+    let previousWasSpace = false;
+    for (let i = 0; i < folded.text.length; i++) {
+        const c = folded.text[i];
+        const isSpace = c === ' ';
+        if (isSpace && previousWasSpace)
+            continue;
+        text += isSpace ? ' ' : c;
+        origin.push(folded.origin[i]);
+        previousWasSpace = isSpace;
+    }
+    return { text, origin };
+}
+const WORD = /[\p{L}\p{N}_]/u;
+function isBoundary(text, index) {
+    if (index < 0 || index >= text.length)
+        return true;
+    return !WORD.test(text[index]);
+}
+/**
+ * Where the query occurs in a page's text, as `[start, end)` in the *source* string.
+ *
+ * Exported for testing and for callers that hold their own page text.
+ */
+export function findRanges(source, query, options = {}) {
+    const needle = squash(fold(query, options)).text.trim();
+    if (needle === '')
+        return [];
+    const haystack = squash(fold(source, options));
+    const ranges = [];
+    let at = 0;
+    for (;;) {
+        const found = haystack.text.indexOf(needle, at);
+        if (found === -1)
+            break;
+        const end = found + needle.length;
+        if (!options.wholeWords ||
+            (isBoundary(haystack.text, found - 1) && isBoundary(haystack.text, end))) {
+            const start = haystack.origin[found];
+            // `end` is exclusive, so the last folded character's origin is the last source
+            // character the match covers — and a source character may fold to several.
+            const lastSource = haystack.origin[end - 1];
+            ranges.push([start, lastSource + 1]);
+        }
+        // Advance past the start, not past the end: overlapping occurrences of a
+        // repetitive query ("aa" in "aaa") are still two hits.
+        at = found + 1;
+    }
+    return ranges;
+}
+function locate(lines, index) {
+    let start = 0;
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        const end = start + line.text.length;
+        if (index < end)
+            return { line: i, offset: index - start };
+        // +1 for the '\n' the page string joins lines with.
+        start = end + 1;
+    }
+    return null;
+}
+/**
+ * Find `query` in one page's already-extracted text.
+ *
+ * Matching runs over the whole page rather than line by line, so a phrase broken
+ * across a line break still matches — and comes back with one quadrilateral per line
+ * it covers, which is what a highlight needs.
+ */
+export function searchPageText(text, query, options = {}) {
+    const source = text.lines.map((line) => line.text).join('\n');
+    const matches = [];
+    for (const [start, end] of findRanges(source, query, options)) {
+        const from = locate(text.lines, start);
+        // `end` is exclusive; step back to a character that is really inside the match.
+        const to = locate(text.lines, end - 1);
+        if (!from || !to)
+            continue;
+        const quads = [];
+        for (let i = from.line; i <= to.line; i++) {
+            const line = text.lines[i];
+            const first = i === from.line ? from.offset : 0;
+            const last = i === to.line ? to.offset + 1 : line.text.length;
+            if (last > first)
+                quads.push(lineQuad(line, first, last));
+        }
+        if (quads.length === 0)
+            continue;
+        const contextStart = Math.max(0, start - CONTEXT_PADDING);
+        matches.push({
+            page: text.page,
+            text: source.slice(start, end),
+            context: source
+                .slice(contextStart, end + CONTEXT_PADDING)
+                .replace(/\n/g, ' '),
+            contextStart: start - contextStart,
+            contextEnd: end - contextStart,
+            quads,
+            rects: quads.map(quadBounds),
+        });
+    }
+    return matches;
+}
+//# sourceMappingURL=search.js.map

package/dist/search.js.map

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

package/dist/text.d.ts

@@ -0,0 +1,113 @@
+import type { PageText as NativePageText } from '@build-qube/papyra-native';
+/**
+ * A run of glyphs sharing one baseline.
+ *
+ * Geometry runs *along the baseline* rather than being a rectangle per character. A
+ * page is thousands of glyphs and four numbers each is far more than a search needs;
+ * an origin, a direction and a list of distances reconstruct any substring's
+ * quadrilateral exactly, and keep working when the text is rotated.
+ */
+export interface TextLine {
+    /** The line's characters, with spaces reinserted between glyph runs. */
+    readonly text: string;
+    /**
+     * Distance along the baseline to the start of each character, plus the end of the
+     * last — one entry more than `text.length`.
+     */
+    readonly offsets: Float32Array;
+    /** Start of the baseline, x. */
+    readonly x: number;
+    /** Start of the baseline, y. */
+    readonly y: number;
+    /** Unit vector along the baseline, x. `(1, 0)` for ordinary horizontal text. */
+    readonly dx: number;
+    /** Unit vector along the baseline, y. */
+    readonly dy: number;
+    /** Extent above the baseline, perpendicular to it. */
+    readonly ascent: number;
+    /** Extent below the baseline. */
+    readonly descent: number;
+}
+/**
+ * The text of one page.
+ *
+ * Coordinates are **the page as rendered at 72 DPI**: pixels from the top-left corner
+ * with y increasing downwards, page rotation and crop box already applied. That makes
+ * them the same space as {@link PageSize}, so lining text up with a rendered bitmap is
+ * one multiply — `rendered.width / pageSize.width`, or equivalently `dpi / 72`.
+ */
+export interface PageText {
+    /** 0-based index of the page this text came from. */
+    readonly page: number;
+    /**
+     * The page's lines, in the order the content stream drew them — which is not
+     * necessarily reading order, because a PDF is under no obligation to draw text in
+     * the order a human reads it.
+     */
+    readonly lines: readonly TextLine[];
+    /**
+     * Glyphs the page drew that no encoding could map back to Unicode.
+     *
+     * Non-zero **alongside lines** is the case worth warning about: a paper whose
+     * headings use a standard font and whose body uses an embedded subset with no
+     * `ToUnicode` cmap looks searchable and mostly is not. Non-zero with no lines is a
+     * page of text nothing can read; zero with no lines is a page with no text, which
+     * may be a scan. Telling a user which they are looking at is the difference between
+     * "no results" and "this cannot be searched".
+     *
+     * Weigh it against the characters actually extracted — a few undecodable ornaments
+     * are not a lost paragraph.
+     */
+    readonly undecodedGlyphs: number;
+}
+/** Four corners, clockwise from the top-left of the text's own orientation. */
+export interface Quad {
+    /** Top-left, x. */
+    readonly x0: number;
+    /** Top-left, y. */
+    readonly y0: number;
+    /** Top-right, x. */
+    readonly x1: number;
+    /** Top-right, y. */
+    readonly y1: number;
+    /** Bottom-right, x. */
+    readonly x2: number;
+    /** Bottom-right, y. */
+    readonly y2: number;
+    /** Bottom-left, x. */
+    readonly x3: number;
+    /** Bottom-left, y. */
+    readonly y3: number;
+}
+/** An axis-aligned rectangle. */
+export interface Rect {
+    /** Left edge. */
+    readonly x: number;
+    /** Top edge — y increases downwards, so this is the smaller of the two. */
+    readonly y: number;
+    /** Width. */
+    readonly width: number;
+    /** Height. */
+    readonly height: number;
+}
+/** @internal */
+export declare function toPageText(page: number, native: NativePageText): PageText;
+/** Every character on the page a search can see. */
+export declare function pageString(text: PageText): string;
+/** Roughly how much memory a page's text holds, for cache accounting. */
+export declare function pageTextBytes(text: PageText): number;
+/**
+ * The quadrilateral covering `line`'s characters in `[start, end)`.
+ *
+ * Built from the baseline rather than from a stored rectangle, so rotated text — a
+ * drawing's vertical dimension labels, a sideways table header — gets a box at its own
+ * angle instead of an axis-aligned one that covers the wrong pixels.
+ */
+export declare function lineQuad(line: TextLine, start: number, end: number): Quad;
+/** The smallest upright rectangle containing `quad`. */
+export declare function quadBounds(quad: Quad): Rect;
+/** Scale a rect from 72-DPI page space into a render's pixels. */
+export declare function scaleRect(rect: Rect, scale: number): Rect;
+/** Scale a quad from 72-DPI page space into a render's pixels. */
+export declare function scaleQuad(quad: Quad, scale: number): Quad;
+//# sourceMappingURL=text.d.ts.map