import { describe, expect, it, vi } from 'vitest';
import { JSDOM } from 'jsdom';
import {
  buildManualEditBridge,
  buildManualEditBridgeStyle,
  buildManualEditKeyboardGuard,
  isMeaningfulManualEditElement,
  isManualEditHostNode,
  isSourceMappableManualEditElement,
  manualEditDomPathForElement,
  manualEditStableIdForElement,
} from '../../src/edit-mode/bridge';

describe('manual edit bridge target normalization', () => {
  it('prefers explicit data-od-id over generated ids', () => {
    const dom = new JSDOM('<main><h1 data-od-id="hero">Title</h1></main>');
    const target = dom.window.document.querySelector('h1')!;

    expect(manualEditStableIdForElement(target)).toBe('hero');
    expect(target.getAttribute('data-od-runtime-id')).toBeNull();
  });

  it('generates stable DOM path ids for unannotated elements', () => {
    const dom = new JSDOM('<main><section><p>First</p><p>Second</p></section></main>');
    const target = dom.window.document.querySelectorAll('p')[1]!;

    expect(manualEditDomPathForElement(target)).toBe('path-0-0-1');
    expect(manualEditStableIdForElement(target)).toBe('path-0-0-1');
    expect(manualEditStableIdForElement(target)).toBe('path-0-0-1');
    expect(target.getAttribute('data-od-runtime-id')).toBe('path-0-0-1');
  });

  it('generates DOM path ids against source-shaped children, ignoring host shim nodes', () => {
    const dom = new JSDOM(
      '<script data-od-sandbox-shim></script><main><section><p>First</p><p>Second</p></section></main><script data-od-edit-bridge></script>',
    );
    const target = dom.window.document.querySelectorAll('p')[1]!;

    expect(isManualEditHostNode(dom.window.document.querySelector('[data-od-sandbox-shim]')!)).toBe(true);
    expect(manualEditDomPathForElement(target)).toBe('path-0-0-1');
  });

  it('discovers meaningful elements and ignores tiny or irrelevant elements', () => {
    const dom = new JSDOM('<main><h1 data-od-source-path="path-0-0">Title</h1><script>1</script></main>');
    const title = dom.window.document.querySelector('h1')!;
    const script = dom.window.document.querySelector('script')!;

    expect(isMeaningfulManualEditElement(title, { width: 80, height: 24 })).toBe(true);
    expect(isMeaningfulManualEditElement(title, { width: 3, height: 24 })).toBe(false);
    expect(isMeaningfulManualEditElement(script, { width: 80, height: 24 })).toBe(false);
  });

  it('keeps source-mappable display:none targets available for the layers panel', async () => {
    const posts: Array<{ type?: string; targets?: Array<{ id: string; isHidden?: boolean }> }> = [];
    const dom = new JSDOM(
      `<main>
        <h1 data-od-source-path="path-0-0">Visible title</h1>
        <section data-od-source-path="path-0-1" style="display:none">
          <p data-od-source-path="path-0-1-0">Hidden author notes</p>
        </section>
      </main>${buildManualEditBridge(true)}`,
      { runScripts: 'dangerously', url: 'http://localhost' },
    );
    const visible = dom.window.document.querySelector('h1')!;
    const hiddenSection = dom.window.document.querySelector('section')!;
    const hiddenParagraph = dom.window.document.querySelector('p')!;
    visible.getBoundingClientRect = () => ({
      x: 0, y: 0, width: 160, height: 32,
      top: 0, right: 160, bottom: 32, left: 0,
      toJSON: () => ({}),
    } as DOMRect);
    hiddenSection.getBoundingClientRect = () => ({
      x: 0, y: 0, width: 0, height: 0,
      top: 0, right: 0, bottom: 0, left: 0,
      toJSON: () => ({}),
    } as DOMRect);
    hiddenParagraph.getBoundingClientRect = hiddenSection.getBoundingClientRect;
    dom.window.parent.postMessage = ((message: unknown) => {
      posts.push(message as { type?: string; targets?: Array<{ id: string; isHidden?: boolean }> });
    }) as typeof dom.window.parent.postMessage;

    dom.window.dispatchEvent(new dom.window.MessageEvent('message', {
      data: { type: 'od-edit-mode', enabled: true },
    }));
    await new Promise((resolve) => dom.window.setTimeout(resolve, 0));

    const targetsMessage = posts.find((message) => message.type === 'od-edit-targets');
    expect(targetsMessage?.targets?.map((target) => target.id)).toEqual([
      'path-0-0',
      'path-0-1',
      'path-0-1-0',
    ]);
    expect(targetsMessage?.targets?.find((target) => target.id === 'path-0-1')?.isHidden).toBe(true);
    expect(targetsMessage?.targets?.find((target) => target.id === 'path-0-1-0')?.isHidden).toBe(true);

    dom.window.close();
  });

  it('treats hidden containers as layout editable targets', async () => {
    const posts: Array<{ type?: string; targets?: Array<{ id: string; isHidden?: boolean; isLayoutContainer?: boolean }> }> = [];
    const dom = new JSDOM(
      `<main>
        <section data-od-source-path="path-0-0" style="display:none">
          <p data-od-source-path="path-0-0-0">Hidden layout copy</p>
        </section>
      </main>${buildManualEditBridge(true)}`,
      { runScripts: 'dangerously', url: 'http://localhost' },
    );
    const section = dom.window.document.querySelector('section')!;
    const paragraph = dom.window.document.querySelector('p')!;
    section.getBoundingClientRect = () => ({
      x: 0, y: 0, width: 0, height: 0,
      top: 0, right: 0, bottom: 0, left: 0,
      toJSON: () => ({}),
    } as DOMRect);
    paragraph.getBoundingClientRect = section.getBoundingClientRect;
    dom.window.parent.postMessage = ((message: unknown) => {
      posts.push(message as { type?: string; targets?: Array<{ id: string; isHidden?: boolean; isLayoutContainer?: boolean }> });
    }) as typeof dom.window.parent.postMessage;

    dom.window.dispatchEvent(new dom.window.MessageEvent('message', {
      data: { type: 'od-edit-mode', enabled: true },
    }));
    await new Promise((resolve) => dom.window.setTimeout(resolve, 0));

    const targetsMessage = posts.find((message) => message.type === 'od-edit-targets');
    const hiddenSection = targetsMessage?.targets?.find((target) => target.id === 'path-0-0');
    const hiddenParagraph = targetsMessage?.targets?.find((target) => target.id === 'path-0-0-0');
    expect(hiddenSection?.isHidden).toBe(true);
    expect(hiddenSection?.isLayoutContainer).toBe(true);
    expect(hiddenParagraph?.isLayoutContainer).toBe(false);

    dom.window.close();
  });

  it('does not treat visibility-hidden block containers as layout editable targets', async () => {
    const posts: Array<{ type?: string; targets?: Array<{ id: string; isHidden?: boolean; isLayoutContainer?: boolean }> }> = [];
    const dom = new JSDOM(
      `<main>
        <section data-od-source-path="path-0-0" style="visibility:hidden">
          <p data-od-source-path="path-0-0-0">Hidden block copy</p>
        </section>
      </main>${buildManualEditBridge(true)}`,
      { runScripts: 'dangerously', url: 'http://localhost' },
    );
    const section = dom.window.document.querySelector('section')!;
    const paragraph = dom.window.document.querySelector('p')!;
    section.getBoundingClientRect = () => ({
      x: 0, y: 0, width: 160, height: 32,
      top: 0, right: 160, bottom: 32, left: 0,
      toJSON: () => ({}),
    } as DOMRect);
    paragraph.getBoundingClientRect = () => ({
      x: 8, y: 8, width: 140, height: 20,
      top: 8, right: 148, bottom: 28, left: 8,
      toJSON: () => ({}),
    } as DOMRect);
    dom.window.parent.postMessage = ((message: unknown) => {
      posts.push(message as { type?: string; targets?: Array<{ id: string; isHidden?: boolean; isLayoutContainer?: boolean }> });
    }) as typeof dom.window.parent.postMessage;

    dom.window.dispatchEvent(new dom.window.MessageEvent('message', {
      data: { type: 'od-edit-mode', enabled: true },
    }));
    await new Promise((resolve) => dom.window.setTimeout(resolve, 0));

    const targetsMessage = posts.find((message) => message.type === 'od-edit-targets');
    const hiddenSection = targetsMessage?.targets?.find((target) => target.id === 'path-0-0');
    expect(hiddenSection?.isHidden).toBe(true);
    expect(hiddenSection?.isLayoutContainer).toBe(false);

    dom.window.close();
  });

  it('does not treat block containers hidden only by an ancestor as layout editable targets', async () => {
    const posts: Array<{ type?: string; targets?: Array<{ id: string; isHidden?: boolean; isLayoutContainer?: boolean }> }> = [];
    const dom = new JSDOM(
      `<main>
        <div data-od-source-path="path-0-0" style="display:none">
          <section data-od-source-path="path-0-0-0">Nested hidden section</section>
        </div>
      </main>${buildManualEditBridge(true)}`,
      { runScripts: 'dangerously', url: 'http://localhost' },
    );
    const wrapper = dom.window.document.querySelector('div')!;
    const section = dom.window.document.querySelector('section')!;
    wrapper.getBoundingClientRect = () => ({
      x: 0, y: 0, width: 0, height: 0,
      top: 0, right: 0, bottom: 0, left: 0,
      toJSON: () => ({}),
    } as DOMRect);
    section.getBoundingClientRect = wrapper.getBoundingClientRect;
    dom.window.parent.postMessage = ((message: unknown) => {
      posts.push(message as { type?: string; targets?: Array<{ id: string; isHidden?: boolean; isLayoutContainer?: boolean }> });
    }) as typeof dom.window.parent.postMessage;

    dom.window.dispatchEvent(new dom.window.MessageEvent('message', {
      data: { type: 'od-edit-mode', enabled: true },
    }));
    await new Promise((resolve) => dom.window.setTimeout(resolve, 0));

    const targetsMessage = posts.find((message) => message.type === 'od-edit-targets');
    const hiddenSection = targetsMessage?.targets?.find((target) => target.id === 'path-0-0-0');
    expect(hiddenSection?.isHidden).toBe(true);
    expect(hiddenSection?.isLayoutContainer).toBe(false);

    dom.window.close();
  });

  it('does not mark visibility:visible descendants as hidden', async () => {
    const posts: Array<{ type?: string; targets?: Array<{ id: string; isHidden?: boolean }> }> = [];
    const dom = new JSDOM(
      `<main>
        <section data-od-source-path="path-0-0" style="visibility:hidden">
          <p data-od-source-path="path-0-0-0" style="visibility:visible">Visible child copy</p>
        </section>
      </main>${buildManualEditBridge(true)}`,
      { runScripts: 'dangerously', url: 'http://localhost' },
    );
    const section = dom.window.document.querySelector('section')!;
    const visibleChild = dom.window.document.querySelector('p')!;
    section.getBoundingClientRect = () => ({
      x: 0, y: 0, width: 160, height: 32,
      top: 0, right: 160, bottom: 32, left: 0,
      toJSON: () => ({}),
    } as DOMRect);
    visibleChild.getBoundingClientRect = () => ({
      x: 8, y: 8, width: 140, height: 20,
      top: 8, right: 148, bottom: 28, left: 8,
      toJSON: () => ({}),
    } as DOMRect);
    dom.window.parent.postMessage = ((message: unknown) => {
      posts.push(message as { type?: string; targets?: Array<{ id: string; isHidden?: boolean }> });
    }) as typeof dom.window.parent.postMessage;

    dom.window.dispatchEvent(new dom.window.MessageEvent('message', {
      data: { type: 'od-edit-mode', enabled: true },
    }));
    await new Promise((resolve) => dom.window.setTimeout(resolve, 0));

    const targetsMessage = posts.find((message) => message.type === 'od-edit-targets');
    expect(targetsMessage?.targets?.find((target) => target.id === 'path-0-0')?.isHidden).toBe(true);
    expect(targetsMessage?.targets?.find((target) => target.id === 'path-0-0-0')?.isHidden).toBe(false);

    dom.window.close();
  });

  it('does not expose runtime-only path targets unless they carry a source marker', () => {
    const dom = new JSDOM('<main><h1>Runtime title</h1><p data-od-source-path="path-0-1">Source text</p></main>');
    const runtimeTitle = dom.window.document.querySelector('h1')!;
    const sourceText = dom.window.document.querySelector('p')!;

    expect(isSourceMappableManualEditElement(runtimeTitle)).toBe(false);
    expect(isSourceMappableManualEditElement(sourceText)).toBe(true);
    expect(isMeaningfulManualEditElement(runtimeTitle, { width: 80, height: 24 })).toBe(false);
  });

  it('omits selected outerHTML from bulk target posts but includes it for selected targets', () => {
    const bridge = buildManualEditBridge(true);

    expect(bridge).toContain('targets.push(targetFrom(nodes[i], false))');
    expect(bridge).toContain("target: targetFrom(el, true)");
    expect(bridge).toContain('if (!isSourceMappable(nodes[i])) continue;');
    expect(bridge).toContain('return el;');
    expect(bridge).not.toContain('if (isPrimaryTarget(el)) return el;');
  });

  it('selects and announces ordinary HTML elements after srcdoc source-path annotation', () => {
    const dom = new JSDOM(
      `<main data-od-source-path="path-0"><section data-od-source-path="path-0-0"><h1 data-od-source-path="path-0-0-0">Plain title</h1><p data-od-source-path="path-0-0-1">Plain body</p></section></main>${buildManualEditBridge(true)}`,
      { runScripts: 'dangerously', url: 'http://localhost' },
    );
    const title = dom.window.document.querySelector('h1') as HTMLElement;
    title.getBoundingClientRect = () => ({
      x: 0, y: 0, width: 160, height: 36,
      top: 0, right: 160, bottom: 36, left: 0,
      toJSON: () => ({}),
    } as DOMRect);
    const postMessage = vi.spyOn(dom.window.parent, 'postMessage');

    title.dispatchEvent(new dom.window.Event('pointerover', { bubbles: true }));
    title.dispatchEvent(new dom.window.MouseEvent('click', { bubbles: true, cancelable: true }));

    expect(title.getAttribute('data-od-runtime-id')).toBe('path-0-0-0');
    expect(postMessage).toHaveBeenCalledWith({
      type: 'od-edit-hover',
      target: expect.objectContaining({ id: 'path-0-0-0', label: 'Plain title' }),
    }, '*');
    expect(postMessage).toHaveBeenCalledWith({
      type: 'od-edit-select',
      target: expect.objectContaining({ id: 'path-0-0-0', kind: 'text' }),
    }, '*');

    dom.window.close();
  });

  it('ignores runtime-inserted elements that are not present in source', () => {
    const dom = new JSDOM(
      `<main data-od-source-path="path-0"><h1 data-od-source-path="path-0-0">Source title</h1></main>${buildManualEditBridge(true)}`,
      { runScripts: 'dangerously', url: 'http://localhost' },
    );
    const runtimePill = dom.window.document.createElement('span');
    runtimePill.className = 'status-pill ready';
    runtimePill.textContent = 'Brand ready';
    dom.window.document.body.appendChild(runtimePill);
    const postMessage = vi.spyOn(dom.window.parent, 'postMessage');

    runtimePill.dispatchEvent(new dom.window.Event('pointerover', { bubbles: true }));
    runtimePill.dispatchEvent(new dom.window.MouseEvent('click', { bubbles: true, cancelable: true }));

    expect(runtimePill.hasAttribute('data-od-runtime-id')).toBe(false);
    expect(postMessage).not.toHaveBeenCalledWith(expect.objectContaining({
      type: 'od-edit-hover',
    }), '*');
    expect(postMessage).toHaveBeenCalledWith({ type: 'od-edit-background' }, '*');

    dom.window.close();
  });

  it('selects runtime-inserted brand kit elements that carry stable data-od-id markers', () => {
    const dom = new JSDOM(
      `<main data-od-source-path="path-0"><div id="root"></div></main>${buildManualEditBridge(true)}`,
      { runScripts: 'dangerously', url: 'http://localhost' },
    );
    const title = dom.window.document.createElement('h1');
    title.setAttribute('data-od-id', 'brand-name');
    title.setAttribute('data-od-edit', 'text');
    title.textContent = 'Runtime brand';
    title.getBoundingClientRect = () => ({
      x: 0, y: 0, width: 180, height: 42,
      top: 0, right: 180, bottom: 42, left: 0,
      toJSON: () => ({}),
    } as DOMRect);
    dom.window.document.getElementById('root')?.appendChild(title);
    const postMessage = vi.spyOn(dom.window.parent, 'postMessage');

    title.dispatchEvent(new dom.window.Event('pointerover', { bubbles: true }));
    title.dispatchEvent(new dom.window.MouseEvent('click', { bubbles: true, cancelable: true }));

    expect(postMessage).toHaveBeenCalledWith({
      type: 'od-edit-hover',
      target: expect.objectContaining({ id: 'brand-name', label: 'Runtime brand' }),
    }, '*');
    expect(postMessage).toHaveBeenCalledWith({
      type: 'od-edit-select',
      target: expect.objectContaining({ id: 'brand-name', kind: 'text' }),
    }, '*');

    dom.window.close();
  });

  it('adds stable ids to legacy runtime brand kit elements before selection', () => {
    const dom = new JSDOM(
      `<script id="od-brand-payload" type="application/json">{"brand":{"name":"Runtime brand"}}</script><main data-od-source-path="path-0"><div id="root"></div></main>${buildManualEditBridge(true)}`,
      { runScripts: 'dangerously', url: 'http://localhost' },
    );
    const title = dom.window.document.createElement('h1');
    title.className = 'kit-title';
    title.textContent = 'Runtime brand';
    title.getBoundingClientRect = () => ({
      x: 0, y: 0, width: 180, height: 42,
      top: 0, right: 180, bottom: 42, left: 0,
      toJSON: () => ({}),
    } as DOMRect);
    dom.window.document.getElementById('root')?.appendChild(title);
    const postMessage = vi.spyOn(dom.window.parent, 'postMessage');

    title.dispatchEvent(new dom.window.Event('pointerover', { bubbles: true }));
    title.dispatchEvent(new dom.window.MouseEvent('click', { bubbles: true, cancelable: true }));

    expect(title.getAttribute('data-od-id')).toBe('brand-name');
    expect(title.getAttribute('data-od-edit')).toBe('text');
    expect(postMessage).toHaveBeenCalledWith({
      type: 'od-edit-hover',
      target: expect.objectContaining({ id: 'brand-name', label: 'Runtime brand' }),
    }, '*');
    expect(postMessage).toHaveBeenCalledWith({
      type: 'od-edit-select',
      target: expect.objectContaining({ id: 'brand-name', kind: 'text' }),
    }, '*');

    dom.window.close();
  });

  it('prefers the deepest source-mapped child over an annotated group on hover', async () => {
    const posts: Array<{ type?: string; target?: { id: string; label?: string } }> = [];
    const dom = new JSDOM(
      `<main>
        <section data-od-id="hero-group">
          <span data-od-source-path="path-0-0-0">Small label</span>
        </section>
      </main>${buildManualEditBridge(true)}`,
      { runScripts: 'dangerously', url: 'http://localhost' },
    );
    const span = dom.window.document.querySelector('span')!;
    dom.window.parent.postMessage = ((message: unknown) => {
      posts.push(message as { type?: string; target?: { id: string; label?: string } });
    }) as typeof dom.window.parent.postMessage;

    span.dispatchEvent(new dom.window.Event('pointerover', { bubbles: true }));

    const hover = posts.find((message) => message.type === 'od-edit-hover');
    expect(hover?.target?.id).toBe('path-0-0-0');
    expect(hover?.target?.label).toBe('Small label');

    dom.window.close();
  });

  it('acks live preview style patches by id and version', () => {
    const bridge = buildManualEditBridge(true);

    expect(bridge).toContain("type: 'od-edit-preview-style-applied'");
    expect(bridge).toContain('version: Number(version) || 0, ok: true');
    expect(bridge).toContain("ok: false, error: 'Target not found'");
  });

  it('keeps edit-mode hover outlines visible over artifact CSS resets', () => {
    const style = buildManualEditBridgeStyle();

    expect(style).toContain('outline: 1px dashed rgba(37, 99, 235, 0.35) !important');
    expect(style).toContain('outline: 2px solid #2563eb !important');
    expect(style).toContain('outline-offset: 3px !important');
  });

  it('moves the runtime selected marker between selected targets', () => {
    const dom = new JSDOM(
      `<main>
        <h1 data-od-id="title">Title</h1>
        <p data-od-id="body">Body</p>
      </main>${buildManualEditBridge(true)}`,
      { runScripts: 'dangerously', url: 'http://localhost' },
    );
    const title = dom.window.document.querySelector('[data-od-id="title"]')!;
    const body = dom.window.document.querySelector('[data-od-id="body"]')!;

    dom.window.dispatchEvent(new dom.window.MessageEvent('message', {
      data: { type: 'od-edit-selected-target', id: 'title' },
    }));
    expect(title.getAttribute('data-od-edit-selected')).toBe('true');
    expect(body.hasAttribute('data-od-edit-selected')).toBe(false);

    dom.window.dispatchEvent(new dom.window.MessageEvent('message', {
      data: { type: 'od-edit-selected-target', id: 'body' },
    }));
    expect(title.hasAttribute('data-od-edit-selected')).toBe(false);
    expect(body.getAttribute('data-od-edit-selected')).toBe('true');

    dom.window.close();
  });

  it('clears runtime selected markers for null selection and edit-mode exit', () => {
    const dom = new JSDOM(
      `<main>
        <h1 data-od-id="title">Title</h1>
        <p data-od-id="body" data-od-edit-selected="true">Body</p>
      </main>${buildManualEditBridge(true)}`,
      { runScripts: 'dangerously', url: 'http://localhost' },
    );
    const body = dom.window.document.querySelector('[data-od-id="body"]')!;

    dom.window.dispatchEvent(new dom.window.MessageEvent('message', {
      data: { type: 'od-edit-selected-target', id: null },
    }));
    expect(body.hasAttribute('data-od-edit-selected')).toBe(false);

    dom.window.dispatchEvent(new dom.window.MessageEvent('message', {
      data: { type: 'od-edit-selected-target', id: 'body' },
    }));
    expect(body.getAttribute('data-od-edit-selected')).toBe('true');

    dom.window.dispatchEvent(new dom.window.MessageEvent('message', {
      data: { type: 'od-edit-mode', enabled: false },
    }));
    expect(body.hasAttribute('data-od-edit-selected')).toBe(false);

    dom.window.close();
  });

  it('keeps runtime selection marker out of source-shaped target data', () => {
    const bridge = buildManualEditBridge(true);

    expect(bridge).toContain("attr.name === 'data-od-edit-selected'");
    expect(bridge).toContain('replace(/\\sdata-od-edit-selected="[^"]*"/g, \'\')');
    expect(bridge).toContain('[data-od-edit-selected]');
  });

  it('marks flex/grid targets as layout containers', () => {
    const bridge = buildManualEditBridge(true);

    expect(bridge).toContain('isLayoutContainer: isLayoutContainer(el)');
    expect(bridge).toContain("display.indexOf('flex') >= 0 || display.indexOf('grid') >= 0");
  });

  it('turns text targets into inline editors and commits changed text on explicit finish', () => {
    const dom = new JSDOM(
      `<main><h1 data-od-id="title">Original title</h1></main>${buildManualEditBridge(true)}`,
      { runScripts: 'dangerously', url: 'http://localhost' },
    );
    const title = dom.window.document.querySelector('[data-od-id="title"]') as HTMLElement;
    const postMessage = vi.spyOn(dom.window.parent, 'postMessage');

    title.dispatchEvent(new dom.window.MouseEvent('click', {
      bubbles: true,
      cancelable: true,
      clientX: 8,
      clientY: 8,
    }));
    expect(title.getAttribute('contenteditable')).toBe('plaintext-only');
    expect(title.getAttribute('data-od-editing')).toBe('true');
    expect(postMessage).toHaveBeenCalledWith({
      type: 'od-edit-select',
      target: expect.objectContaining({
        id: 'title',
        kind: 'text',
      }),
    }, '*');

    title.textContent = 'Edited title';

    dom.window.dispatchEvent(new dom.window.MessageEvent('message', {
      data: { type: 'od-edit-text-finish', commit: true },
    }));

    expect(title.hasAttribute('contenteditable')).toBe(false);
    expect(title.hasAttribute('data-od-editing')).toBe(false);
    expect(postMessage).toHaveBeenCalledWith({
      type: 'od-edit-text-commit',
      id: 'title',
      value: 'Edited title',
    }, '*');
    expect(postMessage).toHaveBeenCalledWith({
      type: 'od-edit-text-session',
      id: 'title',
      active: false,
      committed: true,
      changed: true,
    }, '*');

    dom.window.close();
  });

  // #3646 focus-loss half: once editing, blurring the iframe (e.g. moving the
  // pointer to the host's floating inspector) must NOT end the session or
  // commit. Only an explicit finish (Enter/Escape/od-edit-text-finish) commits.
  it('keeps the inline edit active on blur and commits only on explicit finish', () => {
    const dom = new JSDOM(
      `<main><h1 data-od-id="title">Original title</h1></main>${buildManualEditBridge(true)}`,
      { runScripts: 'dangerously', url: 'http://localhost' },
    );
    const title = dom.window.document.querySelector('[data-od-id="title"]') as HTMLElement;
    const postMessage = vi.spyOn(dom.window.parent, 'postMessage');

    title.dispatchEvent(new dom.window.MouseEvent('click', {
      bubbles: true,
      cancelable: true,
      clientX: 8,
      clientY: 8,
    }));
    title.textContent = 'Edited title';
    title.dispatchEvent(new dom.window.FocusEvent('blur', { bubbles: false }));

    // Blur is no longer a commit trigger — the session stays live.
    expect(title.getAttribute('contenteditable')).toBe('plaintext-only');
    expect(title.getAttribute('data-od-editing')).toBe('true');
    expect(postMessage).not.toHaveBeenCalledWith(expect.objectContaining({
      type: 'od-edit-text-commit',
    }), '*');

    // The host drives the commit explicitly.
    dom.window.dispatchEvent(new dom.window.MessageEvent('message', {
      data: { type: 'od-edit-text-finish', commit: true },
    }));

    expect(title.hasAttribute('contenteditable')).toBe(false);
    expect(postMessage).toHaveBeenCalledWith({
      type: 'od-edit-text-commit',
      id: 'title',
      value: 'Edited title',
    }, '*');

    dom.window.close();
  });

  // #3646 / review fix: clicking empty background while editing must commit and
  // end the session (and tell the host), so host and iframe never desync.
  it('commits an in-flight inline edit when clicking empty background', () => {
    const dom = new JSDOM(
      `<main><h1 data-od-id="title">Original</h1></main>${buildManualEditBridge(true)}`,
      { runScripts: 'dangerously', url: 'http://localhost' },
    );
    const title = dom.window.document.querySelector('[data-od-id="title"]') as HTMLElement;
    const postMessage = vi.spyOn(dom.window.parent, 'postMessage');

    title.dispatchEvent(new dom.window.MouseEvent('click', { bubbles: true, cancelable: true }));
    title.textContent = 'Edited';
    dom.window.document.body.dispatchEvent(new dom.window.MouseEvent('click', { bubbles: true, cancelable: true }));

    expect(postMessage).toHaveBeenCalledWith({
      type: 'od-edit-text-commit',
      id: 'title',
      value: 'Edited',
    }, '*');
    expect(postMessage).toHaveBeenCalledWith(expect.objectContaining({
      type: 'od-edit-text-session',
      id: 'title',
      active: false,
    }), '*');
    expect(postMessage).toHaveBeenCalledWith({ type: 'od-edit-background' }, '*');
    expect(title.hasAttribute('contenteditable')).toBe(false);

    dom.window.close();
  });

  it('cancels inline text edits with Escape without posting a commit', () => {
    const dom = new JSDOM(
      `<main><p data-od-id="body">Original body</p></main>${buildManualEditBridge(true)}`,
      { runScripts: 'dangerously', url: 'http://localhost' },
    );
    const body = dom.window.document.querySelector('[data-od-id="body"]') as HTMLElement;
    const postMessage = vi.spyOn(dom.window.parent, 'postMessage');

    body.dispatchEvent(new dom.window.MouseEvent('click', { bubbles: true, cancelable: true }));
    body.textContent = 'Draft body';
    body.dispatchEvent(new dom.window.KeyboardEvent('keydown', {
      bubbles: true,
      cancelable: true,
      key: 'Escape',
    }));

    expect(body.textContent).toBe('Original body');
    expect(postMessage).not.toHaveBeenCalledWith(expect.objectContaining({
      type: 'od-edit-text-commit',
    }), '*');

    dom.window.close();
  });

  it('removes a window keydown listener registered with the original callback, so the wrapper is not left firing', () => {
    const guardHtml = buildManualEditKeyboardGuard();
    const dom = new JSDOM(
      `<!DOCTYPE html><html><body>${guardHtml}</body></html>`,
      { runScripts: 'dangerously', url: 'http://localhost' },
    );
    const listener = vi.fn();

    dom.window.addEventListener('keydown', listener);
    dom.window.dispatchEvent(new dom.window.KeyboardEvent('keydown', { key: 'a' }));
    expect(listener).toHaveBeenCalledTimes(1);

    dom.window.removeEventListener('keydown', listener);
    dom.window.dispatchEvent(new dom.window.KeyboardEvent('keydown', { key: 'a' }));
    expect(listener).toHaveBeenCalledTimes(1);

    dom.window.close();
  });

  it('removes a document keydown listener registered with the original callback, so the wrapper is not left firing', () => {
    const guardHtml = buildManualEditKeyboardGuard();
    const dom = new JSDOM(
      `<!DOCTYPE html><html><body>${guardHtml}</body></html>`,
      { runScripts: 'dangerously', url: 'http://localhost' },
    );
    const listener = vi.fn();

    dom.window.document.addEventListener('keydown', listener);
    dom.window.document.dispatchEvent(new dom.window.KeyboardEvent('keydown', { key: 'a' }));
    expect(listener).toHaveBeenCalledTimes(1);

    dom.window.document.removeEventListener('keydown', listener);
    dom.window.document.dispatchEvent(new dom.window.KeyboardEvent('keydown', { key: 'a' }));
    expect(listener).toHaveBeenCalledTimes(1);

    dom.window.close();
  });

  it('treats duplicate addEventListener with the same callback and capture as a no-op, matching native behavior', () => {
    const guardHtml = buildManualEditKeyboardGuard();
    const dom = new JSDOM(
      `<!DOCTYPE html><html><body>${guardHtml}</body></html>`,
      { runScripts: 'dangerously', url: 'http://localhost' },
    );
    const listener = vi.fn();

    dom.window.addEventListener('keydown', listener, true);
    dom.window.addEventListener('keydown', listener, true); // duplicate — should be no-op
    dom.window.dispatchEvent(new dom.window.KeyboardEvent('keydown', { key: 'a' }));
    expect(listener).toHaveBeenCalledTimes(1); // fires once, not twice

    dom.window.removeEventListener('keydown', listener, true); // single remove clears it
    dom.window.dispatchEvent(new dom.window.KeyboardEvent('keydown', { key: 'a' }));
    expect(listener).toHaveBeenCalledTimes(1); // no longer fires

    dom.window.close();
  });

  it('matches the capture flag when removing a wrapped keydown listener', () => {
    const guardHtml = buildManualEditKeyboardGuard();
    const dom = new JSDOM(
      `<!DOCTYPE html><html><body>${guardHtml}</body></html>`,
      { runScripts: 'dangerously', url: 'http://localhost' },
    );
    const bubbleListener = vi.fn();
    const captureListener = vi.fn();

    dom.window.addEventListener('keydown', bubbleListener, false);
    dom.window.addEventListener('keydown', captureListener, true);

    dom.window.removeEventListener('keydown', bubbleListener, false);
    dom.window.dispatchEvent(new dom.window.KeyboardEvent('keydown', { key: 'a' }));
    expect(bubbleListener).not.toHaveBeenCalled();
    expect(captureListener).toHaveBeenCalledTimes(1);

    dom.window.close();
  });

  it('cleans up wrapped entry after a once:true listener fires, allowing re-registration', () => {
    const guardHtml = buildManualEditKeyboardGuard();
    const dom = new JSDOM(
      `<!DOCTYPE html><html><body>${guardHtml}</body></html>`,
      { runScripts: 'dangerously', url: 'http://localhost' },
    );
    const listener = vi.fn();

    dom.window.addEventListener('keydown', listener, { once: true, capture: true });
    dom.window.dispatchEvent(new dom.window.KeyboardEvent('keydown', { key: 'a' }));
    expect(listener).toHaveBeenCalledTimes(1); // once fires once

    // After once fires, the browser removed the handler; re-adding the same callback should work
    dom.window.addEventListener('keydown', listener, { once: true, capture: true });
    dom.window.dispatchEvent(new dom.window.KeyboardEvent('keydown', { key: 'b' }));
    expect(listener).toHaveBeenCalledTimes(2); // re-registered and fired again

    dom.window.close();
  });

  it('cleans up wrapped entry when an AbortSignal aborts, allowing re-registration', () => {
    const guardHtml = buildManualEditKeyboardGuard();
    const dom = new JSDOM(
      `<!DOCTYPE html><html><body>${guardHtml}</body></html>`,
      { runScripts: 'dangerously', url: 'http://localhost' },
    );
    const listener = vi.fn();
    const controller = new dom.window.AbortController();

    dom.window.addEventListener('keydown', listener, { signal: controller.signal, capture: true });
    dom.window.dispatchEvent(new dom.window.KeyboardEvent('keydown', { key: 'a' }));
    expect(listener).toHaveBeenCalledTimes(1);

    controller.abort(); // browser removes the handler; our bookkeeping must also drop the entry

    // Re-adding the same callback/capture should now succeed (not be treated as a duplicate)
    const controller2 = new dom.window.AbortController();
    dom.window.addEventListener('keydown', listener, { signal: controller2.signal, capture: true });
    dom.window.dispatchEvent(new dom.window.KeyboardEvent('keydown', { key: 'b' }));
    expect(listener).toHaveBeenCalledTimes(2);

    dom.window.close();
  });

  it('allows re-adding a once listener after it was suppressed by the edit guard', () => {
    const guardHtml = buildManualEditKeyboardGuard();
    const dom = new JSDOM(
      `<!DOCTYPE html><html><body>${guardHtml}</body></html>`,
      { runScripts: 'dangerously', url: 'http://localhost' },
    );
    const listener = vi.fn();

    // Set editingEl so shouldBlock() returns true for events inside it
    const editable = dom.window.document.createElement('div');
    editable.setAttribute('data-od-editing', 'true');
    dom.window.document.body.appendChild(editable);
    (dom.window as any).__odEditGuard.editingEl = editable;

    // Register a once listener on window (capture phase) — dispatch from inside editable so guard suppresses it
    dom.window.addEventListener('keydown', listener, { once: true, capture: true });
    editable.dispatchEvent(new dom.window.KeyboardEvent('keydown', { key: 'a', bubbles: true }));
    expect(listener).not.toHaveBeenCalled(); // suppressed by guard

    // The once handler was consumed (both by browser and our bookkeeping)
    // Re-adding the same callback should work
    (dom.window as any).__odEditGuard.editingEl = null; // clear guard so next event fires
    dom.window.addEventListener('keydown', listener, { once: true, capture: true });
    dom.window.dispatchEvent(new dom.window.KeyboardEvent('keydown', { key: 'b' }));
    expect(listener).toHaveBeenCalledTimes(1); // re-registered and fired

    dom.window.close();
  });

  it('does not leave a stale entry when addEventListener is called with an already-aborted signal', () => {
    const guardHtml = buildManualEditKeyboardGuard();
    const dom = new JSDOM(
      `<!DOCTYPE html><html><body>${guardHtml}</body></html>`,
      { runScripts: 'dangerously', url: 'http://localhost' },
    );
    const listener = vi.fn();
    const controller = new dom.window.AbortController();
    controller.abort(); // already aborted before registration

    // Registering with an already-aborted signal should not leave a stale entry
    dom.window.addEventListener('keydown', listener, { signal: controller.signal, capture: true });

    // The listener should not fire (browser ignores registration with aborted signal)
    dom.window.dispatchEvent(new dom.window.KeyboardEvent('keydown', { key: 'a' }));
    expect(listener).not.toHaveBeenCalled();

    // Re-registering the same callback/capture should succeed (not be blocked by a stale dedup entry)
    dom.window.addEventListener('keydown', listener, { capture: true });
    dom.window.dispatchEvent(new dom.window.KeyboardEvent('keydown', { key: 'b' }));
    expect(listener).toHaveBeenCalledTimes(1);

    dom.window.close();
  });

  it('blocks clicks on unmapped elements while edit mode is enabled', () => {
    const dom = new JSDOM(
      `<main><button id="cta">Launch</button></main>${buildManualEditBridge(true)}`,
      { runScripts: 'dangerously', url: 'http://localhost' },
    );
    const button = dom.window.document.getElementById('cta') as HTMLButtonElement;
    const clicked = vi.fn();
    button.addEventListener('click', clicked);

    const event = new dom.window.MouseEvent('click', { bubbles: true, cancelable: true });
    const result = button.dispatchEvent(event);

    expect(result).toBe(false);
    expect(event.defaultPrevented).toBe(true);
    expect(clicked).not.toHaveBeenCalled();

    dom.window.close();
  });
});