loro-crdt 0.11.1 → 0.13.0

package/CHANGELOG.md

@@ -1,5 +1,35 @@
 # Changelog
 
+## 0.13.0
+
+### Minor Changes
+
+- BREAKING CHANGE: `detached` mode for Containers #300
+
+  Now creating sub-containers is much easier.
+
+  A container can be either attached to a document or detached. When it's detached, its history/state is not persisted. You can attach a container to a document by inserting it into an existing attached container. Once a container is attached, its state, along with all of its descendants's states, will be recreated in the document. After attaching, the container and its descendants will each have their corresponding "attached" version of themselves.
+
+  When a detached container x is attached to a document, you can use `x.getAttached()` to obtain the corresponding attached container.
+
+  When we use const text = new LoroList(), it's not attached to a doc. But we can insert it into a doc by map.insertContainer(”t”, text), where the map is attached. But if we want the operations on the text to be recorded to the doc, we now need to get its attached version. So we can use “let attachedText = text.getAttached()”
+
+### Patch Changes
+
+- Updated dependencies
+  - loro-wasm@0.13.0
+
+## 0.12.0
+
+### Minor Changes
+
+- Add getParent and getOrCreate
+
+### Patch Changes
+
+- Updated dependencies
+  - loro-wasm@0.12.0
+
 ## 0.11.1
 
 ### Patch Changes

package/dist/loro.d.ts

@@ -1,4 +1,4 @@
-import { Value, Container, TreeID, OpId, ContainerID, Delta, LoroText, LoroMap, LoroTree, LoroList } from 'loro-wasm';
+import { Container, Value, TreeID, OpId, ContainerID, Delta, LoroText, LoroMap, LoroTree, LoroList } from 'loro-wasm';
 export * from 'loro-wasm';
 export { Loro } from 'loro-wasm';
 
@@ -125,24 +125,22 @@ declare module "loro-wasm" {
         getTypedList<Key extends keyof T & string>(name: Key): T[Key] extends LoroList ? T[Key] : never;
     }
     interface LoroList<T extends any[] = any[]> {
-        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;
+        insertContainer<C extends Container>(pos: number, child: C): C;
         get(index: number): undefined | Value | Container;
         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: Container): never;
         insert(pos: number, value: Value): void;
         delete(pos: number, len: number): void;
         subscribe(txn: Loro, listener: Listener): number;
     }
     interface LoroMap<T extends Record<string, any> = Record<string, any>> {
-        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;
+        getOrCreateContainer(key: string, container_type: "Map"): LoroMap;
+        getOrCreateContainer(key: string, container_type: "List"): LoroList;
+        getOrCreateContainer(key: string, container_type: "Text"): LoroText;
+        getOrCreateContainer(key: string, container_type: "Tree"): LoroTree;
+        getOrCreateContainer(key: string, container_type: string): never;
+        setContainer<C extends Container>(key: string, child: C): C;
         get(key: string): undefined | Value | Container;
         getTyped<Key extends keyof T & string>(txn: Loro, key: Key): T[Key];
         set(key: string, value: Value): void;

package/dist/loro.js.map

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

package/dist/loro.mjs.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "loro-crdt",
-  "version": "0.11.1",
+  "version": "0.13.0",
   "description": "Loro CRDTs is a high-performance CRDT framework that makes your app state synchronized, collaborative and maintainable effortlessly.",
   "keywords": [
     "crdt",
@@ -17,7 +17,7 @@
   "homepage": "https://loro.dev",
   "license": "MIT",
   "dependencies": {
-    "loro-wasm": "0.11.1"
+    "loro-wasm": "0.13.0"
   },
   "devDependencies": {
     "@rollup/plugin-node-resolve": "^15.0.1",
@@ -32,7 +32,7 @@
     "typescript": "^5.0.2",
     "vite": "^4.2.1",
     "vite-plugin-wasm": "^3.2.2",
-    "vitest": "^1.0.4"
+    "vitest": "^1.4.0"
   },
   "scripts": {
     "build": "rollup -c",

package/src/index.ts

@@ -1,6 +1,18 @@
 export * from "loro-wasm";
-import { Container, Delta, LoroText, LoroTree,LoroTreeNode, OpId, Value, ContainerID, Loro, LoroList, LoroMap, TreeID } from "loro-wasm";
-
+import {
+  Container,
+  ContainerID,
+  Delta,
+  Loro,
+  LoroList,
+  LoroMap,
+  LoroText,
+  LoroTree,
+  LoroTreeNode,
+  OpId,
+  TreeID,
+  Value,
+} from "loro-wasm";
 
 Loro.prototype.getTypedMap = function (...args) {
   return this.getMap(...args);
@@ -36,10 +48,10 @@ export type Frontiers = OpId[];
 /**
  * Represents a path to identify the exact location of an event's target.
  * The path is composed of numbers (e.g., indices of a list container) strings
- * (e.g., keys of a map container) and TreeID (the node of a tree container), 
+ * (e.g., keys of a map container) and TreeID (the node of a tree container),
  * indicating the absolute position of the event's source within a loro document.
  */
-export type Path = (number | string | TreeID )[];
+export type Path = (number | string | TreeID)[];
 
 /**
  * A batch of events that created by a single `import`/`transaction`/`checkout`.
@@ -95,9 +107,10 @@ export type MapDiff = {
   updated: Record<string, Value | Container | undefined>;
 };
 
-export type TreeDiffItem = { target: TreeID; action: "create"; parent: TreeID | undefined }
-   | { target: TreeID; action: "delete" }
-   | { target: TreeID; action: "move"; parent: TreeID | undefined };
+export type TreeDiffItem =
+  | { target: TreeID; action: "create"; parent: TreeID | undefined }
+  | { target: TreeID; action: "delete" }
+  | { target: TreeID; action: "move"; parent: TreeID | undefined };
 
 export type TreeDiff = {
   type: "tree";
@@ -166,14 +179,10 @@ export function isContainer(value: any): value is Container {
  */
 export function getType<T>(
   value: T,
-): T extends LoroText
-  ? "Text"
-  : T extends LoroMap
-  ? "Map"
-  : T extends LoroTree
-  ? "Tree"
-  : T extends LoroList
-  ? "List"
+): T extends LoroText ? "Text"
+  : T extends LoroMap ? "Map"
+  : T extends LoroTree ? "Tree"
+  : T extends LoroList ? "List"
   : "Json" {
   if (isContainer(value)) {
     return value.kind();
@@ -197,26 +206,25 @@ declare module "loro-wasm" {
   }
 
   interface LoroList<T extends any[] = any[]> {
-    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;
+    insertContainer<C extends Container>(pos: number, child: C): C;
 
     get(index: number): undefined | Value | Container;
     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: Container): never;
     insert(pos: number, value: Value): void;
     delete(pos: number, len: number): void;
     subscribe(txn: Loro, listener: Listener): number;
   }
 
   interface LoroMap<T extends Record<string, any> = Record<string, any>> {
-    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;
+    getOrCreateContainer(key: string, container_type: "Map"): LoroMap;
+    getOrCreateContainer(key: string, container_type: "List"): LoroList;
+    getOrCreateContainer(key: string, container_type: "Text"): LoroText;
+    getOrCreateContainer(key: string, container_type: "Tree"): LoroTree;
+    getOrCreateContainer(key: string, container_type: string): never;
+
+    setContainer<C extends Container>(key: string, child: C): C;
 
     get(key: string): undefined | Value | Container;
     getTyped<Key extends keyof T & string>(txn: Loro, key: Key): T[Key];
@@ -241,7 +249,7 @@ declare module "loro-wasm" {
     subscribe(txn: Loro, listener: Listener): number;
   }
 
-  interface LoroTreeNode{
+  interface LoroTreeNode {
     readonly data: LoroMap;
     createNode(): LoroTreeNode;
     setAsRoot(): void;

package/tsconfig.json

@@ -1,7 +1,6 @@
 {
   "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. */
@@ -9,7 +8,6 @@
     // "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. */
@@ -23,7 +21,6 @@
     // "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. */
@@ -42,12 +39,10 @@
     // "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. */
@@ -55,7 +50,7 @@
     // "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. */
+    "outDir": "./dist", /* 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. */
@@ -72,7 +67,6 @@
     // "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. */
@@ -80,7 +74,6 @@
     "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. */
@@ -101,7 +94,6 @@
     // "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. */