@laminapdf/sdk 0.2.0-alpha.2 → 0.2.0-alpha.4

package/README.md

@@ -10,7 +10,7 @@ const doc = Document.open(bytes);
 console.log(doc.pageCount);
 ```
 
-The package is ESM only. It isn't published to npm yet.
+The package is ESM only. It's on npm as an alpha release: `npm install @laminapdf/sdk@alpha`.
 
 ## Quick start
 
@@ -40,8 +40,8 @@ Coordinates are in page space: points from the top-left of the displayed page, w
 | Module | gzip | What it can do |
 | --- | ---: | --- |
 | base (`init()`) | ≈ 373 KB | Open (passwords, limits, strict mode), read pages and Info, warnings, edit with ops (transactions, undo/redo), save (auto, incremental, full rewrite; save jobs); build vector and image pages with links, outline, page labels, metadata |
-| extract (`init({ extract: true })` or `loadExtract()`) | ≈ 526 KB | Everything in base, plus text extraction (`page.text()`) |
-| text (`init({ text: true })` or `loadText()`) | ≈ 1,009 KB | Everything in base, plus fonts (`Font.fromBytes`, the standard 14), shaped text runs and text boxes, and text extraction |
+| extract (`init({ extract: true })` or `loadExtract()`) | ≈ 589 KB | Everything in base, plus text extraction (`page.text()`, `doc.extract()`) |
+| text (`init({ text: true })` or `loadText()`) | ≈ 1,075 KB | Everything in base, plus fonts (`Font.fromBytes`, the standard 14), shaped text runs and text boxes, and text extraction |
 
 A page that never draws text never downloads the text module. A `Builder` is built in the text module when it is loaded at the time the builder is created (or with `new Builder({ text: true })`); drawing text on a base-module builder throws `text-module-not-loaded`.
 
@@ -132,6 +132,47 @@ const text = doc.page(0).text({ skipInvisible: true });
 console.log(text.text());
 ```
 
+### For an LLM or a search index: `doc.extract()`
+
+`doc.extract({ format })` reads the whole document in reading order, tables included, and leaves out text a reader can't see. It needs the extract or text module, like `page.text()`, and returns one of four outputs:
+
+- `"markdown"`: a string, with pipe tables and, with `pageMarkers: true`, a `<!-- page N -->` comment before each page.
+- `"text"`: a string of plain text.
+- `"json"`: an `Extraction`, the `laminapdf.extract/1` document: every block with its page and box in points from the top-left corner, the text left out and why, and the file's warnings. With `chunk`, it carries the chunks too.
+- `"chunks"`: `Chunk`s of whole blocks up to `chunk.maxTokens` (512 by default), each with its blocks, pages, boxes and place in the Markdown.
+
+The JSON holds what Rust's `extract_json` writes for the same options.
+
+Five more options tune the extraction: `pages`, `readingOrder`, `tables` (`"lattice-and-stream"` also finds tables without lines), `drop` and `dehyphenate`. An unknown option throws `unknown-option` with the name you probably meant.
+
+```ts
+await init({ extract: true });
+const doc = Document.open(bytes);
+const chunks = doc.extract({ format: "chunks", chunk: { maxTokens: 400 } });
+```
+
+`doc.extract()` runs to the end in one call. In a Web Worker (`@laminapdf/sdk/worker`) the main thread stays free, but aborting the call's `signal` only rejects the promise: the Web Worker finishes the extraction first.
+
+### With a layout model: `extractWithModels()`
+
+The rules read most pages well. A layout model reads the pages they misread, such as magazines and columns set close together, by finding each page's regions: text, headings, lists, tables, pictures and running headers. The extraction then keeps each region's text together, reads the regions in order and names their kinds.
+
+`extractWithModels` runs an extraction with your model: name the model in `options.models`, and for each page the extraction calls your function with the page and the resolution to render it at. Your function returns the regions, each with a label, a box `[x, y, width, height]` in top-left points and a score.
+
+```ts
+const json = await extractWithModels(
+  doc,
+  { format: "json", models: { layout: heron.info } },
+  { layout: async ({ page, dpi }) => heron.detect(await renderPage(page, dpi)) },
+);
+```
+
+Here `heron` is [`@laminapdf/layout-heron`](../layout-heron/README.md)'s `HeronLayout`, which runs Docling's Heron layout model with onnxruntime-web, and `renderPage` is your own function that draws the page with `@laminapdf/render-pdfium` or `@laminapdf/render-hayro`.
+
+`generator.models` in the JSON names every model that gave a result, and `generator.mode` reads `rules+models`. An OCR engine plugs in the same way (`models.ocr` and an `ocr` function returning words) and reads only the pages with no visible text.
+
+To step the extraction yourself, `doc.extractJob(options)` returns a job: each `step(budget)` that needs a result returns its `request`, and `provide(result)` answers it.
+
 ## Remote and large files
 
 `Document.openRange(source, options)` opens a file whose bytes are fetched range by range, so a remote PDF opens without downloading it whole. Only what the open needs is fetched: the end of the file (the xref), the catalog, the page tree. The document stays synchronous; a call that needs bytes not fetched yet throws `data-pending` with `e.ranges`, and `await doc.ensure(() => …)` fetches them and calls again.
@@ -143,7 +184,7 @@ const bytes = await doc.ensure(() => doc.save({ mode: "fullRewrite" })); // fetc
 ```
 
 - **`httpRangeSource(url, { headers, credentials, signal, blockSize })`:** the first request asks for the last 64 KiB with `Range: bytes=-65536`, which also gives the size. Later requests are aligned to 16 KiB blocks and send `If-Range` with the first strong `ETag` (else `Last-Modified`); a different `ETag`, `Last-Modified` or size fails with `source-changed`. A server without either validator can't be checked: serve one. A server that answers `200` (no range support) is read from that one full download. HTTP errors are `fetch-failed` with `data.status`; the URL never appears in an error.
-- **CORS:** a `Range` header makes a cross-origin request preflighted. The server must answer with `Access-Control-Allow-Headers: Range` and expose `Content-Range`, `Content-Length` and `ETag` (`Access-Control-Expose-Headers`). It must not compress the response: `Content-Encoding` breaks byte ranges.
+- **CORS:** a `Range` header makes a cross-origin request preflighted, and so does the `If-Range` header every request after the first carries. The server must answer with `Access-Control-Allow-Headers: Range, If-Range` and expose `Content-Range`, `Content-Length` and `ETag` (`Access-Control-Expose-Headers`). It must not compress the response: `Content-Encoding` breaks byte ranges.
 - **`callbackSource(size, read)`:** any other random-access input (a `Blob`'s `slice`, a file handle, an IPC call).
 - **Options:** `signal` (for the open; aborting rejects and cancels its requests in flight; `ensure(f, { signal })` takes its own), `blockSize`, `readahead`, `budget` (the most bytes the document may hold; more is `source-budget-exceeded`) and `maxRounds`.
 - **Off the main thread:** each `ensure` call can take several round trips. `client.openUrl` in a Web Worker hides the loop behind its async API (see below).
@@ -173,7 +214,7 @@ const updated = await doc.save({ mode: "incremental" }, { signal, onProgress: (p
   - `Builder`: its callbacks (`path`, `tag`) can't cross either. Build on the main thread or in your own Web Worker.
 
 - **Remote files:** `client.openUrl(url, options)` opens a file by range requests in the Web Worker; every call fetches what it needs first. Its options are `httpRangeSource`'s, without a custom `fetch` (a function can't be sent to the Web Worker), and `openRange`'s (`budget`, `readahead`, `maxRounds`). Aborting the call's `signal` also cancels the fetches in flight.
-- **Cancellation:** pass `signal` to any call. An aborted call rejects at once with `LaminaPdfError` `cancelled`, whose `cause` is the signal's reason, and a late answer is dropped.
+- **Cancellation:** pass `signal` to any call. An aborted call rejects at once with `LaminaPdfError` `cancelled`, whose `cause` is the signal's reason, and a late answer is dropped. If an aborted `open` or `openUrl` opened its document anyway, the Web Worker frees it.
   - **Not started yet:** the call never runs.
   - **`save` / `saveWithReport`:** they run as stepped jobs and stop at the next step. The document stays usable.
   - **Every other call:** one synchronous call in the Web Worker, so it can't be stopped midway (`open` included). `client.terminate()` is the hard stop.
@@ -196,13 +237,27 @@ const updated = await doc.save({ mode: "incremental" }, { signal, onProgress: (p
 
 ## Memory
 
-Documents, builders, pages and images live in WebAssembly memory. `doc.free()` (or `using doc = Document.open(…)`) frees a document at once; `page.finish()` and `builder.finish()` free their own side; the garbage collector frees anything you don't release, through a `FinalizationRegistry`. `wasmMemory()` reports each module's memory size.
+Documents, builders, pages, save jobs and images live in WebAssembly memory. Free each one when you're done: `using doc = Document.open(…)` frees it at the end of the block, and `doc.free()` frees it at once. A second `free()` does nothing, and any other call afterwards throws `disposed`. A page or save job is freed with its document, a builder's page with its builder, and `page.finish()` and `builder.finish()` free their WebAssembly memory. The garbage collector frees whatever you forget, only later. To find what you forget, `onLeak((leak) => console.warn(leak.handle))` reports each document, builder or image the collector reclaims without a `free()`.
+
+WebAssembly memory grows as Lamina PDF needs it and never shrinks. Three bounds keep it in check:
+
+- **Limits:** the open limits (`limits` in `Document.open`'s options) stop most hostile files before they use much memory.
+- **A ceiling:** each module may grow to 2 GiB. Past that, the call throws `out-of-memory`.
+- **`reset()`:** replaces every loaded module's instance with a fresh one, so memory returns to its size after `init()`. Every document, page, builder and save job made before throws `instance-reset`, so call it while none is in use, such as between jobs on a server. Images and fonts keep working.
+
+When Lamina PDF hits a bug, the module traps and the call throws `wasm-trap`. After a trap or `out-of-memory`, the next call runs in a fresh instance, and the old instance's handles throw `instance-reset`: open the document again from its bytes. In a Web Worker from `@laminapdf/sdk/worker`, a trap ends the Web Worker instead, and `client.restart()` starts a new one. `wasmMemory()` reports each module's memory size.
+
+**`using` in Safari:** according to MDN's compatibility data (November 2026), Safari has `Symbol.dispose` only in its Technology Preview. When esbuild or Babel compile `using`, they fall back to `Symbol.for("Symbol.dispose")`, and every Lamina PDF handle answers to that key too. TypeScript's compiled `using` needs the symbol itself, so add `Symbol.dispose ??= Symbol.for("Symbol.dispose")` to your app. In that form it matches Lamina PDF's key whichever runs first. Without it, call `free()` in a `finally` block.
 
 ## Examples
 
-The [examples](https://docs.laminapdf.com/examples/) are `hello`, `invoice`, `multilingual`, `images-and-vectors`, `links-and-outlines` and `generate-then-edit`, plus `report`, 100 pages with two embedded fonts. Each produces the same bytes as its Rust twin.
+The [recipes](https://docs.laminapdf.com/recipes/) show each example with what it makes and what to change: `hello`, `invoice`, `multilingual`, `images-and-vectors`, `links-and-outlines` and `generate-then-edit`, plus `report`, 100 pages with two embedded fonts. Each produces the same bytes as its Rust twin.
+
+A Cloudflare Worker example generates a PDF per request: `/?name=Ada` returns a letter in Helvetica, and `/embedded?name=Ada` the same letter in a font bundled with the Cloudflare Worker. A name the font can't draw gets a 400 with the error as JSON. The [Cloudflare Workers quick start](https://docs.laminapdf.com/quick-start/workers/) shows it and how to run it.
+
+## Docs for coding agents
 
-A Cloudflare Worker example generates a PDF per request: `/?name=Ada` returns a letter in Helvetica, or a 400 with the error as JSON for a name it can't draw, and `/report` returns the report. The [Cloudflare Workers quick start](https://docs.laminapdf.com/quick-start/workers/) shows it and how to run it.
+The package carries these docs as Markdown in `docs/`, for the version you installed: `docs/llms.txt` lists every page, `docs/api/` holds the API reference, `docs/errors/` explains each error code and `docs/renames.json` says what renamed items are called now. Paste `docs/AGENTS.md` into your project's `AGENTS.md` or `CLAUDE.md` to point your coding agent at them. The [coding agents page](https://docs.laminapdf.com/start/coding-agents/) has the details.
 
 ## Working on this package
 

package/dist/api.d.ts

@@ -3,11 +3,16 @@ export { Builder, PAGE_SIZES, Page, PendingPath, Surface, TAG_NAMES } from "./bu
 export { Document, PageRef, SaveJob } from "./document.js";
 export type { Diagnostic, ErrorKind, LaminaPdfWarning, Location } from "./errors.js";
 export { isLaminaPdfError, LaminaPdfError } from "./errors.js";
+export type { Cell, Chunk, ChunkOptions, Coordinates, Dropped, DropReason, ExtractedBlock, ExtractedPage, ExtractedSource, ExtractFormat, Extraction, ExtractOptions, ExtractResult, Flags, Generator, ReadingOrder, Region, Span, SplitOn, StructRef, StructSource, TableDetector, TableMode, TextLayer, TextLayerStatus, TextRange, } from "./extract.js";
+export type { ExtractJobOptions, ExtractStep, HostModels, LayoutRegion, ModelInfo, ModelRequest, ModelResult, Models, OcrWord, RegionLabel, } from "./extract-job.js";
+export { ExtractJob, extractWithModels } from "./extract-job.js";
 export type { FontInfo, Standard14 } from "./font.js";
 export { Font, Image } from "./font.js";
 export type { ErrorCode, LimitName, WarningCode } from "./generated/codes.js";
 export type { InitOptions, WasmMemory, WasmSource } from "./init.js";
-export { isExtractLoaded, isInitialized, isTextLoaded, wasmMemory } from "./init.js";
+export { isExtractLoaded, isInitialized, isTextLoaded, reset, wasmMemory } from "./init.js";
+export type { Leak } from "./internal/handle.js";
+export { onLeak } from "./internal/handle.js";
 export type { Transform } from "./matrix.js";
 export { Matrix } from "./matrix.js";
 export type { PathBuilder } from "./path.js";
@@ -16,8 +21,8 @@ export { httpRangeSource } from "./source/http.js";
 export type { ByteRange, RangeOptions, RangeSource } from "./source/range.js";
 export { callbackSource } from "./source/range.js";
 export type { GlyphQuad, QuadPoint, TextGlyph, TextOptions as PageTextOptions } from "./text.js";
-export { PageText, TextRun as PageTextRun } from "./text.js";
+export { PageText, PageTextRun } from "./text.js";
 export type { InfoPatch, Rotation } from "./transaction.js";
 export { Transaction } from "./transaction.js";
-export type { AfRelationship, Align, AttachmentOptions, BoxRect, BuildOptions, Color, Direction, DocumentInfo, Edited, Fit, Limits, LineBox, LinkTarget, Metadata, Op, OpenOptions, OpLog, OutlineEntry, Overflow, PageInfo, PageLabel, Point, Profile, Progress, Rect, RenderMode, SaveOptions, SaveReport, TextLayout, TextRunInfo, UndoOutcome, ViewerPreferences, } from "./types.js";
+export type { AfRelationship, Align, AttachmentOptions, BoxRect, BuildOptions, Color, Direction, DocumentInfo, Edited, Fit, Limits, LineBox, LinkTarget, Metadata, Op, OpenOptions, OpLog, OutlineEntry, OutlineNode, Overflow, PageInfo, PageLabel, Point, Profile, Progress, Rect, RenderMode, SaveOptions, SaveReport, StructureKid, StructureNode, Target, TargetView, TextLayout, TextRunInfo, UndoOutcome, ViewerPreferences, } from "./types.js";
 //# sourceMappingURL=api.d.ts.map

package/dist/api.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"AAEA,YAAY,EACV,YAAY,EACZ,SAAS,EACT,cAAc,EACd,QAAQ,EACR,OAAO,EACP,QAAQ,EACR,YAAY,EACZ,WAAW,EACX,UAAU,EACV,GAAG,EACH,OAAO,EACP,OAAO,EACP,cAAc,EACd,WAAW,GACZ,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC1F,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAC3D,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACrF,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC/D,YAAY,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACtD,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AACxC,YAAY,EAAE,SAAS,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAC9E,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACrE,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACrF,YAAY,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,YAAY,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAC7C,YAAY,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,YAAY,EAAE,SAAS,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAC9E,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,YAAY,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,WAAW,IAAI,eAAe,EAAE,MAAM,WAAW,CAAC;AACjG,OAAO,EAAE,QAAQ,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,WAAW,CAAC;AAC7D,YAAY,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,YAAY,EACV,cAAc,EACd,KAAK,EACL,iBAAiB,EACjB,OAAO,EACP,YAAY,EACZ,KAAK,EACL,SAAS,EACT,YAAY,EACZ,MAAM,EACN,GAAG,EACH,MAAM,EACN,OAAO,EACP,UAAU,EACV,QAAQ,EACR,EAAE,EACF,WAAW,EACX,KAAK,EACL,YAAY,EACZ,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,KAAK,EACL,OAAO,EACP,QAAQ,EACR,IAAI,EACJ,UAAU,EACV,WAAW,EACX,UAAU,EACV,UAAU,EACV,WAAW,EACX,WAAW,EACX,iBAAiB,GAClB,MAAM,YAAY,CAAC"}
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"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"}

package/dist/api.js

@@ -1,11 +1,13 @@
 export { Builder, PAGE_SIZES, Page, PendingPath, Surface, TAG_NAMES } from "./builder.js";
 export { Document, PageRef, SaveJob } from "./document.js";
 export { isLaminaPdfError, LaminaPdfError } from "./errors.js";
+export { ExtractJob, extractWithModels } from "./extract-job.js";
 export { Font, Image } from "./font.js";
-export { isExtractLoaded, isInitialized, isTextLoaded, wasmMemory } from "./init.js";
+export { isExtractLoaded, isInitialized, isTextLoaded, reset, wasmMemory } from "./init.js";
+export { onLeak } from "./internal/handle.js";
 export { Matrix } from "./matrix.js";
 export { httpRangeSource } from "./source/http.js";
 export { callbackSource } from "./source/range.js";
-export { PageText, TextRun as PageTextRun } from "./text.js";
+export { PageText, PageTextRun } from "./text.js";
 export { Transaction } from "./transaction.js";
 //# sourceMappingURL=api.js.map

package/dist/api.js.map

@@ -1 +1 @@
-{"version":3,"file":"api.js","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"AAkBA,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC1F,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAE3D,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE/D,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AAGxC,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAErF,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAGrC,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAEnD,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEnD,OAAO,EAAE,QAAQ,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,WAAW,CAAC;AAE7D,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"AAkBA,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC1F,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAE3D,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAyC/D,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAEjE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AAGxC,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,YAAY,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAE5F,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAE9C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAGrC,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAEnD,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEnD,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAElD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/builder.d.ts

@@ -1,8 +1,11 @@
+import type { WasmImage } from "@laminapdf/wasm/base";
 import type { WasmPageBuilder as TextPageBuilder, WasmFont } from "@laminapdf/wasm/text";
 import { Document } from "./document.js";
 import type { Font, FontInfo, Image } from "./font.js";
 import { type ArtifactKind, type BlendMode, type FillRule, type LineCap, type LineJoin, type TableScope, type TagName } from "./generated/builder-enums.js";
-import { type BaseGlue, type TextGlue } from "./init.js";
+import { type BaseGlue } from "./init.js";
+import { Handle } from "./internal/handle.js";
+import type { Instance } from "./internal/instance.js";
 import type { Transform } from "./matrix.js";
 import { type PathBuilder } from "./path.js";
 import type { Align, AttachmentOptions, BuildOptions, Color, Direction, Fit, LinkTarget, Metadata, OutlineEntry, Overflow, PageLabel, Point, Rect, RenderMode, TextLayout, TextRunInfo, ViewerPreferences } from "./types.js";
@@ -105,12 +108,22 @@ export interface TextBoxOptions {
     /** The structure element the box is (as drawing it inside {@link Surface.tag}). */
     readonly tag?: Tag;
 }
-/** The raw page of a {@link Page}: freed when the page finishes, `builder-finished` afterwards. */
-declare class LivePage {
+/**
+ * The raw page of a {@link Page}, a handle freed with its builder: `builder-finished` once the page
+ * or its builder finishes, `disposed` once either is freed.
+ */
+declare class LivePage extends Handle<BaseGlue> {
     #private;
-    constructor(raw: TextPageBuilder, onFree: (page: LivePage) => void);
-    get(): TextPageBuilder;
-    free(): void;
+    constructor(raw: TextPageBuilder, builder: Builder, instance: Instance<BaseGlue>, onClose: (page: LivePage) => void);
+    /**
+     * Runs `f`, calls into the glue, on this page's raw side.
+     *
+     * @throws {@link LaminaPdfError} `disposed`, `instance-reset`, `builder-finished`; what `f` throws.
+     */
+    run<T>(f: (page: TextPageBuilder) => T): T;
+    /** Frees the raw page and keeps the handle: later calls throw `builder-finished`. */
+    close(): void;
+    protected release(): void;
 }
 /** A path waiting to be painted: fill it, stroke it, both, or clip to it. */
 export declare class PendingPath {
@@ -182,7 +195,9 @@ export declare class Surface {
     tag(tag: Tag, draw: (s: this) => void): this;
     /**
      * Draws what `draw` draws as an artifact: decoration, running heads and footers, backgrounds;
-     * content outside the structure tree.
+     * content outside the structure tree. `"header"`, `"footer"` and `"watermark"` are pagination
+     * artifacts that also say which (`/Subtype`), a header attached to the page's top edge and a
+     * footer to its bottom (`/Attached`).
      */
     artifact(kind: ArtifactKind, draw: (s: this) => void): this;
     /** A link annotation over `rect`, with `contents` as its alternate text. */
@@ -190,19 +205,25 @@ export declare class Surface {
     /**
      * Draws `text`: shaped, bidi-resolved, one line per line break (needs the text module).
      *
-     * @returns what the run measures.
+     * @returns what the run measures, with `bottom`: where the next element can start (the next text box's top), the
+     *   descent below the last line that draws something, before the surface's transform; left out when nothing is.
      * @throws {@link LaminaPdfError} `text-module-not-loaded`, `missing-glyph`, `font-not-shapable`, …
      */
     text(text: string, options: TextOptions): TextRunInfo;
     /**
      * Lays `text` out in `options.box`, breaking lines at Unicode line-break opportunities.
      *
-     * @returns the lines drawn and where the overflow starts (UTF-16 offsets).
+     * @returns the lines drawn, where the overflow starts (UTF-16 offsets; test it with `!== undefined`, as `0` means no
+     *   line fitted) and `bottom`: the last line that draws something, before the surface's transform; left out when none
+     *   does.
      * @throws {@link LaminaPdfError} as {@link Surface.text}; `text-overflow` with `overflow: "error"`.
      */
     textBox(text: string, options: TextBoxOptions): TextLayout;
 }
-/** A page being drawn: its boxes and rotation, its {@link Surface}, then {@link Page.finish}. */
+/**
+ * A page being drawn: its boxes and rotation, its {@link Surface}, then {@link Page.finish}. Freed
+ * with its builder; `using` or {@link Page.free} drops it without writing it.
+ */
 export declare class Page {
     #private;
     /** @internal */
@@ -229,13 +250,19 @@ export declare class Page {
      * @throws {@link LaminaPdfError} `invalid-geometry`, `builder-finished`.
      */
     finish(): string;
-    /** Drops the page without writing it (frees its WASM side). */
+    /**
+     * Drops the page without writing it and frees its WASM side; a second call does nothing, and
+     * any other call afterwards throws `disposed`.
+     */
     free(): void;
+    /** Drops the page at the end of a `using` block (an alias of `free()`). */
+    [Symbol.dispose](): void;
 }
 /**
  * Builds a new document: pages, navigation and metadata; {@link Builder.finish} returns a
  * {@link Document} to save. Created in the text module when it is loaded (or `text: true`),
- * else in the reading module (text, extract, then base; vector and image pages only).
+ * else in the reading module (text, extract, then base; vector and image pages only). `finish()`
+ * frees its WebAssembly memory; to drop it unfinished, use `using` or {@link Builder.free}.
  *
  * @example
  * ```ts
@@ -247,16 +274,16 @@ export declare class Page {
  * const bytes = b.finish().save();
  * ```
  */
-export declare class Builder {
+export declare class Builder extends Handle<BaseGlue> {
     #private;
-    /** @internal The module the document is built in. */
-    readonly glue: BaseGlue | TextGlue;
     /**
      * @param options - version, file ID, producer, creation date, compression, tagging,
      *   conformance `profiles`; `text`.
      * @throws {@link LaminaPdfError} `not-initialized`, `text-module-not-loaded`; `unknown-option`.
      */
     constructor(options?: BuilderOptions);
+    /** @internal `image` in this builder's instance. */
+    wasmImage(image: Image): WasmImage;
     /** As `new Builder(options)`. */
     static create(options?: BuilderOptions): Builder;
     /** Whether this builder draws in the text module (fonts and text). */
@@ -308,12 +335,6 @@ export declare class Builder {
      *   code (the error reference lists them, from `profile-version-conflict` on).
      */
     finish(): Document;
-    /**
-     * Frees the builder's WASM memory now (`finish` does this itself); the builder takes no more
-     * calls afterwards. Unfinished pages are freed with {@link Page.free}.
-     */
-    free(): void;
-    /** Frees the builder at the end of a `using` block. */
-    [Symbol.dispose](): void;
+    protected release(): void;
 }
 //# sourceMappingURL=builder.d.ts.map

package/dist/builder.d.ts.map

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