@createiq/htmldiff 1.2.0-beta.0 → 1.2.0-beta.1

package/dist/HtmlDiff.d.cts

@@ -208,7 +208,26 @@ declare class HtmlDiff {
    * pairs would project on their own. Pass an explicit boolean to
    * override.
    */
-  static executeThreeWay(v1: string, v2: string, v3: string, options?: ThreeWayOptions): string;
+  /**
+   * Three-way HTML diff against a shared genesis. Produces attributed
+   * HTML that distinguishes CP's accumulated changes (genesis → cpLatest)
+   * from Me's accumulated changes (genesis → meCurrent). Use this for
+   * blackline UX where the negotiation has gone through multiple turns
+   * and the reader wants to see "who proposed what" across the whole
+   * history, not just the most recent round.
+   *
+   * When both parties happen to have made the same change (e.g. CP
+   * proposed a wording change in turn N, Me adopted it in turn N+1),
+   * the change reads as "settled" and is emitted unmarked — only
+   * disagreements and pending proposals carry author attribution.
+   *
+   * @param genesis    the shared common ancestor (per-user — the FE
+   *                   picks between V1.0 and /preview/initialAnswers
+   *                   based on `prefillReceiverAnswers`)
+   * @param cpLatest   the counterparty's current published version
+   * @param meCurrent  Me's current draft (the document on screen)
+   */
+  static executeThreeWay(genesis: string, cpLatest: string, meCurrent: string, options?: ThreeWayOptions): string;
   private static executeThreeWayWithDepth;
   /**
    * Drives a fresh `HtmlDiff` instance through `insertTag` for ins/del

package/dist/HtmlDiff.d.mts

@@ -208,7 +208,26 @@ declare class HtmlDiff {
    * pairs would project on their own. Pass an explicit boolean to
    * override.
    */
-  static executeThreeWay(v1: string, v2: string, v3: string, options?: ThreeWayOptions): string;
+  /**
+   * Three-way HTML diff against a shared genesis. Produces attributed
+   * HTML that distinguishes CP's accumulated changes (genesis → cpLatest)
+   * from Me's accumulated changes (genesis → meCurrent). Use this for
+   * blackline UX where the negotiation has gone through multiple turns
+   * and the reader wants to see "who proposed what" across the whole
+   * history, not just the most recent round.
+   *
+   * When both parties happen to have made the same change (e.g. CP
+   * proposed a wording change in turn N, Me adopted it in turn N+1),
+   * the change reads as "settled" and is emitted unmarked — only
+   * disagreements and pending proposals carry author attribution.
+   *
+   * @param genesis    the shared common ancestor (per-user — the FE
+   *                   picks between V1.0 and /preview/initialAnswers
+   *                   based on `prefillReceiverAnswers`)
+   * @param cpLatest   the counterparty's current published version
+   * @param meCurrent  Me's current draft (the document on screen)
+   */
+  static executeThreeWay(genesis: string, cpLatest: string, meCurrent: string, options?: ThreeWayOptions): string;
   private static executeThreeWayWithDepth;
   /**
    * Drives a fresh `HtmlDiff` instance through `insertTag` for ins/del