@laminapdf/wasm 0.2.0 → 0.3.0

package/dist/lamina_pdf_extract.d.ts

@@ -44,6 +44,27 @@ 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.
  */
@@ -71,12 +92,20 @@ export interface ViolationJs {
     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[] };
+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.
@@ -370,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.
  */
@@ -384,11 +439,60 @@ 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.
  */
@@ -434,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.
  */
@@ -452,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.
  */
@@ -493,7 +692,146 @@ export interface AttachmentInit {
  *
  * Added in 0.2.0.
  */
-export type Op = { op: "setInfo"; args: SetInfo } | { op: "rotatePage"; args: RotatePage } | { op: "setMetadata"; args: SetMetadata } | { op: "removeMetadata"; args: RemoveMetadata };
+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 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
@@ -586,6 +924,148 @@ export interface MetadataPatch {
     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.
  *
@@ -650,36 +1130,115 @@ export interface SetMetadata {
 }
 
 /**
- * How a destination shows its page (§12.3.2.2).
+ * How [`RotatePages`] reads its angle.
+ *
+ * Added in 0.3.0.
  */
-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" };
+export type RotateMode = "set" | "turn";
 
 /**
- * How a file is encrypted, and what its author permits.
+ * How [`images_to_pdf`] sizes its pages.
  */
-export interface EncryptionJs {
+export interface ImagesOptionsInit {
     /**
-     * `/V`.
+     * 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.
      */
-    version: number;
+    fit?: [number, number];
     /**
-     * `/R`.
+     * The space around each image, in points (0 by default).
      */
-    revision: number;
+    margin?: number;
     /**
-     * The key length in bits.
+     * The resolution of an image whose file gives none, in dots per inch (72 by default).
      */
-    keyBits: number;
+    defaultDpi?: number;
     /**
-     * The cipher streams use.
+     * The new document's version, file ID, producer, creation date and compression.
      */
-    cipher: CipherJs;
+    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`).
  */
@@ -795,11 +1354,234 @@ export interface ViewerPreferencesInit {
     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.
+     */
+    created?: string;
+    /**
+     * `/M` as stored.
+     */
+    modified?: string;
+    /**
+     * `/F`, the flags.
+     */
+    flags: number;
+    /**
+     * `/C`: no components (transparent), one (gray), three (RGB) or four (CMYK).
+     */
+    color: number[];
+    /**
+     * `/CA`, the opacity.
+     */
+    opacity?: number;
+    /**
+     * The ID of the annotation this one replies to or is grouped with.
+     */
+    inReplyTo?: string;
+    /**
+     * Whether `inReplyTo` is a group rather than a reply.
+     */
+    grouped: boolean;
+    /**
+     * The ID of its Popup.
+     */
+    popup?: string;
+    /**
+     * For a Popup, the ID of the annotation it belongs to.
+     */
+    parent?: string;
+    /**
+     * Whether it has a normal appearance stream.
+     */
+    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;
+}
+
+/**
+ * One document a merge brings in.
+ *
+ * Added in 0.3.0.
+ */
+export interface MergeSource {
+    /**
+     * The source document, added with [`Document::add_source`](crate::Document::add_source).
+     */
+    source: string;
+    /**
+     * The source's pages to bring in, by their IDs in the source, in order; all of them when
+     * left out.
+     */
+    pages?: string[];
+    /**
+     * The name of the bookmark [`OutlineMerge::PerFile`] gives the source's bookmarks (a file
+     * name, say); the source's own title when left out.
+     */
+    title?: string;
+}
+
 /**
  * One element of the structure tree (`laminapdf::StructureNode`; its strings are document text).
  */
@@ -826,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.
  */
@@ -852,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.
  */
@@ -890,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).
      */
@@ -902,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.
      */
@@ -960,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.
@@ -1145,41 +2044,219 @@ export interface SaveOptionsInit {
      */
     metadataDate?: string;
     /**
-     * The XMP instance ID the save writes, a UUID (`uuid:` optional); without it, one is
-     * derived from the content.
+     * 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.
      */
-    instanceId?: string;
+    carry?: Carry;
 }
 
 /**
- * Removes metadata fields from the Info dictionary and the XMP packet; the packet's other
- * properties stay (J.10).
+ * Replaces the document's page labels with `ranges`; an empty list removes them, so viewers
+ * show page numbers again.
  *
- * 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).
+ * 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::{MetadataKey, Op, RemoveMetadata};
+ * use laminapdf_ops::{Op, ReplaceXmpPacket};
  *
- * 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"]}}"#);
+ * 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.2.0.
+ * Added in 0.3.0.
  */
-export interface RemoveMetadata {
+export interface ReplaceXmpPacket {
     /**
-     * The fields to remove.
+     * The new packet's XML, with or without its `<?xpacket … ?>` wrapper.
      */
-    keys: MetadataKey[];
+    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 {
     /**
-     * As [`SetMetadata::replace_malformed`].
+     * The pages; their order here doesn't matter.
      */
-    replaceMalformed?: boolean;
+    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.
+     */
+    pages: string[];
+    /**
+     * The angle in degrees clockwise: 0, 90, 180 or 270.
+     */
+    angle: 0 | 90 | 180 | 270;
+    /**
+     * Whether the angle is set or added; `set` when left out.
+     */
+    mode?: RotateMode;
 }
 
 /**
@@ -1208,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).
  */
@@ -1291,6 +2422,24 @@ 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]).
@@ -1323,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.
  */
@@ -1340,11 +2505,71 @@ export interface EditedJs {
      * 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;
 }
 
 /**
@@ -1357,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.
  */
@@ -1423,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`).
  */
@@ -1490,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.
  */
@@ -1517,6 +2851,18 @@ export interface DropInit {
  */
 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.
  */
@@ -1532,6 +2878,14 @@ 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.
  *
@@ -1698,6 +3052,15 @@ 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
@@ -1722,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`,
@@ -1732,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).
@@ -1752,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).
      */
@@ -1763,6 +3149,16 @@ 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.
@@ -1779,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.
      *
@@ -1804,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`).
      *
@@ -1906,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).
@@ -1914,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.
@@ -1933,6 +3362,13 @@ export class WasmDocument {
      * `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;
 }
 
 /**
@@ -2005,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.
  */
@@ -2311,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).
  */
@@ -2324,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;
@@ -2331,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];
@@ -2342,21 +3807,28 @@ 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];
@@ -2370,10 +3842,13 @@ export interface InitOutput {
     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];
@@ -2382,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];
@@ -2422,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;
 }