json-patch-to-crdt 0.1.2 → 0.2.0

package/dist/{depth-p6fX9Ak7.d.ts → depth-Cd3nyHWy.d.mts}

@@ -14,6 +14,13 @@ type JsonPrimitive = null | boolean | number | string;
 type JsonValue = JsonPrimitive | JsonValue[] | {
   [k: string]: 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.
+ */
+type JsonValidationMode = "none" | "strict" | "normalize";
 /** Mutable clock that tracks an actor's identity and monotonic counter. */
 type Clock = {
   actor: ActorId;
@@ -94,6 +101,19 @@ type SerializedState = {
 };
 /** 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. */
+type DeserializeFailure = {
+  code: 409;
+  reason: DeserializeErrorReason;
+  path: string;
+  message: string;
+} | {
+  code: 409;
+  reason: "MAX_DEPTH_EXCEEDED";
+  message: string;
+  depth: number;
+  maxDepth: number;
+};
 /**
  * Internal intent operations produced by compiling RFC 6902 JSON Patch ops.
  * Each variant maps to a specific CRDT mutation.
@@ -163,6 +183,16 @@ type CrdtState = {
   doc: Doc;
   clock: Clock;
 };
+/** Options for `createState`. */
+interface CreateStateOptions {
+  actor: ActorId;
+  start?: number;
+  /**
+   * Runtime guardrails for non-JSON values from untyped callers.
+   * Defaults to `"none"` for backward compatibility.
+   */
+  jsonValidation?: JsonValidationMode;
+}
 /** Options for `forkState`. */
 interface ForkStateOptions {
   /**
@@ -181,6 +211,15 @@ type ApplyPatchAsActorOptions = {
   base?: Doc;
   testAgainst?: "head" | "base";
   semantics?: PatchSemantics;
+  strictParents?: boolean;
+  jsonValidation?: JsonValidationMode;
+};
+/** Non-throwing result for internals-only `tryApplyPatchAsActor`. */
+type TryApplyPatchAsActorResult = ({
+  ok: true;
+} & ApplyPatchAsActorResult) | {
+  ok: false;
+  error: ApplyError;
 };
 /** Typed failure reason used across patch/merge helpers. */
 type PatchErrorReason = "INVALID_PATCH" | "INVALID_POINTER" | "MISSING_PARENT" | "MISSING_TARGET" | "INVALID_TARGET" | "OUT_OF_BOUNDS" | "TEST_FAILED" | "INVALID_MOVE" | "DOT_GENERATION_EXHAUSTED" | "MAX_DEPTH_EXCEEDED" | "LINEAGE_MISMATCH";
@@ -197,6 +236,22 @@ type ApplyError = {
 type ApplyResult = {
   ok: true;
 } | ApplyError;
+/** Non-throwing result for `deserializeDoc`. */
+type TryDeserializeDocResult = {
+  ok: true;
+  doc: Doc;
+} | {
+  ok: false;
+  error: DeserializeFailure;
+};
+/** Non-throwing result for `deserializeState`. */
+type TryDeserializeStateResult = {
+  ok: true;
+  state: CrdtState;
+} | {
+  ok: false;
+  error: DeserializeFailure;
+};
 /** How JSON Patch operations are interpreted during application. */
 type PatchSemantics = "base" | "sequential";
 /** Options for compile/validation helpers. */
@@ -213,6 +268,17 @@ type ApplyPatchOptions = {
   base?: CrdtState;
   testAgainst?: "head" | "base";
   semantics?: PatchSemantics;
+  /**
+   * Reject array inserts when the base parent path is missing.
+   * Defaults to `false` to preserve legacy behavior that can auto-create
+   * missing arrays for index `0` / append intents.
+   */
+  strictParents?: boolean;
+  /**
+   * Runtime guardrails for patch payload values from untyped callers.
+   * Defaults to `"none"` for backward compatibility.
+   */
+  jsonValidation?: JsonValidationMode;
 };
 /** Options for in-place patch application (`applyPatchInPlace` / `tryApplyPatchInPlace`). */
 type ApplyPatchInPlaceOptions = ApplyPatchOptions & {
@@ -314,6 +380,7 @@ type JsonPatchToCrdtOptions = {
   evalTestAgainst?: "head" | "base";
   bumpCounterAbove?: (ctr: number) => void;
   semantics?: PatchSemantics;
+  strictParents?: boolean;
 };
 /** Options for `crdtToJsonPatch` and `diffJsonPatch`. */
 type DiffOptions = {
@@ -330,6 +397,11 @@ type DiffOptions = {
    * Set to `Number.POSITIVE_INFINITY` to always allow LCS.
    */
   lcsMaxCells?: number;
+  /**
+   * Runtime guardrails for diff inputs from untyped callers.
+   * Defaults to `"none"` for backward compatibility.
+   */
+  jsonValidation?: JsonValidationMode;
 };
 /**
  * Internal sentinel key used in `IntentOp` to represent root-level operations.
@@ -353,10 +425,7 @@ declare class PatchError extends Error {
  * @param options - Actor ID and optional starting counter.
  * @returns A new `CrdtState` containing the document and clock.
  */
-declare function createState(initial: JsonValue, options: {
-  actor: ActorId;
-  start?: number;
-}): CrdtState;
+declare function createState(initial: JsonValue, options: CreateStateOptions): CrdtState;
 /**
  * Fork a replica from a shared origin state while assigning a new local actor ID.
  * The forked state has an independent document clone and clock.
@@ -400,6 +469,41 @@ declare function validateJsonPatch(base: JsonValue, patch: JsonPatchOp[], option
  * Returns the updated state and a new version vector snapshot.
  */
 declare function applyPatchAsActor(doc: Doc, vv: VersionVector, actor: ActorId, patch: JsonPatchOp[], options?: ApplyPatchAsActorOptions): ApplyPatchAsActorResult;
+/** Non-throwing `applyPatchAsActor` variant for internals sync flows. */
+declare function tryApplyPatchAsActor(doc: Doc, vv: VersionVector, actor: ActorId, patch: JsonPatchOp[], options?: ApplyPatchAsActorOptions): TryApplyPatchAsActorResult;
+//#endregion
+//#region src/json-value.d.ts
+/**
+ * Runtime validation error for values that are not JSON-compatible.
+ * `path` is an RFC 6901 pointer relative to the validated root.
+ */
+declare class JsonValueValidationError extends TypeError {
+  readonly path: string;
+  readonly detail: string;
+  constructor(path: string, detail: string);
+}
+//#endregion
+//#region src/clock.d.ts
+type ClockValidationErrorReason = "INVALID_ACTOR" | "INVALID_COUNTER";
+declare class ClockValidationError extends TypeError {
+  readonly reason: ClockValidationErrorReason;
+  constructor(reason: ClockValidationErrorReason, message: string);
+}
+/**
+ * Create a new clock for the given actor. Each call to `clock.next()` yields a fresh `Dot`.
+ * @param actor - Unique identifier for this peer.
+ * @param start - Initial counter value (defaults to 0).
+ */
+declare function createClock(actor: ActorId, start?: number): Clock;
+/** Create an independent copy of a clock at the same counter position. */
+declare function cloneClock(clock: Clock): Clock;
+/**
+ * Generate the next per-actor dot from a mutable version vector.
+ * Useful when a server needs to mint dots for many actors.
+ */
+declare function nextDotForActor(vv: VersionVector, actor: ActorId): Dot;
+/** Record an observed dot in a version vector. */
+declare function observeDot(vv: VersionVector, dot: Dot): void;
 //#endregion
 //#region src/patch.d.ts
 /** Structured compile error used to map patch validation failures to typed reasons. */
@@ -455,10 +559,14 @@ declare class DeserializeError extends Error {
 declare function serializeDoc(doc: Doc): SerializedDoc;
 /** Reconstruct a CRDT document from its serialized form. */
 declare function deserializeDoc(data: SerializedDoc): Doc;
+/** Non-throwing `deserializeDoc` variant with typed validation details. */
+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. */
 declare function deserializeState(data: SerializedState): CrdtState;
+/** Non-throwing `deserializeState` variant with typed validation details. */
+declare function tryDeserializeState(data: SerializedState): TryDeserializeStateResult;
 //#endregion
 //#region src/merge.d.ts
 /** Error thrown by throwing merge helpers (`mergeDoc` / `mergeState`). */
@@ -531,4 +639,4 @@ declare class TraversalDepthError extends Error {
   constructor(depth: number, maxDepth?: number);
 }
 //#endregion
-export { JsonPatchToCrdtOptions as $, tryApplyPatchInPlace as A, CompactDocTombstonesResult as B, applyPatch as C, TryMergeStateResult as Ct, forkState as D, createState as E, ApplyPatchAsActorResult as F, DiffOptions as G, CompilePatchOptions as H, ApplyPatchInPlaceOptions as I, ElemId as J, Doc as K, ApplyPatchOptions as L, ActorId as M, ApplyError as N, toJson as O, ApplyPatchAsActorOptions as P, JsonPatchOp as Q, ApplyResult as R, PatchError as S, TryMergeDocResult as St, applyPatchInPlace as T, VersionVector as Tt, CrdtState as U, CompactStateTombstonesResult as V, DeserializeErrorReason as W, IntentOp as X, ForkStateOptions as Y, JsonPatch as Z, diffJsonPatch as _, SerializedState as _t, MergeError as a, Node as at, parseJsonPointer as b, TryApplyPatchInPlaceResult as bt, tryMergeDoc as c, PatchErrorReason as ct, deserializeDoc as d, RgaElem as dt, JsonPrimitive as et, deserializeState as f, RgaSeq as ft, compileJsonPatchToIntent as g, SerializedRgaElem as gt, PatchCompileError as h, SerializedNode as ht, compactStateTombstones as i, MergeStateOptions as it, validateJsonPatch as j, tryApplyPatch as k, tryMergeState as l, PatchSemantics as lt, serializeState as m, SerializedDoc as mt, TraversalDepthError as n, LwwReg as nt, mergeDoc as o, ObjEntry as ot, serializeDoc as p, SerializedClock as pt, Dot as q, compactDocTombstones as r, MergeDocOptions as rt, mergeState as s, ObjNode as st, MAX_TRAVERSAL_DEPTH as t, JsonValue as tt, DeserializeError as u, ROOT_KEY as ut, getAtJson as v, TombstoneCompactionOptions as vt, applyPatchAsActor as w, ValidatePatchResult as wt, stringifyJsonPointer as x, TryApplyPatchResult as xt, jsonEquals as y, TombstoneCompactionStats as yt, Clock as z };
+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 };

package/dist/{depth-wDeQ1hO1.d.mts → depth-tcJ8L1dj.d.ts}

@@ -14,6 +14,13 @@ type JsonPrimitive = null | boolean | number | string;
 type JsonValue = JsonPrimitive | JsonValue[] | {
   [k: string]: 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.
+ */
+type JsonValidationMode = "none" | "strict" | "normalize";
 /** Mutable clock that tracks an actor's identity and monotonic counter. */
 type Clock = {
   actor: ActorId;
@@ -94,6 +101,19 @@ type SerializedState = {
 };
 /** 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. */
+type DeserializeFailure = {
+  code: 409;
+  reason: DeserializeErrorReason;
+  path: string;
+  message: string;
+} | {
+  code: 409;
+  reason: "MAX_DEPTH_EXCEEDED";
+  message: string;
+  depth: number;
+  maxDepth: number;
+};
 /**
  * Internal intent operations produced by compiling RFC 6902 JSON Patch ops.
  * Each variant maps to a specific CRDT mutation.
@@ -163,6 +183,16 @@ type CrdtState = {
   doc: Doc;
   clock: Clock;
 };
+/** Options for `createState`. */
+interface CreateStateOptions {
+  actor: ActorId;
+  start?: number;
+  /**
+   * Runtime guardrails for non-JSON values from untyped callers.
+   * Defaults to `"none"` for backward compatibility.
+   */
+  jsonValidation?: JsonValidationMode;
+}
 /** Options for `forkState`. */
 interface ForkStateOptions {
   /**
@@ -181,6 +211,15 @@ type ApplyPatchAsActorOptions = {
   base?: Doc;
   testAgainst?: "head" | "base";
   semantics?: PatchSemantics;
+  strictParents?: boolean;
+  jsonValidation?: JsonValidationMode;
+};
+/** Non-throwing result for internals-only `tryApplyPatchAsActor`. */
+type TryApplyPatchAsActorResult = ({
+  ok: true;
+} & ApplyPatchAsActorResult) | {
+  ok: false;
+  error: ApplyError;
 };
 /** Typed failure reason used across patch/merge helpers. */
 type PatchErrorReason = "INVALID_PATCH" | "INVALID_POINTER" | "MISSING_PARENT" | "MISSING_TARGET" | "INVALID_TARGET" | "OUT_OF_BOUNDS" | "TEST_FAILED" | "INVALID_MOVE" | "DOT_GENERATION_EXHAUSTED" | "MAX_DEPTH_EXCEEDED" | "LINEAGE_MISMATCH";
@@ -197,6 +236,22 @@ type ApplyError = {
 type ApplyResult = {
   ok: true;
 } | ApplyError;
+/** Non-throwing result for `deserializeDoc`. */
+type TryDeserializeDocResult = {
+  ok: true;
+  doc: Doc;
+} | {
+  ok: false;
+  error: DeserializeFailure;
+};
+/** Non-throwing result for `deserializeState`. */
+type TryDeserializeStateResult = {
+  ok: true;
+  state: CrdtState;
+} | {
+  ok: false;
+  error: DeserializeFailure;
+};
 /** How JSON Patch operations are interpreted during application. */
 type PatchSemantics = "base" | "sequential";
 /** Options for compile/validation helpers. */
@@ -213,6 +268,17 @@ type ApplyPatchOptions = {
   base?: CrdtState;
   testAgainst?: "head" | "base";
   semantics?: PatchSemantics;
+  /**
+   * Reject array inserts when the base parent path is missing.
+   * Defaults to `false` to preserve legacy behavior that can auto-create
+   * missing arrays for index `0` / append intents.
+   */
+  strictParents?: boolean;
+  /**
+   * Runtime guardrails for patch payload values from untyped callers.
+   * Defaults to `"none"` for backward compatibility.
+   */
+  jsonValidation?: JsonValidationMode;
 };
 /** Options for in-place patch application (`applyPatchInPlace` / `tryApplyPatchInPlace`). */
 type ApplyPatchInPlaceOptions = ApplyPatchOptions & {
@@ -314,6 +380,7 @@ type JsonPatchToCrdtOptions = {
   evalTestAgainst?: "head" | "base";
   bumpCounterAbove?: (ctr: number) => void;
   semantics?: PatchSemantics;
+  strictParents?: boolean;
 };
 /** Options for `crdtToJsonPatch` and `diffJsonPatch`. */
 type DiffOptions = {
@@ -330,6 +397,11 @@ type DiffOptions = {
    * Set to `Number.POSITIVE_INFINITY` to always allow LCS.
    */
   lcsMaxCells?: number;
+  /**
+   * Runtime guardrails for diff inputs from untyped callers.
+   * Defaults to `"none"` for backward compatibility.
+   */
+  jsonValidation?: JsonValidationMode;
 };
 /**
  * Internal sentinel key used in `IntentOp` to represent root-level operations.
@@ -353,10 +425,7 @@ declare class PatchError extends Error {
  * @param options - Actor ID and optional starting counter.
  * @returns A new `CrdtState` containing the document and clock.
  */
-declare function createState(initial: JsonValue, options: {
-  actor: ActorId;
-  start?: number;
-}): CrdtState;
+declare function createState(initial: JsonValue, options: CreateStateOptions): CrdtState;
 /**
  * Fork a replica from a shared origin state while assigning a new local actor ID.
  * The forked state has an independent document clone and clock.
@@ -400,6 +469,41 @@ declare function validateJsonPatch(base: JsonValue, patch: JsonPatchOp[], option
  * Returns the updated state and a new version vector snapshot.
  */
 declare function applyPatchAsActor(doc: Doc, vv: VersionVector, actor: ActorId, patch: JsonPatchOp[], options?: ApplyPatchAsActorOptions): ApplyPatchAsActorResult;
+/** Non-throwing `applyPatchAsActor` variant for internals sync flows. */
+declare function tryApplyPatchAsActor(doc: Doc, vv: VersionVector, actor: ActorId, patch: JsonPatchOp[], options?: ApplyPatchAsActorOptions): TryApplyPatchAsActorResult;
+//#endregion
+//#region src/json-value.d.ts
+/**
+ * Runtime validation error for values that are not JSON-compatible.
+ * `path` is an RFC 6901 pointer relative to the validated root.
+ */
+declare class JsonValueValidationError extends TypeError {
+  readonly path: string;
+  readonly detail: string;
+  constructor(path: string, detail: string);
+}
+//#endregion
+//#region src/clock.d.ts
+type ClockValidationErrorReason = "INVALID_ACTOR" | "INVALID_COUNTER";
+declare class ClockValidationError extends TypeError {
+  readonly reason: ClockValidationErrorReason;
+  constructor(reason: ClockValidationErrorReason, message: string);
+}
+/**
+ * Create a new clock for the given actor. Each call to `clock.next()` yields a fresh `Dot`.
+ * @param actor - Unique identifier for this peer.
+ * @param start - Initial counter value (defaults to 0).
+ */
+declare function createClock(actor: ActorId, start?: number): Clock;
+/** Create an independent copy of a clock at the same counter position. */
+declare function cloneClock(clock: Clock): Clock;
+/**
+ * Generate the next per-actor dot from a mutable version vector.
+ * Useful when a server needs to mint dots for many actors.
+ */
+declare function nextDotForActor(vv: VersionVector, actor: ActorId): Dot;
+/** Record an observed dot in a version vector. */
+declare function observeDot(vv: VersionVector, dot: Dot): void;
 //#endregion
 //#region src/patch.d.ts
 /** Structured compile error used to map patch validation failures to typed reasons. */
@@ -455,10 +559,14 @@ declare class DeserializeError extends Error {
 declare function serializeDoc(doc: Doc): SerializedDoc;
 /** Reconstruct a CRDT document from its serialized form. */
 declare function deserializeDoc(data: SerializedDoc): Doc;
+/** Non-throwing `deserializeDoc` variant with typed validation details. */
+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. */
 declare function deserializeState(data: SerializedState): CrdtState;
+/** Non-throwing `deserializeState` variant with typed validation details. */
+declare function tryDeserializeState(data: SerializedState): TryDeserializeStateResult;
 //#endregion
 //#region src/merge.d.ts
 /** Error thrown by throwing merge helpers (`mergeDoc` / `mergeState`). */
@@ -531,4 +639,4 @@ declare class TraversalDepthError extends Error {
   constructor(depth: number, maxDepth?: number);
 }
 //#endregion
-export { JsonPatchToCrdtOptions as $, tryApplyPatchInPlace as A, CompactDocTombstonesResult as B, applyPatch as C, TryMergeStateResult as Ct, forkState as D, createState as E, ApplyPatchAsActorResult as F, DiffOptions as G, CompilePatchOptions as H, ApplyPatchInPlaceOptions as I, ElemId as J, Doc as K, ApplyPatchOptions as L, ActorId as M, ApplyError as N, toJson as O, ApplyPatchAsActorOptions as P, JsonPatchOp as Q, ApplyResult as R, PatchError as S, TryMergeDocResult as St, applyPatchInPlace as T, VersionVector as Tt, CrdtState as U, CompactStateTombstonesResult as V, DeserializeErrorReason as W, IntentOp as X, ForkStateOptions as Y, JsonPatch as Z, diffJsonPatch as _, SerializedState as _t, MergeError as a, Node as at, parseJsonPointer as b, TryApplyPatchInPlaceResult as bt, tryMergeDoc as c, PatchErrorReason as ct, deserializeDoc as d, RgaElem as dt, JsonPrimitive as et, deserializeState as f, RgaSeq as ft, compileJsonPatchToIntent as g, SerializedRgaElem as gt, PatchCompileError as h, SerializedNode as ht, compactStateTombstones as i, MergeStateOptions as it, validateJsonPatch as j, tryApplyPatch as k, tryMergeState as l, PatchSemantics as lt, serializeState as m, SerializedDoc as mt, TraversalDepthError as n, LwwReg as nt, mergeDoc as o, ObjEntry as ot, serializeDoc as p, SerializedClock as pt, Dot as q, compactDocTombstones as r, MergeDocOptions as rt, mergeState as s, ObjNode as st, MAX_TRAVERSAL_DEPTH as t, JsonValue as tt, DeserializeError as u, ROOT_KEY as ut, getAtJson as v, TombstoneCompactionOptions as vt, applyPatchAsActor as w, ValidatePatchResult as wt, stringifyJsonPointer as x, TryApplyPatchResult as xt, jsonEquals as y, TombstoneCompactionStats as yt, Clock as z };
+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 };

package/dist/index.d.mts

@@ -1,2 +1,2 @@
-import { A as tryApplyPatchInPlace, C as applyPatch, Ct as TryMergeStateResult, D as forkState, E as createState, G as DiffOptions, I as ApplyPatchInPlaceOptions, L as ApplyPatchOptions, M as ActorId, N as ApplyError, O as toJson, Q as JsonPatchOp, S as PatchError, T as applyPatchInPlace, U as CrdtState, V as CompactStateTombstonesResult, W as DeserializeErrorReason, Y as ForkStateOptions, Z as JsonPatch, _ as diffJsonPatch, _t as SerializedState, a as MergeError, bt as TryApplyPatchInPlaceResult, ct as PatchErrorReason, et as JsonPrimitive, f as deserializeState, i as compactStateTombstones, it as MergeStateOptions, j as validateJsonPatch, k as tryApplyPatch, l as tryMergeState, lt as PatchSemantics, m as serializeState, n as TraversalDepthError, s as mergeState, t as MAX_TRAVERSAL_DEPTH, tt as JsonValue, u as DeserializeError, vt as TombstoneCompactionOptions, wt as ValidatePatchResult, xt as TryApplyPatchResult, yt as TombstoneCompactionStats } from "./depth-wDeQ1hO1.mjs";
-export { type ActorId, type ApplyError, type ApplyPatchInPlaceOptions, type ApplyPatchOptions, type CompactStateTombstonesResult, type CrdtState, DeserializeError, type DeserializeErrorReason, type DiffOptions, type ForkStateOptions, type JsonPatch, type JsonPatchOp, type JsonPrimitive, type JsonValue, MAX_TRAVERSAL_DEPTH, MergeError, type MergeStateOptions, PatchError, type PatchErrorReason, type PatchSemantics, type SerializedState, type TombstoneCompactionOptions, type TombstoneCompactionStats, TraversalDepthError, type TryApplyPatchInPlaceResult, type TryApplyPatchResult, type TryMergeStateResult, type ValidatePatchResult, applyPatch, applyPatchInPlace, compactStateTombstones, createState, deserializeState, diffJsonPatch, forkState, mergeState, serializeState, toJson, tryApplyPatch, tryApplyPatchInPlace, tryMergeState, validateJsonPatch };
+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-Cd3nyHWy.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 };

package/dist/index.d.ts

@@ -1,2 +1,2 @@
-import { A as tryApplyPatchInPlace, C as applyPatch, Ct as TryMergeStateResult, D as forkState, E as createState, G as DiffOptions, I as ApplyPatchInPlaceOptions, L as ApplyPatchOptions, M as ActorId, N as ApplyError, O as toJson, Q as JsonPatchOp, S as PatchError, T as applyPatchInPlace, U as CrdtState, V as CompactStateTombstonesResult, W as DeserializeErrorReason, Y as ForkStateOptions, Z as JsonPatch, _ as diffJsonPatch, _t as SerializedState, a as MergeError, bt as TryApplyPatchInPlaceResult, ct as PatchErrorReason, et as JsonPrimitive, f as deserializeState, i as compactStateTombstones, it as MergeStateOptions, j as validateJsonPatch, k as tryApplyPatch, l as tryMergeState, lt as PatchSemantics, m as serializeState, n as TraversalDepthError, s as mergeState, t as MAX_TRAVERSAL_DEPTH, tt as JsonValue, u as DeserializeError, vt as TombstoneCompactionOptions, wt as ValidatePatchResult, xt as TryApplyPatchResult, yt as TombstoneCompactionStats } from "./depth-p6fX9Ak7.js";
-export { type ActorId, type ApplyError, type ApplyPatchInPlaceOptions, type ApplyPatchOptions, type CompactStateTombstonesResult, type CrdtState, DeserializeError, type DeserializeErrorReason, type DiffOptions, type ForkStateOptions, type JsonPatch, type JsonPatchOp, type JsonPrimitive, type JsonValue, MAX_TRAVERSAL_DEPTH, MergeError, type MergeStateOptions, PatchError, type PatchErrorReason, type PatchSemantics, type SerializedState, type TombstoneCompactionOptions, type TombstoneCompactionStats, TraversalDepthError, type TryApplyPatchInPlaceResult, type TryApplyPatchResult, type TryMergeStateResult, type ValidatePatchResult, applyPatch, applyPatchInPlace, compactStateTombstones, createState, deserializeState, diffJsonPatch, forkState, mergeState, serializeState, toJson, tryApplyPatch, tryApplyPatchInPlace, tryMergeState, validateJsonPatch };
+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-tcJ8L1dj.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 };

package/dist/index.js

@@ -1,7 +1,9 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_compact = require('./compact-CkLd4Yh5.js');
+const require_compact = require('./compact-DrmgKiVW.js');
 
+exports.ClockValidationError = require_compact.ClockValidationError;
 exports.DeserializeError = require_compact.DeserializeError;
+exports.JsonValueValidationError = require_compact.JsonValueValidationError;
 exports.MAX_TRAVERSAL_DEPTH = require_compact.MAX_TRAVERSAL_DEPTH;
 exports.MergeError = require_compact.MergeError;
 exports.PatchError = require_compact.PatchError;
@@ -18,5 +20,6 @@ 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;

package/dist/index.mjs

@@ -1,3 +1,3 @@
-import { P as diffJsonPatch, S as validateJsonPatch, _ as createState, a as mergeState, at as MAX_TRAVERSAL_DEPTH, b as tryApplyPatch, c as DeserializeError, f as serializeState, g as applyPatchInPlace, m as applyPatch, n as compactStateTombstones, ot as TraversalDepthError, p as PatchError, r as MergeError, s as tryMergeState, u as deserializeState, v as forkState, x as tryApplyPatchInPlace, y as toJson } from "./compact-BJBGW9tC.mjs";
+import { L as diffJsonPatch, S as tryApplyPatch, T as validateJsonPatch, U as JsonValueValidationError, a as mergeState, b as forkState, c as DeserializeError, dt as ClockValidationError, f as serializeState, g as applyPatch, h as PatchError, lt as MAX_TRAVERSAL_DEPTH, m as tryDeserializeState, n as compactStateTombstones, r as MergeError, s as tryMergeState, u as deserializeState, ut as TraversalDepthError, v as applyPatchInPlace, w as tryApplyPatchInPlace, x as toJson, y as createState } from "./compact-BE9UsxEo.mjs";
 
-export { DeserializeError, MAX_TRAVERSAL_DEPTH, MergeError, PatchError, TraversalDepthError, applyPatch, applyPatchInPlace, compactStateTombstones, createState, deserializeState, diffJsonPatch, forkState, mergeState, serializeState, toJson, tryApplyPatch, tryApplyPatchInPlace, tryMergeState, validateJsonPatch };
+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 };

package/dist/internals.d.mts

@@ -1,22 +1,5 @@
-import { $ as JsonPatchToCrdtOptions, A as tryApplyPatchInPlace, B as CompactDocTombstonesResult, C as applyPatch, Ct as TryMergeStateResult, D as forkState, E as createState, F as ApplyPatchAsActorResult, G as DiffOptions, H as CompilePatchOptions, I as ApplyPatchInPlaceOptions, J as ElemId, K as Doc, L as ApplyPatchOptions, M as ActorId, N as ApplyError, O as toJson, P as ApplyPatchAsActorOptions, Q as JsonPatchOp, R as ApplyResult, S as PatchError, St as TryMergeDocResult, T as applyPatchInPlace, Tt as VersionVector, U as CrdtState, V as CompactStateTombstonesResult, W as DeserializeErrorReason, X as IntentOp, Y as ForkStateOptions, Z as JsonPatch, _ as diffJsonPatch, _t as SerializedState, a as MergeError, at as Node, b as parseJsonPointer, bt as TryApplyPatchInPlaceResult, c as tryMergeDoc, ct as PatchErrorReason, d as deserializeDoc, dt as RgaElem, et as JsonPrimitive, f as deserializeState, ft as RgaSeq, g as compileJsonPatchToIntent, gt as SerializedRgaElem, h as PatchCompileError, ht as SerializedNode, i as compactStateTombstones, it as MergeStateOptions, j as validateJsonPatch, k as tryApplyPatch, l as tryMergeState, lt as PatchSemantics, m as serializeState, mt as SerializedDoc, n as TraversalDepthError, nt as LwwReg, o as mergeDoc, ot as ObjEntry, p as serializeDoc, pt as SerializedClock, q as Dot, r as compactDocTombstones, rt as MergeDocOptions, s as mergeState, st as ObjNode, t as MAX_TRAVERSAL_DEPTH, tt as JsonValue, u as DeserializeError, ut as ROOT_KEY, v as getAtJson, vt as TombstoneCompactionOptions, w as applyPatchAsActor, wt as ValidatePatchResult, x as stringifyJsonPointer, xt as TryApplyPatchResult, y as jsonEquals, yt as TombstoneCompactionStats, z as Clock } from "./depth-wDeQ1hO1.mjs";
+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-Cd3nyHWy.mjs";
 
-//#region src/clock.d.ts
-/**
- * Create a new clock for the given actor. Each call to `clock.next()` yields a fresh `Dot`.
- * @param actor - Unique identifier for this peer.
- * @param start - Initial counter value (defaults to 0).
- */
-declare function createClock(actor: ActorId, start?: number): Clock;
-/** Create an independent copy of a clock at the same counter position. */
-declare function cloneClock(clock: Clock): Clock;
-/**
- * Generate the next per-actor dot from a mutable version vector.
- * Useful when a server needs to mint dots for many actors.
- */
-declare function nextDotForActor(vv: VersionVector, actor: ActorId): Dot;
-/** Record an observed dot in a version vector. */
-declare function observeDot(vv: VersionVector, dot: Dot): void;
-//#endregion
 //#region src/doc.d.ts
 /**
  * Create a CRDT document from a JSON value, using fresh dots for each node.
@@ -41,23 +24,29 @@ declare function cloneDoc(doc: Doc): Doc;
  * @param newDot - A function that generates a unique `Dot` per mutation.
  * @param evalTestAgainst - Whether `test` ops are evaluated against `"head"` or `"base"`.
  * @param bumpCounterAbove - Optional hook that can fast-forward the underlying counter before inserts.
+ * @param options - Optional behavior toggles.
+ * @param options.strictParents - When `true`, reject array inserts whose base parent path is missing.
  * @returns `{ ok: true }` on success, or `{ ok: false, code: 409, message }` on conflict.
  */
-declare function applyIntentsToCrdt(base: Doc, head: Doc, intents: IntentOp[], newDot: () => Dot, evalTestAgainst?: "head" | "base", bumpCounterAbove?: (ctr: number) => void): ApplyResult;
+declare function applyIntentsToCrdt(base: Doc, head: Doc, intents: IntentOp[], newDot: () => Dot, evalTestAgainst?: "head" | "base", bumpCounterAbove?: (ctr: number) => void, options?: {
+  strictParents?: boolean;
+}): ApplyResult;
 /**
  * Convenience wrapper: compile a JSON Patch and apply it to a CRDT document.
  * Overloads:
- * - positional: `jsonPatchToCrdt(base, head, patch, newDot, evalTestAgainst?, bumpCounterAbove?)`
- * - object: `jsonPatchToCrdt({ base, head, patch, newDot, evalTestAgainst?, bumpCounterAbove?, semantics? })`
+ * - positional:
+ *   `jsonPatchToCrdt(base, head, patch, newDot, evalTestAgainst?, bumpCounterAbove?, strictParents?)`
+ * - object:
+ *   `jsonPatchToCrdt({ base, head, patch, newDot, evalTestAgainst?, bumpCounterAbove?, semantics?, strictParents? })`
  */
 declare function jsonPatchToCrdt(options: JsonPatchToCrdtOptions): ApplyResult;
-declare function jsonPatchToCrdt(base: Doc, head: Doc, patch: JsonPatchOp[], newDot: () => Dot, evalTestAgainst?: "head" | "base", bumpCounterAbove?: (ctr: number) => void): ApplyResult;
+declare function jsonPatchToCrdt(base: Doc, head: Doc, patch: JsonPatchOp[], newDot: () => Dot, evalTestAgainst?: "head" | "base", bumpCounterAbove?: (ctr: number) => void, strictParents?: boolean): ApplyResult;
 /**
  * Safe wrapper around `jsonPatchToCrdt`.
  * This function never throws and always returns an `ApplyResult`.
  */
 declare function jsonPatchToCrdtSafe(options: JsonPatchToCrdtOptions): ApplyResult;
-declare function jsonPatchToCrdtSafe(base: Doc, head: Doc, patch: JsonPatchOp[], newDot: () => Dot, evalTestAgainst?: "head" | "base", bumpCounterAbove?: (ctr: number) => void): ApplyResult;
+declare function jsonPatchToCrdtSafe(base: Doc, head: Doc, patch: JsonPatchOp[], newDot: () => Dot, evalTestAgainst?: "head" | "base", bumpCounterAbove?: (ctr: number) => void, strictParents?: boolean): ApplyResult;
 /** Alias for codebases that prefer `try*` naming for non-throwing APIs. */
 declare const tryJsonPatchToCrdt: typeof jsonPatchToCrdtSafe;
 /**
@@ -112,4 +101,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, type CompactDocTombstonesResult, type CompactStateTombstonesResult, type CompilePatchOptions, CrdtState, DeserializeError, DeserializeErrorReason, DiffOptions, type Doc, type Dot, type ElemId, ForkStateOptions, HEAD, type IntentOp, JsonPatch, JsonPatchOp, type JsonPatchToCrdtOptions, JsonPrimitive, JsonValue, 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 SerializedClock, type SerializedDoc, type SerializedNode, type SerializedRgaElem, SerializedState, type TombstoneCompactionOptions, type TombstoneCompactionStats, TraversalDepthError, TryApplyPatchInPlaceResult, TryApplyPatchResult, type TryMergeDocResult, TryMergeStateResult, ValidatePatchResult, type VersionVector, applyIntentsToCrdt, applyPatch, applyPatchAsActor, applyPatchInPlace, cloneClock, cloneDoc, compactDocTombstones, compactStateTombstones, compareDot, compileJsonPatchToIntent, 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, rgaLinearizeIds, rgaPrevForInsertAtIndex, serializeDoc, serializeState, stringifyJsonPointer, toJson, tryApplyPatch, tryApplyPatchInPlace, tryJsonPatchToCrdt, tryMergeDoc, tryMergeState, validateJsonPatch, 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 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, 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, rgaLinearizeIds, rgaPrevForInsertAtIndex, serializeDoc, serializeState, stringifyJsonPointer, toJson, tryApplyPatch, tryApplyPatchAsActor, tryApplyPatchInPlace, tryDeserializeDoc, tryDeserializeState, tryJsonPatchToCrdt, tryMergeDoc, tryMergeState, validateJsonPatch, vvHasDot, vvMerge };

package/dist/internals.d.ts

@@ -1,22 +1,5 @@
-import { $ as JsonPatchToCrdtOptions, A as tryApplyPatchInPlace, B as CompactDocTombstonesResult, C as applyPatch, Ct as TryMergeStateResult, D as forkState, E as createState, F as ApplyPatchAsActorResult, G as DiffOptions, H as CompilePatchOptions, I as ApplyPatchInPlaceOptions, J as ElemId, K as Doc, L as ApplyPatchOptions, M as ActorId, N as ApplyError, O as toJson, P as ApplyPatchAsActorOptions, Q as JsonPatchOp, R as ApplyResult, S as PatchError, St as TryMergeDocResult, T as applyPatchInPlace, Tt as VersionVector, U as CrdtState, V as CompactStateTombstonesResult, W as DeserializeErrorReason, X as IntentOp, Y as ForkStateOptions, Z as JsonPatch, _ as diffJsonPatch, _t as SerializedState, a as MergeError, at as Node, b as parseJsonPointer, bt as TryApplyPatchInPlaceResult, c as tryMergeDoc, ct as PatchErrorReason, d as deserializeDoc, dt as RgaElem, et as JsonPrimitive, f as deserializeState, ft as RgaSeq, g as compileJsonPatchToIntent, gt as SerializedRgaElem, h as PatchCompileError, ht as SerializedNode, i as compactStateTombstones, it as MergeStateOptions, j as validateJsonPatch, k as tryApplyPatch, l as tryMergeState, lt as PatchSemantics, m as serializeState, mt as SerializedDoc, n as TraversalDepthError, nt as LwwReg, o as mergeDoc, ot as ObjEntry, p as serializeDoc, pt as SerializedClock, q as Dot, r as compactDocTombstones, rt as MergeDocOptions, s as mergeState, st as ObjNode, t as MAX_TRAVERSAL_DEPTH, tt as JsonValue, u as DeserializeError, ut as ROOT_KEY, v as getAtJson, vt as TombstoneCompactionOptions, w as applyPatchAsActor, wt as ValidatePatchResult, x as stringifyJsonPointer, xt as TryApplyPatchResult, y as jsonEquals, yt as TombstoneCompactionStats, z as Clock } from "./depth-p6fX9Ak7.js";
+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-tcJ8L1dj.js";
 
-//#region src/clock.d.ts
-/**
- * Create a new clock for the given actor. Each call to `clock.next()` yields a fresh `Dot`.
- * @param actor - Unique identifier for this peer.
- * @param start - Initial counter value (defaults to 0).
- */
-declare function createClock(actor: ActorId, start?: number): Clock;
-/** Create an independent copy of a clock at the same counter position. */
-declare function cloneClock(clock: Clock): Clock;
-/**
- * Generate the next per-actor dot from a mutable version vector.
- * Useful when a server needs to mint dots for many actors.
- */
-declare function nextDotForActor(vv: VersionVector, actor: ActorId): Dot;
-/** Record an observed dot in a version vector. */
-declare function observeDot(vv: VersionVector, dot: Dot): void;
-//#endregion
 //#region src/doc.d.ts
 /**
  * Create a CRDT document from a JSON value, using fresh dots for each node.
@@ -41,23 +24,29 @@ declare function cloneDoc(doc: Doc): Doc;
  * @param newDot - A function that generates a unique `Dot` per mutation.
  * @param evalTestAgainst - Whether `test` ops are evaluated against `"head"` or `"base"`.
  * @param bumpCounterAbove - Optional hook that can fast-forward the underlying counter before inserts.
+ * @param options - Optional behavior toggles.
+ * @param options.strictParents - When `true`, reject array inserts whose base parent path is missing.
  * @returns `{ ok: true }` on success, or `{ ok: false, code: 409, message }` on conflict.
  */
-declare function applyIntentsToCrdt(base: Doc, head: Doc, intents: IntentOp[], newDot: () => Dot, evalTestAgainst?: "head" | "base", bumpCounterAbove?: (ctr: number) => void): ApplyResult;
+declare function applyIntentsToCrdt(base: Doc, head: Doc, intents: IntentOp[], newDot: () => Dot, evalTestAgainst?: "head" | "base", bumpCounterAbove?: (ctr: number) => void, options?: {
+  strictParents?: boolean;
+}): ApplyResult;
 /**
  * Convenience wrapper: compile a JSON Patch and apply it to a CRDT document.
  * Overloads:
- * - positional: `jsonPatchToCrdt(base, head, patch, newDot, evalTestAgainst?, bumpCounterAbove?)`
- * - object: `jsonPatchToCrdt({ base, head, patch, newDot, evalTestAgainst?, bumpCounterAbove?, semantics? })`
+ * - positional:
+ *   `jsonPatchToCrdt(base, head, patch, newDot, evalTestAgainst?, bumpCounterAbove?, strictParents?)`
+ * - object:
+ *   `jsonPatchToCrdt({ base, head, patch, newDot, evalTestAgainst?, bumpCounterAbove?, semantics?, strictParents? })`
  */
 declare function jsonPatchToCrdt(options: JsonPatchToCrdtOptions): ApplyResult;
-declare function jsonPatchToCrdt(base: Doc, head: Doc, patch: JsonPatchOp[], newDot: () => Dot, evalTestAgainst?: "head" | "base", bumpCounterAbove?: (ctr: number) => void): ApplyResult;
+declare function jsonPatchToCrdt(base: Doc, head: Doc, patch: JsonPatchOp[], newDot: () => Dot, evalTestAgainst?: "head" | "base", bumpCounterAbove?: (ctr: number) => void, strictParents?: boolean): ApplyResult;
 /**
  * Safe wrapper around `jsonPatchToCrdt`.
  * This function never throws and always returns an `ApplyResult`.
  */
 declare function jsonPatchToCrdtSafe(options: JsonPatchToCrdtOptions): ApplyResult;
-declare function jsonPatchToCrdtSafe(base: Doc, head: Doc, patch: JsonPatchOp[], newDot: () => Dot, evalTestAgainst?: "head" | "base", bumpCounterAbove?: (ctr: number) => void): ApplyResult;
+declare function jsonPatchToCrdtSafe(base: Doc, head: Doc, patch: JsonPatchOp[], newDot: () => Dot, evalTestAgainst?: "head" | "base", bumpCounterAbove?: (ctr: number) => void, strictParents?: boolean): ApplyResult;
 /** Alias for codebases that prefer `try*` naming for non-throwing APIs. */
 declare const tryJsonPatchToCrdt: typeof jsonPatchToCrdtSafe;
 /**
@@ -112,4 +101,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, type CompactDocTombstonesResult, type CompactStateTombstonesResult, type CompilePatchOptions, CrdtState, DeserializeError, DeserializeErrorReason, DiffOptions, type Doc, type Dot, type ElemId, ForkStateOptions, HEAD, type IntentOp, JsonPatch, JsonPatchOp, type JsonPatchToCrdtOptions, JsonPrimitive, JsonValue, 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 SerializedClock, type SerializedDoc, type SerializedNode, type SerializedRgaElem, SerializedState, type TombstoneCompactionOptions, type TombstoneCompactionStats, TraversalDepthError, TryApplyPatchInPlaceResult, TryApplyPatchResult, type TryMergeDocResult, TryMergeStateResult, ValidatePatchResult, type VersionVector, applyIntentsToCrdt, applyPatch, applyPatchAsActor, applyPatchInPlace, cloneClock, cloneDoc, compactDocTombstones, compactStateTombstones, compareDot, compileJsonPatchToIntent, 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, rgaLinearizeIds, rgaPrevForInsertAtIndex, serializeDoc, serializeState, stringifyJsonPointer, toJson, tryApplyPatch, tryApplyPatchInPlace, tryJsonPatchToCrdt, tryMergeDoc, tryMergeState, validateJsonPatch, 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 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, 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, rgaLinearizeIds, rgaPrevForInsertAtIndex, serializeDoc, serializeState, stringifyJsonPointer, toJson, tryApplyPatch, tryApplyPatchAsActor, tryApplyPatchInPlace, tryDeserializeDoc, tryDeserializeState, tryJsonPatchToCrdt, tryMergeDoc, tryMergeState, validateJsonPatch, vvHasDot, vvMerge };