loro-crdt 0.2.5

package/.vscode/settings.json

@@ -0,0 +1,3 @@
+{
+  "deno.enable": false
+}

package/dist/loro.d.ts

@@ -0,0 +1,89 @@
+import { ContainerID, PrelimList, PrelimMap, PrelimText } from 'loro-wasm';
+export { ContainerID, ContainerType, Loro, LoroList, LoroMap, LoroText, PrelimList, PrelimMap, PrelimText, Transaction, setPanicHook } from 'loro-wasm';
+
+type Value = ContainerID | string | number | null | {
+    [key: string]: Value;
+} | Value[];
+type Prelim = PrelimList | PrelimMap | PrelimText;
+type Path = (number | string)[];
+type Delta<T> = {
+    type: "insert";
+    value: T;
+} | {
+    type: "delete";
+    len: number;
+} | {
+    type: "retain";
+    len: number;
+};
+type ListDiff = {
+    type: "list";
+    diff: Delta<Value[]>[];
+};
+type TextDiff = {
+    type: "text";
+    diff: Delta<string>[];
+};
+type MapDIff = {
+    type: "map";
+    diff: {
+        added: Record<string, Value>;
+        deleted: Record<string, Value>;
+        updated: Record<string, {
+            old: Value;
+            new: Value;
+        }>;
+    };
+};
+type Diff = ListDiff | TextDiff | MapDIff;
+interface LoroEvent {
+    local: boolean;
+    origin?: string;
+    diff: Diff[];
+    target: ContainerID;
+    path: Path;
+}
+interface Listener {
+    (event: LoroEvent): void;
+}
+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 LoroList {
+        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;
+        get(index: number): Value;
+        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;
+    }
+    interface LoroMap {
+        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;
+        get(key: string): Value;
+        set(txn: Transaction | Loro, key: string, value: Value | Prelim): 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;
+    }
+    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;
+    }
+}
+
+export { Delta, Diff, ListDiff, LoroEvent, MapDIff, Path, Prelim, TextDiff, Value, isContainerId };

package/dist/loro.js

@@ -0,0 +1,117 @@
+'use strict';
+
+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.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);
+  }
+};
+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;
+  }
+}
+
+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;
+//# sourceMappingURL=loro.js.map

package/dist/loro.js.map

@@ -0,0 +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\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 LoroList {\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    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 {\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    set(txn: Transaction | Loro, key: string, value: Value | Prelim): 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","LoroText","LoroList","LoroMap"],"mappings":"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"}

package/dist/loro.mjs

@@ -0,0 +1,80 @@
+import { Loro, LoroText, LoroList, LoroMap } from 'loro-wasm';
+export { Loro, LoroList, LoroMap, LoroText, PrelimList, PrelimMap, PrelimText, Transaction, setPanicHook } from 'loro-wasm';
+
+Loro.prototype.transact = function(cb, origin) {
+  this.__raw__transactionWithOrigin(origin, (txn) => {
+    try {
+      cb(txn);
+    } finally {
+      txn.commit();
+      txn.free();
+    }
+  });
+};
+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);
+  }
+};
+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;
+  }
+}
+
+export { isContainerId };
+//# sourceMappingURL=loro.mjs.map

package/dist/loro.mjs.map

@@ -0,0 +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\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 LoroList {\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    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 {\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    set(txn: Transaction | Loro, key: string, value: Value | Prelim): 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":["LoroText","LoroList","LoroMap"],"mappings":"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"}

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "loro-crdt",
+  "version": "0.2.5",
+  "description": "",
+  "main": "dist/loro.js",
+  "module": "dist/loro.mjs",
+  "typings": "dist/loro.d.ts",
+  "scripts": {
+    "build": "rollup -c",
+    "watch": "rollup -c -w",
+    "test": "vitest run"
+  },
+  "author": "",
+  "license": "ISC",
+  "dependencies": {
+    "loro-wasm": "workspace"
+  },
+  "devDependencies": {
+    "@rollup/plugin-node-resolve": "^15.0.1",
+    "esbuild": "^0.17.12",
+    "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"
+  }
+}

package/rollup.config.mjs

@@ -0,0 +1,37 @@
+import { defineConfig } from "rollup";
+import dts from "rollup-plugin-dts";
+import esbuild from "rollup-plugin-esbuild";
+import packageJson from "./package.json" assert { type: "json" };
+
+const name = packageJson.main.replace(/\.js$/, "");
+
+const bundle = (config) => ({
+  ...config,
+  input: "src/index.ts",
+  external: (id) => !/^[./]/.test(id),
+});
+
+export default defineConfig([
+  bundle({
+    plugins: [esbuild()],
+    output: [
+      {
+        file: `${name}.js`,
+        format: "cjs",
+        sourcemap: true,
+      },
+      {
+        file: `${name}.mjs`,
+        format: "es",
+        sourcemap: true,
+      },
+    ],
+  }),
+  bundle({
+    plugins: [dts()],
+    output: {
+      file: `${name}.d.ts`,
+      format: "es",
+    },
+  }),
+]);

package/src/index.ts

@@ -0,0 +1,243 @@
+export {
+  LoroList,
+  LoroMap,
+  LoroText,
+  PrelimList,
+  PrelimMap,
+  PrelimText,
+  setPanicHook,
+  Transaction,
+} from "loro-wasm";
+import { PrelimMap } from "loro-wasm";
+import { PrelimText } from "loro-wasm";
+import { PrelimList } from "loro-wasm";
+import {
+  ContainerID,
+  Loro,
+  LoroList,
+  LoroMap,
+  LoroText,
+  Transaction,
+} from "loro-wasm";
+
+export type { ContainerID, ContainerType } from "loro-wasm";
+
+Loro.prototype.transact = function (cb, origin) {
+  this.__raw__transactionWithOrigin(origin, (txn: Transaction) => {
+    try {
+      cb(txn);
+    } finally {
+      txn.commit();
+      txn.free();
+    }
+  });
+};
+
+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);
+  }
+};
+
+export type Value =
+  | ContainerID
+  | string
+  | number
+  | null
+  | { [key: string]: Value }
+  | Value[];
+
+export type Prelim = PrelimList | PrelimMap | PrelimText;
+
+export type Path = (number | string)[];
+export type Delta<T> = {
+  type: "insert";
+  value: T;
+} | {
+  type: "delete";
+  len: number;
+} | {
+  type: "retain";
+  len: number;
+};
+
+export type ListDiff = {
+  type: "list";
+  diff: Delta<Value[]>[];
+};
+
+export type TextDiff = {
+  type: "text";
+  diff: Delta<string>[];
+};
+
+export type MapDiff = {
+  type: "map";
+  diff: {
+    added: Record<string, Value>;
+    deleted: Record<string, Value>;
+    updated: Record<string, {
+      old: Value;
+      new: Value;
+    }>;
+  };
+};
+
+export type Diff = ListDiff | TextDiff | MapDiff;
+
+export interface LoroEvent {
+  local: boolean;
+  origin?: string;
+  diff: Diff;
+  target: ContainerID;
+  path: Path;
+}
+
+interface Listener {
+  (event: LoroEvent): void;
+}
+
+const CONTAINER_TYPES = ["Map", "Text", "List"];
+
+export function isContainerId(s: string): s is ContainerID {
+  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;
+  }
+}
+
+export { Loro };
+
+declare module "loro-wasm" {
+  interface Loro {
+    subscribe(listener: Listener): number;
+    transact(f: (tx: Transaction) => void, origin?: string): void;
+  }
+
+  interface LoroList {
+    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;
+
+    get(index: number): Value;
+    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;
+  }
+
+  interface LoroMap {
+    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;
+
+    get(key: string): Value;
+    set(txn: Transaction | Loro, key: string, value: Value | Prelim): 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;
+  }
+
+  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;
+  }
+}

package/tests/event.test.ts

@@ -0,0 +1,261 @@
+import { describe, expect, it } from "vitest";
+import {
+  Delta,
+  ListDiff,
+  Loro,
+  LoroEvent,
+  MapDiff as MapDiff,
+  TextDiff,
+} from "../src";
+
+describe("event", () => {
+  it("target", async () => {
+    const loro = new Loro();
+    let lastEvent: undefined | LoroEvent;
+    loro.subscribe((event) => {
+      lastEvent = event;
+    });
+    const text = loro.getText("text");
+    const id = text.id;
+    text.insert(loro, 0, "123");
+    await zeroMs();
+    expect(lastEvent?.target).toEqual(id);
+  });
+
+  it("path", async () => {
+    const loro = new Loro();
+    let lastEvent: undefined | LoroEvent;
+    loro.subscribe((event) => {
+      lastEvent = event;
+    });
+    const map = loro.getMap("map");
+    const subMap = map.insertContainer(loro, "sub", "Map");
+    subMap.set(loro, "0", "1");
+    await zeroMs();
+    expect(lastEvent?.path).toStrictEqual(["map", "sub"]);
+    const list = subMap.insertContainer(loro, "list", "List");
+    list.insert(loro, 0, "2");
+    const text = list.insertContainer(loro, 1, "Text");
+    await zeroMs();
+    text.insert(loro, 0, "3");
+    await zeroMs();
+    expect(lastEvent?.path).toStrictEqual(["map", "sub", "list", 1]);
+  });
+
+  it("text diff", async () => {
+    const loro = new Loro();
+    let lastEvent: undefined | LoroEvent;
+    loro.subscribe((event) => {
+      lastEvent = event;
+    });
+    const text = loro.getText("t");
+    text.insert(loro, 0, "3");
+    await zeroMs();
+    expect(lastEvent?.diff).toStrictEqual(
+      { type: "text", diff: [{ type: "insert", value: "3" }] } as TextDiff,
+    );
+    text.insert(loro, 1, "12");
+    await zeroMs();
+    expect(lastEvent?.diff).toStrictEqual(
+      {
+        type: "text",
+        diff: [{ type: "retain", len: 1 }, { type: "insert", value: "12" }],
+      } as TextDiff,
+    );
+  });
+
+  it("list diff", async () => {
+    const loro = new Loro();
+    let lastEvent: undefined | LoroEvent;
+    loro.subscribe((event) => {
+      lastEvent = event;
+    });
+    const text = loro.getList("l");
+    text.insert(loro, 0, "3");
+    await zeroMs();
+    expect(lastEvent?.diff).toStrictEqual(
+      { type: "list", diff: [{ type: "insert", value: ["3"] }] } as ListDiff,
+    );
+    text.insert(loro, 1, "12");
+    await zeroMs();
+    expect(lastEvent?.diff).toStrictEqual(
+      {
+        type: "list",
+        diff: [{ type: "retain", len: 1 }, { type: "insert", value: ["12"] }],
+      } as ListDiff,
+    );
+  });
+
+  it("map diff", async () => {
+    const loro = new Loro();
+    let lastEvent: undefined | LoroEvent;
+    loro.subscribe((event) => {
+      lastEvent = event;
+    });
+    const map = loro.getMap("m");
+    loro.transact((tx) => {
+      map.set(tx, "0", "3");
+      map.set(tx, "1", "2");
+    });
+    await zeroMs();
+    expect(lastEvent?.diff).toStrictEqual(
+      {
+        type: "map",
+        diff: {
+          added: {
+            "0": "3",
+            "1": "2",
+          },
+          deleted: {},
+          updated: {},
+        },
+      } as MapDiff,
+    );
+    loro.transact((tx) => {
+      map.set(tx, "0", "0");
+      map.set(tx, "1", "1");
+    });
+    await zeroMs();
+    expect(lastEvent?.diff).toStrictEqual(
+      {
+        type: "map",
+        diff: {
+          added: {},
+          updated: {
+            "0": { old: "3", new: "0" },
+            "1": { old: "2", new: "1" },
+          },
+          deleted: {},
+        },
+      } as MapDiff,
+    );
+  });
+
+  describe("subscribe container events", () => {
+    it("text", async () => {
+      const loro = new Loro();
+      const text = loro.getText("text");
+      let ran = 0;
+      let oneTimeRan = 0;
+      text.subscribeOnce(loro, (_) => {
+        oneTimeRan += 1;
+      });
+      const sub = text.subscribe(loro, (event) => {
+        if (!ran) {
+          expect(event.diff.diff).toStrictEqual(
+            [{ type: "insert", "value": "123" }] as Delta<string>[],
+          );
+        }
+        ran += 1;
+        expect(event.target).toBe(text.id);
+      });
+      text.insert(loro, 0, "123");
+      text.insert(loro, 1, "456");
+      await zeroMs();
+      expect(ran).toBeTruthy();
+      // subscribeOnce test
+      expect(oneTimeRan).toBe(1);
+      expect(text.toString()).toEqual("145623");
+
+      // unsubscribe
+      const oldRan = ran;
+      text.unsubscribe(loro, sub);
+      text.insert(loro, 0, "789");
+      expect(ran).toBe(oldRan);
+    });
+
+    it("map subscribe deep", async () => {
+      const loro = new Loro();
+      const map = loro.getMap("map");
+      let times = 0;
+      const sub = map.subscribeDeep(loro, (event) => {
+        times += 1;
+      });
+
+      const subMap = map.insertContainer(loro, "sub", "Map");
+      await zeroMs();
+      expect(times).toBe(1);
+      const text = subMap.insertContainer(loro, "k", "Text");
+      await zeroMs();
+      expect(times).toBe(2);
+      text.insert(loro, 0, "123");
+      await zeroMs();
+      expect(times).toBe(3);
+
+      // unsubscribe
+      map.unsubscribe(loro, sub);
+      text.insert(loro, 0, "123");
+      await zeroMs();
+      expect(times).toBe(3);
+    });
+
+    it("list subscribe deep", async () => {
+      const loro = new Loro();
+      const list = loro.getList("list");
+      let times = 0;
+      const sub = list.subscribeDeep(loro, (_) => {
+        times += 1;
+      });
+
+      const text = list.insertContainer(loro, 0, "Text");
+      await zeroMs();
+      expect(times).toBe(1);
+      text.insert(loro, 0, "123");
+      await zeroMs();
+      expect(times).toBe(2);
+
+      // unsubscribe
+      list.unsubscribe(loro, sub);
+      text.insert(loro, 0, "123");
+      await zeroMs();
+      expect(times).toBe(2);
+    });
+  });
+
+  describe("text event length should be utf16", () => {
+    it("test", async () => {
+      const loro = new Loro();
+      const text = loro.getText("text");
+      let string = "";
+      text.subscribe(loro, (event) => {
+        const diff = event.diff;
+        expect(diff.type).toBe("text");
+        if (diff.type === "text") {
+          let newString = "";
+          let pos = 0;
+          for (const delta of diff.diff) {
+            if (delta.type === "retain") {
+              pos += delta.len;
+              newString += string.slice(0, pos);
+            } else if (delta.type === "insert") {
+              newString += delta.value;
+            } else {
+              pos += delta.len;
+            }
+          }
+
+          string = newString + string.slice(pos);
+        }
+      });
+      text.insert(loro, 0, "你好");
+      await zeroMs();
+      expect(text.toString()).toBe(string);
+
+      text.insert(loro, 1, "世界");
+      await zeroMs();
+      expect(text.toString()).toBe(string);
+
+      text.insert(loro, 2, "👍");
+      await zeroMs();
+      expect(text.toString()).toBe(string);
+
+      text.insert(loro, 4, "♪(^∇^*)");
+      await zeroMs();
+      expect(text.toString()).toBe(string);
+    });
+  });
+});
+
+function zeroMs(): Promise<void> {
+  return new Promise((r) => setTimeout(r));
+}

package/tests/frontiers.test.ts

@@ -0,0 +1,30 @@
+import { describe, expect, it } from "vitest";
+import {
+  Delta,
+  ListDiff,
+  Loro,
+  LoroEvent,
+  MapDiff as MapDiff,
+  TextDiff,
+} from "../src";
+
+describe("Frontiers", () => {
+  it("two clients", () => {
+    const doc = new Loro();
+    const text = doc.getText("text");
+    text.insert(doc, 0, "0");
+    const v0 = doc.frontiers();
+    const docB = new Loro();
+    docB.import(doc.exportFrom());
+    expect(docB.cmpFrontiers(v0)).toBe(0);
+    text.insert(doc, 1, "0");
+    expect(docB.cmpFrontiers(doc.frontiers())).toBe(-1);
+    const textB = docB.getText("text");
+    textB.insert(docB, 0, "0");
+    expect(docB.cmpFrontiers(doc.frontiers())).toBe(-1);
+    docB.import(doc.exportFrom());
+    expect(docB.cmpFrontiers(doc.frontiers())).toBe(1);
+    doc.import(docB.exportFrom());
+    expect(docB.cmpFrontiers(doc.frontiers())).toBe(0);
+  });
+});

package/tests/misc.test.ts

@@ -0,0 +1,262 @@
+import { describe, expect, it } from "vitest";
+import {
+  Delta,
+  ListDiff,
+  Loro,
+  LoroEvent,
+  LoroMap,
+  MapDiff as MapDiff,
+  PrelimList,
+  PrelimMap,
+  PrelimText,
+  TextDiff,
+  Transaction,
+} from "../src";
+
+function assertEquals(a: any, b: any) {
+  expect(a).toStrictEqual(b);
+}
+
+describe("transaction", () => {
+  it("transaction", async () => {
+    const loro = new Loro();
+    const text = loro.getText("text");
+    let count = 0;
+    const sub = loro.subscribe(() => {
+      count += 1;
+      loro.unsubscribe(sub);
+    });
+    loro.transact((txn: Transaction) => {
+      expect(count).toBe(0);
+      text.insert(txn, 0, "hello world");
+      expect(count).toBe(0);
+      text.insert(txn, 0, "hello world");
+      assertEquals(count, 0);
+    });
+    await one_ms();
+    assertEquals(count, 1);
+  });
+
+  it("transaction origin", async () => {
+    const loro = new Loro();
+    const text = loro.getText("text");
+    let count = 0;
+    const sub = loro.subscribe((event: { origin: string }) => {
+      count += 1;
+      loro.unsubscribe(sub);
+      assertEquals(event.origin, "origin");
+    });
+    loro.transact((txn: Transaction) => {
+      assertEquals(count, 0);
+      text.insert(txn, 0, "hello world");
+      assertEquals(count, 0);
+      text.insert(txn, 0, "hello world");
+      assertEquals(count, 0);
+    }, "origin");
+    await one_ms();
+    assertEquals(count, 1);
+  });
+});
+
+describe("subscribe", () => {
+  it("subscribe_lock", async () => {
+    const loro = new Loro();
+    const text = loro.getText("text");
+    const list = loro.getList("list");
+    let count = 0;
+    let i = 1;
+    const sub = loro.subscribe(() => {
+      if (i > 0) {
+        list.insert(loro, 0, i);
+        i--;
+      }
+      count += 1;
+    });
+    text.insert(loro, 0, "hello world");
+    await one_ms();
+    assertEquals(count, 2);
+    text.insert(loro, 0, "hello world");
+    await one_ms();
+    assertEquals(count, 3);
+    loro.unsubscribe(sub);
+    text.insert(loro, 0, "hello world");
+    await one_ms();
+    assertEquals(count, 3);
+  });
+
+  it("subscribe_lock2", async () => {
+    const loro = new Loro();
+    const text = loro.getText("text");
+    let count = 0;
+    const sub = loro.subscribe(() => {
+      count += 1;
+      loro.unsubscribe(sub);
+    });
+    assertEquals(count, 0);
+    text.insert(loro, 0, "hello world");
+    await one_ms();
+    assertEquals(count, 1);
+    text.insert(loro, 0, "hello world");
+    assertEquals(count, 1);
+  });
+
+  it("subscribe", async () => {
+    const loro = new Loro();
+    const text = loro.getText("text");
+    let count = 0;
+    const sub = loro.subscribe(() => {
+      count += 1;
+    });
+    text.insert(loro, 0, "hello world");
+    await one_ms();
+    assertEquals(count, 1);
+    text.insert(loro, 0, "hello world");
+    await one_ms();
+    assertEquals(count, 2);
+    loro.unsubscribe(sub);
+    text.insert(loro, 0, "hello world");
+    await one_ms();
+    assertEquals(count, 2);
+  });
+});
+
+describe("sync", () => {
+  it("two insert at beginning", async () => {
+    const a = new Loro();
+    const b = new Loro();
+    let a_version: undefined | Uint8Array = undefined;
+    let b_version: undefined | Uint8Array = undefined;
+    a.subscribe((e: { local: boolean }) => {
+      if (e.local) {
+        const exported = a.exportFrom(a_version);
+        b.import(exported);
+        a_version = a.version();
+      }
+    });
+    b.subscribe((e: { local: boolean }) => {
+      if (e.local) {
+        const exported = b.exportFrom(b_version);
+        a.import(exported);
+        b_version = b.version();
+      }
+    });
+    const aText = a.getText("text");
+    const bText = b.getText("text");
+    aText.insert(a, 0, "abc");
+    await one_ms();
+    assertEquals(aText.toString(), bText.toString());
+  });
+
+  it("sync", () => {
+    const loro = new Loro();
+    const text = loro.getText("text");
+    text.insert(loro, 0, "hello world");
+    const loro_bk = new Loro();
+    loro_bk.import(loro.exportFrom(undefined));
+    assertEquals(loro_bk.toJson(), loro.toJson());
+    const text_bk = loro_bk.getText("text");
+    assertEquals(text_bk.toString(), "hello world");
+    text_bk.insert(loro_bk, 0, "a ");
+    loro.import(loro_bk.exportFrom(undefined));
+    assertEquals(text.toString(), "a hello world");
+    const map = loro.getMap("map");
+    map.set(loro, "key", "value");
+  });
+});
+
+describe("prelim", () => {
+  it("test prelim", async (t) => {
+    const loro = new Loro();
+    const map = loro.getMap("map");
+    const list = loro.getList("list");
+    const prelim_text = new PrelimText(undefined);
+    const prelim_map = new PrelimMap({ a: 1, b: 2 });
+    const prelim_list = new PrelimList([1, "2", { a: 4 }]);
+
+    it("prelim text", () => {
+      prelim_text.insert(0, "hello world");
+      assertEquals(prelim_text.value, "hello world");
+      prelim_text.delete(6, 5);
+      prelim_text.insert(6, "everyone");
+      assertEquals(prelim_text.value, "hello everyone");
+    });
+
+    it("prelim map", () => {
+      prelim_map.set("ab", 123);
+      assertEquals(prelim_map.value, { a: 1, b: 2, ab: 123 });
+      prelim_map.delete("b");
+      assertEquals(prelim_map.value, { a: 1, ab: 123 });
+    });
+
+    it("prelim list", () => {
+      prelim_list.insert(0, 0);
+      assertEquals(prelim_list.value, [0, 1, "2", { a: 4 }]);
+      prelim_list.delete(1, 2);
+      assertEquals(prelim_list.value, [0, { a: 4 }]);
+    });
+
+    it("prelim map integrate", () => {
+      map.set(loro, "text", prelim_text);
+      map.set(loro, "map", prelim_map);
+      map.set(loro, "list", prelim_list);
+      assertEquals(map.getValueDeep(loro), {
+        text: "hello everyone",
+        map: { a: 1, ab: 123 },
+        list: [0, { a: 4 }],
+      });
+    });
+
+    it("prelim list integrate", () => {
+      const prelim_text = new PrelimText("ttt");
+      const prelim_map = new PrelimMap({ a: 1, b: 2 });
+      const prelim_list = new PrelimList([1, "2", { a: 4 }]);
+      list.insert(loro, 0, prelim_text);
+      list.insert(loro, 1, prelim_map);
+      list.insert(loro, 2, prelim_list);
+      assertEquals(list.getValueDeep(loro), ["ttt", { a: 1, b: 2 }, [1, "2", {
+        a: 4,
+      }]]);
+    });
+  });
+});
+
+describe("wasm", () => {
+  const loro = new Loro();
+  const a = loro.getText("ha");
+  a.insert(loro, 0, "hello world");
+  a.delete(loro, 6, 5);
+  a.insert(loro, 6, "everyone");
+  const b = loro.getMap("ha");
+  b.set(loro, "ab", 123);
+
+  const bText = b.insertContainer(loro, "hh", "Text");
+
+  it("map get", () => {
+    assertEquals(b.get("ab"), 123);
+  });
+
+  it("getValueDeep", () => {
+    bText.insert(loro, 0, "hello world Text");
+    assertEquals(b.getValueDeep(loro), { ab: 123, hh: "hello world Text" });
+  });
+
+  it("should throw error when using the wrong context", () => {
+    expect(() => {
+      const loro2 = new Loro();
+      bText.insert(loro2, 0, "hello world Text");
+    }).toThrow();
+  });
+
+  it("get container by id", () => {
+    const id = b.id;
+    const b2 = loro.getContainerById(id) as LoroMap;
+    assertEquals(b2.value, b.value);
+    assertEquals(b2.id, id);
+    b2.set(loro, "0", 12);
+    assertEquals(b2.value, b.value);
+  });
+});
+
+function one_ms(): Promise<void> {
+  return new Promise((resolve) => setTimeout(resolve, 1));
+}

package/tsconfig.json

@@ -0,0 +1,109 @@
+{
+  "compilerOptions": {
+    /* Visit https://aka.ms/tsconfig to read more about this file */
+
+    /* Projects */
+    // "incremental": true,                              /* Save .tsbuildinfo files to allow for incremental compilation of projects. */
+    // "composite": true,                                /* Enable constraints that allow a TypeScript project to be used with project references. */
+    // "tsBuildInfoFile": "./.tsbuildinfo",              /* Specify the path to .tsbuildinfo incremental compilation file. */
+    // "disableSourceOfProjectReferenceRedirect": true,  /* Disable preferring source files instead of declaration files when referencing composite projects. */
+    // "disableSolutionSearching": true,                 /* Opt a project out of multi-project reference checking when editing. */
+    // "disableReferencedProjectLoad": true,             /* Reduce the number of projects loaded automatically by TypeScript. */
+
+    /* Language and Environment */
+    "target": "ESNext" /* Set the JavaScript language version for emitted JavaScript and include compatible library declarations. */,
+    // "lib": [],                                        /* Specify a set of bundled library declaration files that describe the target runtime environment. */
+    // "jsx": "preserve",                                /* Specify what JSX code is generated. */
+    // "experimentalDecorators": true,                   /* Enable experimental support for legacy experimental decorators. */
+    // "emitDecoratorMetadata": true,                    /* Emit design-type metadata for decorated declarations in source files. */
+    // "jsxFactory": "",                                 /* Specify the JSX factory function used when targeting React JSX emit, e.g. 'React.createElement' or 'h'. */
+    // "jsxFragmentFactory": "",                         /* Specify the JSX Fragment reference used for fragments when targeting React JSX emit e.g. 'React.Fragment' or 'Fragment'. */
+    // "jsxImportSource": "",                            /* Specify module specifier used to import the JSX factory functions when using 'jsx: react-jsx*'. */
+    // "reactNamespace": "",                             /* Specify the object invoked for 'createElement'. This only applies when targeting 'react' JSX emit. */
+    // "noLib": true,                                    /* Disable including any library files, including the default lib.d.ts. */
+    // "useDefineForClassFields": true,                  /* Emit ECMAScript-standard-compliant class fields. */
+    // "moduleDetection": "auto",                        /* Control what method is used to detect module-format JS files. */
+
+    /* Modules */
+    "module": "commonjs" /* Specify what module code is generated. */,
+    // "rootDir": "./",                                  /* Specify the root folder within your source files. */
+    // "moduleResolution": "node10",                     /* Specify how TypeScript looks up a file from a given module specifier. */
+    // "baseUrl": "./",                                  /* Specify the base directory to resolve non-relative module names. */
+    // "paths": {},                                      /* Specify a set of entries that re-map imports to additional lookup locations. */
+    // "rootDirs": [],                                   /* Allow multiple folders to be treated as one when resolving modules. */
+    // "typeRoots": [],                                  /* Specify multiple folders that act like './node_modules/@types'. */
+    // "types": [],                                      /* Specify type package names to be included without being referenced in a source file. */
+    // "allowUmdGlobalAccess": true,                     /* Allow accessing UMD globals from modules. */
+    // "moduleSuffixes": [],                             /* List of file name suffixes to search when resolving a module. */
+    // "allowImportingTsExtensions": true,               /* Allow imports to include TypeScript file extensions. Requires '--moduleResolution bundler' and either '--noEmit' or '--emitDeclarationOnly' to be set. */
+    // "resolvePackageJsonExports": true,                /* Use the package.json 'exports' field when resolving package imports. */
+    // "resolvePackageJsonImports": true,                /* Use the package.json 'imports' field when resolving imports. */
+    // "customConditions": [],                           /* Conditions to set in addition to the resolver-specific defaults when resolving imports. */
+    // "resolveJsonModule": true,                        /* Enable importing .json files. */
+    // "allowArbitraryExtensions": true,                 /* Enable importing files with any extension, provided a declaration file is present. */
+    // "noResolve": true,                                /* Disallow 'import's, 'require's or '<reference>'s from expanding the number of files TypeScript should add to a project. */
+
+    /* JavaScript Support */
+    // "allowJs": true,                                  /* Allow JavaScript files to be a part of your program. Use the 'checkJS' option to get errors from these files. */
+    // "checkJs": true,                                  /* Enable error reporting in type-checked JavaScript files. */
+    // "maxNodeModuleJsDepth": 1,                        /* Specify the maximum folder depth used for checking JavaScript files from 'node_modules'. Only applicable with 'allowJs'. */
+
+    /* Emit */
+    // "declaration": true,                              /* Generate .d.ts files from TypeScript and JavaScript files in your project. */
+    // "declarationMap": true,                           /* Create sourcemaps for d.ts files. */
+    // "emitDeclarationOnly": true,                      /* Only output d.ts files and not JavaScript files. */
+    // "sourceMap": true,                                /* Create source map files for emitted JavaScript files. */
+    // "inlineSourceMap": true,                          /* Include sourcemap files inside the emitted JavaScript. */
+    // "outFile": "./",                                  /* Specify a file that bundles all outputs into one JavaScript file. If 'declaration' is true, also designates a file that bundles all .d.ts output. */
+    // "outDir": "./",                                   /* Specify an output folder for all emitted files. */
+    // "removeComments": true,                           /* Disable emitting comments. */
+    // "noEmit": true,                                   /* Disable emitting files from a compilation. */
+    // "importHelpers": true,                            /* Allow importing helper functions from tslib once per project, instead of including them per-file. */
+    // "importsNotUsedAsValues": "remove",               /* Specify emit/checking behavior for imports that are only used for types. */
+    // "downlevelIteration": true,                       /* Emit more compliant, but verbose and less performant JavaScript for iteration. */
+    // "sourceRoot": "",                                 /* Specify the root path for debuggers to find the reference source code. */
+    // "mapRoot": "",                                    /* Specify the location where debugger should locate map files instead of generated locations. */
+    // "inlineSources": true,                            /* Include source code in the sourcemaps inside the emitted JavaScript. */
+    // "emitBOM": true,                                  /* Emit a UTF-8 Byte Order Mark (BOM) in the beginning of output files. */
+    // "newLine": "crlf",                                /* Set the newline character for emitting files. */
+    // "stripInternal": true,                            /* Disable emitting declarations that have '@internal' in their JSDoc comments. */
+    // "noEmitHelpers": true,                            /* Disable generating custom helper functions like '__extends' in compiled output. */
+    // "noEmitOnError": true,                            /* Disable emitting files if any type checking errors are reported. */
+    // "preserveConstEnums": true,                       /* Disable erasing 'const enum' declarations in generated code. */
+    // "declarationDir": "./",                           /* Specify the output directory for generated declaration files. */
+    // "preserveValueImports": true,                     /* Preserve unused imported values in the JavaScript output that would otherwise be removed. */
+
+    /* Interop Constraints */
+    // "isolatedModules": true,                          /* Ensure that each file can be safely transpiled without relying on other imports. */
+    // "verbatimModuleSyntax": true,                     /* Do not transform or elide any imports or exports not marked as type-only, ensuring they are written in the output file's format based on the 'module' setting. */
+    // "allowSyntheticDefaultImports": true,             /* Allow 'import x from y' when a module doesn't have a default export. */
+    "esModuleInterop": true /* Emit additional JavaScript to ease support for importing CommonJS modules. This enables 'allowSyntheticDefaultImports' for type compatibility. */,
+    // "preserveSymlinks": true,                         /* Disable resolving symlinks to their realpath. This correlates to the same flag in node. */
+    "forceConsistentCasingInFileNames": true /* Ensure that casing is correct in imports. */,
+
+    /* Type Checking */
+    "strict": true /* Enable all strict type-checking options. */,
+    // "noImplicitAny": true,                            /* Enable error reporting for expressions and declarations with an implied 'any' type. */
+    // "strictNullChecks": true,                         /* When type checking, take into account 'null' and 'undefined'. */
+    // "strictFunctionTypes": true,                      /* When assigning functions, check to ensure parameters and the return values are subtype-compatible. */
+    // "strictBindCallApply": true,                      /* Check that the arguments for 'bind', 'call', and 'apply' methods match the original function. */
+    // "strictPropertyInitialization": true,             /* Check for class properties that are declared but not set in the constructor. */
+    // "noImplicitThis": true,                           /* Enable error reporting when 'this' is given the type 'any'. */
+    // "useUnknownInCatchVariables": true,               /* Default catch clause variables as 'unknown' instead of 'any'. */
+    // "alwaysStrict": true,                             /* Ensure 'use strict' is always emitted. */
+    // "noUnusedLocals": true,                           /* Enable error reporting when local variables aren't read. */
+    // "noUnusedParameters": true,                       /* Raise an error when a function parameter isn't read. */
+    // "exactOptionalPropertyTypes": true,               /* Interpret optional property types as written, rather than adding 'undefined'. */
+    // "noImplicitReturns": true,                        /* Enable error reporting for codepaths that do not explicitly return in a function. */
+    // "noFallthroughCasesInSwitch": true,               /* Enable error reporting for fallthrough cases in switch statements. */
+    // "noUncheckedIndexedAccess": true,                 /* Add 'undefined' to a type when accessed using an index. */
+    // "noImplicitOverride": true,                       /* Ensure overriding members in derived classes are marked with an override modifier. */
+    // "noPropertyAccessFromIndexSignature": true,       /* Enforces using indexed accessors for keys declared using an indexed type. */
+    // "allowUnusedLabels": true,                        /* Disable error reporting for unused labels. */
+    // "allowUnreachableCode": true,                     /* Disable error reporting for unreachable code. */
+
+    /* Completeness */
+    // "skipDefaultLibCheck": true,                      /* Skip type checking .d.ts files that are included with TypeScript. */
+    "skipLibCheck": true /* Skip type checking all .d.ts files. */
+  }
+}

package/vite.config.ts

@@ -0,0 +1,8 @@
+/// <reference types="vitest" />
+import wasm from "vite-plugin-wasm";
+import { defineConfig } from "vite";
+
+export default defineConfig({
+  plugins: [wasm()],
+  test: {},
+});