loro-crdt 1.10.1 → 1.10.3

package/base64/loro_wasm.d.ts

@@ -1,5 +1,14 @@
 /* tslint:disable */
 /* eslint-disable */
+/**
+ * Get the version of Loro
+ */
+export function LORO_VERSION(): string;
+/**
+ * Enable debug info of Loro
+ */
+export function setDebug(): void;
+export function encodeFrontiers(frontiers: ({ peer: PeerID, counter: number })[]): Uint8Array;
 /**
  * Redacts sensitive content in JSON updates within the specified version range.
  *
@@ -20,6 +29,9 @@
  * @returns {Object} The redacted JSON updates
  */
 export function redactJsonUpdates(json_updates: string | JsonSchema, version_range: any): JsonSchema;
+export function callPendingEvents(): void;
+export function run(): void;
+export function decodeFrontiers(bytes: Uint8Array): { peer: PeerID, counter: number }[];
 /**
  * Decode the metadata of the import blob.
  *
@@ -33,18 +45,6 @@ export function redactJsonUpdates(json_updates: string | JsonSchema, version_ran
  * - changeNum
  */
 export function decodeImportBlobMeta(blob: Uint8Array, check_checksum: boolean): ImportBlobMetadata;
-export function decodeFrontiers(bytes: Uint8Array): { peer: PeerID, counter: number }[];
-export function run(): void;
-export function encodeFrontiers(frontiers: ({ peer: PeerID, counter: number })[]): Uint8Array;
-/**
- * Enable debug info of Loro
- */
-export function setDebug(): void;
-export function callPendingEvents(): void;
-/**
- * Get the version of Loro
- */
-export function LORO_VERSION(): string;
 
 /**
 * Container types supported by loro.
@@ -63,6 +63,7 @@ export function LORO_VERSION(): string;
 export type ContainerType = "Text" | "Map" | "List"| "Tree" | "MovableList" | "Counter";
 
 export type PeerID = `${number}`;
+export type TextPosType = "unicode" | "utf16" | "utf8";
 /**
 * The unique id of each container.
 *
@@ -338,7 +339,7 @@ interface LoroDoc {
 export type Delta<T> =
   | {
     insert: T;
-    attributes?: { [key in string]: {} };
+    attributes?: { [key in string]: Value };
     retain?: undefined;
     delete?: undefined;
   }
@@ -350,7 +351,7 @@ export type Delta<T> =
   }
   | {
     retain: number;
-    attributes?: { [key in string]: {} };
+    attributes?: { [key in string]: Value };
     delete?: undefined;
     insert?: undefined;
   };
@@ -450,6 +451,11 @@ export interface ImportBlobMetadata {
 }
 
 interface LoroText {
+    /**
+     * Convert a position between coordinate systems.
+     */
+    convertPos(index: number, from: TextPosType, to: TextPosType): number | undefined;
+
     /**
      * Get the cursor position at the given pos.
      *
@@ -868,6 +874,12 @@ interface Listener {
 
 interface LoroDoc {
     subscribe(listener: Listener): Subscription;
+    /**
+     * Subscribe to changes that may affect a JSONPath query.
+     * Callback may fire false positives and carries no query result.
+     * You can debounce/throttle the callback before running `JSONPath(...)` to optimize heavy reads.
+     */
+    subscribeJsonpath(path: string, callback: () => void): Subscription;
 }
 
 interface UndoManager {
@@ -905,6 +917,12 @@ interface UndoManager {
     groupEnd(): void;
 }
 interface LoroDoc<T extends Record<string, Container> = Record<string, Container>> {
+    /**
+     * Subscribe to changes that may affect a JSONPath query.
+     * Callback may fire false positives and carries no query result.
+     * You can debounce/throttle the callback before running `JSONPath(...)` to optimize heavy reads.
+     */
+    subscribeJsonpath(path: string, callback: () => void): Subscription;
     /**
      * Get a LoroMap by container id
      *
@@ -1264,6 +1282,10 @@ interface LoroText {
     insert(pos: number, text: string): void;
     delete(pos: number, len: number): void;
     subscribe(listener: Listener): Subscription;
+    /**
+     * Convert a position between coordinate systems.
+     */
+    convertPos(index: number, from: TextPosType, to: TextPosType): number | undefined;
     /**
      * Update the current text to the target text.
      *
@@ -3035,6 +3057,14 @@ export class LoroText {
    * ```
    */
   applyDelta(delta: Delta<string>[]): void;
+  /**
+   * Convert a position between coordinate systems.
+   *
+   * Supported values: `"unicode"`, `"utf16"`, `"utf8"`.
+   *
+   * Returns `undefined` when out of bounds or unsupported.
+   */
+  convertPos(index: number, from: string, to: string): any;
   /**
    * Delete elements from index to utf-8 index + len
    *

package/bundler/loro_wasm.d.ts

@@ -1,5 +1,14 @@
 /* tslint:disable */
 /* eslint-disable */
+/**
+ * Get the version of Loro
+ */
+export function LORO_VERSION(): string;
+/**
+ * Enable debug info of Loro
+ */
+export function setDebug(): void;
+export function encodeFrontiers(frontiers: ({ peer: PeerID, counter: number })[]): Uint8Array;
 /**
  * Redacts sensitive content in JSON updates within the specified version range.
  *
@@ -20,6 +29,9 @@
  * @returns {Object} The redacted JSON updates
  */
 export function redactJsonUpdates(json_updates: string | JsonSchema, version_range: any): JsonSchema;
+export function callPendingEvents(): void;
+export function run(): void;
+export function decodeFrontiers(bytes: Uint8Array): { peer: PeerID, counter: number }[];
 /**
  * Decode the metadata of the import blob.
  *
@@ -33,18 +45,6 @@ export function redactJsonUpdates(json_updates: string | JsonSchema, version_ran
  * - changeNum
  */
 export function decodeImportBlobMeta(blob: Uint8Array, check_checksum: boolean): ImportBlobMetadata;
-export function decodeFrontiers(bytes: Uint8Array): { peer: PeerID, counter: number }[];
-export function run(): void;
-export function encodeFrontiers(frontiers: ({ peer: PeerID, counter: number })[]): Uint8Array;
-/**
- * Enable debug info of Loro
- */
-export function setDebug(): void;
-export function callPendingEvents(): void;
-/**
- * Get the version of Loro
- */
-export function LORO_VERSION(): string;
 
 /**
 * Container types supported by loro.
@@ -63,6 +63,7 @@ export function LORO_VERSION(): string;
 export type ContainerType = "Text" | "Map" | "List"| "Tree" | "MovableList" | "Counter";
 
 export type PeerID = `${number}`;
+export type TextPosType = "unicode" | "utf16" | "utf8";
 /**
 * The unique id of each container.
 *
@@ -338,7 +339,7 @@ interface LoroDoc {
 export type Delta<T> =
   | {
     insert: T;
-    attributes?: { [key in string]: {} };
+    attributes?: { [key in string]: Value };
     retain?: undefined;
     delete?: undefined;
   }
@@ -350,7 +351,7 @@ export type Delta<T> =
   }
   | {
     retain: number;
-    attributes?: { [key in string]: {} };
+    attributes?: { [key in string]: Value };
     delete?: undefined;
     insert?: undefined;
   };
@@ -450,6 +451,11 @@ export interface ImportBlobMetadata {
 }
 
 interface LoroText {
+    /**
+     * Convert a position between coordinate systems.
+     */
+    convertPos(index: number, from: TextPosType, to: TextPosType): number | undefined;
+
     /**
      * Get the cursor position at the given pos.
      *
@@ -868,6 +874,12 @@ interface Listener {
 
 interface LoroDoc {
     subscribe(listener: Listener): Subscription;
+    /**
+     * Subscribe to changes that may affect a JSONPath query.
+     * Callback may fire false positives and carries no query result.
+     * You can debounce/throttle the callback before running `JSONPath(...)` to optimize heavy reads.
+     */
+    subscribeJsonpath(path: string, callback: () => void): Subscription;
 }
 
 interface UndoManager {
@@ -905,6 +917,12 @@ interface UndoManager {
     groupEnd(): void;
 }
 interface LoroDoc<T extends Record<string, Container> = Record<string, Container>> {
+    /**
+     * Subscribe to changes that may affect a JSONPath query.
+     * Callback may fire false positives and carries no query result.
+     * You can debounce/throttle the callback before running `JSONPath(...)` to optimize heavy reads.
+     */
+    subscribeJsonpath(path: string, callback: () => void): Subscription;
     /**
      * Get a LoroMap by container id
      *
@@ -1264,6 +1282,10 @@ interface LoroText {
     insert(pos: number, text: string): void;
     delete(pos: number, len: number): void;
     subscribe(listener: Listener): Subscription;
+    /**
+     * Convert a position between coordinate systems.
+     */
+    convertPos(index: number, from: TextPosType, to: TextPosType): number | undefined;
     /**
      * Update the current text to the target text.
      *
@@ -3035,6 +3057,14 @@ export class LoroText {
    * ```
    */
   applyDelta(delta: Delta<string>[]): void;
+  /**
+   * Convert a position between coordinate systems.
+   *
+   * Supported values: `"unicode"`, `"utf16"`, `"utf8"`.
+   *
+   * Returns `undefined` when out of bounds or unsupported.
+   */
+  convertPos(index: number, from: string, to: string): any;
   /**
    * Delete elements from index to utf-8 index + len
    *

package/bundler/loro_wasm_bg.js

@@ -240,6 +240,55 @@ function getArrayJsValueFromWasm0(ptr, len) {
     wasm.__externref_drop_slice(ptr, len);
     return result;
 }
+/**
+ * Get the version of Loro
+ * @returns {string}
+ */
+export function LORO_VERSION() {
+    let deferred1_0;
+    let deferred1_1;
+    try {
+        const ret = wasm.LORO_VERSION();
+        deferred1_0 = ret[0];
+        deferred1_1 = ret[1];
+        return getStringFromWasm0(ret[0], ret[1]);
+    } finally {
+        wasm.__wbindgen_free(deferred1_0, deferred1_1, 1);
+    }
+}
+
+/**
+ * Enable debug info of Loro
+ */
+export function setDebug() {
+    wasm.setDebug();
+}
+
+function passArrayJsValueToWasm0(array, malloc) {
+    const ptr = malloc(array.length * 4, 4) >>> 0;
+    for (let i = 0; i < array.length; i++) {
+        const add = addToExternrefTable0(array[i]);
+        getDataViewMemory0().setUint32(ptr + 4 * i, add, true);
+    }
+    WASM_VECTOR_LEN = array.length;
+    return ptr;
+}
+/**
+ * @param {({ peer: PeerID, counter: number })[]} frontiers
+ * @returns {Uint8Array}
+ */
+export function encodeFrontiers(frontiers) {
+    const ptr0 = passArrayJsValueToWasm0(frontiers, wasm.__wbindgen_malloc);
+    const len0 = WASM_VECTOR_LEN;
+    const ret = wasm.encodeFrontiers(ptr0, len0);
+    if (ret[3]) {
+        throw takeFromExternrefTable0(ret[2]);
+    }
+    var v2 = getArrayU8FromWasm0(ret[0], ret[1]).slice();
+    wasm.__wbindgen_free(ret[0], ret[1] * 1, 1);
+    return v2;
+}
+
 /**
  * Redacts sensitive content in JSON updates within the specified version range.
  *
@@ -270,6 +319,28 @@ export function redactJsonUpdates(json_updates, version_range) {
     return takeFromExternrefTable0(ret[0]);
 }
 
+export function callPendingEvents() {
+    wasm.callPendingEvents();
+}
+
+export function run() {
+    wasm.run();
+}
+
+/**
+ * @param {Uint8Array} bytes
+ * @returns {{ peer: PeerID, counter: number }[]}
+ */
+export function decodeFrontiers(bytes) {
+    const ptr0 = passArray8ToWasm0(bytes, wasm.__wbindgen_malloc);
+    const len0 = WASM_VECTOR_LEN;
+    const ret = wasm.decodeFrontiers(ptr0, len0);
+    if (ret[2]) {
+        throw takeFromExternrefTable0(ret[1]);
+    }
+    return takeFromExternrefTable0(ret[0]);
+}
+
 /**
  * Decode the metadata of the import blob.
  *
@@ -295,83 +366,12 @@ export function decodeImportBlobMeta(blob, check_checksum) {
     return takeFromExternrefTable0(ret[0]);
 }
 
-/**
- * @param {Uint8Array} bytes
- * @returns {{ peer: PeerID, counter: number }[]}
- */
-export function decodeFrontiers(bytes) {
-    const ptr0 = passArray8ToWasm0(bytes, wasm.__wbindgen_malloc);
-    const len0 = WASM_VECTOR_LEN;
-    const ret = wasm.decodeFrontiers(ptr0, len0);
-    if (ret[2]) {
-        throw takeFromExternrefTable0(ret[1]);
-    }
-    return takeFromExternrefTable0(ret[0]);
-}
-
-export function run() {
-    wasm.run();
-}
-
-function passArrayJsValueToWasm0(array, malloc) {
-    const ptr = malloc(array.length * 4, 4) >>> 0;
-    for (let i = 0; i < array.length; i++) {
-        const add = addToExternrefTable0(array[i]);
-        getDataViewMemory0().setUint32(ptr + 4 * i, add, true);
-    }
-    WASM_VECTOR_LEN = array.length;
-    return ptr;
-}
-/**
- * @param {({ peer: PeerID, counter: number })[]} frontiers
- * @returns {Uint8Array}
- */
-export function encodeFrontiers(frontiers) {
-    const ptr0 = passArrayJsValueToWasm0(frontiers, wasm.__wbindgen_malloc);
-    const len0 = WASM_VECTOR_LEN;
-    const ret = wasm.encodeFrontiers(ptr0, len0);
-    if (ret[3]) {
-        throw takeFromExternrefTable0(ret[2]);
-    }
-    var v2 = getArrayU8FromWasm0(ret[0], ret[1]).slice();
-    wasm.__wbindgen_free(ret[0], ret[1] * 1, 1);
-    return v2;
-}
-
-/**
- * Enable debug info of Loro
- */
-export function setDebug() {
-    wasm.setDebug();
-}
-
-export function callPendingEvents() {
-    wasm.callPendingEvents();
-}
-
-/**
- * Get the version of Loro
- * @returns {string}
- */
-export function LORO_VERSION() {
-    let deferred1_0;
-    let deferred1_1;
-    try {
-        const ret = wasm.LORO_VERSION();
-        deferred1_0 = ret[0];
-        deferred1_1 = ret[1];
-        return getStringFromWasm0(ret[0], ret[1]);
-    } finally {
-        wasm.__wbindgen_free(deferred1_0, deferred1_1, 1);
-    }
-}
-
 function __wbg_adapter_62(arg0, arg1, arg2) {
-    wasm.closure11_externref_shim(arg0, arg1, arg2);
+    wasm.closure9_externref_shim(arg0, arg1, arg2);
 }
 
 function __wbg_adapter_65(arg0, arg1) {
-    wasm._dyn_core__ops__function__FnMut_____Output___R_as_wasm_bindgen__closure__WasmClosure___describe__invoke__hb782650185ad08f4(arg0, arg1);
+    wasm._dyn_core__ops__function__FnMut_____Output___R_as_wasm_bindgen__closure__WasmClosure___describe__invoke__h2222385ed10d04df(arg0, arg1);
 }
 
 const AwarenessWasmFinalization = (typeof FinalizationRegistry === 'undefined')
@@ -1655,6 +1655,25 @@ export class LoroDoc {
         }
         return takeFromExternrefTable0(ret[0]);
     }
+    /**
+     * Subscribe to changes that may affect a JSONPath query.
+     *
+     * The callback receives no query result; it is a lightweight notifier and may
+     * fire false positives so callers can debounce/throttle before running JSONPath
+     * themselves.
+     * @param {string} jsonpath
+     * @param {Function} f
+     * @returns {any}
+     */
+    subscribeJsonpath(jsonpath, f) {
+        const ptr0 = passStringToWasm0(jsonpath, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len0 = WASM_VECTOR_LEN;
+        const ret = wasm.lorodoc_subscribeJsonpath(this.__wbg_ptr, ptr0, len0, f);
+        if (ret[2]) {
+            throw takeFromExternrefTable0(ret[1]);
+        }
+        return takeFromExternrefTable0(ret[0]);
+    }
     /**
      * Delete all content from a root container and hide it from the document.
      *
@@ -3903,6 +3922,25 @@ export class LoroText {
             throw takeFromExternrefTable0(ret[0]);
         }
     }
+    /**
+     * Convert a position between coordinate systems.
+     *
+     * Supported values: `"unicode"`, `"utf16"`, `"utf8"`.
+     *
+     * Returns `undefined` when out of bounds or unsupported.
+     * @param {number} index
+     * @param {string} from
+     * @param {string} to
+     * @returns {any}
+     */
+    convertPos(index, from, to) {
+        const ptr0 = passStringToWasm0(from, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len0 = WASM_VECTOR_LEN;
+        const ptr1 = passStringToWasm0(to, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len1 = WASM_VECTOR_LEN;
+        const ret = wasm.lorotext_convertPos(this.__wbg_ptr, index, ptr0, len0, ptr1, len1);
+        return ret;
+    }
     /**
      * Delete elements from index to utf-8 index + len
      *
@@ -5521,7 +5559,7 @@ export function __wbg_error_7534b8e9a36f1ab4(arg0, arg1) {
     }
 };
 
-export function __wbg_error_f6ddbf3300c73fe1(arg0, arg1) {
+export function __wbg_error_ec1c81ec21690870(arg0, arg1) {
     console.error(getStringFromWasm0(arg0, arg1));
 };
 
@@ -5640,7 +5678,7 @@ export function __wbg_log_0cc1b7768397bcfe(arg0, arg1, arg2, arg3, arg4, arg5, a
     }
 };
 
-export function __wbg_log_3c0d0f235e1c209c(arg0, arg1) {
+export function __wbg_log_8c0006defd0ef388(arg0, arg1) {
     console.log(getStringFromWasm0(arg0, arg1));
 };
 
@@ -5777,7 +5815,7 @@ export function __wbg_node_905d3e251edff8a2(arg0) {
     return ret;
 };
 
-export function __wbg_now_d256cd3265ccdaa6() {
+export function __wbg_now_8a87c5466cc7d560() {
     const ret = Date.now();
     return ret;
 };
@@ -5890,7 +5928,7 @@ export function __wbg_versionvector_new(arg0) {
     return ret;
 };
 
-export function __wbg_warn_e3fad33818dd84d2(arg0, arg1) {
+export function __wbg_warn_6a7b1c2df711ad0a(arg0, arg1) {
     console.warn(getStringFromWasm0(arg0, arg1));
 };
 

package/bundler/loro_wasm_bg.wasm.d.ts

@@ -134,6 +134,7 @@ export const lorodoc_shallowSinceFrontiers: (a: number) => [number, number, numb
 export const lorodoc_shallowSinceVV: (a: number) => number;
 export const lorodoc_subscribe: (a: number, b: any) => any;
 export const lorodoc_subscribeFirstCommitFromPeer: (a: number, b: any) => any;
+export const lorodoc_subscribeJsonpath: (a: number, b: number, c: number, d: any) => [number, number, number];
 export const lorodoc_subscribeLocalUpdates: (a: number, b: any) => any;
 export const lorodoc_subscribePreCommit: (a: number, b: any) => any;
 export const lorodoc_toJSON: (a: number) => [number, number, number];
@@ -212,6 +213,7 @@ export const loromovablelist_toArray: (a: number) => [number, number];
 export const loromovablelist_toJSON: (a: number) => any;
 export const lorotext_applyDelta: (a: number, b: any) => [number, number];
 export const lorotext_charAt: (a: number, b: number) => [number, number, number];
+export const lorotext_convertPos: (a: number, b: number, c: number, d: number, e: number, f: number) => any;
 export const lorotext_delete: (a: number, b: number, c: number) => [number, number];
 export const lorotext_deleteUtf8: (a: number, b: number, c: number) => [number, number];
 export const lorotext_getAttached: (a: number) => any;
@@ -323,6 +325,6 @@ export const __wbindgen_free: (a: number, b: number, c: number) => void;
 export const __wbindgen_export_6: WebAssembly.Table;
 export const __externref_table_dealloc: (a: number) => void;
 export const __externref_drop_slice: (a: number, b: number) => void;
-export const closure11_externref_shim: (a: number, b: number, c: any) => void;
-export const _dyn_core__ops__function__FnMut_____Output___R_as_wasm_bindgen__closure__WasmClosure___describe__invoke__hb782650185ad08f4: (a: number, b: number) => void;
+export const closure9_externref_shim: (a: number, b: number, c: any) => void;
+export const _dyn_core__ops__function__FnMut_____Output___R_as_wasm_bindgen__closure__WasmClosure___describe__invoke__h2222385ed10d04df: (a: number, b: number) => void;
 export const __wbindgen_start: () => void;

package/nodejs/loro_wasm.d.ts

@@ -1,5 +1,14 @@
 /* tslint:disable */
 /* eslint-disable */
+/**
+ * Get the version of Loro
+ */
+export function LORO_VERSION(): string;
+/**
+ * Enable debug info of Loro
+ */
+export function setDebug(): void;
+export function encodeFrontiers(frontiers: ({ peer: PeerID, counter: number })[]): Uint8Array;
 /**
  * Redacts sensitive content in JSON updates within the specified version range.
  *
@@ -20,6 +29,9 @@
  * @returns {Object} The redacted JSON updates
  */
 export function redactJsonUpdates(json_updates: string | JsonSchema, version_range: any): JsonSchema;
+export function callPendingEvents(): void;
+export function run(): void;
+export function decodeFrontiers(bytes: Uint8Array): { peer: PeerID, counter: number }[];
 /**
  * Decode the metadata of the import blob.
  *
@@ -33,18 +45,6 @@ export function redactJsonUpdates(json_updates: string | JsonSchema, version_ran
  * - changeNum
  */
 export function decodeImportBlobMeta(blob: Uint8Array, check_checksum: boolean): ImportBlobMetadata;
-export function decodeFrontiers(bytes: Uint8Array): { peer: PeerID, counter: number }[];
-export function run(): void;
-export function encodeFrontiers(frontiers: ({ peer: PeerID, counter: number })[]): Uint8Array;
-/**
- * Enable debug info of Loro
- */
-export function setDebug(): void;
-export function callPendingEvents(): void;
-/**
- * Get the version of Loro
- */
-export function LORO_VERSION(): string;
 
 /**
 * Container types supported by loro.
@@ -63,6 +63,7 @@ export function LORO_VERSION(): string;
 export type ContainerType = "Text" | "Map" | "List"| "Tree" | "MovableList" | "Counter";
 
 export type PeerID = `${number}`;
+export type TextPosType = "unicode" | "utf16" | "utf8";
 /**
 * The unique id of each container.
 *
@@ -338,7 +339,7 @@ interface LoroDoc {
 export type Delta<T> =
   | {
     insert: T;
-    attributes?: { [key in string]: {} };
+    attributes?: { [key in string]: Value };
     retain?: undefined;
     delete?: undefined;
   }
@@ -350,7 +351,7 @@ export type Delta<T> =
   }
   | {
     retain: number;
-    attributes?: { [key in string]: {} };
+    attributes?: { [key in string]: Value };
     delete?: undefined;
     insert?: undefined;
   };
@@ -450,6 +451,11 @@ export interface ImportBlobMetadata {
 }
 
 interface LoroText {
+    /**
+     * Convert a position between coordinate systems.
+     */
+    convertPos(index: number, from: TextPosType, to: TextPosType): number | undefined;
+
     /**
      * Get the cursor position at the given pos.
      *
@@ -868,6 +874,12 @@ interface Listener {
 
 interface LoroDoc {
     subscribe(listener: Listener): Subscription;
+    /**
+     * Subscribe to changes that may affect a JSONPath query.
+     * Callback may fire false positives and carries no query result.
+     * You can debounce/throttle the callback before running `JSONPath(...)` to optimize heavy reads.
+     */
+    subscribeJsonpath(path: string, callback: () => void): Subscription;
 }
 
 interface UndoManager {
@@ -905,6 +917,12 @@ interface UndoManager {
     groupEnd(): void;
 }
 interface LoroDoc<T extends Record<string, Container> = Record<string, Container>> {
+    /**
+     * Subscribe to changes that may affect a JSONPath query.
+     * Callback may fire false positives and carries no query result.
+     * You can debounce/throttle the callback before running `JSONPath(...)` to optimize heavy reads.
+     */
+    subscribeJsonpath(path: string, callback: () => void): Subscription;
     /**
      * Get a LoroMap by container id
      *
@@ -1264,6 +1282,10 @@ interface LoroText {
     insert(pos: number, text: string): void;
     delete(pos: number, len: number): void;
     subscribe(listener: Listener): Subscription;
+    /**
+     * Convert a position between coordinate systems.
+     */
+    convertPos(index: number, from: TextPosType, to: TextPosType): number | undefined;
     /**
      * Update the current text to the target text.
      *
@@ -3035,6 +3057,14 @@ export class LoroText {
    * ```
    */
   applyDelta(delta: Delta<string>[]): void;
+  /**
+   * Convert a position between coordinate systems.
+   *
+   * Supported values: `"unicode"`, `"utf16"`, `"utf8"`.
+   *
+   * Returns `undefined` when out of bounds or unsupported.
+   */
+  convertPos(index: number, from: string, to: string): any;
   /**
    * Delete elements from index to utf-8 index + len
    *