@betteroffice/docx 0.4.3 → 0.5.0

package/dist/wasm-edit.d.mts

@@ -112,11 +112,8 @@ declare class EditSession {
      */
     apply_local_update(update: Uint8Array): void;
     /**
-     * Writes `style_id` as the `pStyle` of every paragraph intersecting
-     * `[start, end)`. Only that key changes: this boundary has no style
-     * resolver, so it never fabricates the paragraph attributes or run marks
-     * the style definition would imply. In suggesting mode the property
-     * change is recorded as a `pPrChange` revision.
+     * Applies a paragraph style and rebases inherited character formatting, preserving direct
+     * formatting. Without a source package, only `pStyle` changes.
      */
     apply_paragraph_style(story: string, start_para: string, start_offset: number, end_para: string, end_offset: number, style_id: string, author_name?: string | null, author_date?: string | null): void;
     /**
@@ -146,6 +143,13 @@ declare class EditSession {
      * Applies seed raw operations with deterministic item ordering.
      */
     apply_seed_raw_ops(story: string, ops_json: string): void;
+    /**
+     * Applies the ordered updates of one sync in a single remote transaction,
+     * so the result matches [`EditSession::apply_update`] on the whole diff.
+     * Errors on a non-`Uint8Array` entry or a malformed or oversized update,
+     * before applying any.
+     */
+    apply_update_chunks(updates: Array<any>): void;
     /**
      * Applies a remote or incremental yrs v1 update. It commits without a
      * local origin, so this replica's undo manager never claims it. Errors on
@@ -175,6 +179,7 @@ declare class EditSession {
      * Until the matching `end_shared_reads`, committed reads share story projections of each document state.
      */
     begin_shared_reads(): void;
+    bootstrap_peer(state: Uint8Array, metadata: Uint8Array, source?: Uint8Array | null): void;
     /**
      * Display-only input JSON in, one binary `FrameDelta` v1 out (exposed as
      * a transferable `Uint8Array`). `expected_frame_epoch` is the epoch of the
@@ -209,6 +214,7 @@ declare class EditSession {
      * surviving nearby cell. Errors when the table itself no longer resolves.
      */
     cell_selection(): string;
+    clear_cell_selection(): string | undefined;
     /**
      * Removes the authored `value` from the content-control embed carrying
      * `embed_id`, leaving the control and its content in place: it never
@@ -227,6 +233,10 @@ declare class EditSession {
      * edit must pass back through the full layout path.
      */
     clear_measure_fonts(): void;
+    /**
+     * Clears the pinned input span.
+     */
+    clear_undo_input_time(): void;
     /**
      * Stops queueing and discards anything not yet drained.
      */
@@ -259,6 +269,7 @@ declare class EditSession {
      * failures throw.
      */
     compare_docx_json(original: Uint8Array, revised: Uint8Array, options: string): string;
+    content_control_targets_json(): string;
     /**
      * Adds a story holding one paragraph with `initial_text` (which must not
      * contain paragraph breaks), `p_style` and `alignment`. Receipt:
@@ -266,6 +277,7 @@ declare class EditSession {
      * the story id already exists.
      */
     create_story(story_id: string, initial_text: string, p_style: string, alignment: string): string;
+    decode_font(bytes: Uint8Array): Uint8Array;
     /**
      * Deletes every column the [`TableRange`] `range_json` covers, along with
      * the stories of the cells removed. Always a plain local edit.
@@ -275,7 +287,8 @@ declare class EditSession {
      * Deletes `[start, end)`. Because a range crossing a paragraph boundary
      * includes the boundary pilcrow, a plain delete also merges those
      * paragraphs. Suggesting mode removes nothing and stamps the content
-     * `del` instead. Receipt: `{"revisionId": string|null}`.
+     * `del` instead. Receipt: `{"revisionId": string|null, "range"}`, the
+     * range being what the delete left.
      */
     delete_range(story: string, start_para: string, start_offset: number, end_para: string, end_offset: number, author_name?: string | null, author_date?: string | null): string;
     /**
@@ -309,6 +322,12 @@ declare class EditSession {
      * what a pointer cursor needs.
      */
     display_hit_test_regions_json(page_index: number, x: number, y: number): string;
+    /**
+     * [`EditSession::display_range_rects_region_json`] for many ranges, given as flat
+     * `[from, to, from, to, ...]` pairs. Per range, in order: its rect count, then
+     * `pageIndex, x, y, width, height` for each rect.
+     */
+    display_range_rects_batch(region: string, part_id: string, ranges: Float64Array): Float64Array;
     /**
      * Highlight rectangles for a body document range against the resident
      * display list: a JSON array of `{pageIndex,x,y,width,height}` in
@@ -316,6 +335,10 @@ declare class EditSession {
      * only. Errors when no display list is resident.
      */
     display_range_rects_json(from: number, to: number): string;
+    /**
+     * @internal
+     */
+    display_range_rects_on_pages_json(from: number, to: number, first_page: number, last_page: number): string;
     /**
      * Same rectangles as [`EditSession::display_range_rects_json`], scoped to
      * a region. `region` is `"body"`, `"header"`, `"footer"`, `"footnote"` or
@@ -336,6 +359,7 @@ declare class EditSession {
      * no display list is resident.
      */
     display_vertical_move_json(position: number, direction: string, goal_x: number): string;
+    document_properties_json(): string;
     /**
      * Pops the oldest queued transaction, in arrival order. Byte 0 is `1`
      * when the transaction had no local origin and `0` otherwise; the rest is
@@ -343,12 +367,40 @@ declare class EditSession {
      * started.
      */
     drain_update_event(): Uint8Array;
+    /**
+     * Typing echo model of one font at one shaping size from this session's
+     * resident font store: `{"horizontal","glyphIds","advances","kerning",
+     * "unsafePairs"}`, indexed by the characters of `alphabet`. `kern` is the
+     * run's kerning gate. Errors for an unknown font or a non-positive size.
+     */
+    echo_glyph_set_json(font_id: number, size: number, kern: boolean, alphabet: string): string;
+    /**
+     * A plain local text edit that the resident lowering records, so the next
+     * [`Self::layout_document_with_regions_after_edit`] re-lowers and
+     * re-measures only its paragraph: inserts `text` at the collapsed range,
+     * or deletes `[start, end)` without it. The document changes exactly as
+     * through [`Self::insert_text`] or [`Self::delete_range`] without an
+     * author, and the receipt is theirs. An empty insertion, an edit that
+     * spans paragraphs, or one whose paragraph resident input is not ready
+     * for goes through them instead and records nothing for the relayout.
+     */
+    edit_text_resident(story: string, start_para: string, start_offset: number, end_para: string, end_offset: number, text?: string | null): string;
+    /**
+     * [`EditSession::encode_diff`] as ordered updates for a sync that must
+     * travel in bounded frames: the whole diff when it fits
+     * `max_chunk_bytes`, otherwise causally ordered struct updates followed
+     * by the delete set alone. Each fits the limit except one that carries a
+     * single larger struct. Errors on a malformed state vector or a zero
+     * limit.
+     */
+    encode_diff_chunks(remote_state_vector: Uint8Array, max_chunk_bytes: number): Array<any>;
     /**
      * The yrs v1 update carrying everything this replica has that the peer
      * described by `remote_state_vector` does not. Errors on a malformed
      * state vector.
      */
     encode_diff(remote_state_vector: Uint8Array): Uint8Array;
+    encode_peer_metadata(): Uint8Array;
     /**
      * The full document state as one yrs v1 update. Hand it to
      * [`EditSession::load`] on a fresh replica to reproduce this document.
@@ -460,10 +512,18 @@ declare class EditSession {
      */
     format_text_target_json(target_json: string, delta_json: string): string;
     geometry_position_outline_json(root: string): string;
+    /**
+     * Whether a remote update is waiting on one that has not arrived yet.
+     */
+    has_pending_update(): boolean;
     /**
      * Whether the document has a story with this id.
      */
     has_story(story: string): boolean;
+    /**
+     * Returns active alias-to-canonical relationship ids as a JSON object.
+     */
+    header_footer_aliases_json(): string;
     /**
      * The headings of `story` in document order, classified as the structured export
      * classifies them: `[{"paraId","heading":{"outlineLevel","source"}}]`.
@@ -480,12 +540,12 @@ declare class EditSession {
     insert_column(at_json: string, after: boolean): string;
     /**
      * Inserts one inline image embed at `(story, para_id, offset)`.
-     * `payload_json` is the image's authored payload object, stored as given.
      * The embed occupies one story unit. Receipt:
-     * `{"revisionId": string|null}`. Errors when the payload is not an
-     * object.
+     * `{"revisionId": string|null, "range"}`, the range being where the image
+     * landed. Errors when the payload is not an object.
      */
     insert_image(story: string, para_id: string, offset: number, payload_json: string, author_name?: string | null, author_date?: string | null): string;
+    insert_line_break(story: string, para_id: string, offset: number, author_name?: string | null, author_date?: string | null): string;
     /**
      * Inserts a page-break embed at `(story, para_id, offset)`, occupying one
      * story unit. Always a plain local edit.
@@ -507,13 +567,20 @@ declare class EditSession {
      * creating one story per cell. Errors when either dimension is zero.
      */
     insert_table(story: string, para_id: string, offset: number, rows: number, columns: number, author_name?: string | null, author_date?: string | null): string;
+    /**
+     * Inserts a clipboard table fragment at `(story, para_id, offset)`.
+     * `fragment_json` is a [`DocxTableFragment`] (`packages/docx/src/yrs/clipboardFragment.ts`).
+     * Returns the [`TableFragmentReceipt`] JSON, with `after` carrying the
+     * caret right after the inserted table embed.
+     */
+    insert_table_fragment(story: string, para_id: string, offset: number, fragment_json: string, author_name?: string | null, author_date?: string | null): string;
     /**
      * Inserts `text` at `(story, para_id, offset)`. It must contain no
      * paragraph or line breaks, and it inherits the formatting at the
-     * insertion point. Receipt: `{"revisionId": string|null}` — non-null in
-     * suggesting mode, where the text is stamped `ins` and coalesces into an
-     * adjacent insertion by the same author rather than opening a second
-     * revision.
+     * insertion point. Receipt: `{"revisionId": string|null, "range"}` —
+     * the id is non-null in suggesting mode, where the text is stamped `ins`
+     * and coalesces into an adjacent insertion by the same author rather than
+     * opening a second revision; the range is where the text landed.
      */
     insert_text(story: string, para_id: string, offset: number, text: string, author_name?: string | null, author_date?: string | null): string;
     /**
@@ -528,6 +595,19 @@ declare class EditSession {
      * Errors on unparseable input or on layout failure.
      */
     layout_document_json(input: string): string;
+    /**
+     * [`Self::layout_document_with_regions_retained`] after one edit: the
+     * resident path when that edit was the [`Self::edit_text_resident`] taken
+     * last; see `EngineSession::layout_document_with_regions_after_edit`.
+     */
+    layout_document_with_regions_after_edit(input: string): void;
+    /**
+     * The retained region layout of exactly the first `pages` pages when no
+     * later content can change them, and of the whole document otherwise; see
+     * `EngineSession::layout_document_with_regions_exact_prefix_retained`.
+     * Returns `{ provisional, pages, documentWidth? }` as JSON.
+     */
+    layout_document_with_regions_exact_prefix_retained(input: string, pages: number): string;
     /**
      * Region-layout input JSON in, a paginated envelope with section and page
      * regions already composed as JSON out — ready for the display builder
@@ -551,6 +631,7 @@ declare class EditSession {
      * via [`Self::retained_kernel_inputs_json`].
      */
     layout_document_with_regions_retained_json(input: string): string;
+    layout_document_with_regions_retained_meta(input: string): RetainedLayoutMeta;
     /**
      * Region-layout input JSON in, the font families and sizes that input
      * needs as JSON out, so the host can register fonts before laying out.
@@ -580,11 +661,15 @@ declare class EditSession {
      * empty for every structural kind, which covers no text.
      */
     list_revisions(): string;
+    list_sections_json(): string;
     /**
-     * Hydrates this replica from an encoded yrs v1 update, typically another
-     * replica's [`EditSession::encode_state`] output. Identical to
-     * [`EditSession::apply_update`]; the separate name marks the initial-load
-     * call site. Errors on a malformed update.
+     * Every story: `{"ok":true,"version","stories":[{"story","kind","parent"?,"root","part"?,
+     * "uses"?}]}`, sorted by id.
+     */
+    list_stories_json(): string;
+    /**
+     * Hydrates from a yrs v1 update. The first load after an unseeded open retains prior
+     * comment writes and marks loaded fields differing from seed placeholders as authored.
      */
     load(update: Uint8Array): void;
     /**
@@ -604,6 +689,10 @@ declare class EditSession {
      * another replica seeded them from.
      */
     load_media_sources(json: string): void;
+    /**
+     * Loads separator notes from a yrs v1 update; empty clears them.
+     */
+    load_note_separators(state: Uint8Array): 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
@@ -661,12 +750,26 @@ declare class EditSession {
      * which has no following paragraph to merge with.
      */
     merge_paragraphs(story: string, para_id: string, author_name?: string | null, author_date?: string | null): string;
+    /**
+     * Moves one inline embed in one local transaction.
+     */
+    move_embed(story: string, para_id: string, offset: number, to_story: string, to_para_id: string, to_offset: number): string;
     /**
      * Creates a replica. The host allocates `client_id` (a random 32-bit id
      * is fine) and must keep it unique across the replicas that will merge.
      * Errors unless it is a non-negative safe integer.
      */
     constructor(client_id: number);
+    /**
+     * The style a paragraph break at `(story, para_id, offset)` gives the new paragraph: the
+     * paragraph style's `w:next` when the break falls at the paragraph end and `w:next` names
+     * another paragraph style. `None` otherwise, and for a session without a source package.
+     */
+    next_paragraph_style(story: string, para_id: string, offset: number): string | undefined;
+    /**
+     * The separator notes for another replica; empty when the package has none.
+     */
+    note_separators_state(): Uint8Array;
     /**
      * Parses a DOCX package, optionally seeds its editable stories into this
      * replica, and retains the source bytes for
@@ -697,6 +800,7 @@ declare class EditSession {
      * refuses, which opens with [`EditSession::open_docx`] instead.
      */
     open_docx_preview(bytes: Uint8Array, blocks: number): string | undefined;
+    open_docx_preview_with_budget(bytes: Uint8Array, blocks: number, paragraph_budget?: number | null): string | undefined;
     /**
      * One glyph outline from this session's resident font store:
      * `{"upem":n,"cmds":[{"t":"M"|"L"|"Q"|"C"|"Z", …}]}` — commands in font
@@ -723,8 +827,9 @@ declare class EditSession {
      * `paragraphIds` request field: `{"assignments":[{"part","ordinal",
      * "paraId"}],"patchedParts":[{"part","paraIds":[[ordinal,"ID"]]}]}`,
      * plus `"splicedParts":[{"part","sha256","paragraphs":[[ordinal,"key"]],
-     * "changed":[ordinal]}]`, whose session keys the caller resolves to the
-     * model paragraphs it marks with their ordinals.
+     * "changed":[ordinal],"inserted":[{"before"|"after":ordinal}],"removed":[ordinal]}]`,
+     * whose session keys the caller resolves to the model paragraphs it marks
+     * with their ordinals.
      */
     paragraph_save_plan(): string;
     /**
@@ -735,6 +840,11 @@ declare class EditSession {
      * the boundary once per paragraph. Errors on an unknown story.
      */
     paragraph_spans(story: string): string;
+    /**
+     * The index of the first paragraph of `story` that carries `para_id`, in
+     * `paragraph_spans` order, or -1. Errors on an unknown story.
+     */
+    paragraph_unit(story: string, para_id: string): number;
     /**
      * `[{"paraId","text","properties"}, …]` in document order. `text` is the
      * paragraph's plain text without its pilcrow; `properties` is the
@@ -742,6 +852,7 @@ declare class EditSession {
      * else has been set on it). Errors on an unknown story.
      */
     paragraphs(story: string): string;
+    part_metadata_json(): string;
     /**
      * Gives every paragraph that saves without a Word paragraph ID a fresh
      * one and repairs duplicates; see [`EditingDoc::persist_paragraph_ids`].
@@ -760,6 +871,13 @@ declare class EditSession {
      * U+FFFC in `text`.
      */
     read_paragraphs_json(request: string): string;
+    /**
+     * Paragraph texts of selected stories in one read:
+     * `{"stories"?:"all"|[kind|id…],"byRoot"?,"view","expectVersion"?}` -> `{"ok":true,
+     * "version","view","truncated","stories":[{"story","ok":true,"paragraphs"}|{"story",
+     * "ok":false,"failure"}]}`. Listed entries keep their order; a kind expands in id order.
+     */
+    read_stories_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
@@ -798,6 +916,7 @@ declare class EditSession {
      * Release display pages; an empty result means the request was superseded.
      */
     release_display_pages_frame(pages: Uint32Array, expected_frame_epoch: number): Uint8Array;
+    repeat_content_control_at(story: string, index: number, remove: boolean): boolean;
     /**
      * Replaces `[start, end)` with `text` in one transaction. The inserted
      * text adopts the first replaced unit's formatting; in suggesting mode
@@ -821,6 +940,8 @@ declare class EditSession {
      * Characters the last [`EditSession::apply_delete`] removed.
      */
     resident_deleted_units(): number;
+    resident_geometry_json(root: string, request: string): string;
+    resident_section_revision(): string;
     /**
      * Where a comment's sticky anchors currently sit:
      * `[{"story","start","end"}, …]`, one entry per anchored range, in
@@ -864,11 +985,29 @@ declare class EditSession {
      * fallback after a retained-only region layout.
      */
     retained_kernel_inputs_json(): string;
+    retained_layout_json(): string;
+    /**
+     * Ids of the tracked changes of `story` whose range holds the caret at
+     * `para_id`/`offset`, in `list_revisions` order: `["id", …]`. The caret
+     * and both range ends resolve through their paragraph's span start as
+     * `locate_paragraph` gives it; a range whose paragraph does not resolve
+     * holds nothing. Reads only `story`, unlike `list_revisions`.
+     */
+    revision_ids_at(story: string, para_id: string, offset: number): string;
     /**
      * Author and date stamps for the requested revision ids.
      */
     revision_stamps_json(ids_json: string): string;
+    /**
+     * Resolves what runs inherit under `styles_json`, a package's style definitions or `null`.
+     */
+    run_inheritance(styles_json: string): RunInheritance;
     search_text(query: string, case_sensitive: boolean, limit?: number | null): string;
+    section_margins_json(): string;
+    /**
+     * Initializes imported metadata, creating an unanchored comment when absent.
+     */
+    seed_comment_metadata_json(comment_id: string, patch_json: string): void;
     /**
      * [`EditSession::open_docx`] with seeding always on.
      */
@@ -881,12 +1020,6 @@ declare class EditSession {
      * Selects a story, closing capture unless manual grouping is selected.
      */
     select_story(story: string): void;
-    /**
-     * This peer's current selection as `{"anchor":{"story","paraId","offset"},
-     * "head":{…}}`, or `"null"` before [`EditSession::set_selection`] is
-     * called. Errors when an endpoint no longer resolves.
-     */
-    selection(): string;
     /**
      * Aggregated toolbar and accessibility state over `[start, end)`:
      *
@@ -911,6 +1044,12 @@ declare class EditSession {
      * pending tracked change.
      */
     selection_context(story: string, start_para: string, start_offset: number, end_para: string, end_offset: number): string;
+    /**
+     * This peer's current selection as `{"anchor":{"story","paraId","offset"},
+     * "head":{…}}`, or `"null"` before [`EditSession::set_selection`] is
+     * called. Errors when an endpoint no longer resolves.
+     */
+    selection(): string;
     /**
      * Accepted-view texts around a paragraph-keyed selection:
      * `{"paraId","selectedText","paragraphText","before","after"}`, with
@@ -957,14 +1096,6 @@ declare class EditSession {
      * 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. 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
@@ -974,6 +1105,15 @@ declare class EditSession {
      * position holds no embed.
      */
     set_content_control_value_at(story: string, para_id: string, offset: number, value_json: string): void;
+    /**
+     * Sets the authored `value` (any JSON) on the content-control embed
+     * 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;
+    set_content_control_value_index(story: string, index: number, json: string): void;
     /**
      * Apply admitted paragraph-local text batches directly. Off by default.
      */
@@ -988,6 +1128,11 @@ declare class EditSession {
      * until [`Self::build_display_pages_frame`] builds them.
      */
     set_display_window(start: number, end: number): void;
+    set_document_property(key: string, json: string): boolean;
+    /**
+     * Declares header/footer alias groups before host-side seeding.
+     */
+    set_header_footer_aliases(json: string): void;
     /**
      * Sets or clears the hyperlink attribute over `[start, end)`.
      * `hyperlink_json` is `{"href", "tooltip"?, "rId"?}` or `null` to unlink.
@@ -996,6 +1141,13 @@ declare class EditSession {
      * `null`.
      */
     set_hyperlink(story: string, start_para: string, start_offset: number, end_para: string, end_offset: number, hyperlink_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;
     /**
      * Writes geometry fields onto the image embed carrying `embed_id` in one
      * transaction. Every key of the `geometry_json` object becomes a payload
@@ -1005,13 +1157,6 @@ 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;
     /**
      * Let an eligible resident text edit re-lower only its paragraph. Off by default.
      */
@@ -1047,11 +1192,13 @@ 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;
+    set_part_metadata(json: string, remove_json: string): boolean;
     /**
      * 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;
+    set_section_margins(section: string, json: string): boolean;
     /**
      * Stores this peer's anchor and head as sticky positions, replacing any
      * previous selection. Both endpoints must lie in `story`. The positions
@@ -1060,6 +1207,7 @@ declare class EditSession {
      * with text inserted at it.
      */
     set_selection(story: string, anchor_para: string, anchor_offset: number, head_para: string, head_offset: number): void;
+    set_table_properties(table_json: string, patch_json: string): string;
     /**
      * Sets the preferred width, in twips, of the table `table_json`
      * ([`TableLocator`]) names. Always a plain local edit. Errors unless
@@ -1070,13 +1218,19 @@ declare class EditSession {
      * Changes grouping policy while retaining undo and redo history.
      */
     set_undo_capture_mode(mode: string): void;
+    /**
+     * Pins the input span used to measure the next capture gap.
+     */
+    set_undo_input_time(first: number, last: number): void;
     /**
      * Subscribes `callback(update: Uint8Array, isRemote: 0|1)` to every
      * committed transaction. `update` is v1-encoded — feed it straight to
      * [`EditSession::apply_update`] on a peer — and is copied out of wasm
      * memory, so JS may hold it across later edits. The second argument is
-     * `1` when the transaction had no local origin. One observer per session;
-     * a second call replaces the first, and a throwing callback is ignored.
+     * `1` when the transaction had no local origin; a remote update's own
+     * formatting cleanup follows it as a `0` update to forward. One observer
+     * per session; a second call replaces the first, and a throwing callback
+     * is ignored.
      */
     set_update_observer(callback: Function): void;
     /**
@@ -1085,8 +1239,9 @@ declare class EditSession {
     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`].
+     * `{"accept":[string, …],"reject":[string, …]}` -> `{"ok":true,"revisionIds":[string, …]}`,
+     * the ids resolved, or `{"ok":false,"version","failure"}`. An id that matches nothing is
+     * skipped. See [`EditingDoc::settle_revisions`].
      */
     settle_revisions_json(request: string): string;
     /**
@@ -1190,21 +1345,23 @@ declare class EditSession {
      * not an undo step; later calls keep the history.
      */
     track_undo(): void;
+    /**
+     * Current undo grouping policy.
+     */
+    undo_capture_mode(): string;
     /**
      * Reverts the latest local-origin step and reports whether anything was
      * reverted. Remote and system transactions are excluded by the manager's
      * tracked-origin policy; `false` before tracking starts.
      */
     undo(): boolean;
-    /**
-     * Current undo grouping policy.
-     */
-    undo_capture_mode(): string;
+    update_comment_metadata_json(comment_id: string, patch_json: string): void;
     /**
      * Runs every check of [`EditSession::apply_edits_json`], staging included,
      * without changing anything: `{"ok":true,"baseVersion","wouldApply","previews"}`.
      */
     validate_edits_json(request: string): string;
+    validate_table_fragment(fragment_json: string): void;
     /**
      * The session-scoped version token of the committed document state. It
      * changes on every committed change, local or remote, and when the
@@ -1232,6 +1389,34 @@ declare class EditSession {
     yrs_blocks_for_story(story: string, env_json: string): string;
 }
 
+declare class RetainedLayoutMeta {
+    private constructor();
+    free(): void;
+    [Symbol.dispose](): void;
+    layout_shell_json(): string;
+    page_sizes(): Float64Array;
+    readonly notes_converged: boolean;
+    readonly page_count: number;
+    readonly partial: boolean;
+    readonly provisional: boolean;
+}
+
+/**
+ * What runs inherit under one package's styles; see [`EditSession::run_inheritance`].
+ */
+declare class RunInheritance {
+    private constructor();
+    free(): void;
+    [Symbol.dispose](): void;
+    /**
+     * The attributes, as a JSON object, that seeding merges into the marks of a run of
+     * `run_style` in a paragraph of `paragraph_style` before the run's direct formatting.
+     */
+    attributes(paragraph_style?: string | null, run_style?: string | null, table_run_json?: string | null): string;
+    paragraph_formatting(paragraph_style: string | null | undefined, table_formatting_json: string): string;
+    table_attributes(table_json: string): string;
+}
+
 /**
  * Loader for the docx-edit wasm (the Rust yrs editing core + resident layout
  * engine). External-asset pattern — see ./loadWasmAsset.ts for the init

package/dist/wasm-edit.mjs

@@ -1 +1 @@
-export{e as createEditSession,b as editWasmModule,g as exportDocxMarkdownJson,f as exportDocxStructuredJson,j as findDocxContentControlsJson,i as listDocxContentControlsJson,a as preloadEditWasm,c as preloadEditWasmFrom,h as renderDocxMarkdownJson,k as renderDocxMarkdownWithPagesJson,d as setEditWasmHeapLimit}from'./chunk-SHVHVJUB.mjs';import'./chunk-HGKSOBXK.mjs';import'./chunk-TTRUPDAB.mjs';
+export{e as createEditSession,b as editWasmModule,g as exportDocxMarkdownJson,f as exportDocxStructuredJson,j as findDocxContentControlsJson,i as listDocxContentControlsJson,a as preloadEditWasm,c as preloadEditWasmFrom,h as renderDocxMarkdownJson,k as renderDocxMarkdownWithPagesJson,d as setEditWasmHeapLimit}from'./chunk-CRTTEHZN.mjs';import'./chunk-HGKSOBXK.mjs';import'./chunk-TTRUPDAB.mjs';

package/dist/wasm-layout.d.mts

@@ -28,11 +28,15 @@ declare function hitTestRegionsJson(displayList: string, pageIndex: number, x: n
  * positions live in different docs and are never consulted.
  */
 declare function rangeRectsJson(displayList: string, from: number, to: number): string;
+/** @internal */
+declare function rangeRectsOnPagesJson(displayList: string, from: number, to: number, firstPage: number, lastPage: number): string;
 /**
  * True when the embedded layout wasm carries the session-handle query exports.
  * Callers gate the handle path on this and otherwise use the JSON-arg exports.
  */
 declare function hasDisplayListSession(): boolean;
+/** @internal */
+declare function hasRangeRectsOnPages(): boolean;
 /**
  * True when the embedded layout wasm carries the region-aware range-rect
  * exports (`range_rects_region_json` and its by-handle twin). Callers gate
@@ -78,6 +82,8 @@ declare function verticalMoveByHandle(handle: number, position: number, directio
  * Throws when the export is absent or the handle is unknown/closed.
  */
 declare function rangeRectsByHandle(handle: number, from: number, to: number): string;
+/** @internal */
+declare function rangeRectsOnPagesByHandle(handle: number, from: number, to: number, firstPage: number, lastPage: number): string;
 /**
  * Region-aware highlight rects: `region` is `"body" | "header" | "footer"`,
  * and `rId` scopes a header/footer to one part (empty string for body, or to
@@ -132,4 +138,4 @@ declare function measureParagraphJson(input: string): string;
  */
 declare function outlineGlyphJson(fontId: number, glyphId: number): string;
 
-export { buildDisplayListJson, clearMeasureFonts, closeDisplayList, hasDisplayListSession, hasDisplayListUpdate, hasRangeRectsRegion, hitTestRegionsByHandle, hitTestRegionsJson, layoutDocumentJson, measureParagraphJson, openDisplayList, outlineGlyphJson, preloadLayoutWasm, rangeRectsByHandle, rangeRectsJson, rangeRectsRegionByHandle, rangeRectsRegionJson, registerMeasureFont, registerSubstituteMeasureFont, updateDisplayList, verticalMoveByHandle, verticalMoveJson };
+export { buildDisplayListJson, clearMeasureFonts, closeDisplayList, hasDisplayListSession, hasDisplayListUpdate, hasRangeRectsOnPages, hasRangeRectsRegion, hitTestRegionsByHandle, hitTestRegionsJson, layoutDocumentJson, measureParagraphJson, openDisplayList, outlineGlyphJson, preloadLayoutWasm, rangeRectsByHandle, rangeRectsJson, rangeRectsOnPagesByHandle, rangeRectsOnPagesJson, rangeRectsRegionByHandle, rangeRectsRegionJson, registerMeasureFont, registerSubstituteMeasureFont, updateDisplayList, verticalMoveByHandle, verticalMoveJson };

package/dist/wasm-layout.mjs

@@ -1 +1 @@
-export{p as buildDisplayListJson,t as clearMeasureFonts,g as closeDisplayList,d as hasDisplayListSession,i as hasDisplayListUpdate,e as hasRangeRectsRegion,j as hitTestRegionsByHandle,b as hitTestRegionsJson,q as layoutDocumentJson,u as measureParagraphJson,f as openDisplayList,v as outlineGlyphJson,a as preloadLayoutWasm,m as rangeRectsByHandle,c as rangeRectsJson,o as rangeRectsRegionByHandle,n as rangeRectsRegionJson,r as registerMeasureFont,s as registerSubstituteMeasureFont,h as updateDisplayList,l as verticalMoveByHandle,k as verticalMoveJson}from'./chunk-3RPZ44TT.mjs';import'./chunk-HGKSOBXK.mjs';import'./chunk-TTRUPDAB.mjs';
+export{s as buildDisplayListJson,w as clearMeasureFonts,i as closeDisplayList,e as hasDisplayListSession,k as hasDisplayListUpdate,f as hasRangeRectsOnPages,g as hasRangeRectsRegion,l as hitTestRegionsByHandle,b as hitTestRegionsJson,t as layoutDocumentJson,x as measureParagraphJson,h as openDisplayList,y as outlineGlyphJson,a as preloadLayoutWasm,o as rangeRectsByHandle,c as rangeRectsJson,p as rangeRectsOnPagesByHandle,d as rangeRectsOnPagesJson,r as rangeRectsRegionByHandle,q as rangeRectsRegionJson,u as registerMeasureFont,v as registerSubstituteMeasureFont,j as updateDisplayList,n as verticalMoveByHandle,m as verticalMoveJson}from'./chunk-WIDM4EMT.mjs';import'./chunk-HGKSOBXK.mjs';import'./chunk-TTRUPDAB.mjs';

package/dist/wasm-opc.mjs

@@ -1 +1 @@
-export{a as preloadOpcWasm,c as rezipContainer,b as unzipContainer}from'./chunk-AXFMDV66.mjs';import'./chunk-HGKSOBXK.mjs';import'./chunk-TTRUPDAB.mjs';
+export{a as preloadOpcWasm,c as rezipContainer,b as unzipContainer}from'./chunk-7WIUNGQW.mjs';import'./chunk-HGKSOBXK.mjs';import'./chunk-TTRUPDAB.mjs';