loro-crdt 0.3.0 → 0.4.0

package/README.md

@@ -0,0 +1,8 @@
+# loro-crdt
+
+Loro CRDTs is a high-performance CRDT framework.
+
+It makes your app state synchronized, collaborative and maintainable effortlessly.
+
+Learn more at https://loro.dev
+

package/dist/loro.d.ts

@@ -1,21 +1,44 @@
-import { ContainerID, PrelimList, PrelimMap, PrelimText } from 'loro-wasm';
-export { ContainerID, ContainerType, Loro, LoroList, LoroMap, LoroText, PrelimList, PrelimMap, PrelimText, Transaction, setPanicHook } from 'loro-wasm';
+import { ContainerID, PrelimList, PrelimMap, PrelimText, Delta, TreeID } from 'loro-wasm';
+export * from 'loro-wasm';
+export { Loro } from 'loro-wasm';
 
-type Value = ContainerID | string | number | null | {
+/**
+ * Data types supported by loro
+ */
+type Value = ContainerID | string | number | boolean | null | {
     [key: string]: Value;
-} | Value[];
+} | Uint8Array | Value[];
 type Prelim = PrelimList | PrelimMap | PrelimText;
+/**
+ * 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.
+ */
 type Path = (number | string)[];
-type Delta<T> = {
-    type: "insert";
-    value: T;
-} | {
-    type: "delete";
-    len: number;
-} | {
-    type: "retain";
-    len: number;
-};
+/**
+ * The event of Loro.
+ * @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 {
+    local: boolean;
+    origin?: string;
+    /**
+     * If true, this event was triggered by a child container.
+     */
+    fromChildren: boolean;
+    /**
+     * If true, this event was triggered by a checkout.
+     */
+    fromCheckout: boolean;
+    diff: Diff;
+    target: ContainerID;
+    path: Path;
+}
 type ListDiff = {
     type: "list";
     diff: Delta<Value[]>[];
@@ -26,23 +49,20 @@ type TextDiff = {
 };
 type MapDiff = {
     type: "map";
+    updated: Record<string, Value | undefined>;
+};
+type TreeDiff = {
+    type: "tree";
     diff: {
-        added: Record<string, Value>;
-        deleted: Record<string, Value>;
-        updated: Record<string, {
-            old: Value;
-            new: Value;
-        }>;
+        target: TreeID;
+        action: "create" | "delete";
+    } | {
+        target: TreeID;
+        action: "move";
+        parent: TreeID;
     };
 };
-type Diff = ListDiff | TextDiff | MapDiff;
-interface LoroEvent {
-    local: boolean;
-    origin?: string;
-    diff: Diff;
-    target: ContainerID;
-    path: Path;
-}
+type Diff = ListDiff | TextDiff | MapDiff | TreeDiff;
 interface Listener {
     (event: LoroEvent): void;
 }
@@ -51,47 +71,42 @@ declare function isContainerId(s: string): s is ContainerID;
 declare module "loro-wasm" {
     interface Loro {
         subscribe(listener: Listener): number;
-        transact(f: (tx: Transaction) => void, origin?: string): void;
     }
     interface Loro<T extends Record<string, any> = Record<string, any>> {
-        getTypedMap<Key extends (keyof T) & string>(name: Key): T[Key] extends LoroMap ? T[Key] : never;
-        getTypedList<Key extends (keyof T) & string>(name: Key): T[Key] extends LoroList ? T[Key] : never;
+        getTypedMap<Key extends keyof T & string>(name: Key): T[Key] extends LoroMap ? T[Key] : never;
+        getTypedList<Key extends keyof T & string>(name: Key): T[Key] extends LoroList ? T[Key] : never;
     }
     interface LoroList<T extends any[] = any[]> {
-        insertContainer(txn: Transaction | Loro, pos: number, container: "Map"): LoroMap;
-        insertContainer(txn: Transaction | Loro, pos: number, container: "List"): LoroList;
-        insertContainer(txn: Transaction | Loro, pos: number, container: "Text"): LoroText;
-        insertContainer(txn: Transaction | Loro, pos: number, container: string): never;
+        insertContainer(pos: number, container: "Map"): LoroMap;
+        insertContainer(pos: number, container: "List"): LoroList;
+        insertContainer(pos: number, container: "Text"): LoroText;
+        insertContainer(pos: number, container: "Tree"): LoroTree;
+        insertContainer(pos: number, container: string): never;
         get(index: number): Value;
-        getTyped<Key extends (keyof T) & number>(loro: Loro, index: Key): T[Key];
-        insertTyped<Key extends (keyof T) & number>(txn: Transaction | Loro, pos: Key, value: T[Key]): void;
-        insert(txn: Transaction | Loro, pos: number, value: Value | Prelim): void;
-        delete(txn: Transaction | Loro, pos: number, len: number): void;
-        subscribe(txn: Transaction | Loro, listener: Listener): number;
-        subscribeDeep(txn: Transaction | Loro, listener: Listener): number;
-        subscribeOnce(txn: Transaction | Loro, listener: Listener): number;
+        getTyped<Key extends keyof T & number>(loro: Loro, index: Key): T[Key];
+        insertTyped<Key extends keyof T & number>(pos: Key, value: T[Key]): void;
+        insert(pos: number, value: Value | Prelim): void;
+        delete(pos: number, len: number): void;
+        subscribe(txn: Loro, listener: Listener): number;
     }
     interface LoroMap<T extends Record<string, any> = Record<string, any>> {
-        insertContainer(txn: Transaction | Loro, key: string, container_type: "Map"): LoroMap;
-        insertContainer(txn: Transaction | Loro, key: string, container_type: "List"): LoroList;
-        insertContainer(txn: Transaction | Loro, key: string, container_type: "Text"): LoroText;
-        insertContainer(txn: Transaction | Loro, key: string, container_type: string): never;
+        setContainer(key: string, container_type: "Map"): LoroMap;
+        setContainer(key: string, container_type: "List"): LoroList;
+        setContainer(key: string, container_type: "Text"): LoroText;
+        setContainer(key: string, container_type: "Tree"): LoroTree;
+        setContainer(key: string, container_type: string): never;
         get(key: string): Value;
-        getTyped<Key extends (keyof T) & string>(txn: Loro, key: Key): T[Key];
-        set(txn: Transaction | Loro, key: string, value: Value | Prelim): void;
-        setTyped<Key extends (keyof T) & string>(txn: Transaction | Loro, key: Key, value: T[Key]): void;
-        delete(txn: Transaction | Loro, key: string): void;
-        subscribe(txn: Transaction | Loro, listener: Listener): number;
-        subscribeDeep(txn: Transaction | Loro, listener: Listener): number;
-        subscribeOnce(txn: Transaction | Loro, listener: Listener): number;
+        getTyped<Key extends keyof T & string>(txn: Loro, key: Key): T[Key];
+        set(key: string, value: Value | Prelim): void;
+        setTyped<Key extends keyof T & string>(key: Key, value: T[Key]): void;
+        delete(key: string): void;
+        subscribe(txn: Loro, listener: Listener): number;
     }
     interface LoroText {
-        insert(txn: Transaction | Loro, pos: number, text: string): void;
-        delete(txn: Transaction | Loro, pos: number, len: number): void;
-        subscribe(txn: Transaction | Loro, listener: Listener): number;
-        subscribeDeep(txn: Transaction | Loro, listener: Listener): number;
-        subscribeOnce(txn: Transaction | Loro, listener: Listener): number;
+        insert(pos: number, text: string): void;
+        delete(pos: number, len: number): void;
+        subscribe(txn: Loro, listener: Listener): number;
     }
 }
 
-export { Delta, Diff, ListDiff, LoroEvent, MapDiff, Path, Prelim, TextDiff, Value, isContainerId };
+export { Diff, ListDiff, LoroEvent, MapDiff, Path, Prelim, TextDiff, TreeDiff, Value, isContainerId };

package/dist/loro.js

@@ -2,18 +2,12 @@
 
 var loroWasm = require('loro-wasm');
 
-loroWasm.Loro.prototype.transact = function(cb, origin) {
-  this.__raw__transactionWithOrigin(origin, (txn) => {
-    try {
-      cb(txn);
-    } finally {
-      txn.commit();
-      txn.free();
-    }
-  });
+loroWasm.Loro.prototype.getTypedMap = function(...args) {
+  return this.getMap(...args);
+};
+loroWasm.Loro.prototype.getTypedList = function(...args) {
+  return this.getList(...args);
 };
-loroWasm.Loro.prototype.getTypedMap = loroWasm.Loro.prototype.getMap;
-loroWasm.Loro.prototype.getTypedList = loroWasm.Loro.prototype.getList;
 loroWasm.LoroList.prototype.getTyped = function(loro, index) {
   const value = this.get(index);
   if (typeof value === "string" && isContainerId(value)) {
@@ -22,7 +16,9 @@ loroWasm.LoroList.prototype.getTyped = function(loro, index) {
     return value;
   }
 };
-loroWasm.LoroList.prototype.insertTyped = loroWasm.LoroList.prototype.insert;
+loroWasm.LoroList.prototype.insertTyped = function(...args) {
+  return this.insert(...args);
+};
 loroWasm.LoroMap.prototype.getTyped = function(loro, key) {
   const value = this.get(key);
   if (typeof value === "string" && isContainerId(value)) {
@@ -31,107 +27,22 @@ loroWasm.LoroMap.prototype.getTyped = function(loro, key) {
     return value;
   }
 };
-loroWasm.LoroMap.prototype.setTyped = loroWasm.LoroMap.prototype.set;
-loroWasm.LoroText.prototype.insert = function(txn, pos, text) {
-  if (txn instanceof loroWasm.Loro) {
-    this.__loro_insert(txn, pos, text);
-  } else {
-    this.__txn_insert(txn, pos, text);
-  }
-};
-loroWasm.LoroText.prototype.delete = function(txn, pos, len) {
-  if (txn instanceof loroWasm.Loro) {
-    this.__loro_delete(txn, pos, len);
-  } else {
-    this.__txn_delete(txn, pos, len);
-  }
-};
-loroWasm.LoroList.prototype.insert = function(txn, pos, len) {
-  if (txn instanceof loroWasm.Loro) {
-    this.__loro_insert(txn, pos, len);
-  } else {
-    this.__txn_insert(txn, pos, len);
-  }
-};
-loroWasm.LoroList.prototype.delete = function(txn, pos, len) {
-  if (txn instanceof loroWasm.Loro) {
-    this.__loro_delete(txn, pos, len);
-  } else {
-    this.__txn_delete(txn, pos, len);
-  }
-};
-loroWasm.LoroMap.prototype.set = function(txn, key, value) {
-  if (txn instanceof loroWasm.Loro) {
-    this.__loro_insert(txn, key, value);
-  } else {
-    this.__txn_insert(txn, key, value);
-  }
-};
-loroWasm.LoroMap.prototype.delete = function(txn, key) {
-  if (txn instanceof loroWasm.Loro) {
-    this.__loro_delete(txn, key);
-  } else {
-    this.__txn_delete(txn, key);
-  }
+loroWasm.LoroMap.prototype.setTyped = function(...args) {
+  return this.set(...args);
 };
-const CONTAINER_TYPES = ["Map", "Text", "List"];
 function isContainerId(s) {
-  try {
-    if (s.startsWith("/")) {
-      const [_, type] = s.slice(1).split(":");
-      if (!CONTAINER_TYPES.includes(type)) {
-        return false;
-      }
-    } else {
-      const [id, type] = s.split(":");
-      if (!CONTAINER_TYPES.includes(type)) {
-        return false;
-      }
-      const [counter, client] = id.split("@");
-      Number.parseInt(counter);
-      Number.parseInt(client);
-    }
-    return true;
-  } catch (e) {
-    return false;
-  }
+  return s.startsWith("cid:");
 }
 
 Object.defineProperty(exports, 'Loro', {
   enumerable: true,
   get: function () { return loroWasm.Loro; }
 });
-Object.defineProperty(exports, 'LoroList', {
-  enumerable: true,
-  get: function () { return loroWasm.LoroList; }
-});
-Object.defineProperty(exports, 'LoroMap', {
-  enumerable: true,
-  get: function () { return loroWasm.LoroMap; }
-});
-Object.defineProperty(exports, 'LoroText', {
-  enumerable: true,
-  get: function () { return loroWasm.LoroText; }
-});
-Object.defineProperty(exports, 'PrelimList', {
-  enumerable: true,
-  get: function () { return loroWasm.PrelimList; }
-});
-Object.defineProperty(exports, 'PrelimMap', {
-  enumerable: true,
-  get: function () { return loroWasm.PrelimMap; }
-});
-Object.defineProperty(exports, 'PrelimText', {
-  enumerable: true,
-  get: function () { return loroWasm.PrelimText; }
-});
-Object.defineProperty(exports, 'Transaction', {
-  enumerable: true,
-  get: function () { return loroWasm.Transaction; }
-});
-Object.defineProperty(exports, 'setPanicHook', {
-  enumerable: true,
-  get: function () { return loroWasm.setPanicHook; }
-});
 exports.isContainerId = isContainerId;
+Object.keys(loroWasm).forEach(function (k) {
+  if (k !== 'default' && !exports.hasOwnProperty(k)) Object.defineProperty(exports, k, {
+    enumerable: true,
+    get: function () { return loroWasm[k]; }
+  });
+});
 //# sourceMappingURL=loro.js.map

package/dist/loro.js.map

@@ -1 +1 @@
-{"version":3,"file":"loro.js","sources":["../src/index.ts"],"sourcesContent":["export {\n  LoroList,\n  LoroMap,\n  LoroText,\n  PrelimList,\n  PrelimMap,\n  PrelimText,\n  setPanicHook,\n  Transaction,\n} from \"loro-wasm\";\nimport { PrelimMap } from \"loro-wasm\";\nimport { PrelimText } from \"loro-wasm\";\nimport { PrelimList } from \"loro-wasm\";\nimport {\n  ContainerID,\n  Loro,\n  LoroList,\n  LoroMap,\n  LoroText,\n  Transaction,\n} from \"loro-wasm\";\n\nexport type { ContainerID, ContainerType } from \"loro-wasm\";\n\nLoro.prototype.transact = function (cb, origin) {\n  this.__raw__transactionWithOrigin(origin, (txn: Transaction) => {\n    try {\n      cb(txn);\n    } finally {\n      txn.commit();\n      txn.free();\n    }\n  });\n};\n\nLoro.prototype.getTypedMap = Loro.prototype.getMap;\nLoro.prototype.getTypedList = Loro.prototype.getList;\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 = LoroList.prototype.insert;\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 = LoroMap.prototype.set;\n\nLoroText.prototype.insert = function (txn, pos, text) {\n  if (txn instanceof Loro) {\n    this.__loro_insert(txn, pos, text);\n  } else {\n    this.__txn_insert(txn, pos, text);\n  }\n};\n\nLoroText.prototype.delete = function (txn, pos, len) {\n  if (txn instanceof Loro) {\n    this.__loro_delete(txn, pos, len);\n  } else {\n    this.__txn_delete(txn, pos, len);\n  }\n};\n\nLoroList.prototype.insert = function (txn, pos, len) {\n  if (txn instanceof Loro) {\n    this.__loro_insert(txn, pos, len);\n  } else {\n    this.__txn_insert(txn, pos, len);\n  }\n};\n\nLoroList.prototype.delete = function (txn, pos, len) {\n  if (txn instanceof Loro) {\n    this.__loro_delete(txn, pos, len);\n  } else {\n    this.__txn_delete(txn, pos, len);\n  }\n};\n\nLoroMap.prototype.set = function (txn, key, value) {\n  if (txn instanceof Loro) {\n    this.__loro_insert(txn, key, value);\n  } else {\n    this.__txn_insert(txn, key, value);\n  }\n};\n\nLoroMap.prototype.delete = function (txn, key) {\n  if (txn instanceof Loro) {\n    this.__loro_delete(txn, key);\n  } else {\n    this.__txn_delete(txn, key);\n  }\n};\n\nexport type Value =\n  | ContainerID\n  | string\n  | number\n  | null\n  | { [key: string]: Value }\n  | Value[];\n\nexport type Prelim = PrelimList | PrelimMap | PrelimText;\n\nexport type Path = (number | string)[];\nexport type Delta<T> = {\n  type: \"insert\";\n  value: T;\n} | {\n  type: \"delete\";\n  len: number;\n} | {\n  type: \"retain\";\n  len: number;\n};\n\nexport type ListDiff = {\n  type: \"list\";\n  diff: Delta<Value[]>[];\n};\n\nexport type TextDiff = {\n  type: \"text\";\n  diff: Delta<string>[];\n};\n\nexport type MapDiff = {\n  type: \"map\";\n  diff: {\n    added: Record<string, Value>;\n    deleted: Record<string, Value>;\n    updated: Record<string, {\n      old: Value;\n      new: Value;\n    }>;\n  };\n};\n\nexport type Diff = ListDiff | TextDiff | MapDiff;\n\nexport interface LoroEvent {\n  local: boolean;\n  origin?: string;\n  diff: Diff;\n  target: ContainerID;\n  path: Path;\n}\n\ninterface Listener {\n  (event: LoroEvent): void;\n}\n\nconst CONTAINER_TYPES = [\"Map\", \"Text\", \"List\"];\n\nexport function isContainerId(s: string): s is ContainerID {\n  try {\n    if (s.startsWith(\"/\")) {\n      const [_, type] = s.slice(1).split(\":\");\n      if (!CONTAINER_TYPES.includes(type)) {\n        return false;\n      }\n    } else {\n      const [id, type] = s.split(\":\");\n      if (!CONTAINER_TYPES.includes(type)) {\n        return false;\n      }\n\n      const [counter, client] = id.split(\"@\");\n      Number.parseInt(counter);\n      Number.parseInt(client);\n    }\n\n    return true;\n  } catch (e) {\n    return false;\n  }\n}\n\nexport { Loro };\n\ndeclare module \"loro-wasm\" {\n  interface Loro {\n    subscribe(listener: Listener): number;\n    transact(f: (tx: Transaction) => void, origin?: string): void;\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(\n      txn: Transaction | Loro,\n      pos: number,\n      container: \"Map\",\n    ): LoroMap;\n    insertContainer(\n      txn: Transaction | Loro,\n      pos: number,\n      container: \"List\",\n    ): LoroList;\n    insertContainer(\n      txn: Transaction | Loro,\n      pos: number,\n      container: \"Text\",\n    ): LoroText;\n    insertContainer(\n      txn: Transaction | Loro,\n      pos: number,\n      container: string,\n    ): never;\n\n    get(index: number): Value;\n    getTyped<Key extends (keyof T) & number>(loro: Loro, index: Key): T[Key];\n    insertTyped<Key extends (keyof T) & number>(\n      txn: Transaction | Loro,\n      pos: Key,\n      value: T[Key],\n    ): void;\n    insert(txn: Transaction | Loro, pos: number, value: Value | Prelim): void;\n    delete(txn: Transaction | Loro, pos: number, len: number): void;\n    subscribe(txn: Transaction | Loro, listener: Listener): number;\n    subscribeDeep(txn: Transaction | Loro, listener: Listener): number;\n    subscribeOnce(txn: Transaction | Loro, listener: Listener): number;\n  }\n\n  interface LoroMap<T extends Record<string, any> = Record<string, any>> {\n    insertContainer(\n      txn: Transaction | Loro,\n      key: string,\n      container_type: \"Map\",\n    ): LoroMap;\n    insertContainer(\n      txn: Transaction | Loro,\n      key: string,\n      container_type: \"List\",\n    ): LoroList;\n    insertContainer(\n      txn: Transaction | Loro,\n      key: string,\n      container_type: \"Text\",\n    ): LoroText;\n    insertContainer(\n      txn: Transaction | Loro,\n      key: string,\n      container_type: string,\n    ): never;\n\n    get(key: string): Value;\n    getTyped<Key extends (keyof T) & string>(\n      txn: Loro,\n      key: Key,\n    ): T[Key];\n    set(txn: Transaction | Loro, key: string, value: Value | Prelim): void;\n    setTyped<Key extends (keyof T) & string>(\n      txn: Transaction | Loro,\n      key: Key,\n      value: T[Key],\n    ): void;\n    delete(txn: Transaction | Loro, key: string): void;\n    subscribe(txn: Transaction | Loro, listener: Listener): number;\n    subscribeDeep(txn: Transaction | Loro, listener: Listener): number;\n    subscribeOnce(txn: Transaction | Loro, listener: Listener): number;\n  }\n\n  interface LoroText {\n    insert(txn: Transaction | Loro, pos: number, text: string): void;\n    delete(txn: Transaction | Loro, pos: number, len: number): void;\n    subscribe(txn: Transaction | Loro, listener: Listener): number;\n    subscribeDeep(txn: Transaction | Loro, listener: Listener): number;\n    subscribeOnce(txn: Transaction | Loro, listener: Listener): number;\n  }\n}\n"],"names":["Loro","LoroList","LoroMap","LoroText"],"mappings":"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"}
+{"version":3,"file":"loro.js","sources":["../src/index.ts"],"sourcesContent":["export * from \"loro-wasm\";\nimport { Delta } from \"loro-wasm\";\nimport { PrelimText,PrelimList,PrelimMap } from \"loro-wasm\";\nimport { ContainerID, Loro, LoroList, LoroMap, LoroText , LoroTree, TreeID} from \"loro-wasm\";\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\n/**\n * Data types supported by loro\n */\nexport type Value =\n  | ContainerID\n  | string\n  | number\n  | boolean\n  | null\n  | { [key: string]: Value }\n  | Uint8Array\n  | Value[];\n\n\nexport type Prelim = PrelimList | PrelimMap | PrelimText;\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  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[]>[];\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 | undefined>;\n};\n\nexport type TreeDiff = {\n  type: \"tree\";\n  diff: {target: TreeID, action: \"create\"|\"delete\" } | {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\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): Value;\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 | Prelim): 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): Value;\n    getTyped<Key extends keyof T & string>(txn: Loro, key: Key): T[Key];\n    set(key: string, value: Value | Prelim): 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"],"names":["Loro","LoroList","LoroMap"],"mappings":";;;;AAKAA,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;AA8EO,SAAS,cAAc,CAA6B,EAAA;AACzD,EAAO,OAAA,CAAA,CAAE,WAAW,MAAM,CAAA,CAAA;AAC5B;;;;;;;;;;;;;;"}

package/dist/loro.mjs

@@ -1,18 +1,13 @@
-import { Loro, LoroList, LoroMap, LoroText } from 'loro-wasm';
-export { Loro, LoroList, LoroMap, LoroText, PrelimList, PrelimMap, PrelimText, Transaction, setPanicHook } from 'loro-wasm';
+import { Loro, LoroList, LoroMap } from 'loro-wasm';
+export * from 'loro-wasm';
+export { Loro } from 'loro-wasm';
 
-Loro.prototype.transact = function(cb, origin) {
-  this.__raw__transactionWithOrigin(origin, (txn) => {
-    try {
-      cb(txn);
-    } finally {
-      txn.commit();
-      txn.free();
-    }
-  });
+Loro.prototype.getTypedMap = function(...args) {
+  return this.getMap(...args);
+};
+Loro.prototype.getTypedList = function(...args) {
+  return this.getList(...args);
 };
-Loro.prototype.getTypedMap = Loro.prototype.getMap;
-Loro.prototype.getTypedList = Loro.prototype.getList;
 LoroList.prototype.getTyped = function(loro, index) {
   const value = this.get(index);
   if (typeof value === "string" && isContainerId(value)) {
@@ -21,7 +16,9 @@ LoroList.prototype.getTyped = function(loro, index) {
     return value;
   }
 };
-LoroList.prototype.insertTyped = LoroList.prototype.insert;
+LoroList.prototype.insertTyped = function(...args) {
+  return this.insert(...args);
+};
 LoroMap.prototype.getTyped = function(loro, key) {
   const value = this.get(key);
   if (typeof value === "string" && isContainerId(value)) {
@@ -30,70 +27,11 @@ LoroMap.prototype.getTyped = function(loro, key) {
     return value;
   }
 };
-LoroMap.prototype.setTyped = LoroMap.prototype.set;
-LoroText.prototype.insert = function(txn, pos, text) {
-  if (txn instanceof Loro) {
-    this.__loro_insert(txn, pos, text);
-  } else {
-    this.__txn_insert(txn, pos, text);
-  }
-};
-LoroText.prototype.delete = function(txn, pos, len) {
-  if (txn instanceof Loro) {
-    this.__loro_delete(txn, pos, len);
-  } else {
-    this.__txn_delete(txn, pos, len);
-  }
-};
-LoroList.prototype.insert = function(txn, pos, len) {
-  if (txn instanceof Loro) {
-    this.__loro_insert(txn, pos, len);
-  } else {
-    this.__txn_insert(txn, pos, len);
-  }
-};
-LoroList.prototype.delete = function(txn, pos, len) {
-  if (txn instanceof Loro) {
-    this.__loro_delete(txn, pos, len);
-  } else {
-    this.__txn_delete(txn, pos, len);
-  }
-};
-LoroMap.prototype.set = function(txn, key, value) {
-  if (txn instanceof Loro) {
-    this.__loro_insert(txn, key, value);
-  } else {
-    this.__txn_insert(txn, key, value);
-  }
-};
-LoroMap.prototype.delete = function(txn, key) {
-  if (txn instanceof Loro) {
-    this.__loro_delete(txn, key);
-  } else {
-    this.__txn_delete(txn, key);
-  }
+LoroMap.prototype.setTyped = function(...args) {
+  return this.set(...args);
 };
-const CONTAINER_TYPES = ["Map", "Text", "List"];
 function isContainerId(s) {
-  try {
-    if (s.startsWith("/")) {
-      const [_, type] = s.slice(1).split(":");
-      if (!CONTAINER_TYPES.includes(type)) {
-        return false;
-      }
-    } else {
-      const [id, type] = s.split(":");
-      if (!CONTAINER_TYPES.includes(type)) {
-        return false;
-      }
-      const [counter, client] = id.split("@");
-      Number.parseInt(counter);
-      Number.parseInt(client);
-    }
-    return true;
-  } catch (e) {
-    return false;
-  }
+  return s.startsWith("cid:");
 }
 
 export { isContainerId };

package/dist/loro.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"loro.mjs","sources":["../src/index.ts"],"sourcesContent":["export {\n  LoroList,\n  LoroMap,\n  LoroText,\n  PrelimList,\n  PrelimMap,\n  PrelimText,\n  setPanicHook,\n  Transaction,\n} from \"loro-wasm\";\nimport { PrelimMap } from \"loro-wasm\";\nimport { PrelimText } from \"loro-wasm\";\nimport { PrelimList } from \"loro-wasm\";\nimport {\n  ContainerID,\n  Loro,\n  LoroList,\n  LoroMap,\n  LoroText,\n  Transaction,\n} from \"loro-wasm\";\n\nexport type { ContainerID, ContainerType } from \"loro-wasm\";\n\nLoro.prototype.transact = function (cb, origin) {\n  this.__raw__transactionWithOrigin(origin, (txn: Transaction) => {\n    try {\n      cb(txn);\n    } finally {\n      txn.commit();\n      txn.free();\n    }\n  });\n};\n\nLoro.prototype.getTypedMap = Loro.prototype.getMap;\nLoro.prototype.getTypedList = Loro.prototype.getList;\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 = LoroList.prototype.insert;\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 = LoroMap.prototype.set;\n\nLoroText.prototype.insert = function (txn, pos, text) {\n  if (txn instanceof Loro) {\n    this.__loro_insert(txn, pos, text);\n  } else {\n    this.__txn_insert(txn, pos, text);\n  }\n};\n\nLoroText.prototype.delete = function (txn, pos, len) {\n  if (txn instanceof Loro) {\n    this.__loro_delete(txn, pos, len);\n  } else {\n    this.__txn_delete(txn, pos, len);\n  }\n};\n\nLoroList.prototype.insert = function (txn, pos, len) {\n  if (txn instanceof Loro) {\n    this.__loro_insert(txn, pos, len);\n  } else {\n    this.__txn_insert(txn, pos, len);\n  }\n};\n\nLoroList.prototype.delete = function (txn, pos, len) {\n  if (txn instanceof Loro) {\n    this.__loro_delete(txn, pos, len);\n  } else {\n    this.__txn_delete(txn, pos, len);\n  }\n};\n\nLoroMap.prototype.set = function (txn, key, value) {\n  if (txn instanceof Loro) {\n    this.__loro_insert(txn, key, value);\n  } else {\n    this.__txn_insert(txn, key, value);\n  }\n};\n\nLoroMap.prototype.delete = function (txn, key) {\n  if (txn instanceof Loro) {\n    this.__loro_delete(txn, key);\n  } else {\n    this.__txn_delete(txn, key);\n  }\n};\n\nexport type Value =\n  | ContainerID\n  | string\n  | number\n  | null\n  | { [key: string]: Value }\n  | Value[];\n\nexport type Prelim = PrelimList | PrelimMap | PrelimText;\n\nexport type Path = (number | string)[];\nexport type Delta<T> = {\n  type: \"insert\";\n  value: T;\n} | {\n  type: \"delete\";\n  len: number;\n} | {\n  type: \"retain\";\n  len: number;\n};\n\nexport type ListDiff = {\n  type: \"list\";\n  diff: Delta<Value[]>[];\n};\n\nexport type TextDiff = {\n  type: \"text\";\n  diff: Delta<string>[];\n};\n\nexport type MapDiff = {\n  type: \"map\";\n  diff: {\n    added: Record<string, Value>;\n    deleted: Record<string, Value>;\n    updated: Record<string, {\n      old: Value;\n      new: Value;\n    }>;\n  };\n};\n\nexport type Diff = ListDiff | TextDiff | MapDiff;\n\nexport interface LoroEvent {\n  local: boolean;\n  origin?: string;\n  diff: Diff;\n  target: ContainerID;\n  path: Path;\n}\n\ninterface Listener {\n  (event: LoroEvent): void;\n}\n\nconst CONTAINER_TYPES = [\"Map\", \"Text\", \"List\"];\n\nexport function isContainerId(s: string): s is ContainerID {\n  try {\n    if (s.startsWith(\"/\")) {\n      const [_, type] = s.slice(1).split(\":\");\n      if (!CONTAINER_TYPES.includes(type)) {\n        return false;\n      }\n    } else {\n      const [id, type] = s.split(\":\");\n      if (!CONTAINER_TYPES.includes(type)) {\n        return false;\n      }\n\n      const [counter, client] = id.split(\"@\");\n      Number.parseInt(counter);\n      Number.parseInt(client);\n    }\n\n    return true;\n  } catch (e) {\n    return false;\n  }\n}\n\nexport { Loro };\n\ndeclare module \"loro-wasm\" {\n  interface Loro {\n    subscribe(listener: Listener): number;\n    transact(f: (tx: Transaction) => void, origin?: string): void;\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(\n      txn: Transaction | Loro,\n      pos: number,\n      container: \"Map\",\n    ): LoroMap;\n    insertContainer(\n      txn: Transaction | Loro,\n      pos: number,\n      container: \"List\",\n    ): LoroList;\n    insertContainer(\n      txn: Transaction | Loro,\n      pos: number,\n      container: \"Text\",\n    ): LoroText;\n    insertContainer(\n      txn: Transaction | Loro,\n      pos: number,\n      container: string,\n    ): never;\n\n    get(index: number): Value;\n    getTyped<Key extends (keyof T) & number>(loro: Loro, index: Key): T[Key];\n    insertTyped<Key extends (keyof T) & number>(\n      txn: Transaction | Loro,\n      pos: Key,\n      value: T[Key],\n    ): void;\n    insert(txn: Transaction | Loro, pos: number, value: Value | Prelim): void;\n    delete(txn: Transaction | Loro, pos: number, len: number): void;\n    subscribe(txn: Transaction | Loro, listener: Listener): number;\n    subscribeDeep(txn: Transaction | Loro, listener: Listener): number;\n    subscribeOnce(txn: Transaction | Loro, listener: Listener): number;\n  }\n\n  interface LoroMap<T extends Record<string, any> = Record<string, any>> {\n    insertContainer(\n      txn: Transaction | Loro,\n      key: string,\n      container_type: \"Map\",\n    ): LoroMap;\n    insertContainer(\n      txn: Transaction | Loro,\n      key: string,\n      container_type: \"List\",\n    ): LoroList;\n    insertContainer(\n      txn: Transaction | Loro,\n      key: string,\n      container_type: \"Text\",\n    ): LoroText;\n    insertContainer(\n      txn: Transaction | Loro,\n      key: string,\n      container_type: string,\n    ): never;\n\n    get(key: string): Value;\n    getTyped<Key extends (keyof T) & string>(\n      txn: Loro,\n      key: Key,\n    ): T[Key];\n    set(txn: Transaction | Loro, key: string, value: Value | Prelim): void;\n    setTyped<Key extends (keyof T) & string>(\n      txn: Transaction | Loro,\n      key: Key,\n      value: T[Key],\n    ): void;\n    delete(txn: Transaction | Loro, key: string): void;\n    subscribe(txn: Transaction | Loro, listener: Listener): number;\n    subscribeDeep(txn: Transaction | Loro, listener: Listener): number;\n    subscribeOnce(txn: Transaction | Loro, listener: Listener): number;\n  }\n\n  interface LoroText {\n    insert(txn: Transaction | Loro, pos: number, text: string): void;\n    delete(txn: Transaction | Loro, pos: number, len: number): void;\n    subscribe(txn: Transaction | Loro, listener: Listener): number;\n    subscribeDeep(txn: Transaction | Loro, listener: Listener): number;\n    subscribeOnce(txn: Transaction | Loro, listener: Listener): number;\n  }\n}\n"],"names":["LoroList","LoroMap","LoroText"],"mappings":";;;AAwBA,IAAA,CAAK,SAAU,CAAA,QAAA,GAAW,SAAU,EAAA,EAAI,MAAQ,EAAA;AAC9C,EAAK,IAAA,CAAA,4BAAA,CAA6B,MAAQ,EAAA,CAAC,GAAqB,KAAA;AAC9D,IAAI,IAAA;AACF,MAAA,EAAA,CAAG,GAAG,CAAA,CAAA;AAAA,KACN,SAAA;AACA,MAAA,GAAA,CAAI,MAAO,EAAA,CAAA;AACX,MAAA,GAAA,CAAI,IAAK,EAAA,CAAA;AAAA,KACX;AAAA,GACD,CAAA,CAAA;AACH,CAAA,CAAA;AAEA,IAAK,CAAA,SAAA,CAAU,WAAc,GAAA,IAAA,CAAK,SAAU,CAAA,MAAA,CAAA;AAC5C,IAAK,CAAA,SAAA,CAAU,YAAe,GAAA,IAAA,CAAK,SAAU,CAAA,OAAA,CAAA;AAC7CA,QAAAA,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,QAAS,CAAA,SAAA,CAAU,WAAcA,GAAAA,QAAAA,CAAS,SAAU,CAAA,MAAA,CAAA;AACpDC,OAAAA,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,OAAQ,CAAA,SAAA,CAAU,QAAWA,GAAAA,OAAAA,CAAQ,SAAU,CAAA,GAAA,CAAA;AAE/CC,QAAAA,CAAS,SAAU,CAAA,MAAA,GAAS,SAAU,GAAA,EAAK,KAAK,IAAM,EAAA;AACpD,EAAA,IAAI,eAAe,IAAM,EAAA;AACvB,IAAK,IAAA,CAAA,aAAA,CAAc,GAAK,EAAA,GAAA,EAAK,IAAI,CAAA,CAAA;AAAA,GAC5B,MAAA;AACL,IAAK,IAAA,CAAA,YAAA,CAAa,GAAK,EAAA,GAAA,EAAK,IAAI,CAAA,CAAA;AAAA,GAClC;AACF,CAAA,CAAA;AAEAA,QAAAA,CAAS,SAAU,CAAA,MAAA,GAAS,SAAU,GAAA,EAAK,KAAK,GAAK,EAAA;AACnD,EAAA,IAAI,eAAe,IAAM,EAAA;AACvB,IAAK,IAAA,CAAA,aAAA,CAAc,GAAK,EAAA,GAAA,EAAK,GAAG,CAAA,CAAA;AAAA,GAC3B,MAAA;AACL,IAAK,IAAA,CAAA,YAAA,CAAa,GAAK,EAAA,GAAA,EAAK,GAAG,CAAA,CAAA;AAAA,GACjC;AACF,CAAA,CAAA;AAEAF,QAAAA,CAAS,SAAU,CAAA,MAAA,GAAS,SAAU,GAAA,EAAK,KAAK,GAAK,EAAA;AACnD,EAAA,IAAI,eAAe,IAAM,EAAA;AACvB,IAAK,IAAA,CAAA,aAAA,CAAc,GAAK,EAAA,GAAA,EAAK,GAAG,CAAA,CAAA;AAAA,GAC3B,MAAA;AACL,IAAK,IAAA,CAAA,YAAA,CAAa,GAAK,EAAA,GAAA,EAAK,GAAG,CAAA,CAAA;AAAA,GACjC;AACF,CAAA,CAAA;AAEAA,QAAAA,CAAS,SAAU,CAAA,MAAA,GAAS,SAAU,GAAA,EAAK,KAAK,GAAK,EAAA;AACnD,EAAA,IAAI,eAAe,IAAM,EAAA;AACvB,IAAK,IAAA,CAAA,aAAA,CAAc,GAAK,EAAA,GAAA,EAAK,GAAG,CAAA,CAAA;AAAA,GAC3B,MAAA;AACL,IAAK,IAAA,CAAA,YAAA,CAAa,GAAK,EAAA,GAAA,EAAK,GAAG,CAAA,CAAA;AAAA,GACjC;AACF,CAAA,CAAA;AAEAC,OAAAA,CAAQ,SAAU,CAAA,GAAA,GAAM,SAAU,GAAA,EAAK,KAAK,KAAO,EAAA;AACjD,EAAA,IAAI,eAAe,IAAM,EAAA;AACvB,IAAK,IAAA,CAAA,aAAA,CAAc,GAAK,EAAA,GAAA,EAAK,KAAK,CAAA,CAAA;AAAA,GAC7B,MAAA;AACL,IAAK,IAAA,CAAA,YAAA,CAAa,GAAK,EAAA,GAAA,EAAK,KAAK,CAAA,CAAA;AAAA,GACnC;AACF,CAAA,CAAA;AAEAA,OAAAA,CAAQ,SAAU,CAAA,MAAA,GAAS,SAAU,GAAA,EAAK,GAAK,EAAA;AAC7C,EAAA,IAAI,eAAe,IAAM,EAAA;AACvB,IAAK,IAAA,CAAA,aAAA,CAAc,KAAK,GAAG,CAAA,CAAA;AAAA,GACtB,MAAA;AACL,IAAK,IAAA,CAAA,YAAA,CAAa,KAAK,GAAG,CAAA,CAAA;AAAA,GAC5B;AACF,CAAA,CAAA;AA4DA,MAAM,eAAkB,GAAA,CAAC,KAAO,EAAA,MAAA,EAAQ,MAAM,CAAA,CAAA;AAEvC,SAAS,cAAc,CAA6B,EAAA;AACzD,EAAI,IAAA;AACF,IAAI,IAAA,CAAA,CAAE,UAAW,CAAA,GAAG,CAAG,EAAA;AACrB,MAAM,MAAA,CAAC,GAAG,IAAI,CAAA,GAAI,EAAE,KAAM,CAAA,CAAC,CAAE,CAAA,KAAA,CAAM,GAAG,CAAA,CAAA;AACtC,MAAA,IAAI,CAAC,eAAA,CAAgB,QAAS,CAAA,IAAI,CAAG,EAAA;AACnC,QAAO,OAAA,KAAA,CAAA;AAAA,OACT;AAAA,KACK,MAAA;AACL,MAAA,MAAM,CAAC,EAAI,EAAA,IAAI,CAAI,GAAA,CAAA,CAAE,MAAM,GAAG,CAAA,CAAA;AAC9B,MAAA,IAAI,CAAC,eAAA,CAAgB,QAAS,CAAA,IAAI,CAAG,EAAA;AACnC,QAAO,OAAA,KAAA,CAAA;AAAA,OACT;AAEA,MAAA,MAAM,CAAC,OAAS,EAAA,MAAM,CAAI,GAAA,EAAA,CAAG,MAAM,GAAG,CAAA,CAAA;AACtC,MAAA,MAAA,CAAO,SAAS,OAAO,CAAA,CAAA;AACvB,MAAA,MAAA,CAAO,SAAS,MAAM,CAAA,CAAA;AAAA,KACxB;AAEA,IAAO,OAAA,IAAA,CAAA;AAAA,WACA,CAAP,EAAA;AACA,IAAO,OAAA,KAAA,CAAA;AAAA,GACT;AACF;;;;"}
+{"version":3,"file":"loro.mjs","sources":["../src/index.ts"],"sourcesContent":["export * from \"loro-wasm\";\nimport { Delta } from \"loro-wasm\";\nimport { PrelimText,PrelimList,PrelimMap } from \"loro-wasm\";\nimport { ContainerID, Loro, LoroList, LoroMap, LoroText , LoroTree, TreeID} from \"loro-wasm\";\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\n/**\n * Data types supported by loro\n */\nexport type Value =\n  | ContainerID\n  | string\n  | number\n  | boolean\n  | null\n  | { [key: string]: Value }\n  | Uint8Array\n  | Value[];\n\n\nexport type Prelim = PrelimList | PrelimMap | PrelimText;\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  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[]>[];\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 | undefined>;\n};\n\nexport type TreeDiff = {\n  type: \"tree\";\n  diff: {target: TreeID, action: \"create\"|\"delete\" } | {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\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): Value;\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 | Prelim): 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): Value;\n    getTyped<Key extends keyof T & string>(txn: Loro, key: Key): T[Key];\n    set(key: string, value: Value | Prelim): 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"],"names":[],"mappings":";;;;AAKA,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;AA8EO,SAAS,cAAc,CAA6B,EAAA;AACzD,EAAO,OAAA,CAAA,CAAE,WAAW,MAAM,CAAA,CAAA;AAC5B;;;;"}

package/package.json

@@ -1,25 +1,38 @@
 {
   "name": "loro-crdt",
-  "version": "0.3.0",
-  "description": "",
+  "version": "0.4.0",
+  "description": "Loro CRDTs is a high-performance CRDT framework that makes your app state synchronized, collaborative and maintainable effortlessly.",
+  "keywords": [
+    "crdt",
+    "CRDTs",
+    "realtime",
+    "collaboration",
+    "sync",
+    "p2p"
+  ],
   "main": "dist/loro.js",
   "module": "dist/loro.mjs",
   "typings": "dist/loro.d.ts",
-  "author": "",
+  "author": "Loro",
+  "homepage": "https://loro.dev",
   "license": "ISC",
   "dependencies": {
-    "loro-wasm": "0.3.0"
+    "loro-wasm": "0.4.0"
   },
   "devDependencies": {
     "@rollup/plugin-node-resolve": "^15.0.1",
-    "esbuild": "^0.17.12",
+    "@typescript-eslint/parser": "^6.2.0",
+    "@vitest/ui": "^0.34.6",
+    "esbuild": "^0.18.20",
+    "eslint": "^8.46.0",
+    "prettier": "^3.0.0",
     "rollup": "^3.20.1",
     "rollup-plugin-dts": "^5.3.0",
     "rollup-plugin-esbuild": "^5.0.0",
     "typescript": "^5.0.2",
     "vite": "^4.2.1",
     "vite-plugin-wasm": "^3.2.2",
-    "vitest": "^0.29.7"
+    "vitest": "^0.34.0"
   },
   "scripts": {
     "build": "rollup -c",