lib0 0.2.112 → 0.2.115-0

package/crypto/aes-gcm.js

@@ -19,7 +19,7 @@ const defaultUsages = ['encrypt', 'decrypt']
 
 /**
  * @param {CryptoKey} key
- * @param {Uint8Array} data
+ * @param {Uint8Array<ArrayBuffer>} data
  */
 export const encrypt = (key, data) => {
   const iv = webcrypto.getRandomValues(new Uint8Array(16)) // 92bit is enough. 128bit is recommended if space is not an issue.
@@ -45,7 +45,7 @@ export const encrypt = (key, data) => {
  * Decrypt some data using AES-GCM method.
  *
  * @param {CryptoKey} key
- * @param {Uint8Array} data
+ * @param {Uint8Array<ArrayBuffer>} data
  * @return {PromiseLike<Uint8Array>} decrypted buffer
  */
 export const decrypt = (key, data) => {
@@ -84,7 +84,7 @@ export const importKeyJwk = (jwk, { usages, extractable = false } = {}) => {
 /**
  * Only suited for importing public keys.
  *
- * @param {Uint8Array} raw
+ * @param {Uint8Array<ArrayBuffer>} raw
  * @param {Object} opts
  * @param {Usages} [opts.usages]
  * @param {boolean} [opts.extractable]
@@ -93,7 +93,7 @@ export const importKeyRaw = (raw, { usages = defaultUsages, extractable = false
   webcrypto.subtle.importKey('raw', raw, aesAlgDef, extractable, /** @type {Usages} */ (usages))
 
 /**
- * @param {Uint8Array | string} data
+ * @param {Uint8Array<ArrayBuffer> | string} data
  */
 /* c8 ignore next */
 const toBinary = data => typeof data === 'string' ? string.encodeUtf8(data) : data
@@ -103,8 +103,8 @@ const toBinary = data => typeof data === 'string' ? string.encodeUtf8(data) : da
  *
  * Derive an symmetric key using the Password-Based-Key-Derivation-Function-2.
  *
- * @param {Uint8Array|string} secret
- * @param {Uint8Array|string} salt
+ * @param {Uint8Array<ArrayBuffer>|string} secret
+ * @param {Uint8Array<ArrayBuffer>|string} salt
  * @param {Object} opts
  * @param {boolean} [opts.extractable]
  * @param {Usages} [opts.usages]

package/crypto/common.d.ts

@@ -1,3 +1,3 @@
 export function exportKeyJwk(key: CryptoKey): Promise<JsonWebKey>;
-export function exportKeyRaw(key: CryptoKey): Promise<Uint8Array>;
+export function exportKeyRaw(key: CryptoKey): Promise<Uint8Array<ArrayBuffer>>;
 //# sourceMappingURL=common.d.ts.map

package/crypto/common.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["common.js"],"names":[],"mappings":"AAKO,kCAFI,SAAS,uBAMnB;AAQM,kCAHI,SAAS,GACR,OAAO,CAAC,UAAU,CAAC,CAG0C"}
+{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["common.js"],"names":[],"mappings":"AAKO,kCAFI,SAAS,uBAMnB;AAQM,kCAHI,SAAS,GACR,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,CAG6B"}

package/crypto/common.js

@@ -13,7 +13,7 @@ export const exportKeyJwk = async key => {
  * Only suited for exporting public keys.
  *
  * @param {CryptoKey} key
- * @return {Promise<Uint8Array>}
+ * @return {Promise<Uint8Array<ArrayBuffer>>}
  */
 export const exportKeyRaw = key =>
   webcrypto.subtle.exportKey('raw', key).then(key => new Uint8Array(key))

package/crypto/ecdsa.d.ts

@@ -1,5 +1,5 @@
-export function sign(key: CryptoKey, data: Uint8Array): PromiseLike<Uint8Array>;
-export function verify(key: CryptoKey, signature: Uint8Array, data: Uint8Array): PromiseLike<boolean>;
+export function sign(key: CryptoKey, data: Uint8Array<ArrayBuffer>): PromiseLike<Uint8Array<ArrayBuffer>>;
+export function verify(key: CryptoKey, signature: Uint8Array<ArrayBuffer>, data: Uint8Array<ArrayBuffer>): PromiseLike<boolean>;
 export function generateKeyPair({ extractable, usages }?: {
     extractable?: boolean | undefined;
     usages?: Usages | undefined;

package/crypto/ecdsa.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ecdsa.d.ts","sourceRoot":"","sources":["ecdsa.js"],"names":[],"mappings":"AA8BO,0BAJI,SAAS,QACT,UAAU,GACT,WAAW,CAAC,UAAU,CAAC,CAOa;AAYzC,4BALI,SAAS,aACT,UAAU,QACV,UAAU,GACT,WAAW,CAAC,OAAO,CAAC,CAQ7B;AAaI,0DAHJ;IAAuB,WAAW;IACZ,MAAM;CAAC,0BAO7B;AAQI,kCALI,GAAG,4BAEX;IAAuB,WAAW;IACZ,MAAM;CAAC,sBAQ/B;AAUM,kCALI,GAAG,4BAEX;IAAuB,WAAW;IACZ,MAAM;CAAC,sBAGkD;qBAxFrE,KAAK,CAAC,MAAM,GAAC,QAAQ,CAAC"}
+{"version":3,"file":"ecdsa.d.ts","sourceRoot":"","sources":["ecdsa.js"],"names":[],"mappings":"AA8BO,0BAJI,SAAS,QACT,UAAU,CAAC,WAAW,CAAC,GACtB,WAAW,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,CAOA;AAYzC,4BALI,SAAS,aACT,UAAU,CAAC,WAAW,CAAC,QACvB,UAAU,CAAC,WAAW,CAAC,GACtB,WAAW,CAAC,OAAO,CAAC,CAQ7B;AAaI,0DAHJ;IAAuB,WAAW;IACZ,MAAM;CAAC,0BAO7B;AAQI,kCALI,GAAG,4BAEX;IAAuB,WAAW;IACZ,MAAM;CAAC,sBAQ/B;AAUM,kCALI,GAAG,4BAEX;IAAuB,WAAW;IACZ,MAAM;CAAC,sBAGkD;qBAxFrE,KAAK,CAAC,MAAM,GAAC,QAAQ,CAAC"}

package/crypto/ecdsa.js

@@ -25,8 +25,8 @@ const defaultSignAlgorithm = {
  * Sign a message
  *
  * @param {CryptoKey} key
- * @param {Uint8Array} data
- * @return {PromiseLike<Uint8Array>} signature
+ * @param {Uint8Array<ArrayBuffer>} data
+ * @return {PromiseLike<Uint8Array<ArrayBuffer>>} signature
  */
 export const sign = (key, data) =>
   webcrypto.subtle.sign(
@@ -41,8 +41,8 @@ export const sign = (key, data) =>
  * Sign a message
  *
  * @param {CryptoKey} key
- * @param {Uint8Array} signature
- * @param {Uint8Array} data
+ * @param {Uint8Array<ArrayBuffer>} signature
+ * @param {Uint8Array<ArrayBuffer>} data
  * @return {PromiseLike<boolean>} signature
  */
 export const verify = (key, signature, data) =>

package/crypto/rsa-oaep.d.ts

@@ -1,6 +1,6 @@
 export { exportKeyJwk } from "./common.js";
-export function encrypt(key: CryptoKey, data: Uint8Array): PromiseLike<Uint8Array>;
-export function decrypt(key: CryptoKey, data: Uint8Array): PromiseLike<Uint8Array>;
+export function encrypt(key: CryptoKey, data: Uint8Array<ArrayBuffer>): PromiseLike<Uint8Array<ArrayBuffer>>;
+export function decrypt(key: CryptoKey, data: Uint8Array<ArrayBuffer>): PromiseLike<Uint8Array>;
 export function generateKeyPair({ extractable, usages }?: {
     extractable?: boolean | undefined;
     usages?: Usages | undefined;

package/crypto/rsa-oaep.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rsa-oaep.d.ts","sourceRoot":"","sources":["rsa-oaep.js"],"names":[],"mappings":";AAuBO,6BAJI,SAAS,QACT,UAAU,GACT,WAAW,CAAC,UAAU,CAAC,CASC;AAW7B,6BAJI,SAAS,QACT,UAAU,GACT,WAAW,CAAC,UAAU,CAAC,CASG;AAQ/B,0DAJJ;IAAuB,WAAW;IACZ,MAAM;CAC5B,GAAS,OAAO,CAAC,aAAa,CAAC,CAY/B;AAQI,kCALI,GAAG,4BAEX;IAAuB,WAAW;IACZ,MAAM;CAAC,sBAQ/B;qBAxEY,KAAK,CAAC,SAAS,GAAC,SAAS,CAAC"}
+{"version":3,"file":"rsa-oaep.d.ts","sourceRoot":"","sources":["rsa-oaep.js"],"names":[],"mappings":";AAuBO,6BAJI,SAAS,QACT,UAAU,CAAC,WAAW,CAAC,GACtB,WAAW,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,CASZ;AAW7B,6BAJI,SAAS,QACT,UAAU,CAAC,WAAW,CAAC,GACtB,WAAW,CAAC,UAAU,CAAC,CASG;AAQ/B,0DAJJ;IAAuB,WAAW;IACZ,MAAM;CAC5B,GAAS,OAAO,CAAC,aAAa,CAAC,CAY/B;AAQI,kCALI,GAAG,4BAEX;IAAuB,WAAW;IACZ,MAAM;CAAC,sBAQ/B;qBAxEY,KAAK,CAAC,SAAS,GAAC,SAAS,CAAC"}

package/crypto/rsa-oaep.js

@@ -18,8 +18,8 @@ const defaultUsages = ['encrypt', 'decrypt']
  * Note that the max data size is limited by the size of the RSA key.
  *
  * @param {CryptoKey} key
- * @param {Uint8Array} data
- * @return {PromiseLike<Uint8Array>}
+ * @param {Uint8Array<ArrayBuffer>} data
+ * @return {PromiseLike<Uint8Array<ArrayBuffer>>}
  */
 export const encrypt = (key, data) =>
   webcrypto.subtle.encrypt(
@@ -36,7 +36,7 @@ export const encrypt = (key, data) =>
  * Decrypt some data using AES-GCM method.
  *
  * @param {CryptoKey} key
- * @param {Uint8Array} data
+ * @param {Uint8Array<ArrayBuffer>} data
  * @return {PromiseLike<Uint8Array>} decrypted buffer
  */
 export const decrypt = (key, data) =>

package/decoding.d.ts

@@ -1,17 +1,18 @@
 /**
  * A Decoder handles the decoding of an Uint8Array.
+ * @template {ArrayBufferLike} [Buf=ArrayBufferLike]
  */
-export class Decoder {
+export class Decoder<Buf extends ArrayBufferLike = ArrayBufferLike> {
     /**
-     * @param {Uint8Array} uint8Array Binary data to decode
+     * @param {Uint8Array<Buf>} uint8Array Binary data to decode
      */
-    constructor(uint8Array: Uint8Array);
+    constructor(uint8Array: Uint8Array<Buf>);
     /**
      * Decoding target.
      *
-     * @type {Uint8Array}
+     * @type {Uint8Array<Buf>}
      */
-    arr: Uint8Array;
+    arr: Uint8Array<Buf>;
     /**
      * Current decoding position.
      *
@@ -19,11 +20,11 @@ export class Decoder {
      */
     pos: number;
 }
-export function createDecoder(uint8Array: Uint8Array): Decoder;
+export function createDecoder<Buf extends ArrayBufferLike>(uint8Array: Uint8Array<Buf>): Decoder<Buf>;
 export function hasContent(decoder: Decoder): boolean;
 export function clone(decoder: Decoder, newPos?: number): Decoder;
-export function readUint8Array(decoder: Decoder, len: number): Uint8Array;
-export function readVarUint8Array(decoder: Decoder): Uint8Array;
+export function readUint8Array<Buf extends ArrayBufferLike>(decoder: Decoder<Buf>, len: number): Uint8Array<Buf>;
+export function readVarUint8Array<Buf extends ArrayBufferLike>(decoder: Decoder<Buf>): Uint8Array<Buf>;
 export function readTailAsUint8Array(decoder: Decoder): Uint8Array;
 export function skip8(decoder: Decoder): number;
 export function readUint8(decoder: Decoder): number;
@@ -54,7 +55,7 @@ export function readAny(decoder: Decoder): any;
  *
  * @template T
  */
-export class RleDecoder<T> extends Decoder {
+export class RleDecoder<T> extends Decoder<ArrayBufferLike> {
     /**
      * @param {Uint8Array} uint8Array
      * @param {function(Decoder):T} reader
@@ -72,7 +73,7 @@ export class RleDecoder<T> extends Decoder {
     count: number;
     read(): T;
 }
-export class IntDiffDecoder extends Decoder {
+export class IntDiffDecoder extends Decoder<ArrayBufferLike> {
     /**
      * @param {Uint8Array} uint8Array
      * @param {number} start
@@ -88,7 +89,7 @@ export class IntDiffDecoder extends Decoder {
      */
     read(): number;
 }
-export class RleIntDiffDecoder extends Decoder {
+export class RleIntDiffDecoder extends Decoder<ArrayBufferLike> {
     /**
      * @param {Uint8Array} uint8Array
      * @param {number} start
@@ -105,7 +106,11 @@ export class RleIntDiffDecoder extends Decoder {
      */
     read(): number;
 }
-export class UintOptRleDecoder extends Decoder {
+export class UintOptRleDecoder extends Decoder<ArrayBufferLike> {
+    /**
+     * @param {Uint8Array} uint8Array
+     */
+    constructor(uint8Array: Uint8Array);
     /**
      * @type {number}
      */
@@ -113,7 +118,11 @@ export class UintOptRleDecoder extends Decoder {
     count: number;
     read(): number;
 }
-export class IncUintOptRleDecoder extends Decoder {
+export class IncUintOptRleDecoder extends Decoder<ArrayBufferLike> {
+    /**
+     * @param {Uint8Array} uint8Array
+     */
+    constructor(uint8Array: Uint8Array);
     /**
      * @type {number}
      */
@@ -121,7 +130,11 @@ export class IncUintOptRleDecoder extends Decoder {
     count: number;
     read(): number;
 }
-export class IntDiffOptRleDecoder extends Decoder {
+export class IntDiffOptRleDecoder extends Decoder<ArrayBufferLike> {
+    /**
+     * @param {Uint8Array} uint8Array
+     */
+    constructor(uint8Array: Uint8Array);
     /**
      * @type {number}
      */

package/decoding.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"decoding.d.ts","sourceRoot":"","sources":["decoding.js"],"names":[],"mappings":"AAsCA;;GAEG;AACH;IACE;;OAEG;IACH,wBAFW,UAAU,EAepB;IAZC;;;;OAIG;IACH,KAFU,UAAU,CAEC;IACrB;;;;OAIG;IACH,KAFU,MAAM,CAEJ;CAEf;AAOM,0CAHI,UAAU,GACT,OAAO,CAE+C;AAO3D,oCAHI,OAAO,GACN,OAAO,CAEoD;AAWhE,+BAJI,OAAO,WACP,MAAM,GACL,OAAO,CAMlB;AAaM,wCAJI,OAAO,OACP,MAAM,GACL,UAAU,CAMrB;AAYM,2CAHI,OAAO,GACN,UAAU,CAEmE;AAQlF,8CAHI,OAAO,GACN,UAAU,CAEkF;AAQjG,+BAHI,OAAO,GACN,MAAM,CAE2B;AAQtC,mCAHI,OAAO,GACN,MAAM,CAE4C;AASvD,oCAHI,OAAO,GACN,MAAM,CAQjB;AASM,oCAHI,OAAO,GACN,MAAM,CAUjB;AAUM,6CAHI,OAAO,GACN,MAAM,CAUjB;AAUM,mCAHI,OAAO,GACN,MAAM,CAE0C;AAUrD,oCAHI,OAAO,GACN,MAAM,CAImB;AAU9B,oCAHI,OAAO,GACN,MAAM,CAOX;AAYA,qCAHI,OAAO,GACN,MAAM,CAqBjB;AAaM,oCAHI,OAAO,GACN,MAAM,CA2BjB;AASM,qCAHI,OAAO,GACN,MAAM,CAOjB;AASM,oCAHI,OAAO,GACN,MAAM,CAOjB;AAgBM,gDAJI,OAAO,UA2BjB;AAQM,8CAHI,OAAO,UAI4D;AAhCvE,uCAJI,OAAO,UA2BjB;AA2BM,kDAHI,OAAO,GACN,UAAU,CAerB;AAMM,8CAHI,OAAO,GACN,MAAM,CAEiF;AAS5F,uCAHI,OAAO,GACN,MAAM,CAOjB;AAOM,0CAJI,OAAO,OACP,MAAM,GACL,QAAQ,CAMnB;AAKM,qCAFI,OAAO,UAEqE;AAKhF,qCAFI,OAAO,UAEqE;AAKhF,sCAFI,OAAO,OAE4F;AAKvG,uCAFI,OAAO,OAE8F;AAyCzG,iCAFI,OAAO,OAEqE;AAEvF;;;;GAIG;AACH,wBAFa,CAAC;IAGZ;;;OAGG;IACH,wBAHW,UAAU,UACV,CAAS,IAAO,EAAP,OAAO,KAAE,CAAC,EAc7B;IAVC;;OAEG;IACH,eAPkB,OAAO,KAAE,CAAC,CAOR;IACpB;;;OAGG;IACH,GAFU,CAAC,GAAC,IAAI,CAEH;IACb,cAAc;IAGhB,QAUoB,CAAC,CACpB;CACF;AAED;IACE;;;OAGG;IACH,wBAHW,UAAU,SACV,MAAM,EAShB;IALC;;;OAGG;IACH,GAFU,MAAM,CAEF;IAGhB;;OAEG;IACH,QAFY,MAAM,CAKjB;CACF;AAED;IACE;;;OAGG;IACH,wBAHW,UAAU,SACV,MAAM,EAUhB;IANC;;;OAGG;IACH,GAFU,MAAM,CAEF;IACd,cAAc;IAGhB;;OAEG;IACH,QAFY,MAAM,CAajB;CACF;AAED;IAMI;;OAEG;IACH,GAFU,MAAM,CAEN;IACV,cAAc;IAGhB,QAYoB,MAAM,CACzB;CACF;AAED;IAMI;;OAEG;IACH,GAFU,MAAM,CAEN;IACV,cAAc;IAGhB,QAYoB,MAAM,CACzB;CACF;AAED;IAMI;;OAEG;IACH,GAFU,MAAM,CAEN;IACV,cAAc;IACd,aAAa;IAGf;;OAEG;IACH,QAFY,MAAM,CAgBjB;CACF;AAED;IACE;;OAEG;IACH,wBAFW,UAAU,EASpB;IANC,2BAAgD;IAChD,YAAsC;IACtC;;OAEG;IACH,MAFU,MAAM,CAEH;IAGf;;OAEG;IACH,QAFY,MAAM,CAOjB;CACF"}
+{"version":3,"file":"decoding.d.ts","sourceRoot":"","sources":["decoding.js"],"names":[],"mappings":"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"}

package/decoding.js

@@ -38,16 +38,17 @@ const errorIntegerOutOfRange = error.create('Integer out of Range')
 
 /**
  * A Decoder handles the decoding of an Uint8Array.
+ * @template {ArrayBufferLike} [Buf=ArrayBufferLike]
  */
 export class Decoder {
   /**
-   * @param {Uint8Array} uint8Array Binary data to decode
+   * @param {Uint8Array<Buf>} uint8Array Binary data to decode
    */
   constructor (uint8Array) {
     /**
      * Decoding target.
      *
-     * @type {Uint8Array}
+     * @type {Uint8Array<Buf>}
      */
     this.arr = uint8Array
     /**
@@ -61,8 +62,9 @@ export class Decoder {
 
 /**
  * @function
- * @param {Uint8Array} uint8Array
- * @return {Decoder}
+ * @template {ArrayBufferLike} Buf
+ * @param {Uint8Array<Buf>} uint8Array
+ * @return {Decoder<Buf>}
  */
 export const createDecoder = uint8Array => new Decoder(uint8Array)
 
@@ -95,9 +97,10 @@ export const clone = (decoder, newPos = decoder.pos) => {
  *            Use `buffer.copyUint8Array` to copy the result into a new Uint8Array.
  *
  * @function
- * @param {Decoder} decoder The decoder instance
+ * @template {ArrayBufferLike} Buf
+ * @param {Decoder<Buf>} decoder The decoder instance
  * @param {number} len The length of bytes to read
- * @return {Uint8Array}
+ * @return {Uint8Array<Buf>}
  */
 export const readUint8Array = (decoder, len) => {
   const view = new Uint8Array(decoder.arr.buffer, decoder.pos + decoder.arr.byteOffset, len)
@@ -112,8 +115,9 @@ export const readUint8Array = (decoder, len) => {
  *            Use `buffer.copyUint8Array` to copy the result into a new Uint8Array.
  *
  * @function
- * @param {Decoder} decoder
- * @return {Uint8Array}
+ * @template {ArrayBufferLike} Buf
+ * @param {Decoder<Buf>} decoder
+ * @return {Uint8Array<Buf>}
  */
 export const readVarUint8Array = decoder => readUint8Array(decoder, readVarUint(decoder))
 

package/delta/abstract-array.d.ts

@@ -0,0 +1,166 @@
+/**
+ * @typedef {Array<dops.DeltaJsonOp>} DeltaJson
+ */
+/**
+ * @template {'array' | 'text' | 'custom'} Type
+ * @template {dops.AbstractDeltaArrayOps<any>} OPS
+ * @extends {d.AbstractDelta}
+ */
+export class AbstractDeltaArray<Type extends "array" | "text" | "custom", OPS extends dops.AbstractDeltaArrayOps<any>> extends d.AbstractDelta {
+    /**
+     * @param {Type} type
+     */
+    constructor(type: Type);
+    type: Type;
+    /**
+     * @type {Array<OPS>}
+     */
+    ops: Array<OPS>;
+    /**
+     * @template M
+     * @param {(d:OPS) => dops.AbstractDeltaArrayOps<M>} f
+     * @return {AbstractDeltaArrayBuilder<Type,M>}
+     */
+    map<M>(f: (d: OPS) => dops.AbstractDeltaArrayOps<M>): AbstractDeltaArrayBuilder<Type, M>;
+    /**
+     *
+     * Iterate through the changes. There are two approches to iterate through the changes. The
+     * following examples achieve the same thing:
+     *
+     * @example
+     *   d.forEach((op, index) => {
+     *     if (op instanceof delta.InsertArrayOp) {
+     *       op.insert
+     *     } else if (op instanceof delta.RetainOp ) {
+     *       op.retain
+     *     } else if (op instanceof delta.DeleteOp) {
+     *       op.delete
+     *     }
+     *   })
+     *
+     * The second approach doesn't require instanceof checks.
+     *
+     * @example
+     *   d.forEach(null,
+     *     (insertOp, index) => insertOp.insert,
+     *     (retainOp, index) => insertOp.retain
+     *     (deleteOp, index) => insertOp.delete
+     *   )
+     *
+     * @param {null|((d:OPS,index:number)=>void)} f
+     * @param {null|((insertOp:Extract<OPS,InsertOp<any>|TextOp>,index:number)=>void)} insertHandler
+     * @param {null|((retainOp:RetainOp,index:number)=>void)} retainHandler
+     * @param {null|((deleteOp:DeleteOp,index:number)=>void)} deleteHandler
+     * @param {null|((modifyOp:OPS extends ModifyOp<infer M> ? ModifyOp<M> : never,index:number)=>void)} modifyHandler
+     */
+    forEach(f?: null | ((d: OPS, index: number) => void), insertHandler?: null | ((insertOp: Extract<OPS, InsertOp<any> | TextOp>, index: number) => void), retainHandler?: null | ((retainOp: RetainOp, index: number) => void), deleteHandler?: null | ((deleteOp: DeleteOp, index: number) => void), modifyHandler?: null | ((modifyOp: OPS extends ModifyOp<infer M> ? ModifyOp<M> : never, index: number) => void)): void;
+    /**
+     * @param {AbstractDeltaArray<Type, OPS>} other
+     * @return {boolean}
+     */
+    equals(other: AbstractDeltaArray<Type, OPS>): boolean;
+    /**
+     * @returns {DeltaJson}
+     */
+    toJSON(): DeltaJson;
+    get size(): number;
+    /**
+     * @param {AbstractDeltaArray<Type,OPS>} other
+     */
+    [traits.EqualityTraitSymbol](other: AbstractDeltaArray<Type, OPS>): boolean;
+}
+/**
+ * @template {'text' | 'array' | 'custom'} Type
+ * @template {dops.AbstractDeltaArrayOps<any>} OPS
+ * @extends {AbstractDeltaArray<Type,OPS>}
+ */
+export class AbstractDeltaArrayBuilder<Type extends "text" | "array" | "custom", OPS extends dops.AbstractDeltaArrayOps<any>> extends AbstractDeltaArray<Type, OPS> {
+    /**
+     * @param {Type} type
+     * @param {s.Schema<OPS extends dops.AbstractDeltaArrayOps<infer V> ? V : never>} $insert
+     */
+    constructor(type: Type, $insert: s.Schema<OPS extends dops.AbstractDeltaArrayOps<infer V> ? V : never>);
+    $insert: s.Schema<OPS extends dops.AbstractDeltaArrayOps<infer V extends unknown> ? V : never>;
+    /**
+     * @type {dops.FormattingAttributes?}
+     */
+    usedAttributes: dops.FormattingAttributes | null;
+    /**
+     * @type {d.Attribution?}
+     */
+    usedAttribution: d.Attribution | null;
+    /**
+     * @type {dops.AbstractDeltaArrayOps<any>?}
+     */
+    lastOp: dops.AbstractDeltaArrayOps<any> | null;
+    /**
+     * @return {this}
+     */
+    clone(): this;
+    /**
+     * @param {dops.FormattingAttributes?} attributes
+     * @return {this}
+     */
+    useAttributes(attributes: dops.FormattingAttributes | null): this;
+    /**
+     * @param {string} name
+     * @param {any} value
+     */
+    updateUsedAttributes(name: string, value: any): this;
+    /**
+     * @template {keyof d.Attribution} NAME
+     * @param {NAME} name
+     * @param {d.Attribution[NAME]?} value
+     */
+    updateUsedAttribution<NAME extends keyof d.Attribution>(name: NAME, value: d.Attribution[NAME] | null): this;
+    /**
+     * @param {d.Attribution?} attribution
+     */
+    useAttribution(attribution: d.Attribution | null): this;
+    /**
+     * @param {(OPS extends TextOp ? string : never) | (OPS extends InsertOp<infer Content> ? Array<Content> : never) } insert
+     * @param {dops.FormattingAttributes?} attributes
+     * @param {d.Attribution?} attribution
+     * @return {this}
+     */
+    insert(insert: (OPS extends TextOp ? string : never) | (OPS extends InsertOp<infer Content> ? Array<Content> : never), attributes?: dops.FormattingAttributes | null, attribution?: d.Attribution | null): this;
+    /**
+     * @param {OPS extends ModifyOp<infer Mod> ? Mod : never } modify
+     * @param {dops.FormattingAttributes?} attributes
+     * @param {d.Attribution?} attribution
+     * @return {this}
+     */
+    modify(modify: OPS extends ModifyOp<infer Mod> ? Mod : never, attributes?: dops.FormattingAttributes | null, attribution?: d.Attribution | null): this;
+    /**
+     * @param {number} retain
+     * @param {dops.FormattingAttributes?} attributes
+     * @param {d.Attribution?} attribution
+     * @return {this}
+     */
+    retain(retain: number, attributes?: dops.FormattingAttributes | null, attribution?: d.Attribution | null): this;
+    /**
+     * @param {number} len
+     * @return {this}
+     */
+    delete(len: number): this;
+    /**
+     * @todo this is basically untested and is in dire need of randomized testing.
+     * @param {AbstractDeltaArray<Type, OPS>} other
+     */
+    apply(other: AbstractDeltaArray<Type, OPS>): void;
+    /**
+     * @return {Type extends 'array' ? (OPS extends dops.InsertOp<infer C> ? import('./array.js').DeltaArray<C> : never) : (Type extends 'text' ? (OPS extends dops.DeltaTextOps<infer Embeds> ? import('./text.js').DeltaText<Embeds> : never) : AbstractDeltaArray<Type,OPS>)}
+     */
+    done(): Type extends "array" ? (OPS extends dops.InsertOp<infer C> ? import("./array.js").DeltaArray<C> : never) : (Type extends "text" ? (OPS extends dops.DeltaTextOps<infer Embeds> ? import("./text.js").DeltaText<Embeds> : never) : AbstractDeltaArray<Type, OPS>);
+}
+export type DeltaJson = Array<dops.DeltaJsonOp>;
+import * as dops from './ops.js';
+import * as d from './abstract.js';
+import { InsertOp } from './ops.js';
+import { TextOp } from './ops.js';
+import { RetainOp } from './ops.js';
+import { DeleteOp } from './ops.js';
+import { ModifyOp } from './ops.js';
+import * as traits from '../traits.js';
+import * as s from '../schema.js';
+//# sourceMappingURL=abstract-array.d.ts.map

package/delta/abstract-array.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"abstract-array.d.ts","sourceRoot":"","sources":["abstract-array.js"],"names":[],"mappings":"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"}