@apollohg/react-native-prose-editor 0.3.0 → 0.4.1

package/dist/NativeEditorBridge.d.ts

@@ -1,3 +1,4 @@
+import type { SchemaDefinition } from './schemas';
 export interface NativeEditorModule {
     editorCreate(configJson: string): number;
     editorDestroy(editorId: number): void;
@@ -17,6 +18,7 @@ export interface NativeEditorModule {
     editorGetHtml(editorId: number): string;
     editorSetJson(editorId: number, json: string): string;
     editorGetJson(editorId: number): string;
+    editorGetContentSnapshot(editorId: number): string;
     editorReplaceHtml(editorId: number, html: string): string;
     editorReplaceJson(editorId: number, json: string): string;
     editorInsertText(editorId: number, pos: number, text: string): string;
@@ -30,8 +32,10 @@ export interface NativeEditorModule {
     editorSetMark(editorId: number, markName: string, attrsJson: string): string;
     editorUnsetMark(editorId: number, markName: string): string;
     editorToggleBlockquote(editorId: number): string;
+    editorToggleHeading(editorId: number, level: number): string;
     editorSetSelection(editorId: number, anchor: number, head: number): void;
     editorGetSelection(editorId: number): string;
+    editorGetSelectionState(editorId: number): string;
     editorGetCurrentState(editorId: number): string;
     editorInsertTextScalar(editorId: number, scalarPos: number, text: string): string;
     editorDeleteScalarRange(editorId: number, scalarFrom: number, scalarTo: number): string;
@@ -43,6 +47,7 @@ export interface NativeEditorModule {
     editorSetMarkAtSelectionScalar(editorId: number, scalarAnchor: number, scalarHead: number, markName: string, attrsJson: string): string;
     editorUnsetMarkAtSelectionScalar(editorId: number, scalarAnchor: number, scalarHead: number, markName: string): string;
     editorToggleBlockquoteAtSelectionScalar(editorId: number, scalarAnchor: number, scalarHead: number): string;
+    editorToggleHeadingAtSelectionScalar(editorId: number, scalarAnchor: number, scalarHead: number, level: number): string;
     editorWrapInListAtSelectionScalar(editorId: number, scalarAnchor: number, scalarHead: number, listType: string): string;
     editorUnwrapFromListAtSelectionScalar(editorId: number, scalarAnchor: number, scalarHead: number): string;
     editorIndentListItemAtSelectionScalar(editorId: number, scalarAnchor: number, scalarHead: number): string;
@@ -90,6 +95,11 @@ export interface RenderElement {
     attrs?: Record<string, unknown>;
     listContext?: ListContext;
 }
+interface RenderBlocksPatch {
+    startIndex: number;
+    deleteCount: number;
+    renderBlocks: RenderElement[][];
+}
 export interface ActiveState {
     marks: Record<string, boolean>;
     markAttrs: Record<string, Record<string, unknown>>;
@@ -104,9 +114,16 @@ export interface HistoryState {
 }
 export interface EditorUpdate {
     renderElements: RenderElement[];
+    renderBlocks?: RenderElement[][];
+    renderPatch?: RenderBlocksPatch;
     selection: Selection;
     activeState: ActiveState;
     historyState: HistoryState;
+    documentVersion?: number;
+}
+export interface ContentSnapshot {
+    html: string;
+    json: DocumentJSON;
 }
 export interface DocumentJSON {
     [key: string]: unknown;
@@ -125,7 +142,7 @@ export interface CollaborationResult {
 }
 export type EncodedCollaborationStateInput = Uint8Array | readonly number[] | string;
 export declare function normalizeActiveState(raw: unknown): ActiveState;
-export declare function parseEditorUpdateJson(json: string): EditorUpdate | null;
+export declare function parseEditorUpdateJson(json: string, previousRenderBlocks?: RenderElement[][]): EditorUpdate | null;
 export declare function encodeCollaborationStateBase64(encodedState: EncodedCollaborationStateInput): string;
 export declare function decodeCollaborationStateBase64(base64: string): Uint8Array;
 export declare function parseCollaborationResultJson(json: string): CollaborationResult;
@@ -135,6 +152,10 @@ export declare class NativeEditorBridge {
     private _editorId;
     private _destroyed;
     private _lastSelection;
+    private _documentVersion;
+    private _cachedHtml;
+    private _cachedJsonString;
+    private _renderBlocksCache;
     private constructor();
     /** Create a new editor instance backed by the Rust engine. */
     static create(config?: {
@@ -154,8 +175,14 @@ export declare class NativeEditorBridge {
     getHtml(): string;
     /** Set content from ProseMirror JSON. Returns render elements. */
     setJson(doc: DocumentJSON): RenderElement[];
+    /** Set content from a serialized ProseMirror JSON string. Returns render elements. */
+    setJsonString(jsonString: string): RenderElement[];
+    /** Get content as raw ProseMirror JSON string. */
+    getJsonString(): string;
     /** Get content as ProseMirror JSON. */
     getJson(): DocumentJSON;
+    /** Get both HTML and JSON content in one native roundtrip. */
+    getContentSnapshot(): ContentSnapshot;
     /** Insert text at a document position. Returns the full update. */
     insertText(pos: number, text: string): EditorUpdate | null;
     /** Delete a range [from, to). Returns the full update. */
@@ -170,6 +197,8 @@ export declare class NativeEditorBridge {
     unsetMark(markType: string): EditorUpdate | null;
     /** Toggle blockquote wrapping for the current block selection. */
     toggleBlockquote(): EditorUpdate | null;
+    /** Toggle a heading level on the current block selection. */
+    toggleHeading(level: number): EditorUpdate | null;
     /** Set the document selection by anchor and head positions. */
     setSelection(anchor: number, head: number): void;
     /** Get the current selection from the Rust engine (synchronous native call).
@@ -180,6 +209,8 @@ export declare class NativeEditorBridge {
     updateSelectionFromNative(anchor: number, head: number): void;
     /** Get the current full state from Rust (render elements, selection, etc.). */
     getCurrentState(): EditorUpdate | null;
+    /** Get the current selection-related state without render elements. */
+    getSelectionState(): EditorUpdate | null;
     /** Split the block at a position (Enter key). */
     splitBlock(pos: number): EditorUpdate | null;
     /** Insert HTML content at the current selection. */
@@ -192,6 +223,8 @@ export declare class NativeEditorBridge {
     replaceHtml(html: string): EditorUpdate | null;
     /** Replace entire document with JSON via transaction (preserves undo history). */
     replaceJson(doc: DocumentJSON): EditorUpdate | null;
+    /** Replace entire document with a serialized JSON transaction. */
+    replaceJsonString(jsonString: string): EditorUpdate | null;
     /** Undo the last operation. Returns update or null if nothing to undo. */
     undo(): EditorUpdate | null;
     /** Redo the last undone operation. Returns update or null if nothing to redo. */
@@ -210,6 +243,10 @@ export declare class NativeEditorBridge {
     outdentListItem(): EditorUpdate | null;
     /** Insert a void node (e.g. 'horizontalRule') at the current selection. */
     insertNode(nodeType: string): EditorUpdate | null;
+    parseUpdateJson(json: string): EditorUpdate | null;
+    private noteUpdate;
+    private parseAndNoteUpdate;
+    private invalidateContentCaches;
     private assertNotDestroyed;
     private currentScalarSelection;
 }
@@ -220,6 +257,7 @@ export declare class NativeCollaborationBridge {
     static create(config?: {
         clientId?: number;
         fragmentName?: string;
+        schema?: SchemaDefinition;
         initialDocumentJson?: DocumentJSON;
         initialEncodedState?: EncodedCollaborationStateInput;
         localAwareness?: Record<string, unknown>;
@@ -240,3 +278,4 @@ export declare class NativeCollaborationBridge {
     clearLocalAwareness(): CollaborationResult;
     private assertNotDestroyed;
 }
+export {};

package/dist/NativeEditorBridge.js

@@ -46,7 +46,7 @@ function parseRenderElements(json) {
         throw new Error(ERR_NATIVE_RESPONSE);
     }
 }
-function parseEditorUpdateJson(json) {
+function parseEditorUpdateJson(json, previousRenderBlocks) {
     if (!json || json === '')
         return null;
     try {
@@ -54,14 +54,72 @@ function parseEditorUpdateJson(json) {
         if ('error' in parsed) {
             throw new Error(`NativeEditorBridge: ${parsed.error}`);
         }
+        const renderBlocks = Array.isArray(parsed.renderBlocks)
+            ? parsed.renderBlocks
+            : applyRenderBlocksPatch(previousRenderBlocks, parsed.renderPatch != null && typeof parsed.renderPatch === 'object'
+                ? parsed.renderPatch
+                : undefined);
+        const renderPatch = parsed.renderPatch != null && typeof parsed.renderPatch === 'object'
+            ? parsed.renderPatch
+            : undefined;
         return {
-            renderElements: (parsed.renderElements ?? []),
+            renderElements: Array.isArray(parsed.renderElements)
+                ? parsed.renderElements
+                : flattenRenderBlocks(renderBlocks),
+            renderBlocks,
+            renderPatch,
             selection: (parsed.selection ?? { type: 'text', anchor: 0, head: 0 }),
             activeState: normalizeActiveState(parsed.activeState),
             historyState: (parsed.historyState ?? {
                 canUndo: false,
                 canRedo: false,
             }),
+            documentVersion: typeof parsed.documentVersion === 'number' ? parsed.documentVersion : undefined,
+        };
+    }
+    catch (e) {
+        if (e instanceof Error && e.message.startsWith('NativeEditorBridge:')) {
+            throw e;
+        }
+        throw new Error(ERR_NATIVE_RESPONSE);
+    }
+}
+function flattenRenderBlocks(renderBlocks) {
+    if (!renderBlocks || renderBlocks.length === 0) {
+        return [];
+    }
+    return renderBlocks.flat();
+}
+function applyRenderBlocksPatch(previousRenderBlocks, renderPatch) {
+    if (!previousRenderBlocks || !renderPatch) {
+        return undefined;
+    }
+    const { startIndex, deleteCount, renderBlocks } = renderPatch;
+    if (!Number.isInteger(startIndex) ||
+        !Number.isInteger(deleteCount) ||
+        startIndex < 0 ||
+        deleteCount < 0 ||
+        startIndex > previousRenderBlocks.length ||
+        startIndex + deleteCount > previousRenderBlocks.length) {
+        return undefined;
+    }
+    return [
+        ...previousRenderBlocks.slice(0, startIndex),
+        ...renderBlocks,
+        ...previousRenderBlocks.slice(startIndex + deleteCount),
+    ];
+}
+function parseContentSnapshotJson(json) {
+    try {
+        const parsed = JSON.parse(json);
+        if ('error' in parsed) {
+            throw new Error(`NativeEditorBridge: ${parsed.error}`);
+        }
+        return {
+            html: typeof parsed.html === 'string' ? parsed.html : '',
+            json: parsed.json != null && typeof parsed.json === 'object'
+                ? parsed.json
+                : {},
         };
     }
     catch (e) {
@@ -220,6 +278,10 @@ class NativeEditorBridge {
     constructor(editorId) {
         this._destroyed = false;
         this._lastSelection = { type: 'text', anchor: 0, head: 0 };
+        this._documentVersion = 0;
+        this._cachedHtml = null;
+        this._cachedJsonString = null;
+        this._renderBlocksCache = null;
         this._editorId = editorId;
     }
     /** Create a new editor instance backed by the Rust engine. */
@@ -254,57 +316,88 @@ class NativeEditorBridge {
         if (this._destroyed)
             return;
         this._destroyed = true;
+        this._renderBlocksCache = null;
         getNativeModule().editorDestroy(this._editorId);
     }
     /** Set content from HTML. Returns render elements for display. */
     setHtml(html) {
         this.assertNotDestroyed();
+        this.invalidateContentCaches();
+        this._renderBlocksCache = null;
         const json = getNativeModule().editorSetHtml(this._editorId, html);
         return parseRenderElements(json);
     }
     /** Get content as HTML. */
     getHtml() {
         this.assertNotDestroyed();
-        return getNativeModule().editorGetHtml(this._editorId);
+        if (this._cachedHtml?.version === this._documentVersion) {
+            return this._cachedHtml.value;
+        }
+        const html = getNativeModule().editorGetHtml(this._editorId);
+        this._cachedHtml = { version: this._documentVersion, value: html };
+        return html;
     }
     /** Set content from ProseMirror JSON. Returns render elements. */
     setJson(doc) {
+        return this.setJsonString(JSON.stringify(doc));
+    }
+    /** Set content from a serialized ProseMirror JSON string. Returns render elements. */
+    setJsonString(jsonString) {
         this.assertNotDestroyed();
-        const json = getNativeModule().editorSetJson(this._editorId, JSON.stringify(doc));
+        this.invalidateContentCaches();
+        this._renderBlocksCache = null;
+        const json = getNativeModule().editorSetJson(this._editorId, jsonString);
         return parseRenderElements(json);
     }
+    /** Get content as raw ProseMirror JSON string. */
+    getJsonString() {
+        this.assertNotDestroyed();
+        if (this._cachedJsonString?.version === this._documentVersion) {
+            return this._cachedJsonString.value;
+        }
+        const json = getNativeModule().editorGetJson(this._editorId);
+        this._cachedJsonString = { version: this._documentVersion, value: json };
+        return json;
+    }
     /** Get content as ProseMirror JSON. */
     getJson() {
+        return parseDocumentJSON(this.getJsonString());
+    }
+    /** Get both HTML and JSON content in one native roundtrip. */
+    getContentSnapshot() {
         this.assertNotDestroyed();
-        const json = getNativeModule().editorGetJson(this._editorId);
-        return parseDocumentJSON(json);
+        if (this._cachedHtml?.version === this._documentVersion &&
+            this._cachedJsonString?.version === this._documentVersion) {
+            return {
+                html: this._cachedHtml.value,
+                json: parseDocumentJSON(this._cachedJsonString.value),
+            };
+        }
+        const snapshot = parseContentSnapshotJson(getNativeModule().editorGetContentSnapshot(this._editorId));
+        this._cachedHtml = { version: this._documentVersion, value: snapshot.html };
+        this._cachedJsonString = {
+            version: this._documentVersion,
+            value: JSON.stringify(snapshot.json),
+        };
+        return snapshot;
     }
     /** Insert text at a document position. Returns the full update. */
     insertText(pos, text) {
         this.assertNotDestroyed();
         const json = getNativeModule().editorInsertText(this._editorId, pos, text);
-        const update = parseEditorUpdateJson(json);
-        if (update)
-            this._lastSelection = update.selection;
-        return update;
+        return this.parseAndNoteUpdate(json);
     }
     /** Delete a range [from, to). Returns the full update. */
     deleteRange(from, to) {
         this.assertNotDestroyed();
         const json = getNativeModule().editorDeleteRange(this._editorId, from, to);
-        const update = parseEditorUpdateJson(json);
-        if (update)
-            this._lastSelection = update.selection;
-        return update;
+        return this.parseAndNoteUpdate(json);
     }
     /** Replace the current selection with text atomically. */
     replaceSelectionText(text) {
         this.assertNotDestroyed();
         const json = getNativeModule().editorReplaceSelectionText(this._editorId, text);
-        const update = parseEditorUpdateJson(json);
-        if (update)
-            this._lastSelection = update.selection;
-        return update;
+        return this.parseAndNoteUpdate(json);
     }
     /** Toggle a mark (bold, italic, etc.) on the current selection. */
     toggleMark(markType) {
@@ -313,10 +406,7 @@ class NativeEditorBridge {
         const json = scalarSelection
             ? getNativeModule().editorToggleMarkAtSelectionScalar(this._editorId, scalarSelection.anchor, scalarSelection.head, markType)
             : getNativeModule().editorToggleMark(this._editorId, markType);
-        const update = parseEditorUpdateJson(json);
-        if (update)
-            this._lastSelection = update.selection;
-        return update;
+        return this.parseAndNoteUpdate(json);
     }
     /** Set a mark with attrs on the current selection. */
     setMark(markType, attrs) {
@@ -326,10 +416,7 @@ class NativeEditorBridge {
         const json = scalarSelection
             ? getNativeModule().editorSetMarkAtSelectionScalar(this._editorId, scalarSelection.anchor, scalarSelection.head, markType, attrsJson)
             : getNativeModule().editorSetMark(this._editorId, markType, attrsJson);
-        const update = parseEditorUpdateJson(json);
-        if (update)
-            this._lastSelection = update.selection;
-        return update;
+        return this.parseAndNoteUpdate(json);
     }
     /** Remove a mark from the current selection. */
     unsetMark(markType) {
@@ -338,10 +425,7 @@ class NativeEditorBridge {
         const json = scalarSelection
             ? getNativeModule().editorUnsetMarkAtSelectionScalar(this._editorId, scalarSelection.anchor, scalarSelection.head, markType)
             : getNativeModule().editorUnsetMark(this._editorId, markType);
-        const update = parseEditorUpdateJson(json);
-        if (update)
-            this._lastSelection = update.selection;
-        return update;
+        return this.parseAndNoteUpdate(json);
     }
     /** Toggle blockquote wrapping for the current block selection. */
     toggleBlockquote() {
@@ -350,10 +434,19 @@ class NativeEditorBridge {
         const json = scalarSelection
             ? getNativeModule().editorToggleBlockquoteAtSelectionScalar(this._editorId, scalarSelection.anchor, scalarSelection.head)
             : getNativeModule().editorToggleBlockquote(this._editorId);
-        const update = parseEditorUpdateJson(json);
-        if (update)
-            this._lastSelection = update.selection;
-        return update;
+        return this.parseAndNoteUpdate(json);
+    }
+    /** Toggle a heading level on the current block selection. */
+    toggleHeading(level) {
+        this.assertNotDestroyed();
+        if (!Number.isInteger(level) || level < 1 || level > 6) {
+            throw new Error('NativeEditorBridge: invalid heading level');
+        }
+        const scalarSelection = this.currentScalarSelection();
+        const json = scalarSelection
+            ? getNativeModule().editorToggleHeadingAtSelectionScalar(this._editorId, scalarSelection.anchor, scalarSelection.head, level)
+            : getNativeModule().editorToggleHeading(this._editorId, level);
+        return this.parseAndNoteUpdate(json);
     }
     /** Set the document selection by anchor and head positions. */
     setSelection(anchor, head) {
@@ -387,82 +480,65 @@ class NativeEditorBridge {
     getCurrentState() {
         this.assertNotDestroyed();
         const json = getNativeModule().editorGetCurrentState(this._editorId);
-        const update = parseEditorUpdateJson(json);
-        if (update)
-            this._lastSelection = update.selection;
-        return update;
+        return this.parseAndNoteUpdate(json);
+    }
+    /** Get the current selection-related state without render elements. */
+    getSelectionState() {
+        this.assertNotDestroyed();
+        const json = getNativeModule().editorGetSelectionState(this._editorId);
+        return this.parseAndNoteUpdate(json);
     }
     /** Split the block at a position (Enter key). */
     splitBlock(pos) {
         this.assertNotDestroyed();
         const json = getNativeModule().editorSplitBlock(this._editorId, pos);
-        const update = parseEditorUpdateJson(json);
-        if (update)
-            this._lastSelection = update.selection;
-        return update;
+        return this.parseAndNoteUpdate(json);
     }
     /** Insert HTML content at the current selection. */
     insertContentHtml(html) {
         this.assertNotDestroyed();
         const json = getNativeModule().editorInsertContentHtml(this._editorId, html);
-        const update = parseEditorUpdateJson(json);
-        if (update)
-            this._lastSelection = update.selection;
-        return update;
+        return this.parseAndNoteUpdate(json);
     }
     /** Insert JSON content at the current selection. */
     insertContentJson(doc) {
         this.assertNotDestroyed();
         const json = getNativeModule().editorInsertContentJson(this._editorId, JSON.stringify(doc));
-        const update = parseEditorUpdateJson(json);
-        if (update)
-            this._lastSelection = update.selection;
-        return update;
+        return this.parseAndNoteUpdate(json);
     }
     /** Insert JSON content at an explicit scalar selection. */
     insertContentJsonAtSelectionScalar(scalarAnchor, scalarHead, doc) {
         this.assertNotDestroyed();
         const json = getNativeModule().editorInsertContentJsonAtSelectionScalar(this._editorId, scalarAnchor, scalarHead, JSON.stringify(doc));
-        const update = parseEditorUpdateJson(json);
-        if (update)
-            this._lastSelection = update.selection;
-        return update;
+        return this.parseAndNoteUpdate(json);
     }
     /** Replace entire document with HTML via transaction (preserves undo history). */
     replaceHtml(html) {
         this.assertNotDestroyed();
         const json = getNativeModule().editorReplaceHtml(this._editorId, html);
-        const update = parseEditorUpdateJson(json);
-        if (update)
-            this._lastSelection = update.selection;
-        return update;
+        return this.parseAndNoteUpdate(json);
     }
     /** Replace entire document with JSON via transaction (preserves undo history). */
     replaceJson(doc) {
+        return this.replaceJsonString(JSON.stringify(doc));
+    }
+    /** Replace entire document with a serialized JSON transaction. */
+    replaceJsonString(jsonString) {
         this.assertNotDestroyed();
-        const json = getNativeModule().editorReplaceJson(this._editorId, JSON.stringify(doc));
-        const update = parseEditorUpdateJson(json);
-        if (update)
-            this._lastSelection = update.selection;
-        return update;
+        const json = getNativeModule().editorReplaceJson(this._editorId, jsonString);
+        return this.parseAndNoteUpdate(json);
     }
     /** Undo the last operation. Returns update or null if nothing to undo. */
     undo() {
         this.assertNotDestroyed();
         const json = getNativeModule().editorUndo(this._editorId);
-        const update = parseEditorUpdateJson(json);
-        if (update)
-            this._lastSelection = update.selection;
-        return update;
+        return this.parseAndNoteUpdate(json);
     }
     /** Redo the last undone operation. Returns update or null if nothing to redo. */
     redo() {
         this.assertNotDestroyed();
         const json = getNativeModule().editorRedo(this._editorId);
-        const update = parseEditorUpdateJson(json);
-        if (update)
-            this._lastSelection = update.selection;
-        return update;
+        return this.parseAndNoteUpdate(json);
     }
     /** Check if undo is available. */
     canUndo() {
@@ -486,10 +562,7 @@ class NativeEditorBridge {
             : scalarSelection
                 ? getNativeModule().editorWrapInListAtSelectionScalar(this._editorId, scalarSelection.anchor, scalarSelection.head, listType)
                 : getNativeModule().editorWrapInList(this._editorId, listType);
-        const update = parseEditorUpdateJson(json);
-        if (update)
-            this._lastSelection = update.selection;
-        return update;
+        return this.parseAndNoteUpdate(json);
     }
     /** Unwrap the current list item back to a paragraph. */
     unwrapFromList() {
@@ -498,10 +571,7 @@ class NativeEditorBridge {
         const json = scalarSelection
             ? getNativeModule().editorUnwrapFromListAtSelectionScalar(this._editorId, scalarSelection.anchor, scalarSelection.head)
             : getNativeModule().editorUnwrapFromList(this._editorId);
-        const update = parseEditorUpdateJson(json);
-        if (update)
-            this._lastSelection = update.selection;
-        return update;
+        return this.parseAndNoteUpdate(json);
     }
     /** Indent the current list item into a nested list. */
     indentListItem() {
@@ -510,10 +580,7 @@ class NativeEditorBridge {
         const json = scalarSelection
             ? getNativeModule().editorIndentListItemAtSelectionScalar(this._editorId, scalarSelection.anchor, scalarSelection.head)
             : getNativeModule().editorIndentListItem(this._editorId);
-        const update = parseEditorUpdateJson(json);
-        if (update)
-            this._lastSelection = update.selection;
-        return update;
+        return this.parseAndNoteUpdate(json);
     }
     /** Outdent the current list item to the parent list level. */
     outdentListItem() {
@@ -522,10 +589,7 @@ class NativeEditorBridge {
         const json = scalarSelection
             ? getNativeModule().editorOutdentListItemAtSelectionScalar(this._editorId, scalarSelection.anchor, scalarSelection.head)
             : getNativeModule().editorOutdentListItem(this._editorId);
-        const update = parseEditorUpdateJson(json);
-        if (update)
-            this._lastSelection = update.selection;
-        return update;
+        return this.parseAndNoteUpdate(json);
     }
     /** Insert a void node (e.g. 'horizontalRule') at the current selection. */
     insertNode(nodeType) {
@@ -534,11 +598,41 @@ class NativeEditorBridge {
         const json = scalarSelection
             ? getNativeModule().editorInsertNodeAtSelectionScalar(this._editorId, scalarSelection.anchor, scalarSelection.head, nodeType)
             : getNativeModule().editorInsertNode(this._editorId, nodeType);
-        const update = parseEditorUpdateJson(json);
-        if (update)
-            this._lastSelection = update.selection;
+        return this.parseAndNoteUpdate(json);
+    }
+    parseUpdateJson(json) {
+        this.assertNotDestroyed();
+        return this.parseAndNoteUpdate(json);
+    }
+    noteUpdate(update) {
+        if (!update) {
+            return;
+        }
+        this._lastSelection = update.selection;
+        if (update.renderBlocks) {
+            this._renderBlocksCache = update.renderBlocks;
+        }
+        if (typeof update.documentVersion !== 'number') {
+            this.invalidateContentCaches();
+            return;
+        }
+        if (update.documentVersion !== this._documentVersion) {
+            this._documentVersion = update.documentVersion;
+            this.invalidateContentCaches();
+        }
+    }
+    parseAndNoteUpdate(json) {
+        let update = parseEditorUpdateJson(json, this._renderBlocksCache ?? undefined);
+        if (update?.renderPatch && !update.renderBlocks) {
+            update = parseEditorUpdateJson(getNativeModule().editorGetCurrentState(this._editorId), this._renderBlocksCache ?? undefined);
+        }
+        this.noteUpdate(update);
         return update;
     }
+    invalidateContentCaches() {
+        this._cachedHtml = null;
+        this._cachedJsonString = null;
+    }
     assertNotDestroyed() {
         if (this._destroyed) {
             throw new Error(ERR_DESTROYED);

package/dist/NativeRichTextEditor.d.ts

@@ -1,7 +1,7 @@
 import React from 'react';
 import { type StyleProp, type ViewStyle } from 'react-native';
 import { type ActiveState, type DocumentJSON, type HistoryState, type Selection } from './NativeEditorBridge';
-import { type EditorToolbarItem } from './EditorToolbar';
+import { type EditorToolbarHeadingLevel, type EditorToolbarItem } from './EditorToolbar';
 import { type EditorTheme } from './EditorTheme';
 import { type EditorAddons } from './addons';
 import { type SchemaDefinition } from './schemas';
@@ -38,6 +38,8 @@ export interface NativeRichTextEditorProps {
     value?: string;
     /** Controlled ProseMirror JSON content. Ignored if value is set. */
     valueJSON?: DocumentJSON;
+    /** Optional stable revision hint for `valueJSON` to avoid reserializing equal docs on rerender. */
+    valueJSONRevision?: string | number;
     /** Schema definition. Defaults to tiptapSchema if not provided. */
     schema?: SchemaDefinition;
     /** Placeholder text shown when editor is empty. */
@@ -104,6 +106,8 @@ export interface NativeRichTextEditorRef {
     unsetLink(): void;
     /** Toggle blockquote wrapping around the current block selection. */
     toggleBlockquote(): void;
+    /** Toggle a heading level on the current block selection. */
+    toggleHeading(level: EditorToolbarHeadingLevel): void;
     /** Toggle a list type (bulletList or orderedList). */
     toggleList(listType: 'bulletList' | 'orderedList'): void;
     /** Indent the current list item. */