@laminapdf/sdk 0.0.0-stage → 0.2.0-alpha.3

package/dist/worker/transfer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transfer.d.ts","sourceRoot":"","sources":["../../src/worker/transfer.ts"],"names":[],"mappings":"AAEA,sGAAsG;AACtG,wBAAgB,KAAK,CAAC,KAAK,EAAE,OAAO,GAAG,WAAW,EAAE,CAOnD"}

package/dist/worker/transfer.js

@@ -0,0 +1,13 @@
+// Which buffers a message between the page and the worker can move instead of copying.
+/** The buffer of `value` if transferring it moves exactly `value` (not a larger or shared buffer). */
+export function whole(value) {
+    if (value instanceof ArrayBuffer)
+        return [value];
+    if (!ArrayBuffer.isView(value))
+        return [];
+    const { buffer } = value;
+    return buffer instanceof ArrayBuffer && value.byteOffset === 0 && value.byteLength === buffer.byteLength
+        ? [buffer]
+        : [];
+}
+//# sourceMappingURL=transfer.js.map

package/dist/worker/transfer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transfer.js","sourceRoot":"","sources":["../../src/worker/transfer.ts"],"names":[],"mappings":"AAAA,uFAAuF;AAEvF,sGAAsG;AACtG,MAAM,UAAU,KAAK,CAAC,KAAc;IAClC,IAAI,KAAK,YAAY,WAAW;QAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IACjD,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAC1C,MAAM,EAAE,MAAM,EAAE,GAAG,KAAK,CAAC;IACzB,OAAO,MAAM,YAAY,WAAW,IAAI,KAAK,CAAC,UAAU,KAAK,CAAC,IAAI,KAAK,CAAC,UAAU,KAAK,MAAM,CAAC,UAAU;QACtG,CAAC,CAAC,CAAC,MAAM,CAAC;QACV,CAAC,CAAC,EAAE,CAAC;AACT,CAAC"}

package/dist/worker/types.d.ts

@@ -0,0 +1,50 @@
+import type { Document, PageRef } from "../document.js";
+import type { ExtractFormat, ExtractOptions, ExtractResult } from "../extract.js";
+import type { Progress } from "../types.js";
+import type { RemotableDocumentMember, RemotablePageMember } from "./support.js";
+/** Per-call options of the worker client. */
+export interface CallOptions {
+    /** Aborting it rejects the call (`cancelled`) and stops it in the worker (see the README). */
+    readonly signal?: AbortSignal;
+    /** Progress of a stepped call (`save`), sent as events, at most every 50 ms. */
+    readonly onProgress?: (progress: Progress) => void;
+    /**
+     * Transfer the input buffer to the worker instead of copying it: faster for large files, but
+     * the caller's buffer is detached (empty) afterwards. Default `false` (copy). Only a buffer
+     * the input covers whole moves: a subarray or a `SharedArrayBuffer` view is copied.
+     */
+    readonly transfer?: boolean;
+}
+/**
+ * Options of an extension call (`client.request`, for packages that extend the worker, such as
+ * `@laminapdf/viewer`): the worker runs the highest `priority` first, and runs calls with the same
+ * `key` once (each caller still gets its own answer).
+ */
+export interface RequestOptions extends CallOptions {
+    readonly priority?: number;
+    readonly key?: string;
+}
+/** `R` as the page receives it. */
+export type RemoteResult<R> = R extends PageRef ? RemotePage : R;
+/** A member of `T` as a remote method. */
+export type RemoteMember<T> = T extends (...args: infer A) => infer R ? (...args: [...A, options?: CallOptions]) => Promise<RemoteResult<R>> : (options?: CallOptions) => Promise<RemoteResult<T>>;
+/** A document in the worker. Close it (or `await using`) to free it there. */
+export type RemoteDocument = {
+    readonly [K in Exclude<RemotableDocumentMember, "extract">]: RemoteMember<Document[K]>;
+} & {
+    /**
+     * {@link Document.extract} in the worker, typed by `format` like the sync one (a mapped type
+     * would lose the generic). It runs to the end: an aborted `signal` rejects the call, and the
+     * worker finishes the extraction before its next call.
+     */
+    extract<F extends ExtractFormat>(options: ExtractOptions<F>, call?: CallOptions): Promise<ExtractResult[F]>;
+    /** Frees the document in the worker; a second call, or one after the worker stopped, does nothing. */
+    close(): Promise<void>;
+    /** `close()`, for `await using`. */
+    [Symbol.asyncDispose](): Promise<void>;
+};
+/** A page of a document in the worker (freed with its document). */
+export type RemotePage = {
+    readonly [K in RemotablePageMember]: RemoteMember<PageRef[K]>;
+};
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/worker/types.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAClF,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,KAAK,EAAE,uBAAuB,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAEjF,6CAA6C;AAC7C,MAAM,WAAW,WAAW;IAC1B,8FAA8F;IAC9F,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAC9B,gFAAgF;IAChF,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,KAAK,IAAI,CAAC;IACnD;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED;;;;GAIG;AACH,MAAM,WAAW,cAAe,SAAQ,WAAW;IACjD,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,mCAAmC;AACnC,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI,CAAC,SAAS,OAAO,GAAG,UAAU,GAAG,CAAC,CAAC;AAEjE,0CAA0C;AAC1C,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,MAAM,CAAC,KAAK,MAAM,CAAC,GACjE,CAAC,GAAG,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC,EAAE,WAAW,CAAC,KAAK,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,GACpE,CAAC,OAAO,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC;AAExD,8EAA8E;AAC9E,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,EAAE,CAAC,IAAI,OAAO,CAAC,uBAAuB,EAAE,SAAS,CAAC,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;CACvF,GAAG;IACF;;;;OAIG;IACH,OAAO,CAAC,CAAC,SAAS,aAAa,EAAE,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5G,sGAAsG;IACtG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,oCAAoC;IACpC,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxC,CAAC;AAEF,oEAAoE;AACpE,MAAM,MAAM,UAAU,GAAG;IAAE,QAAQ,EAAE,CAAC,IAAI,mBAAmB,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;CAAE,CAAC"}

package/dist/worker/types.js

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

package/dist/worker/types.js.map

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

package/docs/AGENTS.md

@@ -0,0 +1,14 @@
+---
+version: "0.2.0-alpha.3"
+---
+
+## Lamina PDF
+
+This project uses Lamina PDF (`@laminapdf/sdk` in TypeScript, the `laminapdf` crate in Rust) to create, read, edit and save PDF files.
+
+- **Read the installed docs first.** They match the installed version: `node_modules/@laminapdf/sdk/docs/llms.txt` lists every page, and `docs/api/` holds the API reference. In Rust they are in the `laminapdf` crate's `docs/` folder. Online: https://docs.laminapdf.com/llms.txt (the latest version).
+- **Call `await init()` once before anything else.** After it every call is synchronous. Fonts and text need `await init({ text: true })`; reading text needs the extract or text module (`await init({ extract: true })` or `{ text: true }`). Rust needs no setup.
+- **Positions are points from the top-left corner** of the page as it is displayed, with y going down. A text position is its baseline. Page numbers in the API start at 0 (`page(0)` is the first page).
+- **Branch on an error's `code`, never its message.** Every error is a `LaminaPdfError` with a stable `code` (such as `wrong-password`) and a `hint`; `docs/errors/<code>.md` explains each one. Warnings, which say what Lamina PDF repaired in a damaged file, use the same codes.
+- **Free what you open.** A `Document` or `Builder` holds WebAssembly memory: declare it with `using`, or call `free()` when you are done.
+- **Check `docs/renames.json`** when a name in older code or an older answer doesn't exist: it says what each renamed item is called now.

package/docs/api/README.md

@@ -0,0 +1,147 @@
+---
+version: "0.2.0-alpha.3"
+---
+
+**@laminapdf/sdk**
+
+***
+
+# @laminapdf/sdk
+
+## Classes
+
+- [Builder](classes/Builder.md)
+- [Document](classes/Document.md)
+- [Font](classes/Font.md)
+- [Image](classes/Image.md)
+- [LaminaPdfError](classes/LaminaPdfError.md)
+- [Page](classes/Page.md)
+- [PageRef](classes/PageRef.md)
+- [PageText](classes/PageText.md)
+- [PageTextRun](classes/PageTextRun.md)
+- [PendingPath](classes/PendingPath.md)
+- [SaveJob](classes/SaveJob.md)
+- [Surface](classes/Surface.md)
+- [Transaction](classes/Transaction.md)
+
+## Interfaces
+
+- [BuilderOptions](interfaces/BuilderOptions.md)
+- [ByteRange](interfaces/ByteRange.md)
+- [ChunkOptions](interfaces/ChunkOptions.md)
+- [Diagnostic](interfaces/Diagnostic.md)
+- [ExtractOptions](interfaces/ExtractOptions.md)
+- [ExtractResult](interfaces/ExtractResult.md)
+- [FontInfo](interfaces/FontInfo.md)
+- [HttpRangeOptions](interfaces/HttpRangeOptions.md)
+- [InitOptions](interfaces/InitOptions.md)
+- [Leak](interfaces/Leak.md)
+- [Location](interfaces/Location.md)
+- [OpenOptions](interfaces/OpenOptions.md)
+- [OpLog](interfaces/OpLog.md)
+- [PageTextOptions](interfaces/PageTextOptions.md)
+- [PathBuilder](interfaces/PathBuilder.md)
+- [QuadPoint](interfaces/QuadPoint.md)
+- [RangeOptions](interfaces/RangeOptions.md)
+- [RangeSource](interfaces/RangeSource.md)
+- [StrokeStyle](interfaces/StrokeStyle.md)
+- [TagSpec](interfaces/TagSpec.md)
+- [TextBoxOptions](interfaces/TextBoxOptions.md)
+- [TextGlyph](interfaces/TextGlyph.md)
+- [TextOptions](interfaces/TextOptions.md)
+- [WasmMemory](interfaces/WasmMemory.md)
+
+## Type Aliases
+
+- [AfRelationship](type-aliases/AfRelationship.md)
+- [Align](type-aliases/Align.md)
+- [ArtifactKind](type-aliases/ArtifactKind.md)
+- [AttachmentOptions](type-aliases/AttachmentOptions.md)
+- [BlendMode](type-aliases/BlendMode.md)
+- [BoxRect](type-aliases/BoxRect.md)
+- [BuildOptions](type-aliases/BuildOptions.md)
+- [Cell](type-aliases/Cell.md)
+- [Chunk](type-aliases/Chunk.md)
+- [Color](type-aliases/Color.md)
+- [Coordinates](type-aliases/Coordinates.md)
+- [Direction](type-aliases/Direction.md)
+- [DocumentInfo](type-aliases/DocumentInfo.md)
+- [Dropped](type-aliases/Dropped.md)
+- [DropReason](type-aliases/DropReason.md)
+- [Edited](type-aliases/Edited.md)
+- [ErrorCode](type-aliases/ErrorCode.md)
+- [ErrorKind](type-aliases/ErrorKind.md)
+- [ExtractedBlock](type-aliases/ExtractedBlock.md)
+- [ExtractedPage](type-aliases/ExtractedPage.md)
+- [ExtractedSource](type-aliases/ExtractedSource.md)
+- [ExtractFormat](type-aliases/ExtractFormat.md)
+- [Extraction](type-aliases/Extraction.md)
+- [FillRule](type-aliases/FillRule.md)
+- [Fit](type-aliases/Fit.md)
+- [Flags](type-aliases/Flags.md)
+- [Generator](type-aliases/Generator.md)
+- [GlyphQuad](type-aliases/GlyphQuad.md)
+- [InfoPatch](type-aliases/InfoPatch.md)
+- [LaminaPdfWarning](type-aliases/LaminaPdfWarning.md)
+- [LimitName](type-aliases/LimitName.md)
+- [Limits](type-aliases/Limits.md)
+- [LineBox](type-aliases/LineBox.md)
+- [LineCap](type-aliases/LineCap.md)
+- [LineJoin](type-aliases/LineJoin.md)
+- [LinkTarget](type-aliases/LinkTarget.md)
+- [Metadata](type-aliases/Metadata.md)
+- [Op](type-aliases/Op.md)
+- [OutlineEntry](type-aliases/OutlineEntry.md)
+- [Overflow](type-aliases/Overflow.md)
+- [PageInfo](type-aliases/PageInfo.md)
+- [PageLabel](type-aliases/PageLabel.md)
+- [PageSizeName](type-aliases/PageSizeName.md)
+- [Point](type-aliases/Point.md)
+- [Profile](type-aliases/Profile.md)
+- [Progress](type-aliases/Progress.md)
+- [ReadingOrder](type-aliases/ReadingOrder.md)
+- [Rect](type-aliases/Rect.md)
+- [Region](type-aliases/Region.md)
+- [RenderMode](type-aliases/RenderMode.md)
+- [Rotation](type-aliases/Rotation.md)
+- [SaveOptions](type-aliases/SaveOptions.md)
+- [SaveReport](type-aliases/SaveReport.md)
+- [Span](type-aliases/Span.md)
+- [SplitOn](type-aliases/SplitOn.md)
+- [Standard14](type-aliases/Standard14.md)
+- [StructRef](type-aliases/StructRef.md)
+- [StructSource](type-aliases/StructSource.md)
+- [TableDetector](type-aliases/TableDetector.md)
+- [TableMode](type-aliases/TableMode.md)
+- [TableScope](type-aliases/TableScope.md)
+- [Tag](type-aliases/Tag.md)
+- [TagName](type-aliases/TagName.md)
+- [TextLayout](type-aliases/TextLayout.md)
+- [TextRange](type-aliases/TextRange.md)
+- [TextRunInfo](type-aliases/TextRunInfo.md)
+- [Transform](type-aliases/Transform.md)
+- [UndoOutcome](type-aliases/UndoOutcome.md)
+- [ViewerPreferences](type-aliases/ViewerPreferences.md)
+- [WarningCode](type-aliases/WarningCode.md)
+- [WasmSource](type-aliases/WasmSource.md)
+
+## Variables
+
+- [Matrix](variables/Matrix.md)
+- [PAGE\_SIZES](variables/PAGE_SIZES.md)
+- [TAG\_NAMES](variables/TAG_NAMES.md)
+
+## Functions
+
+- [callbackSource](functions/callbackSource.md)
+- [httpRangeSource](functions/httpRangeSource.md)
+- [init](functions/init.md)
+- [isExtractLoaded](functions/isExtractLoaded.md)
+- [isInitialized](functions/isInitialized.md)
+- [isLaminaPdfError](functions/isLaminaPdfError.md)
+- [isTextLoaded](functions/isTextLoaded.md)
+- [loadExtract](functions/loadExtract.md)
+- [loadText](functions/loadText.md)
+- [onLeak](functions/onLeak.md)
+- [reset](functions/reset.md)
+- [wasmMemory](functions/wasmMemory.md)

package/docs/api/classes/Builder.md

@@ -0,0 +1,467 @@
+---
+version: "0.2.0-alpha.3"
+---
+
+[**@laminapdf/sdk**](../README.md)
+
+***
+
+[@laminapdf/sdk](../README.md) / Builder
+
+# Class: Builder
+
+Builds a new document: pages, navigation and metadata; [Builder.finish](#finish) returns a
+[Document](Document.md) 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). `finish()`
+frees its WebAssembly memory; to drop it unfinished, use `using` or [Builder.free](#free).
+
+## Example
+
+```ts
+await init({ text: true });
+const b = new Builder({ producer: "my app" });
+const page = b.page("A4");
+page.surface().text("Hello, world!", { font: Font.standard("Helvetica"), size: 24, at: [72, 96] });
+page.finish();
+const bytes = b.finish().save();
+```
+
+## Extends
+
+- `Handle`\<`BaseGlue`\>
+
+## Constructors
+
+### Constructor
+
+> **new Builder**(`options?`): `Builder`
+
+#### Parameters
+
+##### options?
+
+[`BuilderOptions`](../interfaces/BuilderOptions.md) = `{}`
+
+version, file ID, producer, creation date, compression, tagging,
+  conformance `profiles`; `text`.
+
+#### Returns
+
+`Builder`
+
+#### Throws
+
+[LaminaPdfError](LaminaPdfError.md) `not-initialized`, `text-module-not-loaded`; `unknown-option`.
+
+#### Overrides
+
+`Handle<BaseGlue>.constructor`
+
+## Accessors
+
+### hasText
+
+#### Get Signature
+
+> **get** **hasText**(): `boolean`
+
+Whether this builder draws in the text module (fonts and text).
+
+##### Returns
+
+`boolean`
+
+***
+
+### instance
+
+#### Get Signature
+
+> **get** `protected` **instance**(): `Instance`\<`G`\>
+
+The instance this handle lives in (for the handles it makes).
+
+##### Returns
+
+`Instance`\<`G`\>
+
+#### Inherited from
+
+`Handle.instance`
+
+***
+
+### isFreed
+
+#### Get Signature
+
+> **get** `protected` **isFreed**(): `boolean`
+
+Whether `free()` ran on this handle or its parent.
+
+##### Returns
+
+`boolean`
+
+#### Inherited from
+
+`Handle.isFreed`
+
+***
+
+### owned
+
+#### Get Signature
+
+> **get** `protected` **owned**(): `boolean`
+
+Whether the handle's raw objects can be freed: its instance is current and hasn't trapped.
+
+##### Returns
+
+`boolean`
+
+#### Inherited from
+
+`Handle.owned`
+
+## Methods
+
+### \[dispose\]()
+
+> **\[dispose\]**(): `void`
+
+Frees the handle at the end of a `using` block (an alias of `free()`).
+
+#### Returns
+
+`void`
+
+#### Inherited from
+
+`Handle.[dispose]`
+
+***
+
+### assertLive()
+
+> `protected` **assertLive**(): `void`
+
+#### Returns
+
+`void`
+
+#### Throws
+
+[LaminaPdfError](LaminaPdfError.md) `disposed` after `free()` (here or on the parent);
+  `instance-reset` when the instance was replaced (a trapped one is replaced first).
+
+#### Inherited from
+
+`Handle.assertLive`
+
+***
+
+### attach()
+
+> **attach**(`name`, `bytes`, `mime`, `options?`): `this`
+
+Attaches a file: PDF/A-3b's associated files, such as an e-invoice's XML. The same name
+again replaces the file. PDF/A-2b and PDF/A-2u refuse attachments at [Builder.finish](#finish),
+and every PDF/A profile refuses one without a MIME type there.
+
+#### Parameters
+
+##### name
+
+`string`
+
+the file name viewers show.
+
+##### bytes
+
+`Uint8Array`
+
+the file's contents.
+
+##### mime
+
+`string`
+
+its MIME type, such as `text/xml`.
+
+##### options?
+
+`AttachmentInit`
+
+how the file relates to the document (`relationship`, default
+  `unspecified`), its `description` and `modDate`.
+
+#### Returns
+
+`this`
+
+#### Throws
+
+[LaminaPdfError](LaminaPdfError.md) `invalid-argument` for a `modDate` that isn't a PDF date,
+  `unknown-option` for an unknown key, `builder-finished` after [Builder.finish](#finish).
+
+***
+
+### call()
+
+> `protected` **call**\<`T`\>(`f`): `T`
+
+Runs `f` (calls into the glue) on this live handle; see Instance.call.
+
+#### Type Parameters
+
+##### T
+
+`T`
+
+#### Parameters
+
+##### f
+
+(`glue`) => `T`
+
+#### Returns
+
+`T`
+
+#### Inherited from
+
+`Handle.call`
+
+***
+
+### destination()
+
+> **destination**(`name`, `index`, `fit?`): `this`
+
+Defines the named destination `name`: page `index`, shown as `fit` (default: the page).
+
+#### Parameters
+
+##### name
+
+`string`
+
+##### index
+
+`number`
+
+##### fit?
+
+`FitInit`
+
+#### Returns
+
+`this`
+
+***
+
+### finish()
+
+> **finish**(): [`Document`](Document.md)
+
+Writes fonts, links, the page tree, outline and metadata; the builder (and its unfinished
+pages) take no more calls afterwards.
+
+#### Returns
+
+[`Document`](Document.md)
+
+the new document (unsaved; its save is a full rewrite).
+
+#### Throws
+
+[LaminaPdfError](LaminaPdfError.md) `page-index-out-of-range`, `unknown-destination`,
+  `invalid-page-labels`, `invalid-geometry`, `subset-failed`, `builder-finished`; under a
+  profile (`profiles` in the options), the first rule the document breaks, with that rule's
+  code (the error reference lists them, from `profile-version-conflict` on).
+
+***
+
+### font()
+
+> **font**(`font`): [`FontInfo`](../interfaces/FontInfo.md)
+
+Registers `font` with this builder (otherwise it is registered at first use).
+
+#### Parameters
+
+##### font
+
+[`Font`](Font.md)
+
+#### Returns
+
+[`FontInfo`](../interfaces/FontInfo.md)
+
+#### Throws
+
+[LaminaPdfError](LaminaPdfError.md) `text-module-not-loaded`, `invalid-font`, `font-not-embeddable`.
+
+***
+
+### free()
+
+> **free**(): `void`
+
+Frees the handle's memory now; without it, the garbage collector frees it later. A second
+call does nothing, and any other call afterwards throws `disposed`. Prefer `using`, which
+calls this at the end of the block.
+
+#### Returns
+
+`void`
+
+#### Inherited from
+
+`Handle.free`
+
+***
+
+### lang()
+
+> **lang**(`tag`): `this`
+
+The natural language (`/Lang`), a BCP 47 tag.
+
+#### Parameters
+
+##### tag
+
+`string`
+
+#### Returns
+
+`this`
+
+***
+
+### metadata()
+
+> **metadata**(`metadata`): `this`
+
+The metadata, written as the Info dictionary and an XMP packet.
+
+#### Parameters
+
+##### metadata
+
+`MetadataInit`
+
+#### Returns
+
+`this`
+
+***
+
+### outline()
+
+> **outline**(`entries`): `string`[]
+
+Adds outline (bookmark) items with their children.
+
+#### Parameters
+
+##### entries
+
+readonly `OutlineEntryInit`[]
+
+#### Returns
+
+`string`[]
+
+their IDs, in pre-order.
+
+***
+
+### page()
+
+> **page**(`size?`): [`Page`](Page.md)
+
+A new page of a named size or `[width, height]` in points.
+
+#### Parameters
+
+##### size?
+
+[`PageSizeName`](../type-aliases/PageSizeName.md) \| readonly \[`number`, `number`\] = `"A4"`
+
+#### Returns
+
+[`Page`](Page.md)
+
+***
+
+### pageLabels()
+
+> **pageLabels**(`ranges`): `this`
+
+The page labels (`i, ii, 1, 2…`), ranges by first page; checked at finish.
+
+#### Parameters
+
+##### ranges
+
+readonly `PageLabelInit`[]
+
+#### Returns
+
+`this`
+
+***
+
+### release()
+
+> `protected` **release**(): `void`
+
+Frees the WebAssembly side; called at most once, and only while [owned](#owned).
+
+#### Returns
+
+`void`
+
+#### Overrides
+
+`Handle.release`
+
+***
+
+### viewerPreferences()
+
+> **viewerPreferences**(`preferences`): `this`
+
+How viewers present the document when it opens.
+
+#### Parameters
+
+##### preferences
+
+`ViewerPreferencesInit`
+
+#### Returns
+
+`this`
+
+***
+
+### create()
+
+> `static` **create**(`options?`): `Builder`
+
+As `new Builder(options)`.
+
+#### Parameters
+
+##### options?
+
+[`BuilderOptions`](../interfaces/BuilderOptions.md)
+
+#### Returns
+
+`Builder`