lib0 0.2.115-4 → 0.2.115-5

package/schema.js

@@ -8,9 +8,11 @@ import * as obj from './object.js'
 import * as arr from './array.js'
 import * as error from './error.js'
 import * as env from './environment.js'
-import * as traits from './traits.js'
+import * as equalityTraits from './trait/equality.js'
 import * as fun from './function.js'
 import * as string from './string.js'
+import * as prng from './prng.js'
+import * as number from './number.js'
 
 /**
  * @typedef {string|number|bigint|boolean|null|undefined|symbol} Primitive
@@ -64,7 +66,7 @@ import * as string from './string.js'
 
 const schemaSymbol = Symbol('0schema')
 
-class ValidationError {
+export class ValidationError {
   constructor () {
     /**
      * Reverse errors
@@ -102,7 +104,7 @@ class ValidationError {
 const shapeExtends = (a, b) => {
   if (a === b) return true
   if (a == null || b == null || a.constructor !== b.constructor) return false
-  if (a[traits.EqualityTraitSymbol]) return traits.equals(a, b) // last resort: check equality (do this before array and obj check which don't implement the equality trait)
+  if (a[equalityTraits.EqualityTraitSymbol]) return equalityTraits.equals(a, b) // last resort: check equality (do this before array and obj check which don't implement the equality trait)
   if (arr.isArray(a)) {
     return arr.every(a, aitem =>
       arr.some(b, bitem => shapeExtends(aitem, bitem))
@@ -118,7 +120,7 @@ const shapeExtends = (a, b) => {
 
 /**
  * @template T
- * @implements {traits.EqualityTrait}
+ * @implements {equalityTraits.EqualityTrait}
  */
 export class Schema {
   // this.shape must not be defined on Schema. Otherwise typecheck on metatypes (e.g. $$object) won't work as expected anymore
@@ -153,7 +155,7 @@ export class Schema {
   /**
    * @param {object} other
    */
-  [traits.EqualityTraitSymbol] (other) {
+  [equalityTraits.EqualityTraitSymbol] (other) {
     return this.equals(/** @type {any} */ (other))
   }
 
@@ -186,6 +188,7 @@ export class Schema {
    * @type {Schema<T?>}
    */
   get nullable () {
+    // @ts-ignore
     return $union(this, $null)
   }
 
@@ -314,7 +317,7 @@ export class $Custom extends Schema {
  * @param {(o:any) => boolean} check
  * @return {Schema<any>}
  */
-export const $custom = check => new $Custom(check)
+export const $custom = (check) => new $Custom(check)
 export const $$custom = $constructedBy($Custom)
 
 /**
@@ -529,7 +532,7 @@ export class $Object extends Schema {
 }
 
 /**
- * @template {{ [key:string|symbol|number]: Schema<any> }} S
+ * @template S
  * @typedef {Schema<{ [Key in keyof S as S[Key] extends $Optional<Schema<any>> ? Key : never]?: S[Key] extends $Optional<Schema<infer Type>> ? Type : never } & { [Key in keyof S as S[Key] extends $Optional<Schema<any>> ? never : Key]: S[Key] extends Schema<infer Type> ? Type : never }>} _ObjectDefToSchema
  */
 
@@ -817,12 +820,12 @@ export class $Union extends Schema {
 }
 
 /**
- * @template {Array<Schema<any>>} T
+ * @template {Array<any>} T
  * @param {T} schemas
- * @return {CastToSchema<$Union<T extends [] ? never : (T extends Array<Schema<infer S>> ? S : never)>>}
+ * @return {CastToSchema<$Union<Unwrap<ReadSchema<T>>>>}
  */
 export const $union = (...schemas) => schemas.findIndex($s => $$union.check($s)) >= 0
-  ? $union(...schemas.map($s => $$union.check($s) ? $s.shape : [$s]).flat(1))
+  ? $union(...schemas.map($s => $($s)).map($s => $$union.check($s) ? $s.shape : [$s]).flat(1))
   : (schemas.length === 1
       ? schemas[0]
       : new $Union(schemas))
@@ -838,32 +841,32 @@ export const $$any = /** @type {Schema<Schema<any>>} */ ($constructedBy($Custom,
 /**
  * @type {Schema<bigint>}
  */
-export const $bigint = $constructedBy(BigInt)
-export const $$bigint = /** @type {Schema<Schema<BigInt>>} */ ($constructedBy($ConstructedBy, o => o.shape === BigInt))
+export const $bigint = $custom(o => typeof o === 'bigint')
+export const $$bigint = /** @type {Schema<Schema<BigInt>>} */ ($custom(o => o === $bigint))
 
 /**
  * @type {Schema<symbol>}
  */
-export const $symbol = $constructedBy(Symbol)
-export const $$symbol = /** @type {Schema<Schema<Symbol>>} */ ($constructedBy($ConstructedBy, o => o.shape === Symbol))
+export const $symbol = $custom(o => typeof o === 'symbol')
+export const $$symbol = /** @type {Schema<Schema<Symbol>>} */ ($custom(o => o === $symbol))
 
 /**
  * @type {Schema<number>}
  */
-export const $number = $constructedBy(Number)
-export const $$number = /** @type {Schema<Schema<number>>} */ ($constructedBy($ConstructedBy, o => o.shape === Number))
+export const $number = $custom(o => typeof o === 'number')
+export const $$number = /** @type {Schema<Schema<number>>} */ ($custom(o => o === $number))
 
 /**
  * @type {Schema<string>}
  */
-export const $string = $constructedBy(String)
-export const $$string = /** @type {Schema<Schema<string>>} */ ($constructedBy($ConstructedBy, o => o.shape === String))
+export const $string = $custom(o => typeof o === 'string')
+export const $$string = /** @type {Schema<Schema<string>>} */ ($custom(o => o === $string))
 
 /**
  * @type {Schema<boolean>}
  */
-export const $boolean = $constructedBy(Boolean)
-export const $$boolean = /** @type {Schema<Schema<Boolean>>} */ ($constructedBy($ConstructedBy, o => o.shape === Boolean))
+export const $boolean = $custom(o => typeof o === 'boolean')
+export const $$boolean = /** @type {Schema<Schema<Boolean>>} */ ($custom(o => o === $boolean))
 
 /**
  * @type {Schema<undefined>}
@@ -917,9 +920,26 @@ export const $json = (() => {
  *         )
  *       )
  *     )
+ * } ReadSchemaOld
+ */
+
+/**
+ * @template {any} IN
+ * @typedef {[Extract<IN,Schema<any>>,Extract<IN,string|number|boolean|null>,Extract<IN,new (...args:any[])=>any>,Extract<IN,any[]>,Extract<Exclude<IN,Schema<any>|string|number|boolean|null|(new (...args:any[])=>any)|any[]>,object>] extends [infer Schemas, infer Primitives, infer Constructors, infer Arrs, infer Obj]
+ *   ? Schema<
+ *       (Schemas extends Schema<infer S> ? S : never)
+ *     | Primitives
+ *     | (Constructors extends new (...args:any[])=>any ? InstanceType<Constructors> : never)
+ *     | (Arrs extends any[] ? { [K in keyof Arrs]: Unwrap<ReadSchema<Arrs[K]>> }[number] : never)
+ *     | (Obj extends object ? Unwrap<(_ObjectDefToSchema<{[K in keyof Obj]:ReadSchema<Obj[K]>}> extends Schema<infer S> ? Schema<{ [K in keyof S]: S[K] }> : never)> : never)>
+ *   : never
  * } ReadSchema
  */
 
+/**
+ * @typedef {ReadSchema<{x:42}|{y:99}|Schema<string>|[1,2,{}]>} Q
+ */
+
 /**
  * @template IN
  * @param {IN} o
@@ -944,6 +964,7 @@ export const $ = o => {
   } else if ($function.check(o)) {
     return /** @type {any} */ ($constructedBy(/** @type {any} */ (o)))
   }
+  /* c8 ignore next */
   error.unexpectedCase()
 }
 
@@ -963,3 +984,153 @@ export const assert = env.production
       }
     }
 /* c8 ignore end */
+
+/**
+ * @template In
+ * @template Out
+ * @typedef {{ if: Schema<In>, h: (o:In,state?:any)=>Out }} Pattern
+ */
+
+/**
+ * @template {Pattern<any,any>} P
+ * @template In
+ * @typedef {ReturnType<Extract<P,Pattern<In extends number ? number : (In extends string ? string : In),any>>['h']>} PatternMatchResult
+ */
+
+/**
+ * @todo move this to separate library
+ * @template {any} [State=undefined]
+ * @template {Pattern<any,any>} [Patterns=never]
+ */
+export class PatternMatcher {
+  /**
+   * @param {Schema<State>} [$state]
+   */
+  constructor ($state) {
+    /**
+     * @type {Array<Patterns>}
+     */
+    this.patterns = []
+    this.$state = $state
+  }
+
+  /**
+   * @template P
+   * @template R
+   * @param {P} pattern
+   * @param {(o:NoInfer<Unwrap<ReadSchema<P>>>,s:State)=>R} handler
+   * @return {PatternMatcher<State,Patterns|Pattern<Unwrap<ReadSchema<P>>,R>>}
+   */
+  if (pattern, handler) {
+    // @ts-ignore
+    this.patterns.push({ if: $(pattern), h: handler })
+    // @ts-ignore
+    return this
+  }
+
+  /**
+   * @template R
+   * @param {(o:any,s:State)=>R} h
+   */
+  else (h) {
+    return this.if($any, h)
+  }
+
+  /**
+   * @return {State extends undefined
+   *   ? <In extends Unwrap<Patterns['if']>>(o:In,state?:undefined)=>PatternMatchResult<Patterns,In>
+   *   : <In extends Unwrap<Patterns['if']>>(o:In,state:State)=>PatternMatchResult<Patterns,In>}
+   */
+  done () {
+    // @ts-ignore
+    return /** @type {any} */ (o, s) => {
+      for (let i = 0; i < this.patterns.length; i++) {
+        const p = this.patterns[i]
+        if (p.if.check(o)) {
+          // @ts-ignore
+          return p.h(o, s)
+        }
+      }
+      throw error.create('Unhandled pattern')
+    }
+  }
+}
+
+/**
+ * @template [State=undefined]
+ * @param {State} [state]
+ * @return {PatternMatcher<State extends undefined ? undefined : Unwrap<ReadSchema<State>>>}
+ */
+export const match = state => new PatternMatcher(/** @type {any} */ (state))
+
+/**
+ * Helper function to generate a (non-exhaustive) sample set from a gives schema.
+ *
+ * @type {<T>(o:T,gen:prng.PRNG)=>T}
+ */
+const _random = /** @type {any} */ (match(/** @type {Schema<prng.PRNG>} */ ($any))
+  .if($$number, (_o, gen) => prng.int53(gen, number.MIN_SAFE_INTEGER, number.MAX_SAFE_INTEGER))
+  .if($$string, (_o, gen) => prng.word(gen))
+  .if($$boolean, (_o, gen) => prng.bool(gen))
+  .if($$bigint, (_o, gen) => BigInt(prng.int53(gen, number.MIN_SAFE_INTEGER, number.MAX_SAFE_INTEGER)))
+  .if($$union, (o, gen) => random(gen, prng.oneOf(gen, o.shape)))
+  .if($$object, (o, gen) => {
+    /**
+     * @type {any}
+     */
+    const res = {}
+    for (const k in o.shape) {
+      let prop = o.shape[k]
+      if ($$optional.check(prop)) {
+        if (prng.bool(gen)) { continue }
+        prop = prop.shape
+      }
+      res[k] = _random(prop, gen)
+    }
+    return res
+  })
+  .if($$array, (o, gen) => {
+    const arr = []
+    const n = prng.int32(gen, 0, 42)
+    for (let i = 0; i < n; i++) {
+      arr.push(random(gen, o.shape))
+    }
+    return arr
+  })
+  .if($$literal, (o, gen) => {
+    return prng.oneOf(gen, o.shape)
+  })
+  .if($$null, (o, gen) => {
+    return null
+  })
+  .if($$lambda, (o, gen) => {
+    const res = random(gen, o.res)
+    return () => res
+  })
+  .if($$any, (o, gen) => random(gen, prng.oneOf(gen, [
+    $number, $string, $null, $undefined, $bigint, $boolean,
+    $array($number),
+    $record($union('a', 'b', 'c'), $number)
+  ])))
+  .if($$record, (o, gen) => {
+    /**
+     * @type {any}
+     */
+    const res = {}
+    const keysN = prng.int53(gen, 0, 3)
+    for (let i = 0; i < keysN; i++) {
+      const key = random(gen, o.shape.keys)
+      const val = random(gen, o.shape.values)
+      res[key] = val
+    }
+    return res
+  })
+  .done())
+
+/**
+ * @template S
+ * @param {prng.PRNG} gen
+ * @param {S} schema
+ * @return {Unwrap<ReadSchema<S>>}
+ */
+export const random = (gen, schema) => /** @type {any} */ (_random($(schema), gen))

package/schema.test.d.ts

@@ -7,5 +7,9 @@ export function testSchemaExtends(_tc: t.TestCase): void;
 export function testSchemaErrors(_tc: t.TestCase): void;
 export function testUnionMerging(_tc: t.TestCase): void;
 export function testConvenienceHelper(): void;
+export function testPatternMatcherBase(): void;
+export function testPatternMatcherWithState(): void;
+export function testPatternMatcherBenchmark(): void;
+export function testRepeatRandomFromSchema(tc: t.TestCase): void;
 import * as t from './testing.js';
 //# sourceMappingURL=schema.test.d.ts.map

package/schema.test.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schema.test.d.ts","sourceRoot":"","sources":["schema.test.js"],"names":[],"mappings":"AAOO,iCAFI,CAAC,CAAC,QAAQ,QAoPpB;AAEM,yCAMN;AAKM,+CAFI,CAAC,CAAC,QAAQ,QAiBpB;AAKM,qCAFI,CAAC,CAAC,QAAQ,QA0BpB;AAKM,wCAFI,CAAC,CAAC,QAAQ,QAmBpB;AAKM,uCAFI,CAAC,CAAC,QAAQ,QAUpB;AAKM,sCAFI,CAAC,CAAC,QAAQ,QASpB;AAMM,sCAFI,CAAC,CAAC,QAAQ,QAcpB;AAEM,8CAqBN;mBA1YkB,cAAc"}
+{"version":3,"file":"schema.test.d.ts","sourceRoot":"","sources":["schema.test.js"],"names":[],"mappings":"AAQO,iCAFI,CAAC,CAAC,QAAQ,QAqPpB;AAEM,yCAMN;AAKM,+CAFI,CAAC,CAAC,QAAQ,QAiBpB;AAKM,qCAFI,CAAC,CAAC,QAAQ,QA0BpB;AAKM,wCAFI,CAAC,CAAC,QAAQ,QAmBpB;AAKM,uCAFI,CAAC,CAAC,QAAQ,QAUpB;AAKM,sCAFI,CAAC,CAAC,QAAQ,QASpB;AAMM,sCAFI,CAAC,CAAC,QAAQ,QAcpB;AAEM,8CAqBN;AAEM,+CAmBN;AAEM,oDAuBN;AAEM,oDA8IN;AAKM,+CAFI,CAAC,CAAC,QAAQ,QA4BpB;mBAzmBkB,cAAc"}

package/test.html

@@ -31,7 +31,7 @@
   "lib0/conditions": "./conditions.js",
   "lib0/crypto/jwt": "./crypto/jwt.js",
   "lib0/crypto/aes-gcm": "./crypto/aes-gcm.js",
-  "lib0/delta": "./delta/d2.js",
+  "lib0/delta": "./delta/delta.js",
   "lib0/crypto/ecdsa": "./crypto/ecdsa.js",
   "lib0/crypto/rsa-oaep": "./crypto/rsa-oaep.js",
   "lib0/hash/rabin": "./hash/rabin.js",
@@ -133,9 +133,7 @@
   "lib0/symbol.js": "./symbol.js",
   "lib0/dist/symbol.cjs": "./dist/symbol.cjs",
   "lib0/symbol": "./symbol.js",
-  "lib0/traits.js": "./traits.js",
-  "lib0/dist/traits.cjs": "./dist/traits.cjs",
-  "lib0/traits": "./traits.js",
+  "lib0/traits": "./trait/traits.js",
   "lib0/testing.js": "./testing.js",
   "lib0/dist/testing.cjs": "./dist/testing.cjs",
   "lib0/testing": "./testing.js",

package/test.js

@@ -38,14 +38,11 @@ import * as storage from './storage.test.js'
 import * as list from './list.test.js'
 import * as cache from './cache.test.js'
 import * as symbol from './symbol.test.js'
-import * as traits from './traits.test.js'
+import * as traits from './trait/traits.test.js'
 import * as schema from './schema.test.js'
-import * as d2 from './delta/d2.test.js'
-import * as deltaArray from './delta/array.test.js'
-import * as deltaText from './delta/text.test.js'
-import * as deltaNode from './delta/node.test.js'
-import * as deltaTransformer from './delta/transformer.test.js'
-import * as deltaBinding from './delta/binding.test.js'
+import * as delta from './delta/delta.test.js'
+import * as deltaPitch from './delta/delta-pitch.test.js'
+// import * as deltaBinding from './delta/binding.test.js'
 import * as mutex from './mutex.test.js'
 import { isBrowser, isNode } from './environment.js'
 
@@ -95,12 +92,9 @@ runTests({
   symbol,
   traits,
   schema,
-  d2,
-  deltaArray,
-  deltaText,
-  deltaNode,
-  deltaTransformer,
-  deltaBinding,
+  delta,
+  deltaPitch,
+  // deltaBinding,
   mutex
 }).then(success => {
   /* c8 ignore next */

package/testing.js

@@ -57,7 +57,7 @@ import * as json from './json.js'
 import * as time from './time.js'
 import * as promise from './promise.js'
 import * as performance from 'lib0/performance'
-import * as traits from './traits.js'
+import * as equalityTrait from './trait/equality.js'
 
 export { production } from './environment.js'
 export const extensive = env.hasConf('extensive')
@@ -435,8 +435,8 @@ const _compare = (a, b, path, message, customCompare) => {
   if (a == null || b == null) {
     return compareValues(null, a, b, path)
   }
-  if (a[traits.EqualityTraitSymbol] != null) {
-    if (a[traits.EqualityTraitSymbol](b)) {
+  if (a[equalityTrait.EqualityTraitSymbol] != null) {
+    if (a[equalityTrait.EqualityTraitSymbol](b)) {
       return true
     } else {
       _failMessage(message, 'Not equal by equality trait', path)

package/{traits.d.ts → trait/equality.d.ts}

@@ -3,4 +3,4 @@ export function equals<T extends EqualityTrait>(a: NoInfer<T>, b: T): boolean;
 export type EqualityTrait = {
     [EqualityTraitSymbol]: (other: EqualityTrait) => boolean;
 };
-//# sourceMappingURL=traits.d.ts.map
+//# sourceMappingURL=equality.d.ts.map

package/trait/equality.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"equality.d.ts","sourceRoot":"","sources":["equality.js"],"names":[],"mappings":"AAAA,gDAAqD;AAyB9C,uBALsB,CAAC,SAAhB,aAAc,KACjB,OAAO,CAAC,CAAC,CAAC,KACV,CAAC,GACA,OAAO,CAE4D;4BAtBlE;IAAE,CAAC,mBAAmB,CAAC,EAAC,CAAC,KAAK,EAAC,aAAa,KAAG,OAAO,CAAA;CAAE"}

package/trait/fingerprint.d.ts

@@ -0,0 +1,13 @@
+export const FingerprintTraitSymbol: unique symbol;
+export function fingerprint(a: Fingerprintable): string;
+/**
+ * When implementing this trait, it is recommended to write some sort of "magic number" first to
+ * ensure that different types of objects don't have the same fingerprint.
+ *
+ * The recommended pracice is to generate a random u32 number as your magic number. e.g. using
+ * `console.log(random.uint32().toString(16))`
+ */
+export type Fingerprintable = {
+    [FingerprintTraitSymbol]: () => string;
+} | import("../encoding.js").AnyEncodable;
+//# sourceMappingURL=fingerprint.d.ts.map

package/trait/fingerprint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fingerprint.d.ts","sourceRoot":"","sources":["fingerprint.js"],"names":[],"mappings":"AAIA,mDAA2D;AAgBpD,+BAHI,eAAe,GACd,MAAM,CAE6P;;;;;;;;8BAPlQ;IAAE,CAAC,sBAAsB,CAAC,EAAC,MAAI,MAAM,CAAA;CAAE,GAAG,OAAO,gBAAgB,EAAE,YAAY"}

package/trait/fingerprint.js

@@ -0,0 +1,21 @@
+import * as encoding from '../encoding.js'
+import * as rabin from '../hash/rabin.js'
+import * as buffer from '../buffer.js'
+
+export const FingerprintTraitSymbol = Symbol('Fingerprint')
+
+/**
+ * When implementing this trait, it is recommended to write some sort of "magic number" first to
+ * ensure that different types of objects don't have the same fingerprint.
+ *
+ * The recommended pracice is to generate a random u32 number as your magic number. e.g. using
+ * `console.log(random.uint32().toString(16))`
+ *
+ * @typedef {{ [FingerprintTraitSymbol]:()=>string } | import('../encoding.js').AnyEncodable} Fingerprintable
+ */
+
+/**
+ * @param {Fingerprintable} a
+ * @return {string}
+ */
+export const fingerprint = a => (a != null && /** @type {any} */ (a)[FingerprintTraitSymbol]?.()) || buffer.toBase64(rabin.fingerprint(rabin.StandardIrreducible128, encoding.encode(encoder => { encoding.writeUint32(encoder, 0x8de1c475); encoding.writeAny(encoder, a) })))

package/trait/traits.d.ts

@@ -0,0 +1,3 @@
+export * from "./equality.js";
+export * from "./fingerprint.js";
+//# sourceMappingURL=traits.d.ts.map

package/trait/traits.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"traits.d.ts","sourceRoot":"","sources":["traits.js"],"names":[],"mappings":""}

package/trait/traits.js

@@ -0,0 +1,2 @@
+export * from './equality.js'
+export * from './fingerprint.js'

package/trait/traits.test.d.ts

@@ -0,0 +1,5 @@
+export function testEqualityTrait1(_tc: t.TestCase): void;
+export function testEqualityTrait2(_tc: t.TestCase): void;
+export function testFingerprintTrait(): void;
+import * as t from '../testing.js';
+//# sourceMappingURL=traits.test.d.ts.map

package/{traits.test.d.ts.map → trait/traits.test.d.ts.map}

@@ -1 +1 @@
-{"version":3,"file":"traits.test.d.ts","sourceRoot":"","sources":["traits.test.js"],"names":[],"mappings":"AAQO,wCAFI,CAAC,CAAC,QAAQ,QAwCpB;AAKM,wCAFI,CAAC,CAAC,QAAQ,QA2BpB;mBA5EkB,cAAc"}
+{"version":3,"file":"traits.test.d.ts","sourceRoot":"","sources":["traits.test.js"],"names":[],"mappings":"AAQO,wCAFI,CAAC,CAAC,QAAQ,QAwCpB;AAKM,wCAFI,CAAC,CAAC,QAAQ,QA2BpB;AAEM,6CAMN;mBApFkB,eAAe"}

package/delta/abstract-array.d.ts

@@ -1,166 +0,0 @@
-/**
- * @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

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