feat: stream editor selection changes

Author: cs50victor

__tests__/desktop-stub-utils.test.js

@@ -14,6 +14,13 @@ import {
   extractMediaFilename,
   buildMediaUrl,
   extractBlobUrl,
+  SELECTION_CHANGED_MESSAGE_TYPE,
+  extractSelectedText,
+  serializeSelectedElements,
+  buildCellSelectionPayload,
+  buildDocumentSelectionPayload,
+  buildSelectionMessage,
+  createSelectionStream,
   FONT_SPRITE_BASE_WIDTH,
   FONT_SPRITE_ROW_HEIGHT
 } from '../editors/desktop-stub-utils.js';
@@ -394,6 +401,208 @@ describe('extractBlobUrl', () => {
   });
 });
 
+describe('selection streaming utilities', () => {
+  test('extractSelectedText reads Word and slide selected text safely', () => {
+    const api = {
+      asc_GetSelectedText(includeHidden) {
+        expect(includeHidden).toBe(false);
+        return 'selected word text';
+      }
+    };
+
+    expect(extractSelectedText(api)).toBe('selected word text');
+    expect(extractSelectedText({ asc_GetSelectedText() { throw new Error('sdk failure'); } })).toBe('');
+    expect(extractSelectedText(null)).toBe('');
+  });
+
+  test('buildCellSelectionPayload streams active Excel cell, range, text, and sheet index', () => {
+    const api = {
+      asc_getCellInfo() {
+        return {
+          asc_getName() { return 'B2'; },
+          asc_getText() { return 'Quarterly revenue'; }
+        };
+      },
+      asc_getActiveRangeStr(_unused, activeCell) {
+        return activeCell ? 'B2' : 'B2:D4';
+      },
+      asc_getActiveWorksheetIndex() {
+        return 2;
+      }
+    };
+
+    expect(buildCellSelectionPayload(api, {}, null)).toEqual({
+      kind: 'cell',
+      cell: 'B2',
+      range: 'B2:D4',
+      activeCell: 'B2',
+      sheetIndex: 2,
+      text: 'Quarterly revenue'
+    });
+  });
+
+  test('buildCellSelectionPayload falls back to the workbook selection model', () => {
+    const api = {
+      wbModel: {
+        getActiveWs() {
+          return {
+            selectionRange: {
+              getLast() {
+                return { c1: 26, r1: 9 };
+              }
+            }
+          };
+        }
+      },
+      getActiveWorksheetIndex() {
+        return 1;
+      }
+    };
+
+    expect(buildCellSelectionPayload(api, { AscCommonExcel: {} }, null)).toEqual({
+      kind: 'cell',
+      cell: 'AA10',
+      range: 'AA10',
+      activeCell: 'AA10',
+      sheetIndex: 1,
+      text: null
+    });
+  });
+
+  test('serializeSelectedElements keeps image metadata JSON-safe and drops raw SDK objects', () => {
+    const rawValue = {
+      imageUrl: 'media/image1.png',
+      cyclic: null
+    };
+    rawValue.cyclic = rawValue;
+
+    const result = serializeSelectedElements([
+      {
+        asc_getType() { return 'Image'; },
+        asc_getObjectValue() { return rawValue; },
+        getId() { return 'object-1'; }
+      }
+    ]);
+
+    expect(result).toEqual([
+      {
+        type: 'Image',
+        id: 'object-1',
+        imageUrl: 'media/image1.png',
+        hasImage: true
+      }
+    ]);
+    expect(result[0].value).toBeUndefined();
+    expect(JSON.stringify(result)).toBe('[{"type":"Image","id":"object-1","imageUrl":"media/image1.png","hasImage":true}]');
+  });
+
+  test('buildDocumentSelectionPayload prefers selected Word text and includes selected objects', () => {
+    const api = {
+      asc_GetSelectedText() {
+        return 'hello world';
+      },
+      getSelectedElements() {
+        return [{ type: 'Paragraph', value: 'p1' }];
+      }
+    };
+
+    expect(buildDocumentSelectionPayload(api)).toEqual({
+      kind: 'text',
+      text: 'hello world',
+      objects: [
+        {
+          type: 'Paragraph',
+          value: 'p1',
+          hasImage: false
+        }
+      ]
+    });
+  });
+
+  test('buildDocumentSelectionPayload emits image selection when text is empty', () => {
+    const api = {
+      asc_GetSelectedText() {
+        return '';
+      }
+    };
+
+    expect(buildDocumentSelectionPayload(api, [{ type: 'Picture', ImageUrl: 'media/photo.png' }])).toEqual({
+      kind: 'image',
+      objects: [
+        {
+          type: 'Picture',
+          imageUrl: 'media/photo.png',
+          hasImage: true
+        }
+      ]
+    });
+  });
+
+  test('buildSelectionMessage includes file identity so all open files can be merged by the host', () => {
+    expect(buildSelectionMessage({
+      doctype: 'word',
+      filePath: '/tmp/report.docx',
+      filename: 'report.docx'
+    }, { kind: 'text', text: 'budget' }, 1234)).toEqual({
+      type: SELECTION_CHANGED_MESSAGE_TYPE,
+      filePath: '/tmp/report.docx',
+      filename: 'report.docx',
+      doctype: 'word',
+      selection: { kind: 'text', text: 'budget' },
+      timestamp: 1234
+    });
+  });
+
+  test('createSelectionStream posts live selection changes and dedupes identical payloads', () => {
+    const posted = [];
+    const parentWindow = {
+      postMessage(message, targetOrigin) {
+        posted.push({ message, targetOrigin });
+      }
+    };
+    const api = {
+      asc_getCellInfo() {
+        return {
+          asc_getName() { return 'C3'; },
+          asc_getText() { return '42'; }
+        };
+      },
+      asc_getActiveWorksheetIndex() {
+        return 0;
+      }
+    };
+    const stream = createSelectionStream({
+      api,
+      parentWindow,
+      doctype: 'cell',
+      filePath: '/tmp/book.xlsx',
+      filename: 'book.xlsx',
+      now: () => 999
+    });
+
+    const first = stream.emitCell();
+    const duplicate = stream.emitCell();
+
+    expect(first).toEqual({
+      type: SELECTION_CHANGED_MESSAGE_TYPE,
+      filePath: '/tmp/book.xlsx',
+      filename: 'book.xlsx',
+      doctype: 'cell',
+      selection: {
+        kind: 'cell',
+        cell: 'C3',
+        range: 'C3',
+        activeCell: 'C3',
+        sheetIndex: 0,
+        text: '42'
+      },
+      timestamp: 999
+    });
+    expect(duplicate).toBe(null);
+    expect(posted).toEqual([{ message: first, targetOrigin: '*' }]);
+  });
+});
+
 describe('constants', () => {
   test('FONT_SPRITE_BASE_WIDTH is defined', () => {
     expect(FONT_SPRITE_BASE_WIDTH).toBe(300);

__tests__/offline-loader-config.test.js

@@ -9,4 +9,18 @@ describe('offline loader editorConfig', () => {
     const loaderHtml = fs.readFileSync(LOADER_PATH, 'utf8');
     expect(loaderHtml).toMatch(/featuresTips\s*:\s*false/);
   });
+
+  test('streams live editor selections to the host window', () => {
+    const loaderHtml = fs.readFileSync(LOADER_PATH, 'utf8');
+
+    expect(loaderHtml).toContain('createSelectionStream');
+    expect(loaderHtml).toContain('window.parent');
+    expect(loaderHtml).toContain('selectionStream.emitCell(cellInfo)');
+    expect(loaderHtml).toContain("asc_registerCallback('asc_onSelectionChanged'");
+    expect(loaderHtml).toContain("asc_registerCallback('asc_onSelectionNameChanged'");
+    expect(loaderHtml).toContain("asc_registerCallback('asc_onSelectionEnd'");
+    expect(loaderHtml).toContain("asc_registerCallback('asc_onCursorMove'");
+    expect(loaderHtml).toContain("asc_registerCallback('asc_onFocusObject'");
+    expect(loaderHtml).toContain('selectionStream.emitDocument(focusedElements)');
+  });
 });