loro-crdt 1.0.8 → 1.1.0

package/web/loro_wasm.js

@@ -360,17 +360,18 @@ function _assertClass(instance, klass) {
 * - endVersionVector
 * - startTimestamp
 * - endTimestamp
-* - isSnapshot
+* - mode
 * - changeNum
 * @param {Uint8Array} blob
+* @param {boolean} check_checksum
 * @returns {ImportBlobMetadata}
 */
-export function decodeImportBlobMeta(blob) {
+export function decodeImportBlobMeta(blob, check_checksum) {
     try {
         const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
         const ptr0 = passArray8ToWasm0(blob, wasm.__wbindgen_export_0);
         const len0 = WASM_VECTOR_LEN;
-        wasm.decodeImportBlobMeta(retptr, ptr0, len0);
+        wasm.decodeImportBlobMeta(retptr, ptr0, len0, check_checksum);
         var r0 = getInt32Memory0()[retptr / 4 + 0];
         var r1 = getInt32Memory0()[retptr / 4 + 1];
         var r2 = getInt32Memory0()[retptr / 4 + 2];
@@ -1126,6 +1127,9 @@ export class LoroDoc {
     * Duplicate the document with a different PeerID
     *
     * The time complexity and space complexity of this operation are both O(n),
+    *
+    * When called in detached mode, it will fork at the current state frontiers.
+    * It will have the same effect as `forkAt(&self.frontiers())`.
     * @returns {LoroDoc}
     */
     fork() {
@@ -1134,6 +1138,8 @@ export class LoroDoc {
     }
     /**
     * Creates a new LoroDoc at a specified version (Frontiers)
+    *
+    * The created doc will only contain the history before the specified frontiers.
     * @param {({ peer: PeerID, counter: number })[]} frontiers
     * @returns {LoroDoc}
     */
@@ -1197,7 +1203,7 @@ export class LoroDoc {
     * @param ids - the changes to visit
     * @param f - the callback function, return `true` to continue visiting, return `false` to stop
     * @param {({ peer: PeerID, counter: number })[]} ids
-    * @param {Function} f
+    * @param {(change: ChangeMeta) => boolean} f
     */
     travelChangeAncestors(ids, f) {
         try {
@@ -2344,6 +2350,40 @@ export class LoroDoc {
             wasm.__wbindgen_add_to_stack_pointer(16);
         }
     }
+    /**
+    * Gets container IDs modified in the given ID range.
+    *
+    * **NOTE:** This method will implicitly commit.
+    *
+    * This method identifies which containers were affected by changes in a given range of operations.
+    * It can be used together with `doc.travelChangeAncestors()` to analyze the history of changes
+    * and determine which containers were modified by each change.
+    *
+    * @param id - The starting ID of the change range
+    * @param len - The length of the change range to check
+    * @returns An array of container IDs that were modified in the given range
+    * @param {{ peer: PeerID, counter: number }} id
+    * @param {number} len
+    * @returns {(ContainerID)[]}
+    */
+    getChangedContainersIn(id, len) {
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            wasm.lorodoc_getChangedContainersIn(retptr, this.__wbg_ptr, addHeapObject(id), len);
+            var r0 = getInt32Memory0()[retptr / 4 + 0];
+            var r1 = getInt32Memory0()[retptr / 4 + 1];
+            var r2 = getInt32Memory0()[retptr / 4 + 2];
+            var r3 = getInt32Memory0()[retptr / 4 + 3];
+            if (r3) {
+                throw takeObject(r2);
+            }
+            var v1 = getArrayJsValueFromWasm0(r0, r1).slice();
+            wasm.__wbindgen_export_5(r0, r1 * 4, 4);
+            return v1;
+        } finally {
+            wasm.__wbindgen_add_to_stack_pointer(16);
+        }
+    }
 }
 
 const LoroListFinalization = (typeof FinalizationRegistry === 'undefined')
@@ -2567,6 +2607,25 @@ export class LoroList {
         }
     }
     /**
+    * @param {Container} child
+    * @returns {Container}
+    */
+    pushContainer(child) {
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            wasm.lorolist_pushContainer(retptr, this.__wbg_ptr, addHeapObject(child));
+            var r0 = getInt32Memory0()[retptr / 4 + 0];
+            var r1 = getInt32Memory0()[retptr / 4 + 1];
+            var r2 = getInt32Memory0()[retptr / 4 + 2];
+            if (r2) {
+                throw takeObject(r1);
+            }
+            return takeObject(r0);
+        } finally {
+            wasm.__wbindgen_add_to_stack_pointer(16);
+        }
+    }
+    /**
     * Subscribe to the changes of the list.
     *
     * Returns a subscription callback, which can be used to unsubscribe.
@@ -2725,6 +2784,14 @@ export class LoroList {
             wasm.__wbindgen_add_to_stack_pointer(16);
         }
     }
+    /**
+    * @param {number} pos
+    * @returns {{ peer: PeerID, counter: number } | undefined}
+    */
+    getIdAt(pos) {
+        const ret = wasm.lorolist_getIdAt(this.__wbg_ptr, pos);
+        return takeObject(ret);
+    }
 }
 
 const LoroMapFinalization = (typeof FinalizationRegistry === 'undefined')
@@ -3156,6 +3223,17 @@ export class LoroMap {
             wasm.__wbindgen_add_to_stack_pointer(16);
         }
     }
+    /**
+    * Get the peer id of the last editor on the given entry
+    * @param {string} key
+    * @returns {PeerID | undefined}
+    */
+    getLastEditor(key) {
+        const ptr0 = passStringToWasm0(key, wasm.__wbindgen_export_0, wasm.__wbindgen_export_1);
+        const len0 = WASM_VECTOR_LEN;
+        const ret = wasm.loromap_getLastEditor(this.__wbg_ptr, ptr0, len0);
+        return takeObject(ret);
+    }
 }
 
 const LoroMovableListFinalization = (typeof FinalizationRegistry === 'undefined')
@@ -3379,6 +3457,26 @@ export class LoroMovableList {
         }
     }
     /**
+    * Push a container to the end of the list.
+    * @param {Container} child
+    * @returns {Container}
+    */
+    pushContainer(child) {
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            wasm.loromovablelist_pushContainer(retptr, this.__wbg_ptr, addHeapObject(child));
+            var r0 = getInt32Memory0()[retptr / 4 + 0];
+            var r1 = getInt32Memory0()[retptr / 4 + 1];
+            var r2 = getInt32Memory0()[retptr / 4 + 2];
+            if (r2) {
+                throw takeObject(r1);
+            }
+            return takeObject(r0);
+        } finally {
+            wasm.__wbindgen_add_to_stack_pointer(16);
+        }
+    }
+    /**
     * Subscribe to the changes of the list.
     *
     * Returns a subscription callback, which can be used to unsubscribe.
@@ -3608,6 +3706,33 @@ export class LoroMovableList {
             wasm.__wbindgen_add_to_stack_pointer(16);
         }
     }
+    /**
+    * Get the creator of the list item at the given position.
+    * @param {number} pos
+    * @returns {PeerID | undefined}
+    */
+    getCreatorAt(pos) {
+        const ret = wasm.loromovablelist_getCreatorAt(this.__wbg_ptr, pos);
+        return takeObject(ret);
+    }
+    /**
+    * Get the last mover of the list item at the given position.
+    * @param {number} pos
+    * @returns {PeerID | undefined}
+    */
+    getLastMoverAt(pos) {
+        const ret = wasm.loromovablelist_getLastMoverAt(this.__wbg_ptr, pos);
+        return takeObject(ret);
+    }
+    /**
+    * Get the last editor of the list item at the given position.
+    * @param {number} pos
+    * @returns {PeerID | undefined}
+    */
+    getLastEditorAt(pos) {
+        const ret = wasm.loromovablelist_getLastEditorAt(this.__wbg_ptr, pos);
+        return takeObject(ret);
+    }
 }
 
 const LoroTextFinalization = (typeof FinalizationRegistry === 'undefined')
@@ -3659,11 +3784,14 @@ export class LoroText {
         return takeObject(ret);
     }
     /**
-    * Iterate each span(internal storage unit) of the text.
+    * Iterate each text span(internal storage unit)
     *
     * The callback function will be called for each span in the text.
     * If the callback returns `false`, the iteration will stop.
     *
+    * Limitation: you cannot access or alter the doc state when iterating (this is for performance consideration).
+    * If you need to access or alter the doc state, please use `toString` instead.
+    *
     * @example
     * ```ts
     * import { LoroDoc } from "loro-crdt";
@@ -3702,22 +3830,44 @@ export class LoroText {
     * console.log(text.toString()); // "Hello World"
     * ```
     * @param {string} text
+    * @param {any} options
     */
-    update(text) {
-        const ptr0 = passStringToWasm0(text, wasm.__wbindgen_export_0, wasm.__wbindgen_export_1);
-        const len0 = WASM_VECTOR_LEN;
-        wasm.lorotext_update(this.__wbg_ptr, ptr0, len0);
+    update(text, options) {
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            const ptr0 = passStringToWasm0(text, wasm.__wbindgen_export_0, wasm.__wbindgen_export_1);
+            const len0 = WASM_VECTOR_LEN;
+            wasm.lorotext_update(retptr, this.__wbg_ptr, ptr0, len0, addHeapObject(options));
+            var r0 = getInt32Memory0()[retptr / 4 + 0];
+            var r1 = getInt32Memory0()[retptr / 4 + 1];
+            if (r1) {
+                throw takeObject(r0);
+            }
+        } finally {
+            wasm.__wbindgen_add_to_stack_pointer(16);
+        }
     }
     /**
     * Update the current text to the target text, the difference is calculated line by line.
     *
     * It uses Myers' diff algorithm to compute the optimal difference.
     * @param {string} text
+    * @param {any} options
     */
-    updateByLine(text) {
-        const ptr0 = passStringToWasm0(text, wasm.__wbindgen_export_0, wasm.__wbindgen_export_1);
-        const len0 = WASM_VECTOR_LEN;
-        wasm.lorotext_updateByLine(this.__wbg_ptr, ptr0, len0);
+    updateByLine(text, options) {
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            const ptr0 = passStringToWasm0(text, wasm.__wbindgen_export_0, wasm.__wbindgen_export_1);
+            const len0 = WASM_VECTOR_LEN;
+            wasm.lorotext_updateByLine(retptr, this.__wbg_ptr, ptr0, len0, addHeapObject(options));
+            var r0 = getInt32Memory0()[retptr / 4 + 0];
+            var r1 = getInt32Memory0()[retptr / 4 + 1];
+            if (r1) {
+                throw takeObject(r0);
+            }
+        } finally {
+            wasm.__wbindgen_add_to_stack_pointer(16);
+        }
     }
     /**
     * Insert the string at the given index (utf-16 index).
@@ -4196,6 +4346,34 @@ export class LoroText {
         const ret = wasm.lorotext_getCursor(this.__wbg_ptr, pos, addHeapObject(side));
         return ret === 0 ? undefined : Cursor.__wrap(ret);
     }
+    /**
+    * Push a string to the end of the text.
+    * @param {string} s
+    */
+    push(s) {
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            const ptr0 = passStringToWasm0(s, wasm.__wbindgen_export_0, wasm.__wbindgen_export_1);
+            const len0 = WASM_VECTOR_LEN;
+            wasm.lorotext_push(retptr, this.__wbg_ptr, ptr0, len0);
+            var r0 = getInt32Memory0()[retptr / 4 + 0];
+            var r1 = getInt32Memory0()[retptr / 4 + 1];
+            if (r1) {
+                throw takeObject(r0);
+            }
+        } finally {
+            wasm.__wbindgen_add_to_stack_pointer(16);
+        }
+    }
+    /**
+    * Get the editor of the text at the given position.
+    * @param {number} pos
+    * @returns {PeerID | undefined}
+    */
+    getEditorOf(pos) {
+        const ret = wasm.lorotext_getEditorOf(this.__wbg_ptr, pos);
+        return takeObject(ret);
+    }
 }
 
 const LoroTreeFinalization = (typeof FinalizationRegistry === 'undefined')
@@ -4890,6 +5068,24 @@ export class LoroTreeNode {
         }
     }
     /**
+    * @returns {any}
+    */
+    toJSON() {
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            wasm.lorotreenode_toJSON(retptr, this.__wbg_ptr);
+            var r0 = getInt32Memory0()[retptr / 4 + 0];
+            var r1 = getInt32Memory0()[retptr / 4 + 1];
+            var r2 = getInt32Memory0()[retptr / 4 + 2];
+            if (r2) {
+                throw takeObject(r1);
+            }
+            return takeObject(r0);
+        } finally {
+            wasm.__wbindgen_add_to_stack_pointer(16);
+        }
+    }
+    /**
     * Get the parent node of this node.
     *
     * - The parent of the root node is `undefined`.
@@ -4942,6 +5138,30 @@ export class LoroTreeNode {
             wasm.__wbindgen_add_to_stack_pointer(16);
         }
     }
+    /**
+    * Get the last mover of this node.
+    * @returns {{ peer: PeerID, counter: number } | undefined}
+    */
+    getLastMoveId() {
+        const ret = wasm.lorotreenode_getLastMoveId(this.__wbg_ptr);
+        return takeObject(ret);
+    }
+    /**
+    * Get the creation id of this node.
+    * @returns {{ peer: PeerID, counter: number }}
+    */
+    creationId() {
+        const ret = wasm.lorotreenode_creationId(this.__wbg_ptr);
+        return takeObject(ret);
+    }
+    /**
+    * Get the creator of this node.
+    * @returns {PeerID}
+    */
+    creator() {
+        const ret = wasm.lorotreenode_creator(this.__wbg_ptr);
+        return takeObject(ret);
+    }
 }
 
 const UndoManagerFinalization = (typeof FinalizationRegistry === 'undefined')
@@ -5353,6 +5573,10 @@ function __wbg_get_imports() {
         const ret = VersionVector.__wrap(arg0);
         return addHeapObject(ret);
     };
+    imports.wbg.__wbindgen_is_function = function(arg0) {
+        const ret = typeof(getObject(arg0)) === 'function';
+        return ret;
+    };
     imports.wbg.__wbindgen_string_new = function(arg0, arg1) {
         const ret = getStringFromWasm0(arg0, arg1);
         return addHeapObject(ret);
@@ -5426,10 +5650,6 @@ function __wbg_get_imports() {
         const ret = +getObject(arg0);
         return ret;
     };
-    imports.wbg.__wbindgen_is_function = function(arg0) {
-        const ret = typeof(getObject(arg0)) === 'function';
-        return ret;
-    };
     imports.wbg.__wbindgen_is_string = function(arg0) {
         const ret = typeof(getObject(arg0)) === 'string';
         return ret;
@@ -5796,11 +6016,11 @@ function __wbg_get_imports() {
         const ret = wasm.memory;
         return addHeapObject(ret);
     };
-    imports.wbg.__wbindgen_closure_wrapper488 = function(arg0, arg1, arg2) {
+    imports.wbg.__wbindgen_closure_wrapper491 = function(arg0, arg1, arg2) {
         const ret = makeMutClosure(arg0, arg1, 9, __wbg_adapter_58);
         return addHeapObject(ret);
     };
-    imports.wbg.__wbindgen_closure_wrapper491 = function(arg0, arg1, arg2) {
+    imports.wbg.__wbindgen_closure_wrapper494 = function(arg0, arg1, arg2) {
         const ret = makeMutClosure(arg0, arg1, 11, __wbg_adapter_61);
         return addHeapObject(ret);
     };

package/web/loro_wasm_bg.wasm.d.ts

@@ -89,12 +89,13 @@ export function lorodoc_frontiersToVV(a: number, b: number, c: number, d: number
 export function lorodoc_vvToFrontiers(a: number, b: number, c: number): void;
 export function lorodoc_getByPath(a: number, b: number, c: number): number;
 export function lorodoc_getCursorPos(a: number, b: number, c: number): void;
+export function lorodoc_getChangedContainersIn(a: number, b: number, c: number, d: number): void;
 export function __wbg_lorotext_free(a: number): void;
 export function lorotext_new(): number;
 export function lorotext_kind(a: number): number;
 export function lorotext_iter(a: number, b: number): void;
-export function lorotext_update(a: number, b: number, c: number): void;
-export function lorotext_updateByLine(a: number, b: number, c: number): void;
+export function lorotext_update(a: number, b: number, c: number, d: number, e: number): void;
+export function lorotext_updateByLine(a: number, b: number, c: number, d: number, e: number): void;
 export function lorotext_insert(a: number, b: number, c: number, d: number, e: number): void;
 export function lorotext_slice(a: number, b: number, c: number, d: number): void;
 export function lorotext_charAt(a: number, b: number, c: number): void;
@@ -113,6 +114,8 @@ export function lorotext_applyDelta(a: number, b: number, c: number): void;
 export function lorotext_parent(a: number): number;
 export function lorotext_getAttached(a: number): number;
 export function lorotext_getCursor(a: number, b: number, c: number): number;
+export function lorotext_push(a: number, b: number, c: number, d: number): void;
+export function lorotext_getEditorOf(a: number, b: number): number;
 export function __wbg_loromap_free(a: number): void;
 export function loromap_new(): number;
 export function loromap_kind(a: number): number;
@@ -131,6 +134,7 @@ export function loromap_size(a: number): number;
 export function loromap_parent(a: number): number;
 export function loromap_getAttached(a: number): number;
 export function loromap_clear(a: number, b: number): void;
+export function loromap_getLastEditor(a: number, b: number, c: number): number;
 export function __wbg_lorolist_free(a: number): void;
 export function lorolist_new(): number;
 export function lorolist_kind(a: number): number;
@@ -141,6 +145,7 @@ export function lorolist_id(a: number): number;
 export function lorolist_toArray(a: number, b: number): void;
 export function lorolist_toJSON(a: number): number;
 export function lorolist_insertContainer(a: number, b: number, c: number, d: number): void;
+export function lorolist_pushContainer(a: number, b: number, c: number): void;
 export function lorolist_subscribe(a: number, b: number, c: number): void;
 export function lorolist_length(a: number): number;
 export function lorolist_parent(a: number): number;
@@ -150,6 +155,7 @@ export function lorolist_getCursor(a: number, b: number, c: number): number;
 export function lorolist_push(a: number, b: number, c: number): void;
 export function lorolist_pop(a: number, b: number): void;
 export function lorolist_clear(a: number, b: number): void;
+export function lorolist_getIdAt(a: number, b: number): number;
 export function loromovablelist_new(): number;
 export function loromovablelist_kind(a: number): number;
 export function loromovablelist_insert(a: number, b: number, c: number, d: number): void;
@@ -159,6 +165,7 @@ export function loromovablelist_id(a: number): number;
 export function loromovablelist_toArray(a: number, b: number): void;
 export function loromovablelist_toJSON(a: number): number;
 export function loromovablelist_insertContainer(a: number, b: number, c: number, d: number): void;
+export function loromovablelist_pushContainer(a: number, b: number, c: number): void;
 export function loromovablelist_subscribe(a: number, b: number, c: number): void;
 export function loromovablelist_length(a: number): number;
 export function loromovablelist_getAttached(a: number): number;
@@ -169,6 +176,9 @@ export function loromovablelist_setContainer(a: number, b: number, c: number, d:
 export function loromovablelist_push(a: number, b: number, c: number): void;
 export function loromovablelist_pop(a: number, b: number): void;
 export function loromovablelist_clear(a: number, b: number): void;
+export function loromovablelist_getCreatorAt(a: number, b: number): number;
+export function loromovablelist_getLastMoverAt(a: number, b: number): number;
+export function loromovablelist_getLastEditorAt(a: number, b: number): number;
 export function __wbg_lorotree_free(a: number): void;
 export function lorotreenode___getClassname(a: number, b: number): void;
 export function __wbg_lorotreenode_free(a: number): void;
@@ -180,9 +190,13 @@ export function lorotreenode_moveBefore(a: number, b: number, c: number): void;
 export function lorotreenode_index(a: number, b: number): void;
 export function lorotreenode_fractionalIndex(a: number, b: number): void;
 export function lorotreenode_data(a: number, b: number): void;
+export function lorotreenode_toJSON(a: number, b: number): void;
 export function lorotreenode_parent(a: number, b: number): void;
 export function lorotreenode_children(a: number): number;
 export function lorotreenode_isDeleted(a: number, b: number): void;
+export function lorotreenode_getLastMoveId(a: number): number;
+export function lorotreenode_creationId(a: number): number;
+export function lorotreenode_creator(a: number): number;
 export function lorotree_new(): number;
 export function lorotree_kind(a: number): number;
 export function lorotree_createNode(a: number, b: number, c: number, d: number, e: number): void;
@@ -232,7 +246,7 @@ export function versionvector_encode(a: number, b: number): void;
 export function versionvector_decode(a: number, b: number, c: number): void;
 export function versionvector_get(a: number, b: number, c: number): void;
 export function versionvector_compare(a: number, b: number, c: number): void;
-export function decodeImportBlobMeta(a: number, b: number, c: number): void;
+export function decodeImportBlobMeta(a: number, b: number, c: number, d: number): void;
 export function __wbg_loromovablelist_free(a: number): void;
 export function loromovablelist_parent(a: number): number;
 export function lorotext_isAttached(a: number): number;