@ephia/dova-sdk 1.0.0

package/src/core/bindings/SegmentBindingBridge.test.ts

@@ -0,0 +1,422 @@
+// @vitest-environment jsdom
+
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+import { NativeAdapter } from "./adapters/NativeAdapter";
+import { SegmentBindingBridge } from "./SegmentBindingBridge";
+import type { BindingAdapter, SegmentStatus, TextSegment } from "./types";
+import { pickEffectiveText } from "../../shared/effective-text";
+
+describe("SegmentBindingBridge", () => {
+  beforeEach(() => {
+    vi.useFakeTimers();
+  });
+
+  afterEach(() => {
+    vi.useRealTimers();
+  });
+
+  it("updates the session anchor end after final commits", () => {
+    const textarea = document.createElement("textarea");
+    document.body.appendChild(textarea);
+
+    const bridge = new SegmentBindingBridge(new NativeAdapter(textarea), textarea);
+    const anchor = bridge.beginSession();
+
+    bridge.insertPartial("s1", "\nComment ça va", 1);
+    bridge.commitFinal("s1", "\nComment ça va");
+
+    expect(textarea.value).toBe("\nComment ça va");
+    expect(anchor.end).toBe(textarea.value.length);
+    expect(anchor.end).toBeGreaterThan(anchor.initialStart);
+
+    bridge.endSession();
+    textarea.remove();
+  });
+
+  it.skip("trims an open segment after the previous segment commits — overlap trimming removed (Replace Model, backend-enforced)", () => {
+    const textarea = document.createElement("textarea");
+    document.body.appendChild(textarea);
+
+    const adapter = new NativeAdapter(textarea);
+    const bridge = new SegmentBindingBridge(adapter, textarea);
+    bridge.beginSession();
+
+    bridge.insertPartial("a", "Scanner cérébral", 0);
+    bridge.insertPartial("b", "Scanner cérébral. Indication", 0);
+    bridge.commitFinal("a", "Scanner cérébral.");
+
+    expect(textarea.value).toBe("Scanner cérébral. Indication");
+    expect(adapter.getSegmentText("b")).toBe("Indication");
+
+    bridge.endSession();
+    textarea.remove();
+  });
+
+  it.skip("trims every open overlapping segment on commit — overlap trimming removed (Replace Model, backend-enforced)", () => {
+    const textarea = document.createElement("textarea");
+    document.body.appendChild(textarea);
+
+    const adapter = new NativeAdapter(textarea);
+    const bridge = new SegmentBindingBridge(adapter, textarea);
+    bridge.beginSession();
+
+    bridge.insertPartial("a", "Scanner cérébral", 0);
+    bridge.insertPartial("b", "Scanner cérébral. Indication", 0);
+    bridge.insertPartial("c", "Scanner cérébral. Conclusion", 0);
+    bridge.commitFinal("a", "Scanner cérébral.");
+
+    expect(adapter.getSegmentText("b")).toBe("Indication");
+    expect(adapter.getSegmentText("c")).toBe("Conclusion");
+    expect(textarea.value).toBe("Scanner cérébral. Indication Conclusion");
+
+    bridge.endSession();
+    textarea.remove();
+  });
+
+  it("keeps an explicit empty delta as the effective committed text", () => {
+    expect(pickEffectiveText({ text: "raw context", delta: "" })).toBe("");
+    expect(pickEffectiveText({ text: "raw context" })).toBe("raw context");
+
+    const textarea = document.createElement("textarea");
+    document.body.appendChild(textarea);
+
+    const bridge = new SegmentBindingBridge(new NativeAdapter(textarea), textarea);
+    bridge.beginSession();
+    bridge.insertPartial("a", "raw context", 0);
+    bridge.commitFinal("a", "");
+
+    expect(textarea.value).toBe("");
+
+    bridge.endSession();
+    textarea.remove();
+  });
+
+  it("inserts native dictation at the cursor and keeps the suffix intact", () => {
+    const textarea = document.createElement("textarea");
+    textarea.value = "foo  baz";
+    document.body.appendChild(textarea);
+    textarea.focus();
+    textarea.setSelectionRange(4, 4);
+
+    const bridge = new SegmentBindingBridge(new NativeAdapter(textarea), textarea);
+    const anchor = bridge.beginSession();
+
+    bridge.insertPartial("s1", "bar", 1);
+    vi.advanceTimersByTime(120);
+    expect(textarea.value).toBe("foo bar baz");
+
+    bridge.commitFinal("s1", "bar.");
+    expect(textarea.value).toBe("foo bar. baz");
+    expect(anchor.end).toBe("foo bar.".length);
+
+    bridge.endSession();
+    textarea.remove();
+  });
+
+  it("replaces the native selection on first insert", () => {
+    const textarea = document.createElement("textarea");
+    textarea.value = "hello old world";
+    document.body.appendChild(textarea);
+    textarea.focus();
+    textarea.setSelectionRange(6, 9);
+
+    const bridge = new SegmentBindingBridge(new NativeAdapter(textarea), textarea);
+    bridge.beginSession();
+
+    bridge.insertPartial("s1", "new", 1);
+    vi.advanceTimersByTime(120);
+    expect(textarea.value).toBe("hello new world");
+
+    bridge.commitFinal("s1", "new");
+    expect(textarea.value).toBe("hello new world");
+
+    bridge.endSession();
+    textarea.remove();
+  });
+
+  it("clears only native streaming segments on clearAll", () => {
+    const textarea = document.createElement("textarea");
+    document.body.appendChild(textarea);
+
+    const bridge = new SegmentBindingBridge(new NativeAdapter(textarea), textarea);
+    bridge.beginSession();
+    bridge.insertPartial("placeholder", "...", 0);
+    bridge.clearAll();
+
+    expect(textarea.value).toBe("");
+
+    bridge.insertPartial("s1", "texte final", 1);
+    bridge.commitFinal("s1", "texte final");
+    bridge.insertPartial("s2", "preview", 1);
+    bridge.clearAll();
+
+    expect(textarea.value).toBe("texte final");
+
+    bridge.endSession();
+    textarea.remove();
+  });
+
+  it("skips trimming for adapters that do not expose getSegmentText", () => {
+    const adapter = new RecordingAdapter({ exposeText: false });
+    const element = document.createElement("div");
+    const bridge = new SegmentBindingBridge(adapter, element);
+
+    bridge.beginSession();
+    bridge.insertPartial("a", "Scanner cérébral", 0);
+    bridge.insertPartial("b", "Scanner cérébral. Indication", 0);
+    vi.advanceTimersByTime(120);
+    bridge.commitFinal("a", "Scanner cérébral.");
+
+    expect(adapter.getInternalText("b")).toBe("Scanner cérébral. Indication");
+    expect(adapter.updates.filter((u) => u.id === "b")).toHaveLength(0);
+  });
+
+  it.skip("uses adapter-side text when trimming another open segment — overlap trimming removed (Replace Model, backend-enforced)", () => {
+    const adapter = new RecordingAdapter();
+    const element = document.createElement("div");
+    const bridge = new SegmentBindingBridge(adapter, element);
+
+    bridge.beginSession();
+    bridge.insertPartial("a", "Bonjour docteur", 0);
+    bridge.insertPartial("b", "Bonjour docteur le monde", 0);
+    adapter.simulateManualDomText("b", "Bonjour docteur mes amis");
+    bridge.commitFinal("a", "Bonjour docteur.");
+
+    expect(adapter.getInternalText("b")).toBe("le monde");
+    expect(adapter.getDomText("b")).toBe("Bonjour docteur mes amis");
+    expect(adapter.updates.some((u) => u.id === "b" && u.text === "le monde")).toBe(true);
+  });
+
+  it("does not trim a one-token overlap in the binding DOM path", () => {
+    const textarea = document.createElement("textarea");
+    document.body.appendChild(textarea);
+
+    const adapter = new NativeAdapter(textarea);
+    const bridge = new SegmentBindingBridge(adapter, textarea);
+    bridge.beginSession();
+
+    bridge.insertPartial("a", "le", 0);
+    bridge.insertPartial("b", "le chien", 0);
+    vi.advanceTimersByTime(120);
+    bridge.commitFinal("a", "le");
+
+    expect(adapter.getSegmentText("b")).toBe("le chien");
+    expect(textarea.value).toBe("le le chien");
+
+    bridge.endSession();
+    textarea.remove();
+  });
+
+  it("revises a committed native segment with a later Small final", () => {
+    const textarea = document.createElement("textarea");
+    document.body.appendChild(textarea);
+
+    const bridge = new SegmentBindingBridge(new NativeAdapter(textarea), textarea);
+    bridge.beginSession();
+
+    bridge.insertPartial("s1", "bonjour", 1);
+    vi.advanceTimersByTime(120);
+    expect(textarea.value).toBe("bonjour");
+
+    bridge.commitFinal("s1", "bonjour"); // realtime final
+    expect(textarea.value).toBe("bonjour");
+
+    bridge.commitFinal("s1", "Bonjour."); // small revision
+    expect(textarea.value).toBe("Bonjour.");
+
+    bridge.endSession();
+    textarea.remove();
+  });
+
+  it("ignores identical duplicate commits but still accepts later revisions", () => {
+    const textarea = document.createElement("textarea");
+    document.body.appendChild(textarea);
+    const onInput = vi.fn();
+    textarea.addEventListener("input", onInput);
+
+    const bridge = new SegmentBindingBridge(new NativeAdapter(textarea), textarea);
+    bridge.beginSession();
+
+    bridge.insertPartial("s1", "bonjour", 1);
+    vi.advanceTimersByTime(120);
+    bridge.commitFinal("s1", "bonjour");
+    expect(textarea.value).toBe("bonjour");
+    expect(onInput).toHaveBeenCalledTimes(1);
+
+    bridge.commitFinal("s1", "bonjour");
+    expect(textarea.value).toBe("bonjour");
+    expect(onInput).toHaveBeenCalledTimes(1);
+
+    bridge.commitFinal("s1", "Bonjour.");
+    expect(textarea.value).toBe("Bonjour.");
+    expect(onInput).toHaveBeenCalledTimes(2);
+
+    bridge.endSession();
+    textarea.remove();
+  });
+
+  it("removes absorbed native segments idempotently on commit", () => {
+    const textarea = document.createElement("textarea");
+    document.body.appendChild(textarea);
+
+    const bridge = new SegmentBindingBridge(new NativeAdapter(textarea), textarea);
+    bridge.beginSession();
+
+    bridge.insertPartial("s1", "avec aspect inflammatoire", 1);
+    bridge.insertPartial("s2", "amincissement des parois adjacentes", 1);
+    vi.advanceTimersByTime(120);
+    expect(textarea.value).toBe("avec aspect inflammatoire amincissement des parois adjacentes");
+
+    bridge.commitFinal("s1", "avec aspect inflammatoire et amincissement des parois adjacentes.", {
+      absorbedSegmentIds: ["s2", "missing"],
+    });
+    expect(textarea.value).toBe("avec aspect inflammatoire et amincissement des parois adjacentes.");
+
+    bridge.commitFinal("s1", "avec aspect inflammatoire et amincissement des parois adjacentes.", {
+      absorbedSegmentIds: ["s2"],
+    });
+    expect(textarea.value).toBe("avec aspect inflammatoire et amincissement des parois adjacentes.");
+
+    bridge.endSession();
+    textarea.remove();
+  });
+
+  it("cancels pending native partials for absorbed segments", () => {
+    const textarea = document.createElement("textarea");
+    document.body.appendChild(textarea);
+
+    const bridge = new SegmentBindingBridge(new NativeAdapter(textarea), textarea);
+    bridge.beginSession();
+
+    bridge.insertPartial("s2", "segment absorbé", 1);
+    bridge.commitFinal("s1", "segment fusionné", { absorbedSegmentIds: ["s2"] });
+    vi.advanceTimersByTime(120);
+
+    expect(textarea.value).toBe("segment fusionné");
+
+    bridge.endSession();
+    textarea.remove();
+  });
+
+  it("debounces native partials with a 120ms default and accepts an override", () => {
+    const textarea = document.createElement("textarea");
+    document.body.appendChild(textarea);
+
+    const bridge = new SegmentBindingBridge(new NativeAdapter(textarea), textarea);
+    bridge.beginSession();
+
+    bridge.insertPartial("s1", "bo", 1);
+    bridge.insertPartial("s1", "bonjour", 2);
+    vi.advanceTimersByTime(119);
+    expect(textarea.value).toBe("");
+
+    vi.advanceTimersByTime(1);
+    expect(textarea.value).toBe("bonjour");
+
+    bridge.endSession();
+
+    const fastBridge = new SegmentBindingBridge(new NativeAdapter(textarea), textarea, {
+      partialDebounceMs: 10,
+    });
+    fastBridge.beginSession();
+    fastBridge.insertPartial("s2", " vite", 1);
+    vi.advanceTimersByTime(10);
+
+    expect(textarea.value).toBe("bonjour vite");
+
+    fastBridge.endSession();
+    textarea.remove();
+  });
+
+  it("cancels pending native partials on clearAll, endSession, and detach", () => {
+    const textarea = document.createElement("textarea");
+    document.body.appendChild(textarea);
+
+    const bridge = new SegmentBindingBridge(new NativeAdapter(textarea), textarea);
+    bridge.beginSession();
+    bridge.insertPartial("s1", "preview", 1);
+    bridge.clearAll();
+    vi.advanceTimersByTime(120);
+    expect(textarea.value).toBe("");
+
+    bridge.insertPartial("s2", "preview", 1);
+    bridge.endSession();
+    vi.advanceTimersByTime(120);
+    expect(textarea.value).toBe("");
+
+    bridge.beginSession();
+    bridge.insertPartial("s3", "preview", 1);
+    bridge.detach();
+    vi.advanceTimersByTime(120);
+    expect(textarea.value).toBe("");
+
+    textarea.remove();
+  });
+});
+
+class RecordingAdapter implements BindingAdapter {
+  private segments = new Map<string, { text: string; status: SegmentStatus }>();
+  private domText = new Map<string, string>();
+  readonly updates: Array<{ id: string; text: string; status: SegmentStatus }> = [];
+
+  constructor(private readonly opts: { exposeText?: boolean } = {}) {
+    if (opts.exposeText === false) {
+      (this as { getSegmentText?: (id: string) => string | null }).getSegmentText = undefined;
+    }
+  }
+
+  attach(): void {}
+
+  detach(): void {
+    this.segments.clear();
+  }
+
+  insertSegment(seg: TextSegment): void {
+    this.segments.set(seg.id, { text: seg.text, status: seg.status });
+    this.domText.set(seg.id, seg.text);
+  }
+
+  updateSegment(id: string, text: string, status: SegmentStatus): void {
+    const seg = this.segments.get(id);
+    if (!seg) return;
+    this.segments.set(id, { text, status });
+    this.updates.push({ id, text, status });
+  }
+
+  commitSegment(id: string): void {
+    this.segments.delete(id);
+  }
+
+  removeSegment(id: string): void {
+    this.segments.delete(id);
+  }
+
+  getSegmentText(id: string): string | null {
+    if (this.opts.exposeText === false) return null;
+    const seg = this.segments.get(id);
+    if (!seg || seg.status === "committed") return null;
+    return seg.text;
+  }
+
+  getTextContent(): string {
+    return [...this.segments.values()].map((s) => s.text).join("");
+  }
+
+  getCursorOffset(): number {
+    return this.getTextContent().length;
+  }
+
+  applyOperation(): void {}
+
+  getInternalText(id: string): string | null {
+    return this.segments.get(id)?.text ?? null;
+  }
+
+  simulateManualDomText(id: string, text: string): void {
+    this.domText.set(id, text);
+  }
+
+  getDomText(id: string): string | null {
+    return this.domText.get(id) ?? null;
+  }
+}