loro-crdt 1.6.0 → 1.7.1

package/bundler/loro_wasm.d.ts

@@ -1640,6 +1640,7 @@ export class LoroCounter {
    * Get the value of the counter.
    */
   getShallowValue(): number;
+  toJSON(): number;
   /**
    * The container id of this handler.
    */
@@ -2001,6 +2002,13 @@ export class LoroDoc {
    * the largest existing timestamp will be used instead.
    *
    * NOTE: The `origin` will not be persisted, but the `message` will.
+   *
+   * Behavior on empty commits:
+   * - This method is an explicit commit. If the pending transaction is empty, any provided
+   *   options (message/timestamp/origin) are swallowed and will not carry over to the next commit.
+   * - Implicit commits triggered by `export`/`checkout` act as processing barriers. If the
+   *   transaction is empty in those cases, `message`/`timestamp`/`origin` are preserved for the
+   *   next commit.
    */
   commit(options?: { origin?: string, timestamp?: number, message?: string } | null): void;
   /**
@@ -3621,6 +3629,16 @@ export class UndoManager {
    * Can redo the last operation.
    */
   canRedo(): boolean;
+  /**
+   * Get the value associated with the top undo stack item, if any.
+   * Returns `undefined` if there is no undo item.
+   */
+  topUndoValue(): Value | undefined;
+  /**
+   * Get the value associated with the top redo stack item, if any.
+   * Returns `undefined` if there is no redo item.
+   */
+  topRedoValue(): Value | undefined;
   /**
    * The number of max undo steps.
    * If the number of undo steps exceeds this number, the oldest undo step will be removed.

package/bundler/loro_wasm_bg.js

@@ -1122,6 +1122,13 @@ export class LoroCounter {
         const ret = wasm.lorocounter_getShallowValue(this.__wbg_ptr);
         return ret;
     }
+    /**
+     * @returns {number}
+     */
+    toJSON() {
+        const ret = wasm.lorocounter_toJSON(this.__wbg_ptr);
+        return ret;
+    }
 }
 
 const LoroDocFinalization = (typeof FinalizationRegistry === 'undefined')
@@ -1683,6 +1690,13 @@ export class LoroDoc {
      * the largest existing timestamp will be used instead.
      *
      * NOTE: The `origin` will not be persisted, but the `message` will.
+     *
+     * Behavior on empty commits:
+     * - This method is an explicit commit. If the pending transaction is empty, any provided
+     *   options (message/timestamp/origin) are swallowed and will not carry over to the next commit.
+     * - Implicit commits triggered by `export`/`checkout` act as processing barriers. If the
+     *   transaction is empty in those cases, `message`/`timestamp`/`origin` are preserved for the
+     *   next commit.
      * @param {{ origin?: string, timestamp?: number, message?: string } | null} [options]
      */
     commit(options) {
@@ -6222,6 +6236,24 @@ export class UndoManager {
         const ret = wasm.undomanager_canRedo(this.__wbg_ptr);
         return ret !== 0;
     }
+    /**
+     * Get the value associated with the top undo stack item, if any.
+     * Returns `undefined` if there is no undo item.
+     * @returns {Value | undefined}
+     */
+    topUndoValue() {
+        const ret = wasm.undomanager_topUndoValue(this.__wbg_ptr);
+        return takeObject(ret);
+    }
+    /**
+     * Get the value associated with the top redo stack item, if any.
+     * Returns `undefined` if there is no redo item.
+     * @returns {Value | undefined}
+     */
+    topRedoValue() {
+        const ret = wasm.undomanager_topRedoValue(this.__wbg_ptr);
+        return takeObject(ret);
+    }
     /**
      * The number of max undo steps.
      * If the number of undo steps exceeds this number, the oldest undo step will be removed.
@@ -6824,7 +6856,7 @@ export function __wbg_node_02999533c4ea02e3(arg0) {
     return addHeapObject(ret);
 };
 
-export function __wbg_now_4f8b2820be8a682c() {
+export function __wbg_now_bbd8229e4a52638e() {
     const ret = Date.now();
     return ret;
 };

package/bundler/loro_wasm_bg.wasm.d.ts

@@ -13,6 +13,7 @@ export const lorocounter_parent: (a: number) => number;
 export const lorocounter_isAttached: (a: number) => number;
 export const lorocounter_getAttached: (a: number) => number;
 export const lorocounter_getShallowValue: (a: number) => number;
+export const lorocounter_toJSON: (a: number) => number;
 export const __wbg_awarenesswasm_free: (a: number, b: number) => void;
 export const awarenesswasm_new: (a: number, b: number) => number;
 export const awarenesswasm_encode: (a: number, b: number, c: number) => void;
@@ -285,6 +286,8 @@ export const undomanager_groupStart: (a: number, b: number) => void;
 export const undomanager_groupEnd: (a: number) => void;
 export const undomanager_canUndo: (a: number) => number;
 export const undomanager_canRedo: (a: number) => number;
+export const undomanager_topUndoValue: (a: number) => number;
+export const undomanager_topRedoValue: (a: number) => number;
 export const undomanager_setMaxUndoSteps: (a: number, b: number) => void;
 export const undomanager_setMergeInterval: (a: number, b: number) => void;
 export const undomanager_addExcludeOriginPrefix: (a: number, b: number, c: number) => void;

package/nodejs/loro_wasm.d.ts

@@ -1640,6 +1640,7 @@ export class LoroCounter {
    * Get the value of the counter.
    */
   getShallowValue(): number;
+  toJSON(): number;
   /**
    * The container id of this handler.
    */
@@ -2001,6 +2002,13 @@ export class LoroDoc {
    * the largest existing timestamp will be used instead.
    *
    * NOTE: The `origin` will not be persisted, but the `message` will.
+   *
+   * Behavior on empty commits:
+   * - This method is an explicit commit. If the pending transaction is empty, any provided
+   *   options (message/timestamp/origin) are swallowed and will not carry over to the next commit.
+   * - Implicit commits triggered by `export`/`checkout` act as processing barriers. If the
+   *   transaction is empty in those cases, `message`/`timestamp`/`origin` are preserved for the
+   *   next commit.
    */
   commit(options?: { origin?: string, timestamp?: number, message?: string } | null): void;
   /**
@@ -3621,6 +3629,16 @@ export class UndoManager {
    * Can redo the last operation.
    */
   canRedo(): boolean;
+  /**
+   * Get the value associated with the top undo stack item, if any.
+   * Returns `undefined` if there is no undo item.
+   */
+  topUndoValue(): Value | undefined;
+  /**
+   * Get the value associated with the top redo stack item, if any.
+   * Returns `undefined` if there is no redo item.
+   */
+  topRedoValue(): Value | undefined;
   /**
    * The number of max undo steps.
    * If the number of undo steps exceeds this number, the oldest undo step will be removed.

package/nodejs/loro_wasm.js

@@ -1122,6 +1122,13 @@ class LoroCounter {
         const ret = wasm.lorocounter_getShallowValue(this.__wbg_ptr);
         return ret;
     }
+    /**
+     * @returns {number}
+     */
+    toJSON() {
+        const ret = wasm.lorocounter_toJSON(this.__wbg_ptr);
+        return ret;
+    }
 }
 module.exports.LoroCounter = LoroCounter;
 
@@ -1684,6 +1691,13 @@ class LoroDoc {
      * the largest existing timestamp will be used instead.
      *
      * NOTE: The `origin` will not be persisted, but the `message` will.
+     *
+     * Behavior on empty commits:
+     * - This method is an explicit commit. If the pending transaction is empty, any provided
+     *   options (message/timestamp/origin) are swallowed and will not carry over to the next commit.
+     * - Implicit commits triggered by `export`/`checkout` act as processing barriers. If the
+     *   transaction is empty in those cases, `message`/`timestamp`/`origin` are preserved for the
+     *   next commit.
      * @param {{ origin?: string, timestamp?: number, message?: string } | null} [options]
      */
     commit(options) {
@@ -6230,6 +6244,24 @@ class UndoManager {
         const ret = wasm.undomanager_canRedo(this.__wbg_ptr);
         return ret !== 0;
     }
+    /**
+     * Get the value associated with the top undo stack item, if any.
+     * Returns `undefined` if there is no undo item.
+     * @returns {Value | undefined}
+     */
+    topUndoValue() {
+        const ret = wasm.undomanager_topUndoValue(this.__wbg_ptr);
+        return takeObject(ret);
+    }
+    /**
+     * Get the value associated with the top redo stack item, if any.
+     * Returns `undefined` if there is no redo item.
+     * @returns {Value | undefined}
+     */
+    topRedoValue() {
+        const ret = wasm.undomanager_topRedoValue(this.__wbg_ptr);
+        return takeObject(ret);
+    }
     /**
      * The number of max undo steps.
      * If the number of undo steps exceeds this number, the oldest undo step will be removed.
@@ -6834,7 +6866,7 @@ module.exports.__wbg_node_02999533c4ea02e3 = function(arg0) {
     return addHeapObject(ret);
 };
 
-module.exports.__wbg_now_4f8b2820be8a682c = function() {
+module.exports.__wbg_now_bbd8229e4a52638e = function() {
     const ret = Date.now();
     return ret;
 };

package/nodejs/loro_wasm_bg.wasm.d.ts

@@ -13,6 +13,7 @@ export const lorocounter_parent: (a: number) => number;
 export const lorocounter_isAttached: (a: number) => number;
 export const lorocounter_getAttached: (a: number) => number;
 export const lorocounter_getShallowValue: (a: number) => number;
+export const lorocounter_toJSON: (a: number) => number;
 export const __wbg_awarenesswasm_free: (a: number, b: number) => void;
 export const awarenesswasm_new: (a: number, b: number) => number;
 export const awarenesswasm_encode: (a: number, b: number, c: number) => void;
@@ -285,6 +286,8 @@ export const undomanager_groupStart: (a: number, b: number) => void;
 export const undomanager_groupEnd: (a: number) => void;
 export const undomanager_canUndo: (a: number) => number;
 export const undomanager_canRedo: (a: number) => number;
+export const undomanager_topUndoValue: (a: number) => number;
+export const undomanager_topRedoValue: (a: number) => number;
 export const undomanager_setMaxUndoSteps: (a: number, b: number) => void;
 export const undomanager_setMergeInterval: (a: number, b: number) => void;
 export const undomanager_addExcludeOriginPrefix: (a: number, b: number, c: number) => void;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "loro-crdt",
-  "version": "1.6.0",
+  "version": "1.7.1",
   "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

@@ -1640,6 +1640,7 @@ export class LoroCounter {
    * Get the value of the counter.
    */
   getShallowValue(): number;
+  toJSON(): number;
   /**
    * The container id of this handler.
    */
@@ -2001,6 +2002,13 @@ export class LoroDoc {
    * the largest existing timestamp will be used instead.
    *
    * NOTE: The `origin` will not be persisted, but the `message` will.
+   *
+   * Behavior on empty commits:
+   * - This method is an explicit commit. If the pending transaction is empty, any provided
+   *   options (message/timestamp/origin) are swallowed and will not carry over to the next commit.
+   * - Implicit commits triggered by `export`/`checkout` act as processing barriers. If the
+   *   transaction is empty in those cases, `message`/`timestamp`/`origin` are preserved for the
+   *   next commit.
    */
   commit(options?: { origin?: string, timestamp?: number, message?: string } | null): void;
   /**
@@ -3621,6 +3629,16 @@ export class UndoManager {
    * Can redo the last operation.
    */
   canRedo(): boolean;
+  /**
+   * Get the value associated with the top undo stack item, if any.
+   * Returns `undefined` if there is no undo item.
+   */
+  topUndoValue(): Value | undefined;
+  /**
+   * Get the value associated with the top redo stack item, if any.
+   * Returns `undefined` if there is no redo item.
+   */
+  topRedoValue(): Value | undefined;
   /**
    * The number of max undo steps.
    * If the number of undo steps exceeds this number, the oldest undo step will be removed.
@@ -3707,6 +3725,7 @@ export interface InitOutput {
   readonly lorocounter_isAttached: (a: number) => number;
   readonly lorocounter_getAttached: (a: number) => number;
   readonly lorocounter_getShallowValue: (a: number) => number;
+  readonly lorocounter_toJSON: (a: number) => number;
   readonly __wbg_awarenesswasm_free: (a: number, b: number) => void;
   readonly awarenesswasm_new: (a: number, b: number) => number;
   readonly awarenesswasm_encode: (a: number, b: number, c: number) => void;
@@ -3979,6 +3998,8 @@ export interface InitOutput {
   readonly undomanager_groupEnd: (a: number) => void;
   readonly undomanager_canUndo: (a: number) => number;
   readonly undomanager_canRedo: (a: number) => number;
+  readonly undomanager_topUndoValue: (a: number) => number;
+  readonly undomanager_topRedoValue: (a: number) => number;
   readonly undomanager_setMaxUndoSteps: (a: number, b: number) => void;
   readonly undomanager_setMergeInterval: (a: number, b: number) => void;
   readonly undomanager_addExcludeOriginPrefix: (a: number, b: number, c: number) => void;

package/web/loro_wasm.js

@@ -1114,6 +1114,13 @@ export class LoroCounter {
         const ret = wasm.lorocounter_getShallowValue(this.__wbg_ptr);
         return ret;
     }
+    /**
+     * @returns {number}
+     */
+    toJSON() {
+        const ret = wasm.lorocounter_toJSON(this.__wbg_ptr);
+        return ret;
+    }
 }
 
 const LoroDocFinalization = (typeof FinalizationRegistry === 'undefined')
@@ -1675,6 +1682,13 @@ export class LoroDoc {
      * the largest existing timestamp will be used instead.
      *
      * NOTE: The `origin` will not be persisted, but the `message` will.
+     *
+     * Behavior on empty commits:
+     * - This method is an explicit commit. If the pending transaction is empty, any provided
+     *   options (message/timestamp/origin) are swallowed and will not carry over to the next commit.
+     * - Implicit commits triggered by `export`/`checkout` act as processing barriers. If the
+     *   transaction is empty in those cases, `message`/`timestamp`/`origin` are preserved for the
+     *   next commit.
      * @param {{ origin?: string, timestamp?: number, message?: string } | null} [options]
      */
     commit(options) {
@@ -6214,6 +6228,24 @@ export class UndoManager {
         const ret = wasm.undomanager_canRedo(this.__wbg_ptr);
         return ret !== 0;
     }
+    /**
+     * Get the value associated with the top undo stack item, if any.
+     * Returns `undefined` if there is no undo item.
+     * @returns {Value | undefined}
+     */
+    topUndoValue() {
+        const ret = wasm.undomanager_topUndoValue(this.__wbg_ptr);
+        return takeObject(ret);
+    }
+    /**
+     * Get the value associated with the top redo stack item, if any.
+     * Returns `undefined` if there is no redo item.
+     * @returns {Value | undefined}
+     */
+    topRedoValue() {
+        const ret = wasm.undomanager_topRedoValue(this.__wbg_ptr);
+        return takeObject(ret);
+    }
     /**
      * The number of max undo steps.
      * If the number of undo steps exceeds this number, the oldest undo step will be removed.
@@ -6793,7 +6825,7 @@ function __wbg_get_imports() {
         const ret = getObject(arg0).node;
         return addHeapObject(ret);
     };
-    imports.wbg.__wbg_now_4f8b2820be8a682c = function() {
+    imports.wbg.__wbg_now_bbd8229e4a52638e = function() {
         const ret = Date.now();
         return ret;
     };

package/web/loro_wasm_bg.wasm.d.ts

@@ -13,6 +13,7 @@ export const lorocounter_parent: (a: number) => number;
 export const lorocounter_isAttached: (a: number) => number;
 export const lorocounter_getAttached: (a: number) => number;
 export const lorocounter_getShallowValue: (a: number) => number;
+export const lorocounter_toJSON: (a: number) => number;
 export const __wbg_awarenesswasm_free: (a: number, b: number) => void;
 export const awarenesswasm_new: (a: number, b: number) => number;
 export const awarenesswasm_encode: (a: number, b: number, c: number) => void;
@@ -285,6 +286,8 @@ export const undomanager_groupStart: (a: number, b: number) => void;
 export const undomanager_groupEnd: (a: number) => void;
 export const undomanager_canUndo: (a: number) => number;
 export const undomanager_canRedo: (a: number) => number;
+export const undomanager_topUndoValue: (a: number) => number;
+export const undomanager_topRedoValue: (a: number) => number;
 export const undomanager_setMaxUndoSteps: (a: number, b: number) => void;
 export const undomanager_setMergeInterval: (a: number, b: number) => void;
 export const undomanager_addExcludeOriginPrefix: (a: number, b: number, c: number) => void;