loro-crdt 1.0.8 → 1.0.9

package/CHANGELOG.md

@@ -1,5 +1,14 @@
 # Changelog
 
+## 1.0.9
+
+### Patch Changes
+
+- 7bf6db7: Add `push` to LoroText and `pushContainer` to LoroList LoroMovableList
+- 9b60d01: Define the behavior of `doc.fork()` when the doc is detached
+
+  It will fork at the current state_frontiers, which is equivalent to calling `doc.fork_at(&doc.state_frontiers())`
+
 ## 1.0.8
 
 ### Patch Changes

package/bundler/loro_wasm.d.ts

@@ -779,6 +779,10 @@ interface LoroList<T = unknown> {
      *  ```
      */
     insertContainer<C extends Container>(pos: number, child: C): T extends C ? T : C;
+    /**
+     * Push a container to the end of the list.
+     */
+    pushContainer<C extends Container>(child: C): T extends C ? T : C;
     /**
      * Get the value at the index. If the value is a container, the corresponding handler will be returned.
      *
@@ -851,6 +855,10 @@ interface LoroMovableList<T = unknown> {
      *  ```
      */
     insertContainer<C extends Container>(pos: number, child: C): T extends C ? T : C;
+    /**
+     * Push a container to the end of the list.
+     */
+    pushContainer<C extends Container>(child: C): T extends C ? T : C;
     /**
      * Get the value at the index. If the value is a container, the corresponding handler will be returned.
      *
@@ -1479,11 +1487,16 @@ 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(): 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}
 */
@@ -2687,6 +2700,11 @@ export class LoroText {
 */
   getAttached(): LoroText | undefined;
 /**
+* Push a string to the end of the text.
+* @param {string} s
+*/
+  push(s: string): void;
+/**
 * Get the container id of the text.
 */
   readonly id: ContainerID;

package/bundler/loro_wasm_bg.js

@@ -1134,6 +1134,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() {
@@ -1142,6 +1145,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}
     */
@@ -2575,6 +2580,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.
@@ -3387,6 +3411,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.
@@ -4204,6 +4248,25 @@ 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);
+        }
+    }
 }
 
 const LoroTreeFinalization = (typeof FinalizationRegistry === 'undefined')

package/bundler/loro_wasm_bg.wasm.d.ts

@@ -113,6 +113,7 @@ 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 __wbg_loromap_free(a: number): void;
 export function loromap_new(): number;
 export function loromap_kind(a: number): number;
@@ -141,6 +142,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;
@@ -159,6 +161,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;

package/nodejs/loro_wasm.d.ts

@@ -779,6 +779,10 @@ interface LoroList<T = unknown> {
      *  ```
      */
     insertContainer<C extends Container>(pos: number, child: C): T extends C ? T : C;
+    /**
+     * Push a container to the end of the list.
+     */
+    pushContainer<C extends Container>(child: C): T extends C ? T : C;
     /**
      * Get the value at the index. If the value is a container, the corresponding handler will be returned.
      *
@@ -851,6 +855,10 @@ interface LoroMovableList<T = unknown> {
      *  ```
      */
     insertContainer<C extends Container>(pos: number, child: C): T extends C ? T : C;
+    /**
+     * Push a container to the end of the list.
+     */
+    pushContainer<C extends Container>(child: C): T extends C ? T : C;
     /**
      * Get the value at the index. If the value is a container, the corresponding handler will be returned.
      *
@@ -1479,11 +1487,16 @@ 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(): 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}
 */
@@ -2687,6 +2700,11 @@ export class LoroText {
 */
   getAttached(): LoroText | undefined;
 /**
+* Push a string to the end of the text.
+* @param {string} s
+*/
+  push(s: string): void;
+/**
 * Get the container id of the text.
 */
   readonly id: ContainerID;

package/nodejs/loro_wasm.js

@@ -1132,6 +1132,9 @@ 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() {
@@ -1140,6 +1143,8 @@ 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}
     */
@@ -2574,6 +2579,25 @@ 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.
@@ -3388,6 +3412,26 @@ 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.
@@ -4206,6 +4250,25 @@ 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);
+        }
+    }
 }
 module.exports.LoroText = LoroText;
 

package/nodejs/loro_wasm_bg.wasm.d.ts

@@ -113,6 +113,7 @@ 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 __wbg_loromap_free(a: number): void;
 export function loromap_new(): number;
 export function loromap_kind(a: number): number;
@@ -141,6 +142,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;
@@ -159,6 +161,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;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "loro-crdt",
-  "version": "1.0.8",
+  "version": "1.0.9",
   "description": "Loro CRDTs is a high-performance CRDT framework that makes your app state synchronized, collaborative and maintainable effortlessly.",
   "keywords": [
     "crdt",

package/web/loro_wasm.d.ts

@@ -779,6 +779,10 @@ interface LoroList<T = unknown> {
      *  ```
      */
     insertContainer<C extends Container>(pos: number, child: C): T extends C ? T : C;
+    /**
+     * Push a container to the end of the list.
+     */
+    pushContainer<C extends Container>(child: C): T extends C ? T : C;
     /**
      * Get the value at the index. If the value is a container, the corresponding handler will be returned.
      *
@@ -851,6 +855,10 @@ interface LoroMovableList<T = unknown> {
      *  ```
      */
     insertContainer<C extends Container>(pos: number, child: C): T extends C ? T : C;
+    /**
+     * Push a container to the end of the list.
+     */
+    pushContainer<C extends Container>(child: C): T extends C ? T : C;
     /**
      * Get the value at the index. If the value is a container, the corresponding handler will be returned.
      *
@@ -1479,11 +1487,16 @@ 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(): 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}
 */
@@ -2687,6 +2700,11 @@ export class LoroText {
 */
   getAttached(): LoroText | undefined;
 /**
+* Push a string to the end of the text.
+* @param {string} s
+*/
+  push(s: string): void;
+/**
 * Get the container id of the text.
 */
   readonly id: ContainerID;
@@ -3218,6 +3236,7 @@ export interface InitOutput {
   readonly lorotext_parent: (a: number) => number;
   readonly lorotext_getAttached: (a: number) => number;
   readonly lorotext_getCursor: (a: number, b: number, c: number) => number;
+  readonly lorotext_push: (a: number, b: number, c: number, d: number) => void;
   readonly __wbg_loromap_free: (a: number) => void;
   readonly loromap_new: () => number;
   readonly loromap_kind: (a: number) => number;
@@ -3246,6 +3265,7 @@ export interface InitOutput {
   readonly lorolist_toArray: (a: number, b: number) => void;
   readonly lorolist_toJSON: (a: number) => number;
   readonly lorolist_insertContainer: (a: number, b: number, c: number, d: number) => void;
+  readonly lorolist_pushContainer: (a: number, b: number, c: number) => void;
   readonly lorolist_subscribe: (a: number, b: number, c: number) => void;
   readonly lorolist_length: (a: number) => number;
   readonly lorolist_parent: (a: number) => number;
@@ -3264,6 +3284,7 @@ export interface InitOutput {
   readonly loromovablelist_toArray: (a: number, b: number) => void;
   readonly loromovablelist_toJSON: (a: number) => number;
   readonly loromovablelist_insertContainer: (a: number, b: number, c: number, d: number) => void;
+  readonly loromovablelist_pushContainer: (a: number, b: number, c: number) => void;
   readonly loromovablelist_subscribe: (a: number, b: number, c: number) => void;
   readonly loromovablelist_length: (a: number) => number;
   readonly loromovablelist_getAttached: (a: number) => number;

package/web/loro_wasm.js

@@ -1126,6 +1126,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 +1137,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}
     */
@@ -2567,6 +2572,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.
@@ -3379,6 +3403,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.
@@ -4196,6 +4240,25 @@ 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);
+        }
+    }
 }
 
 const LoroTreeFinalization = (typeof FinalizationRegistry === 'undefined')

package/web/loro_wasm_bg.wasm.d.ts

@@ -113,6 +113,7 @@ 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 __wbg_loromap_free(a: number): void;
 export function loromap_new(): number;
 export function loromap_kind(a: number): number;
@@ -141,6 +142,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;
@@ -159,6 +161,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;