loro-crdt 1.2.1 → 1.2.2

package/web/index.js

@@ -152,6 +152,53 @@ class Awareness {
         }, this.timeout / 2);
     }
 }
+LoroDoc.prototype.toJsonWithReplacer = function (replacer) {
+    const doc = this;
+    const m = (key, value) => {
+        if (typeof value === "string") {
+            if (isContainerId(value)) {
+                const container = doc.getContainerById(value);
+                if (container == null) {
+                    throw new Error(`ContainerID not found: ${value}`);
+                }
+                const ans = replacer(key, container);
+                if (ans === container) {
+                    const ans = container.getShallowValue();
+                    if (typeof ans === "object") {
+                        return run(ans);
+                    }
+                    return ans;
+                }
+                if (isContainer(ans)) {
+                    throw new Error("Using new container is not allowed in toJsonWithReplacer");
+                }
+                return ans;
+            }
+        }
+        const ans = replacer(key, value);
+        if (isContainer(ans)) {
+            throw new Error("Using new container is not allowed in toJsonWithReplacer");
+        }
+        return ans;
+    };
+    const run = (layer) => {
+        if (Array.isArray(layer)) {
+            return layer.map((item, index) => {
+                return m(index, item);
+            }).filter((item) => item !== undefined);
+        }
+        const result = {};
+        for (const [key, value] of Object.entries(layer)) {
+            const ans = m(key, value);
+            if (ans !== undefined) {
+                result[key] = ans;
+            }
+        }
+        return result;
+    };
+    const layer = this.getShallowValue();
+    return run(layer);
+};
 
 export { Awareness, Loro, getType, isContainer, isContainerId, newContainerID, newRootContainerID };
 //# sourceMappingURL=index.js.map

package/web/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../../index.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sources":["../../index.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/web/loro_wasm.d.ts

@@ -155,6 +155,36 @@ interface LoroDoc {
      * ```
      */
     subscribeLocalUpdates(f: (bytes: Uint8Array) => void): () => void
+    /**
+     * Convert the document to a JSON value with a custom replacer function.
+     * 
+     * This method works similarly to `JSON.stringify`'s replacer parameter.
+     * The replacer function is called for each value in the document and can transform
+     * how values are serialized to JSON.
+     * 
+     * @param replacer - A function that takes a key and value, and returns how that value
+     *                  should be serialized. Similar to JSON.stringify's replacer. 
+     *                  If return undefined, the value will be skipped.
+     * @returns The JSON representation of the document after applying the replacer function.
+     * 
+     * @example
+     * ```ts
+     * const doc = new LoroDoc();
+     * const text = doc.getText("text");
+     * text.insert(0, "Hello");
+     * text.mark(0, 2, {bold: true});
+     * 
+     * // Use delta to represent text
+     * const json = doc.toJsonWithReplacer((key, value) => {
+     *   if (value instanceof LoroText) {
+     *     return value.toDelta();
+     *   } 
+     * 
+     *   return value;
+     * });
+     * ```
+     */
+    toJsonWithReplacer(replacer: (key: string | index, value: Value | Container) => Value | Container | undefined): Value;
 }
 
 /**
@@ -231,7 +261,8 @@ export type Value =
   | null
   | { [key: string]: Value }
   | Uint8Array
-  | Value[];
+  | Value[]
+  | undefined;
 
 export type UndoConfig = {
     mergeInterval?: number,
@@ -343,6 +374,15 @@ interface LoroList {
     getCursor(pos: number, side?: Side): Cursor | undefined;
 }
 
+export type TreeNodeShallowValue = {
+    id: TreeID,
+    parent: TreeID | undefined,
+    index: number,
+    fractionalIndex: string,
+    meta: ContainerID,
+    children: TreeNodeShallowValue[],
+}
+
 export type TreeNodeValue = {
     id: TreeID,
     parent: TreeID | undefined,
@@ -1320,6 +1360,11 @@ export class LoroCounter {
   getAttached(): LoroTree | undefined;
 /**
 * Get the value of the counter.
+* @returns {number}
+*/
+  getShallowValue(): number;
+/**
+* Get the value of the counter.
 */
   readonly value: number;
 }
@@ -1863,7 +1908,30 @@ export class LoroDoc {
 */
   import(update_or_snapshot: Uint8Array): ImportStatus;
 /**
-* Import a batch of updates.
+* Import a batch of updates and snapshots.
+*
+* It's more efficient than importing updates one by one.
+*
+* @deprecated Use `importBatch` instead.
+*
+* @example
+* ```ts
+* import { LoroDoc } from "loro-crdt";
+*
+* const doc = new LoroDoc();
+* const text = doc.getText("text");
+* text.insert(0, "Hello");
+* const updates = doc.export({ mode: "update" });
+* const snapshot = doc.export({ mode: "snapshot" });
+* const doc2 = new LoroDoc();
+* doc2.importBatch([snapshot, updates]);
+* ```
+* @param {Uint8Array[]} data
+* @returns {ImportStatus}
+*/
+  importUpdateBatch(data: Uint8Array[]): ImportStatus;
+/**
+* Import a batch of updates or snapshots.
 *
 * It's more efficient than importing updates one by one.
 *
@@ -1877,15 +1945,18 @@ export class LoroDoc {
 * const updates = doc.export({ mode: "update" });
 * const snapshot = doc.export({ mode: "snapshot" });
 * const doc2 = new LoroDoc();
-* doc2.importUpdateBatch([snapshot, updates]);
+* doc2.importBatch([snapshot, updates]);
 * ```
-* @param {Array<any>} data
+* @param {Uint8Array[]} data
 * @returns {ImportStatus}
 */
-  importUpdateBatch(data: Array<any>): ImportStatus;
+  importBatch(data: Uint8Array[]): ImportStatus;
 /**
 * Get the shallow json format of the document state.
 *
+* Unlike `toJSON()` which recursively resolves all containers to their values,
+* `getShallowValue()` returns container IDs as strings for any nested containers.
+*
 * @example
 * ```ts
 * import { LoroDoc } from "loro-crdt";
@@ -1895,20 +1966,28 @@ export class LoroDoc {
 * const tree = doc.getTree("tree");
 * const map = doc.getMap("map");
 * const shallowValue = doc.getShallowValue();
-* /*
-* {"list": ..., "tree": ..., "map": ...}
-*  *\/
 * console.log(shallowValue);
+* // {
+* //   list: 'cid:root-list:List',
+* //   tree: 'cid:root-tree:Tree',
+* //   map: 'cid:root-map:Map'
+* // }
+*
+* // It points to the same container as `list`
+* const listB = doc.getContainerById(shallowValue.list);
 * ```
-* @returns {any}
+* @returns {Record<string, ContainerID>}
 */
-  getShallowValue(): any;
+  getShallowValue(): Record<string, ContainerID>;
 /**
 * Get the json format of the entire document state.
 *
+* Unlike `getShallowValue()` which returns container IDs as strings,
+* `toJSON()` recursively resolves all containers to their actual values.
+*
 * @example
 * ```ts
-* import { LoroDoc, LoroText, LoroMap } from "loro-crdt";
+* import { LoroDoc, LoroText } from "loro-crdt";
 *
 * const doc = new LoroDoc();
 * const list = doc.getList("list");
@@ -1917,10 +1996,8 @@ export class LoroDoc {
 * text.insert(0, "Hello");
 * const map = list.insertContainer(1, new LoroMap());
 * map.set("foo", "bar");
-* /*
-* {"list": ["Hello", {"foo": "bar"}]}
-*  *\/
 * console.log(doc.toJSON());
+* // {"list": ["Hello", {"foo": "bar"}]}
 * ```
 * @returns {any}
 */
@@ -2181,6 +2258,26 @@ export class LoroList {
 */
   isDeleted(): boolean;
 /**
+* Get the shallow value of the list.
+*
+* Unlike `toJSON()` which recursively resolves all containers to their values,
+* `getShallowValue()` returns container IDs as strings for any nested containers.
+*
+* ```js
+* const doc = new LoroDoc();
+* doc.setPeerId("1");
+* const list = doc.getList("list");
+* list.insert(0, 1);
+* list.insert(1, "two");
+* const subList = list.insertContainer(2, new LoroList());
+* subList.insert(0, "sub");
+* list.getShallowValue(); // [1, "two", "cid:2@1:List"]
+* list.toJSON(); // [1, "two", ["sub"]]
+* ```
+* @returns {Value[]}
+*/
+  getShallowValue(): Value[];
+/**
 * Get the id of this container.
 */
   readonly id: ContainerID;
@@ -2342,6 +2439,34 @@ export class LoroMap {
 */
   isDeleted(): boolean;
 /**
+* Get the shallow value of the map.
+*
+* Unlike `toJSON()` which recursively resolves all containers to their values,
+* `getShallowValue()` returns container IDs as strings for any nested containers.
+*
+* @example
+* ```ts
+* import { LoroDoc } from "loro-crdt";
+*
+* const doc = new LoroDoc();
+* doc.setPeerId("1");
+* const map = doc.getMap("map");
+* map.set("key", "value");
+* const subText = map.setContainer("text", new LoroText());
+* subText.insert(0, "Hello");
+*
+* // Get shallow value - nested containers are represented by their IDs
+* console.log(map.getShallowValue());
+* // Output: { key: "value", text: "cid:1@1:Text" }
+*
+* // Get full value with nested containers resolved by `toJSON()`
+* console.log(map.toJSON());
+* // Output: { key: "value", text: "Hello" }
+* ```
+* @returns {Record<string, Value>}
+*/
+  getShallowValue(): Record<string, Value>;
+/**
 * The container id of this handler.
 */
   readonly id: ContainerID;
@@ -2485,6 +2610,26 @@ export class LoroMovableList {
 */
   isDeleted(): boolean;
 /**
+* Get the shallow value of the movable list.
+*
+* Unlike `toJSON()` which recursively resolves all containers to their values,
+* `getShallowValue()` returns container IDs as strings for any nested containers.
+*
+* ```js
+* const doc = new LoroDoc();
+* doc.setPeerId("1");
+* const list = doc.getMovableList("list");
+* list.insert(0, 1);
+* list.insert(1, "two");
+* const subList = list.insertContainer(2, new LoroList());
+* subList.insert(0, "sub");
+* list.getShallowValue(); // [1, "two", "cid:2@1:List"]
+* list.toJSON(); // [1, "two", ["sub"]]
+* ```
+* @returns {Value[]}
+*/
+  getShallowValue(): Value[];
+/**
 * Get the id of this container.
 */
   readonly id: ContainerID;
@@ -2800,6 +2945,11 @@ export class LoroText {
 */
   isDeleted(): boolean;
 /**
+* Get the shallow value of the text. This equals to `text.toString()`.
+* @returns {string}
+*/
+  getShallowValue(): string;
+/**
 * Get the container id of the text.
 */
   readonly id: ContainerID;
@@ -2972,6 +3122,48 @@ export class LoroTree {
 */
   isDeleted(): boolean;
 /**
+* Get the shallow value of the tree.
+*
+* Unlike `toJSON()` which recursively resolves nested containers to their values,
+* `getShallowValue()` returns container IDs as strings for any nested containers.
+*
+* @example
+* ```ts
+* const doc = new LoroDoc();
+* doc.setPeerId("1");
+* const tree = doc.getTree("tree");
+* const root = tree.createNode();
+* root.data.set("name", "root");
+* const text = root.data.setContainer("content", new LoroText());
+* text.insert(0, "Hello");
+*
+* console.log(tree.getShallowValue());
+* // [{
+* //   id: "0@1",
+* //   parent: null,
+* //   index: 0,
+* //   fractional_index: "80",
+* //   meta: "cid:0@1:Map",
+* //   children: []
+* // }]
+*
+* console.log(tree.toJSON());
+* // [{
+* //   id: "0@1",
+* //   parent: null,
+* //   index: 0,
+* //   fractional_index: "80",
+* //   meta: {
+* //     name: "root",
+* //     content: "Hello"
+* //   },
+* //   children: []
+* // }]
+* ```
+* @returns {TreeNodeShallowValue[]}
+*/
+  getShallowValue(): TreeNodeShallowValue[];
+/**
 * Get the id of the container.
 */
   readonly id: ContainerID;
@@ -3269,6 +3461,7 @@ export interface InitOutput {
   readonly lorocounter_parent: (a: number) => number;
   readonly lorocounter_isAttached: (a: number) => number;
   readonly lorocounter_getAttached: (a: number) => number;
+  readonly lorocounter_getShallowValue: (a: number) => number;
   readonly __wbg_awarenesswasm_free: (a: number) => void;
   readonly awarenesswasm_new: (a: number, b: number) => number;
   readonly awarenesswasm_encode: (a: number, b: number, c: number) => void;
@@ -3335,6 +3528,7 @@ export interface InitOutput {
   readonly lorodoc_importJsonUpdates: (a: number, b: number, c: number) => void;
   readonly lorodoc_import: (a: number, b: number, c: number, d: number) => void;
   readonly lorodoc_importUpdateBatch: (a: number, b: number, c: number) => void;
+  readonly lorodoc_importBatch: (a: number, b: number, c: number) => void;
   readonly lorodoc_getShallowValue: (a: number, b: number) => void;
   readonly lorodoc_toJSON: (a: number, b: number) => void;
   readonly lorodoc_subscribe: (a: number, b: number) => number;
@@ -3378,6 +3572,7 @@ export interface InitOutput {
   readonly lorotext_push: (a: number, b: number, c: number, d: number) => void;
   readonly lorotext_getEditorOf: (a: number, b: number) => number;
   readonly lorotext_isDeleted: (a: number) => number;
+  readonly lorotext_getShallowValue: (a: number, b: number) => void;
   readonly __wbg_loromap_free: (a: number) => void;
   readonly loromap_new: () => number;
   readonly loromap_kind: (a: number) => number;
@@ -3398,6 +3593,7 @@ export interface InitOutput {
   readonly loromap_clear: (a: number, b: number) => void;
   readonly loromap_getLastEditor: (a: number, b: number, c: number) => number;
   readonly loromap_isDeleted: (a: number) => number;
+  readonly loromap_getShallowValue: (a: number) => number;
   readonly __wbg_lorolist_free: (a: number) => void;
   readonly lorolist_new: () => number;
   readonly lorolist_kind: (a: number) => number;
@@ -3420,6 +3616,7 @@ export interface InitOutput {
   readonly lorolist_clear: (a: number, b: number) => void;
   readonly lorolist_getIdAt: (a: number, b: number) => number;
   readonly lorolist_isDeleted: (a: number) => number;
+  readonly lorolist_getShallowValue: (a: number) => number;
   readonly loromovablelist_new: () => number;
   readonly loromovablelist_kind: (a: number) => number;
   readonly loromovablelist_insert: (a: number, b: number, c: number, d: number) => void;
@@ -3444,6 +3641,7 @@ export interface InitOutput {
   readonly loromovablelist_getLastMoverAt: (a: number, b: number) => number;
   readonly loromovablelist_getLastEditorAt: (a: number, b: number) => number;
   readonly loromovablelist_isDeleted: (a: number) => number;
+  readonly loromovablelist_getShallowValue: (a: number) => number;
   readonly __wbg_lorotree_free: (a: number) => void;
   readonly lorotreenode___getClassname: (a: number, b: number) => void;
   readonly __wbg_lorotreenode_free: (a: number) => void;
@@ -3484,6 +3682,7 @@ export interface InitOutput {
   readonly lorotree_disableFractionalIndex: (a: number) => void;
   readonly lorotree_isFractionalIndexEnabled: (a: number) => number;
   readonly lorotree_isDeleted: (a: number) => number;
+  readonly lorotree_getShallowValue: (a: number) => number;
   readonly __wbg_cursor_free: (a: number) => void;
   readonly cursor_containerId: (a: number) => number;
   readonly cursor_pos: (a: number) => number;