@apollohg/react-native-prose-editor 0.4.0 → 0.4.2

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;
@@ -33,6 +35,7 @@ export interface NativeEditorModule {
     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;
@@ -92,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>>;
@@ -106,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;
@@ -127,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,8 +150,13 @@ export declare function parseCollaborationResultJson(json: string): Collaboratio
 export declare function _resetNativeModuleCache(): void;
 export declare class NativeEditorBridge {
     private _editorId;
+    private _schema?;
     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?: {
@@ -156,8 +176,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. */
@@ -184,6 +210,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. */
@@ -196,6 +224,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. */
@@ -214,6 +244,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;
 }
@@ -224,6 +258,7 @@ export declare class NativeCollaborationBridge {
     static create(config?: {
         clientId?: number;
         fragmentName?: string;
+        schema?: SchemaDefinition;
         initialDocumentJson?: DocumentJSON;
         initialEncodedState?: EncodedCollaborationStateInput;
         localAwareness?: Record<string, unknown>;
@@ -244,3 +279,4 @@ export declare class NativeCollaborationBridge {
     clearLocalAwareness(): CollaborationResult;
     private assertNotDestroyed;
 }
+export {};

package/dist/NativeEditorBridge.js

@@ -8,6 +8,7 @@ exports.decodeCollaborationStateBase64 = decodeCollaborationStateBase64;
 exports.parseCollaborationResultJson = parseCollaborationResultJson;
 exports._resetNativeModuleCache = _resetNativeModuleCache;
 const expo_modules_core_1 = require("expo-modules-core");
+const schemas_1 = require("./schemas");
 const ERR_DESTROYED = 'NativeEditorBridge: editor has been destroyed';
 const ERR_NATIVE_RESPONSE = 'NativeEditorBridge: invalid JSON response from native module';
 const ERR_INVALID_ENCODED_STATE = 'NativeEditorBridge: invalid encoded collaboration state';
@@ -46,7 +47,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 +55,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) {
@@ -175,6 +234,16 @@ function encodeCollaborationStateBase64(encodedState) {
 function decodeCollaborationStateBase64(base64) {
     return base64ToBytes(base64);
 }
+function normalizeDocumentJsonString(jsonString, schema) {
+    try {
+        const parsed = JSON.parse(jsonString);
+        const normalized = (0, schemas_1.normalizeDocumentJson)(parsed, schema);
+        return normalized === parsed ? jsonString : JSON.stringify(normalized);
+    }
+    catch {
+        return jsonString;
+    }
+}
 function parseCollaborationResultJson(json) {
     if (!json || json === '') {
         return {
@@ -217,14 +286,20 @@ function _resetNativeModuleCache() {
     _nativeModule = null;
 }
 class NativeEditorBridge {
-    constructor(editorId) {
+    constructor(editorId, schema) {
         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;
+        this._schema = schema;
     }
     /** Create a new editor instance backed by the Rust engine. */
     static create(config) {
         const configObj = {};
+        let parsedSchema;
         if (config?.maxLength != null)
             configObj.maxLength = config.maxLength;
         if (config?.allowBase64Images != null) {
@@ -232,14 +307,15 @@ class NativeEditorBridge {
         }
         if (config?.schemaJson != null) {
             try {
-                configObj.schema = JSON.parse(config.schemaJson);
+                parsedSchema = JSON.parse(config.schemaJson);
+                configObj.schema = parsedSchema;
             }
             catch {
                 // Fall back to the default schema when the provided JSON is invalid.
             }
         }
         const id = getNativeModule().editorCreate(JSON.stringify(configObj));
-        return new NativeEditorBridge(id);
+        return new NativeEditorBridge(id, parsedSchema);
     }
     /** The underlying native editor ID. */
     get editorId() {
@@ -254,57 +330,89 @@ 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((0, schemas_1.normalizeDocumentJson)(doc, this._schema)));
+    }
+    /** 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 normalizedJsonString = normalizeDocumentJsonString(jsonString, this._schema);
+        const json = getNativeModule().editorSetJson(this._editorId, normalizedJsonString);
         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 +421,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 +431,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 +440,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 +449,7 @@ 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) {
@@ -365,10 +461,7 @@ class NativeEditorBridge {
         const json = scalarSelection
             ? getNativeModule().editorToggleHeadingAtSelectionScalar(this._editorId, scalarSelection.anchor, scalarSelection.head, level)
             : getNativeModule().editorToggleHeading(this._editorId, level);
-        const update = parseEditorUpdateJson(json);
-        if (update)
-            this._lastSelection = update.selection;
-        return update;
+        return this.parseAndNoteUpdate(json);
     }
     /** Set the document selection by anchor and head positions. */
     setSelection(anchor, head) {
@@ -402,82 +495,66 @@ 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((0, schemas_1.normalizeDocumentJson)(doc, this._schema)));
+    }
+    /** 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 normalizedJsonString = normalizeDocumentJsonString(jsonString, this._schema);
+        const json = getNativeModule().editorReplaceJson(this._editorId, normalizedJsonString);
+        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() {
@@ -501,10 +578,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() {
@@ -513,10 +587,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() {
@@ -525,10 +596,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() {
@@ -537,10 +605,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) {
@@ -549,11 +614,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

@@ -4,8 +4,7 @@ import { type ActiveState, type DocumentJSON, type HistoryState, type Selection
 import { type EditorToolbarHeadingLevel, type EditorToolbarItem } from './EditorToolbar';
 import { type EditorTheme } from './EditorTheme';
 import { type EditorAddons } from './addons';
-import { type SchemaDefinition } from './schemas';
-import { type ImageNodeAttributes } from './schemas';
+import { type ImageNodeAttributes, type SchemaDefinition } from './schemas';
 export type NativeRichTextEditorHeightBehavior = 'fixed' | 'autoGrow';
 export type NativeRichTextEditorToolbarPlacement = 'keyboard' | 'inline';
 export interface RemoteSelectionDecoration {
@@ -38,6 +37,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. */