@laminapdf/wasm 0.2.0-alpha.6 → 0.3.0

package/dist/lamina_pdf_extract.d.ts

@@ -44,11 +44,146 @@ export type PageLinkJs = {
 } & LinkToJs;
 
 
+/**
+ * A bookmark's look: its colour (`/C`; `None` is the viewer's default, black) and type style
+ * (`/F`: bit 1 italic, bit 2 bold).
+ *
+ * Added in 0.3.0.
+ */
+export interface OutlineStyle {
+    /**
+     * The colour.
+     */
+    color?: string | null;
+    /**
+     * Bold.
+     */
+    bold?: boolean;
+    /**
+     * Italic.
+     */
+    italic?: boolean;
+}
+
+/**
+ * A change a signature's restriction forbids.
+ */
+export interface ViolationJs {
+    /**
+     * The kind of change.
+     */
+    class: ModificationClass;
+    /**
+     * `docMdp`, `fieldMdp`, `usageRights`, `signedBytes` or `signedWidget`.
+     */
+    restriction: string;
+    /**
+     * The certification's `/P` (1, 2 or 3), for a `docMdp` restriction.
+     */
+    permission?: number;
+    /**
+     * The signature that carries the restriction.
+     */
+    signature: SignatureJs;
+    /**
+     * The form field whose widget a page edit deletes or reshows (its ID), for a
+     * `signedWidget` restriction or a `fieldMdp` one that a page edit breaks.
+     */
+    field?: string;
+}
+
+/**
+ * A colour of 8 bits a channel, `"#rrggbb"` on the wire. A bookmark's `/C` (§12.3.3,
+ * Table 151) holds it as three numbers from 0 to 1.
+ *
+ * Added in 0.3.0.
+ */
+export type Rgb = string;
+
+/**
+ * A conformance claim the document's metadata no longer meets.
+ *
+ * Added in 0.2.0.
+ */
+export type ConformanceWarning = { code: "pdfa-one-author"; authors: number } | { code: "pdfua-title-missing" } | { code: "pdfa-info-mismatch"; keys: MetadataKey[] } | { code: "duplicate-tags-incomplete" } | { code: "imported-tags-dropped" } | { code: "imported-pdfa-unchecked" };
+
 /**
  * A conformance profile.
  */
 export type ProfileInit = "PDF/UA-1" | "PDF/A-2b" | "PDF/A-2u" | "PDF/A-3b";
 
+/**
+ * A document's metadata as one record, read from the Info dictionary and the XMP packet.
+ *
+ * When the two disagree, the values come from the XMP packet in a PDF 2.0 file (ISO 32000-2
+ * §14.3.3 deprecates the Info entries) or a file that claims PDF/A (whose packet is
+ * authoritative, ISO 19005-2 §6.6.2.3.1), and otherwise from the side whose modification date
+ * is newer, Info winning a tie. A field the winning side lacks is taken from the other.
+ * [`disagreements`](DocumentMetadata::disagreements) names the fields where the two differ, so
+ * a properties view can say so.
+ *
+ * Added in 0.2.0.
+ */
+export interface DocumentMetadata {
+    /**
+     * The title.
+     */
+    title?: string;
+    /**
+     * The authors, in order (Info's `/Author` split at `;`).
+     */
+    authors: string[];
+    /**
+     * The subject.
+     */
+    subject?: string;
+    /**
+     * The keywords.
+     */
+    keywords?: string;
+    /**
+     * The application the content came from.
+     */
+    creator?: string;
+    /**
+     * The application that wrote the PDF.
+     */
+    producer?: string;
+    /**
+     * The creation date (a PDF date string on the wire).
+     */
+    created?: string;
+    /**
+     * The modification date.
+     */
+    modified?: string;
+    /**
+     * Which side the values come from.
+     */
+    source: MetadataSource;
+    /**
+     * The fields where Info and XMP hold different values.
+     */
+    disagreements: MetadataKey[];
+    /**
+     * What `/Metadata` holds.
+     */
+    packet: PacketStatus;
+    /**
+     * The PDF/A part and conformance the packet claims (`pdfaid:`), e.g. `"2B"`.
+     */
+    pdfa?: string;
+    /**
+     * The PDF/UA part the packet claims (`pdfuaid:part`).
+     */
+    pdfua?: number;
+    /**
+     * In a PDF 2.0 file, the Info entries besides the two dates: deprecated, kept as they
+     * were for older readers, and never written by an edit.
+     */
+    keptInfoKeys: MetadataKey[];
+}
+
 /**
  * A document's properties, for a properties view.
  */
@@ -193,12 +328,33 @@ export interface RegionInit {
  * ```
  *
  * [ADR 0006]: https://github.com/laudebugs/laminapdf/blob/main/docs/decisions/0006-op-log-and-undo.md
+ *
+ * Added in 0.2.0.
  */
 export interface OpLog {
     v: 1;
     ops: Op[];
 }
 
+/**
+ * A metadata field Lamina PDF keeps in step in the Info dictionary and the XMP packet: what
+ * [`RemoveMetadata`] removes and [`DocumentMetadata::disagreements`] names.
+ *
+ * | Key | Info | XMP |
+ * | --- | --- | --- |
+ * | `title` | `/Title` | `dc:title` |
+ * | `authors` | `/Author` (joined with `; `) | `dc:creator` |
+ * | `subject` | `/Subject` | `dc:description` |
+ * | `keywords` | `/Keywords` | `pdf:Keywords` |
+ * | `creator` | `/Creator` | `xmp:CreatorTool` |
+ * | `producer` | `/Producer` | `pdf:Producer` |
+ * | `created` | `/CreationDate` | `xmp:CreateDate` |
+ * | `modified` | `/ModDate` | `xmp:ModifyDate` |
+ *
+ * Added in 0.2.0.
+ */
+export type MetadataKey = "title" | "authors" | "subject" | "keywords" | "creator" | "producer" | "created" | "modified";
+
 /**
  * A model result the job waits for.
  */
@@ -243,6 +399,32 @@ export interface ModelInfoInit {
     licence: string;
 }
 
+/**
+ * A move in user space (ISO 32000-2 §8.3.2.3: y up), in user-space units. Both distances are
+ * finite: [`Offset::new`] and the wire form refuse anything else, so a move never writes a
+ * coordinate a PDF can't hold.
+ *
+ * Added in 0.3.0.
+ */
+export interface Offset {
+    dx: number;
+    dy: number;
+}
+
+/**
+ * A named destination brought in under another name.
+ */
+export interface RenamedDestinationJs {
+    /**
+     * Its name in the source.
+     */
+    from: string;
+    /**
+     * Its name in this document.
+     */
+    to: string;
+}
+
 /**
  * A page and how to show it.
  */
@@ -257,16 +439,83 @@ export interface TargetJs {
     view: TargetViewJs;
 }
 
+/**
+ * A page of this document and how to show it: what `/Dest [page /XYZ …]` holds.
+ *
+ * Added in 0.3.0.
+ */
+export interface ExplicitDestination {
+    /**
+     * The page.
+     */
+    page: string;
+    /**
+     * How to show it.
+     */
+    view: DestinationView;
+}
+
 /**
  * A page-label numbering style.
  */
 export type LabelStyleInit = "decimal" | "upperRoman" | "lowerRoman" | "upperLetters" | "lowerLetters";
 
+/**
+ * A patch of the window entries of `/ViewerPreferences` ([`WindowPreferences`]): each field
+ * left out keeps what the file has, `true` sets the entry, `false` removes it.
+ *
+ * Added in 0.3.0.
+ */
+export interface WindowPreferencesPatch {
+    /**
+     * `/HideToolbar`.
+     */
+    hideToolbar?: boolean;
+    /**
+     * `/HideMenubar`.
+     */
+    hideMenubar?: boolean;
+    /**
+     * `/HideWindowUI`.
+     */
+    hideWindowUi?: boolean;
+    /**
+     * `/FitWindow`.
+     */
+    fitWindow?: boolean;
+    /**
+     * `/CenterWindow`.
+     */
+    centerWindow?: boolean;
+    /**
+     * `/DisplayDocTitle`.
+     */
+    displayDocTitle?: boolean;
+}
+
 /**
  * A region's kind.
  */
 export type RegionLabelName = "text" | "title" | "section-header" | "list-item" | "table" | "picture" | "caption" | "footnote" | "formula" | "page-header" | "page-footer" | "other";
 
+/**
+ * A signature the planner found.
+ */
+export interface SignatureJs {
+    /**
+     * `approval`, `certification`, `docTimeStamp` or `usageRights`.
+     */
+    kind: string;
+    /**
+     * The signature field's ID, when a field holds it.
+     */
+    field?: string;
+    /**
+     * The 1-based revision the signature closes, when known.
+     */
+    revision?: number;
+}
+
 /**
  * A step's progress, and the model result the job waits for, if any.
  */
@@ -289,6 +538,60 @@ export interface ExtractProgressJs {
     request?: ModelRequestJs;
 }
 
+/**
+ * Adds a bookmark under `parent` (`null`: the top level) at `at`, with its title, target and
+ * style. It has no children, so it has no open state yet (`/Count`, §12.3.3): set it with
+ * [`UpdateOutlineItem::open`] once it has some. The new item's ID is in
+ * [`Applied::created_outline_items`](crate::Applied::created_outline_items).
+ *
+ * On the wire: `{ "op": "addOutlineItem", "args": { "parent": null, "at": "last", "title":
+ * "Chapter 1", "target": { "destination": { "page": "p3.0", "view": { "kind": "fit" } } } } }`.
+ *
+ * Added in 0.3.0.
+ */
+export interface AddOutlineItem {
+    /**
+     * The parent item; `None` for the top level.
+     */
+    parent?: string | null;
+    /**
+     * Where among the parent's children.
+     */
+    at: "first" | "last" | { before: string } | { after: string };
+    /**
+     * The title.
+     */
+    title: string;
+    /**
+     * Where the bookmark goes.
+     */
+    target: OutlineTarget;
+    /**
+     * Its colour and type style.
+     */
+    style?: OutlineStyle;
+}
+
+/**
+ * Adds a named destination, or points an existing one at `destination`. A name the catalog's
+ * `/Dests` dictionary holds stays there; any other goes into the `/Names /Dests` tree.
+ *
+ * On the wire: `{ "op": "setNamedDestination", "args": { "name": "results", "destination": {
+ * "page": "p7.0", "view": { "kind": "fitH", "top": 700 } } } }`.
+ *
+ * Added in 0.3.0.
+ */
+export interface SetNamedDestination {
+    /**
+     * The name.
+     */
+    name: string;
+    /**
+     * Where it points.
+     */
+    destination: ExplicitDestination;
+}
+
 /**
  * An OCR word, its box as a region's.
  */
@@ -307,6 +610,47 @@ export interface WordInit {
     confidence: number;
 }
 
+/**
+ * An XMP property declared in a PDF/A file's extension schemas.
+ */
+export interface ExtensionPropertyJs {
+    /**
+     * The schema's namespace URI.
+     */
+    namespace: string;
+    /**
+     * The prefix the packet writes the namespace with.
+     */
+    prefix: string;
+    /**
+     * The property's local name.
+     */
+    name: string;
+    /**
+     * Its declared type, e.g. `Text` or `Seq Integer`.
+     */
+    valueType: string;
+}
+
+/**
+ * An annotation's own geometry, by `kind`; points are flat `[x, y, …]` lists in page space.
+ */
+export type GeometryJs = { kind: "none" } | { kind: "quads"; quads: number[] } | { kind: "ink"; strokes: number[][] } | { kind: "vertices"; points: number[] } | { kind: "line"; points: number[] } | { kind: "callout"; points: number[] };
+
+/**
+ * An article thread: its title and its parts in reading order.
+ */
+export interface ThreadJs {
+    /**
+     * Its title (document text), when it has one.
+     */
+    title?: string;
+    /**
+     * Its parts.
+     */
+    parts: ThreadPartJs[];
+}
+
 /**
  * An attached file's options.
  */
@@ -345,8 +689,149 @@ export interface AttachmentInit {
  * ```
  *
  * [ADR 0006]: https://github.com/laudebugs/laminapdf/blob/main/docs/decisions/0006-op-log-and-undo.md
+ *
+ * Added in 0.2.0.
+ */
+export type Op = { op: "setInfo"; args: SetInfo } | { op: "rotatePage"; args: RotatePage } | { op: "setMetadata"; args: SetMetadata } | { op: "removeMetadata"; args: RemoveMetadata } | { op: "setInitialView"; args: SetInitialView } | { op: "addOutlineItem"; args: AddOutlineItem } | { op: "updateOutlineItem"; args: UpdateOutlineItem } | { op: "moveOutlineItem"; args: MoveOutlineItem } | { op: "deleteOutlineItem"; args: DeleteOutlineItem } | { op: "setNamedDestination"; args: SetNamedDestination } | { op: "renameNamedDestination"; args: RenameNamedDestination } | { op: "deleteNamedDestination"; args: DeleteNamedDestination } | { op: "setXmpProperty"; args: SetXmpProperty } | { op: "removeXmpProperty"; args: RemoveXmpProperty } | { op: "replaceXmpPacket"; args: ReplaceXmpPacket } | { op: "insertBlankPages"; args: InsertBlankPages } | { op: "deletePages"; args: DeletePages } | { op: "movePages"; args: MovePages } | { op: "rotatePages"; args: RotatePages } | { op: "reversePages"; args: ReversePages } | { op: "duplicatePages"; args: DuplicatePages } | { op: "insertPagesFrom"; args: InsertPagesFrom } | { op: "replacePages"; args: ReplacePages } | { op: "mergeDocuments"; args: MergeDocuments } | { op: "updateAnnot"; args: UpdateAnnot } | { op: "deleteAnnot"; args: DeleteAnnot } | { op: "setPageLabels"; args: SetPageLabels };
+
+/**
+ * Changes a bookmark's title, target, style or open state. An absent field is left alone. A
+ * target held as another action (JavaScript, `Launch`, …) is replaced only when `target` is
+ * given; the item's other entries are kept.
+ *
+ * On the wire: `{ "op": "updateOutlineItem", "args": { "item": "o12.0", "title": "Results",
+ * "open": true } }`.
+ *
+ * Added in 0.3.0.
+ */
+export interface UpdateOutlineItem {
+    /**
+     * The item.
+     */
+    item: string;
+    /**
+     * A new title.
+     */
+    title?: string;
+    /**
+     * A new target.
+     */
+    target?: OutlineTarget;
+    /**
+     * A new style (colour and type style together).
+     */
+    style?: OutlineStyle;
+    /**
+     * Open (children shown) or closed; a bookmark without children has nowhere to keep it
+     * (`/Count`, §12.3.3), so it writes nothing there.
+     */
+    open?: boolean;
+}
+
+/**
+ * Changes an annotation's common and markup entries and moves it.
+ *
+ * An absent field leaves the entry alone and `null` removes it. `translate` moves `/Rect` and
+ * the subtype's geometry (`/QuadPoints`, `/InkList`, `/Vertices`, `/L`, `/CL`) and the
+ * annotation's Popup with it, and keeps the appearance, which §12.5.5 maps onto the new
+ * `/Rect`. A `Locked` annotation refuses everything but a change of its flags and its
+ * contents; a `LockedContents` one refuses a change of its contents (`annotation-locked`).
+ * Widgets and annotations stored as direct dictionaries are refused (`annotation-not-editable`).
+ *
+ * On the wire: `{ "op": "updateAnnot", "args": { "id": "a12.0", "contents": "Checked",
+ * "translate": { "dx": 0, "dy": -10 } } }`.
+ *
+ * Added in 0.3.0.
+ */
+export interface UpdateAnnot {
+    /**
+     * The annotation.
+     */
+    id: string;
+    /**
+     * `/Contents`: the comment, or the alternative description.
+     */
+    contents?: string | null;
+    /**
+     * `/T`: the author.
+     */
+    author?: string | null;
+    /**
+     * `/Subj`.
+     */
+    subject?: string | null;
+    /**
+     * `/M`, the modification date the edit writes.
+     */
+    modified?: string;
+    /**
+     * `/F`, all the flags at once (Table 167).
+     */
+    flags?: number;
+    /**
+     * A move in user space.
+     */
+    translate?: Offset;
+}
+
+/**
+ * Changes how the document asks to be shown when it opens. Each field is a patch: left out,
+ * it keeps what the file has; `null` removes the entry, so readers use their default; a value
+ * sets it.
+ *
+ * * `open`: the page and zoom to open at, written as an explicit destination in
+ *   `/OpenAction` (§12.3.2.2). An `/OpenAction` that is an action other than `GoTo`
+ *   (JavaScript, a named action, a link to another file) is never replaced or removed: the op
+ *   fails with [`Error::OpenActionNotDestination`].
+ * * `page_mode`, `page_layout`: the panel to show and how to lay the pages out.
+ * * `preferences`: the window entries of `/ViewerPreferences` (§12.2, Table 147); `true` sets
+ *   one, `false` removes it (its default), and other entries (`/Direction`, `/PrintScaling`, …)
+ *   are kept.
+ *
+ * When a value needs a later PDF version than the file declares (`UseAttachments` 1.6,
+ * `UseOC` and the two-page layouts 1.5, `/DisplayDocTitle` 1.4), the catalog's `/Version` is
+ * raised to it. The op is class [`Document`](crate::ModificationClass::Document) and touches no
+ * page.
+ *
+ * On the wire:
+ * `{ "op": "setInitialView", "args": { "open": { "page": "p12.0", "zoom": "fitWidth" },
+ * "pageMode": "outlines", "pageLayout": null, "preferences": { "displayDocTitle": true } } }`.
+ *
+ * ```
+ * use laminapdf_ops::{OpenAt, OpenZoom, SetInitialView, WindowPreferencesPatch};
+ * use laminapdf_model::PageMode;
+ *
+ * let op = SetInitialView::default()
+ *     .with_open(Some(OpenAt::new("p3.0".parse()?, OpenZoom::FitWidth)))
+ *     .with_page_mode(Some(PageMode::Outlines))
+ *     .with_preferences(WindowPreferencesPatch::default().with_display_doc_title(true));
+ * assert_eq!(
+ *     serde_json::to_string(&op)?,
+ *     r#"{"open":{"page":"p3.0","zoom":"fitWidth"},"pageMode":"outlines","preferences":{"displayDocTitle":true}}"#
+ * );
+ * # Ok::<(), Box<dyn std::error::Error>>(())
+ * ```
+ *
+ * Added in 0.3.0.
  */
-export type Op = { op: "setInfo"; args: SetInfo } | { op: "rotatePage"; args: RotatePage };
+export interface SetInitialView {
+    /**
+     * The page and zoom to open at.
+     */
+    open?: OpenAt | null;
+    /**
+     * The panel to show (`/PageMode`).
+     */
+    pageMode?: "none" | "outlines" | "thumbnails" | "fullScreen" | "optionalContent" | "attachments" | null;
+    /**
+     * How to lay the pages out (`/PageLayout`).
+     */
+    pageLayout?: "singlePage" | "oneColumn" | "twoColumnLeft" | "twoColumnRight" | "twoPageLeft" | "twoPageRight" | null;
+    /**
+     * The window entries of `/ViewerPreferences`.
+     */
+    preferences?: WindowPreferencesPatch;
+}
 
 /**
  * Changes to the Info dictionary's text entries. For each field, `None` leaves the entry
@@ -355,6 +840,8 @@ export type Op = { op: "setInfo"; args: SetInfo } | { op: "rotatePage"; args: Ro
  *
  * On the wire an absent field is left alone and `null` clears: `{ "title": "Report",
  * "author": null }`.
+ *
+ * Added in 0.2.0.
  */
 export interface InfoPatch {
     /**
@@ -384,116 +871,717 @@ export interface InfoPatch {
 }
 
 /**
- * Edits the Info dictionary: applies `patch` and, when `at` is given, sets `/ModDate` to it.
- * The date is part of the op, never read from a clock, so the same op gives the same bytes
- * everywhere (ADR 0006 §1).
+ * Changes to the document's metadata. For each field, `None` leaves it alone, `Some(None)`
+ * removes it and `Some(Some(value))` sets it, in Info and XMP alike.
+ *
+ * On the wire an absent field is left alone and `null` removes: `{ "title": "Report",
+ * "authors": ["Ada Lovelace", "Charles Babbage"], "keywords": null }`; dates are PDF date
+ * strings (`"D:20261110093000+01'00'"`).
+ *
+ * ```
+ * use laminapdf_ops::MetadataPatch;
+ *
+ * let patch = MetadataPatch::new().title(Some("Quarterly figures")).authors(&["Ada Lovelace", "Charles Babbage"]);
+ * assert_eq!(patch.authors, Some(Some(vec!["Ada Lovelace".to_owned(), "Charles Babbage".to_owned()])));
+ * assert_eq!(serde_json::to_string(&patch)?, r#"{"title":"Quarterly figures","authors":["Ada Lovelace","Charles Babbage"]}"#);
+ * # Ok::<(), serde_json::Error>(())
+ * ```
+ *
+ * Added in 0.2.0.
+ */
+export interface MetadataPatch {
+    /**
+     * `/Title`, `dc:title`.
+     */
+    title?: string | null;
+    /**
+     * `/Author` (joined with `; `), `dc:creator` (in order). An empty list removes them.
+     */
+    authors?: string[] | null;
+    /**
+     * `/Subject`, `dc:description`.
+     */
+    subject?: string | null;
+    /**
+     * `/Keywords`, `pdf:Keywords`.
+     */
+    keywords?: string | null;
+    /**
+     * `/Creator`, `xmp:CreatorTool`: the application the content came from.
+     */
+    creator?: string | null;
+    /**
+     * `/Producer`, `pdf:Producer`: the application that wrote the PDF.
+     */
+    producer?: string | null;
+    /**
+     * `/CreationDate`, `xmp:CreateDate`.
+     */
+    created?: string | null;
+    /**
+     * `/ModDate`, `xmp:ModifyDate`.
+     */
+    modified?: string | null;
+}
+
+/**
+ * Copies `pages` (each once, in the order given) to `at`. A copy shares its source's content
+ * streams and resources and shows what it shows, inherited attributes included (ISO 32000-2
+ * §7.7.3.4). Its annotations are new objects with a new `/NM`; a form field's widget becomes
+ * a new field named `<partial>#<n>` with its own value, and a signature's widget is not copied
+ * (both in [`Applied::fields`](crate::Applied::fields)). In a tagged document the copy gets
+ * its own `/StructParents` key and clones of the elements whose content lies only on its
+ * source; content of elements that span pages is left untagged and the copy is listed in
+ * [`Applied::tags_incomplete`](crate::Applied::tags_incomplete). Page labels continue the range
+ * each copy lands in.
+ *
+ * On the wire: `{ "op": "duplicatePages", "args": { "pages": ["p7.0"], "at": { "after": "p7.0" } } }`.
+ *
+ * Added in 0.3.0.
+ */
+export interface DuplicatePages {
+    /**
+     * The pages to copy.
+     */
+    pages: string[];
+    /**
+     * Where the copies go.
+     */
+    at: "start" | "end" | { before: string } | { after: string };
+}
+
+/**
+ * Copies pages of a source document into this one at `at`, in the order given (each once).
+ * The copies are new objects with new IDs, sharing nothing with the source. Their
+ * annotations point at them and get a new `/NM`; a link to a page that didn't come along is
+ * removed ([`Applied::links_removed`](crate::Applied::links_removed)), and the named
+ * destinations the others use come along, renamed `<name>#<n>` on a clash. Form fields join
+ * the form under their own names, or per [`Carry::fields`] when the name is taken
+ * ([`Applied::fields`](crate::Applied::fields)); signature fields are left off. The copies
+ * lose their tags ([`Applied::tags_dropped`](crate::Applied::tags_dropped)), page labels
+ * continue the range each copy lands in, and the document's version rises to the source's
+ * when that is newer.
+ *
+ * On the wire: `{ "op": "insertPagesFrom", "args": { "source": "<64 hex digits>", "pages":
+ * ["p3.0"], "at": "end" } }`, with `carry` optional.
+ *
+ * Added in 0.3.0.
+ */
+export interface InsertPagesFrom {
+    /**
+     * The source document.
+     */
+    source: string;
+    /**
+     * The source's pages to copy, by their IDs in the source.
+     */
+    pages: string[];
+    /**
+     * Where the copies go.
+     */
+    at: "start" | "end" | { before: string } | { after: string };
+    /**
+     * What comes along with the pages.
+     */
+    carry?: Carry;
+}
+
+/**
+ * Deletes `pages` (each once; unknown pages are an error). Outline items, links and `GoTo`
+ * actions on surviving pages, named destinations and `/OpenAction` that named a deleted page
+ * follow `references` ([`ReferencePolicy`]); structure elements whose content was all on
+ * deleted pages are removed with their `/ParentTree` entries, and the widgets on deleted pages
+ * leave the form (a field left with none leaves it too). The page objects stay in the file's
+ * earlier revisions. Deleting every page is [`Error::NoPagesLeft`].
+ *
+ * On the wire: `{ "op": "deletePages", "args": { "pages": ["p7.0"], "references": "retarget" } }`.
+ *
+ * Added in 0.3.0.
+ */
+export interface DeletePages {
+    /**
+     * The pages.
+     */
+    pages: string[];
+    /**
+     * What happens to destinations that name them; `retarget` when left out.
+     */
+    references?: ReferencePolicy;
+}
+
+/**
+ * Deletes a bookmark, and its children with it or moved up into its place.
+ *
+ * On the wire: `{ "op": "deleteOutlineItem", "args": { "item": "o12.0", "children":
+ * "promote" } }`.
+ *
+ * Added in 0.3.0.
+ */
+export interface DeleteOutlineItem {
+    /**
+     * The item.
+     */
+    item: string;
+    /**
+     * What happens to its children.
+     */
+    children: ChildItems;
+}
+
+/**
+ * Deletes a named destination, from both stores when both hold it. Its uses in this file are left as they are and reported
+ * ([`Applied::destination_uses`](crate::Applied::destination_uses)): a bookmark or link that
+ * names it no longer goes anywhere.
+ *
+ * On the wire: `{ "op": "deleteNamedDestination", "args": { "name": "draft-notes" } }`.
+ *
+ * Added in 0.3.0.
+ */
+export interface DeleteNamedDestination {
+    /**
+     * The name.
+     */
+    name: string;
+}
+
+/**
+ * Deletes an annotation with what belongs to it: its Popup, every reply whose `/IRT` chain
+ * reaches it, and, for a member of a group (`/RT /Group`, §12.5.6.2), the whole group, which
+ * is one unit. Chains are followed through cycles once. In a tagged document, the structure
+ * element's object reference to each deleted annotation is removed, and so is an element left
+ * with nothing in it. Each deleted object is freed.
+ *
+ * A `Locked` annotation is refused (`annotation-locked`), and so are widgets and direct
+ * dictionaries (`annotation-not-editable`). Deleting a Popup alone removes the `/Popup` entry
+ * that names it.
+ *
+ * On the wire: `{ "op": "deleteAnnot", "args": { "id": "a12.0" } }`.
+ *
+ * Added in 0.3.0.
+ */
+export interface DeleteAnnot {
+    /**
+     * The annotation.
+     */
+    id: string;
+}
+
+/**
+ * Edits the Info dictionary: applies `patch` and, when `at` is given, sets `/ModDate` to it.
+ *
+ * **Deprecated:** use [`SetMetadata`](crate::SetMetadata), which writes authors as a list and
+ * the dates, and edits files whose metadata is in XMP alone. `SetInfo` stays, with its v1 wire
+ * form (`setInfo`) and meaning, so op logs already written still apply (ADR 0006 §6). It now
+ * goes through the same writer, so a document's XMP packet, when it has one, changes with it.
+ * It adds a packet only to a PDF 2.0 file, where the fields other than the dates belong in XMP.
+ * The date is part of the op, never read from a clock, so the same op gives the same bytes
+ * everywhere (ADR 0006 §1).
  *
  * An Info dictionary written directly in the trailer, or missing, becomes a new indirect
  * object that the trailer's `/Info` points to (the first time the op changes something).
+ *
+ * Added in 0.2.0.
  */
 export interface SetInfo {
     /**
-     * The entries to set or clear.
+     * The entries to set or clear.
+     */
+    patch?: InfoPatch;
+    /**
+     * The modification date to record as `/ModDate`.
+     */
+    at?: string;
+}
+
+/**
+ * Edits the document's metadata: applies `patch` to the Info dictionary and the XMP packet
+ * together and, when `at` is given, records it as the modification date (`/ModDate`,
+ * `xmp:ModifyDate`) and as `xmp:MetadataDate`, unless the patch sets the modification date
+ * itself. The date is part of the op, never read from a clock (ADR 0006 §1).
+ *
+ * ```
+ * use laminapdf_ops::{MetadataPatch, Op, SetMetadata};
+ *
+ * let op = Op::from(SetMetadata::new(MetadataPatch::new().title(Some("Minutes")), Some("D:20261110093000Z".parse()?)));
+ * assert_eq!(
+ *     serde_json::to_string(&op)?,
+ *     r#"{"op":"setMetadata","args":{"patch":{"title":"Minutes"},"at":"D:20261110093000Z"}}"#
+ * );
+ * # Ok::<(), Box<dyn std::error::Error>>(())
+ * ```
+ *
+ * Added in 0.2.0.
+ */
+export interface SetMetadata {
+    /**
+     * The fields to set or remove.
+     */
+    patch?: MetadataPatch;
+    /**
+     * The modification date the edit writes.
+     */
+    at?: string;
+    /**
+     * Replace an XMP packet that can't be read with a new one, losing whatever it held.
+     * Without it, such a packet makes the op fail with `malformed-xmp`, so nothing is lost
+     * without the user saying so.
+     */
+    replaceMalformed?: boolean;
+}
+
+/**
+ * How [`RotatePages`] reads its angle.
+ *
+ * Added in 0.3.0.
+ */
+export type RotateMode = "set" | "turn";
+
+/**
+ * How [`images_to_pdf`] sizes its pages.
+ */
+export interface ImagesOptionsInit {
+    /**
+     * Each page this size, `[width, height]` in points, turned the image's way, the image fitted
+     * inside the margins and centred. Without it, each page is its image's size at the image's
+     * resolution.
+     */
+    fit?: [number, number];
+    /**
+     * The space around each image, in points (0 by default).
+     */
+    margin?: number;
+    /**
+     * The resolution of an image whose file gives none, in dots per inch (72 by default).
+     */
+    defaultDpi?: number;
+    /**
+     * The new document's version, file ID, producer, creation date and compression.
+     */
+    build?: BuildOptionsInit;
+}
+
+/**
+ * How a destination shows its page (§12.3.2.2).
+ */
+export type FitInit = { type: "page" } | { type: "width"; top?: number } | { type: "height"; left?: number } | { type: "xyz"; left?: number; top?: number; zoom?: number } | { type: "rect"; x: number; y: number; width: number; height: number } | { type: "bounds" };
+
+/**
+ * How a destination shows its page (§12.3.2.2, Table 149), in the page's user space. A `None`
+ * coordinate keeps the viewer's current one (`null` in the file).
+ *
+ * Every number must be finite: the ops refuse any other with `view-not-finite`.
+ *
+ * Added in 0.3.0.
+ */
+export type DestinationView = { kind: "xyz"; left: number | undefined; top: number | undefined; zoom: number | undefined } | { kind: "fit" } | { kind: "fitH"; top: number | undefined } | { kind: "fitV"; left: number | undefined } | { kind: "fitR"; left: number; bottom: number; right: number; top: number } | { kind: "fitB" } | { kind: "fitBH"; top: number | undefined } | { kind: "fitBV"; left: number | undefined };
+
+/**
+ * How a document asks to be shown when it opens.
+ */
+export interface InitialViewJs {
+    /**
+     * Where it opens.
+     */
+    open: OpenTargetJs;
+    /**
+     * The panel to show; left out when the file leaves it to the reader.
+     */
+    pageMode?: "none" | "outlines" | "thumbnails" | "fullScreen" | "optionalContent" | "attachments";
+    /**
+     * How to lay the pages out; left out when the file leaves it to the reader.
+     */
+    pageLayout?: "singlePage" | "oneColumn" | "twoColumnLeft" | "twoColumnRight" | "twoPageLeft" | "twoPageRight";
+    /**
+     * The window's viewer preferences.
+     */
+    preferences: WindowPreferencesJs;
+}
+
+/**
+ * How a file is encrypted, and what its author permits.
+ */
+export interface EncryptionJs {
+    /**
+     * `/V`.
+     */
+    version: number;
+    /**
+     * `/R`.
+     */
+    revision: number;
+    /**
+     * The key length in bits.
+     */
+    keyBits: number;
+    /**
+     * The cipher streams use.
+     */
+    cipher: CipherJs;
+    /**
+     * What `/P` permits; absent when the handler gives no permissions.
+     */
+    permissions?: PermissionsJs;
+}
+
+/**
+ * How a merge brings in what the sources hold besides their pages.
+ *
+ * Added in 0.3.0.
+ */
+export interface MergeOptions {
+    /**
+     * What becomes of the sources' bookmarks; `perFile` when left out.
+     */
+    outline?: OutlineMerge;
+    /**
+     * What happens to a form field whose name is already used; `rename` when left out.
+     */
+    fields?: FieldClash;
+}
+
+/**
+ * How a save would go (`laminapdf::PlannedSave`).
+ */
+export interface PlannedSaveJs {
+    /**
+     * The mode the save resolves to; absent when it would be refused.
+     */
+    mode?: SaveModeJs;
+    /**
+     * The code the save would be refused with.
+     */
+    refusal?: string;
+    /**
+     * `free`, `appendOnly`, `requiresRewrite` or `conflict`.
+     */
+    constraint: string;
+    /**
+     * Every signature, in the order found.
+     */
+    signatures: SignatureJs[];
+    /**
+     * The certification's `/P` (1, 2 or 3), when the document is certified.
+     */
+    docMdp?: number;
+    /**
+     * Why only a full rewrite is safe: `repairedBase`, `encryptedBase`, `noBase`,
+     * `opRequiresRewrite`.
+     */
+    rewriteReasons: string[];
+    /**
+     * The pending changes a signature's restriction forbids.
+     */
+    violations: ViolationJs[];
+    /**
+     * The signatures the save would invalidate (only with `invalidateSignatures`).
+     */
+    wouldInvalidate: SignatureJs[];
+    /**
+     * Whether the save writes an encrypted document as plaintext.
+     */
+    removesEncryption: boolean;
+    /**
+     * What the save does with the save-time metadata: `none`, `stamp` or `skipped`.
+     */
+    metadata: string;
+    /**
+     * Whether an edit to save rewrote the XMP packet whole.
+     */
+    packetRewritten: boolean;
+    /**
+     * The PDF/A and PDF/UA claims the edited metadata breaks (warnings that never block).
+     */
+    conformanceWarnings: Diagnostic[];
+    /**
+     * The document has no changes.
+     */
+    unchanged: boolean;
+}
+
+/**
+ * How a target shows its page, in page space; an unset coordinate is left out.
+ */
+export type TargetViewJs = { kind: "at"; x?: number; y?: number; zoom?: number } | { kind: "fit" } | { kind: "fit-width"; y?: number } | { kind: "fit-height"; x?: number } | { kind: "fit-rect"; x0: number; y0: number; x1: number; y1: number };
+
+/**
+ * How a viewer lays pages out.
+ */
+export type PageLayoutInit = "singlePage" | "oneColumn" | "twoColumnLeft" | "twoColumnRight" | "twoPageLeft" | "twoPageRight";
+
+/**
+ * How an attached file relates to the document (`/AFRelationship`).
+ */
+export type AfRelationshipInit = "source" | "data" | "alternative" | "supplement" | "unspecified";
+
+/**
+ * How an undo or redo went (`laminapdf::UndoOutcome`).
+ */
+export type UndoOutcomeJs = "applied" | "partial" | "skipped";
+
+/**
+ * How the Markdown is cut into chunks.
+ */
+export interface ChunkInit {
+    /**
+     * A chunk's budget in approximate tokens (characters / 4); 512 by default.
+     */
+    maxTokens?: number;
+    /**
+     * Approximate tokens of whole blocks repeated from the chunk before; 0 by default.
+     */
+    overlap?: number;
+    /**
+     * Where chunks may start; `"headings"` by default.
+     */
+    splitOn?: SplitOnName;
+}
+
+/**
+ * How viewers present the document when it opens.
+ */
+export interface ViewerPreferencesInit {
+    /**
+     * Show the title, not the file name.
+     */
+    displayDocTitle?: boolean;
+    /**
+     * The panel shown.
+     */
+    pageMode?: PageModeInit;
+    /**
+     * The page layout.
+     */
+    pageLayout?: PageLayoutInit;
+}
+
+/**
+ * Inserts `count` blank pages of `size` at `at`, each showing at `rotate`. Each new page
+ * gets a new object and [`PageId`] (ADR 0005 §5), an empty `/Resources` and no content; in
+ * a labelled document they continue the label range they land in. A count outside 1 to
+ * 10,000, or a side that isn't above 0 and at most 14,400 points, is
+ * [`Error::InvalidOp`](crate::Error::InvalidOp).
+ *
+ * On the wire: `{ "op": "insertBlankPages", "args": { "at": { "after": "p3.0" }, "count": 2,
+ * "size": { "width": 612, "height": 792 }, "rotate": 0 } }`.
+ *
+ * Added in 0.3.0.
+ */
+export interface InsertBlankPages {
+    /**
+     * Where the pages go.
+     */
+    at: "start" | "end" | { before: string } | { after: string };
+    /**
+     * How many pages, at least 1.
+     */
+    count: number;
+    /**
+     * Their `/MediaBox` size, in points: `{ "width": 612, "height": 792 }`.
+     */
+    size: { width: number; height: number };
+    /**
+     * Their rotation in degrees clockwise: 0, 90, 180 or 270.
+     */
+    rotate: 0 | 90 | 180 | 270;
+}
+
+/**
+ * Merges source documents into this one at `at`, one after another, as one edit. Each
+ * source's pages come in as [`InsertPagesFrom`](crate::InsertPagesFrom) brings them (their
+ * annotations, links and the named destinations those use, form fields under the clash rule
+ * of `options.fields`, signature fields left off, tags dropped), and with them what belongs to
+ * the whole source:
+ *
+ * - its bookmarks, per `options.outline`, going to the copies of their pages; a bookmark whose
+ *   page didn't come along is left out unless one of its children came
+ *   ([`Applied::bookmarks_dropped`](crate::Applied::bookmarks_dropped));
+ * - its layers (optional content groups the copied pages use), added to this document's list
+ *   in the source's order and visible or hidden as the source showed them;
+ * - its page labels: each copy keeps the label it had in its source, and this document's
+ *   pages keep theirs (a document without labels numbers its pages from 1);
+ * - its form's default appearance and `/NeedAppearances`, and its PDF version when newer.
+ *
+ * Named destinations that clash are renamed `<name>#<n>`
+ * ([`Applied::renamed_destinations`](crate::Applied::renamed_destinations)).
+ *
+ * On the wire: `{ "op": "mergeDocuments", "args": { "sources": [{ "source": "<64 hex
+ * digits>" }], "at": "end" } }`, with each source's `pages` and `title`, and `options`,
+ * optional.
+ *
+ * Added in 0.3.0.
+ */
+export interface MergeDocuments {
+    /**
+     * The documents to bring in, in order.
+     */
+    sources: MergeSource[];
+    /**
+     * Where their pages go.
+     */
+    at: "start" | "end" | { before: string } | { after: string };
+    /**
+     * What comes along besides the pages.
+     */
+    options?: MergeOptions;
+}
+
+/**
+ * Moves `pages` to `to`. They keep their order among themselves (the order given, each page
+ * once) and their IDs; an anchor that is itself moved is replaced by the nearest page that
+ * stays.
+ *
+ * On the wire: `{ "op": "movePages", "args": { "pages": ["p7.0", "p8.0"], "to": "start" } }`.
+ *
+ * Added in 0.3.0.
+ */
+export interface MovePages {
+    /**
+     * The pages, in the order they take at `to`.
+     */
+    pages: string[];
+    /**
+     * Where they go.
+     */
+    to: "start" | "end" | { before: string } | { after: string };
+}
+
+/**
+ * Moves a bookmark, with its children, under `parent` (`null`: the top level) at `at`. The
+ * item keeps its ID.
+ *
+ * On the wire: `{ "op": "moveOutlineItem", "args": { "item": "o12.0", "parent": "o9.0", "at":
+ * { "after": "o10.0" } } }`.
+ *
+ * Added in 0.3.0.
+ */
+export interface MoveOutlineItem {
+    /**
+     * The item.
+     */
+    item: string;
+    /**
+     * The new parent; `None` for the top level.
+     */
+    parent?: string | null;
+    /**
+     * Where among the new parent's children.
+     */
+    at: "first" | "last" | { before: string } | { after: string };
+}
+
+/**
+ * Object numbering in a full rewrite.
+ */
+export type RenumberJs = "keep" | "compact";
+
+/**
+ * One annotation on a page, in page space.
+ */
+export interface PageAnnotationJs {
+    /**
+     * Its ID (`a12.0`), as `updateAnnot` and `deleteAnnot` take it.
+     */
+    id: string;
+    /**
+     * Its position in the page's `/Annots`.
+     */
+    index: number;
+    /**
+     * Its subtype as written (`Highlight`, `Text`, …).
+     */
+    subtype: string;
+    /**
+     * Its rectangle: `[x0, y0, x1, y1]`, top-left and bottom-right; left out when it has none.
+     */
+    rect?: [number, number, number, number];
+    /**
+     * `/Contents` (document text).
+     */
+    contents?: string;
+    /**
+     * `/NM` (document text), only a hint.
+     */
+    name?: string;
+    /**
+     * `/T`, the author.
+     */
+    author?: string;
+    /**
+     * `/Subj`.
+     */
+    subject?: string;
+    /**
+     * `/CreationDate` as stored.
      */
-    patch?: InfoPatch;
+    created?: string;
     /**
-     * The modification date to record as `/ModDate`.
+     * `/M` as stored.
      */
-    at?: string;
-}
-
-/**
- * How a destination shows its page (§12.3.2.2).
- */
-export type FitInit = { type: "page" } | { type: "width"; top?: number } | { type: "height"; left?: number } | { type: "xyz"; left?: number; top?: number; zoom?: number } | { type: "rect"; x: number; y: number; width: number; height: number } | { type: "bounds" };
-
-/**
- * How a file is encrypted, and what its author permits.
- */
-export interface EncryptionJs {
+    modified?: string;
     /**
-     * `/V`.
+     * `/F`, the flags.
      */
-    version: number;
+    flags: number;
     /**
-     * `/R`.
+     * `/C`: no components (transparent), one (gray), three (RGB) or four (CMYK).
      */
-    revision: number;
+    color: number[];
     /**
-     * The key length in bits.
+     * `/CA`, the opacity.
      */
-    keyBits: number;
+    opacity?: number;
     /**
-     * The cipher streams use.
+     * The ID of the annotation this one replies to or is grouped with.
      */
-    cipher: CipherJs;
+    inReplyTo?: string;
     /**
-     * What `/P` permits; absent when the handler gives no permissions.
+     * Whether `inReplyTo` is a group rather than a reply.
      */
-    permissions?: PermissionsJs;
-}
-
-/**
- * How a target shows its page, in page space; an unset coordinate is left out.
- */
-export type TargetViewJs = { kind: "at"; x?: number; y?: number; zoom?: number } | { kind: "fit" } | { kind: "fit-width"; y?: number } | { kind: "fit-height"; x?: number } | { kind: "fit-rect"; x0: number; y0: number; x1: number; y1: number };
-
-/**
- * How a viewer lays pages out.
- */
-export type PageLayoutInit = "singlePage" | "oneColumn" | "twoColumnLeft" | "twoColumnRight" | "twoPageLeft" | "twoPageRight";
-
-/**
- * How an attached file relates to the document (`/AFRelationship`).
- */
-export type AfRelationshipInit = "source" | "data" | "alternative" | "supplement" | "unspecified";
-
-/**
- * How an undo or redo went (`laminapdf::UndoOutcome`).
- */
-export type UndoOutcomeJs = "applied" | "partial" | "skipped";
-
-/**
- * How the Markdown is cut into chunks.
- */
-export interface ChunkInit {
+    grouped: boolean;
     /**
-     * A chunk's budget in approximate tokens (characters / 4); 512 by default.
+     * The ID of its Popup.
      */
-    maxTokens?: number;
+    popup?: string;
     /**
-     * Approximate tokens of whole blocks repeated from the chunk before; 0 by default.
+     * For a Popup, the ID of the annotation it belongs to.
      */
-    overlap?: number;
+    parent?: string;
     /**
-     * Where chunks may start; `"headings"` by default.
+     * Whether it has a normal appearance stream.
      */
-    splitOn?: SplitOnName;
+    hasAppearance: boolean;
+    /**
+     * Whether it has rich-text contents.
+     */
+    hasRichText: boolean;
+    /**
+     * The subtype's own geometry, as flat `[x, y, …]` lists in page space.
+     */
+    geometry: GeometryJs;
 }
 
 /**
- * How viewers present the document when it opens.
+ * One document a merge brings in.
+ *
+ * Added in 0.3.0.
  */
-export interface ViewerPreferencesInit {
+export interface MergeSource {
     /**
-     * Show the title, not the file name.
+     * The source document, added with [`Document::add_source`](crate::Document::add_source).
      */
-    displayDocTitle?: boolean;
+    source: string;
     /**
-     * The panel shown.
+     * The source's pages to bring in, by their IDs in the source, in order; all of them when
+     * left out.
      */
-    pageMode?: PageModeInit;
+    pages?: string[];
     /**
-     * The page layout.
+     * The name of the bookmark [`OutlineMerge::PerFile`] gives the source's bookmarks (a file
+     * name, say); the source's own title when left out.
      */
-    pageLayout?: PageLayoutInit;
+    title?: string;
 }
 
-/**
- * Object numbering in a full rewrite.
- */
-export type RenumberJs = "keep" | "compact";
-
 /**
  * One element of the structure tree (`laminapdf::StructureNode`; its strings are document text).
  */
@@ -520,6 +1608,14 @@ export interface StructureNodeJs {
     kids: StructureKidJs[];
 }
 
+/**
+ * One entry of a language alternative, under the name TypeScript gives it.
+ */
+export interface XmpLangText {
+    lang: string;
+    text: string;
+}
+
 /**
  * One font the document uses.
  */
@@ -546,6 +1642,20 @@ export interface FontJs {
     encoding?: EncodingJs;
 }
 
+/**
+ * One named destination and where it goes.
+ */
+export interface NamedDestinationJs {
+    /**
+     * The name.
+     */
+    name: string;
+    /**
+     * Where it goes, when it names a page of this document.
+     */
+    target?: TargetJs;
+}
+
 /**
  * One outline item and its children.
  */
@@ -584,6 +1694,10 @@ export interface OutlineEntryInit {
  * One outline item.
  */
 export interface OutlineNodeJs {
+    /**
+     * Its ID (`o12.0`), which the outline ops take.
+     */
+    id: string;
     /**
      * Its title (document text).
      */
@@ -596,6 +1710,30 @@ export interface OutlineNodeJs {
      * Where it goes, when its destination names a page of this document.
      */
     target?: TargetJs;
+    /**
+     * The named destination it goes to, when it names one.
+     */
+    destinationName?: string;
+    /**
+     * The web address it opens, when it has one.
+     */
+    uri?: string;
+    /**
+     * Its action's type when that is neither `GoTo` nor `URI` (`JavaScript`, `Launch`, …).
+     */
+    otherAction?: string;
+    /**
+     * Its colour as `"#rrggbb"`, when it isn't the default black.
+     */
+    color?: string;
+    /**
+     * Shown in bold.
+     */
+    bold: boolean;
+    /**
+     * Shown in italic.
+     */
+    italic: boolean;
     /**
      * Its children, in order.
      */
@@ -654,6 +1792,73 @@ export interface PageLabelInit {
     first?: number;
 }
 
+/**
+ * One part of an article thread.
+ */
+export interface ThreadPartJs {
+    /**
+     * The page's 0-based index; left out when the part names a page the document lacks.
+     */
+    page?: number;
+    /**
+     * Its rectangle, `[x0, y0, x1, y1]` in page space; left out when unreadable.
+     */
+    rect?: [number, number, number, number];
+}
+
+/**
+ * One range of [`SetPageLabels`]: the labels from `page` up to the next range's page.
+ *
+ * Added in 0.3.0.
+ */
+export interface PageLabelRange {
+    /**
+     * The range's first page.
+     */
+    page: string;
+    /**
+     * The numbering style; without one, each label is the prefix alone. On the wire:
+     * `decimal`, `upperRoman`, `lowerRoman`, `upperLetters` or `lowerLetters`.
+     */
+    style?: "decimal" | "upperRoman" | "lowerRoman" | "upperLetters" | "lowerLetters";
+    /**
+     * Text before each number (`A-` in `A-1`).
+     */
+    prefix?: string;
+    /**
+     * The number of the range's first page, 1 or more (a `u32`, as the builder's page labels
+     * take).
+     */
+    first?: number;
+}
+
+/**
+ * One reference to a deleted page and what the deletion did to it.
+ */
+export interface ReferenceEditJs {
+    /**
+     * The deleted page it named.
+     */
+    page: string;
+    /**
+     * `outlineItem`, `link`, `namedDestination`, `openAction`, `structureElement`,
+     * `structureKid` or `widget`.
+     */
+    kind: "outlineItem" | "link" | "namedDestination" | "openAction" | "structureElement" | "structureKid" | "widget";
+    /**
+     * The named destination's name, for a `namedDestination`.
+     */
+    name?: string;
+    /**
+     * `retargeted` or `removed`.
+     */
+    outcome: "retargeted" | "removed";
+    /**
+     * The surviving page it now names, when retargeted.
+     */
+    to?: string;
+}
+
 /**
  * One text run (`laminapdf::extract::PageTextRun`): glyphs of one font, size, direction and marked
  * content on one baseline, in logical order.
@@ -821,17 +2026,237 @@ export interface SaveOptionsInit {
      */
     removeEncryption?: boolean;
     /**
-     * What an incremental save returns.
+     * What an incremental save returns.
+     */
+    output?: OutputJs;
+    /**
+     * Numbering in a full rewrite.
+     */
+    renumber?: RenumberJs;
+    /**
+     * The cross-reference form.
+     */
+    xref?: XrefJs;
+    /**
+     * When the save happens, as the app's clock reads it: a PDF date (`D:20261110093000Z`)
+     * or an ISO 8601 date-time. A save that writes changes stamps it as the modification and
+     * metadata dates and gives the XMP packet a new instance ID.
+     */
+    metadataDate?: string;
+    /**
+     * The XMP instance ID the save writes, a UUID (`uuid:` optional); without it, one is
+     * derived from the content.
+     */
+    instanceId?: string;
+}
+
+/**
+ * Removes an XMP property, every copy of it in the packet; a property the Info dictionary
+ * mirrors is removed from both. The value stays in the file's earlier revisions until a full
+ * rewrite ([`Applied::still_in_earlier_revisions`](crate::Applied::still_in_earlier_revisions)).
+ *
+ * ```
+ * use laminapdf_ops::{Op, RemoveXmpProperty};
+ *
+ * let op = Op::from(RemoveXmpProperty::new("http://example.com/ns/", "batch"));
+ * assert_eq!(
+ *     serde_json::to_string(&op)?,
+ *     r#"{"op":"removeXmpProperty","args":{"namespace":"http://example.com/ns/","name":"batch"}}"#
+ * );
+ * # Ok::<(), serde_json::Error>(())
+ * ```
+ *
+ * Added in 0.3.0.
+ */
+export interface RemoveXmpProperty {
+    /**
+     * The property's namespace URI.
+     */
+    namespace: string;
+    /**
+     * The property's local name.
+     */
+    name: string;
+    /**
+     * As [`SetMetadata::replace_malformed`](crate::SetMetadata::replace_malformed).
+     */
+    replaceMalformed?: boolean;
+}
+
+/**
+ * Removes metadata fields from the Info dictionary and the XMP packet; the packet's other
+ * properties stay (J.10).
+ *
+ * The values stay in the file's earlier revisions until a full rewrite: an incremental save
+ * appends the change and keeps the original bytes. When it removed anything, the op's result
+ * says so ([`Applied::still_in_earlier_revisions`](crate::Applied::still_in_earlier_revisions)),
+ * so the caller can offer a full rewrite (on a signed file, the override that removes the
+ * signatures).
+ *
+ * ```
+ * use laminapdf_ops::{MetadataKey, Op, RemoveMetadata};
+ *
+ * let op = Op::from(RemoveMetadata::new(vec![MetadataKey::Authors, MetadataKey::Creator]));
+ * assert_eq!(serde_json::to_string(&op)?, r#"{"op":"removeMetadata","args":{"keys":["authors","creator"]}}"#);
+ * # Ok::<(), serde_json::Error>(())
+ * ```
+ *
+ * Added in 0.2.0.
+ */
+export interface RemoveMetadata {
+    /**
+     * The fields to remove.
+     */
+    keys: MetadataKey[];
+    /**
+     * As [`SetMetadata::replace_malformed`].
+     */
+    replaceMalformed?: boolean;
+}
+
+/**
+ * Renames a named destination, keeping it where it is. With `links: follow` (the default) the
+ * bookmarks, links and `GoTo` actions of this file that name it are renamed too, in the form
+ * they named it in.
+ *
+ * On the wire: `{ "op": "renameNamedDestination", "args": { "from": "sec2", "to": "methods" } }`.
+ *
+ * Added in 0.3.0.
+ */
+export interface RenameNamedDestination {
+    /**
+     * The current name.
+     */
+    from: string;
+    /**
+     * The new name; no destination may have it yet.
+     */
+    to: string;
+    /**
+     * Whether the uses follow.
+     */
+    links?: RenameLinks;
+}
+
+/**
+ * Replaces pages of this document with pages of a source document, pair by pair: the first
+ * source page takes the first target's place, and so on. What pointed at a replaced page
+ * (outline items, links, named destinations, `GoTo` actions, `/OpenAction`) now points at
+ * the page that took its place, with the view `/Fit`, since coordinates on the old page mean
+ * nothing on the new one. Targets left over are deleted (their references retargeted to the
+ * nearest surviving page); source pages left over go after the last copy. The copies come
+ * in as with [`InsertPagesFrom`]; the replaced pages are deleted as with
+ * [`DeletePages`](crate::DeletePages), structure, widgets and earlier revisions included.
+ *
+ * On the wire: `{ "op": "replacePages", "args": { "targets": ["p7.0"], "source": "<64 hex
+ * digits>", "pages": ["p3.0"] } }`, with `carry` optional.
+ *
+ * Added in 0.3.0.
+ */
+export interface ReplacePages {
+    /**
+     * The pages to replace, in order.
+     */
+    targets: string[];
+    /**
+     * The source document.
+     */
+    source: string;
+    /**
+     * The source's pages that take their places, by their IDs in the source.
+     */
+    pages: string[];
+    /**
+     * What comes along with the pages.
+     */
+    carry?: Carry;
+}
+
+/**
+ * Replaces the document's page labels with `ranges`; an empty list removes them, so viewers
+ * show page numbers again.
+ *
+ * Each range starts at a page, named by its ID, and labels that page and the ones after it up
+ * to the next range. The ranges must be in page order, two never on one page, the first on
+ * the document's first page (the number tree must have an entry for page 0, §12.4.2), and
+ * each numbered from 1 or more; otherwise the op fails with `invalid-label-ranges`. Nothing
+ * is written when the catalog already holds exactly these labels
+ * ([`PageLabels::is_written`]); any other tree, a damaged one included, is replaced.
+ *
+ * On the wire:
+ * `{ "op": "setPageLabels", "args": { "ranges": [{ "page": "p3.0", "style": "lowerRoman" }] } }`.
+ *
+ * Added in 0.3.0.
+ */
+export interface SetPageLabels {
+    /**
+     * The ranges, in page order.
+     */
+    ranges: PageLabelRange[];
+}
+
+/**
+ * Replaces the whole XMP packet with `xml`, for what the property ops can't write
+ * (structures, qualifiers, comments). The packet is parsed before it applies and refused if it
+ * doesn't parse (`invalid-xmp-packet`) or changes the PDF/A or PDF/UA identification
+ * (`xmp-claim-read-only`). Info's mirrored entries follow the new packet; in a file that
+ * claims PDF/A, the extension schema entries its properties lack are added and reported
+ * ([`Applied::declared`](crate::Applied::declared)). The old packet stays in the file's
+ * earlier revisions until a full rewrite.
+ *
+ * ```
+ * use laminapdf_ops::{Op, ReplaceXmpPacket};
+ *
+ * let op = Op::from(ReplaceXmpPacket::new("<x:xmpmeta xmlns:x=\"adobe:ns:meta/\">…</x:xmpmeta>"));
+ * assert!(serde_json::to_string(&op)?.starts_with(r#"{"op":"replaceXmpPacket","args":{"xml":"<x:xmpmeta"#));
+ * # Ok::<(), serde_json::Error>(())
+ * ```
+ *
+ * Added in 0.3.0.
+ */
+export interface ReplaceXmpPacket {
+    /**
+     * The new packet's XML, with or without its `<?xpacket … ?>` wrapper.
+     */
+    xml: string;
+}
+
+/**
+ * Reverses the order of `pages` within the places they hold: the first of them (in page
+ * order) takes the last one's place, and so on; the other pages don't move.
+ *
+ * On the wire: `{ "op": "reversePages", "args": { "pages": ["p3.0", "p4.0", "p5.0"] } }`.
+ *
+ * Added in 0.3.0.
+ */
+export interface ReversePages {
+    /**
+     * The pages; their order here doesn't matter.
+     */
+    pages: string[];
+}
+
+/**
+ * Rotates `pages` by `angle`, set or turned ([`RotateMode`]); each page as
+ * [`RotatePage`] does, keeping its object and [`PageId`].
+ *
+ * On the wire: `{ "op": "rotatePages", "args": { "pages": ["p3.0"], "angle": 90, "mode": "turn" } }`.
+ *
+ * Added in 0.3.0.
+ */
+export interface RotatePages {
+    /**
+     * The pages.
      */
-    output?: OutputJs;
+    pages: string[];
     /**
-     * Numbering in a full rewrite.
+     * The angle in degrees clockwise: 0, 90, 180 or 270.
      */
-    renumber?: RenumberJs;
+    angle: 0 | 90 | 180 | 270;
     /**
-     * The cross-reference form.
+     * Whether the angle is set or added; `set` when left out.
      */
-    xref?: XrefJs;
+    mode?: RotateMode;
 }
 
 /**
@@ -846,6 +2271,8 @@ export interface SaveOptionsInit {
  * On the wire: `{ "op": "rotatePage", "args": { "page": "p12.0", "rotate": 90 } }`.
  *
  * [ADR 0005]: https://github.com/laudebugs/laminapdf/blob/main/docs/decisions/0005-document-model.md
+ *
+ * Added in 0.2.0.
  */
 export interface RotatePage {
     /**
@@ -858,6 +2285,60 @@ export interface RotatePage {
     rotate: 0 | 90 | 180 | 270;
 }
 
+/**
+ * Sets any XMP property: text, a URI, a number, a boolean, a date, a language alternative,
+ * or an ordered or unordered array of simple values. A file without a packet gets one.
+ *
+ * `prefix` names the namespace when the packet binds no prefix to it. A property the Info
+ * dictionary mirrors (`dc:title`, `pdf:Producer`, …) is set in both, as
+ * [`SetMetadata`](crate::SetMetadata) sets it, and must have its shape: text, or a language
+ * alternative of the `x-default` entry alone, for `dc:title` and `dc:description`; an array of
+ * text for `dc:creator`; a date for the dates.
+ *
+ * ```
+ * use laminapdf_ops::{Op, SetXmpProperty};
+ * use laminapdf_model::xmp::XmpValue;
+ *
+ * let op = Op::from(SetXmpProperty::new("http://example.com/ns/", "acme", "batch", XmpValue::Integer(42)));
+ * assert_eq!(
+ *     serde_json::to_string(&op)?,
+ *     r#"{"op":"setXmpProperty","args":{"namespace":"http://example.com/ns/","prefix":"acme","name":"batch","value":{"type":"integer","value":42}}}"#
+ * );
+ * # Ok::<(), serde_json::Error>(())
+ * ```
+ *
+ * Added in 0.3.0.
+ */
+export interface SetXmpProperty {
+    /**
+     * The property's namespace URI.
+     */
+    namespace: string;
+    /**
+     * The prefix to write the namespace with when the packet binds none.
+     */
+    prefix: string;
+    /**
+     * The property's local name.
+     */
+    name: string;
+    /**
+     * The new value.
+     */
+    value: XmpValue;
+    /**
+     * As [`SetMetadata::replace_malformed`](crate::SetMetadata::replace_malformed).
+     */
+    replaceMalformed?: boolean;
+}
+
+/**
+ * Something in the file that names a destination.
+ *
+ * Added in 0.3.0.
+ */
+export type DestinationUse = { kind: "outlineItem"; item: string } | { kind: "annotation"; page: string; annot: string } | { kind: "catalog" };
+
 /**
  * The Info dictionary's text entries; absent ones are left out (document text).
  */
@@ -941,11 +2422,31 @@ export interface MetadataInit {
     modDate?: string;
 }
 
+/**
+ * The document's XMP packet as text (`laminapdf::XmpText`).
+ */
+export interface XmpTextJs {
+    /**
+     * Whether there is a packet, and whether it was read.
+     */
+    status: PacketStatus;
+    /**
+     * The packet's XML, with the edits made so far.
+     */
+    xml?: string;
+    /**
+     * The PDF/A part and conformance the packet claims, e.g. `"2B"`.
+     */
+    pdfa?: string;
+}
+
 /**
  * The kind of change an op makes. The save planner checks it against `DocMDP` / `FieldMDP`
  * permissions and the document's `SaveConstraint` ([ADR 0007]).
  *
  * [ADR 0007]: https://github.com/laudebugs/laminapdf/blob/main/docs/decisions/0007-save-planner.md
+ *
+ * Added in 0.2.0.
  */
 export type ModificationClass = "metadata" | "formFill" | "annotation" | "signature" | "pageStructure" | "content" | "document";
 
@@ -971,6 +2472,22 @@ export interface ModelsInit {
     langs?: string[];
 }
 
+/**
+ * The page and zoom a document opens at.
+ *
+ * Added in 0.3.0.
+ */
+export interface OpenAt {
+    /**
+     * The page.
+     */
+    page: string;
+    /**
+     * The zoom.
+     */
+    zoom?: "default" | "fitPage" | "fitWidth" | number;
+}
+
 /**
  * The pages an edit touched.
  */
@@ -979,11 +2496,80 @@ export interface EditedJs {
      * IDs of the pages whose content or attributes changed.
      */
     touchedPages: string[];
+    /**
+     * A metadata edit rewrote the XMP packet whole (UTF-16, or marked read-only).
+     */
+    packetRewritten: boolean;
+    /**
+     * A metadata edit removed values the file's earlier revisions still hold, which only a
+     * full rewrite drops.
+     */
+    stillInEarlierRevisions: boolean;
+    /**
+     * IDs of annotations an annotation op deleted besides the one it names (Popups, replies,
+     * the rest of a group); left out when there are none.
+     */
+    alsoDeleted?: string[];
     /**
      * Whether the edit changed the document: one that only set values they already had leaves
      * no step to undo.
      */
     changed: boolean;
+    /**
+     * The IDs of the bookmarks the edit added, in order.
+     */
+    createdOutlineItems: string[];
+    /**
+     * An outline edit found the outline's links broken and rewrote them whole; bookmarks
+     * stored inside others have new IDs.
+     */
+    outlineRepaired: boolean;
+    /**
+     * What still names a named destination the edit deleted.
+     */
+    destinationUses: DestinationUse[];
+    /**
+     * The XMP properties the edit declared in a PDF/A file's extension schemas.
+     */
+    declared: ExtensionPropertyJs[];
+    /**
+     * The page IDs in order after the edit, when it changed the page list.
+     */
+    pageOrder?: string[];
+    /**
+     * What a page deletion did to the references to the deleted pages.
+     */
+    references: ReferenceEditJs[];
+    /**
+     * What a page duplication did to the form fields whose widgets the copied pages show;
+     * left out when there are none.
+     */
+    fields?: FieldEditJs[];
+    /**
+     * The copies a page duplication made whose tags couldn't all be cloned; left out when
+     * there are none.
+     */
+    tagsIncomplete?: string[];
+    /**
+     * The page holding each link a page copied in from another document lost, one entry per
+     * link; left out when there are none.
+     */
+    linksRemoved?: string[];
+    /**
+     * The pages copied in from another document without the tags their source gave them; left
+     * out when there are none.
+     */
+    tagsDropped?: string[];
+    /**
+     * The named destinations a merge or a page import brought in under another name, because
+     * the document already used theirs; left out when there are none.
+     */
+    renamedDestinations?: RenamedDestinationJs[];
+    /**
+     * The bookmarks a merge left out because the pages they went to didn't come along; left
+     * out when there are none.
+     */
+    bookmarksDropped?: number;
 }
 
 /**
@@ -996,6 +2582,55 @@ export type PageModeInit = "none" | "outlines" | "thumbnails" | "fullScreen" | "
  */
 export type SaveModeJs = "auto" | "incremental" | "fullRewrite";
 
+/**
+ * The wire form, under the name TypeScript gives it.
+ */
+export type XmpValue = { type: "text"; value: string } | { type: "uri"; value: string } | { type: "integer"; value: number } | { type: "real"; value: number } | { type: "boolean"; value: boolean } | { type: "date"; value: string } | { type: "langAlt"; value: XmpLangText[] } | { type: "seq"; value: XmpValue[] } | { type: "bag"; value: XmpValue[] };
+
+/**
+ * The yes-or-no window entries of the viewer preferences.
+ */
+export interface WindowPreferencesJs {
+    /**
+     * Hide the reader's toolbars.
+     */
+    hideToolbar: boolean;
+    /**
+     * Hide the reader's menu bar.
+     */
+    hideMenubar: boolean;
+    /**
+     * Hide the scroll bars and navigation controls.
+     */
+    hideWindowUi: boolean;
+    /**
+     * Resize the window to fit the first page.
+     */
+    fitWindow: boolean;
+    /**
+     * Put the window in the middle of the screen.
+     */
+    centerWindow: boolean;
+    /**
+     * Show the document's title in the title bar.
+     */
+    displayDocTitle: boolean;
+}
+
+/**
+ * What [`DeleteOutlineItem`](super::DeleteOutlineItem) does with the item's children.
+ *
+ * Added in 0.3.0.
+ */
+export type ChildItems = "delete" | "promote";
+
+/**
+ * What [`DeletePages`] does with a destination that names a deleted page.
+ *
+ * Added in 0.3.0.
+ */
+export type ReferencePolicy = "retarget" | "remove";
+
 /**
  * What `WasmDocument.extract` returns.
  */
@@ -1062,6 +2697,33 @@ export interface PermissionsJs {
     assemble: boolean;
 }
 
+/**
+ * What a page duplication or a page copied in did to one form field.
+ */
+export interface FieldEditJs {
+    /**
+     * The field on the source page (in the source document, for a page copied in).
+     */
+    field: string;
+    /**
+     * The copy whose widget it concerns.
+     */
+    page: string;
+    /**
+     * `renamed` (the copy's widget belongs to a new field), `linked` (it joined the field of
+     * the same name) or `notCopied` (a signature's widget).
+     */
+    outcome: "renamed" | "linked" | "notCopied";
+    /**
+     * The new field's ID, when renamed; the field it joined, when linked.
+     */
+    to?: string;
+    /**
+     * The new field's fully qualified name, when renamed.
+     */
+    name?: string;
+}
+
 /**
  * What a save wrote (`laminapdf::SaveReport`).
  */
@@ -1090,6 +2752,24 @@ export interface SaveReportJs {
      * Whether encryption was removed.
      */
     encryptionRemoved: boolean;
+    /**
+     * Whether the save stamped the save-time metadata (`metadataDate`, `instanceId`).
+     */
+    metadataUpdated: boolean;
+    /**
+     * Whether the options asked for the stamp and the save left it out, because it would have
+     * broken a signature's restriction the saved changes keep.
+     */
+    metadataNotUpdated: boolean;
+    /**
+     * Whether an edit saved here rewrote the XMP packet whole.
+     */
+    packetRewritten: boolean;
+    /**
+     * Whether the save emptied the undo history (a full rewrite, or an incremental save that
+     * freed objects); for a copy, whether adopting it would.
+     */
+    historyCleared: boolean;
 }
 
 /**
@@ -1111,11 +2791,44 @@ export interface RevertedJs {
     touchedPages: string[];
 }
 
+/**
+ * What becomes of the sources' outlines (bookmarks) in a merge.
+ *
+ * Added in 0.3.0.
+ */
+export type OutlineMerge = "perFile" | "keep" | "none";
+
+/**
+ * What comes along with pages copied from another document.
+ *
+ * Added in 0.3.0.
+ */
+export interface Carry {
+    /**
+     * Whether the pages' annotations other than form fields come along (links, comments,
+     * markup); `true` when left out.
+     */
+    annotations?: boolean;
+    /**
+     * What happens to a form field whose name the target already uses; `rename` when left
+     * out.
+     */
+    fields?: FieldClash;
+}
+
 /**
  * What following a link does, by `kind`.
  */
 export type LinkToJs = { kind: "dest"; target?: TargetJs } | { kind: "named"; name: string; target?: TargetJs } | { kind: "uri"; uri: string } | { kind: "remote"; file?: string } | { kind: "named-action"; name: string } | { kind: "unsupported"; action: string };
 
+/**
+ * What happens to a copied form field whose fully qualified name the target already uses
+ * (E2 plan §11).
+ *
+ * Added in 0.3.0.
+ */
+export type FieldClash = "rename" | "link";
+
 /**
  * What happens to hidden text and page furniture.
  */
@@ -1131,6 +2844,25 @@ export interface DropInit {
     furniture?: boolean;
 }
 
+/**
+ * What the document's `/Metadata` holds.
+ *
+ * Added in 0.2.0.
+ */
+export type PacketStatus = "absent" | "parsed" | "malformed";
+
+/**
+ * Where a bookmark goes.
+ *
+ * Added in 0.3.0.
+ */
+export type OutlineTarget = { destination: ExplicitDestination } | { named: string } | { uri: string };
+
+/**
+ * Where a document opens, by `kind`.
+ */
+export type OpenTargetJs = { kind: "default" } | { kind: "page"; target: TargetJs } | { kind: "action"; action: string };
+
 /**
  * Where a link or outline item goes.
  */
@@ -1146,6 +2878,21 @@ export type SplitOnName = "headings" | "blocks" | "pages";
  */
 export type ReadingOrderName = "auto" | "tagged" | "layout" | "content-stream";
 
+/**
+ * Whether [`RenameNamedDestination`](super::RenameNamedDestination) renames the uses of the
+ * name in this file too.
+ *
+ * Added in 0.3.0.
+ */
+export type RenameLinks = "keep" | "follow";
+
+/**
+ * Which side [`DocumentMetadata`]'s values come from.
+ *
+ * Added in 0.2.0.
+ */
+export type MetadataSource = "info" | "xmp";
+
 /**
  * Which table detectors run.
  */
@@ -1305,6 +3052,24 @@ export class WasmDocument {
     private constructor();
     free(): void;
     [Symbol.dispose](): void;
+    /**
+     * Adds another PDF as a source document: `{ id, pages }`, its ID (64 hex digits, the
+     * SHA-256 of `bytes`) and its page IDs in order. An encrypted one opens with `password`,
+     * which no op ever holds.
+     *
+     * # Errors
+     * `wrong-password`, `password-required`, and the errors of a file that doesn't open.
+     */
+    addSource(bytes: Uint8Array, password?: string | null): { id: string; pages: string[] };
+    /**
+     * Makes `bytes`, the whole output of `saveCopy`, the document's saved file (it rebases onto
+     * them), once they are written where the document lives; `historyCleared` is the copy's
+     * report's.
+     *
+     * # Errors
+     * `nested-transaction`, `saved-not-rebased`; `not-rebased` when `bytes` can't be read.
+     */
+    adoptCopy(bytes: Uint8Array, historyCleared: boolean): void;
     /**
      * Applies an op log (`{ "v": 1, "ops": [ … ] }`) as one transaction.
      *
@@ -1320,6 +3085,14 @@ export class WasmDocument {
      * error (nothing is applied).
      */
     apply(ops: Op[]): EditedJs;
+    /**
+     * `view` (page space) on page `page` as the destination the outline and named-destination
+     * ops take, in the page's user space (the extract and text modules).
+     *
+     * # Errors
+     * `invalid-argument` for a view that isn't one; `page-index-out-of-range`; reading errors.
+     */
+    destinationAt(page: number, view: TargetViewJs): ExplicitDestination;
     /**
      * An extraction stepped a page at a time, whose models the host runs: each step returns
      * its progress, with the result it waits for under `request` (render that page at `dpi`,
@@ -1330,6 +3103,14 @@ export class WasmDocument {
      * As `extract`, for the options and the pages asked for.
      */
     extractJob(options: ExtractInit): WasmExtractJob;
+    /**
+     * A new document of `pages` of this one, in the order given.
+     *
+     * # Errors
+     * `invalid-argument` for a value that isn't a list of page IDs, `unknown-page`; reading
+     * errors.
+     */
+    extractPages(pages: string[]): WasmDocument;
     /**
      * The document's text for retrieval and LLMs, as one string: Markdown, plain text, the
      * `laminapdf.extract/1` JSON, or the chunks as a JSON array (the extract and text modules).
@@ -1350,6 +3131,13 @@ export class WasmDocument {
      * Reading errors.
      */
     info(): DocumentInfoJs;
+    /**
+     * How the document asks to be shown when it opens (the extract and text modules).
+     *
+     * # Errors
+     * `data-pending` and the reading errors.
+     */
+    initialView(): InitialViewJs;
     /**
      * Whether the file is encrypted (it opened with its password, or the empty one).
      */
@@ -1361,6 +3149,24 @@ export class WasmDocument {
      * Reading errors.
      */
     isTagged(): boolean;
+    /**
+     * A new document of `inputs` (each `{ bytes, password?, title? }`) one after another,
+     * with their bookmarks, named destinations, form fields, layers and page labels; `options`
+     * as `mergeDocuments`' (`outline`, `fields`).
+     *
+     * # Errors
+     * `invalid-argument` / `unknown-option` for bad values, `wrong-password`,
+     * `password-required`, and the errors of a file that doesn't open.
+     */
+    static merge(inputs: { bytes: Uint8Array; password?: string; title?: string }[], options: MergeOptions | undefined): WasmDocument;
+    /**
+     * The document's metadata, read from Info and XMP together, with the fields where they
+     * disagree.
+     *
+     * # Errors
+     * Reading errors.
+     */
+    metadata(): DocumentMetadata;
     /**
      * The named destination `name`, or `undefined` when the document has none by that name or
      * it names no page here (the extract and text modules).
@@ -1369,6 +3175,13 @@ export class WasmDocument {
      * `data-pending` and the reading errors.
      */
     namedDestination(name: string): TargetJs | undefined;
+    /**
+     * Every named destination, sorted by name (the extract and text modules).
+     *
+     * # Errors
+     * `data-pending` and the reading errors.
+     */
+    namedDestinations(): NamedDestinationJs[];
     /**
      * Opens a document from its bytes.
      *
@@ -1394,6 +3207,14 @@ export class WasmDocument {
      * `data-pending` and the reading errors.
      */
     outline(): OutlineNodeJs[];
+    /**
+     * The annotations on page `index`, in the order of its `/Annots`, every subtype included
+     * (the extract and text modules).
+     *
+     * # Errors
+     * `page-index-out-of-range`, `data-pending` and the reading errors.
+     */
+    pageAnnotations(index: number): PageAnnotationJs[];
     /**
      * A handle on the page with `id` (`p12.0`).
      *
@@ -1436,6 +3257,13 @@ export class WasmDocument {
      * `page-index-out-of-range`; reading errors.
      */
     page(index: number): WasmPage;
+    /**
+     * How a save with `options` would go, without saving.
+     *
+     * # Errors
+     * `invalid-argument` / `unknown-option` for bad options; reading errors.
+     */
+    plan(options: SaveOptionsInit | undefined): PlannedSaveJs;
     /**
      * The document's properties (the extract and text modules). Reads every object once.
      *
@@ -1467,6 +3295,14 @@ export class WasmDocument {
      * `data-pending` and the reading errors.
      */
     reflow(): string;
+    /**
+     * Writes what `save` would and leaves the document as it was: not rebased, its changes
+     * still unsaved, the save-time stamp in the copy only (Save a copy).
+     *
+     * # Errors
+     * As `save`; the document is unchanged either way.
+     */
+    saveCopy(options: SaveOptionsInit | undefined): { bytes: Uint8Array<ArrayBuffer>; report: SaveReportJs };
     /**
      * A save as a job, stepped with a budget of work units (ADR 0028 §3, §4).
      *
@@ -1481,6 +3317,17 @@ export class WasmDocument {
      * The save's errors (`would-invalidate-signatures`, `requires-rewrite`, …).
      */
     save(options: SaveOptionsInit | undefined): { bytes: Uint8Array<ArrayBuffer>; report: SaveReportJs };
+    /**
+     * This document cut into new ones: `{ count: n }` parts of `n` pages, `{ ranges: [[id, …],
+     * …] }` one part per list of page IDs, or `{ bookmarks: level }` a part from each bookmark
+     * at that depth (1: the top level). Each part carries what its pages reach and the
+     * bookmarks that go to them.
+     *
+     * # Errors
+     * `invalid-argument` / `unknown-option` for a value that isn't one of those, `unknown-page`,
+     * `no-pages-left` for an empty list; reading errors.
+     */
+    split(by: { readonly count: number } | { readonly ranges: readonly (readonly string[])[] } | { readonly bookmarks: number }): WasmDocument[];
     /**
      * The structure tree's top-level elements in reading order, or `undefined` without one (the
      * extract and text modules, beside `WasmPage.text`, whose runs it links by MCID).
@@ -1489,6 +3336,13 @@ export class WasmDocument {
      * Reading errors.
      */
     structureTree(): StructureNodeJs[] | undefined;
+    /**
+     * The document's article threads; empty without any (the extract and text modules).
+     *
+     * # Errors
+     * `data-pending` and the reading errors.
+     */
+    threads(): ThreadJs[];
     /**
      * Undoes the newest transaction: how it went and the pages it touched; `undefined` when
      * there is nothing to undo.
@@ -1501,6 +3355,20 @@ export class WasmDocument {
      * A cursor over the warnings so far (build warnings first), each as the §1 object.
      */
     warnings(): WasmWarningCursor;
+    /**
+     * The signature restrictions `op` would break if it were applied and saved.
+     *
+     * # Errors
+     * `invalid-argument` for a value that isn't an op; reading errors.
+     */
+    wouldViolate(op: Op): ViolationJs[];
+    /**
+     * The document's XMP packet as text, with the edits made so far.
+     *
+     * # Errors
+     * Reading errors.
+     */
+    xmpPacket(): XmpTextJs;
 }
 
 /**
@@ -1573,6 +3441,23 @@ export class WasmImage {
     readonly width: number;
 }
 
+/**
+ * The images of [`images_to_pdf`], in page order. Images are JavaScript-owned objects, which a
+ * record can't carry, so they are added one by one.
+ */
+export class WasmImageList {
+    free(): void;
+    [Symbol.dispose](): void;
+    /**
+     * An empty list.
+     */
+    constructor();
+    /**
+     * Adds `image` as the next page. The image stays usable: the list holds its own copy.
+     */
+    push(image: WasmImage): void;
+}
+
 /**
  * A page of a [`WasmDocument`], held by its ID (F2): moving pages doesn't retarget it.
  */
@@ -1879,6 +3764,16 @@ export function allocationFailed(): boolean;
  */
 export function hasText(): boolean;
 
+/**
+ * A new document with one page per image of `images`, in order: a JPEG embedded as it is, a PNG
+ * with its transparency, each drawn the way up its EXIF orientation says.
+ *
+ * # Errors
+ * `invalid-geometry` for no images, a negative margin or resolution, or a page too small for its
+ * margins; `unknown-option`, `invalid-argument` for bad options.
+ */
+export function imagesToPdf(images: WasmImageList, options: ImagesOptionsInit | undefined): WasmDocument;
+
 /**
  * The crate version (`@laminapdf/wasm`'s).
  */
@@ -1892,6 +3787,7 @@ export interface InitOutput {
     readonly __wbg_wasmdocument_free: (a: number, b: number) => void;
     readonly __wbg_wasmextractjob_free: (a: number, b: number) => void;
     readonly __wbg_wasmimage_free: (a: number, b: number) => void;
+    readonly __wbg_wasmimagelist_free: (a: number, b: number) => void;
     readonly __wbg_wasmpage_free: (a: number, b: number) => void;
     readonly __wbg_wasmpagebuilder_free: (a: number, b: number) => void;
     readonly __wbg_wasmsavejob_free: (a: number, b: number) => void;
@@ -1899,6 +3795,7 @@ export interface InitOutput {
     readonly __wbg_wasmwarningcursor_free: (a: number, b: number) => void;
     readonly allocationFailed: () => number;
     readonly hasText: () => number;
+    readonly imagesToPdf: (a: number, b: any) => [number, number, number];
     readonly version: () => [number, number];
     readonly wasmbuilder_attach: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: any) => [number, number];
     readonly wasmbuilder_destination: (a: number, b: number, c: number, d: number, e: any) => [number, number];
@@ -1910,33 +3807,48 @@ export interface InitOutput {
     readonly wasmbuilder_page: (a: number, b: number, c: number) => number;
     readonly wasmbuilder_pageLabels: (a: number, b: any) => [number, number];
     readonly wasmbuilder_viewerPreferences: (a: number, b: any) => [number, number];
+    readonly wasmdocument_addSource: (a: number, b: number, c: number, d: number, e: number) => [number, number, number];
+    readonly wasmdocument_adoptCopy: (a: number, b: number, c: number, d: number) => [number, number];
     readonly wasmdocument_apply: (a: number, b: any) => [number, number, number];
     readonly wasmdocument_applyLog: (a: number, b: number, c: number) => [number, number, number];
+    readonly wasmdocument_destinationAt: (a: number, b: number, c: any) => [number, number, number];
     readonly wasmdocument_extract: (a: number, b: any) => [number, number, number, number];
     readonly wasmdocument_extractJob: (a: number, b: any) => [number, number, number];
+    readonly wasmdocument_extractPages: (a: number, b: any) => [number, number, number];
     readonly wasmdocument_hasUnsavedChanges: (a: number) => number;
     readonly wasmdocument_info: (a: number) => [number, number, number];
+    readonly wasmdocument_initialView: (a: number) => [number, number, number];
     readonly wasmdocument_isEncrypted: (a: number) => number;
     readonly wasmdocument_isTagged: (a: number) => [number, number, number];
+    readonly wasmdocument_merge: (a: any, b: any) => [number, number, number];
+    readonly wasmdocument_metadata: (a: number) => [number, number, number];
     readonly wasmdocument_namedDestination: (a: number, b: number, c: number) => [number, number, number];
+    readonly wasmdocument_namedDestinations: (a: number) => [number, number, number];
     readonly wasmdocument_openBytes: (a: number, b: number, c: any) => [number, number, number];
     readonly wasmdocument_openSource: (a: number, b: any) => [number, number, number];
     readonly wasmdocument_outline: (a: number) => [number, number, number];
     readonly wasmdocument_page: (a: number, b: number) => [number, number, number];
+    readonly wasmdocument_pageAnnotations: (a: number, b: number) => [number, number, number];
     readonly wasmdocument_pageById: (a: number, b: number, c: number) => [number, number, number];
     readonly wasmdocument_pageCount: (a: number) => [number, number, number];
     readonly wasmdocument_pageInfo: (a: number, b: number) => [number, number, number];
     readonly wasmdocument_pageInfos: (a: number) => [number, number, number];
     readonly wasmdocument_pageLinks: (a: number, b: number) => [number, number, number];
+    readonly wasmdocument_plan: (a: number, b: any) => [number, number, number];
     readonly wasmdocument_properties: (a: number) => [number, number, number];
     readonly wasmdocument_rebase: (a: number, b: number, c: number) => [number, number];
     readonly wasmdocument_redo: (a: number) => [number, number, number];
     readonly wasmdocument_reflow: (a: number) => [number, number, number, number];
     readonly wasmdocument_save: (a: number, b: any) => [number, number, number];
+    readonly wasmdocument_saveCopy: (a: number, b: any) => [number, number, number];
     readonly wasmdocument_saveJob: (a: number, b: any) => [number, number, number];
+    readonly wasmdocument_split: (a: number, b: any) => [number, number, number];
     readonly wasmdocument_structureTree: (a: number) => [number, number, number];
+    readonly wasmdocument_threads: (a: number) => [number, number, number];
     readonly wasmdocument_undo: (a: number) => [number, number, number];
     readonly wasmdocument_warnings: (a: number) => number;
+    readonly wasmdocument_wouldViolate: (a: number, b: any) => [number, number, number];
+    readonly wasmdocument_xmpPacket: (a: number) => [number, number, number];
     readonly wasmextractjob_cancel: (a: number) => void;
     readonly wasmextractjob_provide: (a: number, b: any) => [number, number];
     readonly wasmextractjob_step: (a: number, b: number) => [number, number, number];
@@ -1945,6 +3857,8 @@ export interface InitOutput {
     readonly wasmimage_png: (a: number, b: number) => [number, number, number];
     readonly wasmimage_rgba: (a: number, b: number, c: number, d: number) => [number, number, number];
     readonly wasmimage_width: (a: number) => number;
+    readonly wasmimagelist_new: () => number;
+    readonly wasmimagelist_push: (a: number, b: number) => void;
     readonly wasmpage_id: (a: number) => [number, number];
     readonly wasmpage_index: (a: number) => [number, number, number];
     readonly wasmpage_info: (a: number) => [number, number, number];
@@ -1985,8 +3899,8 @@ export interface InitOutput {
     readonly __wbindgen_exn_store: (a: number) => void;
     readonly __externref_table_alloc: () => number;
     readonly __wbindgen_externrefs: WebAssembly.Table;
-    readonly __wbindgen_free: (a: number, b: number, c: number) => void;
     readonly __externref_table_dealloc: (a: number) => void;
+    readonly __wbindgen_free: (a: number, b: number, c: number) => void;
     readonly __wbindgen_start: () => void;
 }