@betteroffice/docx 0.2.1 → 0.4.0

package/dist/wasm-edit.d.mts

@@ -1,4 +1,4 @@
-import { W as WasmAsyncInput } from './loadWasmAsset-CMvnVkfA.mjs';
+import { W as WasmAsyncInput } from './loadWasmAsset-Cr95TImt.mjs';
 
 /* tslint:disable */
 /* eslint-disable */
@@ -40,23 +40,38 @@ declare class EditSession {
      */
     add_comment(ranges_json: string, author: string, date: string, body_json: string): string;
     /**
-     * Deletes one character at this session's collapsed selection and returns
-     * the resulting binary `FrameDelta`. `direction` is `"backward"` or
-     * `"forward"`; a surrogate pair is removed whole. At a paragraph boundary
-     * this merges with the neighbouring paragraph instead.
+     * Closes the current undo capture without adding an empty step.
+     */
+    add_undo_boundary(): void;
+    /**
+     * Deletes up to `count` characters at this session's collapsed selection,
+     * lays out once, and returns the resulting binary `FrameDelta`.
+     * `direction` is `"backward"` or `"forward"`; a surrogate pair is removed
+     * whole. At a paragraph boundary a deletion merges with the neighbouring
+     * paragraph instead. Deleting stops early at the document start or end,
+     * before a second paragraph merge, or at a paragraph the resident state
+     * cannot absorb; [`EditSession::resident_deleted_units`] reports how many
+     * were removed.
      *
-     * Errors on an unknown `direction`, when `expected_frame_epoch` is not a
-     * non-negative safe integer, under the same selection and readiness
-     * conditions as [`EditSession::apply_input`], and when there is no
-     * character to delete in that direction (document start or end).
+     * Errors on an unknown `direction`, a zero `count`, when
+     * `expected_frame_epoch` is not a non-negative safe integer, under the
+     * same selection and readiness conditions as [`EditSession::apply_input`],
+     * and when there is no character to delete in that direction.
      */
-    apply_delete(direction: string, expected_frame_epoch: number): Uint8Array;
+    apply_delete(direction: string, expected_frame_epoch: number, count: number): Uint8Array;
     /**
      * Instrumented twin of [`EditSession::apply_delete`]: identical arguments,
      * result and error contract, but it also records stage timings for
      * [`EditSession::apply_input_profile_json`].
      */
-    apply_delete_profiled(direction: string, expected_frame_epoch: number): Uint8Array;
+    apply_delete_profiled(direction: string, expected_frame_epoch: number, count: number): Uint8Array;
+    /**
+     * Applies an edit batch all-or-nothing:
+     * `{"ok":true,"baseVersion","version","applied","source","changedStories",
+     * "receipts"}`. An applied batch commits one transaction; `history`
+     * `"separate"` makes it exactly one undo step.
+     */
+    apply_edits_json(request: string): string;
     /**
      * Applies one ordinary insertion at this session's collapsed selection
      * and returns the resulting binary `FrameDelta`. The inserted text
@@ -141,11 +156,26 @@ declare class EditSession {
      * Errors on a malformed update.
      */
     apply_update_with_inference(update: Uint8Array): string;
+    /**
+     * Starts a new opening of the document; see [`EditingDoc::begin_opening`].
+     */
+    begin_opening(generation?: string | null): void;
+    /**
+     * Begins `layout_document_with_regions_retained_json` as a pass measured a
+     * step at a time; see `EngineSession::begin_region_layout`. Returns the
+     * progress JSON, with `layoutJson` once the pass is complete.
+     */
+    begin_region_layout(input: string): string;
+    /**
+     * Until the matching `end_shared_reads`, committed reads share story projections of each document state.
+     */
+    begin_shared_reads(): void;
     /**
      * Display-only input JSON in, one binary `FrameDelta` v1 out (exposed as
      * a transferable `Uint8Array`). `expected_frame_epoch` is the epoch of the
      * frame the caller currently holds; pass `0` for the first frame. A
-     * mismatch makes the engine emit a full frame instead of a delta. Errors
+     * mismatch makes the engine emit a full frame instead of a delta, and the
+     * returned frame's epoch is always greater than `expected_frame_epoch`. Errors
      * unless the epoch is a non-negative safe integer, and on build failure.
      */
     build_display_list_frame(input: string, expected_frame_epoch: number): Uint8Array;
@@ -154,6 +184,12 @@ declare class EditSession {
      * against the same resident font store this session measures with.
      */
     build_display_list_json(input: string): string;
+    /**
+     * Build the listed pages that are still unbuilt and return a FrameDelta
+     * v1 carrying them; `expected_frame_epoch` works as for
+     * [`Self::build_display_list_frame`].
+     */
+    build_display_pages_frame(pages: Uint32Array, expected_frame_epoch: number): Uint8Array;
     /**
      * Whether [`EditSession::redo`] would reapply something.
      */
@@ -170,8 +206,8 @@ declare class EditSession {
     cell_selection(): string;
     /**
      * Removes the authored `value` from the content-control embed carrying
-     * `embed_id`, leaving the control itself in place. Errors when no embed
-     * has that id.
+     * `embed_id`, leaving the control and its content in place: it never
+     * erases a text control's text. Errors when no embed has that id.
      */
     clear_content_control_value(embed_id: string): void;
     /**
@@ -198,6 +234,26 @@ declare class EditSession {
      * This replica's client id, as passed to the constructor.
      */
     client_id(): number;
+    /**
+     * Resolves a text target and anchors a side-map comment over it in one
+     * call (legacy agent helpers). `comment_json`:
+     * `{"id","author","date","body"?}`. Returns `{"ok":true,"version"}` or a
+     * refusal.
+     */
+    comment_text_target_json(target_json: string, comment_json: string): string;
+    /**
+     * Compares two DOCX packages into this session, which must hold no document: the original
+     * is opened here and the revised body text differences are applied as tracked changes,
+     * outside undo history.
+     *
+     * `options` is `{"author","date","granularity"?,"unsupported"?,"limits"?}`. Returns a final
+     * `{"ok":false,"diagnostics"}` or `{"ok":true,"noop":true,"changes":[],"diagnostics"}`, or
+     * `{"ok":true,"noop":false,"save"}` naming what a save of the applied changes may write:
+     * then pass the saved bytes to [`EditSession::finish_compared_docx_json`], or the save
+     * failure to [`EditSession::fail_compared_docx_json`]. Malformed options and internal
+     * failures throw.
+     */
+    compare_docx_json(original: Uint8Array, revised: Uint8Array, options: string): string;
     /**
      * Adds a story holding one paragraph with `initial_text` (which must not
      * contain paragraph breaks), `p_style` and `alignment`. Receipt:
@@ -308,6 +364,62 @@ declare class EditSession {
      * with [`EditSession::resolve_encoded_selection`].
      */
     encoded_selection(): string;
+    /**
+     * Ends a shared-read scope, dropping shared story projections when the last scope ends.
+     */
+    end_shared_reads(): void;
+    /**
+     * [`EditSession::export_structured_json`] rendered as Markdown from the same read:
+     * `{"ok":true,"version","content":{"markdown","anchors","diagnostics","truncated"}}`.
+     */
+    export_markdown_json(options: string): string;
+    /**
+     * Lays this private session out with its own fonts and exports it with pages as a
+     * snapshot. `fonts` holds the font files back to back, `font_lengths` their byte lengths;
+     * `request` is a region layout request whose font chains name fonts by their index. The
+     * reply is `{"ok":true,"content"}` or `{"ok":false,"failure"}`; a rejected font or an
+     * unusable request throws. The session's measurement fonts are left untouched.
+     */
+    export_snapshot_with_private_fonts_json(fonts: Uint8Array, font_lengths: Uint32Array, request: string, options: string): string;
+    /**
+     * Structured export of the committed document state:
+     * `{"revisionView","stories"?,"includeFormatting"?,"maxBlocks"?,"maxBytes"?}` ->
+     * `{"ok":true,"version","content"}` or `{"ok":false,"version","failure"}`. Anchors are scoped
+     * to the returned version. Reads only: nothing is committed, minted or published.
+     */
+    export_structured_json(options: string): string;
+    /**
+     * [`EditSession::export_structured_json`] with the page map of the retained region
+     * layout. `options` adds `"includeGeometry"?`, `"expectLayoutVersion"?`,
+     * `"maxFragments"?` and `"maxLayoutBytes"?`; the reply is
+     * `{"ok":true,"version","content":{"structured","layout"}}` or a refusal. An editor passes
+     * the region layout request it would lay the document out with now as `current_request`,
+     * and the layout must have been computed from the same inputs. Lays nothing out and changes
+     * nothing.
+     */
+    export_structured_with_pages_json(options: string, current_request?: string | null): string;
+    /**
+     * The final comparison result when saving the applied changes failed with `message`.
+     */
+    fail_compared_docx_json(message: string): string;
+    /**
+     * [`EditSession::list_content_controls_json`] keeping the controls that match `query`
+     * (`{"kind":"id","controlId"}`, `{"kind":"tag","tag"}`, `{"kind":"ooxmlId","ooxmlId"}` or
+     * `{"kind":"alias","alias"}`) exactly.
+     */
+    find_content_controls_json(query: string, options: string): string;
+    /**
+     * Exact, case-sensitive, paragraph-local search:
+     * `{"text","within","view","limit"?}` ->
+     * `{"ok":true,"version","matches":[{"text","range"}],"truncated"}`.
+     */
+    find_text_json(request: string): string;
+    /**
+     * The final comparison result for `bytes`, the saved applied changes, verified against both
+     * inputs: `{"ok":true,"changes","diagnostics"}` or `{"ok":false,"diagnostics"}`. Throws
+     * when no comparison awaits its saved bytes.
+     */
+    finish_compared_docx_json(bytes: Uint8Array): string;
     /**
      * Applies a set-valued, tri-state inline formatting delta over
      * `[start, end)` in one transaction. An omitted key keeps the current
@@ -332,6 +444,21 @@ declare class EditSession {
      * there is no receipt. Errors when a key carries a type not listed here.
      */
     format_range(story: string, start_para: string, start_offset: number, end_para: string, end_offset: number, delta_json: string): void;
+    /**
+     * Resolves a text target and formats it in one call (legacy agent
+     * helpers). `delta_json` is the [`EditSession::format_range`] delta.
+     * Returns `{"ok":true,"version"}` or a refusal.
+     */
+    format_text_target_json(target_json: string, delta_json: string): string;
+    /**
+     * Whether the document has a story with this id.
+     */
+    has_story(story: string): boolean;
+    /**
+     * The headings of `story` in document order, classified as the structured export
+     * classifies them: `[{"paraId","heading":{"outlineLevel","source"}}]`.
+     */
+    headings_json(story: string): string;
     /**
      * Stories changed by the latest undo or redo, sorted.
      */
@@ -397,6 +524,16 @@ declare class EditSession {
      * with no host-side layout mutation. Retains the pass for resident edits.
      */
     layout_document_with_regions_json(input: string): string;
+    /**
+     * The retained region layout of the first `pages` pages only; see
+     * `EngineSession::layout_document_with_regions_prefix_retained_json`.
+     */
+    layout_document_with_regions_prefix_retained_json(input: string, pages: number): string;
+    /**
+     * [`Self::layout_document_with_regions_retained_json`] without the reply,
+     * for a caller that reads only the retained state.
+     */
+    layout_document_with_regions_retained(input: string): void;
     /**
      * Same full region pass as [`Self::layout_document_with_regions_json`],
      * but the reply carries only `{ layout, headersFooters?, notesConverged }`
@@ -409,6 +546,19 @@ declare class EditSession {
      * needs as JSON out, so the host can register fonts before laying out.
      */
     layout_font_requirements_json(input: string): string;
+    /**
+     * Every comment the session holds, sorted by id:
+     * `[{"id","author","date","done","parentId","body"}, …]`, `parentId`
+     * null for a top-level comment and `body` the JSON value it was given.
+     */
+    list_comments(): string;
+    /**
+     * The content controls of the committed state:
+     * `{"stories"?,"maxControls"?,"maxBytes"?}` -> `{"ok":true,"version","content"}` or
+     * `{"ok":false,"version","failure"}`. Control ids and anchors are scoped to the returned
+     * version. Reads only.
+     */
+    list_content_controls_json(options: string): string;
     /**
      * Every pending tracked change across all stories, in deterministic
      * story-then-position order:
@@ -434,9 +584,16 @@ declare class EditSession {
      * text must not contain paragraph breaks. Receipt:
      * `{storyId: [paraId, …]}` with each story's paragraphs in document
      * order. Errors when a story entry has no `storyId`, no `paragraphs`
-     * array, or an empty one, and when a story id already exists.
+     * array, or an empty one, and when a story id already exists. Seeding a
+     * document that has no opening yet starts one; see
+     * [`EditingDoc::begin_opening`].
      */
     load_json(stories_json: string): string;
+    /**
+     * Lays this replica's `data:` image sources out as the `media:{n}` tokens
+     * another replica seeded them from.
+     */
+    load_media_sources(json: string): void;
     /**
      * `{"start","end"}` — the paragraph's span in story-global UTF-16 units.
      * `end` is the index of its own pilcrow, so `end - start` is the
@@ -458,6 +615,26 @@ declare class EditSession {
      * the engine's message for input it cannot measure.
      */
     measure_paragraph_json(input: string): string;
+    /**
+     * The bytes a `media:{n}` image source displays, as the part's
+     * [`EditSession::media_type`]; `undefined` for any other source or a
+     * part that cannot be read.
+     */
+    media_bytes(token: string): Uint8Array | undefined;
+    /**
+     * The `data:` URL a `media:{n}` image source stands for.
+     */
+    media_data_url(token: string): string | undefined;
+    /**
+     * The digests mapping the `data:` URLs this replica seeded to
+     * `media:{n}` tokens, for [`EditSession::load_media_sources`]; empty
+     * when it seeded none.
+     */
+    media_sources_json(): string;
+    /**
+     * The media type of [`EditSession::media_bytes`].
+     */
+    media_type(token: string): string | undefined;
     /**
      * Merges the rectangle the [`TableRange`] `range_json` covers into its
      * top-left cell, whose story survives; the other cells' stories are
@@ -483,17 +660,33 @@ declare class EditSession {
     /**
      * Parses a DOCX package, optionally seeds its editable stories into this
      * replica, and retains the source bytes for
-     * [`EditSession::materialize_docx`].
+     * [`EditSession::materialize_docx`] and paragraph identity reads.
+     * Seeding starts a new opening, with `generation` or a fresh one, so its
+     * session anchors are its own; see [`EditingDoc::begin_opening`].
      *
-     * Returns `{"envelope","referencedFonts":[string, …]}`. The envelope is
+     * Returns `{"envelope","referencedFonts":[string, …],"unusedScriptFonts":[string, …]}`:
+     * `unusedScriptFonts` are the referenced fonts a seeded package names only
+     * for East Asian or complex-script text it does not contain. The envelope is
      * the parsed package with the parts the host does not need stripped —
      * body content, header/footer and note content, numbering, media and
      * charts are emptied, section entries keep only their properties — so
      * styles, theme, settings, fonts and relationships still cross while the
      * bulk of the document stays in Rust. Errors on bytes that are not a
      * readable DOCX.
+     * `digest`, when given, must be the SHA-256 of `bytes` in lowercase hex,
+     * as a host that hashed them off this thread already knows it.
      */
-    open_docx(bytes: Uint8Array, seed_stories: boolean): string;
+    open_docx(bytes: Uint8Array, seed_stories: boolean, generation?: string | null, digest?: string | null): string;
+    /**
+     * Opens `bytes` for display only, seeded from the body's first `blocks`
+     * blocks (see `seed::seed_docx_preview`): the reply is the host metadata
+     * of that parse, as [`EditSession::open_docx`] replies, with the
+     * `unusedScriptFonts` of its cut. The session keeps no source package, so
+     * it cannot save.
+     * Opens nothing and replies with nothing for a document the preview
+     * refuses, which opens with [`EditSession::open_docx`] instead.
+     */
+    open_docx_preview(bytes: Uint8Array, blocks: number): string | undefined;
     /**
      * One glyph outline from this session's resident font store:
      * `{"upem":n,"cmds":[{"t":"M"|"L"|"Q"|"C"|"Z", …}]}` — commands in font
@@ -502,6 +695,20 @@ declare class EditSession {
      * Errors when the glyph cannot be extracted.
      */
     outline_glyph_json(font_id: number, glyph_id: number): string;
+    /**
+     * Every paragraph's identities: `{"sessionId","packageSha256",
+     * "paragraphs":[{"session","origin","ooxmlParaId","idOrigin",
+     * "persisted","source"}]}`, session paragraphs with stories sorted and
+     * in document order, then source paragraphs outside the stories, whose
+     * `session` is `null`. Reads only.
+     */
+    paragraph_identities(): string;
+    /**
+     * The paragraph IDs a save applies, as the package writer's
+     * `paragraphIds` request field: `{"assignments":[{"part","ordinal",
+     * "paraId"}],"patchedParts":[{"part","paraIds":[[ordinal,"ID"]]}]}`.
+     */
+    paragraph_save_plan(): string;
     /**
      * Compact paragraph-position projection built in one story traversal:
      * `[{"paraId","length"}, …]` in document order, where `length` counts the
@@ -517,6 +724,30 @@ declare class EditSession {
      * else has been set on it). Errors on an unknown story.
      */
     paragraphs(story: string): string;
+    /**
+     * Gives every paragraph that saves without a Word paragraph ID a fresh
+     * one and repairs duplicates; see [`EditingDoc::persist_paragraph_ids`].
+     * Receipt: `{"status":"applied","assignments":[{"paragraph",
+     * "replacedParaId","previousOoxmlParaId","ooxmlParaId","idOrigin",
+     * "persisted"}],"diagnostics":[…]}`, or `{"status":"refused","refusal"}`
+     * when nothing was changed.
+     */
+    persist_paragraph_ids(): string;
+    /**
+     * Versioned paragraph texts:
+     * `{"story"?,"paraIds"?,"view":"accepted"|"original"}` ->
+     * `{"ok":true,"version","view","paragraphs":[{"story","paraId","text",
+     * "styleId"?,"atoms":[{"offset","kind"}]}]}`. Each inline atom occupies one
+     * U+FFFC in `text`.
+     */
+    read_paragraphs_json(request: string): string;
+    /**
+     * Reconciles and publishes the `[owner, paraId]` pairs a save captured,
+     * an owner being a session key or a source occurrence's
+     * `{partUri}#{ordinal}`; returns the stale pairs as the same JSON shape.
+     * See [`EditingDoc::record_saved_paragraph_ids`].
+     */
+    record_saved_paragraph_ids(saved_json: string): string;
     /**
      * Reapplies the latest locally undone transaction and reports whether
      * anything was reapplied.
@@ -528,6 +759,13 @@ declare class EditSession {
      * Errors on bytes the font parser rejects.
      */
     register_measure_font(bytes: Uint8Array): number;
+    /**
+     * Registers a measurement view of `base` carrying the vertical metrics
+     * and advance pitch Word measures `requested_family` with — for a face
+     * this host had to substitute. Returns `base` for a family whose metrics
+     * are unknown.
+     */
+    register_substitute_measure_font(base: number, requested_family: string): number;
     /**
      * Rejects tracked changes — the inverse of
      * [`EditSession::accept_change`]: pending insertions roll back, pending
@@ -541,9 +779,14 @@ declare class EditSession {
      * Replaces `[start, end)` with `text` in one transaction. The inserted
      * text adopts the first replaced unit's formatting; in suggesting mode
      * the deletion and the insertion share one revision id. Receipt:
-     * `{"revisionId": string|null}`.
+     * `{"revisionId": string|null, "range": {"story", "start": {"paraId", "offset"}, "end": {"paraId", "offset"}}}`.
      */
     replace_range(story: string, start_para: string, start_offset: number, end_para: string, end_offset: number, text: string, author_name?: string | null, author_date?: string | null): string;
+    /**
+     * Makes the next display frame a full one whatever epoch its caller
+     * passes, for a host that switches to this engine from another.
+     */
+    reset_frame_base(): void;
     /**
      * `{"frameEpoch", "caretRect": {…}|null}` for the session's own collapsed
      * body selection. `caretRect` is null whenever there is no selection, the
@@ -551,6 +794,10 @@ declare class EditSession {
      * geometry for it. `frameEpoch` identifies the frame the rect belongs to.
      */
     resident_caret_snapshot_json(): string;
+    /**
+     * Characters the last [`EditSession::apply_delete`] removed.
+     */
+    resident_deleted_units(): number;
     /**
      * Where a comment's sticky anchors currently sit:
      * `[{"story","start","end"}, …]`, one entry per anchored range, in
@@ -564,24 +811,47 @@ declare class EditSession {
      * Errors on malformed bytes or an endpoint that no longer resolves.
      */
     resolve_encoded_selection(story: string, anchor: Uint8Array, head: Uint8Array): string;
+    /**
+     * Resolves a `session`, `source` or `persisted` anchor JSON against the
+     * current state: `{"status":"found","anchor"}`, `{"status":"missing"}`,
+     * `{"status":"ambiguous","candidates"}` or `{"status":"unsupported",
+     * "reason"}` with a `foreign-session`, `foreign-package` or
+     * `no-source-package` reason. A found source paragraph outside the
+     * session stories comes back as its source anchor. Errors on a malformed
+     * anchor.
+     */
+    resolve_paragraph_anchor(anchor_json: string): string;
     /**
      * Resolves sticky bytes from [`EditSession::encode_sticky_position`] back
      * to `{"story","paraId","offset"}`. Errors when the bytes are malformed
      * or the position no longer resolves in `story`.
      */
     resolve_sticky_position(story: string, position: Uint8Array): string;
+    /**
+     * Measures up to `blocks` more body blocks of the begun pass; see
+     * `EngineSession::resume_region_layout`.
+     */
+    resume_region_layout(blocks: number): string;
+    /**
+     * The retained region layout's `headersFooters` JSON, when it has any.
+     */
+    retained_headers_footers_json(): string | undefined;
     /**
      * Retained `{ measured, options }` for the main-thread display-list
      * fallback after a retained-only region layout.
      */
     retained_kernel_inputs_json(): string;
+    search_text(query: string, case_sensitive: boolean, limit?: number | null): string;
     /**
      * [`EditSession::open_docx`] with seeding always on.
      */
-    seed_from_docx(bytes: Uint8Array): string;
+    seed_from_docx(bytes: Uint8Array, generation?: string | null): string;
+    /**
+     * Unions seeded opaque sequence names into document state.
+     */
+    seed_opaque_sequences(names_json: string): void;
     /**
-     * Notes the story a direct operation is about to edit; a different story
-     * than the previous edit or caret closes the current undo step.
+     * Selects a story, closing capture unless manual grouping is selected.
      */
     select_story(story: string): void;
     /**
@@ -596,7 +866,9 @@ declare class EditSession {
      * ```json
      * {
      *   "bold": true | false | "mixed", "italic": …, "underline": …, "strike": …,
+     *   "superscript": …, "subscript": …,
      *   "fontFamily": string|null, "fontSize": number|null, "color": string|null,
+     *   "highlight": string|null,
      *   "paraId": string, "styleId": string|null, "alignment": string|null,
      *   "paragraphProperties": {…},
      *   "hasSelection": bool, "isMultiParagraph": bool, "inTable": bool,
@@ -612,6 +884,12 @@ declare class EditSession {
      * pending tracked change.
      */
     selection_context(story: string, start_para: string, start_offset: number, end_para: string, end_offset: number): string;
+    /**
+     * Accepted-view texts around a paragraph-keyed selection:
+     * `{"paraId","selectedText","paragraphText","before","after"}`, with
+     * `\n` between paragraphs and U+FFFC for each inline atom.
+     */
+    selection_text_json(story: string, start_para: string, start_offset: number, end_para: string, end_offset: number): string;
     /**
      * Merges the sides of the JSON object `borders_json` into every selected
      * cell's `tcPr.borders`; `insideH`/`insideV` resolve to the physical edges
@@ -648,20 +926,37 @@ declare class EditSession {
      * `width_twips` is finite and positive.
      */
     set_column_width(at_json: string, width_twips: number): string;
+    /**
+     * Reanchors an existing comment without changing its metadata.
+     */
+    set_comment_ranges(comment_id: string, ranges_json: string): void;
     /**
      * Sets the authored `value` (any JSON) on the content-control embed
-     * carrying `embed_id`, searching every story. Errors when no embed has
-     * that id.
+     * carrying `embed_id`, searching every story. A plain- or rich-text
+     * control takes a string, which fills its content as one
+     * version-checked batch step instead. Errors when no embed has that id
+     * and when a fill is refused.
      */
     set_content_control_value(embed_id: string, value_json: string): void;
     /**
      * Sets the authored `value` on the content-control embed at
      * `(story, para_id, offset)` — the way to reach a control with no
      * authored `w:id` or tag, which
-     * [`EditSession::set_content_control_value`] cannot address. Errors when
-     * that position holds no embed.
+     * [`EditSession::set_content_control_value`] cannot address. A text
+     * control's string value fills it as that method does. Errors when that
+     * position holds no embed.
      */
     set_content_control_value_at(story: string, para_id: string, offset: number, value_json: string): void;
+    /**
+     * Keep every previously built page while windowed builds are on.
+     */
+    set_display_retain_built_pages(retain: boolean): void;
+    /**
+     * Limit full display builds to pages `start..end` plus the pages already
+     * built; the others stay unbuilt placeholders carrying their geometry
+     * until [`Self::build_display_pages_frame`] builds them.
+     */
+    set_display_window(start: number, end: number): void;
     /**
      * Sets or clears the hyperlink attribute over `[start, end)`.
      * `hyperlink_json` is `{"href", "tooltip"?, "rId"?}` or `null` to unlink.
@@ -679,6 +974,19 @@ declare class EditSession {
      * has that id.
      */
     set_image_geometry(embed_id: string, geometry_json: string): void;
+    /**
+     * [`EditSession::set_image_geometry`] for the image embed at
+     * `(story, para_id, offset)` — the way to reach one of several images
+     * sharing a relationship id, which the id variant resolves to the first.
+     * Errors when that position holds no image.
+     */
+    set_image_geometry_at(story: string, para_id: string, offset: number, geometry_json: string): void;
+    /**
+     * Whether [`EditSession::open_docx`] seeds images as `media:{n}` tokens,
+     * which only a replica opened from the same package resolves, instead of
+     * `data:` URLs. Off by default.
+     */
+    set_media_tokens(enabled: boolean): void;
     /**
      * Sets one paragraph property to any JSON value on `para_id`'s pilcrow,
      * searching every story. Unlike
@@ -704,6 +1012,11 @@ declare class EditSession {
      * identity such as `paraId`.
      */
     set_paragraph_attrs(story: string, start_para: string, start_offset: number, end_para: string, end_offset: number, attrs_json: string, author_name?: string | null, author_date?: string | null): void;
+    /**
+     * Marks whether the session's document is part of a package, as a
+     * replica of a preview is: its layouts render NUMPAGES empty.
+     */
+    set_partial_document(partial: boolean): void;
     /**
      * Stores this peer's anchor and head as sticky positions, replacing any
      * previous selection. Both endpoints must lie in `story`. The positions
@@ -718,6 +1031,10 @@ declare class EditSession {
      * `width_twips` is finite and positive.
      */
     set_table_width(table_json: string, width_twips: number): string;
+    /**
+     * Changes grouping policy while retaining undo and redo history.
+     */
+    set_undo_capture_mode(mode: string): void;
     /**
      * Subscribes `callback(update: Uint8Array, isRemote: 0|1)` to every
      * committed transaction. `update` is v1-encoded — feed it straight to
@@ -727,6 +1044,16 @@ declare class EditSession {
      * a second call replaces the first, and a throwing callback is ignored.
      */
     set_update_observer(callback: Function): void;
+    /**
+     * Limit incremental rebuilds to the display window and caret pages. Off by default.
+     */
+    set_windowed_incremental_builds(enabled: boolean): void;
+    /**
+     * Resolves tracked changes by revision id outside undo history:
+     * `{"accept":[string, …],"reject":[string, …]}` -> `{"revisionIds":[string, …]}`, the ids
+     * resolved. An id that matches nothing is skipped. See [`EditingDoc::settle_revisions`].
+     */
+    settle_revisions_json(request: string): string;
     /**
      * Splits the cell `at_json` ([`CellLoc`]) covers into a `rows` x
      * `columns` grid; the original story stays in the top-left slot and every
@@ -752,6 +1079,11 @@ declare class EditSession {
      * callback. Idempotent while observation is running.
      */
     start_update_event_observation(): void;
+    /**
+     * `{"revision","stories":[…]}`: the current story revision and the sorted
+     * ids of the stories created, edited, or deleted after revision `since`.
+     */
+    stories_changed_since(since: number): string;
     /**
      * The story's `canonical-stream-v1` FNV-1a checksum (see
      * [`crate::canonical`]) as a DECIMAL STRING, because a u64 exceeds the
@@ -770,6 +1102,22 @@ declare class EditSession {
      * as one. Errors on an unknown story.
      */
     story_len(story: string): number;
+    /**
+     * The Word paragraph ID each paragraph of `story` saves with, as a JSON
+     * array of strings or `null` in document order. Errors on an unknown story.
+     */
+    story_paragraph_ids(story: string): string;
+    /**
+     * `story_segments` split after each pilcrow into units, as one hex digest
+     * per unit: `["digest", …]`. Equal digests mean equal segments.
+     */
+    story_segment_unit_digests(story: string): string;
+    /**
+     * The segments of the listed units (indices into
+     * `story_segment_unit_digests`), each as `story_segments` gives them:
+     * `[[segment, …], …]`. Errors on an index past the last unit.
+     */
+    story_segment_units(story: string, units: Uint32Array): string;
     /**
      * The story as an ordered run of formatted segments — the same view
      * lowering reads:
@@ -784,6 +1132,12 @@ declare class EditSession {
      * tracked-change stamps. Errors on an unknown story.
      */
     story_segments(story: string): string;
+    /**
+     * The `payload` of the story's `table_index`-th table embed, as
+     * `story_segments` gives it, or `None` when the story has no such
+     * table. Errors on an unknown story.
+     */
+    table_payload(story: string, table_index: number): string | undefined;
     /**
      * Applies one run mark over `[start, end)`. `mark_json`:
      * `{"type":"bold"|"italic"|"underline"|"strike"|"superscript"|"subscript"} |
@@ -807,6 +1161,26 @@ declare class EditSession {
      * tracked-origin policy; `false` before tracking starts.
      */
     undo(): boolean;
+    /**
+     * Current undo grouping policy.
+     */
+    undo_capture_mode(): string;
+    /**
+     * Runs every check of [`EditSession::apply_edits_json`], staging included,
+     * without changing anything: `{"ok":true,"baseVersion","wouldApply","previews"}`.
+     */
+    validate_edits_json(request: string): string;
+    /**
+     * The session-scoped version token of the committed document state. It
+     * changes on every committed change, local or remote, and when the
+     * document or its retained source is replaced.
+     */
+    version(): string;
+    /**
+     * The Word paragraph IDs a DOCX package holds, as JSON mapping each XML
+     * part URI to its paragraphs' IDs in document order, in canonical form.
+     */
+    written_paragraph_ids(bytes: Uint8Array): string;
     /**
      * Lowers one story to a `LayoutBlock[]` JSON array — the block, run and
      * table vocabulary the layout engine consumes. `env_json` supplies the
@@ -814,7 +1188,8 @@ declare class EditSession {
      * `{"themeColors":{slot: hex},"defaultTabStopTwips":number|null,
      * "pageContentHeight":number|null,"numericIds":{yrsId: number},
      * "tocStyleIds":[styleId],"showHiddenText":bool,
-     * "defaultParagraphStyleId":string}`, all
+     * "defaultParagraphStyleId":string,
+     * "revisionPreview":{revisionId: "accepted"|"rejected"}}`, all
      * optional. Errors when the story does not end in a pilcrow, holds a
      * malformed table, references itself through a cell story, or contains an
      * embed lowering does not support.
@@ -836,11 +1211,28 @@ declare class EditSession {
 
 /** Load + instantiate the editing-core wasm (browser path). Idempotent. */
 declare function preloadEditWasm(input?: WasmAsyncInput): Promise<void>;
+/**
+ * Caps the bytes the editing core in this thread may allocate at once; an
+ * allocation past the cap fails as if the memory were full. Undefined removes it.
+ */
+declare function setEditWasmHeapLimit(bytes: number | undefined): void;
 /**
  * Constructs a raw wasm `EditSession` replica after ensuring the module is
  * initialized. The `src/yrs/` facade wraps this in the typed `YrsSession`
  * surface — nothing else should call it.
  */
 declare function createEditSession(clientId: number): EditSession;
+/** Structured export of DOCX bytes: `{ok: true, content}` or `{ok: false, failure}` JSON. */
+declare function exportDocxStructuredJson(bytes: Uint8Array, options: string): string;
+/** {@link exportDocxStructuredJson} rendered as Markdown. */
+declare function exportDocxMarkdownJson(bytes: Uint8Array, options: string): string;
+/** Markdown rendering of structured content JSON. */
+declare function renderDocxMarkdownJson(content: string, options: string): string;
+/** Content controls of DOCX bytes: `{ok: true, content}` or `{ok: false, failure}` JSON. */
+declare function listDocxContentControlsJson(bytes: Uint8Array, options: string): string;
+/** The content controls of DOCX bytes matching a query, as {@link listDocxContentControlsJson}. */
+declare function findDocxContentControlsJson(bytes: Uint8Array, query: string, options: string): string;
+/** Markdown rendering of a paged export's JSON, with optional page markers. */
+declare function renderDocxMarkdownWithPagesJson(content: string, options: string): string;
 
-export { EditSession, createEditSession, preloadEditWasm };
+export { EditSession, createEditSession, exportDocxMarkdownJson, exportDocxStructuredJson, findDocxContentControlsJson, listDocxContentControlsJson, preloadEditWasm, renderDocxMarkdownJson, renderDocxMarkdownWithPagesJson, setEditWasmHeapLimit };