loro-crdt 0.10.0 → 0.11.0

package/CHANGELOG.md

@@ -1,5 +1,29 @@
 # Changelog
 
+## 0.11.0
+
+### Minor Changes
+
+- Fix a few bugs and include BREAKING CHANG refactors
+
+  - fix: should not reset the state when calling checkout to latest (#265)
+  - refactor: only send a event for one `import`/`transaction`/`checkout` (#263)
+  - perf: optimize snapshot encoding speed (#264)
+  - feat: remove deleted set in tree state and optimize api (#259)
+
+### Patch Changes
+
+- Updated dependencies
+  - loro-wasm@0.11.0
+
+## 0.10.1
+
+### Patch Changes
+
+- fix: remove checking after checkout
+- Updated dependencies
+  - loro-wasm@0.10.1
+
 ## 0.10.0
 
 ### Minor Changes

package/dist/loro.d.ts

@@ -5,36 +5,46 @@ export { Loro } from 'loro-wasm';
 type Frontiers = OpId[];
 /**
  * Represents a path to identify the exact location of an event's target.
- * The path is composed of numbers (e.g., indices of a list container) and strings
- * (e.g., keys of a map container), indicating the absolute position of the event's source
- * within a loro document.
+ * The path is composed of numbers (e.g., indices of a list container) strings
+ * (e.g., keys of a map container) and TreeID (the node of a tree container),
+ * indicating the absolute position of the event's source within a loro document.
  */
-type Path = (number | string)[];
+type Path = (number | string | TreeID)[];
 /**
- * The event of Loro.
+ * A batch of events that created by a single `import`/`transaction`/`checkout`.
+ *
  * @prop local - Indicates whether the event is local.
  * @prop origin - (Optional) Provides information about the origin of the event.
  * @prop diff - Contains the differential information related to the event.
  * @prop target - Identifies the container ID of the event's target.
  * @prop path - Specifies the absolute path of the event's emitter, which can be an index of a list container or a key of a map container.
  */
-interface LoroEvent {
+interface LoroEventBatch {
+    local: boolean;
     /**
-     * The unique ID of the event.
+     * If true, this event was triggered by a checkout.
      */
-    id: bigint;
-    local: boolean;
+    fromCheckout: boolean;
     origin?: string;
     /**
-     * If true, this event was triggered by a child container.
+     * The container ID of the current event receiver.
+     * It's undefined if the subscriber is on the root document.
      */
-    fromChildren: boolean;
+    currentTarget?: ContainerID;
+    events: LoroEvent[];
+}
+/**
+ * The concrete event of Loro.
+ */
+interface LoroEvent {
     /**
-     * If true, this event was triggered by a checkout.
+     * The container ID of the event's target.
      */
-    fromCheckout: boolean;
-    diff: Diff;
     target: ContainerID;
+    diff: Diff;
+    /**
+     * The absolute path of the event's emitter, which can be an index of a list container or a key of a map container.
+     */
     path: Path;
 }
 type ListDiff = {
@@ -49,20 +59,25 @@ type MapDiff = {
     type: "map";
     updated: Record<string, Value | Container | undefined>;
 };
+type TreeDiffItem = {
+    target: TreeID;
+    action: "create";
+    parent: TreeID | undefined;
+} | {
+    target: TreeID;
+    action: "delete";
+} | {
+    target: TreeID;
+    action: "move";
+    parent: TreeID | undefined;
+};
 type TreeDiff = {
     type: "tree";
-    diff: {
-        target: TreeID;
-        action: "create" | "delete";
-    } | {
-        target: TreeID;
-        action: "move";
-        parent: TreeID;
-    };
+    diff: TreeDiffItem[];
 };
 type Diff = ListDiff | TextDiff | MapDiff | TreeDiff;
 interface Listener {
-    (event: LoroEvent): void;
+    (event: LoroEventBatch): void;
 }
 declare function isContainerId(s: string): s is ContainerID;
 
@@ -141,14 +156,21 @@ declare module "loro-wasm" {
         subscribe(txn: Loro, listener: Listener): number;
     }
     interface LoroTree {
-        create(parent: TreeID | undefined): TreeID;
-        mov(target: TreeID, parent: TreeID | undefined): void;
+        createNode(parent: TreeID | undefined): LoroTreeNode;
+        move(target: TreeID, parent: TreeID | undefined): void;
         delete(target: TreeID): void;
-        getMeta(target: TreeID): LoroMap;
-        parent(target: TreeID): TreeID | undefined;
-        contains(target: TreeID): boolean;
+        has(target: TreeID): boolean;
+        getNodeByID(target: TreeID): LoroTreeNode;
         subscribe(txn: Loro, listener: Listener): number;
     }
+    interface LoroTreeNode {
+        readonly data: LoroMap;
+        createNode(): LoroTreeNode;
+        setAsRoot(): void;
+        moveTo(parent: LoroTreeNode): void;
+        parent(): LoroTreeNode | undefined;
+        children(): Array<LoroTreeNode>;
+    }
 }
 
-export { Diff, Frontiers, ListDiff, LoroEvent, MapDiff, Path, TextDiff, TreeDiff, getType, isContainer, isContainerId };
+export { Diff, Frontiers, ListDiff, LoroEvent, LoroEventBatch, MapDiff, Path, TextDiff, TreeDiff, TreeDiffItem, getType, isContainer, isContainerId };

package/dist/loro.js.map

@@ -1 +1 @@
-{"version":3,"file":"loro.js","sources":["../src/index.ts"],"sourcesContent":["export * from \"loro-wasm\";\nimport { Container, Delta, LoroText, LoroTree, OpId, Value, ContainerID, Loro, LoroList, LoroMap, TreeID } from \"loro-wasm\";\n\n\nLoro.prototype.getTypedMap = function (...args) {\n  return this.getMap(...args);\n};\nLoro.prototype.getTypedList = function (...args) {\n  return this.getList(...args);\n};\nLoroList.prototype.getTyped = function (loro, index) {\n  const value = this.get(index);\n  if (typeof value === \"string\" && isContainerId(value)) {\n    return loro.getContainerById(value);\n  } else {\n    return value;\n  }\n};\nLoroList.prototype.insertTyped = function (...args) {\n  return this.insert(...args);\n};\nLoroMap.prototype.getTyped = function (loro, key) {\n  const value = this.get(key);\n  if (typeof value === \"string\" && isContainerId(value)) {\n    return loro.getContainerById(value);\n  } else {\n    return value;\n  }\n};\nLoroMap.prototype.setTyped = function (...args) {\n  return this.set(...args);\n};\n\nexport type Frontiers = OpId[];\n\n/**\n * Represents a path to identify the exact location of an event's target.\n * The path is composed of numbers (e.g., indices of a list container) and strings\n * (e.g., keys of a map container), indicating the absolute position of the event's source\n * within a loro document.\n */\nexport type Path = (number | string)[];\n\n/**\n * The event of Loro.\n * @prop local - Indicates whether the event is local.\n * @prop origin - (Optional) Provides information about the origin of the event.\n * @prop diff - Contains the differential information related to the event.\n * @prop target - Identifies the container ID of the event's target.\n * @prop path - Specifies the absolute path of the event's emitter, which can be an index of a list container or a key of a map container.\n */\nexport interface LoroEvent {\n  /**\n   * The unique ID of the event.\n   */\n  id: bigint;\n  local: boolean;\n  origin?: string;\n  /**\n   * If true, this event was triggered by a child container.\n   */\n  fromChildren: boolean;\n  /**\n   * If true, this event was triggered by a checkout.\n   */\n  fromCheckout: boolean;\n  diff: Diff;\n  target: ContainerID;\n  path: Path;\n}\n\nexport type ListDiff = {\n  type: \"list\";\n  diff: Delta<(Value | Container)[]>[];\n};\n\nexport type TextDiff = {\n  type: \"text\";\n  diff: Delta<string>[];\n};\n\nexport type MapDiff = {\n  type: \"map\";\n  updated: Record<string, Value | Container | undefined>;\n};\n\nexport type TreeDiff = {\n  type: \"tree\";\n  diff:\n  | { target: TreeID; action: \"create\" | \"delete\" }\n  | { target: TreeID; action: \"move\"; parent: TreeID };\n};\n\nexport type Diff = ListDiff | TextDiff | MapDiff | TreeDiff;\n\ninterface Listener {\n  (event: LoroEvent): void;\n}\n\nconst CONTAINER_TYPES = [\"Map\", \"Text\", \"List\", \"Tree\"];\n\nexport function isContainerId(s: string): s is ContainerID {\n  return s.startsWith(\"cid:\");\n}\n\nexport { Loro };\n\n/**  Whether the value is a container.\n * \n * # Example\n * \n * ```ts\n * const doc = new Loro();\n * const map = doc.getMap(\"map\");\n * const list = doc.getList(\"list\");\n * const text = doc.getText(\"text\");\n * isContainer(map); // true\n * isContainer(list); // true\n * isContainer(text); // true\n * isContainer(123); // false\n * isContainer(\"123\"); // false\n * isContainer({}); // false\n */\nexport function isContainer(value: any): value is Container {\n  if (typeof value !== \"object\" || value == null) {\n    return false;\n  }\n\n  const p = Object.getPrototypeOf(value);\n  if (p == null || typeof p !== \"object\" || typeof p[\"kind\"] !== \"function\") {\n    return false;\n  }\n\n  return CONTAINER_TYPES.includes(value.kind());\n}\n\n/**  Get the type of a value that may be a container.\n * \n * # Example\n * \n * ```ts\n * const doc = new Loro();\n * const map = doc.getMap(\"map\");\n * const list = doc.getList(\"list\");\n * const text = doc.getText(\"text\");\n * getType(map); // \"Map\"\n * getType(list); // \"List\"\n * getType(text); // \"Text\"\n * getType(123); // \"Json\"\n * getType(\"123\"); // \"Json\"\n * getType({}); // \"Json\"\n * ```\n */\nexport function getType<T>(value: T): T extends LoroText ? \"Text\" :\n  T extends LoroMap ? \"Map\" :\n  T extends LoroTree ? \"Tree\" :\n  T extends LoroList ? \"List\" : \"Json\" {\n  if (isContainer(value)) {\n    return value.kind();\n  }\n\n  return \"Json\" as any;\n}\n\ndeclare module \"loro-wasm\" {\n  interface Loro {\n    subscribe(listener: Listener): number;\n  }\n\n  interface Loro<T extends Record<string, any> = Record<string, any>> {\n    getTypedMap<Key extends keyof T & string>(\n      name: Key\n    ): T[Key] extends LoroMap ? T[Key] : never;\n    getTypedList<Key extends keyof T & string>(\n      name: Key\n    ): T[Key] extends LoroList ? T[Key] : never;\n  }\n\n  interface LoroList<T extends any[] = any[]> {\n    insertContainer(pos: number, container: \"Map\"): LoroMap;\n    insertContainer(pos: number, container: \"List\"): LoroList;\n    insertContainer(pos: number, container: \"Text\"): LoroText;\n    insertContainer(pos: number, container: \"Tree\"): LoroTree;\n    insertContainer(pos: number, container: string): never;\n\n    get(index: number): undefined | Value | Container;\n    getTyped<Key extends keyof T & number>(loro: Loro, index: Key): T[Key];\n    insertTyped<Key extends keyof T & number>(pos: Key, value: T[Key]): void;\n    insert(pos: number, value: Value): void;\n    delete(pos: number, len: number): void;\n    subscribe(txn: Loro, listener: Listener): number;\n  }\n\n  interface LoroMap<T extends Record<string, any> = Record<string, any>> {\n    setContainer(key: string, container_type: \"Map\"): LoroMap;\n    setContainer(key: string, container_type: \"List\"): LoroList;\n    setContainer(key: string, container_type: \"Text\"): LoroText;\n    setContainer(key: string, container_type: \"Tree\"): LoroTree;\n    setContainer(key: string, container_type: string): never;\n\n    get(key: string): undefined | Value | Container;\n    getTyped<Key extends keyof T & string>(txn: Loro, key: Key): T[Key];\n    set(key: string, value: Value): void;\n    setTyped<Key extends keyof T & string>(key: Key, value: T[Key]): void;\n    delete(key: string): void;\n    subscribe(txn: Loro, listener: Listener): number;\n  }\n\n  interface LoroText {\n    insert(pos: number, text: string): void;\n    delete(pos: number, len: number): void;\n    subscribe(txn: Loro, listener: Listener): number;\n  }\n\n  interface LoroTree {\n    create(parent: TreeID | undefined): TreeID;\n    mov(target: TreeID, parent: TreeID | undefined): void;\n    delete(target: TreeID): void;\n    getMeta(target: TreeID): LoroMap;\n    parent(target: TreeID): TreeID | undefined;\n    contains(target: TreeID): boolean;\n    subscribe(txn: Loro, listener: Listener): number;\n  }\n}\n"],"names":["Loro","LoroList","LoroMap"],"mappings":";;;;AAIAA,aAAK,CAAA,SAAA,CAAU,WAAc,GAAA,SAAA,GAAa,IAAM,EAAA;AAC9C,EAAO,OAAA,IAAA,CAAK,MAAO,CAAA,GAAG,IAAI,CAAA,CAAA;AAC5B,CAAA,CAAA;AACAA,aAAK,CAAA,SAAA,CAAU,YAAe,GAAA,SAAA,GAAa,IAAM,EAAA;AAC/C,EAAO,OAAA,IAAA,CAAK,OAAQ,CAAA,GAAG,IAAI,CAAA,CAAA;AAC7B,CAAA,CAAA;AACAC,iBAAA,CAAS,SAAU,CAAA,QAAA,GAAW,SAAU,IAAA,EAAM,KAAO,EAAA;AACnD,EAAM,MAAA,KAAA,GAAQ,IAAK,CAAA,GAAA,CAAI,KAAK,CAAA,CAAA;AAC5B,EAAA,IAAI,OAAO,KAAA,KAAU,QAAY,IAAA,aAAA,CAAc,KAAK,CAAG,EAAA;AACrD,IAAO,OAAA,IAAA,CAAK,iBAAiB,KAAK,CAAA,CAAA;AAAA,GAC7B,MAAA;AACL,IAAO,OAAA,KAAA,CAAA;AAAA,GACT;AACF,CAAA,CAAA;AACAA,iBAAS,CAAA,SAAA,CAAU,WAAc,GAAA,SAAA,GAAa,IAAM,EAAA;AAClD,EAAO,OAAA,IAAA,CAAK,MAAO,CAAA,GAAG,IAAI,CAAA,CAAA;AAC5B,CAAA,CAAA;AACAC,gBAAA,CAAQ,SAAU,CAAA,QAAA,GAAW,SAAU,IAAA,EAAM,GAAK,EAAA;AAChD,EAAM,MAAA,KAAA,GAAQ,IAAK,CAAA,GAAA,CAAI,GAAG,CAAA,CAAA;AAC1B,EAAA,IAAI,OAAO,KAAA,KAAU,QAAY,IAAA,aAAA,CAAc,KAAK,CAAG,EAAA;AACrD,IAAO,OAAA,IAAA,CAAK,iBAAiB,KAAK,CAAA,CAAA;AAAA,GAC7B,MAAA;AACL,IAAO,OAAA,KAAA,CAAA;AAAA,GACT;AACF,CAAA,CAAA;AACAA,gBAAQ,CAAA,SAAA,CAAU,QAAW,GAAA,SAAA,GAAa,IAAM,EAAA;AAC9C,EAAO,OAAA,IAAA,CAAK,GAAI,CAAA,GAAG,IAAI,CAAA,CAAA;AACzB,CAAA,CAAA;AAoEA,MAAM,eAAkB,GAAA,CAAC,KAAO,EAAA,MAAA,EAAQ,QAAQ,MAAM,CAAA,CAAA;AAE/C,SAAS,cAAc,CAA6B,EAAA;AACzD,EAAO,OAAA,CAAA,CAAE,WAAW,MAAM,CAAA,CAAA;AAC5B,CAAA;AAoBO,SAAS,YAAY,KAAgC,EAAA;AAC1D,EAAA,IAAI,OAAO,KAAA,KAAU,QAAY,IAAA,KAAA,IAAS,IAAM,EAAA;AAC9C,IAAO,OAAA,KAAA,CAAA;AAAA,GACT;AAEA,EAAM,MAAA,CAAA,GAAI,MAAO,CAAA,cAAA,CAAe,KAAK,CAAA,CAAA;AACrC,EAAI,IAAA,CAAA,IAAK,QAAQ,OAAO,CAAA,KAAM,YAAY,OAAO,CAAA,CAAE,MAAM,CAAA,KAAM,UAAY,EAAA;AACzE,IAAO,OAAA,KAAA,CAAA;AAAA,GACT;AAEA,EAAA,OAAO,eAAgB,CAAA,QAAA,CAAS,KAAM,CAAA,IAAA,EAAM,CAAA,CAAA;AAC9C,CAAA;AAmBO,SAAS,QAAW,KAGY,EAAA;AACrC,EAAI,IAAA,WAAA,CAAY,KAAK,CAAG,EAAA;AACtB,IAAA,OAAO,MAAM,IAAK,EAAA,CAAA;AAAA,GACpB;AAEA,EAAO,OAAA,MAAA,CAAA;AACT;;;;;;;;;;;;;;;;"}
+{"version":3,"file":"loro.js","sources":["../src/index.ts"],"sourcesContent":["export * from \"loro-wasm\";\nimport { Container, Delta, LoroText, LoroTree,LoroTreeNode, OpId, Value, ContainerID, Loro, LoroList, LoroMap, TreeID } from \"loro-wasm\";\n\n\nLoro.prototype.getTypedMap = function (...args) {\n  return this.getMap(...args);\n};\nLoro.prototype.getTypedList = function (...args) {\n  return this.getList(...args);\n};\nLoroList.prototype.getTyped = function (loro, index) {\n  const value = this.get(index);\n  if (typeof value === \"string\" && isContainerId(value)) {\n    return loro.getContainerById(value);\n  } else {\n    return value;\n  }\n};\nLoroList.prototype.insertTyped = function (...args) {\n  return this.insert(...args);\n};\nLoroMap.prototype.getTyped = function (loro, key) {\n  const value = this.get(key);\n  if (typeof value === \"string\" && isContainerId(value)) {\n    return loro.getContainerById(value);\n  } else {\n    return value;\n  }\n};\nLoroMap.prototype.setTyped = function (...args) {\n  return this.set(...args);\n};\n\nexport type Frontiers = OpId[];\n\n/**\n * Represents a path to identify the exact location of an event's target.\n * The path is composed of numbers (e.g., indices of a list container) strings\n * (e.g., keys of a map container) and TreeID (the node of a tree container), \n * indicating the absolute position of the event's source within a loro document.\n */\nexport type Path = (number | string | TreeID )[];\n\n/**\n * A batch of events that created by a single `import`/`transaction`/`checkout`.\n *\n * @prop local - Indicates whether the event is local.\n * @prop origin - (Optional) Provides information about the origin of the event.\n * @prop diff - Contains the differential information related to the event.\n * @prop target - Identifies the container ID of the event's target.\n * @prop path - Specifies the absolute path of the event's emitter, which can be an index of a list container or a key of a map container.\n */\nexport interface LoroEventBatch {\n  local: boolean;\n  /**\n   * If true, this event was triggered by a checkout.\n   */\n  fromCheckout: boolean;\n  origin?: string;\n  /**\n   * The container ID of the current event receiver.\n   * It's undefined if the subscriber is on the root document.\n   */\n  currentTarget?: ContainerID;\n  events: LoroEvent[];\n}\n\n/**\n * The concrete event of Loro.\n */\nexport interface LoroEvent {\n  /**\n   * The container ID of the event's target.\n   */\n  target: ContainerID;\n  diff: Diff;\n  /**\n   * The absolute path of the event's emitter, which can be an index of a list container or a key of a map container.\n   */\n  path: Path;\n}\n\nexport type ListDiff = {\n  type: \"list\";\n  diff: Delta<(Value | Container)[]>[];\n};\n\nexport type TextDiff = {\n  type: \"text\";\n  diff: Delta<string>[];\n};\n\nexport type MapDiff = {\n  type: \"map\";\n  updated: Record<string, Value | Container | undefined>;\n};\n\nexport type TreeDiffItem = { target: TreeID; action: \"create\"; parent: TreeID | undefined }\n   | { target: TreeID; action: \"delete\" }\n   | { target: TreeID; action: \"move\"; parent: TreeID | undefined };\n\nexport type TreeDiff = {\n  type: \"tree\";\n  diff: TreeDiffItem[];\n};\n\nexport type Diff = ListDiff | TextDiff | MapDiff | TreeDiff;\n\ninterface Listener {\n  (event: LoroEventBatch): void;\n}\n\nconst CONTAINER_TYPES = [\"Map\", \"Text\", \"List\", \"Tree\"];\n\nexport function isContainerId(s: string): s is ContainerID {\n  return s.startsWith(\"cid:\");\n}\n\nexport { Loro };\n\n/**  Whether the value is a container.\n *\n * # Example\n *\n * ```ts\n * const doc = new Loro();\n * const map = doc.getMap(\"map\");\n * const list = doc.getList(\"list\");\n * const text = doc.getText(\"text\");\n * isContainer(map); // true\n * isContainer(list); // true\n * isContainer(text); // true\n * isContainer(123); // false\n * isContainer(\"123\"); // false\n * isContainer({}); // false\n */\nexport function isContainer(value: any): value is Container {\n  if (typeof value !== \"object\" || value == null) {\n    return false;\n  }\n\n  const p = Object.getPrototypeOf(value);\n  if (p == null || typeof p !== \"object\" || typeof p[\"kind\"] !== \"function\") {\n    return false;\n  }\n\n  return CONTAINER_TYPES.includes(value.kind());\n}\n\n/**  Get the type of a value that may be a container.\n *\n * # Example\n *\n * ```ts\n * const doc = new Loro();\n * const map = doc.getMap(\"map\");\n * const list = doc.getList(\"list\");\n * const text = doc.getText(\"text\");\n * getType(map); // \"Map\"\n * getType(list); // \"List\"\n * getType(text); // \"Text\"\n * getType(123); // \"Json\"\n * getType(\"123\"); // \"Json\"\n * getType({}); // \"Json\"\n * ```\n */\nexport function getType<T>(\n  value: T,\n): T extends LoroText\n  ? \"Text\"\n  : T extends LoroMap\n  ? \"Map\"\n  : T extends LoroTree\n  ? \"Tree\"\n  : T extends LoroList\n  ? \"List\"\n  : \"Json\" {\n  if (isContainer(value)) {\n    return value.kind();\n  }\n\n  return \"Json\" as any;\n}\n\ndeclare module \"loro-wasm\" {\n  interface Loro {\n    subscribe(listener: Listener): number;\n  }\n\n  interface Loro<T extends Record<string, any> = Record<string, any>> {\n    getTypedMap<Key extends keyof T & string>(\n      name: Key,\n    ): T[Key] extends LoroMap ? T[Key] : never;\n    getTypedList<Key extends keyof T & string>(\n      name: Key,\n    ): T[Key] extends LoroList ? T[Key] : never;\n  }\n\n  interface LoroList<T extends any[] = any[]> {\n    insertContainer(pos: number, container: \"Map\"): LoroMap;\n    insertContainer(pos: number, container: \"List\"): LoroList;\n    insertContainer(pos: number, container: \"Text\"): LoroText;\n    insertContainer(pos: number, container: \"Tree\"): LoroTree;\n    insertContainer(pos: number, container: string): never;\n\n    get(index: number): undefined | Value | Container;\n    getTyped<Key extends keyof T & number>(loro: Loro, index: Key): T[Key];\n    insertTyped<Key extends keyof T & number>(pos: Key, value: T[Key]): void;\n    insert(pos: number, value: Value): void;\n    delete(pos: number, len: number): void;\n    subscribe(txn: Loro, listener: Listener): number;\n  }\n\n  interface LoroMap<T extends Record<string, any> = Record<string, any>> {\n    setContainer(key: string, container_type: \"Map\"): LoroMap;\n    setContainer(key: string, container_type: \"List\"): LoroList;\n    setContainer(key: string, container_type: \"Text\"): LoroText;\n    setContainer(key: string, container_type: \"Tree\"): LoroTree;\n    setContainer(key: string, container_type: string): never;\n\n    get(key: string): undefined | Value | Container;\n    getTyped<Key extends keyof T & string>(txn: Loro, key: Key): T[Key];\n    set(key: string, value: Value): void;\n    setTyped<Key extends keyof T & string>(key: Key, value: T[Key]): void;\n    delete(key: string): void;\n    subscribe(txn: Loro, listener: Listener): number;\n  }\n\n  interface LoroText {\n    insert(pos: number, text: string): void;\n    delete(pos: number, len: number): void;\n    subscribe(txn: Loro, listener: Listener): number;\n  }\n\n  interface LoroTree {\n    createNode(parent: TreeID | undefined): LoroTreeNode;\n    move(target: TreeID, parent: TreeID | undefined): void;\n    delete(target: TreeID): void;\n    has(target: TreeID): boolean;\n    getNodeByID(target: TreeID): LoroTreeNode;\n    subscribe(txn: Loro, listener: Listener): number;\n  }\n\n  interface LoroTreeNode{\n    readonly data: LoroMap;\n    createNode(): LoroTreeNode;\n    setAsRoot(): void;\n    moveTo(parent: LoroTreeNode): void;\n    parent(): LoroTreeNode | undefined;\n    children(): Array<LoroTreeNode>;\n  }\n}\n"],"names":["Loro","LoroList","LoroMap"],"mappings":";;;;AAIAA,aAAK,CAAA,SAAA,CAAU,WAAc,GAAA,SAAA,GAAa,IAAM,EAAA;AAC9C,EAAO,OAAA,IAAA,CAAK,MAAO,CAAA,GAAG,IAAI,CAAA,CAAA;AAC5B,CAAA,CAAA;AACAA,aAAK,CAAA,SAAA,CAAU,YAAe,GAAA,SAAA,GAAa,IAAM,EAAA;AAC/C,EAAO,OAAA,IAAA,CAAK,OAAQ,CAAA,GAAG,IAAI,CAAA,CAAA;AAC7B,CAAA,CAAA;AACAC,iBAAA,CAAS,SAAU,CAAA,QAAA,GAAW,SAAU,IAAA,EAAM,KAAO,EAAA;AACnD,EAAM,MAAA,KAAA,GAAQ,IAAK,CAAA,GAAA,CAAI,KAAK,CAAA,CAAA;AAC5B,EAAA,IAAI,OAAO,KAAA,KAAU,QAAY,IAAA,aAAA,CAAc,KAAK,CAAG,EAAA;AACrD,IAAO,OAAA,IAAA,CAAK,iBAAiB,KAAK,CAAA,CAAA;AAAA,GAC7B,MAAA;AACL,IAAO,OAAA,KAAA,CAAA;AAAA,GACT;AACF,CAAA,CAAA;AACAA,iBAAS,CAAA,SAAA,CAAU,WAAc,GAAA,SAAA,GAAa,IAAM,EAAA;AAClD,EAAO,OAAA,IAAA,CAAK,MAAO,CAAA,GAAG,IAAI,CAAA,CAAA;AAC5B,CAAA,CAAA;AACAC,gBAAA,CAAQ,SAAU,CAAA,QAAA,GAAW,SAAU,IAAA,EAAM,GAAK,EAAA;AAChD,EAAM,MAAA,KAAA,GAAQ,IAAK,CAAA,GAAA,CAAI,GAAG,CAAA,CAAA;AAC1B,EAAA,IAAI,OAAO,KAAA,KAAU,QAAY,IAAA,aAAA,CAAc,KAAK,CAAG,EAAA;AACrD,IAAO,OAAA,IAAA,CAAK,iBAAiB,KAAK,CAAA,CAAA;AAAA,GAC7B,MAAA;AACL,IAAO,OAAA,KAAA,CAAA;AAAA,GACT;AACF,CAAA,CAAA;AACAA,gBAAQ,CAAA,SAAA,CAAU,QAAW,GAAA,SAAA,GAAa,IAAM,EAAA;AAC9C,EAAO,OAAA,IAAA,CAAK,GAAI,CAAA,GAAG,IAAI,CAAA,CAAA;AACzB,CAAA,CAAA;AAiFA,MAAM,eAAkB,GAAA,CAAC,KAAO,EAAA,MAAA,EAAQ,QAAQ,MAAM,CAAA,CAAA;AAE/C,SAAS,cAAc,CAA6B,EAAA;AACzD,EAAO,OAAA,CAAA,CAAE,WAAW,MAAM,CAAA,CAAA;AAC5B,CAAA;AAoBO,SAAS,YAAY,KAAgC,EAAA;AAC1D,EAAA,IAAI,OAAO,KAAA,KAAU,QAAY,IAAA,KAAA,IAAS,IAAM,EAAA;AAC9C,IAAO,OAAA,KAAA,CAAA;AAAA,GACT;AAEA,EAAM,MAAA,CAAA,GAAI,MAAO,CAAA,cAAA,CAAe,KAAK,CAAA,CAAA;AACrC,EAAI,IAAA,CAAA,IAAK,QAAQ,OAAO,CAAA,KAAM,YAAY,OAAO,CAAA,CAAE,MAAM,CAAA,KAAM,UAAY,EAAA;AACzE,IAAO,OAAA,KAAA,CAAA;AAAA,GACT;AAEA,EAAA,OAAO,eAAgB,CAAA,QAAA,CAAS,KAAM,CAAA,IAAA,EAAM,CAAA,CAAA;AAC9C,CAAA;AAmBO,SAAS,QACd,KASS,EAAA;AACT,EAAI,IAAA,WAAA,CAAY,KAAK,CAAG,EAAA;AACtB,IAAA,OAAO,MAAM,IAAK,EAAA,CAAA;AAAA,GACpB;AAEA,EAAO,OAAA,MAAA,CAAA;AACT;;;;;;;;;;;;;;;;"}

package/dist/loro.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"loro.mjs","sources":["../src/index.ts"],"sourcesContent":["export * from \"loro-wasm\";\nimport { Container, Delta, LoroText, LoroTree, OpId, Value, ContainerID, Loro, LoroList, LoroMap, TreeID } from \"loro-wasm\";\n\n\nLoro.prototype.getTypedMap = function (...args) {\n  return this.getMap(...args);\n};\nLoro.prototype.getTypedList = function (...args) {\n  return this.getList(...args);\n};\nLoroList.prototype.getTyped = function (loro, index) {\n  const value = this.get(index);\n  if (typeof value === \"string\" && isContainerId(value)) {\n    return loro.getContainerById(value);\n  } else {\n    return value;\n  }\n};\nLoroList.prototype.insertTyped = function (...args) {\n  return this.insert(...args);\n};\nLoroMap.prototype.getTyped = function (loro, key) {\n  const value = this.get(key);\n  if (typeof value === \"string\" && isContainerId(value)) {\n    return loro.getContainerById(value);\n  } else {\n    return value;\n  }\n};\nLoroMap.prototype.setTyped = function (...args) {\n  return this.set(...args);\n};\n\nexport type Frontiers = OpId[];\n\n/**\n * Represents a path to identify the exact location of an event's target.\n * The path is composed of numbers (e.g., indices of a list container) and strings\n * (e.g., keys of a map container), indicating the absolute position of the event's source\n * within a loro document.\n */\nexport type Path = (number | string)[];\n\n/**\n * The event of Loro.\n * @prop local - Indicates whether the event is local.\n * @prop origin - (Optional) Provides information about the origin of the event.\n * @prop diff - Contains the differential information related to the event.\n * @prop target - Identifies the container ID of the event's target.\n * @prop path - Specifies the absolute path of the event's emitter, which can be an index of a list container or a key of a map container.\n */\nexport interface LoroEvent {\n  /**\n   * The unique ID of the event.\n   */\n  id: bigint;\n  local: boolean;\n  origin?: string;\n  /**\n   * If true, this event was triggered by a child container.\n   */\n  fromChildren: boolean;\n  /**\n   * If true, this event was triggered by a checkout.\n   */\n  fromCheckout: boolean;\n  diff: Diff;\n  target: ContainerID;\n  path: Path;\n}\n\nexport type ListDiff = {\n  type: \"list\";\n  diff: Delta<(Value | Container)[]>[];\n};\n\nexport type TextDiff = {\n  type: \"text\";\n  diff: Delta<string>[];\n};\n\nexport type MapDiff = {\n  type: \"map\";\n  updated: Record<string, Value | Container | undefined>;\n};\n\nexport type TreeDiff = {\n  type: \"tree\";\n  diff:\n  | { target: TreeID; action: \"create\" | \"delete\" }\n  | { target: TreeID; action: \"move\"; parent: TreeID };\n};\n\nexport type Diff = ListDiff | TextDiff | MapDiff | TreeDiff;\n\ninterface Listener {\n  (event: LoroEvent): void;\n}\n\nconst CONTAINER_TYPES = [\"Map\", \"Text\", \"List\", \"Tree\"];\n\nexport function isContainerId(s: string): s is ContainerID {\n  return s.startsWith(\"cid:\");\n}\n\nexport { Loro };\n\n/**  Whether the value is a container.\n * \n * # Example\n * \n * ```ts\n * const doc = new Loro();\n * const map = doc.getMap(\"map\");\n * const list = doc.getList(\"list\");\n * const text = doc.getText(\"text\");\n * isContainer(map); // true\n * isContainer(list); // true\n * isContainer(text); // true\n * isContainer(123); // false\n * isContainer(\"123\"); // false\n * isContainer({}); // false\n */\nexport function isContainer(value: any): value is Container {\n  if (typeof value !== \"object\" || value == null) {\n    return false;\n  }\n\n  const p = Object.getPrototypeOf(value);\n  if (p == null || typeof p !== \"object\" || typeof p[\"kind\"] !== \"function\") {\n    return false;\n  }\n\n  return CONTAINER_TYPES.includes(value.kind());\n}\n\n/**  Get the type of a value that may be a container.\n * \n * # Example\n * \n * ```ts\n * const doc = new Loro();\n * const map = doc.getMap(\"map\");\n * const list = doc.getList(\"list\");\n * const text = doc.getText(\"text\");\n * getType(map); // \"Map\"\n * getType(list); // \"List\"\n * getType(text); // \"Text\"\n * getType(123); // \"Json\"\n * getType(\"123\"); // \"Json\"\n * getType({}); // \"Json\"\n * ```\n */\nexport function getType<T>(value: T): T extends LoroText ? \"Text\" :\n  T extends LoroMap ? \"Map\" :\n  T extends LoroTree ? \"Tree\" :\n  T extends LoroList ? \"List\" : \"Json\" {\n  if (isContainer(value)) {\n    return value.kind();\n  }\n\n  return \"Json\" as any;\n}\n\ndeclare module \"loro-wasm\" {\n  interface Loro {\n    subscribe(listener: Listener): number;\n  }\n\n  interface Loro<T extends Record<string, any> = Record<string, any>> {\n    getTypedMap<Key extends keyof T & string>(\n      name: Key\n    ): T[Key] extends LoroMap ? T[Key] : never;\n    getTypedList<Key extends keyof T & string>(\n      name: Key\n    ): T[Key] extends LoroList ? T[Key] : never;\n  }\n\n  interface LoroList<T extends any[] = any[]> {\n    insertContainer(pos: number, container: \"Map\"): LoroMap;\n    insertContainer(pos: number, container: \"List\"): LoroList;\n    insertContainer(pos: number, container: \"Text\"): LoroText;\n    insertContainer(pos: number, container: \"Tree\"): LoroTree;\n    insertContainer(pos: number, container: string): never;\n\n    get(index: number): undefined | Value | Container;\n    getTyped<Key extends keyof T & number>(loro: Loro, index: Key): T[Key];\n    insertTyped<Key extends keyof T & number>(pos: Key, value: T[Key]): void;\n    insert(pos: number, value: Value): void;\n    delete(pos: number, len: number): void;\n    subscribe(txn: Loro, listener: Listener): number;\n  }\n\n  interface LoroMap<T extends Record<string, any> = Record<string, any>> {\n    setContainer(key: string, container_type: \"Map\"): LoroMap;\n    setContainer(key: string, container_type: \"List\"): LoroList;\n    setContainer(key: string, container_type: \"Text\"): LoroText;\n    setContainer(key: string, container_type: \"Tree\"): LoroTree;\n    setContainer(key: string, container_type: string): never;\n\n    get(key: string): undefined | Value | Container;\n    getTyped<Key extends keyof T & string>(txn: Loro, key: Key): T[Key];\n    set(key: string, value: Value): void;\n    setTyped<Key extends keyof T & string>(key: Key, value: T[Key]): void;\n    delete(key: string): void;\n    subscribe(txn: Loro, listener: Listener): number;\n  }\n\n  interface LoroText {\n    insert(pos: number, text: string): void;\n    delete(pos: number, len: number): void;\n    subscribe(txn: Loro, listener: Listener): number;\n  }\n\n  interface LoroTree {\n    create(parent: TreeID | undefined): TreeID;\n    mov(target: TreeID, parent: TreeID | undefined): void;\n    delete(target: TreeID): void;\n    getMeta(target: TreeID): LoroMap;\n    parent(target: TreeID): TreeID | undefined;\n    contains(target: TreeID): boolean;\n    subscribe(txn: Loro, listener: Listener): number;\n  }\n}\n"],"names":[],"mappings":";;;;AAIA,IAAK,CAAA,SAAA,CAAU,WAAc,GAAA,SAAA,GAAa,IAAM,EAAA;AAC9C,EAAO,OAAA,IAAA,CAAK,MAAO,CAAA,GAAG,IAAI,CAAA,CAAA;AAC5B,CAAA,CAAA;AACA,IAAK,CAAA,SAAA,CAAU,YAAe,GAAA,SAAA,GAAa,IAAM,EAAA;AAC/C,EAAO,OAAA,IAAA,CAAK,OAAQ,CAAA,GAAG,IAAI,CAAA,CAAA;AAC7B,CAAA,CAAA;AACA,QAAA,CAAS,SAAU,CAAA,QAAA,GAAW,SAAU,IAAA,EAAM,KAAO,EAAA;AACnD,EAAM,MAAA,KAAA,GAAQ,IAAK,CAAA,GAAA,CAAI,KAAK,CAAA,CAAA;AAC5B,EAAA,IAAI,OAAO,KAAA,KAAU,QAAY,IAAA,aAAA,CAAc,KAAK,CAAG,EAAA;AACrD,IAAO,OAAA,IAAA,CAAK,iBAAiB,KAAK,CAAA,CAAA;AAAA,GAC7B,MAAA;AACL,IAAO,OAAA,KAAA,CAAA;AAAA,GACT;AACF,CAAA,CAAA;AACA,QAAS,CAAA,SAAA,CAAU,WAAc,GAAA,SAAA,GAAa,IAAM,EAAA;AAClD,EAAO,OAAA,IAAA,CAAK,MAAO,CAAA,GAAG,IAAI,CAAA,CAAA;AAC5B,CAAA,CAAA;AACA,OAAA,CAAQ,SAAU,CAAA,QAAA,GAAW,SAAU,IAAA,EAAM,GAAK,EAAA;AAChD,EAAM,MAAA,KAAA,GAAQ,IAAK,CAAA,GAAA,CAAI,GAAG,CAAA,CAAA;AAC1B,EAAA,IAAI,OAAO,KAAA,KAAU,QAAY,IAAA,aAAA,CAAc,KAAK,CAAG,EAAA;AACrD,IAAO,OAAA,IAAA,CAAK,iBAAiB,KAAK,CAAA,CAAA;AAAA,GAC7B,MAAA;AACL,IAAO,OAAA,KAAA,CAAA;AAAA,GACT;AACF,CAAA,CAAA;AACA,OAAQ,CAAA,SAAA,CAAU,QAAW,GAAA,SAAA,GAAa,IAAM,EAAA;AAC9C,EAAO,OAAA,IAAA,CAAK,GAAI,CAAA,GAAG,IAAI,CAAA,CAAA;AACzB,CAAA,CAAA;AAoEA,MAAM,eAAkB,GAAA,CAAC,KAAO,EAAA,MAAA,EAAQ,QAAQ,MAAM,CAAA,CAAA;AAE/C,SAAS,cAAc,CAA6B,EAAA;AACzD,EAAO,OAAA,CAAA,CAAE,WAAW,MAAM,CAAA,CAAA;AAC5B,CAAA;AAoBO,SAAS,YAAY,KAAgC,EAAA;AAC1D,EAAA,IAAI,OAAO,KAAA,KAAU,QAAY,IAAA,KAAA,IAAS,IAAM,EAAA;AAC9C,IAAO,OAAA,KAAA,CAAA;AAAA,GACT;AAEA,EAAM,MAAA,CAAA,GAAI,MAAO,CAAA,cAAA,CAAe,KAAK,CAAA,CAAA;AACrC,EAAI,IAAA,CAAA,IAAK,QAAQ,OAAO,CAAA,KAAM,YAAY,OAAO,CAAA,CAAE,MAAM,CAAA,KAAM,UAAY,EAAA;AACzE,IAAO,OAAA,KAAA,CAAA;AAAA,GACT;AAEA,EAAA,OAAO,eAAgB,CAAA,QAAA,CAAS,KAAM,CAAA,IAAA,EAAM,CAAA,CAAA;AAC9C,CAAA;AAmBO,SAAS,QAAW,KAGY,EAAA;AACrC,EAAI,IAAA,WAAA,CAAY,KAAK,CAAG,EAAA;AACtB,IAAA,OAAO,MAAM,IAAK,EAAA,CAAA;AAAA,GACpB;AAEA,EAAO,OAAA,MAAA,CAAA;AACT;;;;"}
+{"version":3,"file":"loro.mjs","sources":["../src/index.ts"],"sourcesContent":["export * from \"loro-wasm\";\nimport { Container, Delta, LoroText, LoroTree,LoroTreeNode, OpId, Value, ContainerID, Loro, LoroList, LoroMap, TreeID } from \"loro-wasm\";\n\n\nLoro.prototype.getTypedMap = function (...args) {\n  return this.getMap(...args);\n};\nLoro.prototype.getTypedList = function (...args) {\n  return this.getList(...args);\n};\nLoroList.prototype.getTyped = function (loro, index) {\n  const value = this.get(index);\n  if (typeof value === \"string\" && isContainerId(value)) {\n    return loro.getContainerById(value);\n  } else {\n    return value;\n  }\n};\nLoroList.prototype.insertTyped = function (...args) {\n  return this.insert(...args);\n};\nLoroMap.prototype.getTyped = function (loro, key) {\n  const value = this.get(key);\n  if (typeof value === \"string\" && isContainerId(value)) {\n    return loro.getContainerById(value);\n  } else {\n    return value;\n  }\n};\nLoroMap.prototype.setTyped = function (...args) {\n  return this.set(...args);\n};\n\nexport type Frontiers = OpId[];\n\n/**\n * Represents a path to identify the exact location of an event's target.\n * The path is composed of numbers (e.g., indices of a list container) strings\n * (e.g., keys of a map container) and TreeID (the node of a tree container), \n * indicating the absolute position of the event's source within a loro document.\n */\nexport type Path = (number | string | TreeID )[];\n\n/**\n * A batch of events that created by a single `import`/`transaction`/`checkout`.\n *\n * @prop local - Indicates whether the event is local.\n * @prop origin - (Optional) Provides information about the origin of the event.\n * @prop diff - Contains the differential information related to the event.\n * @prop target - Identifies the container ID of the event's target.\n * @prop path - Specifies the absolute path of the event's emitter, which can be an index of a list container or a key of a map container.\n */\nexport interface LoroEventBatch {\n  local: boolean;\n  /**\n   * If true, this event was triggered by a checkout.\n   */\n  fromCheckout: boolean;\n  origin?: string;\n  /**\n   * The container ID of the current event receiver.\n   * It's undefined if the subscriber is on the root document.\n   */\n  currentTarget?: ContainerID;\n  events: LoroEvent[];\n}\n\n/**\n * The concrete event of Loro.\n */\nexport interface LoroEvent {\n  /**\n   * The container ID of the event's target.\n   */\n  target: ContainerID;\n  diff: Diff;\n  /**\n   * The absolute path of the event's emitter, which can be an index of a list container or a key of a map container.\n   */\n  path: Path;\n}\n\nexport type ListDiff = {\n  type: \"list\";\n  diff: Delta<(Value | Container)[]>[];\n};\n\nexport type TextDiff = {\n  type: \"text\";\n  diff: Delta<string>[];\n};\n\nexport type MapDiff = {\n  type: \"map\";\n  updated: Record<string, Value | Container | undefined>;\n};\n\nexport type TreeDiffItem = { target: TreeID; action: \"create\"; parent: TreeID | undefined }\n   | { target: TreeID; action: \"delete\" }\n   | { target: TreeID; action: \"move\"; parent: TreeID | undefined };\n\nexport type TreeDiff = {\n  type: \"tree\";\n  diff: TreeDiffItem[];\n};\n\nexport type Diff = ListDiff | TextDiff | MapDiff | TreeDiff;\n\ninterface Listener {\n  (event: LoroEventBatch): void;\n}\n\nconst CONTAINER_TYPES = [\"Map\", \"Text\", \"List\", \"Tree\"];\n\nexport function isContainerId(s: string): s is ContainerID {\n  return s.startsWith(\"cid:\");\n}\n\nexport { Loro };\n\n/**  Whether the value is a container.\n *\n * # Example\n *\n * ```ts\n * const doc = new Loro();\n * const map = doc.getMap(\"map\");\n * const list = doc.getList(\"list\");\n * const text = doc.getText(\"text\");\n * isContainer(map); // true\n * isContainer(list); // true\n * isContainer(text); // true\n * isContainer(123); // false\n * isContainer(\"123\"); // false\n * isContainer({}); // false\n */\nexport function isContainer(value: any): value is Container {\n  if (typeof value !== \"object\" || value == null) {\n    return false;\n  }\n\n  const p = Object.getPrototypeOf(value);\n  if (p == null || typeof p !== \"object\" || typeof p[\"kind\"] !== \"function\") {\n    return false;\n  }\n\n  return CONTAINER_TYPES.includes(value.kind());\n}\n\n/**  Get the type of a value that may be a container.\n *\n * # Example\n *\n * ```ts\n * const doc = new Loro();\n * const map = doc.getMap(\"map\");\n * const list = doc.getList(\"list\");\n * const text = doc.getText(\"text\");\n * getType(map); // \"Map\"\n * getType(list); // \"List\"\n * getType(text); // \"Text\"\n * getType(123); // \"Json\"\n * getType(\"123\"); // \"Json\"\n * getType({}); // \"Json\"\n * ```\n */\nexport function getType<T>(\n  value: T,\n): T extends LoroText\n  ? \"Text\"\n  : T extends LoroMap\n  ? \"Map\"\n  : T extends LoroTree\n  ? \"Tree\"\n  : T extends LoroList\n  ? \"List\"\n  : \"Json\" {\n  if (isContainer(value)) {\n    return value.kind();\n  }\n\n  return \"Json\" as any;\n}\n\ndeclare module \"loro-wasm\" {\n  interface Loro {\n    subscribe(listener: Listener): number;\n  }\n\n  interface Loro<T extends Record<string, any> = Record<string, any>> {\n    getTypedMap<Key extends keyof T & string>(\n      name: Key,\n    ): T[Key] extends LoroMap ? T[Key] : never;\n    getTypedList<Key extends keyof T & string>(\n      name: Key,\n    ): T[Key] extends LoroList ? T[Key] : never;\n  }\n\n  interface LoroList<T extends any[] = any[]> {\n    insertContainer(pos: number, container: \"Map\"): LoroMap;\n    insertContainer(pos: number, container: \"List\"): LoroList;\n    insertContainer(pos: number, container: \"Text\"): LoroText;\n    insertContainer(pos: number, container: \"Tree\"): LoroTree;\n    insertContainer(pos: number, container: string): never;\n\n    get(index: number): undefined | Value | Container;\n    getTyped<Key extends keyof T & number>(loro: Loro, index: Key): T[Key];\n    insertTyped<Key extends keyof T & number>(pos: Key, value: T[Key]): void;\n    insert(pos: number, value: Value): void;\n    delete(pos: number, len: number): void;\n    subscribe(txn: Loro, listener: Listener): number;\n  }\n\n  interface LoroMap<T extends Record<string, any> = Record<string, any>> {\n    setContainer(key: string, container_type: \"Map\"): LoroMap;\n    setContainer(key: string, container_type: \"List\"): LoroList;\n    setContainer(key: string, container_type: \"Text\"): LoroText;\n    setContainer(key: string, container_type: \"Tree\"): LoroTree;\n    setContainer(key: string, container_type: string): never;\n\n    get(key: string): undefined | Value | Container;\n    getTyped<Key extends keyof T & string>(txn: Loro, key: Key): T[Key];\n    set(key: string, value: Value): void;\n    setTyped<Key extends keyof T & string>(key: Key, value: T[Key]): void;\n    delete(key: string): void;\n    subscribe(txn: Loro, listener: Listener): number;\n  }\n\n  interface LoroText {\n    insert(pos: number, text: string): void;\n    delete(pos: number, len: number): void;\n    subscribe(txn: Loro, listener: Listener): number;\n  }\n\n  interface LoroTree {\n    createNode(parent: TreeID | undefined): LoroTreeNode;\n    move(target: TreeID, parent: TreeID | undefined): void;\n    delete(target: TreeID): void;\n    has(target: TreeID): boolean;\n    getNodeByID(target: TreeID): LoroTreeNode;\n    subscribe(txn: Loro, listener: Listener): number;\n  }\n\n  interface LoroTreeNode{\n    readonly data: LoroMap;\n    createNode(): LoroTreeNode;\n    setAsRoot(): void;\n    moveTo(parent: LoroTreeNode): void;\n    parent(): LoroTreeNode | undefined;\n    children(): Array<LoroTreeNode>;\n  }\n}\n"],"names":[],"mappings":";;;;AAIA,IAAK,CAAA,SAAA,CAAU,WAAc,GAAA,SAAA,GAAa,IAAM,EAAA;AAC9C,EAAO,OAAA,IAAA,CAAK,MAAO,CAAA,GAAG,IAAI,CAAA,CAAA;AAC5B,CAAA,CAAA;AACA,IAAK,CAAA,SAAA,CAAU,YAAe,GAAA,SAAA,GAAa,IAAM,EAAA;AAC/C,EAAO,OAAA,IAAA,CAAK,OAAQ,CAAA,GAAG,IAAI,CAAA,CAAA;AAC7B,CAAA,CAAA;AACA,QAAA,CAAS,SAAU,CAAA,QAAA,GAAW,SAAU,IAAA,EAAM,KAAO,EAAA;AACnD,EAAM,MAAA,KAAA,GAAQ,IAAK,CAAA,GAAA,CAAI,KAAK,CAAA,CAAA;AAC5B,EAAA,IAAI,OAAO,KAAA,KAAU,QAAY,IAAA,aAAA,CAAc,KAAK,CAAG,EAAA;AACrD,IAAO,OAAA,IAAA,CAAK,iBAAiB,KAAK,CAAA,CAAA;AAAA,GAC7B,MAAA;AACL,IAAO,OAAA,KAAA,CAAA;AAAA,GACT;AACF,CAAA,CAAA;AACA,QAAS,CAAA,SAAA,CAAU,WAAc,GAAA,SAAA,GAAa,IAAM,EAAA;AAClD,EAAO,OAAA,IAAA,CAAK,MAAO,CAAA,GAAG,IAAI,CAAA,CAAA;AAC5B,CAAA,CAAA;AACA,OAAA,CAAQ,SAAU,CAAA,QAAA,GAAW,SAAU,IAAA,EAAM,GAAK,EAAA;AAChD,EAAM,MAAA,KAAA,GAAQ,IAAK,CAAA,GAAA,CAAI,GAAG,CAAA,CAAA;AAC1B,EAAA,IAAI,OAAO,KAAA,KAAU,QAAY,IAAA,aAAA,CAAc,KAAK,CAAG,EAAA;AACrD,IAAO,OAAA,IAAA,CAAK,iBAAiB,KAAK,CAAA,CAAA;AAAA,GAC7B,MAAA;AACL,IAAO,OAAA,KAAA,CAAA;AAAA,GACT;AACF,CAAA,CAAA;AACA,OAAQ,CAAA,SAAA,CAAU,QAAW,GAAA,SAAA,GAAa,IAAM,EAAA;AAC9C,EAAO,OAAA,IAAA,CAAK,GAAI,CAAA,GAAG,IAAI,CAAA,CAAA;AACzB,CAAA,CAAA;AAiFA,MAAM,eAAkB,GAAA,CAAC,KAAO,EAAA,MAAA,EAAQ,QAAQ,MAAM,CAAA,CAAA;AAE/C,SAAS,cAAc,CAA6B,EAAA;AACzD,EAAO,OAAA,CAAA,CAAE,WAAW,MAAM,CAAA,CAAA;AAC5B,CAAA;AAoBO,SAAS,YAAY,KAAgC,EAAA;AAC1D,EAAA,IAAI,OAAO,KAAA,KAAU,QAAY,IAAA,KAAA,IAAS,IAAM,EAAA;AAC9C,IAAO,OAAA,KAAA,CAAA;AAAA,GACT;AAEA,EAAM,MAAA,CAAA,GAAI,MAAO,CAAA,cAAA,CAAe,KAAK,CAAA,CAAA;AACrC,EAAI,IAAA,CAAA,IAAK,QAAQ,OAAO,CAAA,KAAM,YAAY,OAAO,CAAA,CAAE,MAAM,CAAA,KAAM,UAAY,EAAA;AACzE,IAAO,OAAA,KAAA,CAAA;AAAA,GACT;AAEA,EAAA,OAAO,eAAgB,CAAA,QAAA,CAAS,KAAM,CAAA,IAAA,EAAM,CAAA,CAAA;AAC9C,CAAA;AAmBO,SAAS,QACd,KASS,EAAA;AACT,EAAI,IAAA,WAAA,CAAY,KAAK,CAAG,EAAA;AACtB,IAAA,OAAO,MAAM,IAAK,EAAA,CAAA;AAAA,GACpB;AAEA,EAAO,OAAA,MAAA,CAAA;AACT;;;;"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "loro-crdt",
-  "version": "0.10.0",
+  "version": "0.11.0",
   "description": "Loro CRDTs is a high-performance CRDT framework that makes your app state synchronized, collaborative and maintainable effortlessly.",
   "keywords": [
     "crdt",
@@ -17,7 +17,7 @@
   "homepage": "https://loro.dev",
   "license": "MIT",
   "dependencies": {
-    "loro-wasm": "0.10.0"
+    "loro-wasm": "0.11.0"
   },
   "devDependencies": {
     "@rollup/plugin-node-resolve": "^15.0.1",

package/src/index.ts

@@ -1,5 +1,5 @@
 export * from "loro-wasm";
-import { Container, Delta, LoroText, LoroTree, OpId, Value, ContainerID, Loro, LoroList, LoroMap, TreeID } from "loro-wasm";
+import { Container, Delta, LoroText, LoroTree,LoroTreeNode, OpId, Value, ContainerID, Loro, LoroList, LoroMap, TreeID } from "loro-wasm";
 
 
 Loro.prototype.getTypedMap = function (...args) {
@@ -35,37 +35,48 @@ export type Frontiers = OpId[];
 
 /**
  * Represents a path to identify the exact location of an event's target.
- * The path is composed of numbers (e.g., indices of a list container) and strings
- * (e.g., keys of a map container), indicating the absolute position of the event's source
- * within a loro document.
+ * The path is composed of numbers (e.g., indices of a list container) strings
+ * (e.g., keys of a map container) and TreeID (the node of a tree container), 
+ * indicating the absolute position of the event's source within a loro document.
  */
-export type Path = (number | string)[];
+export type Path = (number | string | TreeID )[];
 
 /**
- * The event of Loro.
+ * A batch of events that created by a single `import`/`transaction`/`checkout`.
+ *
  * @prop local - Indicates whether the event is local.
  * @prop origin - (Optional) Provides information about the origin of the event.
  * @prop diff - Contains the differential information related to the event.
  * @prop target - Identifies the container ID of the event's target.
  * @prop path - Specifies the absolute path of the event's emitter, which can be an index of a list container or a key of a map container.
  */
-export interface LoroEvent {
+export interface LoroEventBatch {
+  local: boolean;
   /**
-   * The unique ID of the event.
+   * If true, this event was triggered by a checkout.
    */
-  id: bigint;
-  local: boolean;
+  fromCheckout: boolean;
   origin?: string;
   /**
-   * If true, this event was triggered by a child container.
+   * The container ID of the current event receiver.
+   * It's undefined if the subscriber is on the root document.
    */
-  fromChildren: boolean;
+  currentTarget?: ContainerID;
+  events: LoroEvent[];
+}
+
+/**
+ * The concrete event of Loro.
+ */
+export interface LoroEvent {
   /**
-   * If true, this event was triggered by a checkout.
+   * The container ID of the event's target.
    */
-  fromCheckout: boolean;
-  diff: Diff;
   target: ContainerID;
+  diff: Diff;
+  /**
+   * The absolute path of the event's emitter, which can be an index of a list container or a key of a map container.
+   */
   path: Path;
 }
 
@@ -84,17 +95,19 @@ export type MapDiff = {
   updated: Record<string, Value | Container | undefined>;
 };
 
+export type TreeDiffItem = { target: TreeID; action: "create"; parent: TreeID | undefined }
+   | { target: TreeID; action: "delete" }
+   | { target: TreeID; action: "move"; parent: TreeID | undefined };
+
 export type TreeDiff = {
   type: "tree";
-  diff:
-  | { target: TreeID; action: "create" | "delete" }
-  | { target: TreeID; action: "move"; parent: TreeID };
+  diff: TreeDiffItem[];
 };
 
 export type Diff = ListDiff | TextDiff | MapDiff | TreeDiff;
 
 interface Listener {
-  (event: LoroEvent): void;
+  (event: LoroEventBatch): void;
 }
 
 const CONTAINER_TYPES = ["Map", "Text", "List", "Tree"];
@@ -106,9 +119,9 @@ export function isContainerId(s: string): s is ContainerID {
 export { Loro };
 
 /**  Whether the value is a container.
- * 
+ *
  * # Example
- * 
+ *
  * ```ts
  * const doc = new Loro();
  * const map = doc.getMap("map");
@@ -135,9 +148,9 @@ export function isContainer(value: any): value is Container {
 }
 
 /**  Get the type of a value that may be a container.
- * 
+ *
  * # Example
- * 
+ *
  * ```ts
  * const doc = new Loro();
  * const map = doc.getMap("map");
@@ -151,10 +164,17 @@ export function isContainer(value: any): value is Container {
  * getType({}); // "Json"
  * ```
  */
-export function getType<T>(value: T): T extends LoroText ? "Text" :
-  T extends LoroMap ? "Map" :
-  T extends LoroTree ? "Tree" :
-  T extends LoroList ? "List" : "Json" {
+export function getType<T>(
+  value: T,
+): T extends LoroText
+  ? "Text"
+  : T extends LoroMap
+  ? "Map"
+  : T extends LoroTree
+  ? "Tree"
+  : T extends LoroList
+  ? "List"
+  : "Json" {
   if (isContainer(value)) {
     return value.kind();
   }
@@ -169,10 +189,10 @@ declare module "loro-wasm" {
 
   interface Loro<T extends Record<string, any> = Record<string, any>> {
     getTypedMap<Key extends keyof T & string>(
-      name: Key
+      name: Key,
     ): T[Key] extends LoroMap ? T[Key] : never;
     getTypedList<Key extends keyof T & string>(
-      name: Key
+      name: Key,
     ): T[Key] extends LoroList ? T[Key] : never;
   }
 
@@ -213,12 +233,20 @@ declare module "loro-wasm" {
   }
 
   interface LoroTree {
-    create(parent: TreeID | undefined): TreeID;
-    mov(target: TreeID, parent: TreeID | undefined): void;
+    createNode(parent: TreeID | undefined): LoroTreeNode;
+    move(target: TreeID, parent: TreeID | undefined): void;
     delete(target: TreeID): void;
-    getMeta(target: TreeID): LoroMap;
-    parent(target: TreeID): TreeID | undefined;
-    contains(target: TreeID): boolean;
+    has(target: TreeID): boolean;
+    getNodeByID(target: TreeID): LoroTreeNode;
     subscribe(txn: Loro, listener: Listener): number;
   }
+
+  interface LoroTreeNode{
+    readonly data: LoroMap;
+    createNode(): LoroTreeNode;
+    setAsRoot(): void;
+    moveTo(parent: LoroTreeNode): void;
+    parent(): LoroTreeNode | undefined;
+    children(): Array<LoroTreeNode>;
+  }
 }