@laminapdf/wasm 0.2.0-alpha.5 → 0.2.0

package/dist/lamina_pdf_text.d.ts

@@ -44,16 +44,122 @@ export type PageLinkJs = {
 } & LinkToJs;
 
 
+/**
+ * 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 for text options (the text module's records).
  */
 export type ColorInit = number[] | 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[] };
+
 /**
  * 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.
  */
@@ -141,6 +247,25 @@ export interface PropertiesJs {
  */
 export type EncodingJs = { kind: "named"; name: string } | { kind: "custom" };
 
+/**
+ * A header or footer: text at the start, centre and end, with `{page}`, `{pages}`, `{section}`
+ * and `{title}` filled in.
+ */
+export interface PageRegionInit {
+    /**
+     * At the start of the line.
+     */
+    start?: string;
+    /**
+     * Centred.
+     */
+    center?: string;
+    /**
+     * At the end of the line.
+     */
+    end?: string;
+}
+
 /**
  * A job's progress (`laminapdf::Step::Progress`).
  */
@@ -212,12 +337,33 @@ export interface TextLinkInit {
  * ```
  *
  * [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.
  */
@@ -308,6 +454,24 @@ export interface RectJs {
  */
 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.
  */
@@ -391,8 +555,10 @@ 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 };
+export type Op = { op: "setInfo"; args: SetInfo } | { op: "rotatePage"; args: RotatePage } | { op: "setMetadata"; args: SetMetadata } | { op: "removeMetadata"; args: RemoveMetadata };
 
 /**
  * Changes to the Info dictionary's text entries. For each field, `None` leaves the entry
@@ -401,6 +567,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 {
     /**
@@ -429,13 +597,75 @@ export interface InfoPatch {
     producer?: string | null;
 }
 
+/**
+ * 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;
+}
+
 /**
  * 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 {
     /**
@@ -448,6 +678,71 @@ export interface SetInfo {
     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 `flow` reads its document.
+ */
+export interface FlowOptionsInit {
+    /**
+     * The values a template's `$data`, `$each` and `$item` placeholders read; without it, the
+     * document is read as it is.
+     */
+    data?: unknown;
+}
+
+/**
+ * How `markdown` lays a document out.
+ */
+export interface MarkdownOptionsInit {
+    /**
+     * The body text's size in points (10.5 by default); headings scale from it.
+     */
+    size?: number;
+    /**
+     * A contents page listing headings of levels 1 to `contents`, at the start.
+     */
+    contents?: number;
+    /**
+     * The pages (by default A4, 56-point margins, "Page {page} of {pages}" in the footer).
+     */
+    page?: PageTemplateInit;
+}
+
 /**
  * How a destination shows its page (§12.3.2.2).
  */
@@ -509,6 +804,65 @@ export interface TextOptionsInit {
     direction?: DirectionInit;
 }
 
+/**
+ * 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.
  */
@@ -985,6 +1339,17 @@ export interface SaveOptionsInit {
      * 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;
 }
 
 /**
@@ -992,6 +1357,37 @@ export interface SaveOptionsInit {
  */
 export type DirectionInit = "ltr" | "rtl";
 
+/**
+ * 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;
+}
+
 /**
  * Sets a page's rotation to `rotate` (absolute, not relative to the current value).
  *
@@ -1004,6 +1400,8 @@ export type DirectionInit = "ltr" | "rtl";
  * 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 {
     /**
@@ -1109,6 +1507,8 @@ export interface MetadataInit {
  * 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";
 
@@ -1134,6 +1534,32 @@ export interface ModelsInit {
     langs?: string[];
 }
 
+/**
+ * The pages a Markdown document flows through.
+ */
+export interface PageTemplateInit {
+    /**
+     * The page's width and height in points.
+     */
+    size: [number, number];
+    /**
+     * Top, right, bottom and left margins in points (72 each by default).
+     */
+    margins?: [number, number, number, number];
+    /**
+     * The header.
+     */
+    header?: PageRegionInit;
+    /**
+     * The footer.
+     */
+    footer?: PageRegionInit;
+    /**
+     * The size of the header and footer text, in the regular font (8 points by default).
+     */
+    furnitureSize?: number;
+}
+
 /**
  * The pages an edit touched.
  */
@@ -1142,6 +1568,20 @@ 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;
+    /**
+     * Whether the edit changed the document: one that only set values they already had leaves
+     * no step to undo.
+     */
+    changed: boolean;
 }
 
 /**
@@ -1159,6 +1599,26 @@ export type SaveModeJs = "auto" | "incremental" | "fullRewrite";
  */
 export type ExtractFormat = "markdown" | "json" | "text" | "chunks";
 
+/**
+ * What `flow` added.
+ */
+export interface FlowReportJs {
+    /**
+     * The pages it added, in order, by ID.
+     */
+    pages: string[];
+}
+
+/**
+ * What `markdown` added.
+ */
+export interface MarkdownReportJs {
+    /**
+     * The pages it added, in order, by ID.
+     */
+    pages: string[];
+}
+
 /**
  * What `provide` takes.
  */
@@ -1272,6 +1732,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;
 }
 
 /**
@@ -1279,6 +1757,20 @@ export interface SaveReportJs {
  */
 export type OutputJs = "whole" | "appendedOnly";
 
+/**
+ * What an undo or redo did (`laminapdf::Reverted`).
+ */
+export interface RevertedJs {
+    /**
+     * How it went.
+     */
+    outcome: UndoOutcomeJs;
+    /**
+     * IDs of the pages the undone or redone transaction touched: draw these again.
+     */
+    touchedPages: string[];
+}
+
 /**
  * What following a link does, by `kind`.
  */
@@ -1304,6 +1796,13 @@ export interface DropInit {
  */
 export type OverflowInit = "clip" | "error";
 
+/**
+ * What the document's `/Metadata` holds.
+ *
+ * Added in 0.2.0.
+ */
+export type PacketStatus = "absent" | "parsed" | "malformed";
+
 /**
  * Where a link or outline item goes.
  */
@@ -1319,6 +1818,13 @@ export type SplitOnName = "headings" | "blocks" | "pages";
  */
 export type ReadingOrderName = "auto" | "tagged" | "layout" | "content-stream";
 
+/**
+ * Which side [`DocumentMetadata`]'s values come from.
+ *
+ * Added in 0.2.0.
+ */
+export type MetadataSource = "info" | "xmp";
+
 /**
  * Which table detectors run.
  */
@@ -1422,6 +1928,18 @@ export class WasmBuilder {
      * `invalid-page-labels`, `invalid-geometry`, `subset-failed`.
      */
     finish(): WasmDocument;
+    /**
+     * Lays `document` out as tagged pages that flow, after any pages already added, filled from
+     * `options.data` first when it is given. The document's profiles are the builder's to set
+     * (`profiles` in its options); its warnings are the finished document's.
+     *
+     * # Errors
+     * `builder-finished`; `unknown-option`, `invalid-argument`; `invalid-document` with the JSON
+     * Pointer at fault and the closest keys in `didYouMean`; `template-data-missing`,
+     * `template-data-type`, `template-too-large`; `unknown-font` and `unknown-image` for a name
+     * `resources` lacks; `missing-glyph`, `flow-content-too-large`.
+     */
+    flow(document: unknown, resources: WasmFlowResources, options: FlowOptionsInit | undefined): FlowReportJs;
     /**
      * Loads a font from its bytes (TrueType or OpenType/CFF) and registers it; it is
      * subset to the glyphs drawn.
@@ -1430,6 +1948,13 @@ export class WasmBuilder {
      * `builder-finished`; `invalid-font`, `font-not-embeddable`.
      */
     fontBytes(bytes: Uint8Array): WasmFont;
+    /**
+     * Loads face `index` (from 0) of a font collection (`.ttc`, `.otc`) and registers it.
+     *
+     * # Errors
+     * `builder-finished`; `invalid-font`, `collection-index` (no such face), `font-not-embeddable`.
+     */
+    fontCollection(bytes: Uint8Array, index: number): WasmFont;
     /**
      * The natural language (`/Lang`), a BCP 47 tag.
      *
@@ -1437,6 +1962,17 @@ export class WasmBuilder {
      * `builder-finished`.
      */
     lang(lang: string): void;
+    /**
+     * Lays `markdown` out as tagged pages that flow, after any pages already added; its front
+     * matter's title, language, author and subject become the document's. Its warnings
+     * (`markdown-html-ignored`, `markdown-image-missing`, the flow's) are the finished
+     * document's.
+     *
+     * # Errors
+     * `builder-finished`; `unknown-option`, `invalid-argument`; `missing-glyph`,
+     * `flow-content-too-large`; `unknown-font` at `finish` for a font another builder registered.
+     */
+    markdown(markdown: string, resources: WasmMarkdownOptions, options: MarkdownOptionsInit | undefined): MarkdownReportJs;
     /**
      * The metadata, written as the Info dictionary and an XMP packet.
      *
@@ -1494,6 +2030,15 @@ export class WasmDocument {
     private constructor();
     free(): void;
     [Symbol.dispose](): void;
+    /**
+     * 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.
      *
@@ -1539,6 +2084,10 @@ export class WasmDocument {
      * Reading errors.
      */
     info(): DocumentInfoJs;
+    /**
+     * Whether the file is encrypted (it opened with its password, or the empty one).
+     */
+    isEncrypted(): boolean;
     /**
      * Whether the document says it is tagged (`/MarkInfo /Marked true`; the extract and text modules).
      *
@@ -1546,6 +2095,14 @@ export class WasmDocument {
      * Reading errors.
      */
     isTagged(): boolean;
+    /**
+     * 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).
@@ -1621,6 +2178,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.
      *
@@ -1636,12 +2200,21 @@ export class WasmDocument {
      */
     rebase(bytes: Uint8Array): void;
     /**
-     * Redoes the newest undone transaction; `undefined` when there is nothing to redo.
+     * Redoes the newest undone transaction: how it went and the pages it touched; `undefined`
+     * when there is nothing to redo.
      *
      * # Errors
      * As [`WasmDocument::undo`].
      */
-    redo(): UndoOutcomeJs | undefined;
+    redo(): RevertedJs | undefined;
+    /**
+     * 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).
      *
@@ -1665,16 +2238,24 @@ export class WasmDocument {
      */
     structureTree(): StructureNodeJs[] | undefined;
     /**
-     * Undoes the newest transaction; `undefined` when there is nothing to undo.
+     * Undoes the newest transaction: how it went and the pages it touched; `undefined` when
+     * there is nothing to undo.
      *
      * # Errors
      * `nested-transaction`, `saved-not-rebased`; reading errors.
      */
-    undo(): UndoOutcomeJs | undefined;
+    undo(): RevertedJs | undefined;
     /**
      * 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[];
 }
 
 /**
@@ -1709,6 +2290,26 @@ export class WasmExtractJob {
     step(budget: number): ({ state: "progress" } & ExtractProgressJs) | { state: "done"; output: string };
 }
 
+/**
+ * The fonts and images a document names, by the names it gives them.
+ */
+export class WasmFlowResources {
+    free(): void;
+    [Symbol.dispose](): void;
+    /**
+     * `font` for the styles that name `name`; the same name again replaces it.
+     */
+    font(name: string, font: WasmFont): void;
+    /**
+     * `image` for the figures that name `name`; the same name again replaces it.
+     */
+    image(name: string, image: WasmImage): void;
+    /**
+     * No fonts and no images.
+     */
+    constructor();
+}
+
 /**
  * A font registered with a [`WasmBuilder`].
  */
@@ -1768,6 +2369,30 @@ export class WasmImage {
     readonly width: number;
 }
 
+/**
+ * The fonts and images of a Markdown build, by role and by the target the Markdown names.
+ */
+export class WasmMarkdownOptions {
+    free(): void;
+    [Symbol.dispose](): void;
+    /**
+     * `font` for `role`: `regular`, `bold` (headings too), `italic`, `boldItalic`, `mono`, or
+     * `fallback` (each call adds one) for characters the others lack.
+     *
+     * # Errors
+     * `invalid-argument` for another role.
+     */
+    font(role: string, font: WasmFont): void;
+    /**
+     * `image` for the images whose target is `target`, as the Markdown writes it.
+     */
+    image(target: string, image: WasmImage): void;
+    /**
+     * No fonts (the standard 14 Helvetica family and Courier) and no images.
+     */
+    constructor();
+}
+
 /**
  * A page of a [`WasmDocument`], held by its ID (F2): moving pages doesn't retarget it.
  */
@@ -2103,8 +2728,10 @@ export interface InitOutput {
     readonly __wbg_wasmbuilder_free: (a: number, b: number) => void;
     readonly __wbg_wasmdocument_free: (a: number, b: number) => void;
     readonly __wbg_wasmextractjob_free: (a: number, b: number) => void;
+    readonly __wbg_wasmflowresources_free: (a: number, b: number) => void;
     readonly __wbg_wasmfont_free: (a: number, b: number) => void;
     readonly __wbg_wasmimage_free: (a: number, b: number) => void;
+    readonly __wbg_wasmmarkdownoptions_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;
@@ -2116,8 +2743,11 @@ export interface InitOutput {
     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];
     readonly wasmbuilder_finish: (a: number) => [number, number, number];
+    readonly wasmbuilder_flow: (a: number, b: any, c: number, d: any) => [number, number, number];
     readonly wasmbuilder_fontBytes: (a: number, b: number, c: number) => [number, number, number];
+    readonly wasmbuilder_fontCollection: (a: number, b: number, c: number, d: number) => [number, number, number];
     readonly wasmbuilder_lang: (a: number, b: number, c: number) => [number, number];
+    readonly wasmbuilder_markdown: (a: number, b: number, c: number, d: number, e: any) => [number, number, number];
     readonly wasmbuilder_metadata: (a: number, b: any) => [number, number];
     readonly wasmbuilder_new: (a: any) => [number, number, number];
     readonly wasmbuilder_outline: (a: number, b: any) => [number, number, number];
@@ -2125,13 +2755,16 @@ export interface InitOutput {
     readonly wasmbuilder_pageLabels: (a: number, b: any) => [number, number];
     readonly wasmbuilder_standardFont: (a: number, b: number, c: number) => [number, number, number];
     readonly wasmbuilder_viewerPreferences: (a: number, b: any) => [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_extract: (a: number, b: any) => [number, number, number, number];
     readonly wasmdocument_extractJob: (a: number, b: any) => [number, number, number];
     readonly wasmdocument_hasUnsavedChanges: (a: number) => number;
     readonly wasmdocument_info: (a: number) => [number, number, number];
+    readonly wasmdocument_isEncrypted: (a: number) => number;
     readonly wasmdocument_isTagged: (a: number) => [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_openBytes: (a: number, b: number, c: any) => [number, number, number];
     readonly wasmdocument_openSource: (a: number, b: any) => [number, number, number];
@@ -2142,17 +2775,23 @@ export interface InitOutput {
     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_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_structureTree: (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 wasmextractjob_cancel: (a: number) => void;
     readonly wasmextractjob_provide: (a: number, b: any) => [number, number];
     readonly wasmextractjob_step: (a: number, b: number) => [number, number, number];
+    readonly wasmflowresources_font: (a: number, b: number, c: number, d: number) => void;
+    readonly wasmflowresources_image: (a: number, b: number, c: number, d: number) => void;
+    readonly wasmflowresources_new: () => number;
     readonly wasmfont_family: (a: number) => [number, number];
     readonly wasmfont_isStandard: (a: number) => number;
     readonly wasmfont_postscriptName: (a: number) => [number, number];
@@ -2161,6 +2800,9 @@ 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 wasmmarkdownoptions_font: (a: number, b: number, c: number, d: number) => [number, number];
+    readonly wasmmarkdownoptions_image: (a: number, b: number, c: number, d: number) => void;
+    readonly wasmmarkdownoptions_new: () => number;
     readonly wasmpage_id: (a: number) => [number, number];
     readonly wasmpage_index: (a: number) => [number, number, number];
     readonly wasmpage_info: (a: number) => [number, number, number];