json-patch-to-crdt 0.3.0 → 0.5.0

package/dist/{depth-BTHjgY18.d.mts → depth-CM1kCxhm.d.mts}

@@ -17,8 +17,9 @@ type JsonValue = JsonPrimitive | JsonValue[] | {
 /**
  * Runtime handling mode for non-JSON inputs received through `any` / untyped callers.
  * - `"none"`: keep current behavior (no extra runtime guardrails).
- * - `"strict"`: reject invalid values (e.g. `NaN`, `Infinity`, `undefined`).
- * - `"normalize"`: coerce invalid values into JSON-safe output.
+ * - `"strict"`: reject invalid values (e.g. `NaN`, `Infinity`, `undefined`, or non-plain objects like `Date`).
+ * - `"normalize"`: coerce invalid values into JSON-safe output. Non-plain objects become `null`
+ *   at the root or in arrays, and are omitted from object properties.
  */
 type JsonValidationMode = "none" | "strict" | "normalize";
 /** Mutable clock that tracks an actor's identity and monotonic counter. */
@@ -87,20 +88,35 @@ type SerializedNode = {
   kind: "seq";
   elems: Record<string, SerializedRgaElem>;
 };
-/** JSON-serializable form of a CRDT document. */
-type SerializedDoc = {
+/** Versioned JSON-serializable form of a CRDT document. */
+interface SerializedDocV1 {
+  version: 1;
   root: SerializedNode;
-};
+}
+/** Legacy unversioned JSON-serializable form of a CRDT document. */
+interface LegacySerializedDoc {
+  root: SerializedNode;
+}
+/** JSON-serializable form of a CRDT document. */
+type SerializedDoc = SerializedDocV1 | LegacySerializedDoc;
 /** JSON-serializable form of a clock. */
-type SerializedClock = {
+interface SerializedClock {
   actor: ActorId;
   ctr: number;
-};
-/** JSON-serializable form of a full CRDT state (document + clock). */
-type SerializedState = {
+}
+/** Versioned JSON-serializable form of a full CRDT state (document + clock). */
+interface SerializedStateV1 {
+  version: 1;
   doc: SerializedDoc;
   clock: SerializedClock;
-};
+}
+/** Legacy unversioned JSON-serializable form of a full CRDT state (document + clock). */
+interface LegacySerializedState {
+  doc: SerializedDoc;
+  clock: SerializedClock;
+}
+/** JSON-serializable form of a full CRDT state (document + clock). */
+type SerializedState = SerializedStateV1 | LegacySerializedState;
 /** Typed reasons for rejecting malformed serialized CRDT payloads. */
 type DeserializeErrorReason = "INVALID_SERIALIZED_SHAPE" | "INVALID_SERIALIZED_INVARIANT";
 /** Structured failure payload used by non-throwing deserialize helpers. */
@@ -308,6 +324,16 @@ type ValidatePatchResult = {
   ok: false;
   error: ApplyError;
 };
+/**
+ * Merge strategy applied when two non-empty array sequences share no element lineage.
+ *
+ * - `"reject"` – abort the merge and return a `LINEAGE_MISMATCH` error (default).
+ * - `"atomic-replace"` – replace the losing array entirely with the one that has
+ *   the higher representative dot (causal last-write-wins at the array level).
+ * - `"unsafe-union"` – union all elements from both sequences without any lineage
+ *   check. Element ordering may be non-deterministic across peers.
+ */
+type UnrelatedArraysStrategy = "reject" | "atomic-replace" | "unsafe-union";
 /** Options for `mergeState`. */
 type MergeStateOptions = {
   /**
@@ -316,16 +342,30 @@ type MergeStateOptions = {
    */
   actor?: ActorId;
   /**
-   * Require array sequences to share element lineage before merging.
-   * Defaults to `true`.
+   * Strategy for merging unrelated (non-overlapping) non-empty array sequences.
+   * Defaults to `"reject"`.
+   */
+  unrelatedArrays?: UnrelatedArraysStrategy;
+  /**
+   * @deprecated Use `unrelatedArrays` instead.
+   * When `true`, behaves like `unrelatedArrays: "reject"`.
+   * When `false`, behaves like `unrelatedArrays: "unsafe-union"`.
+   * Ignored when `unrelatedArrays` is also provided.
    */
   requireSharedOrigin?: boolean;
 };
 /** Options for `mergeDoc`. */
 type MergeDocOptions = {
   /**
-   * Require array sequences to share element lineage before merging.
-   * Defaults to `true`.
+   * Strategy for merging unrelated (non-overlapping) non-empty array sequences.
+   * Defaults to `"reject"`.
+   */
+  unrelatedArrays?: UnrelatedArraysStrategy;
+  /**
+   * @deprecated Use `unrelatedArrays` instead.
+   * When `true`, behaves like `unrelatedArrays: "reject"`.
+   * When `false`, behaves like `unrelatedArrays: "unsafe-union"`.
+   * Ignored when `unrelatedArrays` is also provided.
    */
   requireSharedOrigin?: boolean;
 };
@@ -403,6 +443,19 @@ type DiffOptions = {
    * Set to `Number.POSITIVE_INFINITY` to always allow LCS.
    */
   lcsMaxCells?: number;
+  /**
+   * Optional guardrail for `arrayStrategy: "lcs-linear"`.
+   * Uses the trimmed unmatched window size
+   * (`(unmatchedBase.length + 1) * (unmatchedNext.length + 1)`) as a proxy for
+   * worst-case work. When the cap is exceeded, the diff falls back to an atomic
+   * array replacement instead of running the linear-space traversal.
+   *
+   * Unlike `lcsMaxCells`, this is opt-in and defaults to no fallback so
+   * existing `lcs-linear` callers keep their current behavior.
+   *
+   * Set to `Number.POSITIVE_INFINITY` to always allow `lcs-linear`.
+   */
+  lcsLinearMaxCells?: number;
   /**
    * Emit RFC 6902 `move` operations when a deterministic remove/add rewrite is available.
    * Defaults to `false` for backward compatibility.
@@ -556,8 +609,8 @@ declare function compileJsonPatchToIntent(baseJson: JsonValue, patch: JsonPatchO
  * By default arrays use a deterministic LCS strategy.
  * Pass `{ arrayStrategy: "atomic" }` for single-op array replacement.
  * Pass `{ arrayStrategy: "lcs-linear" }` for a lower-memory LCS variant.
- * Note that `lcs-linear` still runs in `O(n * m)` time and does not have an
- * automatic fallback for very large unmatched windows.
+ * Use `lcsLinearMaxCells` to optionally cap worst-case `lcs-linear` work and
+ * fall back to an atomic array replacement for very large unmatched windows.
  * Pass `{ emitMoves: true }` or `{ emitCopies: true }` to opt into RFC 6902
  * move/copy emission when a deterministic rewrite is available.
  * @param base - The original JSON value.
@@ -566,6 +619,8 @@ declare function compileJsonPatchToIntent(baseJson: JsonValue, patch: JsonPatchO
  * @returns An array of JSON Patch operations that transform `base` into `next`.
  */
 declare function diffJsonPatch(base: JsonValue, next: JsonValue, options?: DiffOptions): JsonPatchOp[];
+/** @internal Stable structural fingerprint used for deterministic diff rewrites. */
+declare function stableJsonValueKey(value: JsonValue, structuralKeyCache?: WeakMap<object, string>): string;
 /** Deep equality check for JSON values (null-safe, handles arrays and objects). */
 declare function jsonEquals(a: JsonValue, b: JsonValue): boolean;
 //#endregion
@@ -584,7 +639,12 @@ declare function deserializeDoc(data: SerializedDoc): Doc;
 declare function tryDeserializeDoc(data: SerializedDoc): TryDeserializeDocResult;
 /** Serialize a full CRDT state (document + clock) to a JSON-safe representation. */
 declare function serializeState(state: CrdtState): SerializedState;
-/** Reconstruct a full CRDT state from its serialized form, restoring the clock. */
+/**
+ * Reconstruct a full CRDT state from its serialized form, restoring the clock.
+ *
+ * May throw `TraversalDepthError` when the payload exceeds the maximum
+ * supported nesting depth.
+ */
 declare function deserializeState(data: SerializedState): CrdtState;
 /** Non-throwing `deserializeState` variant with typed validation details. */
 declare function tryDeserializeState(data: SerializedState): TryDeserializeStateResult;
@@ -619,7 +679,7 @@ declare function tryMergeDoc(a: Doc, b: Doc, options?: MergeDocOptions): TryMerg
  * The merged clock keeps a stable actor identity:
  * - defaults to the actor from the first argument (`a`)
  * - can be overridden via `options.actor`
- * - optional `options.requireSharedOrigin` controls merge lineage checks
+ * - optional `options.unrelatedArrays` controls the merge strategy for non-overlapping sequences
  *
  * The merged counter is lifted to the highest counter already observed for
  * that actor across both input clocks and the merged document dots.
@@ -628,6 +688,28 @@ declare function mergeState(a: CrdtState, b: CrdtState, options?: MergeStateOpti
 /** Non-throwing `mergeState` variant with structured conflict details. */
 declare function tryMergeState(a: CrdtState, b: CrdtState, options?: MergeStateOptions): TryMergeStateResult;
 //#endregion
+//#region src/version-vector.d.ts
+/**
+ * Inspect a document or state and return the highest observed counter per actor.
+ *
+ * When a `CrdtState` is provided, the returned vector is also seeded from the
+ * state's local clock so callers do not lose counters that have advanced ahead
+ * of the currently materialized document tree.
+ */
+declare function observedVersionVector(target: Doc | CrdtState): VersionVector;
+/** Combine version vectors using per-actor maxima. */
+declare function mergeVersionVectors(...vectors: readonly VersionVector[]): VersionVector;
+/**
+ * Derive a causally-stable checkpoint by taking the per-actor minimum.
+ *
+ * When called with a single vector the result equals that vector. In practice,
+ * a meaningful shared-stability checkpoint usually needs acknowledgements from
+ * at least two peers or from an explicit quorum.
+ */
+declare function intersectVersionVectors(...vectors: readonly VersionVector[]): VersionVector;
+/** Check whether one version vector has observed every counter in another. */
+declare function versionVectorCovers(observed: VersionVector, required: VersionVector): boolean;
+//#endregion
 //#region src/compact.d.ts
 /**
  * Compact causally-stable tombstones in a document.
@@ -660,4 +742,4 @@ declare class TraversalDepthError extends Error {
   constructor(depth: number, maxDepth?: number);
 }
 //#endregion
-export { CreateStateOptions as $, PatchError as A, TombstoneCompactionOptions as At, validateJsonPatch as B, VersionVector as Bt, stringifyJsonPointer as C, RgaElem as Ct, nextDotForActor as D, SerializedNode as Dt, createClock as E, SerializedDoc as Et, forkState as F, TryDeserializeDocResult as Ft, ApplyPatchInPlaceOptions as G, ApplyError as H, toJson as I, TryDeserializeStateResult as It, Clock as J, ApplyPatchOptions as K, tryApplyPatch as L, TryMergeDocResult as Lt, applyPatchAsActor as M, TryApplyPatchAsActorResult as Mt, applyPatchInPlace as N, TryApplyPatchInPlaceResult as Nt, observeDot as O, SerializedRgaElem as Ot, createState as P, TryApplyPatchResult as Pt, CrdtState as Q, tryApplyPatchAsActor as R, TryMergeStateResult as Rt, parseJsonPointer as S, ROOT_KEY as St, cloneClock as T, SerializedClock as Tt, ApplyPatchAsActorOptions as U, ActorId as V, ApplyPatchAsActorResult as W, CompactStateTombstonesResult as X, CompactDocTombstonesResult as Y, CompilePatchOptions as Z, PatchCompileError as _, Node as _t, MergeError as a, ElemId as at, getAtJson as b, PatchErrorReason as bt, tryMergeDoc as c, JsonPatch as ct, deserializeDoc as d, JsonPrimitive as dt, DeserializeErrorReason as et, deserializeState as f, JsonValidationMode as ft, tryDeserializeState as g, MergeStateOptions as gt, tryDeserializeDoc as h, MergeDocOptions as ht, compactStateTombstones as i, Dot as it, applyPatch as j, TombstoneCompactionStats as jt, JsonValueValidationError as k, SerializedState as kt, tryMergeState as l, JsonPatchOp as lt, serializeState as m, LwwReg as mt, TraversalDepthError as n, DiffOptions as nt, mergeDoc as o, ForkStateOptions as ot, serializeDoc as p, JsonValue as pt, ApplyResult as q, compactDocTombstones as r, Doc as rt, mergeState as s, IntentOp as st, MAX_TRAVERSAL_DEPTH as t, DeserializeFailure as tt, DeserializeError as u, JsonPatchToCrdtOptions as ut, compileJsonPatchToIntent as v, ObjEntry as vt, ClockValidationError as w, RgaSeq as wt, jsonEquals as x, PatchSemantics as xt, diffJsonPatch as y, ObjNode as yt, tryApplyPatchInPlace as z, ValidatePatchResult as zt };
+export { Clock as $, cloneClock as A, SerializedClock as At, forkState as B, TryDeserializeDocResult as Bt, diffJsonPatch as C, ObjEntry as Ct, stableJsonValueKey as D, ROOT_KEY as Dt, parseJsonPointer as E, PatchSemantics as Et, PatchError as F, TombstoneCompactionOptions as Ft, validateJsonPatch as G, ValidatePatchResult as Gt, tryApplyPatch as H, TryMergeDocResult as Ht, applyPatch as I, TombstoneCompactionStats as It, ApplyPatchAsActorOptions as J, ActorId as K, VersionVector as Kt, applyPatchAsActor as L, TryApplyPatchAsActorResult as Lt, nextDotForActor as M, SerializedNode as Mt, observeDot as N, SerializedRgaElem as Nt, stringifyJsonPointer as O, RgaElem as Ot, JsonValueValidationError as P, SerializedState as Pt, ApplyResult as Q, applyPatchInPlace as R, TryApplyPatchInPlaceResult as Rt, compileJsonPatchToIntent as S, Node as St, jsonEquals as T, PatchErrorReason as Tt, tryApplyPatchAsActor as U, TryMergeStateResult as Ut, toJson as V, TryDeserializeStateResult as Vt, tryApplyPatchInPlace as W, UnrelatedArraysStrategy as Wt, ApplyPatchInPlaceOptions as X, ApplyPatchAsActorResult as Y, ApplyPatchOptions as Z, serializeDoc as _, JsonValidationMode as _t, intersectVersionVectors as a, DeserializeErrorReason as at, tryDeserializeState as b, MergeDocOptions as bt, versionVectorCovers as c, Doc as ct, mergeState as d, ForkStateOptions as dt, CompactDocTombstonesResult as et, tryMergeDoc as f, IntentOp as ft, deserializeState as g, JsonPrimitive as gt, deserializeDoc as h, JsonPatchToCrdtOptions as ht, compactStateTombstones as i, CreateStateOptions as it, createClock as j, SerializedDoc as jt, ClockValidationError as k, RgaSeq as kt, MergeError as l, Dot as lt, DeserializeError as m, JsonPatchOp as mt, TraversalDepthError as n, CompilePatchOptions as nt, mergeVersionVectors as o, DeserializeFailure as ot, tryMergeState as p, JsonPatch as pt, ApplyError as q, compactDocTombstones as r, CrdtState as rt, observedVersionVector as s, DiffOptions as st, MAX_TRAVERSAL_DEPTH as t, CompactStateTombstonesResult as tt, mergeDoc as u, ElemId as ut, serializeState as v, JsonValue as vt, getAtJson as w, ObjNode as wt, PatchCompileError as x, MergeStateOptions as xt, tryDeserializeDoc as y, LwwReg as yt, createState as z, TryApplyPatchResult as zt };

package/dist/{depth-DSl2ghKu.d.ts → depth-NbZ6Giq9.d.ts}

@@ -17,8 +17,9 @@ type JsonValue = JsonPrimitive | JsonValue[] | {
 /**
  * Runtime handling mode for non-JSON inputs received through `any` / untyped callers.
  * - `"none"`: keep current behavior (no extra runtime guardrails).
- * - `"strict"`: reject invalid values (e.g. `NaN`, `Infinity`, `undefined`).
- * - `"normalize"`: coerce invalid values into JSON-safe output.
+ * - `"strict"`: reject invalid values (e.g. `NaN`, `Infinity`, `undefined`, or non-plain objects like `Date`).
+ * - `"normalize"`: coerce invalid values into JSON-safe output. Non-plain objects become `null`
+ *   at the root or in arrays, and are omitted from object properties.
  */
 type JsonValidationMode = "none" | "strict" | "normalize";
 /** Mutable clock that tracks an actor's identity and monotonic counter. */
@@ -87,20 +88,35 @@ type SerializedNode = {
   kind: "seq";
   elems: Record<string, SerializedRgaElem>;
 };
-/** JSON-serializable form of a CRDT document. */
-type SerializedDoc = {
+/** Versioned JSON-serializable form of a CRDT document. */
+interface SerializedDocV1 {
+  version: 1;
   root: SerializedNode;
-};
+}
+/** Legacy unversioned JSON-serializable form of a CRDT document. */
+interface LegacySerializedDoc {
+  root: SerializedNode;
+}
+/** JSON-serializable form of a CRDT document. */
+type SerializedDoc = SerializedDocV1 | LegacySerializedDoc;
 /** JSON-serializable form of a clock. */
-type SerializedClock = {
+interface SerializedClock {
   actor: ActorId;
   ctr: number;
-};
-/** JSON-serializable form of a full CRDT state (document + clock). */
-type SerializedState = {
+}
+/** Versioned JSON-serializable form of a full CRDT state (document + clock). */
+interface SerializedStateV1 {
+  version: 1;
   doc: SerializedDoc;
   clock: SerializedClock;
-};
+}
+/** Legacy unversioned JSON-serializable form of a full CRDT state (document + clock). */
+interface LegacySerializedState {
+  doc: SerializedDoc;
+  clock: SerializedClock;
+}
+/** JSON-serializable form of a full CRDT state (document + clock). */
+type SerializedState = SerializedStateV1 | LegacySerializedState;
 /** Typed reasons for rejecting malformed serialized CRDT payloads. */
 type DeserializeErrorReason = "INVALID_SERIALIZED_SHAPE" | "INVALID_SERIALIZED_INVARIANT";
 /** Structured failure payload used by non-throwing deserialize helpers. */
@@ -308,6 +324,16 @@ type ValidatePatchResult = {
   ok: false;
   error: ApplyError;
 };
+/**
+ * Merge strategy applied when two non-empty array sequences share no element lineage.
+ *
+ * - `"reject"` – abort the merge and return a `LINEAGE_MISMATCH` error (default).
+ * - `"atomic-replace"` – replace the losing array entirely with the one that has
+ *   the higher representative dot (causal last-write-wins at the array level).
+ * - `"unsafe-union"` – union all elements from both sequences without any lineage
+ *   check. Element ordering may be non-deterministic across peers.
+ */
+type UnrelatedArraysStrategy = "reject" | "atomic-replace" | "unsafe-union";
 /** Options for `mergeState`. */
 type MergeStateOptions = {
   /**
@@ -316,16 +342,30 @@ type MergeStateOptions = {
    */
   actor?: ActorId;
   /**
-   * Require array sequences to share element lineage before merging.
-   * Defaults to `true`.
+   * Strategy for merging unrelated (non-overlapping) non-empty array sequences.
+   * Defaults to `"reject"`.
+   */
+  unrelatedArrays?: UnrelatedArraysStrategy;
+  /**
+   * @deprecated Use `unrelatedArrays` instead.
+   * When `true`, behaves like `unrelatedArrays: "reject"`.
+   * When `false`, behaves like `unrelatedArrays: "unsafe-union"`.
+   * Ignored when `unrelatedArrays` is also provided.
    */
   requireSharedOrigin?: boolean;
 };
 /** Options for `mergeDoc`. */
 type MergeDocOptions = {
   /**
-   * Require array sequences to share element lineage before merging.
-   * Defaults to `true`.
+   * Strategy for merging unrelated (non-overlapping) non-empty array sequences.
+   * Defaults to `"reject"`.
+   */
+  unrelatedArrays?: UnrelatedArraysStrategy;
+  /**
+   * @deprecated Use `unrelatedArrays` instead.
+   * When `true`, behaves like `unrelatedArrays: "reject"`.
+   * When `false`, behaves like `unrelatedArrays: "unsafe-union"`.
+   * Ignored when `unrelatedArrays` is also provided.
    */
   requireSharedOrigin?: boolean;
 };
@@ -403,6 +443,19 @@ type DiffOptions = {
    * Set to `Number.POSITIVE_INFINITY` to always allow LCS.
    */
   lcsMaxCells?: number;
+  /**
+   * Optional guardrail for `arrayStrategy: "lcs-linear"`.
+   * Uses the trimmed unmatched window size
+   * (`(unmatchedBase.length + 1) * (unmatchedNext.length + 1)`) as a proxy for
+   * worst-case work. When the cap is exceeded, the diff falls back to an atomic
+   * array replacement instead of running the linear-space traversal.
+   *
+   * Unlike `lcsMaxCells`, this is opt-in and defaults to no fallback so
+   * existing `lcs-linear` callers keep their current behavior.
+   *
+   * Set to `Number.POSITIVE_INFINITY` to always allow `lcs-linear`.
+   */
+  lcsLinearMaxCells?: number;
   /**
    * Emit RFC 6902 `move` operations when a deterministic remove/add rewrite is available.
    * Defaults to `false` for backward compatibility.
@@ -556,8 +609,8 @@ declare function compileJsonPatchToIntent(baseJson: JsonValue, patch: JsonPatchO
  * By default arrays use a deterministic LCS strategy.
  * Pass `{ arrayStrategy: "atomic" }` for single-op array replacement.
  * Pass `{ arrayStrategy: "lcs-linear" }` for a lower-memory LCS variant.
- * Note that `lcs-linear` still runs in `O(n * m)` time and does not have an
- * automatic fallback for very large unmatched windows.
+ * Use `lcsLinearMaxCells` to optionally cap worst-case `lcs-linear` work and
+ * fall back to an atomic array replacement for very large unmatched windows.
  * Pass `{ emitMoves: true }` or `{ emitCopies: true }` to opt into RFC 6902
  * move/copy emission when a deterministic rewrite is available.
  * @param base - The original JSON value.
@@ -566,6 +619,8 @@ declare function compileJsonPatchToIntent(baseJson: JsonValue, patch: JsonPatchO
  * @returns An array of JSON Patch operations that transform `base` into `next`.
  */
 declare function diffJsonPatch(base: JsonValue, next: JsonValue, options?: DiffOptions): JsonPatchOp[];
+/** @internal Stable structural fingerprint used for deterministic diff rewrites. */
+declare function stableJsonValueKey(value: JsonValue, structuralKeyCache?: WeakMap<object, string>): string;
 /** Deep equality check for JSON values (null-safe, handles arrays and objects). */
 declare function jsonEquals(a: JsonValue, b: JsonValue): boolean;
 //#endregion
@@ -584,7 +639,12 @@ declare function deserializeDoc(data: SerializedDoc): Doc;
 declare function tryDeserializeDoc(data: SerializedDoc): TryDeserializeDocResult;
 /** Serialize a full CRDT state (document + clock) to a JSON-safe representation. */
 declare function serializeState(state: CrdtState): SerializedState;
-/** Reconstruct a full CRDT state from its serialized form, restoring the clock. */
+/**
+ * Reconstruct a full CRDT state from its serialized form, restoring the clock.
+ *
+ * May throw `TraversalDepthError` when the payload exceeds the maximum
+ * supported nesting depth.
+ */
 declare function deserializeState(data: SerializedState): CrdtState;
 /** Non-throwing `deserializeState` variant with typed validation details. */
 declare function tryDeserializeState(data: SerializedState): TryDeserializeStateResult;
@@ -619,7 +679,7 @@ declare function tryMergeDoc(a: Doc, b: Doc, options?: MergeDocOptions): TryMerg
  * The merged clock keeps a stable actor identity:
  * - defaults to the actor from the first argument (`a`)
  * - can be overridden via `options.actor`
- * - optional `options.requireSharedOrigin` controls merge lineage checks
+ * - optional `options.unrelatedArrays` controls the merge strategy for non-overlapping sequences
  *
  * The merged counter is lifted to the highest counter already observed for
  * that actor across both input clocks and the merged document dots.
@@ -628,6 +688,28 @@ declare function mergeState(a: CrdtState, b: CrdtState, options?: MergeStateOpti
 /** Non-throwing `mergeState` variant with structured conflict details. */
 declare function tryMergeState(a: CrdtState, b: CrdtState, options?: MergeStateOptions): TryMergeStateResult;
 //#endregion
+//#region src/version-vector.d.ts
+/**
+ * Inspect a document or state and return the highest observed counter per actor.
+ *
+ * When a `CrdtState` is provided, the returned vector is also seeded from the
+ * state's local clock so callers do not lose counters that have advanced ahead
+ * of the currently materialized document tree.
+ */
+declare function observedVersionVector(target: Doc | CrdtState): VersionVector;
+/** Combine version vectors using per-actor maxima. */
+declare function mergeVersionVectors(...vectors: readonly VersionVector[]): VersionVector;
+/**
+ * Derive a causally-stable checkpoint by taking the per-actor minimum.
+ *
+ * When called with a single vector the result equals that vector. In practice,
+ * a meaningful shared-stability checkpoint usually needs acknowledgements from
+ * at least two peers or from an explicit quorum.
+ */
+declare function intersectVersionVectors(...vectors: readonly VersionVector[]): VersionVector;
+/** Check whether one version vector has observed every counter in another. */
+declare function versionVectorCovers(observed: VersionVector, required: VersionVector): boolean;
+//#endregion
 //#region src/compact.d.ts
 /**
  * Compact causally-stable tombstones in a document.
@@ -660,4 +742,4 @@ declare class TraversalDepthError extends Error {
   constructor(depth: number, maxDepth?: number);
 }
 //#endregion
-export { CreateStateOptions as $, PatchError as A, TombstoneCompactionOptions as At, validateJsonPatch as B, VersionVector as Bt, stringifyJsonPointer as C, RgaElem as Ct, nextDotForActor as D, SerializedNode as Dt, createClock as E, SerializedDoc as Et, forkState as F, TryDeserializeDocResult as Ft, ApplyPatchInPlaceOptions as G, ApplyError as H, toJson as I, TryDeserializeStateResult as It, Clock as J, ApplyPatchOptions as K, tryApplyPatch as L, TryMergeDocResult as Lt, applyPatchAsActor as M, TryApplyPatchAsActorResult as Mt, applyPatchInPlace as N, TryApplyPatchInPlaceResult as Nt, observeDot as O, SerializedRgaElem as Ot, createState as P, TryApplyPatchResult as Pt, CrdtState as Q, tryApplyPatchAsActor as R, TryMergeStateResult as Rt, parseJsonPointer as S, ROOT_KEY as St, cloneClock as T, SerializedClock as Tt, ApplyPatchAsActorOptions as U, ActorId as V, ApplyPatchAsActorResult as W, CompactStateTombstonesResult as X, CompactDocTombstonesResult as Y, CompilePatchOptions as Z, PatchCompileError as _, Node as _t, MergeError as a, ElemId as at, getAtJson as b, PatchErrorReason as bt, tryMergeDoc as c, JsonPatch as ct, deserializeDoc as d, JsonPrimitive as dt, DeserializeErrorReason as et, deserializeState as f, JsonValidationMode as ft, tryDeserializeState as g, MergeStateOptions as gt, tryDeserializeDoc as h, MergeDocOptions as ht, compactStateTombstones as i, Dot as it, applyPatch as j, TombstoneCompactionStats as jt, JsonValueValidationError as k, SerializedState as kt, tryMergeState as l, JsonPatchOp as lt, serializeState as m, LwwReg as mt, TraversalDepthError as n, DiffOptions as nt, mergeDoc as o, ForkStateOptions as ot, serializeDoc as p, JsonValue as pt, ApplyResult as q, compactDocTombstones as r, Doc as rt, mergeState as s, IntentOp as st, MAX_TRAVERSAL_DEPTH as t, DeserializeFailure as tt, DeserializeError as u, JsonPatchToCrdtOptions as ut, compileJsonPatchToIntent as v, ObjEntry as vt, ClockValidationError as w, RgaSeq as wt, jsonEquals as x, PatchSemantics as xt, diffJsonPatch as y, ObjNode as yt, tryApplyPatchInPlace as z, ValidatePatchResult as zt };
+export { Clock as $, cloneClock as A, SerializedClock as At, forkState as B, TryDeserializeDocResult as Bt, diffJsonPatch as C, ObjEntry as Ct, stableJsonValueKey as D, ROOT_KEY as Dt, parseJsonPointer as E, PatchSemantics as Et, PatchError as F, TombstoneCompactionOptions as Ft, validateJsonPatch as G, ValidatePatchResult as Gt, tryApplyPatch as H, TryMergeDocResult as Ht, applyPatch as I, TombstoneCompactionStats as It, ApplyPatchAsActorOptions as J, ActorId as K, VersionVector as Kt, applyPatchAsActor as L, TryApplyPatchAsActorResult as Lt, nextDotForActor as M, SerializedNode as Mt, observeDot as N, SerializedRgaElem as Nt, stringifyJsonPointer as O, RgaElem as Ot, JsonValueValidationError as P, SerializedState as Pt, ApplyResult as Q, applyPatchInPlace as R, TryApplyPatchInPlaceResult as Rt, compileJsonPatchToIntent as S, Node as St, jsonEquals as T, PatchErrorReason as Tt, tryApplyPatchAsActor as U, TryMergeStateResult as Ut, toJson as V, TryDeserializeStateResult as Vt, tryApplyPatchInPlace as W, UnrelatedArraysStrategy as Wt, ApplyPatchInPlaceOptions as X, ApplyPatchAsActorResult as Y, ApplyPatchOptions as Z, serializeDoc as _, JsonValidationMode as _t, intersectVersionVectors as a, DeserializeErrorReason as at, tryDeserializeState as b, MergeDocOptions as bt, versionVectorCovers as c, Doc as ct, mergeState as d, ForkStateOptions as dt, CompactDocTombstonesResult as et, tryMergeDoc as f, IntentOp as ft, deserializeState as g, JsonPrimitive as gt, deserializeDoc as h, JsonPatchToCrdtOptions as ht, compactStateTombstones as i, CreateStateOptions as it, createClock as j, SerializedDoc as jt, ClockValidationError as k, RgaSeq as kt, MergeError as l, Dot as lt, DeserializeError as m, JsonPatchOp as mt, TraversalDepthError as n, CompilePatchOptions as nt, mergeVersionVectors as o, DeserializeFailure as ot, tryMergeState as p, JsonPatch as pt, ApplyError as q, compactDocTombstones as r, CrdtState as rt, observedVersionVector as s, DiffOptions as st, MAX_TRAVERSAL_DEPTH as t, CompactStateTombstonesResult as tt, mergeDoc as u, ElemId as ut, serializeState as v, JsonValue as vt, getAtJson as w, ObjNode as wt, PatchCompileError as x, MergeStateOptions as xt, tryDeserializeDoc as y, LwwReg as yt, createState as z, TryApplyPatchResult as zt };

package/dist/index.d.mts

@@ -1,2 +1,2 @@
-import { $ as CreateStateOptions, A as PatchError, At as TombstoneCompactionOptions, B as validateJsonPatch, F as forkState, G as ApplyPatchInPlaceOptions, H as ApplyError, I as toJson, It as TryDeserializeStateResult, K as ApplyPatchOptions, L as tryApplyPatch, N as applyPatchInPlace, Nt as TryApplyPatchInPlaceResult, P as createState, Pt as TryApplyPatchResult, Q as CrdtState, Rt as TryMergeStateResult, V as ActorId, X as CompactStateTombstonesResult, a as MergeError, bt as PatchErrorReason, ct as JsonPatch, dt as JsonPrimitive, et as DeserializeErrorReason, f as deserializeState, ft as JsonValidationMode, g as tryDeserializeState, gt as MergeStateOptions, i as compactStateTombstones, j as applyPatch, jt as TombstoneCompactionStats, k as JsonValueValidationError, kt as SerializedState, l as tryMergeState, lt as JsonPatchOp, m as serializeState, n as TraversalDepthError, nt as DiffOptions, ot as ForkStateOptions, pt as JsonValue, s as mergeState, t as MAX_TRAVERSAL_DEPTH, tt as DeserializeFailure, u as DeserializeError, w as ClockValidationError, xt as PatchSemantics, y as diffJsonPatch, z as tryApplyPatchInPlace, zt as ValidatePatchResult } from "./depth-BTHjgY18.mjs";
-export { type ActorId, type ApplyError, type ApplyPatchInPlaceOptions, type ApplyPatchOptions, ClockValidationError, type CompactStateTombstonesResult, type CrdtState, type CreateStateOptions, DeserializeError, type DeserializeErrorReason, type DeserializeFailure, type DiffOptions, type ForkStateOptions, type JsonPatch, type JsonPatchOp, type JsonPrimitive, type JsonValidationMode, type JsonValue, JsonValueValidationError, MAX_TRAVERSAL_DEPTH, MergeError, type MergeStateOptions, PatchError, type PatchErrorReason, type PatchSemantics, type SerializedState, type TombstoneCompactionOptions, type TombstoneCompactionStats, TraversalDepthError, type TryApplyPatchInPlaceResult, type TryApplyPatchResult, type TryDeserializeStateResult, type TryMergeStateResult, type ValidatePatchResult, applyPatch, applyPatchInPlace, compactStateTombstones, createState, deserializeState, diffJsonPatch, forkState, mergeState, serializeState, toJson, tryApplyPatch, tryApplyPatchInPlace, tryDeserializeState, tryMergeState, validateJsonPatch };
+import { B as forkState, C as diffJsonPatch, Et as PatchSemantics, F as PatchError, Ft as TombstoneCompactionOptions, G as validateJsonPatch, Gt as ValidatePatchResult, H as tryApplyPatch, I as applyPatch, It as TombstoneCompactionStats, K as ActorId, P as JsonValueValidationError, Pt as SerializedState, R as applyPatchInPlace, Rt as TryApplyPatchInPlaceResult, Tt as PatchErrorReason, Ut as TryMergeStateResult, V as toJson, Vt as TryDeserializeStateResult, W as tryApplyPatchInPlace, Wt as UnrelatedArraysStrategy, X as ApplyPatchInPlaceOptions, Z as ApplyPatchOptions, _t as JsonValidationMode, a as intersectVersionVectors, at as DeserializeErrorReason, b as tryDeserializeState, c as versionVectorCovers, d as mergeState, dt as ForkStateOptions, g as deserializeState, gt as JsonPrimitive, i as compactStateTombstones, it as CreateStateOptions, k as ClockValidationError, l as MergeError, m as DeserializeError, mt as JsonPatchOp, n as TraversalDepthError, o as mergeVersionVectors, ot as DeserializeFailure, p as tryMergeState, pt as JsonPatch, q as ApplyError, rt as CrdtState, s as observedVersionVector, st as DiffOptions, t as MAX_TRAVERSAL_DEPTH, tt as CompactStateTombstonesResult, v as serializeState, vt as JsonValue, xt as MergeStateOptions, z as createState, zt as TryApplyPatchResult } from "./depth-CM1kCxhm.mjs";
+export { type ActorId, type ApplyError, type ApplyPatchInPlaceOptions, type ApplyPatchOptions, ClockValidationError, type CompactStateTombstonesResult, type CrdtState, type CreateStateOptions, DeserializeError, type DeserializeErrorReason, type DeserializeFailure, type DiffOptions, type ForkStateOptions, type JsonPatch, type JsonPatchOp, type JsonPrimitive, type JsonValidationMode, type JsonValue, JsonValueValidationError, MAX_TRAVERSAL_DEPTH, MergeError, type MergeStateOptions, PatchError, type PatchErrorReason, type PatchSemantics, type SerializedState, type TombstoneCompactionOptions, type TombstoneCompactionStats, TraversalDepthError, type TryApplyPatchInPlaceResult, type TryApplyPatchResult, type TryDeserializeStateResult, type TryMergeStateResult, type UnrelatedArraysStrategy, type ValidatePatchResult, applyPatch, applyPatchInPlace, compactStateTombstones, createState, deserializeState, diffJsonPatch, forkState, intersectVersionVectors, mergeState, mergeVersionVectors, observedVersionVector, serializeState, toJson, tryApplyPatch, tryApplyPatchInPlace, tryDeserializeState, tryMergeState, validateJsonPatch, versionVectorCovers };

package/dist/index.d.ts

@@ -1,2 +1,2 @@
-import { $ as CreateStateOptions, A as PatchError, At as TombstoneCompactionOptions, B as validateJsonPatch, F as forkState, G as ApplyPatchInPlaceOptions, H as ApplyError, I as toJson, It as TryDeserializeStateResult, K as ApplyPatchOptions, L as tryApplyPatch, N as applyPatchInPlace, Nt as TryApplyPatchInPlaceResult, P as createState, Pt as TryApplyPatchResult, Q as CrdtState, Rt as TryMergeStateResult, V as ActorId, X as CompactStateTombstonesResult, a as MergeError, bt as PatchErrorReason, ct as JsonPatch, dt as JsonPrimitive, et as DeserializeErrorReason, f as deserializeState, ft as JsonValidationMode, g as tryDeserializeState, gt as MergeStateOptions, i as compactStateTombstones, j as applyPatch, jt as TombstoneCompactionStats, k as JsonValueValidationError, kt as SerializedState, l as tryMergeState, lt as JsonPatchOp, m as serializeState, n as TraversalDepthError, nt as DiffOptions, ot as ForkStateOptions, pt as JsonValue, s as mergeState, t as MAX_TRAVERSAL_DEPTH, tt as DeserializeFailure, u as DeserializeError, w as ClockValidationError, xt as PatchSemantics, y as diffJsonPatch, z as tryApplyPatchInPlace, zt as ValidatePatchResult } from "./depth-DSl2ghKu.js";
-export { type ActorId, type ApplyError, type ApplyPatchInPlaceOptions, type ApplyPatchOptions, ClockValidationError, type CompactStateTombstonesResult, type CrdtState, type CreateStateOptions, DeserializeError, type DeserializeErrorReason, type DeserializeFailure, type DiffOptions, type ForkStateOptions, type JsonPatch, type JsonPatchOp, type JsonPrimitive, type JsonValidationMode, type JsonValue, JsonValueValidationError, MAX_TRAVERSAL_DEPTH, MergeError, type MergeStateOptions, PatchError, type PatchErrorReason, type PatchSemantics, type SerializedState, type TombstoneCompactionOptions, type TombstoneCompactionStats, TraversalDepthError, type TryApplyPatchInPlaceResult, type TryApplyPatchResult, type TryDeserializeStateResult, type TryMergeStateResult, type ValidatePatchResult, applyPatch, applyPatchInPlace, compactStateTombstones, createState, deserializeState, diffJsonPatch, forkState, mergeState, serializeState, toJson, tryApplyPatch, tryApplyPatchInPlace, tryDeserializeState, tryMergeState, validateJsonPatch };
+import { B as forkState, C as diffJsonPatch, Et as PatchSemantics, F as PatchError, Ft as TombstoneCompactionOptions, G as validateJsonPatch, Gt as ValidatePatchResult, H as tryApplyPatch, I as applyPatch, It as TombstoneCompactionStats, K as ActorId, P as JsonValueValidationError, Pt as SerializedState, R as applyPatchInPlace, Rt as TryApplyPatchInPlaceResult, Tt as PatchErrorReason, Ut as TryMergeStateResult, V as toJson, Vt as TryDeserializeStateResult, W as tryApplyPatchInPlace, Wt as UnrelatedArraysStrategy, X as ApplyPatchInPlaceOptions, Z as ApplyPatchOptions, _t as JsonValidationMode, a as intersectVersionVectors, at as DeserializeErrorReason, b as tryDeserializeState, c as versionVectorCovers, d as mergeState, dt as ForkStateOptions, g as deserializeState, gt as JsonPrimitive, i as compactStateTombstones, it as CreateStateOptions, k as ClockValidationError, l as MergeError, m as DeserializeError, mt as JsonPatchOp, n as TraversalDepthError, o as mergeVersionVectors, ot as DeserializeFailure, p as tryMergeState, pt as JsonPatch, q as ApplyError, rt as CrdtState, s as observedVersionVector, st as DiffOptions, t as MAX_TRAVERSAL_DEPTH, tt as CompactStateTombstonesResult, v as serializeState, vt as JsonValue, xt as MergeStateOptions, z as createState, zt as TryApplyPatchResult } from "./depth-NbZ6Giq9.js";
+export { type ActorId, type ApplyError, type ApplyPatchInPlaceOptions, type ApplyPatchOptions, ClockValidationError, type CompactStateTombstonesResult, type CrdtState, type CreateStateOptions, DeserializeError, type DeserializeErrorReason, type DeserializeFailure, type DiffOptions, type ForkStateOptions, type JsonPatch, type JsonPatchOp, type JsonPrimitive, type JsonValidationMode, type JsonValue, JsonValueValidationError, MAX_TRAVERSAL_DEPTH, MergeError, type MergeStateOptions, PatchError, type PatchErrorReason, type PatchSemantics, type SerializedState, type TombstoneCompactionOptions, type TombstoneCompactionStats, TraversalDepthError, type TryApplyPatchInPlaceResult, type TryApplyPatchResult, type TryDeserializeStateResult, type TryMergeStateResult, type UnrelatedArraysStrategy, type ValidatePatchResult, applyPatch, applyPatchInPlace, compactStateTombstones, createState, deserializeState, diffJsonPatch, forkState, intersectVersionVectors, mergeState, mergeVersionVectors, observedVersionVector, serializeState, toJson, tryApplyPatch, tryApplyPatchInPlace, tryDeserializeState, tryMergeState, validateJsonPatch, versionVectorCovers };

package/dist/index.js

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_compact = require('./compact-BToZE6Q6.js');
+const require_compact = require('./compact-CDvajUfn.js');
 
 exports.ClockValidationError = require_compact.ClockValidationError;
 exports.DeserializeError = require_compact.DeserializeError;
@@ -15,11 +15,15 @@ exports.createState = require_compact.createState;
 exports.deserializeState = require_compact.deserializeState;
 exports.diffJsonPatch = require_compact.diffJsonPatch;
 exports.forkState = require_compact.forkState;
+exports.intersectVersionVectors = require_compact.intersectVersionVectors;
 exports.mergeState = require_compact.mergeState;
+exports.mergeVersionVectors = require_compact.mergeVersionVectors;
+exports.observedVersionVector = require_compact.observedVersionVector;
 exports.serializeState = require_compact.serializeState;
 exports.toJson = require_compact.toJson;
 exports.tryApplyPatch = require_compact.tryApplyPatch;
 exports.tryApplyPatchInPlace = require_compact.tryApplyPatchInPlace;
 exports.tryDeserializeState = require_compact.tryDeserializeState;
 exports.tryMergeState = require_compact.tryMergeState;
-exports.validateJsonPatch = require_compact.validateJsonPatch;
+exports.validateJsonPatch = require_compact.validateJsonPatch;
+exports.versionVectorCovers = require_compact.versionVectorCovers;

package/dist/index.mjs

@@ -1,3 +1,3 @@
-import { R as diffJsonPatch, S as tryApplyPatch, T as validateJsonPatch, W as JsonValueValidationError, a as mergeState, b as forkState, c as DeserializeError, f as serializeState, ft as MAX_TRAVERSAL_DEPTH, g as applyPatch, h as PatchError, m as tryDeserializeState, mt as ClockValidationError, n as compactStateTombstones, pt as TraversalDepthError, r as MergeError, s as tryMergeState, u as deserializeState, v as applyPatchInPlace, w as tryApplyPatchInPlace, x as toJson, y as createState } from "./compact-BS7F604m.mjs";
+import { Ct as TraversalDepthError, G as JsonValueValidationError, R as diffJsonPatch, S as tryApplyPatch, St as MAX_TRAVERSAL_DEPTH, T as validateJsonPatch, a as mergeState, b as forkState, bt as observedVersionVector, c as DeserializeError, f as serializeState, g as applyPatch, h as PatchError, m as tryDeserializeState, n as compactStateTombstones, pt as ClockValidationError, r as MergeError, s as tryMergeState, u as deserializeState, v as applyPatchInPlace, vt as intersectVersionVectors, w as tryApplyPatchInPlace, x as toJson, xt as versionVectorCovers, y as createState, yt as mergeVersionVectors } from "./compact-Dj0BYeY5.mjs";
 
-export { ClockValidationError, DeserializeError, JsonValueValidationError, MAX_TRAVERSAL_DEPTH, MergeError, PatchError, TraversalDepthError, applyPatch, applyPatchInPlace, compactStateTombstones, createState, deserializeState, diffJsonPatch, forkState, mergeState, serializeState, toJson, tryApplyPatch, tryApplyPatchInPlace, tryDeserializeState, tryMergeState, validateJsonPatch };
+export { ClockValidationError, DeserializeError, JsonValueValidationError, MAX_TRAVERSAL_DEPTH, MergeError, PatchError, TraversalDepthError, applyPatch, applyPatchInPlace, compactStateTombstones, createState, deserializeState, diffJsonPatch, forkState, intersectVersionVectors, mergeState, mergeVersionVectors, observedVersionVector, serializeState, toJson, tryApplyPatch, tryApplyPatchInPlace, tryDeserializeState, tryMergeState, validateJsonPatch, versionVectorCovers };

package/dist/internals.d.mts

@@ -1,4 +1,4 @@
-import { $ as CreateStateOptions, A as PatchError, At as TombstoneCompactionOptions, B as validateJsonPatch, Bt as VersionVector, C as stringifyJsonPointer, Ct as RgaElem, D as nextDotForActor, Dt as SerializedNode, E as createClock, Et as SerializedDoc, F as forkState, Ft as TryDeserializeDocResult, G as ApplyPatchInPlaceOptions, H as ApplyError, I as toJson, It as TryDeserializeStateResult, J as Clock, K as ApplyPatchOptions, L as tryApplyPatch, Lt as TryMergeDocResult, M as applyPatchAsActor, Mt as TryApplyPatchAsActorResult, N as applyPatchInPlace, Nt as TryApplyPatchInPlaceResult, O as observeDot, Ot as SerializedRgaElem, P as createState, Pt as TryApplyPatchResult, Q as CrdtState, R as tryApplyPatchAsActor, Rt as TryMergeStateResult, S as parseJsonPointer, St as ROOT_KEY, T as cloneClock, Tt as SerializedClock, U as ApplyPatchAsActorOptions, V as ActorId, W as ApplyPatchAsActorResult, X as CompactStateTombstonesResult, Y as CompactDocTombstonesResult, Z as CompilePatchOptions, _ as PatchCompileError, _t as Node, a as MergeError, at as ElemId, b as getAtJson, bt as PatchErrorReason, c as tryMergeDoc, ct as JsonPatch, d as deserializeDoc, dt as JsonPrimitive, et as DeserializeErrorReason, f as deserializeState, ft as JsonValidationMode, g as tryDeserializeState, gt as MergeStateOptions, h as tryDeserializeDoc, ht as MergeDocOptions, i as compactStateTombstones, it as Dot, j as applyPatch, jt as TombstoneCompactionStats, k as JsonValueValidationError, kt as SerializedState, l as tryMergeState, lt as JsonPatchOp, m as serializeState, mt as LwwReg, n as TraversalDepthError, nt as DiffOptions, o as mergeDoc, ot as ForkStateOptions, p as serializeDoc, pt as JsonValue, q as ApplyResult, r as compactDocTombstones, rt as Doc, s as mergeState, st as IntentOp, t as MAX_TRAVERSAL_DEPTH, tt as DeserializeFailure, u as DeserializeError, ut as JsonPatchToCrdtOptions, v as compileJsonPatchToIntent, vt as ObjEntry, w as ClockValidationError, wt as RgaSeq, x as jsonEquals, xt as PatchSemantics, y as diffJsonPatch, yt as ObjNode, z as tryApplyPatchInPlace, zt as ValidatePatchResult } from "./depth-BTHjgY18.mjs";
+import { $ as Clock, A as cloneClock, At as SerializedClock, B as forkState, Bt as TryDeserializeDocResult, C as diffJsonPatch, Ct as ObjEntry, D as stableJsonValueKey, Dt as ROOT_KEY, E as parseJsonPointer, Et as PatchSemantics, F as PatchError, Ft as TombstoneCompactionOptions, G as validateJsonPatch, Gt as ValidatePatchResult, H as tryApplyPatch, Ht as TryMergeDocResult, I as applyPatch, It as TombstoneCompactionStats, J as ApplyPatchAsActorOptions, K as ActorId, Kt as VersionVector, L as applyPatchAsActor, Lt as TryApplyPatchAsActorResult, M as nextDotForActor, Mt as SerializedNode, N as observeDot, Nt as SerializedRgaElem, O as stringifyJsonPointer, Ot as RgaElem, P as JsonValueValidationError, Pt as SerializedState, Q as ApplyResult, R as applyPatchInPlace, Rt as TryApplyPatchInPlaceResult, S as compileJsonPatchToIntent, St as Node, T as jsonEquals, Tt as PatchErrorReason, U as tryApplyPatchAsActor, Ut as TryMergeStateResult, V as toJson, Vt as TryDeserializeStateResult, W as tryApplyPatchInPlace, Wt as UnrelatedArraysStrategy, X as ApplyPatchInPlaceOptions, Y as ApplyPatchAsActorResult, Z as ApplyPatchOptions, _ as serializeDoc, _t as JsonValidationMode, a as intersectVersionVectors, at as DeserializeErrorReason, b as tryDeserializeState, bt as MergeDocOptions, c as versionVectorCovers, ct as Doc, d as mergeState, dt as ForkStateOptions, et as CompactDocTombstonesResult, f as tryMergeDoc, ft as IntentOp, g as deserializeState, gt as JsonPrimitive, h as deserializeDoc, ht as JsonPatchToCrdtOptions, i as compactStateTombstones, it as CreateStateOptions, j as createClock, jt as SerializedDoc, k as ClockValidationError, kt as RgaSeq, l as MergeError, lt as Dot, m as DeserializeError, mt as JsonPatchOp, n as TraversalDepthError, nt as CompilePatchOptions, o as mergeVersionVectors, ot as DeserializeFailure, p as tryMergeState, pt as JsonPatch, q as ApplyError, r as compactDocTombstones, rt as CrdtState, s as observedVersionVector, st as DiffOptions, t as MAX_TRAVERSAL_DEPTH, tt as CompactStateTombstonesResult, u as mergeDoc, ut as ElemId, v as serializeState, vt as JsonValue, w as getAtJson, wt as ObjNode, x as PatchCompileError, xt as MergeStateOptions, y as tryDeserializeDoc, yt as LwwReg, z as createState, zt as TryApplyPatchResult } from "./depth-CM1kCxhm.mjs";
 
 //#region src/doc.d.ts
 /**
@@ -9,8 +9,15 @@ import { $ as CreateStateOptions, A as PatchError, At as TombstoneCompactionOpti
  */
 declare function docFromJson(value: JsonValue, nextDot: () => Dot): Doc;
 /**
- * Legacy: create a doc using a single dot with counter offsets for array children.
- * Prefer `docFromJson(value, nextDot)` to ensure unique dots per node.
+ * Legacy helper for tests and fixtures that seeds an entire document from one dot.
+ *
+ * It reuses that dot for object entries and synthesizes array child counters from the
+ * same seed, which can produce low-quality causal metadata and unrealistic sequence
+ * identities in production CRDT state.
+ *
+ * Prefer `docFromJson(value, nextDot)` so every node receives a fresh unique dot.
+ *
+ * @deprecated Use `docFromJson(value, nextDot)` for production documents.
  */
 declare function docFromJsonWithDot(value: JsonValue, dot: Dot): Doc;
 /** Deep-clone a CRDT document. The clone is fully independent of the original. */
@@ -128,4 +135,4 @@ declare function rgaCompactTombstones(seq: RgaSeq, isStable: (dot: Dot) => boole
 declare function rgaIdAtIndex(seq: RgaSeq, index: number): ElemId | undefined;
 declare function rgaPrevForInsertAtIndex(seq: RgaSeq, index: number): ElemId;
 //#endregion
-export { ActorId, ApplyError, type ApplyPatchAsActorOptions, type ApplyPatchAsActorResult, ApplyPatchInPlaceOptions, ApplyPatchOptions, type ApplyResult, type Clock, ClockValidationError, type CompactDocTombstonesResult, type CompactStateTombstonesResult, type CompilePatchOptions, CrdtState, CreateStateOptions, DeserializeError, DeserializeErrorReason, type DeserializeFailure, DiffOptions, type Doc, type Dot, type ElemId, ForkStateOptions, HEAD, type IntentOp, JsonPatch, JsonPatchOp, type JsonPatchToCrdtOptions, JsonPrimitive, JsonValidationMode, JsonValue, JsonValueValidationError, type LwwReg, MAX_TRAVERSAL_DEPTH, type MergeDocOptions, MergeError, MergeStateOptions, type Node, type ObjEntry, type ObjNode, PatchCompileError, PatchError, PatchErrorReason, PatchSemantics, ROOT_KEY, type RgaElem, type RgaSeq, type RgaValidationIssue, type RgaValidationResult, type SerializedClock, type SerializedDoc, type SerializedNode, type SerializedRgaElem, SerializedState, type TombstoneCompactionOptions, type TombstoneCompactionStats, TraversalDepthError, type TryApplyPatchAsActorResult, TryApplyPatchInPlaceResult, TryApplyPatchResult, type TryDeserializeDocResult, TryDeserializeStateResult, type TryMergeDocResult, TryMergeStateResult, ValidatePatchResult, type VersionVector, applyIntentsToCrdt, applyPatch, applyPatchAsActor, applyPatchInPlace, cloneClock, cloneDoc, compactDocTombstones, compactStateTombstones, compareDot, compileJsonPatchToIntent, crdtNodesToJsonPatch, crdtToFullReplace, crdtToJsonPatch, createClock, createState, deserializeDoc, deserializeState, diffJsonPatch, docFromJson, docFromJsonWithDot, dotToElemId, forkState, getAtJson, jsonEquals, jsonPatchToCrdt, jsonPatchToCrdtSafe, lwwSet, materialize, mergeDoc, mergeState, newObj, newReg, newSeq, nextDotForActor, objCompactTombstones, objRemove, objSet, observeDot, parseJsonPointer, rgaCompactTombstones, rgaDelete, rgaIdAtIndex, rgaInsertAfter, rgaInsertAfterChecked, rgaLinearizeIds, rgaPrevForInsertAtIndex, serializeDoc, serializeState, stringifyJsonPointer, toJson, tryApplyPatch, tryApplyPatchAsActor, tryApplyPatchInPlace, tryDeserializeDoc, tryDeserializeState, tryJsonPatchToCrdt, tryMergeDoc, tryMergeState, validateJsonPatch, validateRgaSeq, vvHasDot, vvMerge };
+export { ActorId, ApplyError, type ApplyPatchAsActorOptions, type ApplyPatchAsActorResult, ApplyPatchInPlaceOptions, ApplyPatchOptions, type ApplyResult, type Clock, ClockValidationError, type CompactDocTombstonesResult, type CompactStateTombstonesResult, type CompilePatchOptions, CrdtState, CreateStateOptions, DeserializeError, DeserializeErrorReason, type DeserializeFailure, DiffOptions, type Doc, type Dot, type ElemId, ForkStateOptions, HEAD, type IntentOp, JsonPatch, JsonPatchOp, type JsonPatchToCrdtOptions, JsonPrimitive, JsonValidationMode, JsonValue, JsonValueValidationError, type LwwReg, MAX_TRAVERSAL_DEPTH, type MergeDocOptions, MergeError, MergeStateOptions, type Node, type ObjEntry, type ObjNode, PatchCompileError, PatchError, PatchErrorReason, PatchSemantics, ROOT_KEY, type RgaElem, type RgaSeq, type RgaValidationIssue, type RgaValidationResult, type SerializedClock, type SerializedDoc, type SerializedNode, type SerializedRgaElem, SerializedState, type TombstoneCompactionOptions, type TombstoneCompactionStats, TraversalDepthError, type TryApplyPatchAsActorResult, TryApplyPatchInPlaceResult, TryApplyPatchResult, type TryDeserializeDocResult, TryDeserializeStateResult, type TryMergeDocResult, TryMergeStateResult, type UnrelatedArraysStrategy, ValidatePatchResult, type VersionVector, applyIntentsToCrdt, applyPatch, applyPatchAsActor, applyPatchInPlace, cloneClock, cloneDoc, compactDocTombstones, compactStateTombstones, compareDot, compileJsonPatchToIntent, crdtNodesToJsonPatch, crdtToFullReplace, crdtToJsonPatch, createClock, createState, deserializeDoc, deserializeState, diffJsonPatch, docFromJson, docFromJsonWithDot, dotToElemId, forkState, getAtJson, intersectVersionVectors, jsonEquals, jsonPatchToCrdt, jsonPatchToCrdtSafe, lwwSet, materialize, mergeDoc, mergeState, mergeVersionVectors, newObj, newReg, newSeq, nextDotForActor, objCompactTombstones, objRemove, objSet, observeDot, observedVersionVector, parseJsonPointer, rgaCompactTombstones, rgaDelete, rgaIdAtIndex, rgaInsertAfter, rgaInsertAfterChecked, rgaLinearizeIds, rgaPrevForInsertAtIndex, serializeDoc, serializeState, stableJsonValueKey, stringifyJsonPointer, toJson, tryApplyPatch, tryApplyPatchAsActor, tryApplyPatchInPlace, tryDeserializeDoc, tryDeserializeState, tryJsonPatchToCrdt, tryMergeDoc, tryMergeState, validateJsonPatch, validateRgaSeq, versionVectorCovers, vvHasDot, vvMerge };

package/dist/internals.d.ts

@@ -1,4 +1,4 @@
-import { $ as CreateStateOptions, A as PatchError, At as TombstoneCompactionOptions, B as validateJsonPatch, Bt as VersionVector, C as stringifyJsonPointer, Ct as RgaElem, D as nextDotForActor, Dt as SerializedNode, E as createClock, Et as SerializedDoc, F as forkState, Ft as TryDeserializeDocResult, G as ApplyPatchInPlaceOptions, H as ApplyError, I as toJson, It as TryDeserializeStateResult, J as Clock, K as ApplyPatchOptions, L as tryApplyPatch, Lt as TryMergeDocResult, M as applyPatchAsActor, Mt as TryApplyPatchAsActorResult, N as applyPatchInPlace, Nt as TryApplyPatchInPlaceResult, O as observeDot, Ot as SerializedRgaElem, P as createState, Pt as TryApplyPatchResult, Q as CrdtState, R as tryApplyPatchAsActor, Rt as TryMergeStateResult, S as parseJsonPointer, St as ROOT_KEY, T as cloneClock, Tt as SerializedClock, U as ApplyPatchAsActorOptions, V as ActorId, W as ApplyPatchAsActorResult, X as CompactStateTombstonesResult, Y as CompactDocTombstonesResult, Z as CompilePatchOptions, _ as PatchCompileError, _t as Node, a as MergeError, at as ElemId, b as getAtJson, bt as PatchErrorReason, c as tryMergeDoc, ct as JsonPatch, d as deserializeDoc, dt as JsonPrimitive, et as DeserializeErrorReason, f as deserializeState, ft as JsonValidationMode, g as tryDeserializeState, gt as MergeStateOptions, h as tryDeserializeDoc, ht as MergeDocOptions, i as compactStateTombstones, it as Dot, j as applyPatch, jt as TombstoneCompactionStats, k as JsonValueValidationError, kt as SerializedState, l as tryMergeState, lt as JsonPatchOp, m as serializeState, mt as LwwReg, n as TraversalDepthError, nt as DiffOptions, o as mergeDoc, ot as ForkStateOptions, p as serializeDoc, pt as JsonValue, q as ApplyResult, r as compactDocTombstones, rt as Doc, s as mergeState, st as IntentOp, t as MAX_TRAVERSAL_DEPTH, tt as DeserializeFailure, u as DeserializeError, ut as JsonPatchToCrdtOptions, v as compileJsonPatchToIntent, vt as ObjEntry, w as ClockValidationError, wt as RgaSeq, x as jsonEquals, xt as PatchSemantics, y as diffJsonPatch, yt as ObjNode, z as tryApplyPatchInPlace, zt as ValidatePatchResult } from "./depth-DSl2ghKu.js";
+import { $ as Clock, A as cloneClock, At as SerializedClock, B as forkState, Bt as TryDeserializeDocResult, C as diffJsonPatch, Ct as ObjEntry, D as stableJsonValueKey, Dt as ROOT_KEY, E as parseJsonPointer, Et as PatchSemantics, F as PatchError, Ft as TombstoneCompactionOptions, G as validateJsonPatch, Gt as ValidatePatchResult, H as tryApplyPatch, Ht as TryMergeDocResult, I as applyPatch, It as TombstoneCompactionStats, J as ApplyPatchAsActorOptions, K as ActorId, Kt as VersionVector, L as applyPatchAsActor, Lt as TryApplyPatchAsActorResult, M as nextDotForActor, Mt as SerializedNode, N as observeDot, Nt as SerializedRgaElem, O as stringifyJsonPointer, Ot as RgaElem, P as JsonValueValidationError, Pt as SerializedState, Q as ApplyResult, R as applyPatchInPlace, Rt as TryApplyPatchInPlaceResult, S as compileJsonPatchToIntent, St as Node, T as jsonEquals, Tt as PatchErrorReason, U as tryApplyPatchAsActor, Ut as TryMergeStateResult, V as toJson, Vt as TryDeserializeStateResult, W as tryApplyPatchInPlace, Wt as UnrelatedArraysStrategy, X as ApplyPatchInPlaceOptions, Y as ApplyPatchAsActorResult, Z as ApplyPatchOptions, _ as serializeDoc, _t as JsonValidationMode, a as intersectVersionVectors, at as DeserializeErrorReason, b as tryDeserializeState, bt as MergeDocOptions, c as versionVectorCovers, ct as Doc, d as mergeState, dt as ForkStateOptions, et as CompactDocTombstonesResult, f as tryMergeDoc, ft as IntentOp, g as deserializeState, gt as JsonPrimitive, h as deserializeDoc, ht as JsonPatchToCrdtOptions, i as compactStateTombstones, it as CreateStateOptions, j as createClock, jt as SerializedDoc, k as ClockValidationError, kt as RgaSeq, l as MergeError, lt as Dot, m as DeserializeError, mt as JsonPatchOp, n as TraversalDepthError, nt as CompilePatchOptions, o as mergeVersionVectors, ot as DeserializeFailure, p as tryMergeState, pt as JsonPatch, q as ApplyError, r as compactDocTombstones, rt as CrdtState, s as observedVersionVector, st as DiffOptions, t as MAX_TRAVERSAL_DEPTH, tt as CompactStateTombstonesResult, u as mergeDoc, ut as ElemId, v as serializeState, vt as JsonValue, w as getAtJson, wt as ObjNode, x as PatchCompileError, xt as MergeStateOptions, y as tryDeserializeDoc, yt as LwwReg, z as createState, zt as TryApplyPatchResult } from "./depth-NbZ6Giq9.js";
 
 //#region src/doc.d.ts
 /**
@@ -9,8 +9,15 @@ import { $ as CreateStateOptions, A as PatchError, At as TombstoneCompactionOpti
  */
 declare function docFromJson(value: JsonValue, nextDot: () => Dot): Doc;
 /**
- * Legacy: create a doc using a single dot with counter offsets for array children.
- * Prefer `docFromJson(value, nextDot)` to ensure unique dots per node.
+ * Legacy helper for tests and fixtures that seeds an entire document from one dot.
+ *
+ * It reuses that dot for object entries and synthesizes array child counters from the
+ * same seed, which can produce low-quality causal metadata and unrealistic sequence
+ * identities in production CRDT state.
+ *
+ * Prefer `docFromJson(value, nextDot)` so every node receives a fresh unique dot.
+ *
+ * @deprecated Use `docFromJson(value, nextDot)` for production documents.
  */
 declare function docFromJsonWithDot(value: JsonValue, dot: Dot): Doc;
 /** Deep-clone a CRDT document. The clone is fully independent of the original. */
@@ -128,4 +135,4 @@ declare function rgaCompactTombstones(seq: RgaSeq, isStable: (dot: Dot) => boole
 declare function rgaIdAtIndex(seq: RgaSeq, index: number): ElemId | undefined;
 declare function rgaPrevForInsertAtIndex(seq: RgaSeq, index: number): ElemId;
 //#endregion
-export { ActorId, ApplyError, type ApplyPatchAsActorOptions, type ApplyPatchAsActorResult, ApplyPatchInPlaceOptions, ApplyPatchOptions, type ApplyResult, type Clock, ClockValidationError, type CompactDocTombstonesResult, type CompactStateTombstonesResult, type CompilePatchOptions, CrdtState, CreateStateOptions, DeserializeError, DeserializeErrorReason, type DeserializeFailure, DiffOptions, type Doc, type Dot, type ElemId, ForkStateOptions, HEAD, type IntentOp, JsonPatch, JsonPatchOp, type JsonPatchToCrdtOptions, JsonPrimitive, JsonValidationMode, JsonValue, JsonValueValidationError, type LwwReg, MAX_TRAVERSAL_DEPTH, type MergeDocOptions, MergeError, MergeStateOptions, type Node, type ObjEntry, type ObjNode, PatchCompileError, PatchError, PatchErrorReason, PatchSemantics, ROOT_KEY, type RgaElem, type RgaSeq, type RgaValidationIssue, type RgaValidationResult, type SerializedClock, type SerializedDoc, type SerializedNode, type SerializedRgaElem, SerializedState, type TombstoneCompactionOptions, type TombstoneCompactionStats, TraversalDepthError, type TryApplyPatchAsActorResult, TryApplyPatchInPlaceResult, TryApplyPatchResult, type TryDeserializeDocResult, TryDeserializeStateResult, type TryMergeDocResult, TryMergeStateResult, ValidatePatchResult, type VersionVector, applyIntentsToCrdt, applyPatch, applyPatchAsActor, applyPatchInPlace, cloneClock, cloneDoc, compactDocTombstones, compactStateTombstones, compareDot, compileJsonPatchToIntent, crdtNodesToJsonPatch, crdtToFullReplace, crdtToJsonPatch, createClock, createState, deserializeDoc, deserializeState, diffJsonPatch, docFromJson, docFromJsonWithDot, dotToElemId, forkState, getAtJson, jsonEquals, jsonPatchToCrdt, jsonPatchToCrdtSafe, lwwSet, materialize, mergeDoc, mergeState, newObj, newReg, newSeq, nextDotForActor, objCompactTombstones, objRemove, objSet, observeDot, parseJsonPointer, rgaCompactTombstones, rgaDelete, rgaIdAtIndex, rgaInsertAfter, rgaInsertAfterChecked, rgaLinearizeIds, rgaPrevForInsertAtIndex, serializeDoc, serializeState, stringifyJsonPointer, toJson, tryApplyPatch, tryApplyPatchAsActor, tryApplyPatchInPlace, tryDeserializeDoc, tryDeserializeState, tryJsonPatchToCrdt, tryMergeDoc, tryMergeState, validateJsonPatch, validateRgaSeq, vvHasDot, vvMerge };
+export { ActorId, ApplyError, type ApplyPatchAsActorOptions, type ApplyPatchAsActorResult, ApplyPatchInPlaceOptions, ApplyPatchOptions, type ApplyResult, type Clock, ClockValidationError, type CompactDocTombstonesResult, type CompactStateTombstonesResult, type CompilePatchOptions, CrdtState, CreateStateOptions, DeserializeError, DeserializeErrorReason, type DeserializeFailure, DiffOptions, type Doc, type Dot, type ElemId, ForkStateOptions, HEAD, type IntentOp, JsonPatch, JsonPatchOp, type JsonPatchToCrdtOptions, JsonPrimitive, JsonValidationMode, JsonValue, JsonValueValidationError, type LwwReg, MAX_TRAVERSAL_DEPTH, type MergeDocOptions, MergeError, MergeStateOptions, type Node, type ObjEntry, type ObjNode, PatchCompileError, PatchError, PatchErrorReason, PatchSemantics, ROOT_KEY, type RgaElem, type RgaSeq, type RgaValidationIssue, type RgaValidationResult, type SerializedClock, type SerializedDoc, type SerializedNode, type SerializedRgaElem, SerializedState, type TombstoneCompactionOptions, type TombstoneCompactionStats, TraversalDepthError, type TryApplyPatchAsActorResult, TryApplyPatchInPlaceResult, TryApplyPatchResult, type TryDeserializeDocResult, TryDeserializeStateResult, type TryMergeDocResult, TryMergeStateResult, type UnrelatedArraysStrategy, ValidatePatchResult, type VersionVector, applyIntentsToCrdt, applyPatch, applyPatchAsActor, applyPatchInPlace, cloneClock, cloneDoc, compactDocTombstones, compactStateTombstones, compareDot, compileJsonPatchToIntent, crdtNodesToJsonPatch, crdtToFullReplace, crdtToJsonPatch, createClock, createState, deserializeDoc, deserializeState, diffJsonPatch, docFromJson, docFromJsonWithDot, dotToElemId, forkState, getAtJson, intersectVersionVectors, jsonEquals, jsonPatchToCrdt, jsonPatchToCrdtSafe, lwwSet, materialize, mergeDoc, mergeState, mergeVersionVectors, newObj, newReg, newSeq, nextDotForActor, objCompactTombstones, objRemove, objSet, observeDot, observedVersionVector, parseJsonPointer, rgaCompactTombstones, rgaDelete, rgaIdAtIndex, rgaInsertAfter, rgaInsertAfterChecked, rgaLinearizeIds, rgaPrevForInsertAtIndex, serializeDoc, serializeState, stableJsonValueKey, stringifyJsonPointer, toJson, tryApplyPatch, tryApplyPatchAsActor, tryApplyPatchInPlace, tryDeserializeDoc, tryDeserializeState, tryJsonPatchToCrdt, tryMergeDoc, tryMergeState, validateJsonPatch, validateRgaSeq, versionVectorCovers, vvHasDot, vvMerge };