loro-crdt 0.14.6 → 0.15.1

package/CHANGELOG.md

@@ -1,5 +1,74 @@
 # Changelog
 
+## 0.15.1
+
+### Patch Changes
+
+- 04c6290: Bug fixes and improvements.
+
+  #### 🐛 Bug Fixes
+
+  - Impl a few unimplemented! for movable tree (#335)
+  - Refine ts type; reject invalid operations (#334)
+  - Get cursor err on text and movable list (#337)
+  - Missing MovableList in all container type (#343)
+  - Upgrade generic-btree to allow large btree (#344)
+
+  #### 📚 Documentation
+
+  - Add warn(missing_docs) to loro and loro-wasm (#339)
+  - Minor fix on set_change_merge_interval api (#341)
+
+  #### ⚙️ Miscellaneous Tasks
+
+  - Skip the checking if not debug_assertions (#340)
+
+  <!-- generated by git-cliff -->
+
+- Updated dependencies [04c6290]
+  - loro-wasm@0.15.1
+
+## 0.15.0
+
+### Minor Changes
+
+- 35b9b6e: Movable List (#293)
+
+  Loro's List supports insert and delete operations but lacks built-in methods for `set` and `move`. To simulate set and move, developers might combine delete and insert. However, this approach can lead to issues during concurrent operations on the same element, often resulting in duplicate entries upon merging.
+
+  For instance, consider a list [0, 1, 2]. If user A moves the element '0' to position 1, while user B moves it to position 2, the ideal merged outcome should be either [1, 0, 2] or [1, 2, 0]. However, using the delete-insert method to simulate a move results in [1, 0, 2, 0], as both users delete '0' from its original position and insert it independently at new positions.
+
+  To address this, we introduce a MovableList container. This new container type directly supports move and set operations, aligning more closely with user expectations and preventing the issues associated with simulated moves.
+
+  ## Example
+
+  ```ts
+  import { Loro } from "loro-crdt";
+  import { expect } from "vitest";
+
+  const doc = new Loro();
+  const list = doc.getMovableList("list");
+  list.push("a");
+  list.push("b");
+  list.push("c");
+  expect(list.toArray()).toEqual(["a", "b", "c"]);
+  list.set(2, "d");
+  list.move(0, 1);
+  const doc2 = new Loro();
+  const list2 = doc2.getMovableList("list");
+  expect(list2.length).toBe(0);
+  doc2.import(doc.exportFrom());
+  expect(list2.length).toBe(3);
+  expect(list2.get(0)).toBe("b");
+  expect(list2.get(1)).toBe("a");
+  expect(list2.get(2)).toBe("d");
+  ```
+
+### Patch Changes
+
+- Updated dependencies [35b9b6e]
+  - loro-wasm@0.15.0
+
 ## 0.14.6
 
 ### Patch Changes

package/dist/loro.d.ts

@@ -185,6 +185,21 @@ declare module "loro-wasm" {
          * ```
          */
         getList<Key extends (keyof T) | ContainerID>(name: Key): T[Key] extends LoroList ? T[Key] : LoroList;
+        /**
+         * Get a LoroMovableList by container id
+         *
+         * The object returned is a new js object each time because it need to cross
+         * the WASM boundary.
+         *
+         * @example
+         * ```ts
+         * import { Loro } from "loro-crdt";
+         *
+         * const doc = new Loro();
+         * const list = doc.getList("list");
+         * ```
+         */
+        getMovableList<Key extends (keyof T) | ContainerID>(name: Key): T[Key] extends LoroMovableList ? T[Key] : LoroMovableList;
         /**
          * Get a LoroTree by container id
          *
@@ -227,14 +242,14 @@ declare module "loro-wasm" {
          *
          *  @example
          *  ```ts
-         *  import { Loro } from "loro-crdt";
+         *  import { Loro, LoroText } from "loro-crdt";
          *
          *  const doc = new Loro();
          *  const list = doc.getList("list");
          *  list.insert(0, 100);
          *  const text = list.insertContainer(1, new LoroText());
          *  text.insert(0, "Hello");
-         *  console.log(list.getDeepValue());  // [100, "Hello"];
+         *  console.log(list.toJSON());  // [100, "Hello"];
          *  ```
          */
         insertContainer<C extends Container>(pos: number, child: C): T extends C ? T : C;
@@ -268,11 +283,125 @@ declare module "loro-wasm" {
          *  console.log(list.value);  // [100, "foo", true];
          *  ```
          */
-        insert(pos: number, value: Exclude<T, Container>): void;
+        insert<V extends T>(pos: number, value: Exclude<V, Container>): void;
         delete(pos: number, len: number): void;
-        subscribe(txn: Loro, listener: Listener): number;
+        push<V extends T>(value: Exclude<V, Container>): void;
+        subscribe(listener: Listener): number;
         getAttached(): undefined | LoroList<T>;
     }
+    interface LoroMovableList<T = unknown> {
+        new (): LoroMovableList<T>;
+        /**
+         *  Get elements of the list. If the value is a child container, the corresponding
+         *  `Container` will be returned.
+         *
+         *  @example
+         *  ```ts
+         *  import { Loro, LoroText } from "loro-crdt";
+         *
+         *  const doc = new Loro();
+         *  const list = doc.getMovableList("list");
+         *  list.insert(0, 100);
+         *  list.insert(1, "foo");
+         *  list.insert(2, true);
+         *  list.insertContainer(3, new LoroText());
+         *  console.log(list.value);  // [100, "foo", true, LoroText];
+         *  ```
+         */
+        toArray(): T[];
+        /**
+         * Insert a container at the index.
+         *
+         *  @example
+         *  ```ts
+         *  import { Loro } from "loro-crdt";
+         *
+         *  const doc = new Loro();
+         *  const list = doc.getMovableList("list");
+         *  list.insert(0, 100);
+         *  const text = list.insertContainer(1, new LoroText());
+         *  text.insert(0, "Hello");
+         *  console.log(list.toJSON());  // [100, "Hello"];
+         *  ```
+         */
+        insertContainer<C extends Container>(pos: number, 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.
+         *
+         *  @example
+         *  ```ts
+         *  import { Loro } from "loro-crdt";
+         *
+         *  const doc = new Loro();
+         *  const list = doc.getMoableList("list");
+         *  list.insert(0, 100);
+         *  console.log(list.get(0));  // 100
+         *  console.log(list.get(1));  // undefined
+         *  ```
+         */
+        get(index: number): T;
+        /**
+         *  Insert a value at index.
+         *
+         *  @example
+         *  ```ts
+         *  import { Loro } from "loro-crdt";
+         *
+         *  const doc = new Loro();
+         *  const list = doc.getMovableList("list");
+         *  list.insert(0, 100);
+         *  list.insert(1, "foo");
+         *  list.insert(2, true);
+         *  console.log(list.value);  // [100, "foo", true];
+         *  ```
+         */
+        insert<V extends T>(pos: number, value: Exclude<V, Container>): void;
+        delete(pos: number, len: number): void;
+        push<V extends T>(value: Exclude<V, Container>): void;
+        subscribe(listener: Listener): number;
+        getAttached(): undefined | LoroMovableList<T>;
+        /**
+         *  Set the value at the given position.
+         *
+         *  It's different from `delete` + `insert` that it will replace the value at the position.
+         *
+         *  For example, if you have a list `[1, 2, 3]`, and you call `set(1, 100)`, the list will be `[1, 100, 3]`.
+         *  If concurrently someone call `set(1, 200)`, the list will be `[1, 200, 3]` or `[1, 100, 3]`.
+         *
+         *  But if you use `delete` + `insert` to simulate the set operation, they may create redundant operations
+         *  and the final result will be `[1, 100, 200, 3]` or `[1, 200, 100, 3]`.
+         *
+         *  @example
+         *  ```ts
+         *  import { Loro } from "loro-crdt";
+         *
+         *  const doc = new Loro();
+         *  const list = doc.getList("list");
+         *  list.insert(0, 100);
+         *  list.insert(1, "foo");
+         *  list.insert(2, true);
+         *  list.set(1, "bar");
+         *  console.log(list.value);  // [100, "bar", true];
+         *  ```
+         */
+        set<V extends T>(pos: number, value: Exclude<V, Container>): void;
+        /**
+         * Set a container at the index.
+         *
+         *  @example
+         *  ```ts
+         *  import { Loro } from "loro-crdt";
+         *
+         *  const doc = new Loro();
+         *  const list = doc.getMovableList("list");
+         *  list.insert(0, 100);
+         *  const text = list.setContainer(0, new LoroText());
+         *  text.insert(0, "Hello");
+         *  console.log(list.toJSON());  // ["Hello"];
+         *  ```
+         */
+        setContainer<C extends Container>(pos: number, child: C): T extends C ? T : C;
+    }
     interface LoroMap<T extends Record<string, unknown> = Record<string, unknown>> {
         new (): LoroMap<T>;
         /**
@@ -340,15 +469,15 @@ declare module "loro-wasm" {
          *  map.set("foo", "baz");
          *  ```
          */
-        set<Key extends keyof T>(key: Key, value: Exclude<T[Key], Container>): void;
+        set<Key extends keyof T, V extends T[Key]>(key: Key, value: Exclude<V, Container>): void;
         delete(key: string): void;
-        subscribe(txn: Loro, listener: Listener): number;
+        subscribe(listener: Listener): number;
     }
     interface LoroText {
         new (): LoroText;
         insert(pos: number, text: string): void;
         delete(pos: number, len: number): void;
-        subscribe(txn: Loro, listener: Listener): number;
+        subscribe(listener: Listener): number;
     }
     interface LoroTree<T extends Record<string, unknown> = Record<string, unknown>> {
         new (): LoroTree<T>;
@@ -357,7 +486,7 @@ declare module "loro-wasm" {
         delete(target: TreeID): void;
         has(target: TreeID): boolean;
         getNodeByID(target: TreeID): LoroTreeNode;
-        subscribe(txn: Loro, listener: Listener): number;
+        subscribe(listener: Listener): number;
     }
     interface LoroTreeNode<T extends Record<string, unknown> = Record<string, unknown>> {
         /**

package/dist/loro.js.map

@@ -1 +1 @@
-{"version":3,"file":"loro.js","sources":["../src/awareness.ts","../src/index.ts"],"sourcesContent":["import { AwarenessWasm, PeerID, Value } from \"loro-wasm\";\n\nexport type AwarenessListener = (\n  arg: { updated: PeerID[]; added: PeerID[]; removed: PeerID[] },\n  origin: \"local\" | \"timeout\" | \"remote\" | string,\n) => void;\n\n/**\n * Awareness is a structure that allows to track the ephemeral state of the peers.\n *\n * If we don't receive a state update from a peer within the timeout, we will remove their state.\n * The timeout is in milliseconds. This can be used to handle the off-line state of a peer.\n */\nexport class Awareness<T extends Value = Value> {\n  inner: AwarenessWasm<T>;\n  private peer: PeerID;\n  private timer: number | undefined;\n  private timeout: number;\n  private listeners: Set<AwarenessListener> = new Set();\n  constructor(peer: PeerID, timeout: number = 30000) {\n    this.inner = new AwarenessWasm(peer, timeout);\n    this.peer = peer;\n    this.timeout = timeout;\n  }\n\n  apply(bytes: Uint8Array, origin = \"remote\") {\n    const { updated, added } = this.inner.apply(bytes);\n    this.listeners.forEach((listener) => {\n      listener({ updated, added, removed: [] }, origin);\n    });\n\n    this.startTimerIfNotEmpty();\n  }\n\n  setLocalState(state: T) {\n    const wasEmpty = this.inner.getState(this.peer) == null;\n    this.inner.setLocalState(state);\n    if (wasEmpty) {\n      this.listeners.forEach((listener) => {\n        listener(\n          { updated: [], added: [this.inner.peer()], removed: [] },\n          \"local\",\n        );\n      });\n    } else {\n      this.listeners.forEach((listener) => {\n        listener(\n          { updated: [this.inner.peer()], added: [], removed: [] },\n          \"local\",\n        );\n      });\n    }\n\n    this.startTimerIfNotEmpty();\n  }\n\n  getLocalState(): T | undefined {\n    return this.inner.getState(this.peer);\n  }\n\n  getAllStates(): Record<PeerID, T> {\n    return this.inner.getAllStates();\n  }\n\n  encode(peers: PeerID[]): Uint8Array {\n    return this.inner.encode(peers);\n  }\n\n  encodeAll(): Uint8Array {\n    return this.inner.encodeAll();\n  }\n\n  addListener(listener: AwarenessListener) {\n    this.listeners.add(listener);\n  }\n\n  removeListener(listener: AwarenessListener) {\n    this.listeners.delete(listener);\n  }\n\n  peers(): PeerID[] {\n    return this.inner.peers();\n  }\n\n  destroy() {\n    clearInterval(this.timer);\n    this.listeners.clear();\n  }\n\n  private startTimerIfNotEmpty() {\n    if (this.inner.isEmpty() || this.timer != null) {\n      return;\n    }\n\n    this.timer = setInterval(() => {\n      const removed = this.inner.removeOutdated();\n      if (removed.length > 0) {\n        this.listeners.forEach((listener) => {\n          listener({ updated: [], added: [], removed }, \"timeout\");\n        });\n      }\n      if (this.inner.isEmpty()) {\n        clearInterval(this.timer);\n        this.timer = undefined;\n      }\n    }, this.timeout / 2) as unknown as number;\n  }\n}\n","export * from \"loro-wasm\";\nimport {\n  Container,\n  ContainerID,\n  Delta,\n  Loro,\n  LoroList,\n  LoroMap,\n  LoroText,\n  LoroTree,\n  OpId,\n  TreeID,\n  Value,\n} from \"loro-wasm\";\nexport { Awareness } from \"./awareness\";\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 by - How the event is triggered.\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  /**\n   * How the event is triggered.\n   *\n   * - `local`: The event is triggered by a local transaction.\n   * - `import`: The event is triggered by an import operation.\n   * - `checkout`: The event is triggered by a checkout operation.\n   */\n  by: \"local\" | \"import\" | \"checkout\";\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 =\n  | { 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 ? \"Text\"\n  : T extends LoroMap<any> ? \"Map\"\n  : T extends LoroTree<any> ? \"Tree\"\n  : T extends LoroList<any> ? \"List\"\n  : \"Json\" {\n  if (isContainer(value)) {\n    return value.kind() as unknown as any;\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<\n    T extends Record<string, Container> = Record<string, Container>,\n  > {\n    /**\n     * Get a LoroMap by container id\n     *\n     * The object returned is a new js object each time because it need to cross\n     * the WASM boundary.\n     *\n     * @example\n     * ```ts\n     * import { Loro } from \"loro-crdt\";\n     *\n     * const doc = new Loro();\n     * const map = doc.getMap(\"map\");\n     * ```\n     */\n    getMap<Key extends (keyof T) | ContainerID>(\n      name: Key,\n    ): T[Key] extends LoroMap ? T[Key] : LoroMap;\n    /**\n     * Get a LoroList by container id\n     *\n     * The object returned is a new js object each time because it need to cross\n     * the WASM boundary.\n     *\n     * @example\n     * ```ts\n     * import { Loro } from \"loro-crdt\";\n     *\n     * const doc = new Loro();\n     * const list = doc.getList(\"list\");\n     * ```\n     */\n    getList<Key extends (keyof T) | ContainerID>(\n      name: Key,\n    ): T[Key] extends LoroList ? T[Key] : LoroList;\n    /**\n     * Get a LoroTree by container id\n     *\n     *  The object returned is a new js object each time because it need to cross\n     *  the WASM boundary.\n     *\n     *  @example\n     *  ```ts\n     *  import { Loro } from \"loro-crdt\";\n     *\n     *  const doc = new Loro();\n     *  const tree = doc.getTree(\"tree\");\n     *  ```\n     */\n    getTree<Key extends (keyof T) | ContainerID>(\n      name: Key,\n    ): T[Key] extends LoroTree ? T[Key] : LoroTree;\n    getText(key: string | ContainerID): LoroText;\n  }\n\n  interface LoroList<T = unknown> {\n    new (): LoroList<T>;\n    /**\n     *  Get elements of the list. If the value is a child container, the corresponding\n     *  `Container` will be returned.\n     *\n     *  @example\n     *  ```ts\n     *  import { Loro } from \"loro-crdt\";\n     *\n     *  const doc = new Loro();\n     *  const list = doc.getList(\"list\");\n     *  list.insert(0, 100);\n     *  list.insert(1, \"foo\");\n     *  list.insert(2, true);\n     *  list.insertContainer(3, new LoroText());\n     *  console.log(list.value);  // [100, \"foo\", true, LoroText];\n     *  ```\n     */\n    toArray(): T[];\n    /**\n     * Insert a container at the index.\n     *\n     *  @example\n     *  ```ts\n     *  import { Loro } from \"loro-crdt\";\n     *\n     *  const doc = new Loro();\n     *  const list = doc.getList(\"list\");\n     *  list.insert(0, 100);\n     *  const text = list.insertContainer(1, new LoroText());\n     *  text.insert(0, \"Hello\");\n     *  console.log(list.getDeepValue());  // [100, \"Hello\"];\n     *  ```\n     */\n    insertContainer<C extends Container>(\n      pos: number,\n      child: C,\n    ): T extends C ? T : C;\n    /**\n     * Get the value at the index. If the value is a container, the corresponding handler will be returned.\n     *\n     *  @example\n     *  ```ts\n     *  import { Loro } from \"loro-crdt\";\n     *\n     *  const doc = new Loro();\n     *  const list = doc.getList(\"list\");\n     *  list.insert(0, 100);\n     *  console.log(list.get(0));  // 100\n     *  console.log(list.get(1));  // undefined\n     *  ```\n     */\n    get(index: number): T;\n    /**\n     *  Insert a value at index.\n     *\n     *  @example\n     *  ```ts\n     *  import { Loro } from \"loro-crdt\";\n     *\n     *  const doc = new Loro();\n     *  const list = doc.getList(\"list\");\n     *  list.insert(0, 100);\n     *  list.insert(1, \"foo\");\n     *  list.insert(2, true);\n     *  console.log(list.value);  // [100, \"foo\", true];\n     *  ```\n     */\n    insert(pos: number, value: Exclude<T, Container>): void;\n    delete(pos: number, len: number): void;\n    subscribe(txn: Loro, listener: Listener): number;\n    getAttached(): undefined | LoroList<T>;\n  }\n\n  interface LoroMap<\n    T extends Record<string, unknown> = Record<string, unknown>,\n  > {\n    new (): LoroMap<T>;\n    /**\n     *  Get the value of the key. If the value is a child container, the corresponding\n     *  `Container` will be returned.\n     *\n     *  The object returned is a new js object each time because it need to cross\n     *\n     *  @example\n     *  ```ts\n     *  import { Loro } from \"loro-crdt\";\n     *\n     *  const doc = new Loro();\n     *  const map = doc.getMap(\"map\");\n     *  map.set(\"foo\", \"bar\");\n     *  const bar = map.get(\"foo\");\n     *  ```\n     */\n    getOrCreateContainer<C extends Container>(key: string, child: C): C;\n    /**\n     * Set the key with a container.\n     *\n     *  @example\n     *  ```ts\n     *  import { Loro } from \"loro-crdt\";\n     *\n     *  const doc = new Loro();\n     *  const map = doc.getMap(\"map\");\n     *  map.set(\"foo\", \"bar\");\n     *  const text = map.setContainer(\"text\", new LoroText());\n     *  const list = map.setContainer(\"list\", new LoroText());\n     *  ```\n     */\n    setContainer<C extends Container, Key extends keyof T>(\n      key: Key,\n      child: C,\n    ): NonNullableType<T[Key]> extends C ? NonNullableType<T[Key]> : C;\n    /**\n     *  Get the value of the key. If the value is a child container, the corresponding\n     *  `Container` will be returned.\n     *\n     *  The object/value returned is a new js object/value each time because it need to cross\n     *  the WASM boundary.\n     *\n     *  @example\n     *  ```ts\n     *  import { Loro } from \"loro-crdt\";\n     *\n     *  const doc = new Loro();\n     *  const map = doc.getMap(\"map\");\n     *  map.set(\"foo\", \"bar\");\n     *  const bar = map.get(\"foo\");\n     *  ```\n     */\n    get<Key extends keyof T>(key: Key): T[Key];\n    /**\n     * Set the key with the value.\n     *\n     *  If the value of the key is exist, the old value will be updated.\n     *\n     *  @example\n     *  ```ts\n     *  import { Loro } from \"loro-crdt\";\n     *\n     *  const doc = new Loro();\n     *  const map = doc.getMap(\"map\");\n     *  map.set(\"foo\", \"bar\");\n     *  map.set(\"foo\", \"baz\");\n     *  ```\n     */\n    set<Key extends keyof T>(key: Key, value: Exclude<T[Key], Container>): void;\n    delete(key: string): void;\n    subscribe(txn: Loro, listener: Listener): number;\n  }\n\n  interface LoroText {\n    new (): 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    T extends Record<string, unknown> = Record<string, unknown>,\n  > {\n    new (): LoroTree<T>;\n    createNode(parent: TreeID | undefined): LoroTreeNode<T>;\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    T extends Record<string, unknown> = Record<string, unknown>,\n  > {\n    /**\n     * Get the associated metadata map container of a tree node.\n     */\n    readonly data: LoroMap<T>;\n    createNode(): LoroTreeNode<T>;\n    setAsRoot(): void;\n    moveTo(parent: LoroTreeNode<T>): void;\n    parent(): LoroTreeNode<T> | undefined;\n    children(): Array<LoroTreeNode<T>>;\n  }\n\n  interface AwarenessWasm<\n    T extends Value = Value,\n  > {\n    getState(peer: PeerID): T | undefined;\n    getTimestamp(peer: PeerID): number | undefined;\n    getAllStates(): Record<PeerID, T>;\n    setLocalState(value: T): void;\n    removeOutdated(): PeerID[];\n  }\n}\n\ntype NonNullableType<T> = Exclude<T, null | undefined>;\n"],"names":["AwarenessWasm"],"mappings":"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"}
+{"version":3,"file":"loro.js","sources":["../src/awareness.ts","../src/index.ts"],"sourcesContent":["import { AwarenessWasm, PeerID, Value } from \"loro-wasm\";\n\nexport type AwarenessListener = (\n  arg: { updated: PeerID[]; added: PeerID[]; removed: PeerID[] },\n  origin: \"local\" | \"timeout\" | \"remote\" | string,\n) => void;\n\n/**\n * Awareness is a structure that allows to track the ephemeral state of the peers.\n *\n * If we don't receive a state update from a peer within the timeout, we will remove their state.\n * The timeout is in milliseconds. This can be used to handle the off-line state of a peer.\n */\nexport class Awareness<T extends Value = Value> {\n  inner: AwarenessWasm<T>;\n  private peer: PeerID;\n  private timer: number | undefined;\n  private timeout: number;\n  private listeners: Set<AwarenessListener> = new Set();\n  constructor(peer: PeerID, timeout: number = 30000) {\n    this.inner = new AwarenessWasm(peer, timeout);\n    this.peer = peer;\n    this.timeout = timeout;\n  }\n\n  apply(bytes: Uint8Array, origin = \"remote\") {\n    const { updated, added } = this.inner.apply(bytes);\n    this.listeners.forEach((listener) => {\n      listener({ updated, added, removed: [] }, origin);\n    });\n\n    this.startTimerIfNotEmpty();\n  }\n\n  setLocalState(state: T) {\n    const wasEmpty = this.inner.getState(this.peer) == null;\n    this.inner.setLocalState(state);\n    if (wasEmpty) {\n      this.listeners.forEach((listener) => {\n        listener(\n          { updated: [], added: [this.inner.peer()], removed: [] },\n          \"local\",\n        );\n      });\n    } else {\n      this.listeners.forEach((listener) => {\n        listener(\n          { updated: [this.inner.peer()], added: [], removed: [] },\n          \"local\",\n        );\n      });\n    }\n\n    this.startTimerIfNotEmpty();\n  }\n\n  getLocalState(): T | undefined {\n    return this.inner.getState(this.peer);\n  }\n\n  getAllStates(): Record<PeerID, T> {\n    return this.inner.getAllStates();\n  }\n\n  encode(peers: PeerID[]): Uint8Array {\n    return this.inner.encode(peers);\n  }\n\n  encodeAll(): Uint8Array {\n    return this.inner.encodeAll();\n  }\n\n  addListener(listener: AwarenessListener) {\n    this.listeners.add(listener);\n  }\n\n  removeListener(listener: AwarenessListener) {\n    this.listeners.delete(listener);\n  }\n\n  peers(): PeerID[] {\n    return this.inner.peers();\n  }\n\n  destroy() {\n    clearInterval(this.timer);\n    this.listeners.clear();\n  }\n\n  private startTimerIfNotEmpty() {\n    if (this.inner.isEmpty() || this.timer != null) {\n      return;\n    }\n\n    this.timer = setInterval(() => {\n      const removed = this.inner.removeOutdated();\n      if (removed.length > 0) {\n        this.listeners.forEach((listener) => {\n          listener({ updated: [], added: [], removed }, \"timeout\");\n        });\n      }\n      if (this.inner.isEmpty()) {\n        clearInterval(this.timer);\n        this.timer = undefined;\n      }\n    }, this.timeout / 2) as unknown as number;\n  }\n}\n","export * from \"loro-wasm\";\nimport {\n  Container,\n  ContainerID,\n  Delta,\n  Loro,\n  LoroList,\n  LoroMap,\n  LoroText,\n  LoroTree,\n  OpId,\n  TreeID,\n  Value,\n} from \"loro-wasm\";\nexport { Awareness } from \"./awareness\";\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 by - How the event is triggered.\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  /**\n   * How the event is triggered.\n   *\n   * - `local`: The event is triggered by a local transaction.\n   * - `import`: The event is triggered by an import operation.\n   * - `checkout`: The event is triggered by a checkout operation.\n   */\n  by: \"local\" | \"import\" | \"checkout\";\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 =\n  | { 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 ? \"Text\"\n  : T extends LoroMap<any> ? \"Map\"\n  : T extends LoroTree<any> ? \"Tree\"\n  : T extends LoroList<any> ? \"List\"\n  : \"Json\" {\n  if (isContainer(value)) {\n    return value.kind() as unknown as any;\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<\n    T extends Record<string, Container> = Record<string, Container>,\n  > {\n    /**\n     * Get a LoroMap by container id\n     *\n     * The object returned is a new js object each time because it need to cross\n     * the WASM boundary.\n     *\n     * @example\n     * ```ts\n     * import { Loro } from \"loro-crdt\";\n     *\n     * const doc = new Loro();\n     * const map = doc.getMap(\"map\");\n     * ```\n     */\n    getMap<Key extends (keyof T) | ContainerID>(\n      name: Key,\n    ): T[Key] extends LoroMap ? T[Key] : LoroMap;\n    /**\n     * Get a LoroList by container id\n     *\n     * The object returned is a new js object each time because it need to cross\n     * the WASM boundary.\n     *\n     * @example\n     * ```ts\n     * import { Loro } from \"loro-crdt\";\n     *\n     * const doc = new Loro();\n     * const list = doc.getList(\"list\");\n     * ```\n     */\n    getList<Key extends (keyof T) | ContainerID>(\n      name: Key,\n    ): T[Key] extends LoroList ? T[Key] : LoroList;\n    /**\n     * Get a LoroMovableList by container id\n     *\n     * The object returned is a new js object each time because it need to cross\n     * the WASM boundary.\n     *\n     * @example\n     * ```ts\n     * import { Loro } from \"loro-crdt\";\n     *\n     * const doc = new Loro();\n     * const list = doc.getList(\"list\");\n     * ```\n     */\n    getMovableList<Key extends (keyof T) | ContainerID>(\n      name: Key,\n    ): T[Key] extends LoroMovableList ? T[Key] : LoroMovableList;\n    /**\n     * Get a LoroTree by container id\n     *\n     *  The object returned is a new js object each time because it need to cross\n     *  the WASM boundary.\n     *\n     *  @example\n     *  ```ts\n     *  import { Loro } from \"loro-crdt\";\n     *\n     *  const doc = new Loro();\n     *  const tree = doc.getTree(\"tree\");\n     *  ```\n     */\n    getTree<Key extends (keyof T) | ContainerID>(\n      name: Key,\n    ): T[Key] extends LoroTree ? T[Key] : LoroTree;\n    getText(key: string | ContainerID): LoroText;\n  }\n\n  interface LoroList<T = unknown> {\n    new (): LoroList<T>;\n    /**\n     *  Get elements of the list. If the value is a child container, the corresponding\n     *  `Container` will be returned.\n     *\n     *  @example\n     *  ```ts\n     *  import { Loro } from \"loro-crdt\";\n     *\n     *  const doc = new Loro();\n     *  const list = doc.getList(\"list\");\n     *  list.insert(0, 100);\n     *  list.insert(1, \"foo\");\n     *  list.insert(2, true);\n     *  list.insertContainer(3, new LoroText());\n     *  console.log(list.value);  // [100, \"foo\", true, LoroText];\n     *  ```\n     */\n    toArray(): T[];\n    /**\n     * Insert a container at the index.\n     *\n     *  @example\n     *  ```ts\n     *  import { Loro, LoroText } from \"loro-crdt\";\n     *\n     *  const doc = new Loro();\n     *  const list = doc.getList(\"list\");\n     *  list.insert(0, 100);\n     *  const text = list.insertContainer(1, new LoroText());\n     *  text.insert(0, \"Hello\");\n     *  console.log(list.toJSON());  // [100, \"Hello\"];\n     *  ```\n     */\n    insertContainer<C extends Container>(\n      pos: number,\n      child: C,\n    ): T extends C ? T : C;\n    /**\n     * Get the value at the index. If the value is a container, the corresponding handler will be returned.\n     *\n     *  @example\n     *  ```ts\n     *  import { Loro } from \"loro-crdt\";\n     *\n     *  const doc = new Loro();\n     *  const list = doc.getList(\"list\");\n     *  list.insert(0, 100);\n     *  console.log(list.get(0));  // 100\n     *  console.log(list.get(1));  // undefined\n     *  ```\n     */\n    get(index: number): T;\n    /**\n     *  Insert a value at index.\n     *\n     *  @example\n     *  ```ts\n     *  import { Loro } from \"loro-crdt\";\n     *\n     *  const doc = new Loro();\n     *  const list = doc.getList(\"list\");\n     *  list.insert(0, 100);\n     *  list.insert(1, \"foo\");\n     *  list.insert(2, true);\n     *  console.log(list.value);  // [100, \"foo\", true];\n     *  ```\n     */\n    insert<V extends T>(pos: number, value: Exclude<V, Container>): void;\n    delete(pos: number, len: number): void;\n    push<V extends T>(value: Exclude<V, Container>): void;\n    subscribe(listener: Listener): number;\n    getAttached(): undefined | LoroList<T>;\n  }\n\n  interface LoroMovableList<T = unknown> {\n    new (): LoroMovableList<T>;\n    /**\n     *  Get elements of the list. If the value is a child container, the corresponding\n     *  `Container` will be returned.\n     *\n     *  @example\n     *  ```ts\n     *  import { Loro, LoroText } from \"loro-crdt\";\n     *\n     *  const doc = new Loro();\n     *  const list = doc.getMovableList(\"list\");\n     *  list.insert(0, 100);\n     *  list.insert(1, \"foo\");\n     *  list.insert(2, true);\n     *  list.insertContainer(3, new LoroText());\n     *  console.log(list.value);  // [100, \"foo\", true, LoroText];\n     *  ```\n     */\n    toArray(): T[];\n    /**\n     * Insert a container at the index.\n     *\n     *  @example\n     *  ```ts\n     *  import { Loro } from \"loro-crdt\";\n     *\n     *  const doc = new Loro();\n     *  const list = doc.getMovableList(\"list\");\n     *  list.insert(0, 100);\n     *  const text = list.insertContainer(1, new LoroText());\n     *  text.insert(0, \"Hello\");\n     *  console.log(list.toJSON());  // [100, \"Hello\"];\n     *  ```\n     */\n    insertContainer<C extends Container>(\n      pos: number,\n      child: C,\n    ): T extends C ? T : C;\n    /**\n     * Get the value at the index. If the value is a container, the corresponding handler will be returned.\n     *\n     *  @example\n     *  ```ts\n     *  import { Loro } from \"loro-crdt\";\n     *\n     *  const doc = new Loro();\n     *  const list = doc.getMoableList(\"list\");\n     *  list.insert(0, 100);\n     *  console.log(list.get(0));  // 100\n     *  console.log(list.get(1));  // undefined\n     *  ```\n     */\n    get(index: number): T;\n    /**\n     *  Insert a value at index.\n     *\n     *  @example\n     *  ```ts\n     *  import { Loro } from \"loro-crdt\";\n     *\n     *  const doc = new Loro();\n     *  const list = doc.getMovableList(\"list\");\n     *  list.insert(0, 100);\n     *  list.insert(1, \"foo\");\n     *  list.insert(2, true);\n     *  console.log(list.value);  // [100, \"foo\", true];\n     *  ```\n     */\n    insert<V extends T>(pos: number, value: Exclude<V, Container>): void;\n    delete(pos: number, len: number): void;\n    push<V extends T>(value: Exclude<V, Container>): void;\n    subscribe(listener: Listener): number;\n    getAttached(): undefined | LoroMovableList<T>;\n    /**\n     *  Set the value at the given position.\n     *\n     *  It's different from `delete` + `insert` that it will replace the value at the position.\n     *\n     *  For example, if you have a list `[1, 2, 3]`, and you call `set(1, 100)`, the list will be `[1, 100, 3]`.\n     *  If concurrently someone call `set(1, 200)`, the list will be `[1, 200, 3]` or `[1, 100, 3]`.\n     *\n     *  But if you use `delete` + `insert` to simulate the set operation, they may create redundant operations\n     *  and the final result will be `[1, 100, 200, 3]` or `[1, 200, 100, 3]`.\n     *\n     *  @example\n     *  ```ts\n     *  import { Loro } from \"loro-crdt\";\n     *\n     *  const doc = new Loro();\n     *  const list = doc.getList(\"list\");\n     *  list.insert(0, 100);\n     *  list.insert(1, \"foo\");\n     *  list.insert(2, true);\n     *  list.set(1, \"bar\");\n     *  console.log(list.value);  // [100, \"bar\", true];\n     *  ```\n     */\n    set<V extends T>(pos: number, value: Exclude<V, Container>): void;\n    /**\n     * Set a container at the index.\n     *\n     *  @example\n     *  ```ts\n     *  import { Loro } from \"loro-crdt\";\n     *\n     *  const doc = new Loro();\n     *  const list = doc.getMovableList(\"list\");\n     *  list.insert(0, 100);\n     *  const text = list.setContainer(0, new LoroText());\n     *  text.insert(0, \"Hello\");\n     *  console.log(list.toJSON());  // [\"Hello\"];\n     *  ```\n     */\n    setContainer<C extends Container>(\n      pos: number,\n      child: C,\n    ): T extends C ? T : C;\n  }\n\n  interface LoroMap<\n    T extends Record<string, unknown> = Record<string, unknown>,\n  > {\n    new (): LoroMap<T>;\n    /**\n     *  Get the value of the key. If the value is a child container, the corresponding\n     *  `Container` will be returned.\n     *\n     *  The object returned is a new js object each time because it need to cross\n     *\n     *  @example\n     *  ```ts\n     *  import { Loro } from \"loro-crdt\";\n     *\n     *  const doc = new Loro();\n     *  const map = doc.getMap(\"map\");\n     *  map.set(\"foo\", \"bar\");\n     *  const bar = map.get(\"foo\");\n     *  ```\n     */\n    getOrCreateContainer<C extends Container>(key: string, child: C): C;\n    /**\n     * Set the key with a container.\n     *\n     *  @example\n     *  ```ts\n     *  import { Loro } from \"loro-crdt\";\n     *\n     *  const doc = new Loro();\n     *  const map = doc.getMap(\"map\");\n     *  map.set(\"foo\", \"bar\");\n     *  const text = map.setContainer(\"text\", new LoroText());\n     *  const list = map.setContainer(\"list\", new LoroText());\n     *  ```\n     */\n    setContainer<C extends Container, Key extends keyof T>(\n      key: Key,\n      child: C,\n    ): NonNullableType<T[Key]> extends C ? NonNullableType<T[Key]> : C;\n    /**\n     *  Get the value of the key. If the value is a child container, the corresponding\n     *  `Container` will be returned.\n     *\n     *  The object/value returned is a new js object/value each time because it need to cross\n     *  the WASM boundary.\n     *\n     *  @example\n     *  ```ts\n     *  import { Loro } from \"loro-crdt\";\n     *\n     *  const doc = new Loro();\n     *  const map = doc.getMap(\"map\");\n     *  map.set(\"foo\", \"bar\");\n     *  const bar = map.get(\"foo\");\n     *  ```\n     */\n    get<Key extends keyof T>(key: Key): T[Key];\n    /**\n     * Set the key with the value.\n     *\n     *  If the value of the key is exist, the old value will be updated.\n     *\n     *  @example\n     *  ```ts\n     *  import { Loro } from \"loro-crdt\";\n     *\n     *  const doc = new Loro();\n     *  const map = doc.getMap(\"map\");\n     *  map.set(\"foo\", \"bar\");\n     *  map.set(\"foo\", \"baz\");\n     *  ```\n     */\n    set<Key extends keyof T, V extends T[Key]>(\n      key: Key,\n      value: Exclude<V, Container>,\n    ): void;\n    delete(key: string): void;\n    subscribe(listener: Listener): number;\n  }\n\n  interface LoroText {\n    new (): LoroText;\n    insert(pos: number, text: string): void;\n    delete(pos: number, len: number): void;\n    subscribe(listener: Listener): number;\n  }\n\n  interface LoroTree<\n    T extends Record<string, unknown> = Record<string, unknown>,\n  > {\n    new (): LoroTree<T>;\n    createNode(parent: TreeID | undefined): LoroTreeNode<T>;\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(listener: Listener): number;\n  }\n\n  interface LoroTreeNode<\n    T extends Record<string, unknown> = Record<string, unknown>,\n  > {\n    /**\n     * Get the associated metadata map container of a tree node.\n     */\n    readonly data: LoroMap<T>;\n    createNode(): LoroTreeNode<T>;\n    setAsRoot(): void;\n    moveTo(parent: LoroTreeNode<T>): void;\n    parent(): LoroTreeNode<T> | undefined;\n    children(): Array<LoroTreeNode<T>>;\n  }\n\n  interface AwarenessWasm<\n    T extends Value = Value,\n  > {\n    getState(peer: PeerID): T | undefined;\n    getTimestamp(peer: PeerID): number | undefined;\n    getAllStates(): Record<PeerID, T>;\n    setLocalState(value: T): void;\n    removeOutdated(): PeerID[];\n  }\n}\n\ntype NonNullableType<T> = Exclude<T, null | undefined>;\n"],"names":["AwarenessWasm"],"mappings":"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"}

package/dist/loro.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"loro.mjs","sources":["../src/awareness.ts","../src/index.ts"],"sourcesContent":["import { AwarenessWasm, PeerID, Value } from \"loro-wasm\";\n\nexport type AwarenessListener = (\n  arg: { updated: PeerID[]; added: PeerID[]; removed: PeerID[] },\n  origin: \"local\" | \"timeout\" | \"remote\" | string,\n) => void;\n\n/**\n * Awareness is a structure that allows to track the ephemeral state of the peers.\n *\n * If we don't receive a state update from a peer within the timeout, we will remove their state.\n * The timeout is in milliseconds. This can be used to handle the off-line state of a peer.\n */\nexport class Awareness<T extends Value = Value> {\n  inner: AwarenessWasm<T>;\n  private peer: PeerID;\n  private timer: number | undefined;\n  private timeout: number;\n  private listeners: Set<AwarenessListener> = new Set();\n  constructor(peer: PeerID, timeout: number = 30000) {\n    this.inner = new AwarenessWasm(peer, timeout);\n    this.peer = peer;\n    this.timeout = timeout;\n  }\n\n  apply(bytes: Uint8Array, origin = \"remote\") {\n    const { updated, added } = this.inner.apply(bytes);\n    this.listeners.forEach((listener) => {\n      listener({ updated, added, removed: [] }, origin);\n    });\n\n    this.startTimerIfNotEmpty();\n  }\n\n  setLocalState(state: T) {\n    const wasEmpty = this.inner.getState(this.peer) == null;\n    this.inner.setLocalState(state);\n    if (wasEmpty) {\n      this.listeners.forEach((listener) => {\n        listener(\n          { updated: [], added: [this.inner.peer()], removed: [] },\n          \"local\",\n        );\n      });\n    } else {\n      this.listeners.forEach((listener) => {\n        listener(\n          { updated: [this.inner.peer()], added: [], removed: [] },\n          \"local\",\n        );\n      });\n    }\n\n    this.startTimerIfNotEmpty();\n  }\n\n  getLocalState(): T | undefined {\n    return this.inner.getState(this.peer);\n  }\n\n  getAllStates(): Record<PeerID, T> {\n    return this.inner.getAllStates();\n  }\n\n  encode(peers: PeerID[]): Uint8Array {\n    return this.inner.encode(peers);\n  }\n\n  encodeAll(): Uint8Array {\n    return this.inner.encodeAll();\n  }\n\n  addListener(listener: AwarenessListener) {\n    this.listeners.add(listener);\n  }\n\n  removeListener(listener: AwarenessListener) {\n    this.listeners.delete(listener);\n  }\n\n  peers(): PeerID[] {\n    return this.inner.peers();\n  }\n\n  destroy() {\n    clearInterval(this.timer);\n    this.listeners.clear();\n  }\n\n  private startTimerIfNotEmpty() {\n    if (this.inner.isEmpty() || this.timer != null) {\n      return;\n    }\n\n    this.timer = setInterval(() => {\n      const removed = this.inner.removeOutdated();\n      if (removed.length > 0) {\n        this.listeners.forEach((listener) => {\n          listener({ updated: [], added: [], removed }, \"timeout\");\n        });\n      }\n      if (this.inner.isEmpty()) {\n        clearInterval(this.timer);\n        this.timer = undefined;\n      }\n    }, this.timeout / 2) as unknown as number;\n  }\n}\n","export * from \"loro-wasm\";\nimport {\n  Container,\n  ContainerID,\n  Delta,\n  Loro,\n  LoroList,\n  LoroMap,\n  LoroText,\n  LoroTree,\n  OpId,\n  TreeID,\n  Value,\n} from \"loro-wasm\";\nexport { Awareness } from \"./awareness\";\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 by - How the event is triggered.\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  /**\n   * How the event is triggered.\n   *\n   * - `local`: The event is triggered by a local transaction.\n   * - `import`: The event is triggered by an import operation.\n   * - `checkout`: The event is triggered by a checkout operation.\n   */\n  by: \"local\" | \"import\" | \"checkout\";\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 =\n  | { 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 ? \"Text\"\n  : T extends LoroMap<any> ? \"Map\"\n  : T extends LoroTree<any> ? \"Tree\"\n  : T extends LoroList<any> ? \"List\"\n  : \"Json\" {\n  if (isContainer(value)) {\n    return value.kind() as unknown as any;\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<\n    T extends Record<string, Container> = Record<string, Container>,\n  > {\n    /**\n     * Get a LoroMap by container id\n     *\n     * The object returned is a new js object each time because it need to cross\n     * the WASM boundary.\n     *\n     * @example\n     * ```ts\n     * import { Loro } from \"loro-crdt\";\n     *\n     * const doc = new Loro();\n     * const map = doc.getMap(\"map\");\n     * ```\n     */\n    getMap<Key extends (keyof T) | ContainerID>(\n      name: Key,\n    ): T[Key] extends LoroMap ? T[Key] : LoroMap;\n    /**\n     * Get a LoroList by container id\n     *\n     * The object returned is a new js object each time because it need to cross\n     * the WASM boundary.\n     *\n     * @example\n     * ```ts\n     * import { Loro } from \"loro-crdt\";\n     *\n     * const doc = new Loro();\n     * const list = doc.getList(\"list\");\n     * ```\n     */\n    getList<Key extends (keyof T) | ContainerID>(\n      name: Key,\n    ): T[Key] extends LoroList ? T[Key] : LoroList;\n    /**\n     * Get a LoroTree by container id\n     *\n     *  The object returned is a new js object each time because it need to cross\n     *  the WASM boundary.\n     *\n     *  @example\n     *  ```ts\n     *  import { Loro } from \"loro-crdt\";\n     *\n     *  const doc = new Loro();\n     *  const tree = doc.getTree(\"tree\");\n     *  ```\n     */\n    getTree<Key extends (keyof T) | ContainerID>(\n      name: Key,\n    ): T[Key] extends LoroTree ? T[Key] : LoroTree;\n    getText(key: string | ContainerID): LoroText;\n  }\n\n  interface LoroList<T = unknown> {\n    new (): LoroList<T>;\n    /**\n     *  Get elements of the list. If the value is a child container, the corresponding\n     *  `Container` will be returned.\n     *\n     *  @example\n     *  ```ts\n     *  import { Loro } from \"loro-crdt\";\n     *\n     *  const doc = new Loro();\n     *  const list = doc.getList(\"list\");\n     *  list.insert(0, 100);\n     *  list.insert(1, \"foo\");\n     *  list.insert(2, true);\n     *  list.insertContainer(3, new LoroText());\n     *  console.log(list.value);  // [100, \"foo\", true, LoroText];\n     *  ```\n     */\n    toArray(): T[];\n    /**\n     * Insert a container at the index.\n     *\n     *  @example\n     *  ```ts\n     *  import { Loro } from \"loro-crdt\";\n     *\n     *  const doc = new Loro();\n     *  const list = doc.getList(\"list\");\n     *  list.insert(0, 100);\n     *  const text = list.insertContainer(1, new LoroText());\n     *  text.insert(0, \"Hello\");\n     *  console.log(list.getDeepValue());  // [100, \"Hello\"];\n     *  ```\n     */\n    insertContainer<C extends Container>(\n      pos: number,\n      child: C,\n    ): T extends C ? T : C;\n    /**\n     * Get the value at the index. If the value is a container, the corresponding handler will be returned.\n     *\n     *  @example\n     *  ```ts\n     *  import { Loro } from \"loro-crdt\";\n     *\n     *  const doc = new Loro();\n     *  const list = doc.getList(\"list\");\n     *  list.insert(0, 100);\n     *  console.log(list.get(0));  // 100\n     *  console.log(list.get(1));  // undefined\n     *  ```\n     */\n    get(index: number): T;\n    /**\n     *  Insert a value at index.\n     *\n     *  @example\n     *  ```ts\n     *  import { Loro } from \"loro-crdt\";\n     *\n     *  const doc = new Loro();\n     *  const list = doc.getList(\"list\");\n     *  list.insert(0, 100);\n     *  list.insert(1, \"foo\");\n     *  list.insert(2, true);\n     *  console.log(list.value);  // [100, \"foo\", true];\n     *  ```\n     */\n    insert(pos: number, value: Exclude<T, Container>): void;\n    delete(pos: number, len: number): void;\n    subscribe(txn: Loro, listener: Listener): number;\n    getAttached(): undefined | LoroList<T>;\n  }\n\n  interface LoroMap<\n    T extends Record<string, unknown> = Record<string, unknown>,\n  > {\n    new (): LoroMap<T>;\n    /**\n     *  Get the value of the key. If the value is a child container, the corresponding\n     *  `Container` will be returned.\n     *\n     *  The object returned is a new js object each time because it need to cross\n     *\n     *  @example\n     *  ```ts\n     *  import { Loro } from \"loro-crdt\";\n     *\n     *  const doc = new Loro();\n     *  const map = doc.getMap(\"map\");\n     *  map.set(\"foo\", \"bar\");\n     *  const bar = map.get(\"foo\");\n     *  ```\n     */\n    getOrCreateContainer<C extends Container>(key: string, child: C): C;\n    /**\n     * Set the key with a container.\n     *\n     *  @example\n     *  ```ts\n     *  import { Loro } from \"loro-crdt\";\n     *\n     *  const doc = new Loro();\n     *  const map = doc.getMap(\"map\");\n     *  map.set(\"foo\", \"bar\");\n     *  const text = map.setContainer(\"text\", new LoroText());\n     *  const list = map.setContainer(\"list\", new LoroText());\n     *  ```\n     */\n    setContainer<C extends Container, Key extends keyof T>(\n      key: Key,\n      child: C,\n    ): NonNullableType<T[Key]> extends C ? NonNullableType<T[Key]> : C;\n    /**\n     *  Get the value of the key. If the value is a child container, the corresponding\n     *  `Container` will be returned.\n     *\n     *  The object/value returned is a new js object/value each time because it need to cross\n     *  the WASM boundary.\n     *\n     *  @example\n     *  ```ts\n     *  import { Loro } from \"loro-crdt\";\n     *\n     *  const doc = new Loro();\n     *  const map = doc.getMap(\"map\");\n     *  map.set(\"foo\", \"bar\");\n     *  const bar = map.get(\"foo\");\n     *  ```\n     */\n    get<Key extends keyof T>(key: Key): T[Key];\n    /**\n     * Set the key with the value.\n     *\n     *  If the value of the key is exist, the old value will be updated.\n     *\n     *  @example\n     *  ```ts\n     *  import { Loro } from \"loro-crdt\";\n     *\n     *  const doc = new Loro();\n     *  const map = doc.getMap(\"map\");\n     *  map.set(\"foo\", \"bar\");\n     *  map.set(\"foo\", \"baz\");\n     *  ```\n     */\n    set<Key extends keyof T>(key: Key, value: Exclude<T[Key], Container>): void;\n    delete(key: string): void;\n    subscribe(txn: Loro, listener: Listener): number;\n  }\n\n  interface LoroText {\n    new (): 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    T extends Record<string, unknown> = Record<string, unknown>,\n  > {\n    new (): LoroTree<T>;\n    createNode(parent: TreeID | undefined): LoroTreeNode<T>;\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    T extends Record<string, unknown> = Record<string, unknown>,\n  > {\n    /**\n     * Get the associated metadata map container of a tree node.\n     */\n    readonly data: LoroMap<T>;\n    createNode(): LoroTreeNode<T>;\n    setAsRoot(): void;\n    moveTo(parent: LoroTreeNode<T>): void;\n    parent(): LoroTreeNode<T> | undefined;\n    children(): Array<LoroTreeNode<T>>;\n  }\n\n  interface AwarenessWasm<\n    T extends Value = Value,\n  > {\n    getState(peer: PeerID): T | undefined;\n    getTimestamp(peer: PeerID): number | undefined;\n    getAllStates(): Record<PeerID, T>;\n    setLocalState(value: T): void;\n    removeOutdated(): PeerID[];\n  }\n}\n\ntype NonNullableType<T> = Exclude<T, null | undefined>;\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"loro.mjs","sources":["../src/awareness.ts","../src/index.ts"],"sourcesContent":["import { AwarenessWasm, PeerID, Value } from \"loro-wasm\";\n\nexport type AwarenessListener = (\n  arg: { updated: PeerID[]; added: PeerID[]; removed: PeerID[] },\n  origin: \"local\" | \"timeout\" | \"remote\" | string,\n) => void;\n\n/**\n * Awareness is a structure that allows to track the ephemeral state of the peers.\n *\n * If we don't receive a state update from a peer within the timeout, we will remove their state.\n * The timeout is in milliseconds. This can be used to handle the off-line state of a peer.\n */\nexport class Awareness<T extends Value = Value> {\n  inner: AwarenessWasm<T>;\n  private peer: PeerID;\n  private timer: number | undefined;\n  private timeout: number;\n  private listeners: Set<AwarenessListener> = new Set();\n  constructor(peer: PeerID, timeout: number = 30000) {\n    this.inner = new AwarenessWasm(peer, timeout);\n    this.peer = peer;\n    this.timeout = timeout;\n  }\n\n  apply(bytes: Uint8Array, origin = \"remote\") {\n    const { updated, added } = this.inner.apply(bytes);\n    this.listeners.forEach((listener) => {\n      listener({ updated, added, removed: [] }, origin);\n    });\n\n    this.startTimerIfNotEmpty();\n  }\n\n  setLocalState(state: T) {\n    const wasEmpty = this.inner.getState(this.peer) == null;\n    this.inner.setLocalState(state);\n    if (wasEmpty) {\n      this.listeners.forEach((listener) => {\n        listener(\n          { updated: [], added: [this.inner.peer()], removed: [] },\n          \"local\",\n        );\n      });\n    } else {\n      this.listeners.forEach((listener) => {\n        listener(\n          { updated: [this.inner.peer()], added: [], removed: [] },\n          \"local\",\n        );\n      });\n    }\n\n    this.startTimerIfNotEmpty();\n  }\n\n  getLocalState(): T | undefined {\n    return this.inner.getState(this.peer);\n  }\n\n  getAllStates(): Record<PeerID, T> {\n    return this.inner.getAllStates();\n  }\n\n  encode(peers: PeerID[]): Uint8Array {\n    return this.inner.encode(peers);\n  }\n\n  encodeAll(): Uint8Array {\n    return this.inner.encodeAll();\n  }\n\n  addListener(listener: AwarenessListener) {\n    this.listeners.add(listener);\n  }\n\n  removeListener(listener: AwarenessListener) {\n    this.listeners.delete(listener);\n  }\n\n  peers(): PeerID[] {\n    return this.inner.peers();\n  }\n\n  destroy() {\n    clearInterval(this.timer);\n    this.listeners.clear();\n  }\n\n  private startTimerIfNotEmpty() {\n    if (this.inner.isEmpty() || this.timer != null) {\n      return;\n    }\n\n    this.timer = setInterval(() => {\n      const removed = this.inner.removeOutdated();\n      if (removed.length > 0) {\n        this.listeners.forEach((listener) => {\n          listener({ updated: [], added: [], removed }, \"timeout\");\n        });\n      }\n      if (this.inner.isEmpty()) {\n        clearInterval(this.timer);\n        this.timer = undefined;\n      }\n    }, this.timeout / 2) as unknown as number;\n  }\n}\n","export * from \"loro-wasm\";\nimport {\n  Container,\n  ContainerID,\n  Delta,\n  Loro,\n  LoroList,\n  LoroMap,\n  LoroText,\n  LoroTree,\n  OpId,\n  TreeID,\n  Value,\n} from \"loro-wasm\";\nexport { Awareness } from \"./awareness\";\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 by - How the event is triggered.\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  /**\n   * How the event is triggered.\n   *\n   * - `local`: The event is triggered by a local transaction.\n   * - `import`: The event is triggered by an import operation.\n   * - `checkout`: The event is triggered by a checkout operation.\n   */\n  by: \"local\" | \"import\" | \"checkout\";\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 =\n  | { 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 ? \"Text\"\n  : T extends LoroMap<any> ? \"Map\"\n  : T extends LoroTree<any> ? \"Tree\"\n  : T extends LoroList<any> ? \"List\"\n  : \"Json\" {\n  if (isContainer(value)) {\n    return value.kind() as unknown as any;\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<\n    T extends Record<string, Container> = Record<string, Container>,\n  > {\n    /**\n     * Get a LoroMap by container id\n     *\n     * The object returned is a new js object each time because it need to cross\n     * the WASM boundary.\n     *\n     * @example\n     * ```ts\n     * import { Loro } from \"loro-crdt\";\n     *\n     * const doc = new Loro();\n     * const map = doc.getMap(\"map\");\n     * ```\n     */\n    getMap<Key extends (keyof T) | ContainerID>(\n      name: Key,\n    ): T[Key] extends LoroMap ? T[Key] : LoroMap;\n    /**\n     * Get a LoroList by container id\n     *\n     * The object returned is a new js object each time because it need to cross\n     * the WASM boundary.\n     *\n     * @example\n     * ```ts\n     * import { Loro } from \"loro-crdt\";\n     *\n     * const doc = new Loro();\n     * const list = doc.getList(\"list\");\n     * ```\n     */\n    getList<Key extends (keyof T) | ContainerID>(\n      name: Key,\n    ): T[Key] extends LoroList ? T[Key] : LoroList;\n    /**\n     * Get a LoroMovableList by container id\n     *\n     * The object returned is a new js object each time because it need to cross\n     * the WASM boundary.\n     *\n     * @example\n     * ```ts\n     * import { Loro } from \"loro-crdt\";\n     *\n     * const doc = new Loro();\n     * const list = doc.getList(\"list\");\n     * ```\n     */\n    getMovableList<Key extends (keyof T) | ContainerID>(\n      name: Key,\n    ): T[Key] extends LoroMovableList ? T[Key] : LoroMovableList;\n    /**\n     * Get a LoroTree by container id\n     *\n     *  The object returned is a new js object each time because it need to cross\n     *  the WASM boundary.\n     *\n     *  @example\n     *  ```ts\n     *  import { Loro } from \"loro-crdt\";\n     *\n     *  const doc = new Loro();\n     *  const tree = doc.getTree(\"tree\");\n     *  ```\n     */\n    getTree<Key extends (keyof T) | ContainerID>(\n      name: Key,\n    ): T[Key] extends LoroTree ? T[Key] : LoroTree;\n    getText(key: string | ContainerID): LoroText;\n  }\n\n  interface LoroList<T = unknown> {\n    new (): LoroList<T>;\n    /**\n     *  Get elements of the list. If the value is a child container, the corresponding\n     *  `Container` will be returned.\n     *\n     *  @example\n     *  ```ts\n     *  import { Loro } from \"loro-crdt\";\n     *\n     *  const doc = new Loro();\n     *  const list = doc.getList(\"list\");\n     *  list.insert(0, 100);\n     *  list.insert(1, \"foo\");\n     *  list.insert(2, true);\n     *  list.insertContainer(3, new LoroText());\n     *  console.log(list.value);  // [100, \"foo\", true, LoroText];\n     *  ```\n     */\n    toArray(): T[];\n    /**\n     * Insert a container at the index.\n     *\n     *  @example\n     *  ```ts\n     *  import { Loro, LoroText } from \"loro-crdt\";\n     *\n     *  const doc = new Loro();\n     *  const list = doc.getList(\"list\");\n     *  list.insert(0, 100);\n     *  const text = list.insertContainer(1, new LoroText());\n     *  text.insert(0, \"Hello\");\n     *  console.log(list.toJSON());  // [100, \"Hello\"];\n     *  ```\n     */\n    insertContainer<C extends Container>(\n      pos: number,\n      child: C,\n    ): T extends C ? T : C;\n    /**\n     * Get the value at the index. If the value is a container, the corresponding handler will be returned.\n     *\n     *  @example\n     *  ```ts\n     *  import { Loro } from \"loro-crdt\";\n     *\n     *  const doc = new Loro();\n     *  const list = doc.getList(\"list\");\n     *  list.insert(0, 100);\n     *  console.log(list.get(0));  // 100\n     *  console.log(list.get(1));  // undefined\n     *  ```\n     */\n    get(index: number): T;\n    /**\n     *  Insert a value at index.\n     *\n     *  @example\n     *  ```ts\n     *  import { Loro } from \"loro-crdt\";\n     *\n     *  const doc = new Loro();\n     *  const list = doc.getList(\"list\");\n     *  list.insert(0, 100);\n     *  list.insert(1, \"foo\");\n     *  list.insert(2, true);\n     *  console.log(list.value);  // [100, \"foo\", true];\n     *  ```\n     */\n    insert<V extends T>(pos: number, value: Exclude<V, Container>): void;\n    delete(pos: number, len: number): void;\n    push<V extends T>(value: Exclude<V, Container>): void;\n    subscribe(listener: Listener): number;\n    getAttached(): undefined | LoroList<T>;\n  }\n\n  interface LoroMovableList<T = unknown> {\n    new (): LoroMovableList<T>;\n    /**\n     *  Get elements of the list. If the value is a child container, the corresponding\n     *  `Container` will be returned.\n     *\n     *  @example\n     *  ```ts\n     *  import { Loro, LoroText } from \"loro-crdt\";\n     *\n     *  const doc = new Loro();\n     *  const list = doc.getMovableList(\"list\");\n     *  list.insert(0, 100);\n     *  list.insert(1, \"foo\");\n     *  list.insert(2, true);\n     *  list.insertContainer(3, new LoroText());\n     *  console.log(list.value);  // [100, \"foo\", true, LoroText];\n     *  ```\n     */\n    toArray(): T[];\n    /**\n     * Insert a container at the index.\n     *\n     *  @example\n     *  ```ts\n     *  import { Loro } from \"loro-crdt\";\n     *\n     *  const doc = new Loro();\n     *  const list = doc.getMovableList(\"list\");\n     *  list.insert(0, 100);\n     *  const text = list.insertContainer(1, new LoroText());\n     *  text.insert(0, \"Hello\");\n     *  console.log(list.toJSON());  // [100, \"Hello\"];\n     *  ```\n     */\n    insertContainer<C extends Container>(\n      pos: number,\n      child: C,\n    ): T extends C ? T : C;\n    /**\n     * Get the value at the index. If the value is a container, the corresponding handler will be returned.\n     *\n     *  @example\n     *  ```ts\n     *  import { Loro } from \"loro-crdt\";\n     *\n     *  const doc = new Loro();\n     *  const list = doc.getMoableList(\"list\");\n     *  list.insert(0, 100);\n     *  console.log(list.get(0));  // 100\n     *  console.log(list.get(1));  // undefined\n     *  ```\n     */\n    get(index: number): T;\n    /**\n     *  Insert a value at index.\n     *\n     *  @example\n     *  ```ts\n     *  import { Loro } from \"loro-crdt\";\n     *\n     *  const doc = new Loro();\n     *  const list = doc.getMovableList(\"list\");\n     *  list.insert(0, 100);\n     *  list.insert(1, \"foo\");\n     *  list.insert(2, true);\n     *  console.log(list.value);  // [100, \"foo\", true];\n     *  ```\n     */\n    insert<V extends T>(pos: number, value: Exclude<V, Container>): void;\n    delete(pos: number, len: number): void;\n    push<V extends T>(value: Exclude<V, Container>): void;\n    subscribe(listener: Listener): number;\n    getAttached(): undefined | LoroMovableList<T>;\n    /**\n     *  Set the value at the given position.\n     *\n     *  It's different from `delete` + `insert` that it will replace the value at the position.\n     *\n     *  For example, if you have a list `[1, 2, 3]`, and you call `set(1, 100)`, the list will be `[1, 100, 3]`.\n     *  If concurrently someone call `set(1, 200)`, the list will be `[1, 200, 3]` or `[1, 100, 3]`.\n     *\n     *  But if you use `delete` + `insert` to simulate the set operation, they may create redundant operations\n     *  and the final result will be `[1, 100, 200, 3]` or `[1, 200, 100, 3]`.\n     *\n     *  @example\n     *  ```ts\n     *  import { Loro } from \"loro-crdt\";\n     *\n     *  const doc = new Loro();\n     *  const list = doc.getList(\"list\");\n     *  list.insert(0, 100);\n     *  list.insert(1, \"foo\");\n     *  list.insert(2, true);\n     *  list.set(1, \"bar\");\n     *  console.log(list.value);  // [100, \"bar\", true];\n     *  ```\n     */\n    set<V extends T>(pos: number, value: Exclude<V, Container>): void;\n    /**\n     * Set a container at the index.\n     *\n     *  @example\n     *  ```ts\n     *  import { Loro } from \"loro-crdt\";\n     *\n     *  const doc = new Loro();\n     *  const list = doc.getMovableList(\"list\");\n     *  list.insert(0, 100);\n     *  const text = list.setContainer(0, new LoroText());\n     *  text.insert(0, \"Hello\");\n     *  console.log(list.toJSON());  // [\"Hello\"];\n     *  ```\n     */\n    setContainer<C extends Container>(\n      pos: number,\n      child: C,\n    ): T extends C ? T : C;\n  }\n\n  interface LoroMap<\n    T extends Record<string, unknown> = Record<string, unknown>,\n  > {\n    new (): LoroMap<T>;\n    /**\n     *  Get the value of the key. If the value is a child container, the corresponding\n     *  `Container` will be returned.\n     *\n     *  The object returned is a new js object each time because it need to cross\n     *\n     *  @example\n     *  ```ts\n     *  import { Loro } from \"loro-crdt\";\n     *\n     *  const doc = new Loro();\n     *  const map = doc.getMap(\"map\");\n     *  map.set(\"foo\", \"bar\");\n     *  const bar = map.get(\"foo\");\n     *  ```\n     */\n    getOrCreateContainer<C extends Container>(key: string, child: C): C;\n    /**\n     * Set the key with a container.\n     *\n     *  @example\n     *  ```ts\n     *  import { Loro } from \"loro-crdt\";\n     *\n     *  const doc = new Loro();\n     *  const map = doc.getMap(\"map\");\n     *  map.set(\"foo\", \"bar\");\n     *  const text = map.setContainer(\"text\", new LoroText());\n     *  const list = map.setContainer(\"list\", new LoroText());\n     *  ```\n     */\n    setContainer<C extends Container, Key extends keyof T>(\n      key: Key,\n      child: C,\n    ): NonNullableType<T[Key]> extends C ? NonNullableType<T[Key]> : C;\n    /**\n     *  Get the value of the key. If the value is a child container, the corresponding\n     *  `Container` will be returned.\n     *\n     *  The object/value returned is a new js object/value each time because it need to cross\n     *  the WASM boundary.\n     *\n     *  @example\n     *  ```ts\n     *  import { Loro } from \"loro-crdt\";\n     *\n     *  const doc = new Loro();\n     *  const map = doc.getMap(\"map\");\n     *  map.set(\"foo\", \"bar\");\n     *  const bar = map.get(\"foo\");\n     *  ```\n     */\n    get<Key extends keyof T>(key: Key): T[Key];\n    /**\n     * Set the key with the value.\n     *\n     *  If the value of the key is exist, the old value will be updated.\n     *\n     *  @example\n     *  ```ts\n     *  import { Loro } from \"loro-crdt\";\n     *\n     *  const doc = new Loro();\n     *  const map = doc.getMap(\"map\");\n     *  map.set(\"foo\", \"bar\");\n     *  map.set(\"foo\", \"baz\");\n     *  ```\n     */\n    set<Key extends keyof T, V extends T[Key]>(\n      key: Key,\n      value: Exclude<V, Container>,\n    ): void;\n    delete(key: string): void;\n    subscribe(listener: Listener): number;\n  }\n\n  interface LoroText {\n    new (): LoroText;\n    insert(pos: number, text: string): void;\n    delete(pos: number, len: number): void;\n    subscribe(listener: Listener): number;\n  }\n\n  interface LoroTree<\n    T extends Record<string, unknown> = Record<string, unknown>,\n  > {\n    new (): LoroTree<T>;\n    createNode(parent: TreeID | undefined): LoroTreeNode<T>;\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(listener: Listener): number;\n  }\n\n  interface LoroTreeNode<\n    T extends Record<string, unknown> = Record<string, unknown>,\n  > {\n    /**\n     * Get the associated metadata map container of a tree node.\n     */\n    readonly data: LoroMap<T>;\n    createNode(): LoroTreeNode<T>;\n    setAsRoot(): void;\n    moveTo(parent: LoroTreeNode<T>): void;\n    parent(): LoroTreeNode<T> | undefined;\n    children(): Array<LoroTreeNode<T>>;\n  }\n\n  interface AwarenessWasm<\n    T extends Value = Value,\n  > {\n    getState(peer: PeerID): T | undefined;\n    getTimestamp(peer: PeerID): number | undefined;\n    getAllStates(): Record<PeerID, T>;\n    setLocalState(value: T): void;\n    removeOutdated(): PeerID[];\n  }\n}\n\ntype NonNullableType<T> = Exclude<T, null | undefined>;\n"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "loro-crdt",
-  "version": "0.14.6",
+  "version": "0.15.1",
   "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.14.6"
+    "loro-wasm": "0.15.1"
   },
   "devDependencies": {
     "@rollup/plugin-node-resolve": "^15.0.1",

package/src/index.ts

@@ -207,6 +207,23 @@ declare module "loro-wasm" {
     getList<Key extends (keyof T) | ContainerID>(
       name: Key,
     ): T[Key] extends LoroList ? T[Key] : LoroList;
+    /**
+     * Get a LoroMovableList by container id
+     *
+     * The object returned is a new js object each time because it need to cross
+     * the WASM boundary.
+     *
+     * @example
+     * ```ts
+     * import { Loro } from "loro-crdt";
+     *
+     * const doc = new Loro();
+     * const list = doc.getList("list");
+     * ```
+     */
+    getMovableList<Key extends (keyof T) | ContainerID>(
+      name: Key,
+    ): T[Key] extends LoroMovableList ? T[Key] : LoroMovableList;
     /**
      * Get a LoroTree by container id
      *
@@ -252,14 +269,14 @@ declare module "loro-wasm" {
      *
      *  @example
      *  ```ts
-     *  import { Loro } from "loro-crdt";
+     *  import { Loro, LoroText } from "loro-crdt";
      *
      *  const doc = new Loro();
      *  const list = doc.getList("list");
      *  list.insert(0, 100);
      *  const text = list.insertContainer(1, new LoroText());
      *  text.insert(0, "Hello");
-     *  console.log(list.getDeepValue());  // [100, "Hello"];
+     *  console.log(list.toJSON());  // [100, "Hello"];
      *  ```
      */
     insertContainer<C extends Container>(
@@ -296,12 +313,133 @@ declare module "loro-wasm" {
      *  console.log(list.value);  // [100, "foo", true];
      *  ```
      */
-    insert(pos: number, value: Exclude<T, Container>): void;
+    insert<V extends T>(pos: number, value: Exclude<V, Container>): void;
     delete(pos: number, len: number): void;
-    subscribe(txn: Loro, listener: Listener): number;
+    push<V extends T>(value: Exclude<V, Container>): void;
+    subscribe(listener: Listener): number;
     getAttached(): undefined | LoroList<T>;
   }
 
+  interface LoroMovableList<T = unknown> {
+    new (): LoroMovableList<T>;
+    /**
+     *  Get elements of the list. If the value is a child container, the corresponding
+     *  `Container` will be returned.
+     *
+     *  @example
+     *  ```ts
+     *  import { Loro, LoroText } from "loro-crdt";
+     *
+     *  const doc = new Loro();
+     *  const list = doc.getMovableList("list");
+     *  list.insert(0, 100);
+     *  list.insert(1, "foo");
+     *  list.insert(2, true);
+     *  list.insertContainer(3, new LoroText());
+     *  console.log(list.value);  // [100, "foo", true, LoroText];
+     *  ```
+     */
+    toArray(): T[];
+    /**
+     * Insert a container at the index.
+     *
+     *  @example
+     *  ```ts
+     *  import { Loro } from "loro-crdt";
+     *
+     *  const doc = new Loro();
+     *  const list = doc.getMovableList("list");
+     *  list.insert(0, 100);
+     *  const text = list.insertContainer(1, new LoroText());
+     *  text.insert(0, "Hello");
+     *  console.log(list.toJSON());  // [100, "Hello"];
+     *  ```
+     */
+    insertContainer<C extends Container>(
+      pos: number,
+      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.
+     *
+     *  @example
+     *  ```ts
+     *  import { Loro } from "loro-crdt";
+     *
+     *  const doc = new Loro();
+     *  const list = doc.getMoableList("list");
+     *  list.insert(0, 100);
+     *  console.log(list.get(0));  // 100
+     *  console.log(list.get(1));  // undefined
+     *  ```
+     */
+    get(index: number): T;
+    /**
+     *  Insert a value at index.
+     *
+     *  @example
+     *  ```ts
+     *  import { Loro } from "loro-crdt";
+     *
+     *  const doc = new Loro();
+     *  const list = doc.getMovableList("list");
+     *  list.insert(0, 100);
+     *  list.insert(1, "foo");
+     *  list.insert(2, true);
+     *  console.log(list.value);  // [100, "foo", true];
+     *  ```
+     */
+    insert<V extends T>(pos: number, value: Exclude<V, Container>): void;
+    delete(pos: number, len: number): void;
+    push<V extends T>(value: Exclude<V, Container>): void;
+    subscribe(listener: Listener): number;
+    getAttached(): undefined | LoroMovableList<T>;
+    /**
+     *  Set the value at the given position.
+     *
+     *  It's different from `delete` + `insert` that it will replace the value at the position.
+     *
+     *  For example, if you have a list `[1, 2, 3]`, and you call `set(1, 100)`, the list will be `[1, 100, 3]`.
+     *  If concurrently someone call `set(1, 200)`, the list will be `[1, 200, 3]` or `[1, 100, 3]`.
+     *
+     *  But if you use `delete` + `insert` to simulate the set operation, they may create redundant operations
+     *  and the final result will be `[1, 100, 200, 3]` or `[1, 200, 100, 3]`.
+     *
+     *  @example
+     *  ```ts
+     *  import { Loro } from "loro-crdt";
+     *
+     *  const doc = new Loro();
+     *  const list = doc.getList("list");
+     *  list.insert(0, 100);
+     *  list.insert(1, "foo");
+     *  list.insert(2, true);
+     *  list.set(1, "bar");
+     *  console.log(list.value);  // [100, "bar", true];
+     *  ```
+     */
+    set<V extends T>(pos: number, value: Exclude<V, Container>): void;
+    /**
+     * Set a container at the index.
+     *
+     *  @example
+     *  ```ts
+     *  import { Loro } from "loro-crdt";
+     *
+     *  const doc = new Loro();
+     *  const list = doc.getMovableList("list");
+     *  list.insert(0, 100);
+     *  const text = list.setContainer(0, new LoroText());
+     *  text.insert(0, "Hello");
+     *  console.log(list.toJSON());  // ["Hello"];
+     *  ```
+     */
+    setContainer<C extends Container>(
+      pos: number,
+      child: C,
+    ): T extends C ? T : C;
+  }
+
   interface LoroMap<
     T extends Record<string, unknown> = Record<string, unknown>,
   > {
@@ -374,16 +512,19 @@ declare module "loro-wasm" {
      *  map.set("foo", "baz");
      *  ```
      */
-    set<Key extends keyof T>(key: Key, value: Exclude<T[Key], Container>): void;
+    set<Key extends keyof T, V extends T[Key]>(
+      key: Key,
+      value: Exclude<V, Container>,
+    ): void;
     delete(key: string): void;
-    subscribe(txn: Loro, listener: Listener): number;
+    subscribe(listener: Listener): number;
   }
 
   interface LoroText {
     new (): LoroText;
     insert(pos: number, text: string): void;
     delete(pos: number, len: number): void;
-    subscribe(txn: Loro, listener: Listener): number;
+    subscribe(listener: Listener): number;
   }
 
   interface LoroTree<
@@ -395,7 +536,7 @@ declare module "loro-wasm" {
     delete(target: TreeID): void;
     has(target: TreeID): boolean;
     getNodeByID(target: TreeID): LoroTreeNode;
-    subscribe(txn: Loro, listener: Listener): number;
+    subscribe(listener: Listener): number;
   }
 
   interface LoroTreeNode<