ep_data_tables 0.0.7 → 0.0.9

package/static/js/client_hooks.js

@@ -1,41 +1,20 @@
-/* ep_data_tables – attribute‑based tables (line‑class + PostWrite renderer)
- * -----------------------------------------------------------------
- * Strategy
- *   • One line attribute   tbljson = JSON({tblId,row,cells:[{txt:"…"},…]})
- *   • One char‑range attr  td      = column‑index (string)
- *   • `aceLineAttribsToClasses` puts class `tbl-line` on the **line div** so
- *     we can catch it once per line in `acePostWriteDomLineHTML`.
- *   • Renderer accumulates rows that share the same tblId in a buffer on
- *     innerdocbody, flushes to a single <table> when the run ends.
- *   • No raw JSON text is ever visible to the user.
- */
-
-/* eslint-env browser */
-
-// ────────────────────────────── constants ──────────────────────────────
 const ATTR_TABLE_JSON = 'tbljson';
 const ATTR_CELL       = 'td';
-const ATTR_CLASS_PREFIX = 'tbljson-'; // For finding the class in DOM
+const ATTR_CLASS_PREFIX = 'tbljson-';
 const log             = (...m) => console.debug('[ep_data_tables:client_hooks]', ...m);
-const DELIMITER       = '\u241F';   // Internal column delimiter (␟)
-// Use the same rare character inside the hidden span so acePostWriteDomLineHTML can
-// still find delimiters when it splits node.innerHTML.
-// Users never see this because the span is contenteditable=false and styled away.
+const DELIMITER       = '\u241F';
 const HIDDEN_DELIM    = DELIMITER;
+const INPUTTYPE_REPLACEMENT_TYPES = new Set(['insertReplacementText', 'insertFromComposition']);
 
-// helper for stable random ids
 const rand = () => Math.random().toString(36).slice(2, 8);
 
-// encode/decode so JSON can survive as a CSS class token if ever needed
 const enc = s => btoa(s).replace(/\+/g, '-').replace(/\//g, '_');
 const dec = s => {
-    // Revert to simpler decode, assuming enc provides valid padding
     const str = s.replace(/-/g, '+').replace(/_/g, '/');
     try {
         if (typeof atob === 'function') {
-            return atob(str); // Browser environment
+            return atob(str); 
         } else if (typeof Buffer === 'function') {
-            // Node.js environment
             return Buffer.from(str, 'base64').toString('utf8');
         } else {
             console.error('[ep_data_tables] Base64 decoding function (atob or Buffer) not found.');
@@ -47,45 +26,48 @@ const dec = s => {
     }
 };
 
-// NEW: Module-level state for last clicked cell
-let lastClickedCellInfo = null; // { lineNum: number, cellIndex: number, tblId: string }
-
-// NEW: Module-level state for column resizing (similar to images plugin)
+let lastClickedCellInfo = null;
 let isResizing = false;
 let resizeStartX = 0;
-let resizeCurrentX = 0; // Track current mouse position
+let resizeCurrentX = 0;
 let resizeTargetTable = null;
 let resizeTargetColumn = -1;
 let resizeOriginalWidths = [];
 let resizeTableMetadata = null;
 let resizeLineNum = -1;
-let resizeOverlay = null; // Visual overlay element
-// Android Chrome composition handling state
+let resizeOverlay = null;
 let suppressNextBeforeInputInsertTextOnce = false;
 let isAndroidChromeComposition = false;
 let handledCurrentComposition = false;
-// Suppress all beforeinput insertText events during an Android Chrome IME composition
 let suppressBeforeInputInsertTextDuringComposition = false;
-// Helper to detect any Android browser (exclude iOS/Safari)
 function isAndroidUA() {
   const ua = (navigator.userAgent || '').toLowerCase();
   const isAndroid = ua.includes('android');
+  // Treat Chrome OS (Chromebooks) similarly because touch-screen Chromebooks exhibit the same
+  // duplicate beforeinput / composition quirks we patch for Android.
+  const isChromeOS = ua.includes('cros'); // "CrOS" token present in Chromebook UAs
   const isIOS = ua.includes('iphone') || ua.includes('ipad') || ua.includes('ipod') || ua.includes('crios');
-  // Safari on Android is rare (WebKit ports), but our exclusion target is iOS Safari; we exclude all iOS above
-  return isAndroid && !isIOS;
+  return (isAndroid || isChromeOS) && !isIOS;
 }
 
-// ─────────────────── Reusable Helper Functions ───────────────────
+function isIOSUA() {
+  const ua = (navigator.userAgent || '').toLowerCase();
+  return ua.includes('iphone') || ua.includes('ipad') || ua.includes('ipod') || ua.includes('ios') || ua.includes('crios') || ua.includes('fxios') || ua.includes('edgios');
+}
+
+// Normalise soft whitespace (NBSP, newline, carriage return, tab) to ASCII space and collapse runs.
+const normalizeSoftWhitespace = (str) => (
+  (str || '')
+    .replace(/[\u00A0\r\n\t]/g, ' ')
+    .replace(/\s+/g, ' ')
+);
 
 /**
- * Recursively search for an element with a 'tbljson-' class inside a given element.
- * This is used to find the metadata carrier when it's nested inside block elements.
- * @param {HTMLElement} element - The root element to start searching from.
- * @returns {HTMLElement|null} - The found element or null.
+ * @param {HTMLElement} element 
+ * @returns {HTMLElement|null} 
  */
 function findTbljsonElement(element) {
   if (!element) return null;
-  // Check if this element has the tbljson class
   if (element.classList) {
     for (const cls of element.classList) {
       if (cls.startsWith(ATTR_CLASS_PREFIX)) {
@@ -93,7 +75,6 @@ function findTbljsonElement(element) {
       }
     }
   }
-  // Recursively check children
   if (element.children) {
     for (const child of element.children) {
       const found = findTbljsonElement(child);
@@ -114,7 +95,6 @@ function findTbljsonElement(element) {
 function getTableLineMetadata(lineNum, editorInfo, docManager) {
   const funcName = 'getTableLineMetadata';
   try {
-    // First, try the fast path: getting the attribute directly from the line.
     const attribs = docManager.getAttributeOnLine(lineNum, ATTR_TABLE_JSON);
     if (attribs) {
       try {
@@ -128,12 +108,9 @@ function getTableLineMetadata(lineNum, editorInfo, docManager) {
       }
     }
 
-    // Fallback for block-styled lines.
    // log(`${funcName}: No valid attribute on line ${lineNum}, checking DOM.`);
     const rep = editorInfo.ace_getRep();
-    
-    // This is the fix: Get the lineNode directly from the rep. It's more reliable
-    // than querying the DOM and avoids the ace_getOuterDoc() call which was failing.
+
     const lineEntry = rep.lines.atIndex(lineNum);
     const lineNode = lineEntry?.lineNode;
 
@@ -168,7 +145,6 @@ function getTableLineMetadata(lineNum, editorInfo, docManager) {
   }
 }
 
-// ─────────────────── Cell Navigation Helper Functions ───────────────────
 /**
  * Navigate to the next cell in the table (Tab key behavior)
  * @param {number} currentLineNum - Current line number
@@ -182,41 +158,35 @@ function getTableLineMetadata(lineNum, editorInfo, docManager) {
 function navigateToNextCell(currentLineNum, currentCellIndex, tableMetadata, shiftKey, editorInfo, docManager) {
   const funcName = 'navigateToNextCell';
  // log(`${funcName}: START - Current: Line=${currentLineNum}, Cell=${currentCellIndex}, Shift=${shiftKey}`);
-  
+
   try {
   let targetRow = tableMetadata.row;
     let targetCol = currentCellIndex;
 
     if (shiftKey) {
-      // Shift+Tab: Move to previous cell
       targetCol--;
   if (targetCol < 0) {
-        // Move to last cell of previous row
     targetRow--;
     targetCol = tableMetadata.cols - 1;
       }
     } else {
-      // Tab: Move to next cell
       targetCol++;
       if (targetCol >= tableMetadata.cols) {
-        // Move to first cell of next row
     targetRow++;
     targetCol = 0;
       }
   }
 
    // log(`${funcName}: Target coordinates - Row=${targetRow}, Col=${targetCol}`);
-    
-    // Find the line number for the target row
+
   const targetLineNum = findLineForTableRow(tableMetadata.tblId, targetRow, editorInfo, docManager);
     if (targetLineNum === -1) {
      // log(`${funcName}: Could not find line for target row ${targetRow}`);
       return false;
     }
 
-    // Navigate to the target cell
   return navigateToCell(targetLineNum, targetCol, editorInfo, docManager);
-    
+
   } catch (e) {
     console.error(`[ep_data_tables] ${funcName}: Error during navigation:`, e);
     return false;
@@ -242,37 +212,28 @@ function navigateToCellBelow(currentLineNum, currentCellIndex, tableMetadata, ed
 
    // log(`${funcName}: Target coordinates - Row=${targetRow}, Col=${targetCol}`);
 
-    // Find the line number for the target row
   const targetLineNum = findLineForTableRow(tableMetadata.tblId, targetRow, editorInfo, docManager);
 
   if (targetLineNum !== -1) {
-      // Found the row below, navigate to it.
      // log(`${funcName}: Found line for target row ${targetRow}, navigating.`);
       return navigateToCell(targetLineNum, targetCol, editorInfo, docManager);
     } else {
-      // Could not find the row below, we must be on the last line.
-      // Create a new, empty line after the table.
      // log(`${funcName}: Could not find next row. Creating new line after table.`);
   const rep = editorInfo.ace_getRep();
       const lineTextLength = rep.lines.atIndex(currentLineNum).text.length;
       const endOfLinePos = [currentLineNum, lineTextLength];
 
-      // Move caret to end of the current line...
       editorInfo.ace_performSelectionChange(endOfLinePos, endOfLinePos, false);
-      // ...and insert a newline character. This creates a new line below.
   editorInfo.ace_performDocumentReplaceRange(endOfLinePos, endOfLinePos, '\n');
 
-      // The caret is automatically moved to the new line by the operation above,
-      // but we ensure the visual selection is synced and the editor is focused.
       editorInfo.ace_updateBrowserSelectionFromRep();
   editorInfo.ace_focus();
 
-      // We've now exited the table, so clear the last-clicked state.
       const editor = editorInfo.editor;
       if (editor) editor.ep_data_tables_last_clicked = null;
      // log(`${funcName}: Cleared last click info as we have exited the table.`);
 
-      return true; // We handled it.
+      return true;
     }
   } catch (e) {
     console.error(`[ep_data_tables] ${funcName}: Error during navigation:`, e);
@@ -291,20 +252,19 @@ function navigateToCellBelow(currentLineNum, currentCellIndex, tableMetadata, ed
 function findLineForTableRow(tblId, targetRow, editorInfo, docManager) {
   const funcName = 'findLineForTableRow';
  // log(`${funcName}: Searching for tblId=${tblId}, row=${targetRow}`);
-  
+
   try {
   const rep = editorInfo.ace_getRep();
     if (!rep || !rep.lines) {
      // log(`${funcName}: Could not get rep or rep.lines`);
       return -1;
     }
-    
+
   const totalLines = rep.lines.length();
     for (let lineIndex = 0; lineIndex < totalLines; lineIndex++) {
       try {
         let lineAttrString = docManager.getAttributeOnLine(lineIndex, ATTR_TABLE_JSON);
-        
-        // If no attribute found directly, check DOM (same logic as acePostWriteDomLineHTML)
+
         if (!lineAttrString) {
           const lineEntry = rep.lines.atIndex(lineIndex);
           if (lineEntry && lineEntry.lineNode) {
@@ -319,7 +279,7 @@ function findLineForTableRow(tblId, targetRow, editorInfo, docManager) {
             }
           }
         }
-        
+
         if (lineAttrString) {
           const lineMetadata = JSON.parse(lineAttrString);
           if (lineMetadata.tblId === tblId && lineMetadata.row === targetRow) {
@@ -328,10 +288,10 @@ function findLineForTableRow(tblId, targetRow, editorInfo, docManager) {
           }
         }
       } catch (e) {
-        continue; // Skip lines with invalid metadata
+        continue;
       }
     }
-    
+
    // log(`${funcName}: Target row not found`);
     return -1;
   } catch (e) {
@@ -359,7 +319,7 @@ function navigateToCell(targetLineNum, targetCellIndex, editorInfo, docManager)
      // log(`${funcName}: Could not get rep or rep.lines`);
       return false;
     }
-    
+
     const lineEntry = rep.lines.atIndex(targetLineNum);
     if (!lineEntry) {
      // log(`${funcName}: Could not get line entry for line ${targetLineNum}`);
@@ -368,7 +328,7 @@ function navigateToCell(targetLineNum, targetCellIndex, editorInfo, docManager)
 
     const lineText = lineEntry.text || '';
     const cells = lineText.split(DELIMITER);
-    
+
     if (targetCellIndex >= cells.length) {
      // log(`${funcName}: Target cell ${targetCellIndex} doesn't exist (only ${cells.length} cells)`);
       return false;
@@ -384,10 +344,8 @@ function navigateToCell(targetLineNum, targetCellIndex, editorInfo, docManager)
     const clampedTargetCol = Math.min(targetCol, lineText.length);
     targetPos = [targetLineNum, clampedTargetCol];
 
-    // --- NEW: Update plugin state BEFORE performing the UI action ---
     try {
       const editor = editorInfo.ep_data_tables_editor;
-      // Use the new robust helper to get metadata, which handles block-styled lines.
     const tableMetadata = getTableLineMetadata(targetLineNum, editorInfo, docManager);
 
     if (editor && tableMetadata) {
@@ -404,23 +362,14 @@ function navigateToCell(targetLineNum, targetCellIndex, editorInfo, docManager)
     } catch (e) {
      // log(`${funcName}: Could not update stored click info before navigation:`, e.message);
     }
-    
-    // The previous attempts involving wrappers and poking the renderer have all
-    // proven to be unstable. The correct approach is to directly update the
-    // internal model and then tell the browser to sync its visual selection to
-    // that model.
+
     try {
-      // 1. Update the internal representation of the selection.
     editorInfo.ace_performSelectionChange(targetPos, targetPos, false);
      // log(`${funcName}: Updated internal selection to [${targetPos}]`);
 
-      // 2. Explicitly tell the editor to update the browser's visual selection
-      // to match the new internal representation. This is the correct way to
-      // make the caret appear in the new location without causing a race condition.
     editorInfo.ace_updateBrowserSelectionFromRep();
      // log(`${funcName}: Called updateBrowserSelectionFromRep to sync visual caret.`);
-      
-      // 3. Ensure the editor has focus.
+
     editorInfo.ace_focus();
      // log(`${funcName}: Editor focused.`);
 
@@ -428,9 +377,8 @@ function navigateToCell(targetLineNum, targetCellIndex, editorInfo, docManager)
       console.error(`[ep_data_tables] ${funcName}: Error during direct navigation update:`, e);
       return false;
     }
-    
+
   } catch (e) {
-    // This synchronous catch is a fallback, though the error was happening asynchronously.
     console.error(`[ep_data_tables] ${funcName}: Error during cell navigation:`, e);
     return false;
   }
@@ -439,16 +387,14 @@ function navigateToCell(targetLineNum, targetCellIndex, editorInfo, docManager)
   return true;
 }
 
-// ────────────────────── collectContentPre (DOM → atext) ─────────────────────
 exports.collectContentPre = (hook, ctx) => {
   const funcName = 'collectContentPre';
-  const node = ctx.domNode; // Etherpad's collector uses ctx.domNode
+  const node = ctx.domNode;
   const state = ctx.state;
-  const cc = ctx.cc; // ContentCollector instance
+  const cc = ctx.cc;
 
  // log(`${funcName}: *** ENTRY POINT *** Hook: ${hook}, Node: ${node?.tagName}.${node?.className}`);
 
-  // ***** START Primary Path: Reconstruct from rendered table *****
   if (node?.classList?.contains('ace-line')) {
     const tableNode = node.querySelector('table.dataTable[data-tblId]');
     if (tableNode) {
@@ -476,20 +422,13 @@ exports.collectContentPre = (hook, ctx) => {
                 let cellHTMLSegments = Array.from(trNode.children).map((td, index) => {
         let segmentHTML = td.innerHTML || '';
                  // log(`${funcName}: Line ${lineNum} TD[${index}] raw innerHTML (first 100): "${segmentHTML.substring(0,100)}"`);
-                  
+
                   const resizeHandleRegex = /<div class="ep-data_tables-resize-handle"[^>]*><\/div>/ig;
                   segmentHTML = segmentHTML.replace(resizeHandleRegex, '');
-                  // NEW: Also remove any previously injected hidden delimiter span so we do
-                  // not serialise it back into the atext. Leaving it in would duplicate the
-                  // hidden span on every save-reload cycle and, more importantly, confuse the
-                  // later HTML-to-table reconstruction because the delimiter that lives *inside*
-                  // the span would be mistaken for a real cell boundary.
                   const hiddenDelimRegexPrimary = /<span class="ep-data_tables-delim"[^>]*>.*?<\/span>/ig;
                   segmentHTML = segmentHTML.replace(hiddenDelimRegexPrimary, '');
-                  // Remove caret-anchor spans (invisible, non-semantic)
                   const caretAnchorRegex = /<span class="ep-data_tables-caret-anchor"[^>]*><\/span>/ig;
                   segmentHTML = segmentHTML.replace(caretAnchorRegex, '');
-                  // If, after stripping tags/entities, the content is empty, serialize as empty string
                   const textCheck = segmentHTML.replace(/<[^>]*>/g, '').replace(/&nbsp;/ig, ' ').trim();
                   if (textCheck === '') segmentHTML = '';
 
@@ -514,7 +453,7 @@ exports.collectContentPre = (hook, ctx) => {
                 state.lineAttributes = state.lineAttributes.filter(attr => attr[0] !== ATTR_TABLE_JSON);
       state.lineAttributes.push([ATTR_TABLE_JSON, existingAttrString]);
                // log(`${funcName}: Line ${lineNum} ensured ${ATTR_TABLE_JSON} attribute is in state.lineAttributes.`);
-                
+
                // log(`${funcName}: Line ${lineNum} reconstruction complete. Returning undefined to prevent default DOM collection.`);
                 return undefined;
               } else {
@@ -534,7 +473,7 @@ exports.collectContentPre = (hook, ctx) => {
                 const tempMetadata = {tblId: domTblId, row: parseInt(domRow, 10), cols: domCols};
                 const tempAttrString = JSON.stringify(tempMetadata);
                // log(`${funcName}: Line ${lineNum} FALLBACK: Constructed temporary metadata: ${tempAttrString}`);
-                
+
                 let cellHTMLSegments = Array.from(trNode.children).map((td, index) => {
                   let segmentHTML = td.innerHTML || '';
                   const resizeHandleRegex = /<div class="ep-data_tables-resize-handle"[^>]*><\/div>/ig;
@@ -543,15 +482,13 @@ exports.collectContentPre = (hook, ctx) => {
                     const hiddenDelimRegex = new RegExp('^<span class="ep-data_tables-delim" contenteditable="false">' + DELIMITER + '(<\\/span>)?<\\/span>', 'i');
                     segmentHTML = segmentHTML.replace(hiddenDelimRegex, '');
                   }
-                  // Remove caret-anchor spans (invisible, non-semantic)
                   const caretAnchorRegex = /<span class="ep-data_tables-caret-anchor"[^>]*><\/span>/ig;
                   segmentHTML = segmentHTML.replace(caretAnchorRegex, '');
-                  // If, after stripping tags/entities, the content is empty, serialize as empty string
                   const textCheck = segmentHTML.replace(/<[^>]*>/g, '').replace(/&nbsp;/ig, ' ').trim();
                   if (textCheck === '') segmentHTML = '';
                   return segmentHTML;
                 });
-                
+
                 if (cellHTMLSegments.length !== domCols) {
                     // log(`${funcName}: WARNING Line ${lineNum} (Fallback): Reconstructed cell count (${cellHTMLSegments.length}) does not match DOM cols (${domCols}).`);
                      while(cellHTMLSegments.length < domCols) cellHTMLSegments.push('');
@@ -582,10 +519,8 @@ exports.collectContentPre = (hook, ctx) => {
   } else {
    // log(`${funcName}: Node is not an ace-line (or node is null). Node: ${node?.tagName}.${node?.className}. Allowing normal processing.`);
   }
-  // ***** END Primary Path *****
 
 
-  // ***** Secondary Path: Apply attributes from tbljson-* class on spans (for initial creation/pasting) *****
   const classes = ctx.cls ? ctx.cls.split(' ') : [];
   let appliedAttribFromClass = false;
   if (classes.length > 0) {
@@ -617,38 +552,31 @@ exports.collectContentPre = (hook, ctx) => {
   } else {
     // log(`${funcName}: Secondary path - Node ${node?.tagName}.${node?.className} has no ctx.cls or classes array is empty.`);
   }
-  
+
  // log(`${funcName}: *** EXIT POINT *** For Node: ${node?.tagName}.${node?.className}. Applied from class: ${appliedAttribFromClass}`);
 };
 
-// ───────────── attribute → span‑class mapping (linestylefilter hook) ─────────
 exports.aceAttribsToClasses = (hook, ctx) => {
   const funcName = 'aceAttribsToClasses';
  // log(`>>>> ${funcName}: Called with key: ${ctx.key}`); // log entry
   if (ctx.key === ATTR_TABLE_JSON) {
    // log(`${funcName}: Processing ATTR_TABLE_JSON.`);
-    // ctx.value is the raw JSON string from Etherpad's attribute pool
     const rawJsonValue = ctx.value;
    // log(`${funcName}: Received raw attribute value (ctx.value):`, rawJsonValue);
 
-    // Attempt to parse for logging purposes
     let parsedMetadataForLog = '[JSON Parse Error]';
     try {
         parsedMetadataForLog = JSON.parse(rawJsonValue);
        // log(`${funcName}: Value parsed for logging:`, parsedMetadataForLog);
     } catch(e) {
        // log(`${funcName}: Error parsing raw JSON value for logging:`, e);
-        // Continue anyway, enc() might still work if it's just a string
     }
 
-    // Generate the class name by base64 encoding the raw JSON string.
-    // This ensures acePostWriteDomLineHTML receives the expected encoded format.
     const className = `tbljson-${enc(rawJsonValue)}`;
    // log(`${funcName}: Generated class name by encoding raw JSON: ${className}`);
     return [className];
   }
   if (ctx.key === ATTR_CELL) {
-    // Keep this in case we want cell-specific styling later
     //// log(`${funcName}: Processing ATTR_CELL: ${ctx.value}`); // Optional: Uncomment if needed
     return [`tblCell-${ctx.value}`];
   }
@@ -656,14 +584,8 @@ exports.aceAttribsToClasses = (hook, ctx) => {
   return [];
 };
 
-// ───────────── line‑class mapping (REMOVE - superseded by aceAttribsToClasses) ─────────
-// exports.aceLineAttribsToClasses = ... (Removed as aceAttribsToClasses adds table-line-data now)
 
-// ─────────────────── Create Initial DOM Structure ────────────────────
-// REMOVED - This hook doesn't reliably trigger on attribute changes during creation.
-// exports.aceCreateDomLine = (hookName, args, cb) => { ... };
 
-// Helper function to escape HTML (Keep this helper)
 function escapeHtml(text = '') {
   const strText = String(text);
   var map = {
@@ -671,8 +593,6 @@ function escapeHtml(text = '') {
   };
   return strText.replace(/[&<>"'']/g, function(m) { return map[m]; });
 }
-
-// NEW Helper function to build table HTML from pre-rendered delimited content with resize handles
 function buildTableFromDelimitedHTML(metadata, innerHTMLSegments) {
   const funcName = 'buildTableFromDelimitedHTML';
  // log(`${funcName}: START`, { metadata, innerHTMLSegments });
@@ -680,14 +600,12 @@ function buildTableFromDelimitedHTML(metadata, innerHTMLSegments) {
   if (!metadata || typeof metadata.tblId === 'undefined' || typeof metadata.row === 'undefined') {
     console.error(`[ep_data_tables] ${funcName}: Invalid or missing metadata. Aborting.`);
    // log(`${funcName}: END - Error`);
-    return '<table class="dataTable dataTable-error"><tbody><tr><td>Error: Missing table metadata</td></tr></tbody></table>'; // Return error table
+    return '<table class="dataTable dataTable-error"><tbody><tr><td>Error: Missing table metadata</td></tr></tbody></table>';
   }
 
-  // Get column widths from metadata, or use equal distribution if not set
   const numCols = innerHTMLSegments.length;
   const columnWidths = metadata.columnWidths || Array(numCols).fill(100 / numCols);
-  
-  // Ensure we have the right number of column widths
+
   while (columnWidths.length < numCols) {
     columnWidths.push(100 / numCols);
   }
@@ -695,20 +613,14 @@ function buildTableFromDelimitedHTML(metadata, innerHTMLSegments) {
     columnWidths.splice(numCols);
   }
 
-  // Basic styling - can be moved to CSS later
-  const tdStyle = `padding: 5px 7px; word-wrap:break-word; vertical-align: top; border: 1px solid #000; position: relative;`; // Added position: relative
+  const tdStyle = `padding: 5px 7px; word-wrap:break-word; vertical-align: top; border: 1px solid #000; position: relative;`;
 
-  // Precompute encoded tbljson class so empty cells can carry the same marker
   let encodedTbljsonClass = '';
   try {
     encodedTbljsonClass = `tbljson-${enc(JSON.stringify(metadata))}`;
   } catch (_) { encodedTbljsonClass = ''; }
 
-  // Map the HTML segments directly into TD elements with column widths
   const cellsHtml = innerHTMLSegments.map((segment, index) => {
-    // Build the hidden delimiter *inside* the first author span so the caret
-    // cannot sit between delimiter and text. For empty cells, synthesize a span
-    // that carries tbljson and tblCell-N so caret anchoring remains stable.
     const textOnly = (segment || '').replace(/<[^>]*>/g, '').replace(/&nbsp;/ig, ' ').trim();
     let modifiedSegment = segment || '';
     const isEmpty = !segment || textOnly === '';
@@ -718,14 +630,10 @@ function buildTableFromDelimitedHTML(metadata, innerHTMLSegments) {
     }
     if (index > 0) {
       const delimSpan = `<span class="ep-data_tables-delim" contenteditable="false">${HIDDEN_DELIM}</span>`;
-      // If the rendered segment already starts with a <span …> (which will be
-      // the usual author-colour wrapper) inject the delimiter right after that
-      // opening tag; otherwise just prefix it.
       modifiedSegment = modifiedSegment.replace(/^(<span[^>]*>)/i, `$1${delimSpan}`);
       if (!/^<span[^>]*>/i.test(modifiedSegment)) modifiedSegment = `${delimSpan}${modifiedSegment}`;
     }
 
-    // --- NEW: Always embed the invisible caret-anchor as *last* child *within* the first span ---
     const caretAnchorSpan = '<span class="ep-data_tables-caret-anchor" contenteditable="false"></span>';
     const anchorInjected = modifiedSegment.replace(/<\/span>\s*$/i, `${caretAnchorSpan}</span>`);
     modifiedSegment = (anchorInjected !== modifiedSegment)
@@ -734,7 +642,36 @@ function buildTableFromDelimitedHTML(metadata, innerHTMLSegments) {
           ? `<span class="${encodedTbljsonClass ? `${encodedTbljsonClass} ` : ''}tblCell-${index}">${modifiedSegment}${caretAnchorSpan}</span>`
           : `${modifiedSegment}${caretAnchorSpan}`);
 
-    // Width & other decorations remain unchanged
+    try {
+      const requiredCellClass = `tblCell-${index}`;
+      const leadingDelimMatch = modifiedSegment.match(/^\s*<span[^>]*\bep-data_tables-delim\b[^>]*>[\s\S]*?<\/span>\s*/i);
+      const head = leadingDelimMatch ? leadingDelimMatch[0] : '';
+      const tail = leadingDelimMatch ? modifiedSegment.slice(head.length) : modifiedSegment;
+
+      const openSpanMatch = tail.match(/^\s*<span([^>]*)>/i);
+      if (!openSpanMatch) {
+        const baseClasses = `${encodedTbljsonClass ? `${encodedTbljsonClass} ` : ''}${requiredCellClass}`;
+        modifiedSegment = `${head}<span class="${baseClasses}">${tail}</span>`;
+      } else {
+        const fullOpen = openSpanMatch[0];
+        const attrs = openSpanMatch[1] || '';
+        const classMatch = /\bclass\s*=\s*"([^"]*)"/i.exec(attrs);
+        let classList = classMatch ? classMatch[1].split(/\s+/).filter(Boolean) : [];
+        classList = classList.filter(c => !/^tblCell-\d+$/.test(c));
+        classList.push(requiredCellClass);
+        const unique = Array.from(new Set(classList));
+        const newClassAttr = ` class="${unique.join(' ')}"`;
+        const attrsWithoutClass = classMatch ? attrs.replace(/\s*class\s*=\s*"[^"]*"/i, '') : attrs;
+        const rebuiltOpen = `<span${newClassAttr}${attrsWithoutClass}>`;
+        const afterOpen = tail.slice(fullOpen.length);
+        const cleanedTail = afterOpen.replace(/(<span[^>]*class=")([^"]*)(")/ig, (m, p1, classes, p3) => {
+          const filtered = classes.split(/\s+/).filter(c => c && !/^tblCell-\d+$/.test(c)).join(' ');
+          return p1 + filtered + p3;
+        });
+        modifiedSegment = head + rebuiltOpen + cleanedTail;
+      }
+    } catch (_) { /* ignore normalization errors */ }
+
     const widthPercent = columnWidths[index] || (100 / numCols);
     const cellStyle = `${tdStyle} width: ${widthPercent}%;`;
 
@@ -747,27 +684,22 @@ function buildTableFromDelimitedHTML(metadata, innerHTMLSegments) {
   }).join('');
  // log(`${funcName}: Joined all cellsHtml:`, cellsHtml);
 
-  // Add 'dataTable-first-row' class if it's the logical first row (row index 0)
   const firstRowClass = metadata.row === 0 ? ' dataTable-first-row' : '';
  // log(`${funcName}: First row class applied: '${firstRowClass}'`);
 
-  // Construct the final table HTML
-  // Rely on CSS for border-collapse, width etc. Add data attributes from metadata.
   const tableHtml = `<table class="dataTable${firstRowClass}" writingsuggestions="false" data-tblId="${metadata.tblId}" data-row="${metadata.row}" style="width:100%; border-collapse: collapse; table-layout: fixed;" draggable="false"><tbody><tr>${cellsHtml}</tr></tbody></table>`;
  // log(`${funcName}: Generated final table HTML:`, tableHtml);
  // log(`${funcName}: END - Success`);
   return tableHtml;
 }
 
-// ───────────────── Populate Table Cells / Render (PostWrite) ──────────────────
 exports.acePostWriteDomLineHTML = function (hook_name, args, cb) {
   const funcName = 'acePostWriteDomLineHTML';
   const node = args?.node;
   const nodeId = node?.id;
-  const lineNum = args?.lineNumber; // Etherpad >= 1.9 provides lineNumber
-  const logPrefix = '[ep_data_tables:acePostWriteDomLineHTML]'; // Consistent prefix
+  const lineNum = args?.lineNumber;
+  const logPrefix = '[ep_data_tables:acePostWriteDomLineHTML]';
 
-  // *** STARTUP LOGGING ***
  // log(`${logPrefix} ----- START ----- NodeID: ${nodeId} LineNum: ${lineNum}`);
   if (!node || !nodeId) {
      // log(`${logPrefix} ERROR - Received invalid node or node without ID. Aborting.`);
@@ -775,15 +707,13 @@ exports.acePostWriteDomLineHTML = function (hook_name, args, cb) {
     return cb();
   }
 
-  // *** ENHANCED DEBUG: Log complete DOM state ***
  // log(`${logPrefix} NodeID#${nodeId}: COMPLETE DOM STRUCTURE DEBUG:`);
  // log(`${logPrefix} NodeID#${nodeId}: Node tagName: ${node.tagName}`);
  // log(`${logPrefix} NodeID#${nodeId}: Node className: ${node.className}`);
  // log(`${logPrefix} NodeID#${nodeId}: Node innerHTML length: ${node.innerHTML?.length || 0}`);
  // log(`${logPrefix} NodeID#${nodeId}: Node innerHTML (first 500 chars): "${(node.innerHTML || '').substring(0, 500)}"`);
  // log(`${logPrefix} NodeID#${nodeId}: Node children count: ${node.children?.length || 0}`);
-  
-  // log all child elements and their classes
+
   if (node.children) {
     for (let i = 0; i < Math.min(node.children.length, 10); i++) {
       const child = node.children[i];
@@ -797,15 +727,12 @@ exports.acePostWriteDomLineHTML = function (hook_name, args, cb) {
   let rowMetadata = null;
   let encodedJsonString = null;
 
-  // --- 1. Find and Parse Metadata Attribute --- 
  // log(`${logPrefix} NodeID#${nodeId}: Searching for tbljson-* class...`);
-  
-  // ENHANCED Helper function to recursively search for tbljson class in all descendants
+
   function findTbljsonClass(element, depth = 0, path = '') {
     const indent = '  '.repeat(depth);
    // log(`${logPrefix} NodeID#${nodeId}: ${indent}Searching element: ${element.tagName || 'unknown'}, path: ${path}`);
-    
-    // Check the element itself
+
     if (element.classList) {
      // log(`${logPrefix} NodeID#${nodeId}: ${indent}Element has ${element.classList.length} classes: [${Array.from(element.classList).join(', ')}]`);
       for (const cls of element.classList) {
@@ -817,8 +744,7 @@ exports.acePostWriteDomLineHTML = function (hook_name, args, cb) {
     } else {
      // log(`${logPrefix} NodeID#${nodeId}: ${indent}Element has no classList`);
     }
-    
-    // Recursively check all descendants
+
     if (element.children) {
      // log(`${logPrefix} NodeID#${nodeId}: ${indent}Element has ${element.children.length} children`);
       for (let i = 0; i < element.children.length; i++) {
@@ -833,54 +759,45 @@ exports.acePostWriteDomLineHTML = function (hook_name, args, cb) {
     } else {
      // log(`${logPrefix} NodeID#${nodeId}: ${indent}Element has no children`);
     }
-    
+
    // log(`${logPrefix} NodeID#${nodeId}: ${indent}No tbljson class found in this element or its children`);
     return null;
   }
 
-  // Search for tbljson class starting from the node
  // log(`${logPrefix} NodeID#${nodeId}: Starting recursive search for tbljson class...`);
   encodedJsonString = findTbljsonClass(node, 0, 'ROOT');
-  
+
   if (encodedJsonString) {
    // log(`${logPrefix} NodeID#${nodeId}: *** SUCCESS: Found encoded tbljson class: ${encodedJsonString} ***`);
   } else {
    // log(`${logPrefix} NodeID#${nodeId}: *** NO TBLJSON CLASS FOUND ***`);
   } 
 
-  // If no attribute found, it's not a table line managed by us
   if (!encodedJsonString) {
      // log(`${logPrefix} NodeID#${nodeId}: No tbljson-* class found. Assuming not a table line. END.`);
-      
-      // DEBUG: Add detailed logging to understand why tbljson class is missing
+
      // log(`${logPrefix} NodeID#${nodeId}: DEBUG - Node tag: ${node.tagName}, Node classes:`, Array.from(node.classList || []));
      // log(`${logPrefix} NodeID#${nodeId}: DEBUG - Node innerHTML (first 200 chars): "${(node.innerHTML || '').substring(0, 200)}"`);
-      
-      // Check if there are any child elements with classes
+
       if (node.children && node.children.length > 0) {
         for (let i = 0; i < Math.min(node.children.length, 5); i++) {
           const child = node.children[i];
          // log(`${logPrefix} NodeID#${nodeId}: DEBUG - Child ${i} tag: ${child.tagName}, classes:`, Array.from(child.classList || []));
         }
       }
-      
-      // Check if there's already a table in this node (orphaned table)
+
       const existingTable = node.querySelector('table.dataTable[data-tblId]');
       if (existingTable) {
         const existingTblId = existingTable.getAttribute('data-tblId');
         const existingRow = existingTable.getAttribute('data-row');
        // log(`${logPrefix} NodeID#${nodeId}: DEBUG - Found orphaned table! TblId: ${existingTblId}, Row: ${existingRow}`);
-        
-        // This suggests the table exists but the tbljson class was lost
-        // Check if we're in a post-resize situation
+
         if (existingTblId && existingRow !== null) {
          // log(`${logPrefix} NodeID#${nodeId}: POTENTIAL ISSUE - Table exists but no tbljson class. This may be a post-resize issue.`);
-          
-          // Try to look up what the metadata should be based on the table attributes
+
           const tableCells = existingTable.querySelectorAll('td');
          // log(`${logPrefix} NodeID#${nodeId}: Table has ${tableCells.length} cells`);
-          
-          // log the current line's attribute state if we can get line number
+
           if (lineNum !== undefined && args?.documentAttributeManager) {
             try {
               const currentLineAttr = args.documentAttributeManager.getAttributeOnLine(lineNum, ATTR_TABLE_JSON);
@@ -891,22 +808,14 @@ exports.acePostWriteDomLineHTML = function (hook_name, args, cb) {
           }
         }
       }
-      
+
       return cb(); 
   }
 
-  // *** NEW CHECK: If table already rendered, skip regeneration ***
   const existingTable = node.querySelector('table.dataTable[data-tblId]');
   if (existingTable) {
      // log(`${logPrefix} NodeID#${nodeId}: Table already exists in DOM. Skipping innerHTML replacement.`);
-      // Optionally, verify tblId matches metadata? For now, assume it's correct.
-      // const existingTblId = existingTable.getAttribute('data-tblId');
-      // try {
-      //    const decoded = dec(encodedJsonString); 
-      //    const currentMetadata = JSON.parse(decoded);
-      //    if (existingTblId === currentMetadata?.tblId) { ... } 
-      // } catch(e) { /* ignore validation error */ }
-      return cb(); // Do nothing further
+      return cb();
   }
 
  // log(`${logPrefix} NodeID#${nodeId}: Decoding and parsing metadata...`);
@@ -917,7 +826,6 @@ exports.acePostWriteDomLineHTML = function (hook_name, args, cb) {
     rowMetadata = JSON.parse(decoded);
      // log(`${logPrefix} NodeID#${nodeId}: Parsed rowMetadata:`, rowMetadata);
 
-      // Validate essential metadata
       if (!rowMetadata || typeof rowMetadata.tblId === 'undefined' || typeof rowMetadata.row === 'undefined' || typeof rowMetadata.cols !== 'number') {
           throw new Error('Invalid or incomplete metadata (missing tblId, row, or cols).');
       }
@@ -926,32 +834,20 @@ exports.acePostWriteDomLineHTML = function (hook_name, args, cb) {
   } catch(e) { 
      // log(`${logPrefix} NodeID#${nodeId}: FATAL ERROR - Failed to decode/parse/validate tbljson metadata. Rendering cannot proceed.`, e);
       console.error(`[ep_data_tables] ${funcName} NodeID#${nodeId}: Failed to decode/parse/validate tbljson.`, encodedJsonString, e);
-      // Optionally render an error state in the node?
       node.innerHTML = '<div style="color:red; border: 1px solid red; padding: 5px;">[ep_data_tables] Error: Invalid table metadata attribute found.</div>';
      // log(`${logPrefix} NodeID#${nodeId}: Rendered error message in node. END.`);
     return cb();
   }
-  // --- End Metadata Parsing ---
-
-  // --- 2. Get and Parse Line Content ---
-  // ALWAYS get the innerHTML of the line div itself to preserve all styling spans and attributes.
-  // This innerHTML is set by Etherpad based on the line's current text in atext and includes
-  // all the span elements with author colors, bold, italic, and other styling.
-  // For an imported line's first render, atext is "Cell1|Cell2", so node.innerHTML will be "Cell1|Cell2".
-  // For a natively created line, node.innerHTML is also "Cell1|Cell2".
-  // After an edit, aceKeyEvent updates atext, and node.innerHTML reflects that new "EditedCell1|Cell2" string.
-  // When styling is applied, it will include spans like: <span class="author-xxx bold">Cell1</span>|<span class="author-yyy italic">Cell2</span>
+
   const delimitedTextFromLine = node.innerHTML;
  // log(`${logPrefix} NodeID#${nodeId}: Using node.innerHTML for delimited text to preserve styling.`);
  // log(`${logPrefix} NodeID#${nodeId}: Raw innerHTML length: ${delimitedTextFromLine?.length || 0}`);
  // log(`${logPrefix} NodeID#${nodeId}: Raw innerHTML (first 1000 chars): "${(delimitedTextFromLine || '').substring(0, 1000)}"`);
-  
-  // *** ENHANCED DEBUG: Analyze delimiter presence ***
+
   const delimiterCount = (delimitedTextFromLine || '').split(DELIMITER).length - 1;
  // log(`${logPrefix} NodeID#${nodeId}: Delimiter '${DELIMITER}' count in innerHTML: ${delimiterCount}`);
  // log(`${logPrefix} NodeID#${nodeId}: Expected delimiters for ${rowMetadata.cols} columns: ${rowMetadata.cols - 1}`);
 
-  // log all delimiter positions
   let pos = -1;
   const delimiterPositions = [];
   while ((pos = delimitedTextFromLine.indexOf(DELIMITER, pos + 1)) !== -1) {
@@ -959,18 +855,18 @@ exports.acePostWriteDomLineHTML = function (hook_name, args, cb) {
    // log(`${logPrefix} NodeID#${nodeId}: Delimiter found at position ${pos}, context: "${delimitedTextFromLine.substring(Math.max(0, pos - 20), pos + 21)}"`);
   }
  // log(`${logPrefix} NodeID#${nodeId}: All delimiter positions: [${delimiterPositions.join(', ')}]`);
-  
-  // The DELIMITER const is defined at the top of this file.
-  // NEW: Remove all hidden-delimiter <span> wrappers **before** we split so
-  // the embedded delimiter character they carry doesn't inflate or shrink
-  // the segment count.
-  const spanDelimRegex = new RegExp('<span class="ep-data_tables-delim"[^>]*>' + DELIMITER + '<\\/span>', 'ig');
+
+  const spanDelimRegex = /<span class="ep-data_tables-delim"[^>]*>[\s\S]*?<\/span>/ig;
   const sanitizedHTMLForSplit = (delimitedTextFromLine || '')
-    .replace(spanDelimRegex, '')
-    // strip caret anchors from raw line html before split
-    .replace(/<span class="ep-data_tables-caret-anchor"[^>]*><\/span>/ig, '');
+    .replace(spanDelimRegex, DELIMITER)
+    .replace(/<span class="ep-data_tables-caret-anchor"[^>]*><\/span>/ig, '')
+    .replace(/\r?\n/g, ' ')
+    .replace(/<br\s*\/?>/gi, ' ')
+    .replace(/\u00A0/gu, ' ')
+    .replace(/[\u200B\u200C\u200D\uFEFF]/g, '')
+    .replace(/\s+/g, ' ');
   const htmlSegments = sanitizedHTMLForSplit.split(DELIMITER);
-  
+
  // log(`${logPrefix} NodeID#${nodeId}: *** SEGMENT ANALYSIS ***`);
  // log(`${logPrefix} NodeID#${nodeId}: Split resulted in ${htmlSegments.length} segments`);
   for (let i = 0; i < htmlSegments.length; i++) {
@@ -983,70 +879,35 @@ exports.acePostWriteDomLineHTML = function (hook_name, args, cb) {
     if (segment.length > 400) {
      // log(`${logPrefix} NodeID#${nodeId}: Segment[${i}] content (chars 400-600): "${segment.substring(400, 600)}"`);
     }
-    // Check if segment contains image-related content
     if (segment.includes('image:') || segment.includes('image-placeholder') || segment.includes('currently-selected')) {
      // log(`${logPrefix} NodeID#${nodeId}: *** SEGMENT[${i}] CONTAINS IMAGE CONTENT ***`);
     }
+    try {
+      const tblCellMatches = segment.match(/\btblCell-(\d+)\b/g) || [];
+      const tbljsonMatches = segment.match(/\btbljson-[A-Za-z0-9_-]+\b/g) || [];
+      const uniqueCells = Array.from(new Set(tblCellMatches));
+      if (uniqueCells.length > 1) {
+        console.warn('[ep_data_tables][diag] segment contains multiple tblCell-* markers', { segIndex: i, uniqueCells });
+      }
+    } catch (_) {}
   }
 
  // log(`${logPrefix} NodeID#${nodeId}: Parsed HTML segments (${htmlSegments.length}):`, htmlSegments.map(s => (s || '').substring(0,50) + (s && s.length > 50 ? '...' : '')));
 
-  // --- Enhanced Validation with Automatic Structure Reconstruction --- 
   let finalHtmlSegments = htmlSegments;
-  
+
   if (htmlSegments.length !== rowMetadata.cols) {
      // log(`${logPrefix} NodeID#${nodeId}: *** MISMATCH DETECTED *** - Attempting reconstruction.`);
-      
-      // Check if this is an image selection issue
+     console.warn('[ep_data_tables][diag] Segment/column mismatch', { nodeId, lineNum, segs: htmlSegments.length, cols: rowMetadata.cols, tblId: rowMetadata.tblId, row: rowMetadata.row });
+
       const hasImageSelected = delimitedTextFromLine.includes('currently-selected');
       const hasImageContent = delimitedTextFromLine.includes('image:');
       if (hasImageSelected) {
        // log(`${logPrefix} NodeID#${nodeId}: *** POTENTIAL CAUSE: Image selection state may be affecting segment parsing ***`);
       }
 
-      // First attempt: reconstruct using DOM spans that carry tblCell-N classes
       let usedClassReconstruction = false;
-      try {
-        const cols = Math.max(0, Number(rowMetadata.cols) || 0);
-        const grouped = Array.from({ length: cols }, () => '');
-        const candidates = Array.from(node.querySelectorAll('[class*="tblCell-"]'));
-
-        const classNum = (el) => {
-          if (!el || !el.classList) return -1;
-          for (const cls of el.classList) {
-            const m = /^tblCell-(\d+)$/.exec(cls);
-            if (m) return parseInt(m[1], 10);
-          }
-          return -1;
-        };
-        const hasAncestorWithSameCell = (el, n) => {
-          let p = el?.parentElement;
-          while (p) {
-            if (p.classList && p.classList.contains(`tblCell-${n}`)) return true;
-            p = p.parentElement;
-          }
-          return false;
-        };
-
-        for (const el of candidates) {
-          const n = classNum(el);
-          if (n >= 0 && n < cols) {
-            if (!hasAncestorWithSameCell(el, n)) {
-              grouped[n] += el.outerHTML || '';
-            }
-          }
-        }
-        const usable = grouped.some(s => s && s.trim() !== '');
-        if (usable) {
-          finalHtmlSegments = grouped.map(s => (s && s.trim() !== '') ? s : '&nbsp;');
-          usedClassReconstruction = true;
-          console.warn(`[ep_data_tables] ${funcName} NodeID#${nodeId}: Reconstructed ${finalHtmlSegments.length} segments from tblCell-N classes.`);
-        }
-      } catch (e) {
-        console.debug(`[ep_data_tables] ${funcName} NodeID#${nodeId}: Class-based reconstruction error; falling back.`, e);
-      }
 
-      // Fallback: reconstruct from string segments
       if (!usedClassReconstruction) {
         const reconstructedSegments = [];
         if (htmlSegments.length === 1 && rowMetadata.cols > 1) {
@@ -1068,7 +929,6 @@ exports.acePostWriteDomLineHTML = function (hook_name, args, cb) {
         finalHtmlSegments = reconstructedSegments;
       }
 
-      // Only warn if we still don't have the right number of segments
       if (finalHtmlSegments.length !== rowMetadata.cols) {
         console.warn(`[ep_data_tables] ${funcName} NodeID#${nodeId}: Could not reconstruct to expected ${rowMetadata.cols} segments. Got ${finalHtmlSegments.length}.`);
       }
@@ -1076,22 +936,17 @@ exports.acePostWriteDomLineHTML = function (hook_name, args, cb) {
      // log(`${logPrefix} NodeID#${nodeId}: Segment count matches metadata cols (${rowMetadata.cols}). Using original segments.`);
   }
 
-  // --- 3. Build and Render Table ---
  // log(`${logPrefix} NodeID#${nodeId}: Calling buildTableFromDelimitedHTML...`);
   try {
     const newTableHTML = buildTableFromDelimitedHTML(rowMetadata, finalHtmlSegments);
      // log(`${logPrefix} NodeID#${nodeId}: Received new table HTML from helper. Replacing content.`);
-      
-      // The old local findTbljsonElement is removed from here. We use the global one now.
+
       const tbljsonElement = findTbljsonElement(node);
-      
-      // If we found a tbljson element and it's nested in a block element, 
-      // we need to preserve the block wrapper while replacing the content
+
       if (tbljsonElement && tbljsonElement.parentElement && tbljsonElement.parentElement !== node) {
-        // Check if the parent is a block-level element that should be preserved
         const parentTag = tbljsonElement.parentElement.tagName.toLowerCase();
     const blockElements = ['center', 'div', 'p', 'h1', 'h2', 'h3', 'h4', 'h5', 'h6', 'blockquote', 'pre', 'right', 'left', 'ul', 'ol', 'li', 'code'];
-    
+
         if (blockElements.includes(parentTag)) {
          // log(`${logPrefix} NodeID#${nodeId}: Preserving block element ${parentTag} and replacing its content with table.`);
           tbljsonElement.parentElement.innerHTML = newTableHTML;
@@ -1100,11 +955,10 @@ exports.acePostWriteDomLineHTML = function (hook_name, args, cb) {
       node.innerHTML = newTableHTML;
     }
       } else {
-      // Replace the node's content entirely with the generated table
        // log(`${logPrefix} NodeID#${nodeId}: No nested block element found, replacing entire node content.`);
       node.innerHTML = newTableHTML;
       }
-      
+
      // log(`${logPrefix} NodeID#${nodeId}: Successfully replaced content with new table structure.`);
   } catch (renderError) {
      // log(`${logPrefix} NodeID#${nodeId}: ERROR during table building or rendering.`, renderError);
@@ -1113,19 +967,13 @@ exports.acePostWriteDomLineHTML = function (hook_name, args, cb) {
      // log(`${logPrefix} NodeID#${nodeId}: Rendered build/render error message in node. END.`);
       return cb();
   }
-  // --- End Table Building ---
 
-  // *** REMOVED CACHING LOGIC ***
-  // The old logic based on tableRowNodes cache is completely removed.
 
  // log(`${logPrefix}: ----- END ----- NodeID: ${nodeId}`);
   return cb();
 };
 
-// NEW: Helper function to get line number (adapted from ep_image_insert)
-// Ensure this is defined before it's used in postAceInit
 function _getLineNumberOfElement(element) {
-    // Implementation similar to ep_image_insert
     let currentElement = element;
     let count = 0;
     while (currentElement = currentElement.previousElementSibling) {
@@ -1133,8 +981,6 @@ function _getLineNumberOfElement(element) {
     }
     return count;
 }
-
-// ───────────────────── Handle Key Events ─────────────────────
 exports.aceKeyEvent = (h, ctx) => {
   const funcName = 'aceKeyEvent';
   const evt = ctx.evt;
@@ -1151,21 +997,17 @@ exports.aceKeyEvent = (h, ctx) => {
     return false;
   }
 
-  // Get caret info from event context - may be stale
   const reportedLineNum = rep.selStart[0];
   const reportedCol = rep.selStart[1]; 
  // log(`${logPrefix} Reported caret from rep: Line=${reportedLineNum}, Col=${reportedCol}`);
 
-  // --- Get Table Metadata for the reported line --- 
   let tableMetadata = null;
-  let lineAttrString = null; // Store for potential use later
+  let lineAttrString = null;
   try {
-    // Add debugging to see what's happening with attribute retrieval
    // log(`${logPrefix} DEBUG: Attempting to get ${ATTR_TABLE_JSON} attribute from line ${reportedLineNum}`);
     lineAttrString = docManager.getAttributeOnLine(reportedLineNum, ATTR_TABLE_JSON);
    // log(`${logPrefix} DEBUG: getAttributeOnLine returned: ${lineAttrString ? `"${lineAttrString}"` : 'null/undefined'}`);
-    
-    // Also check if there are any attributes on this line at all
+
     if (typeof docManager.getAttributesOnLine === 'function') {
       try {
         const allAttribs = docManager.getAttributesOnLine(reportedLineNum);
@@ -1174,8 +1016,7 @@ exports.aceKeyEvent = (h, ctx) => {
        // log(`${logPrefix} DEBUG: Error getting all attributes:`, e);
       }
     }
-    
-    // NEW: Check if there's a table in the DOM even though attribute is missing
+
     if (!lineAttrString) {
       try {
         const rep = editorInfo.ace_getRep();
@@ -1186,7 +1027,6 @@ exports.aceKeyEvent = (h, ctx) => {
             const domTblId = tableInDOM.getAttribute('data-tblId');
             const domRow = tableInDOM.getAttribute('data-row');
            // log(`${logPrefix} DEBUG: Found table in DOM without attribute! TblId=${domTblId}, Row=${domRow}`);
-            // Try to reconstruct the metadata from DOM
             const domCells = tableInDOM.querySelectorAll('td');
             if (domTblId && domRow !== null && domCells.length > 0) {
              // log(`${logPrefix} DEBUG: Attempting to reconstruct metadata from DOM...`);
@@ -1204,28 +1044,25 @@ exports.aceKeyEvent = (h, ctx) => {
        // log(`${logPrefix} DEBUG: Error checking DOM for table:`, e);
       }
     }
-    
+
     if (lineAttrString) {
         tableMetadata = JSON.parse(lineAttrString);
         if (!tableMetadata || typeof tableMetadata.cols !== 'number') {
             // log(`${logPrefix} Line ${reportedLineNum} has attribute, but metadata invalid/missing cols.`);
-             tableMetadata = null; // Ensure it's null if invalid
+             tableMetadata = null;
         }
     } else {
        // log(`${logPrefix} DEBUG: No ${ATTR_TABLE_JSON} attribute found on line ${reportedLineNum}`);
-        // Not a table line based on reported caret line
     }
   } catch(e) {
     console.error(`${logPrefix} Error checking/parsing line attribute for line ${reportedLineNum}.`, e);
-    tableMetadata = null; // Ensure it's null on error
+    tableMetadata = null;
   }
 
-  // Get last known good state
-  const editor = editorInfo.editor; // Get editor instance
-  const lastClick = editor?.ep_data_tables_last_clicked; // Read shared state
+  const editor = editorInfo.editor;
+  const lastClick = editor?.ep_data_tables_last_clicked;
  // log(`${logPrefix} Reading stored click/caret info:`, lastClick);
 
-  // --- Determine the TRUE target line, cell, and caret position --- 
   let currentLineNum = -1;
   let targetCellIndex = -1;
   let relativeCaretPos = -1;
@@ -1234,9 +1071,8 @@ exports.aceKeyEvent = (h, ctx) => {
   let lineText = '';
   let cellTexts = [];
   let metadataForTargetLine = null;
-  let trustedLastClick = false; // Flag to indicate if we are using stored info
+  let trustedLastClick = false;
 
-  // ** Scenario 1: Try to trust lastClick info **
   if (lastClick) {
      // log(`${logPrefix} Attempting to validate stored click info for Line=${lastClick.lineNum}...`);
       let storedLineAttrString = null;
@@ -1245,21 +1081,20 @@ exports.aceKeyEvent = (h, ctx) => {
          // log(`${logPrefix} DEBUG: Getting ${ATTR_TABLE_JSON} attribute from stored line ${lastClick.lineNum}`);
           storedLineAttrString = docManager.getAttributeOnLine(lastClick.lineNum, ATTR_TABLE_JSON);
          // log(`${logPrefix} DEBUG: Stored line attribute result: ${storedLineAttrString ? `"${storedLineAttrString}"` : 'null/undefined'}`);
-          
+
           if (storedLineAttrString) {
             storedLineMetadata = JSON.parse(storedLineAttrString);
            // log(`${logPrefix} DEBUG: Parsed stored metadata:`, storedLineMetadata);
           }
-          
-          // Check if metadata is valid and tblId matches
+
           if (storedLineMetadata && typeof storedLineMetadata.cols === 'number' && storedLineMetadata.tblId === lastClick.tblId) {
              // log(`${logPrefix} Stored click info VALIDATED (Metadata OK and tblId matches). Trusting stored state.`);
               trustedLastClick = true;
               currentLineNum = lastClick.lineNum; 
               targetCellIndex = lastClick.cellIndex;
               metadataForTargetLine = storedLineMetadata; 
-              lineAttrString = storedLineAttrString; // Use the validated attr string
-              
+              lineAttrString = storedLineAttrString;
+
               lineText = rep.lines.atIndex(currentLineNum)?.text || '';
               cellTexts = lineText.split(DELIMITER);
              // log(`${logPrefix} Using Line=${currentLineNum}, CellIndex=${targetCellIndex}. Text: "${lineText}"`);
@@ -1280,7 +1115,7 @@ exports.aceKeyEvent = (h, ctx) => {
                   relativeCaretPos = Math.max(0, Math.min(lastClick.relativePos, currentCellTextLength));
                  // log(`${logPrefix} Using and validated stored relative position: ${relativeCaretPos}.`);
   } else {
-                  relativeCaretPos = reportedCol - cellStartCol; // Use reportedCol for initial calc if relative is missing
+                  relativeCaretPos = reportedCol - cellStartCol;
                   const currentCellTextLength = cellTexts[targetCellIndex]?.length ?? 0;
                   relativeCaretPos = Math.max(0, Math.min(relativeCaretPos, currentCellTextLength)); 
                  // log(`${logPrefix} Stored relativePos missing, calculated from reportedCol (${reportedCol}): ${relativeCaretPos}`);
@@ -1291,20 +1126,17 @@ exports.aceKeyEvent = (h, ctx) => {
           }
       } catch (e) {
            console.error(`${logPrefix} Error validating stored click info for line ${lastClick.lineNum}.`, e);
-           if (editor) editor.ep_data_tables_last_clicked = null; // Clear on error
+           if (editor) editor.ep_data_tables_last_clicked = null;
       }
   }
-  
-  // ** Scenario 2: Fallback - Use reported line/col ONLY if stored info wasn't trusted **
+
   if (!trustedLastClick) {
      // log(`${logPrefix} Fallback: Using reported caret position Line=${reportedLineNum}, Col=${reportedCol}.`);
-      // Fetch metadata for the reported line again, in case it wasn't fetched or was invalid earlier
       try {
           lineAttrString = docManager.getAttributeOnLine(reportedLineNum, ATTR_TABLE_JSON);
           if (lineAttrString) tableMetadata = JSON.parse(lineAttrString);
           if (!tableMetadata || typeof tableMetadata.cols !== 'number') tableMetadata = null;
-          
-          // If no attribute found directly, check if there's a table in the DOM even though attribute is missing (block styles)
+
           if (!lineAttrString) {
             try {
               const rep = editorInfo.ace_getRep();
@@ -1315,7 +1147,6 @@ exports.aceKeyEvent = (h, ctx) => {
                   const domTblId = tableInDOM.getAttribute('data-tblId');
                   const domRow = tableInDOM.getAttribute('data-row');
                  // log(`${logPrefix} Fallback: Found table in DOM without attribute! TblId=${domTblId}, Row=${domRow}`);
-                  // Try to reconstruct the metadata from DOM
                   const domCells = tableInDOM.querySelectorAll('td');
                   if (domTblId && domRow !== null && domCells.length > 0) {
                    // log(`${logPrefix} Fallback: Attempting to reconstruct metadata from DOM...`);
@@ -1334,17 +1165,17 @@ exports.aceKeyEvent = (h, ctx) => {
              // log(`${logPrefix} Fallback: Error checking DOM for table:`, e);
             }
           }
-      } catch(e) { tableMetadata = null; } // Ignore errors here, handled below
+      } catch(e) { tableMetadata = null; }
 
       if (!tableMetadata) {
          // log(`${logPrefix} Fallback: Reported line ${reportedLineNum} is not a valid table line. Allowing default.`);
            return false;
       }
-      
+
       currentLineNum = reportedLineNum;
       metadataForTargetLine = tableMetadata;
      // log(`${logPrefix} Fallback: Processing based on reported line ${currentLineNum}.`);
-      
+
       lineText = rep.lines.atIndex(currentLineNum)?.text || '';
       cellTexts = lineText.split(DELIMITER);
      // log(`${logPrefix} Fallback: Fetched text for reported line ${currentLineNum}: "${lineText}"`);
@@ -1353,7 +1184,6 @@ exports.aceKeyEvent = (h, ctx) => {
          // log(`${logPrefix} WARNING (Fallback): Cell count mismatch for reported line ${currentLineNum}.`);
       }
 
-      // Calculate target cell based on reportedCol
       let currentOffset = 0;
       let foundIndex = -1;
       for (let i = 0; i < cellTexts.length; i++) {
@@ -1394,7 +1224,6 @@ exports.aceKeyEvent = (h, ctx) => {
       targetCellIndex = foundIndex;
   }
 
-  // --- Final Validation --- 
   if (currentLineNum < 0 || targetCellIndex < 0 || !metadataForTargetLine || targetCellIndex >= metadataForTargetLine.cols) {
       // log(`${logPrefix} FAILED final validation: Line=${currentLineNum}, Cell=${targetCellIndex}, Metadata=${!!metadataForTargetLine}. Allowing default.`);
     if (editor) editor.ep_data_tables_last_clicked = null;
@@ -1402,9 +1231,7 @@ exports.aceKeyEvent = (h, ctx) => {
   }
 
  // log(`${logPrefix} --> Final Target: Line=${currentLineNum}, CellIndex=${targetCellIndex}, RelativePos=${relativeCaretPos}`);
-  // --- End Cell/Position Determination ---
 
-  // --- START NEW: Handle Highlight Deletion/Replacement ---
   const selStartActual = rep.selStart;
   const selEndActual = rep.selEnd;
   const hasSelection = selStartActual[0] !== selEndActual[0] || selStartActual[1] !== selEndActual[1];
@@ -1419,11 +1246,10 @@ exports.aceKeyEvent = (h, ctx) => {
       return true; 
     }
 
-    let selectionStartColInLine = selStartActual[1];      // may be clamped
-    let selectionEndColInLine = selEndActual[1];          // may be clamped
+    let selectionStartColInLine = selStartActual[1];
+    let selectionEndColInLine = selEndActual[1];
 
     const currentCellFullText = cellTexts[targetCellIndex] || '';
-    // cellStartCol is already defined and calculated based on trustedLastClick or fallback
     const cellContentStartColInLine = cellStartCol;
     const cellContentEndColInLine = cellStartCol + currentCellFullText.length;
 
@@ -1432,11 +1258,11 @@ exports.aceKeyEvent = (h, ctx) => {
     const hasTrailingDelim =
       targetCellIndex < metadataForTargetLine.cols - 1 &&
       selectionEndColInLine === cellContentEndColInLine + DELIMITER.length;
-    
+
     const hasLeadingDelim =
       targetCellIndex > 0 &&
       selectionStartColInLine === cellContentStartColInLine - DELIMITER.length;
-    
+
     console.log(`[ep_data_tables:highlight-deletion] Selection analysis:`, {
       targetCellIndex,
       totalCols: metadataForTargetLine.cols,
@@ -1451,12 +1277,12 @@ exports.aceKeyEvent = (h, ctx) => {
       hasLeadingDelim,
       cellText: currentCellFullText
     });
-    
+
     if (hasLeadingDelim) {
       console.log(`[ep_data_tables:highlight-deletion] CLAMPING selection start from ${selectionStartColInLine} to ${cellContentStartColInLine}`);
       selectionStartColInLine = cellContentStartColInLine;
     }
-    
+
     if (hasTrailingDelim) {
       console.log(`[ep_data_tables:highlight-deletion] CLAMPING selection end from ${selectionEndColInLine} to ${cellContentEndColInLine}`);
       selectionEndColInLine = cellContentEndColInLine;
@@ -1468,34 +1294,23 @@ exports.aceKeyEvent = (h, ctx) => {
       selectionStartColInLine >= cellContentStartColInLine &&
       selectionEndColInLine <= cellContentEndColInLine;
 
-    // Allow selection even if it starts at the very first char, but be ready to restore
 
     if (isSelectionEntirelyWithinCell) {
-      // Pure selection (no key pressed yet) – allow browser shortcuts such as
-      // Ctrl-C / Ctrl-X / Cmd-C / Cmd-X to work.  We only take control for
-      // real keydown events that would modify the cell (handled further below).
 
-      // 1. Non-keydown events → let them bubble (copy/cut command happens on
-      //    the subsequent "copy"/"cut" event).
       if (evt.type !== 'keydown') return false;
 
-      // 2. Keydown that involves modifiers (Ctrl/Cmd/Alt) → we are not going
-      //    to change the cell text, so let the browser handle it.
       if (evt.ctrlKey || evt.metaKey || evt.altKey) return false;
 
-      // 3. For destructive or printable keys we fall through so the specialised
-      //    highlight-deletion logic that follows can run.
     }
 
     const isCurrentKeyDelete = evt.key === 'Delete' || evt.keyCode === 46;
     const isCurrentKeyBackspace = evt.key === 'Backspace' || evt.keyCode === 8;
-    // Check if it's a printable character, not a modifier
     const isCurrentKeyTyping = evt.key && evt.key.length === 1 && !evt.ctrlKey && !evt.metaKey && !evt.altKey;
 
 
     if (isSelectionEntirelyWithinCell && (isCurrentKeyDelete || isCurrentKeyBackspace || isCurrentKeyTyping)) {
      // log(`${logPrefix} [selection] Handling key='${evt.key}' (Type: ${evt.type}) for valid intra-cell selection.`);
-      
+
       if (evt.type !== 'keydown') {
        // log(`${logPrefix} [selection] Ignoring non-keydown event type ('${evt.type}') for selection handling. Allowing default.`);
         return false; 
@@ -1506,16 +1321,15 @@ exports.aceKeyEvent = (h, ctx) => {
       const rangeEnd = [currentLineNum, selectionEndColInLine];
       let replacementText = '';
       let newAbsoluteCaretCol = selectionStartColInLine;
-      const repBeforeEdit = editorInfo.ace_getRep(); // Get rep before edit for attribute helper
+      const repBeforeEdit = editorInfo.ace_getRep();
      // log(`${logPrefix} [caretTrace] [selection] rep.selStart before ace_performDocumentReplaceRange: Line=${repBeforeEdit.selStart[0]}, Col=${repBeforeEdit.selStart[1]}`);
 
       if (isCurrentKeyTyping) {
         replacementText = evt.key;
         newAbsoluteCaretCol = selectionStartColInLine + replacementText.length;
        // log(`${logPrefix} [selection] -> Replacing selected range [[${rangeStart[0]},${rangeStart[1]}],[${rangeEnd[0]},${rangeEnd[1]}]] with text '${replacementText}'`);
-      } else { // Delete or Backspace
+      } else {
        // log(`${logPrefix} [selection] -> Deleting selected range [[${rangeStart[0]},${rangeStart[1]}],[${rangeEnd[0]},${rangeEnd[1]}]]`);
-        // If whole cell is being wiped, keep a single space so cell isn't empty
         const isWholeCell = selectionStartColInLine <= cellContentStartColInLine && selectionEndColInLine >= cellContentEndColInLine;
         if (isWholeCell) {
           replacementText = ' ';
@@ -1525,11 +1339,8 @@ exports.aceKeyEvent = (h, ctx) => {
       }
 
       try {
-        // const repBeforeEdit = editorInfo.ace_getRep(); // Get rep before edit for attribute helper - MOVED UP
         editorInfo.ace_performDocumentReplaceRange(rangeStart, rangeEnd, replacementText);
 
-        // NEW: ensure the replacement text inherits the cell attribute so the
-        //       author-span (& tblCell-N) comes back immediately
         if (replacementText.length > 0) {
           const attrStart = [currentLineNum, selectionStartColInLine];
           const attrEnd   = [currentLineNum, selectionStartColInLine + replacementText.length];
@@ -1565,14 +1376,12 @@ exports.aceKeyEvent = (h, ctx) => {
         editorInfo.ace_performSelectionChange([currentLineNum, newAbsoluteCaretCol], [currentLineNum, newAbsoluteCaretCol], false);
         const repAfterSelectionChange = editorInfo.ace_getRep();
        // log(`${logPrefix} [caretTrace] [selection] rep.selStart after ace_performSelectionChange: Line=${repAfterSelectionChange.selStart[0]}, Col=${repAfterSelectionChange.selStart[1]}`);
-        
-        // Add sync hint AFTER setting selection
+
     editorInfo.ace_fastIncorp(1);
         const repAfterFastIncorp = editorInfo.ace_getRep();
        // log(`${logPrefix} [caretTrace] [selection] rep.selStart after ace_fastIncorp: Line=${repAfterFastIncorp.selStart[0]}, Col=${repAfterFastIncorp.selStart[1]}`);
        // log(`${logPrefix} [selection] -> Requested sync hint (fastIncorp 1).`);
 
-        // --- Re-assert selection --- 
        // log(`${logPrefix} [caretTrace] [selection] Attempting to re-assert selection post-fastIncorp to [${currentLineNum}, ${newAbsoluteCaretCol}]`);
         editorInfo.ace_performSelectionChange([currentLineNum, newAbsoluteCaretCol], [currentLineNum, newAbsoluteCaretCol], false);
         const repAfterReassert = editorInfo.ace_getRep();
@@ -1590,31 +1399,26 @@ exports.aceKeyEvent = (h, ctx) => {
         } else {
            // log(`${logPrefix} [selection] -> Editor instance not found, cannot update ep_data_tables_last_clicked.`);
         }
-        
+
        // log(`${logPrefix} END [selection] (Handled highlight modification) Key='${evt.key}' Type='${evt.type}'. Duration: ${Date.now() - startLogTime}ms`);
       return true;
       } catch (error) {
        // log(`${logPrefix} [selection] ERROR during highlight modification:`, error);
         console.error('[ep_data_tables] Error processing highlight modification:', error);
-        return true; // Still return true as we prevented default.
+        return true;
       }
     }
   }
-  // --- END NEW: Handle Highlight Deletion/Replacement ---
 
-  // --- Check for Ctrl+X (Cut) key combination ---
   const isCutKey = (evt.ctrlKey || evt.metaKey) && (evt.key === 'x' || evt.key === 'X' || evt.keyCode === 88);
   if (isCutKey && hasSelection) {
    // log(`${logPrefix} Ctrl+X (Cut) detected with selection. Letting cut event handler manage this.`);
-    // Let the cut event handler handle this - we don't need to preventDefault here
-    // as the cut event will handle the operation and prevent default
-    return false; // Allow the cut event to be triggered
+    return false;
   } else if (isCutKey && !hasSelection) {
    // log(`${logPrefix} Ctrl+X (Cut) detected but no selection. Allowing default.`);
-    return false; // Allow default - nothing to cut
+    return false;
   }
 
-  // --- Define Key Types ---
   const isTypingKey = evt.key && evt.key.length === 1 && !evt.ctrlKey && !evt.metaKey && !evt.altKey;
   const isDeleteKey = evt.key === 'Delete' || evt.keyCode === 46;
   const isBackspaceKey = evt.key === 'Backspace' || evt.keyCode === 8;
@@ -1623,18 +1427,9 @@ exports.aceKeyEvent = (h, ctx) => {
   const isEnterKey = evt.key === 'Enter';
  // log(`${logPrefix} Key classification: Typing=${isTypingKey}, Backspace=${isBackspaceKey}, Delete=${isDeleteKey}, Nav=${isNavigationKey}, Tab=${isTabKey}, Enter=${isEnterKey}, Cut=${isCutKey}`);
 
-  /*
-   * Prevent caret placement *after* the invisible caret-anchor.
-   * – RIGHT (→) pressed at the end of a cell jumps to the next cell.
-   * – LEFT  (←) pressed at the start of a cell jumps to the previous cell.
-   * This avoids the narrow dead-zone that lives between the anchor and the
-   * resize handle where typing previously caused content to drift into the
-   * neighbouring column.
-   */
   const currentCellTextLengthEarly = cellTexts[targetCellIndex]?.length ?? 0;
 
   if (evt.type === 'keydown' && !evt.ctrlKey && !evt.metaKey && !evt.altKey) {
-    // Right-arrow – if at the very end of a cell, move to the next cell.
     if (evt.keyCode === 39 && relativeCaretPos >= currentCellTextLengthEarly && targetCellIndex < metadataForTargetLine.cols - 1) {
      // log(`${logPrefix} ArrowRight at cell boundary – navigating to next cell to avoid anchor zone.`);
       evt.preventDefault();
@@ -1642,7 +1437,6 @@ exports.aceKeyEvent = (h, ctx) => {
       return true;
     }
 
-    // Left-arrow – if at the very start of a cell, move to the previous cell.
     if (evt.keyCode === 37 && relativeCaretPos === 0 && targetCellIndex > 0) {
      // log(`${logPrefix} ArrowLeft at cell boundary – navigating to previous cell to avoid anchor zone.`);
       evt.preventDefault();
@@ -1651,21 +1445,17 @@ exports.aceKeyEvent = (h, ctx) => {
     }
   }
 
-  // --- Handle Keys --- 
 
-  // 1. Allow non-Tab navigation keys immediately
   if (isNavigationKey && !isTabKey) {
      // log(`${logPrefix} Allowing navigation key: ${evt.key}. Clearing click state.`);
-      if (editor) editor.ep_data_tables_last_clicked = null; // Clear state on navigation
+      if (editor) editor.ep_data_tables_last_clicked = null;
       return false;
   }
 
-  // 2. Handle Tab - Navigate to next cell (only on keydown to avoid double navigation)
   if (isTabKey) { 
     // log(`${logPrefix} Tab key pressed. Event type: ${evt.type}`);
     evt.preventDefault();
-     
-     // Only process keydown events for navigation to avoid double navigation
+
      if (evt.type !== 'keydown') {
       // log(`${logPrefix} Ignoring Tab ${evt.type} event to prevent double navigation.`);
     return true;
@@ -1679,12 +1469,10 @@ exports.aceKeyEvent = (h, ctx) => {
      return true;
   }
 
-  // 3. Handle Enter - Navigate to cell below (only on keydown to avoid double navigation)
   if (isEnterKey) {
      // log(`${logPrefix} Enter key pressed. Event type: ${evt.type}`);
     evt.preventDefault();
-      
-      // Only process keydown events for navigation to avoid double navigation
+
       if (evt.type !== 'keydown') {
        // log(`${logPrefix} Ignoring Enter ${evt.type} event to prevent double navigation.`);
     return true;
@@ -1698,38 +1486,31 @@ exports.aceKeyEvent = (h, ctx) => {
       return true; 
   }
 
-  // 4. Intercept destructive keys ONLY at cell boundaries to protect delimiters
       const currentCellTextLength = cellTexts[targetCellIndex]?.length ?? 0;
-  // Backspace at the very beginning of cell > 0
       if (isBackspaceKey && relativeCaretPos === 0 && targetCellIndex > 0) {
      // log(`${logPrefix} Intercepted Backspace at start of cell ${targetCellIndex}. Preventing default.`);
     evt.preventDefault();
           return true;
       }
-  // NEW: Backspace at very beginning of first cell – would merge with previous line
       if (isBackspaceKey && relativeCaretPos === 0 && targetCellIndex === 0) {
        // log(`${logPrefix} Intercepted Backspace at start of first cell (line boundary). Preventing merge.`);
         evt.preventDefault();
         return true;
       }
-  // Delete at the very end of cell < last cell
   if (isDeleteKey && relativeCaretPos === currentCellTextLength && targetCellIndex < metadataForTargetLine.cols - 1) {
      // log(`${logPrefix} Intercepted Delete at end of cell ${targetCellIndex}. Preventing default.`);
           evt.preventDefault();
           return true;
       }
-  // NEW: Delete at very end of last cell – would merge with next line
       if (isDeleteKey && relativeCaretPos === currentCellTextLength && targetCellIndex === metadataForTargetLine.cols - 1) {
        // log(`${logPrefix} Intercepted Delete at end of last cell (line boundary). Preventing merge.`);
         evt.preventDefault();
         return true;
       }
 
-  // 5. Handle Typing/Backspace/Delete WITHIN a cell via manual modification
   const isInternalBackspace = isBackspaceKey && relativeCaretPos > 0;
   const isInternalDelete = isDeleteKey && relativeCaretPos < currentCellTextLength;
 
-  // Guard: internal Backspace at relativePos 1 (would delete delimiter) & Delete at relativePos 0
   if ((isInternalBackspace && relativeCaretPos === 1 && targetCellIndex > 0) ||
       (isInternalDelete && relativeCaretPos === 0 && targetCellIndex > 0)) {
    // log(`${logPrefix} Attempt to erase protected delimiter – operation blocked.`);
@@ -1738,7 +1519,6 @@ exports.aceKeyEvent = (h, ctx) => {
   }
 
   if (isTypingKey || isInternalBackspace || isInternalDelete) {
-    // --- PREVENT TYPING DIRECTLY AFTER DELIMITER (relativeCaretPos===0) ---
     if (isTypingKey && relativeCaretPos === 0 && targetCellIndex > 0) {
      // log(`${logPrefix} Caret at forbidden position 0 (just after delimiter). Auto-advancing to position 1.`);
       const safePosAbs = cellStartCol + 1;
@@ -1747,12 +1527,10 @@ exports.aceKeyEvent = (h, ctx) => {
       relativeCaretPos = 1;
      // log(`${logPrefix} Caret moved to safe position. New relativeCaretPos=${relativeCaretPos}`);
     }
-    // *** Use the validated currentLineNum and currentCol derived from relativeCaretPos ***
     const currentCol = cellStartCol + relativeCaretPos;
    // log(`${logPrefix} Handling INTERNAL key='${evt.key}' Type='${evt.type}' at Line=${currentLineNum}, Col=${currentCol} (CellIndex=${targetCellIndex}, RelativePos=${relativeCaretPos}).`);
    // log(`${logPrefix} [caretTrace] Initial rep.selStart for internal edit: Line=${rep.selStart[0]}, Col=${rep.selStart[1]}`);
 
-    // Only process keydown events for modifications
     if (evt.type !== 'keydown') {
        // log(`${logPrefix} Ignoring non-keydown event type ('${evt.type}') for handled key.`);
         return false; 
@@ -1762,10 +1540,10 @@ exports.aceKeyEvent = (h, ctx) => {
     evt.preventDefault();
 
     let newAbsoluteCaretCol = -1;
-    let repBeforeEdit = null; // Store rep before edits for attribute helper
+    let repBeforeEdit = null;
 
     try {
-        repBeforeEdit = editorInfo.ace_getRep(); // Get rep *before* making changes
+        repBeforeEdit = editorInfo.ace_getRep();
        // log(`${logPrefix} [caretTrace] rep.selStart before ace_performDocumentReplaceRange: Line=${repBeforeEdit.selStart[0]}, Col=${repBeforeEdit.selStart[1]}`);
 
     if (isTypingKey) {
@@ -1786,27 +1564,24 @@ exports.aceKeyEvent = (h, ctx) => {
             const delRangeEnd = [currentLineNum, currentCol + 1];
            // log(`${logPrefix} -> Deleting (Delete) range [${delRangeStart}]-[${delRangeEnd}]`);
             editorInfo.ace_performDocumentReplaceRange(delRangeStart, delRangeEnd, '');
-            newAbsoluteCaretCol = currentCol; // Caret stays at the same column for delete
+            newAbsoluteCaretCol = currentCol;
         }
         const repAfterReplace = editorInfo.ace_getRep();
        // log(`${logPrefix} [caretTrace] rep.selStart after ace_performDocumentReplaceRange: Line=${repAfterReplace.selStart[0]}, Col=${repAfterReplace.selStart[1]}`);
 
 
-        // *** CRITICAL: Re-apply the line attribute after ANY modification ***
        // log(`${logPrefix} -> Re-applying tbljson line attribute...`);
-        
-        // DEBUG: Log the values before calculating attrStringToApply
+
        // log(`${logPrefix} DEBUG: Before calculating attrStringToApply - trustedLastClick=${trustedLastClick}, reportedLineNum=${reportedLineNum}, currentLineNum=${currentLineNum}`);
        // log(`${logPrefix} DEBUG: lineAttrString value:`, lineAttrString ? `"${lineAttrString}"` : 'null/undefined');
-        
+
         const applyHelper = editorInfo.ep_data_tables_applyMeta; 
         if (applyHelper && typeof applyHelper === 'function' && repBeforeEdit) { 
-             // Pass the original lineAttrString if available AND if it belongs to the currentLineNum
              const attrStringToApply = (trustedLastClick || reportedLineNum === currentLineNum) ? lineAttrString : null;
-             
+
             // log(`${logPrefix} DEBUG: Calculated attrStringToApply:`, attrStringToApply ? `"${attrStringToApply}"` : 'null/undefined');
             // log(`${logPrefix} DEBUG: Condition result: (${trustedLastClick} || ${reportedLineNum} === ${currentLineNum}) = ${trustedLastClick || reportedLineNum === currentLineNum}`);
-             
+
              applyHelper(currentLineNum, metadataForTargetLine.tblId, metadataForTargetLine.row, metadataForTargetLine.cols, repBeforeEdit, editorInfo, attrStringToApply, docManager);
             // log(`${logPrefix} -> tbljson line attribute re-applied (using rep before edit).`);
                 } else {
@@ -1814,16 +1589,15 @@ exports.aceKeyEvent = (h, ctx) => {
              const currentRepFallback = editorInfo.ace_getRep();
              if (applyHelper && typeof applyHelper === 'function' && currentRepFallback) {
                 // log(`${logPrefix} -> Retrying attribute application with current rep...`);
-                 applyHelper(currentLineNum, metadataForTargetLine.tblId, metadataForTargetLine.row, metadataForTargetLine.cols, currentRepFallback, editorInfo, null, docManager); // Cannot guarantee old attr string is valid here
+                 applyHelper(currentLineNum, metadataForTargetLine.tblId, metadataForTargetLine.row, metadataForTargetLine.cols, currentRepFallback, editorInfo, null, docManager);
                 // log(`${logPrefix} -> tbljson line attribute re-applied (using current rep fallback).`);
             } else {
                   console.error(`${logPrefix} -> FAILED to re-apply tbljson attribute even with fallback rep.`);
              }
         }
-        
-        // Set caret position immediately
+
         if (newAbsoluteCaretCol >= 0) {
-             const newCaretPos = [currentLineNum, newAbsoluteCaretCol]; // Use the trusted currentLineNum
+             const newCaretPos = [currentLineNum, newAbsoluteCaretCol];
             // log(`${logPrefix} -> Setting selection immediately to:`, newCaretPos);
             // log(`${logPrefix} [caretTrace] rep.selStart before ace_performSelectionChange: Line=${editorInfo.ace_getRep().selStart[0]}, Col=${editorInfo.ace_getRep().selStart[1]}`);
              try {
@@ -1832,20 +1606,17 @@ exports.aceKeyEvent = (h, ctx) => {
                // log(`${logPrefix} [caretTrace] [selection] rep.selStart after ace_performSelectionChange: Line=${repAfterSelectionChange.selStart[0]}, Col=${repAfterSelectionChange.selStart[1]}`);
                // log(`${logPrefix} -> Selection set immediately.`);
 
-                // Add sync hint AFTER setting selection
                 editorInfo.ace_fastIncorp(1); 
                 const repAfterFastIncorp = editorInfo.ace_getRep();
                // log(`${logPrefix} [caretTrace] [selection] rep.selStart after ace_fastIncorp: Line=${repAfterFastIncorp.selStart[0]}, Col=${repAfterFastIncorp.selStart[1]}`);
                // log(`${logPrefix} -> Requested sync hint (fastIncorp 1).`);
 
-                // --- Re-assert selection --- 
                 const targetCaretPosForReassert = [currentLineNum, newAbsoluteCaretCol];
                // log(`${logPrefix} [caretTrace] Attempting to re-assert selection post-fastIncorp to [${targetCaretPosForReassert[0]}, ${targetCaretPosForReassert[1]}]`);
                 editorInfo.ace_performSelectionChange(targetCaretPosForReassert, targetCaretPosForReassert, false);
                 const repAfterReassert = editorInfo.ace_getRep();
                // log(`${logPrefix} [caretTrace] [selection] rep.selStart after re-asserting selection: Line=${repAfterReassert.selStart[0]}, Col=${repAfterReassert.selStart[1]}`);
 
-                // Store the updated caret info for the next event
                 const newRelativePos = newAbsoluteCaretCol - cellStartCol;
                 editor.ep_data_tables_last_clicked = {
                     lineNum: currentLineNum, 
@@ -1867,44 +1638,43 @@ exports.aceKeyEvent = (h, ctx) => {
         } catch (error) {
        // log(`${logPrefix} ERROR during manual key handling:`, error);
             console.error('[ep_data_tables] Error processing key event update:', error);
-        // Maybe return false to allow default as a fallback on error?
-        // For now, return true as we prevented default.
     return true;
   }
 
     const endLogTime = Date.now();
    // log(`${logPrefix} END (Handled Internal Edit Manually) Key='${evt.key}' Type='${evt.type}' -> Returned true. Duration: ${endLogTime - startLogTime}ms`);
-    return true; // We handled the key event
+    return true;
 
-  } // End if(isTypingKey || isInternalBackspace || isInternalDelete)
+  }
 
 
-  // Fallback for any other keys or edge cases not handled above
   const endLogTimeFinal = Date.now();
  // log(`${logPrefix} END (Fell Through / Unhandled Case) Key='${evt.key}' Type='${evt.type}'. Allowing default. Duration: ${endLogTimeFinal - startLogTime}ms`);
-  // Clear click state if it wasn't handled?
-  // if (editor?.ep_data_tables_last_clicked) editor.ep_data_tables_last_clicked = null;
  // log(`${logPrefix} [caretTrace] Final rep.selStart at end of aceKeyEvent (if unhandled): Line=${rep.selStart[0]}, Col=${rep.selStart[1]}`);
-  return false; // Allow default browser/ACE handling
+  return false;
 };
-
-// ───────────────────── ace init + public helpers ─────────────────────
 exports.aceInitialized = (h, ctx) => {
   const logPrefix = '[ep_data_tables:aceInitialized]';
  // log(`${logPrefix} START`, { hook_name: h, context: ctx });
   const ed = ctx.editorInfo;
   const docManager = ctx.documentAttributeManager;
 
+  try {
+    if (typeof window !== 'undefined') {
+      window.__epDataTablesReady = true;
+      const guard = document.getElementById('ep-data-tables-guard');
+      if (guard && guard.parentNode) guard.parentNode.removeChild(guard);
+    }
+  } catch (_) {}
+
  // log(`${logPrefix} Attaching ep_data_tables_applyMeta helper to editorInfo.`);
   ed.ep_data_tables_applyMeta = applyTableLineMetadataAttribute;
  // log(`${logPrefix}: Attached applyTableLineMetadataAttribute helper to ed.ep_data_tables_applyMeta successfully.`);
 
-  // Store the documentAttributeManager reference for later use
  // log(`${logPrefix} Storing documentAttributeManager reference on editorInfo.`);
   ed.ep_data_tables_docManager = docManager;
  // log(`${logPrefix}: Stored documentAttributeManager reference as ed.ep_data_tables_docManager.`);
 
-  // *** ENHANCED: Paste event listener + Column resize listeners ***
  // log(`${logPrefix} Preparing to attach paste and resize listeners via ace_callWithAce.`);
   ed.ace_callWithAce((ace) => {
     const callWithAceLogPrefix = '[ep_data_tables:aceInitialized:callWithAceForListeners]';
@@ -1918,12 +1688,10 @@ exports.aceInitialized = (h, ctx) => {
     const editor = ace.editor;
    // log(`${callWithAceLogPrefix} ace.editor obtained successfully.`);
 
-    // Store editor reference for later use in table operations
    // log(`${logPrefix} Storing editor reference on editorInfo.`);
     ed.ep_data_tables_editor = editor;
    // log(`${logPrefix}: Stored editor reference as ed.ep_data_tables_editor.`);
 
-    // Attempt to find the inner iframe body, similar to ep_image_insert
     let $inner;
     try {
      // log(`${callWithAceLogPrefix} Attempting to find inner iframe body for listener attachment.`);
@@ -1949,8 +1717,294 @@ exports.aceInitialized = (h, ctx) => {
        // log(`${callWithAceLogPrefix} Failed to find body in ace_inner.`);
         return;
       }
-      $inner = $(innerDocBody[0]); // Ensure it's a jQuery object of the body itself
+      $inner = $(innerDocBody[0]);
      // log(`${callWithAceLogPrefix} Successfully found inner iframe body:`, $inner);
+
+      const mobileSuggestionBlocker = (evt) => {
+        const t = evt && evt.inputType || '';
+        const dataStr = (evt && typeof evt.data === 'string') ? evt.data : '';
+        const isProblem = (
+          t === 'insertReplacementText' ||
+          t === 'insertFromComposition' ||
+          (t === 'insertText' && !evt.isComposing && (!dataStr || dataStr.length > 1))
+        );
+        if (!isProblem) return;
+
+        try {
+          const repQuick = ed.ace_getRep && ed.ace_getRep();
+          if (!repQuick || !repQuick.selStart) return;
+          const lineNumQuick = repQuick.selStart[0];
+          let metaStrQuick = docManager && docManager.getAttributeOnLine
+            ? docManager.getAttributeOnLine(lineNumQuick, ATTR_TABLE_JSON)
+            : null;
+          let metaQuick = null;
+          if (metaStrQuick) { try { metaQuick = JSON.parse(metaStrQuick); } catch (_) {} }
+          if (!metaQuick) metaQuick = getTableLineMetadata(lineNumQuick, ed, docManager);
+          if (!metaQuick || typeof metaQuick.cols !== 'number') return;
+        } catch (_) { return; }
+
+        evt._epDataTablesHandled = true;
+        if (evt.originalEvent) evt.originalEvent._epDataTablesHandled = true;
+        evt.preventDefault();
+        if (typeof evt.stopImmediatePropagation === 'function') evt.stopImmediatePropagation();
+
+        const capturedInputType = t;
+        const capturedData = dataStr;
+
+        setTimeout(() => {
+          try {
+            ed.ace_callWithAce((aceInstance) => {
+              aceInstance.ace_fastIncorp(10);
+              const rep = aceInstance.ace_getRep();
+              if (!rep || !rep.selStart || !rep.selEnd) return;
+
+              const selStart = [...rep.selStart];
+              const selEnd = [...rep.selEnd];
+              const lineNum = selStart[0];
+
+              let metaStr = docManager && docManager.getAttributeOnLine
+                ? docManager.getAttributeOnLine(lineNum, ATTR_TABLE_JSON)
+                : null;
+              let tableMetadata = null;
+              if (metaStr) { try { tableMetadata = JSON.parse(metaStr); } catch (_) {} }
+              if (!tableMetadata) tableMetadata = getTableLineMetadata(lineNum, ed, docManager);
+              if (!tableMetadata || typeof tableMetadata.cols !== 'number' || typeof tableMetadata.tblId === 'undefined') {
+                return;
+              }
+
+              const initialHasSelection = !(selStart[0] === selEnd[0] && selStart[1] === selEnd[1]);
+
+              let replacement = typeof capturedData === 'string' ? capturedData : '';
+              if (!replacement) {
+                if (capturedInputType === 'insertText' && !initialHasSelection) {
+                  replacement = ' ';
+                } else if (capturedInputType === 'insertReplacementText' || capturedInputType === 'insertFromComposition' || initialHasSelection) {
+                  replacement = ' ';
+                }
+              }
+
+              replacement = normalizeSoftWhitespace(
+                (replacement || '')
+                  .replace(new RegExp(DELIMITER, 'g'), ' ')
+                  .replace(/[\u200B\u200C\u200D\uFEFF]/g, '')
+              );
+
+              if (!replacement) replacement = ' ';
+
+              const lineEntry = rep.lines.atIndex(lineNum);
+              const lineText = lineEntry?.text || '';
+              const cells = lineText.split(DELIMITER);
+              let currentOffset = 0;
+              let targetCellIndex = -1;
+              let cellStartCol = 0;
+              let cellEndCol = 0;
+              for (let i = 0; i < cells.length; i++) {
+                const cellLen = cells[i]?.length ?? 0;
+                const cellEndThis = currentOffset + cellLen;
+                if (selStart[1] >= currentOffset && selStart[1] <= cellEndThis) {
+                  targetCellIndex = i;
+                  cellStartCol = currentOffset;
+                  cellEndCol = cellEndThis;
+                  break;
+                }
+                currentOffset += cellLen + DELIMITER.length;
+              }
+
+              if (targetCellIndex === -1) {
+                aceInstance.ace_performDocumentReplaceRange(selStart, selEnd, replacement);
+                const repAfterFallback = aceInstance.ace_getRep();
+                ed.ep_data_tables_applyMeta(
+                  lineNum,
+                  tableMetadata.tblId,
+                  tableMetadata.row,
+                  tableMetadata.cols,
+                  repAfterFallback,
+                  ed,
+                  null,
+                  docManager
+                );
+                const fallbackLineEntry = repAfterFallback.lines.atIndex(lineNum);
+                const fallbackMaxLen = fallbackLineEntry ? fallbackLineEntry.text.length : 0;
+                const fallbackStartCol = Math.min(Math.max(selStart[1], 0), fallbackMaxLen);
+                const fallbackEndCol = Math.min(fallbackStartCol + replacement.length, fallbackMaxLen);
+                const fallbackCaretPos = [lineNum, fallbackEndCol];
+                aceInstance.ace_performSelectionChange(fallbackCaretPos, fallbackCaretPos, false);
+                aceInstance.ace_fastIncorp(10);
+                return;
+              }
+
+              if (selEnd[0] !== selStart[0]) {
+                selEnd[0] = selStart[0];
+                selEnd[1] = cellEndCol;
+              }
+
+              if (selEnd[1] > cellEndCol) {
+                selEnd[1] = Math.min(selEnd[1], cellEndCol);
+              }
+
+              if (selEnd[1] < selStart[1]) selEnd[1] = selStart[1];
+
+              aceInstance.ace_performDocumentReplaceRange(selStart, selEnd, replacement);
+
+              const repAfter = aceInstance.ace_getRep();
+              const lineEntryAfter = repAfter.lines.atIndex(lineNum);
+              const maxLen = lineEntryAfter ? lineEntryAfter.text.length : 0;
+              const startCol = Math.min(Math.max(selStart[1], 0), maxLen);
+              const endCol = Math.min(startCol + replacement.length, maxLen);
+
+              if (endCol > startCol) {
+                aceInstance.ace_performDocumentApplyAttributesToRange(
+                  [lineNum, startCol],
+                  [lineNum, endCol],
+                  [[ATTR_CELL, String(targetCellIndex)]]
+                );
+              }
+
+              ed.ep_data_tables_applyMeta(
+                lineNum,
+                tableMetadata.tblId,
+                tableMetadata.row,
+                tableMetadata.cols,
+                repAfter,
+                ed,
+                null,
+                docManager
+              );
+
+              const newCaretPos = [lineNum, endCol];
+              aceInstance.ace_performSelectionChange(newCaretPos, newCaretPos, false);
+              aceInstance.ace_fastIncorp(10);
+
+              const editor = ed.ep_data_tables_editor;
+              if (editor && editor.ep_data_tables_last_clicked && editor.ep_data_tables_last_clicked.tblId === tableMetadata.tblId) {
+                const freshLineText = lineEntryAfter ? lineEntryAfter.text : '';
+                const freshCells = freshLineText.split(DELIMITER);
+                let freshOffset = 0;
+                for (let i = 0; i < targetCellIndex; i++) {
+                  freshOffset += (freshCells[i]?.length ?? 0) + DELIMITER.length;
+                }
+                const newRelativePos = newCaretPos[1] - freshOffset;
+                editor.ep_data_tables_last_clicked = {
+                  lineNum,
+                  tblId: tableMetadata.tblId,
+                  cellIndex: targetCellIndex,
+                  relativePos: newRelativePos < 0 ? 0 : newRelativePos,
+                };
+              }
+            }, 'mobileSuggestionBlocker', true);
+          } catch (e) {
+            console.error('[ep_data_tables:mobileSuggestionBlocker] Error applying predictive text:', e);
+          }
+        }, 0);
+      };
+
+      // IME/autocorrect diagnostics: capture-phase logging and newline soft-normalization for table lines
+      const logIMEEvent = (rawEvt, tag) => {
+        try {
+          const e = rawEvt && (rawEvt.originalEvent || rawEvt);
+          const rep = ed.ace_getRep && ed.ace_getRep();
+          const selStart = rep && rep.selStart;
+          const lineNum = selStart ? selStart[0] : -1;
+          let isTableLine = false;
+          if (lineNum >= 0) {
+            let s = docManager && docManager.getAttributeOnLine ? docManager.getAttributeOnLine(lineNum, ATTR_TABLE_JSON) : null;
+            if (!s) {
+              const meta = getTableLineMetadata(lineNum, ed, docManager);
+              isTableLine = !!meta && typeof meta.cols === 'number';
+            } else {
+              isTableLine = true;
+            }
+          }
+          if (!isTableLine) return;
+          const payload = {
+            tag,
+            type: e && e.type,
+            inputType: e && e.inputType,
+            data: typeof (e && e.data) === 'string' ? e.data : null,
+            isComposing: !!(e && e.isComposing),
+            key: e && e.key,
+            code: e && e.code,
+            which: e && e.which,
+            keyCode: e && e.keyCode,
+          };
+          console.debug('[ep_data_tables:ime-diag]', payload);
+        } catch (_) {}
+      };
+
+      const softBreakNormalizer = (rawEvt) => {
+        try {
+          const e = rawEvt && (rawEvt.originalEvent || rawEvt);
+          if (!e || e._epDataTablesNormalized) return;
+          const t = e.inputType || '';
+          const dataStr = typeof e.data === 'string' ? e.data : '';
+          const hasSoftWs = /[\r\n\u00A0]/.test(dataStr); // include NBSP (U+00A0)
+          const isSoftBreak = t === 'insertParagraph' || t === 'insertLineBreak' || hasSoftWs;
+          if (!isSoftBreak) return;
+
+          const rep = ed.ace_getRep && ed.ace_getRep();
+          if (!rep || !rep.selStart) return;
+          const lineNum = rep.selStart[0];
+          let metaStr = docManager && docManager.getAttributeOnLine ? docManager.getAttributeOnLine(lineNum, ATTR_TABLE_JSON) : null;
+          let meta = null;
+          if (metaStr) { try { meta = JSON.parse(metaStr); } catch (_) {} }
+          if (!meta) meta = getTableLineMetadata(lineNum, ed, docManager);
+          if (!meta || typeof meta.cols !== 'number') return;
+
+          e.preventDefault();
+          if (typeof e.stopImmediatePropagation === 'function') e.stopImmediatePropagation();
+          e._epDataTablesNormalized = true;
+          setTimeout(() => {
+            try {
+              ed.ace_callWithAce((aceInstance) => {
+                aceInstance.ace_fastIncorp(10);
+                const rep2 = aceInstance.ace_getRep();
+                const start = rep2.selStart;
+                const end = rep2.selEnd;
+                // Replace the attempted soft-break with a single space
+                aceInstance.ace_performDocumentReplaceRange(start, end, ' ');
+              }, 'softBreakNormalizer', true);
+            } catch (err) { console.error('[ep_data_tables:softBreakNormalizer] error', err); }
+          }, 0);
+        } catch (_) {}
+      };
+
+      if ($inner && $inner.length > 0 && $inner[0].addEventListener) {
+        const el = $inner[0];
+        ['beforeinput','input','textInput','compositionstart','compositionupdate','compositionend','keydown','keyup'].forEach((t) => {
+          el.addEventListener(t, (ev) => logIMEEvent(ev, 'capture'), true);
+        });
+        el.addEventListener('beforeinput', softBreakNormalizer, true);
+      }
+
+      if ($inner && $inner.length > 0 && $inner[0].addEventListener) {
+        $inner[0].addEventListener('beforeinput', mobileSuggestionBlocker, true);
+      }
+
+      if (isAndroidUA && isAndroidUA() && $inner && $inner.length > 0 && $inner[0].addEventListener) {
+        $inner[0].addEventListener('textInput', (evt) => {
+          const s = typeof evt.data === 'string' ? evt.data : '';
+          if (s && s.length > 1) {
+            mobileSuggestionBlocker({
+              inputType: 'insertText',
+              isComposing: false,
+              data: s,
+              preventDefault: () => { try { evt.preventDefault(); } catch (_) {} },
+              stopImmediatePropagation: () => { try { evt.stopImmediatePropagation(); } catch (_) {} },
+            });
+          }
+        }, true);
+      }
+
+      try {
+        const disableAuto = (el) => {
+          if (!el) return;
+          el.setAttribute('autocorrect', 'off');
+          el.setAttribute('autocomplete', 'off');
+          el.setAttribute('autocapitalize', 'off');
+          el.setAttribute('spellcheck', 'false');
+        };
+        disableAuto(innerDocBody[0] || innerDocBody);
+      } catch (_) {}
     } catch (e) {
       console.error(`${callWithAceLogPrefix} ERROR: Exception while trying to find inner iframe body:`, e);
      // log(`${callWithAceLogPrefix} Exception details:`, { message: e.message, stack: e.stack });
@@ -1963,7 +2017,6 @@ exports.aceInitialized = (h, ctx) => {
       return;
     }
 
-    // *** CUT EVENT LISTENER ***
    // log(`${callWithAceLogPrefix} Attaching cut event listener to $inner (inner iframe body).`);
     $inner.on('cut', (evt) => {
       const cutLogPrefix = '[ep_data_tables:cutHandler]';
@@ -1974,20 +2027,18 @@ exports.aceInitialized = (h, ctx) => {
       if (!rep || !rep.selStart) {
         console.warn(`${cutLogPrefix} WARNING: Could not get representation or selection. Allowing default cut.`);
         console.warn(`${cutLogPrefix} Could not get rep or selStart.`);
-        return; // Allow default
+        return;
       }
       console.log(`${cutLogPrefix} Rep obtained. selStart:`, rep.selStart, `selEnd:`, rep.selEnd);
       const selStart = rep.selStart;
       const selEnd = rep.selEnd;
       const lineNum = selStart[0];
       console.log(`${cutLogPrefix} Current line number: ${lineNum}. Column start: ${selStart[1]}, Column end: ${selEnd[1]}.`);
-      // Determine if there is a selection in the editor representation
       const hasSelectionInRep = !(selStart[0] === selEnd[0] && selStart[1] === selEnd[1]);
       if (!hasSelectionInRep) {
         console.log(`${cutLogPrefix} No selection detected in rep; deferring decision until table-line check.`);
       }
 
-      // Check if selection spans multiple lines
       if (selStart[0] !== selEnd[0]) {
         console.warn(`${cutLogPrefix} WARNING: Selection spans multiple lines. Preventing cut to protect table structure.`);
         evt.preventDefault();
@@ -1999,32 +2050,28 @@ exports.aceInitialized = (h, ctx) => {
       let tableMetadata = null;
 
       if (lineAttrString) {
-        // Fast-path: attribute exists – parse it.
         try {
         tableMetadata = JSON.parse(lineAttrString);
         } catch {}
       }
 
       if (!tableMetadata) {
-        // Fallback for block-styled rows – reconstruct via DOM helper.
         tableMetadata = getTableLineMetadata(lineNum, ed, docManager);
       }
 
       if (!tableMetadata || typeof tableMetadata.cols !== 'number' || typeof tableMetadata.tblId === 'undefined' || typeof tableMetadata.row === 'undefined') {
         console.log(`${cutLogPrefix} Line ${lineNum} is NOT a recognised table line. Allowing default cut.`);
-        return; // Not a table line
+        return;
       }
 
       console.log(`${cutLogPrefix} Line ${lineNum} IS a table line. Metadata:`, tableMetadata);
 
-      // If inside a table line but the rep shows no selection, prevent default to protect structure
       if (!hasSelectionInRep) {
         console.log(`${cutLogPrefix} Preventing default CUT on table line with collapsed selection to protect delimiters.`);
         evt.preventDefault();
         return;
       }
 
-      // Validate selection is within cell boundaries
       const lineText = rep.lines.atIndex(lineNum)?.text || '';
       const cells = lineText.split(DELIMITER);
       let currentOffset = 0;
@@ -2035,7 +2082,7 @@ exports.aceInitialized = (h, ctx) => {
       for (let i = 0; i < cells.length; i++) {
         const cellLength = cells[i]?.length ?? 0;
         const cellEndColThisIteration = currentOffset + cellLength;
-        
+
         if (selStart[1] >= currentOffset && selStart[1] <= cellEndColThisIteration) {
           targetCellIndex = i;
           cellStartCol = currentOffset;
@@ -2048,7 +2095,7 @@ exports.aceInitialized = (h, ctx) => {
       /* allow "…cell content + delimiter" selections */
       const wouldClampStart = targetCellIndex > 0 && selStart[1] === cellStartCol - DELIMITER.length;
       const wouldClampEnd = targetCellIndex !== -1 && selEnd[1] === cellEndCol + DELIMITER.length;
-      
+
       console.log(`[ep_data_tables:cut-handler] Cut selection analysis:`, {
         targetCellIndex,
         selStartCol: selStart[1],
@@ -2061,15 +2108,15 @@ exports.aceInitialized = (h, ctx) => {
         wouldClampStart,
         wouldClampEnd
       });
-      
+
       if (wouldClampStart) {
         console.log(`[ep_data_tables:cut-handler] CLAMPING cut selection start from ${selStart[1]} to ${cellStartCol}`);
-        selStart[1] = cellStartCol;          // clamp
+        selStart[1] = cellStartCol;
       }
-      
+
       if (wouldClampEnd) {
         console.log(`[ep_data_tables:cut-handler] CLAMPING cut selection end from ${selEnd[1]} to ${cellEndCol}`);
-        selEnd[1] = cellEndCol;              // clamp
+        selEnd[1] = cellEndCol;
       }
       if (targetCellIndex === -1 || selEnd[1] > cellEndCol) {
         console.warn(`${cutLogPrefix} WARNING: Selection spans cell boundaries or is outside cells. Preventing cut to protect table structure.`);
@@ -2077,16 +2124,13 @@ exports.aceInitialized = (h, ctx) => {
         return;
       }
 
-      // If we reach here, the selection is entirely within a single cell - allow cut and preserve table structure
       console.log(`${cutLogPrefix} Selection is entirely within cell ${targetCellIndex}. Intercepting cut to preserve table structure.`);
       evt.preventDefault();
 
       try {
-        // Get the selected text to copy to clipboard
         const selectedText = lineText.substring(selStart[1], selEnd[1]);
         console.log(`${cutLogPrefix} Selected text to cut: "${selectedText}"`);
 
-        // Copy to clipboard manually
         if (navigator.clipboard && navigator.clipboard.writeText) {
           navigator.clipboard.writeText(selectedText).then(() => {
             console.log(`${cutLogPrefix} Successfully copied to clipboard via Navigator API.`);
@@ -2094,7 +2138,6 @@ exports.aceInitialized = (h, ctx) => {
             console.warn(`${cutLogPrefix} Failed to copy to clipboard via Navigator API:`, err);
           });
         } else {
-          // Fallback for older browsers
           console.log(`${cutLogPrefix} Using fallback clipboard method.`);
           const textArea = document.createElement('textarea');
           textArea.value = selectedText;
@@ -2109,17 +2152,15 @@ exports.aceInitialized = (h, ctx) => {
           document.body.removeChild(textArea);
         }
 
-        // Now perform the deletion within the cell using ace operations
         console.log(`${cutLogPrefix} Performing deletion via ed.ace_callWithAce.`);
         ed.ace_callWithAce((aceInstance) => {
           const callAceLogPrefix = `${cutLogPrefix}[ace_callWithAceOps]`;
           console.log(`${callAceLogPrefix} Entered ace_callWithAce for cut operations. selStart:`, selStart, `selEnd:`, selEnd);
-          
+
           console.log(`${callAceLogPrefix} Calling aceInstance.ace_performDocumentReplaceRange to delete selected text.`);
           aceInstance.ace_performDocumentReplaceRange(selStart, selEnd, '');
           console.log(`${callAceLogPrefix} ace_performDocumentReplaceRange successful.`);
 
-          // --- Ensure cell is not left empty (zero-length) ---
           const repAfterDeletion = aceInstance.ace_getRep();
           const lineTextAfterDeletion = repAfterDeletion.lines.atIndex(lineNum).text;
           const cellsAfterDeletion = lineTextAfterDeletion.split(DELIMITER);
@@ -2127,10 +2168,9 @@ exports.aceInitialized = (h, ctx) => {
 
           if (cellTextAfterDeletion.length === 0) {
             console.log(`${callAceLogPrefix} Cell ${targetCellIndex} became empty after cut – inserting single space to preserve structure.`);
-            const insertPos = [lineNum, selStart[1]]; // Start of the now-empty cell
+            const insertPos = [lineNum, selStart[1]];
             aceInstance.ace_performDocumentReplaceRange(insertPos, insertPos, ' ');
 
-            // NEW – re-apply td attribute to the freshly inserted space
             const attrStart = insertPos;
             const attrEnd   = [insertPos[0], insertPos[1] + 1];
             aceInstance.ace_performDocumentApplyAttributesToRange(
@@ -2141,7 +2181,7 @@ exports.aceInitialized = (h, ctx) => {
           console.log(`${callAceLogPrefix} Preparing to re-apply tbljson attribute to line ${lineNum}.`);
           const repAfterCut = aceInstance.ace_getRep();
           console.log(`${callAceLogPrefix} Fetched rep after cut for applyMeta. Line ${lineNum} text now: "${repAfterCut.lines.atIndex(lineNum).text}"`);
-          
+
           ed.ep_data_tables_applyMeta(
             lineNum,
             tableMetadata.tblId,
@@ -2169,16 +2209,14 @@ exports.aceInitialized = (h, ctx) => {
       }
     });
 
-    // *** BEFOREINPUT EVENT LISTENER FOR CONTEXT-MENU DELETE ***
    // log(`${callWithAceLogPrefix} Attaching beforeinput event listener to $inner (inner iframe body).`);
     $inner.on('beforeinput', (evt) => {
       const deleteLogPrefix = '[ep_data_tables:beforeinputDeleteHandler]';
      // log(`${deleteLogPrefix} BEFOREINPUT EVENT TRIGGERED. inputType: "${evt.originalEvent.inputType}", event object:`, evt);
 
-      // Only intercept deletion-related input events
       if (!evt.originalEvent.inputType || !evt.originalEvent.inputType.startsWith('delete')) {
        // log(`${deleteLogPrefix} Not a deletion event (inputType: "${evt.originalEvent.inputType}"). Allowing default.`);
-        return; // Allow default for non-delete events
+        return;
       }
 
      // log(`${deleteLogPrefix} Getting current editor representation (rep).`);
@@ -2186,7 +2224,7 @@ exports.aceInitialized = (h, ctx) => {
       if (!rep || !rep.selStart) {
        // log(`${deleteLogPrefix} WARNING: Could not get representation or selection. Allowing default delete.`);
         console.warn(`${deleteLogPrefix} Could not get rep or selStart.`);
-        return; // Allow default
+        return;
       }
      // log(`${deleteLogPrefix} Rep obtained. selStart:`, rep.selStart, `selEnd:`, rep.selEnd);
       const selStart = rep.selStart;
@@ -2194,23 +2232,19 @@ exports.aceInitialized = (h, ctx) => {
       const lineNum = selStart[0];
      // log(`${deleteLogPrefix} Current line number: ${lineNum}. Column start: ${selStart[1]}, Column end: ${selEnd[1]}.`);
 
-      // Android Chrome IME: collapsed backspace/forward-delete often comes via beforeinput
       const isAndroidChrome = isAndroidUA();
       const inputType = (evt.originalEvent && evt.originalEvent.inputType) || '';
 
-      // Handle collapsed deletes on Android Chrome inside a table line to protect delimiters
       const isCollapsed = (selStart[0] === selEnd[0] && selStart[1] === selEnd[1]);
       if (isCollapsed && isAndroidChrome && (inputType === 'deleteContentBackward' || inputType === 'deleteContentForward')) {
-        // Resolve metadata for this line
         let lineAttrString = docManager.getAttributeOnLine(lineNum, ATTR_TABLE_JSON);
         let tableMetadata = null;
         if (lineAttrString) { try { tableMetadata = JSON.parse(lineAttrString); } catch (_) {} }
         if (!tableMetadata) tableMetadata = getTableLineMetadata(lineNum, ed, docManager);
         if (!tableMetadata || typeof tableMetadata.cols !== 'number') {
-          return; // Not a table line; allow default
+          return;
         }
 
-        // Compute current cell and boundaries
         const lineText = rep.lines.atIndex(lineNum)?.text || '';
         const cells = lineText.split(DELIMITER);
         let currentOffset = 0;
@@ -2229,27 +2263,52 @@ exports.aceInitialized = (h, ctx) => {
           currentOffset += cellLength + DELIMITER.length;
         }
 
-        if (targetCellIndex === -1) return; // Allow default if not within a cell
+        if (targetCellIndex === -1) return;
 
         const isBackward = inputType === 'deleteContentBackward';
         const caretCol = selStart[1];
 
-        // Prevent deletion across delimiters or line boundaries
         if ((isBackward && caretCol === cellStartCol) || (!isBackward && caretCol === cellEndCol)) {
           evt.preventDefault();
           return;
         }
 
-        // Intercept and perform one-character deletion via Ace
         evt.preventDefault();
         try {
           ed.ace_callWithAce((aceInstance) => {
+            // Refresh representation to account for any prior synchronous edits
+            aceInstance.ace_fastIncorp(10);
+            const freshRep = aceInstance.ace_getRep();
+
+            const freshLineEntry = freshRep.lines.atIndex(lineNum);
+            const freshText = (freshLineEntry && freshLineEntry.text) || '';
+            const freshCells = freshText.split(DELIMITER);
+
+            let offset = 0;
+            let freshCellStart = 0;
+            let freshCellEnd = 0;
+            for (let i = 0; i < freshCells.length; i++) {
+              const len = freshCells[i]?.length ?? 0;
+              const end = offset + len;
+              if (i === targetCellIndex) {
+                freshCellStart = offset;
+                freshCellEnd = end;
+                break;
+              }
+              offset += len + DELIMITER.length;
+            }
+
+            // If caret is flush against delimiter after refresh, abort to protect structure
+            if ((isBackward && caretCol <= freshCellStart) || (!isBackward && caretCol >= freshCellEnd)) {
+              return;
+            }
+
             const delStart = isBackward ? [lineNum, caretCol - 1] : [lineNum, caretCol];
             const delEnd   = isBackward ? [lineNum, caretCol]     : [lineNum, caretCol + 1];
             aceInstance.ace_performDocumentReplaceRange(delStart, delEnd, '');
 
-            // Re-apply table metadata attribute to ensure renderer stability
             const repAfter = aceInstance.ace_getRep();
+
             ed.ep_data_tables_applyMeta(
               lineNum,
               tableMetadata.tblId,
@@ -2261,13 +2320,11 @@ exports.aceInitialized = (h, ctx) => {
               docManager
             );
 
-            // Set caret position after deletion
             const newCaretCol = isBackward ? caretCol - 1 : caretCol;
             const newCaretPos = [lineNum, newCaretCol];
             aceInstance.ace_performSelectionChange(newCaretPos, newCaretPos, false);
             aceInstance.ace_fastIncorp(10);
 
-            // Update last-clicked state if available
             if (ed.ep_data_tables_editor && ed.ep_data_tables_editor.ep_data_tables_last_clicked && ed.ep_data_tables_editor.ep_data_tables_last_clicked.tblId === tableMetadata.tblId) {
               const newRelativePos = newCaretCol - cellStartCol;
               ed.ep_data_tables_editor.ep_data_tables_last_clicked = {
@@ -2284,12 +2341,10 @@ exports.aceInitialized = (h, ctx) => {
         return;
       }
 
-      // Non-Android or non-collapsed: require an actual selection to handle here; otherwise allow default
       if (isCollapsed) {
-        return; // Allow default
+        return;
       }
 
-      // Check if selection spans multiple lines
       if (selStart[0] !== selEnd[0]) {
        // log(`${deleteLogPrefix} WARNING: Selection spans multiple lines. Preventing delete to protect table structure.`);
         evt.preventDefault();
@@ -2301,25 +2356,22 @@ exports.aceInitialized = (h, ctx) => {
       let tableMetadata = null;
 
       if (lineAttrString) {
-        // Fast-path: attribute exists – parse it.
         try {
           tableMetadata = JSON.parse(lineAttrString);
         } catch {}
       }
 
       if (!tableMetadata) {
-        // Fallback for block-styled rows – reconstruct via DOM helper.
         tableMetadata = getTableLineMetadata(lineNum, ed, docManager);
       }
 
       if (!tableMetadata || typeof tableMetadata.cols !== 'number' || typeof tableMetadata.tblId === 'undefined' || typeof tableMetadata.row === 'undefined') {
        // log(`${deleteLogPrefix} Line ${lineNum} is NOT a recognised table line. Allowing default delete.`);
-        return; // Not a table line
+        return;
       }
 
      // log(`${deleteLogPrefix} Line ${lineNum} IS a table line. Metadata:`, tableMetadata);
 
-      // Validate selection is within cell boundaries
       const lineText = rep.lines.atIndex(lineNum)?.text || '';
       const cells = lineText.split(DELIMITER);
       let currentOffset = 0;
@@ -2330,7 +2382,7 @@ exports.aceInitialized = (h, ctx) => {
       for (let i = 0; i < cells.length; i++) {
         const cellLength = cells[i]?.length ?? 0;
         const cellEndColThisIteration = currentOffset + cellLength;
-        
+
         if (selStart[1] >= currentOffset && selStart[1] <= cellEndColThisIteration) {
           targetCellIndex = i;
           cellStartCol = currentOffset;
@@ -2343,7 +2395,7 @@ exports.aceInitialized = (h, ctx) => {
       /* allow "…cell content + delimiter" selections */
       const wouldClampStart = targetCellIndex > 0 && selStart[1] === cellStartCol - DELIMITER.length;
       const wouldClampEnd = targetCellIndex !== -1 && selEnd[1] === cellEndCol + DELIMITER.length;
-      
+
       console.log(`[ep_data_tables:beforeinput-delete] Delete selection analysis:`, {
         targetCellIndex,
         selStartCol: selStart[1],
@@ -2356,39 +2408,36 @@ exports.aceInitialized = (h, ctx) => {
         wouldClampStart,
         wouldClampEnd
       });
-      
+
       if (wouldClampStart) {
         console.log(`[ep_data_tables:beforeinput-delete] CLAMPING delete selection start from ${selStart[1]} to ${cellStartCol}`);
-        selStart[1] = cellStartCol;          // clamp
+        selStart[1] = cellStartCol;
       }
-      
+
       if (wouldClampEnd) {
         console.log(`[ep_data_tables:beforeinput-delete] CLAMPING delete selection end from ${selEnd[1]} to ${cellEndCol}`);
-        selEnd[1] = cellEndCol;              // clamp
+        selEnd[1] = cellEndCol;
       }
-      
+
       if (targetCellIndex === -1 || selEnd[1] > cellEndCol) {
        // log(`${deleteLogPrefix} WARNING: Selection spans cell boundaries or is outside cells. Preventing delete to protect table structure.`);
         evt.preventDefault();
         return;
       }
 
-      // If we reach here, the selection is entirely within a single cell - intercept delete and preserve table structure
      // log(`${deleteLogPrefix} Selection is entirely within cell ${targetCellIndex}. Intercepting delete to preserve table structure.`);
       evt.preventDefault();
 
       try {
-        // No clipboard operations needed for delete - just perform the deletion within the cell using ace operations
        // log(`${deleteLogPrefix} Performing deletion via ed.ace_callWithAce.`);
         ed.ace_callWithAce((aceInstance) => {
           const callAceLogPrefix = `${deleteLogPrefix}[ace_callWithAceOps]`;
          // log(`${callAceLogPrefix} Entered ace_callWithAce for delete operations. selStart:`, selStart, `selEnd:`, selEnd);
-          
+
          // log(`${callAceLogPrefix} Calling aceInstance.ace_performDocumentReplaceRange to delete selected text.`);
           aceInstance.ace_performDocumentReplaceRange(selStart, selEnd, '');
          // log(`${callAceLogPrefix} ace_performDocumentReplaceRange successful.`);
 
-          // --- Ensure cell is not left empty (zero-length) ---
           const repAfterDeletion = aceInstance.ace_getRep();
           const lineTextAfterDeletion = repAfterDeletion.lines.atIndex(lineNum).text;
           const cellsAfterDeletion = lineTextAfterDeletion.split(DELIMITER);
@@ -2396,10 +2445,9 @@ exports.aceInitialized = (h, ctx) => {
 
           if (cellTextAfterDeletion.length === 0) {
            // log(`${callAceLogPrefix} Cell ${targetCellIndex} became empty after delete – inserting single space to preserve structure.`);
-            const insertPos = [lineNum, selStart[1]]; // Start of the now-empty cell
+            const insertPos = [lineNum, selStart[1]];
             aceInstance.ace_performDocumentReplaceRange(insertPos, insertPos, ' ');
 
-            // NEW – give the placeholder its cell attribute back
             const attrStart = insertPos;
             const attrEnd   = [insertPos[0], insertPos[1] + 1];
             aceInstance.ace_performDocumentApplyAttributesToRange(
@@ -2410,7 +2458,7 @@ exports.aceInitialized = (h, ctx) => {
          // log(`${callAceLogPrefix} Preparing to re-apply tbljson attribute to line ${lineNum}.`);
           const repAfterDelete = aceInstance.ace_getRep();
          // log(`${callAceLogPrefix} Fetched rep after delete for applyMeta. Line ${lineNum} text now: "${repAfterDelete.lines.atIndex(lineNum).text}"`);
-          
+
           ed.ep_data_tables_applyMeta(
             lineNum,
             tableMetadata.tblId,
@@ -2423,7 +2471,6 @@ exports.aceInitialized = (h, ctx) => {
           );
          // log(`${callAceLogPrefix} tbljson attribute re-applied successfully via ep_data_tables_applyMeta.`);
 
-          // Determine new caret position – one char forward if we inserted a space
           const newCaretAbsoluteCol = (cellTextAfterDeletion.length === 0) ? selStart[1] + 1 : selStart[1];
           const newCaretPos = [lineNum, newCaretAbsoluteCol];
          // log(`${callAceLogPrefix} Setting caret position to: [${newCaretPos}].`);
@@ -2440,25 +2487,22 @@ exports.aceInitialized = (h, ctx) => {
       }
     });
 
-    // Android Chrome IME insert handling (targeted fix)
     $inner.on('beforeinput', (evt) => {
       const insertLogPrefix = '[ep_data_tables:beforeinputInsertHandler]';
       const inputType = evt.originalEvent && evt.originalEvent.inputType || '';
 
-      // Only intercept insert types
       if (!inputType || !inputType.startsWith('insert')) return;
 
-      // Target only Android browsers (exclude iOS)
+      if ((evt && evt._epDataTablesHandled) || (evt.originalEvent && evt.originalEvent._epDataTablesHandled)) return;
+
       if (!isAndroidUA()) return;
 
-      // Get current selection and ensure we are inside a table line
       const rep = ed.ace_getRep();
       if (!rep || !rep.selStart) return;
       const selStart = rep.selStart;
       const selEnd = rep.selEnd;
       const lineNum = selStart[0];
 
-      // Resolve table metadata for this line
       let lineAttrString = docManager.getAttributeOnLine(lineNum, ATTR_TABLE_JSON);
       let tableMetadata = null;
       if (lineAttrString) {
@@ -2466,10 +2510,9 @@ exports.aceInitialized = (h, ctx) => {
       }
       if (!tableMetadata) tableMetadata = getTableLineMetadata(lineNum, ed, docManager);
       if (!tableMetadata || typeof tableMetadata.cols !== 'number' || typeof tableMetadata.tblId === 'undefined' || typeof tableMetadata.row === 'undefined') {
-        return; // not a table line
+        return;
       }
 
-      // Compute cell boundaries and target cell index
       const lineText = rep.lines.atIndex(lineNum)?.text || '';
       const cells = lineText.split(DELIMITER);
       let currentOffset = 0;
@@ -2488,65 +2531,95 @@ exports.aceInitialized = (h, ctx) => {
         currentOffset += cellLength + DELIMITER.length;
       }
 
-      // Clamp selection end if it includes a trailing delimiter of the same cell
-      if (targetCellIndex !== -1 && selEnd[1] === cellEndCol + DELIMITER.length) {
-        selEnd[1] = cellEndCol;
-      }
-
-      // If selection spills outside the cell boundaries, block to protect structure
       if (targetCellIndex === -1 || selEnd[1] > cellEndCol) {
         evt.preventDefault();
         return;
       }
 
-      // Handle line breaks by routing to Enter behavior
       if (inputType === 'insertParagraph' || inputType === 'insertLineBreak') {
         evt.preventDefault();
-        try {
-          navigateToCellBelow(lineNum, targetCellIndex, tableMetadata, ed, docManager);
-        } catch (e) { console.error(`${insertLogPrefix} Error navigating on line break:`, e); }
+        evt.stopPropagation();
+        if (typeof evt.stopImmediatePropagation === 'function') evt.stopImmediatePropagation();
+        setTimeout(() => {
+          try {
+            ed.ace_callWithAce((aceInstance) => {
+              aceInstance.ace_fastIncorp(10);
+              const freshRep = aceInstance.ace_getRep();
+              const freshSelStart = freshRep.selStart;
+              const freshSelEnd = freshRep.selEnd;
+              aceInstance.ace_performDocumentReplaceRange(freshSelStart, freshSelEnd, ' ');
+
+              const afterRep = aceInstance.ace_getRep();
+              const maxLen = Math.max(0, afterRep.lines.atIndex(lineNum)?.text?.length || 0);
+              const startCol = Math.min(Math.max(freshSelStart[1], 0), maxLen);
+              const endCol = Math.min(startCol + 1, maxLen);
+              if (endCol > startCol) {
+                aceInstance.ace_performDocumentApplyAttributesToRange(
+                  [lineNum, startCol], [lineNum, endCol], [[ATTR_CELL, String(targetCellIndex)]]
+                );
+              }
+
+              ed.ep_data_tables_applyMeta(
+                lineNum, tableMetadata.tblId, tableMetadata.row, tableMetadata.cols,
+                afterRep, ed, null, docManager
+              );
+
+              const newCaretPos = [lineNum, endCol];
+              aceInstance.ace_performSelectionChange(newCaretPos, newCaretPos, false);
+              aceInstance.ace_fastIncorp(10);
+            }, 'iosSoftBreakToSpace', true);
+          } catch (e) {
+            console.error(`${autoLogPrefix} ERROR replacing soft break:`, e);
+          }
+        }, 0);
+        return;
+      }
+
+      if (targetCellIndex !== -1 && selEnd[1] === cellEndCol + DELIMITER.length) {
+        selEnd[1] = cellEndCol;
+      }
+
+      if (inputType === 'insertParagraph' || inputType === 'insertLineBreak') {
+        evt.preventDefault();
+        try {
+          navigateToCellBelow(lineNum, targetCellIndex, tableMetadata, ed, docManager);
+        } catch (e) { console.error(`${insertLogPrefix} Error navigating on line break:`, e); }
         return;
       }
 
-      // If we are in Android Chrome composition flow, suppress all insertText until composition ends
       if (suppressBeforeInputInsertTextDuringComposition && inputType === 'insertText') {
         evt.preventDefault();
         return;
       }
 
-      // If we already handled one insertion via composition handler, skip once (legacy single-shot)
       if (suppressNextBeforeInputInsertTextOnce && inputType === 'insertText') {
         suppressNextBeforeInputInsertTextOnce = false;
         evt.preventDefault();
         return;
       }
 
-      // If composition session is active, let composition handler manage
       if (isAndroidChromeComposition) return;
 
-      // Only proceed for textual insertions we can retrieve
       const rawData = evt.originalEvent && typeof evt.originalEvent.data === 'string' ? evt.originalEvent.data : '';
-      // If no data for this insert type, allow default (paste/drop paths are handled elsewhere)
       if (!rawData) return;
 
-      // Sanitize inserted text: remove our delimiter and zero-width characters
-      let insertedText = rawData
-        .replace(new RegExp(DELIMITER, 'g'), ' ')
-        .replace(/[\u200B\u200C\u200D\uFEFF]/g, '')
-        .replace(/\s+/g, ' ');
+      let insertedText = normalizeSoftWhitespace(
+        rawData
+          .replace(new RegExp(DELIMITER, 'g'), ' ')
+          .replace(/[\u200B\u200C\u200D\uFEFF]/g, '')
+          .replace(/\s+/g, ' ')
+      );
 
       if (insertedText.length === 0) {
         evt.preventDefault();
         return;
       }
 
-      // Intercept the browser default and perform the edit via Ace APIs
       evt.preventDefault();
       evt.stopPropagation();
       if (typeof evt.stopImmediatePropagation === 'function') evt.stopImmediatePropagation();
 
       try {
-        // Defer to next tick to avoid racing with browser internal composition state
         setTimeout(() => {
           ed.ace_callWithAce((aceInstance) => {
             aceInstance.ace_fastIncorp(10);
@@ -2554,10 +2627,8 @@ exports.aceInitialized = (h, ctx) => {
             const freshSelStart = freshRep.selStart;
             const freshSelEnd = freshRep.selEnd;
 
-            // Replace selection with sanitized text
             aceInstance.ace_performDocumentReplaceRange(freshSelStart, freshSelEnd, insertedText);
 
-            // Re-apply cell attribute to the newly inserted text (clamped to line length)
             const repAfterReplace = aceInstance.ace_getRep();
             const freshLineIndex = freshSelStart[0];
             const freshLineEntry = repAfterReplace.lines.atIndex(freshLineIndex);
@@ -2571,7 +2642,6 @@ exports.aceInitialized = (h, ctx) => {
               );
             }
 
-            // Re-apply table metadata line attribute
             ed.ep_data_tables_applyMeta(
               freshLineIndex,
               tableMetadata.tblId,
@@ -2583,14 +2653,12 @@ exports.aceInitialized = (h, ctx) => {
               docManager
             );
 
-            // Move caret to end of inserted text and update last-click state
             const newCaretCol = endCol;
             const newCaretPos = [freshLineIndex, newCaretCol];
             aceInstance.ace_performSelectionChange(newCaretPos, newCaretPos, false);
             aceInstance.ace_fastIncorp(10);
 
             if (editor && editor.ep_data_tables_last_clicked && editor.ep_data_tables_last_clicked.tblId === tableMetadata.tblId) {
-              // Recompute cellStartCol for the fresh line to avoid mismatches
               const freshLineText = (freshLineEntry && freshLineEntry.text) || '';
               const freshCells = freshLineText.split(DELIMITER);
               let freshOffset = 0;
@@ -2612,7 +2680,271 @@ exports.aceInitialized = (h, ctx) => {
       }
     });
 
-    // Composition start marker (Android Chrome/table only)
+    $inner.on('beforeinput', (evt) => {
+      const genericLogPrefix = '[ep_data_tables:beforeinputInsertTextGeneric]';
+      const inputType = (evt.originalEvent && evt.originalEvent.inputType) || '';
+      if (!inputType || !inputType.startsWith('insert')) return;
+
+      if (evt._epDataTablesNormalized || (evt.originalEvent && evt.originalEvent._epDataTablesNormalized)) return;
+      if (isAndroidUA() || isIOSUA()) return;
+
+      const rep = ed.ace_getRep();
+      if (!rep || !rep.selStart) return;
+      const selStart = rep.selStart;
+      const selEnd = rep.selEnd;
+      const lineNum = selStart[0];
+
+      let lineAttrString = docManager.getAttributeOnLine(lineNum, ATTR_TABLE_JSON);
+      let tableMetadata = null;
+      if (lineAttrString) {
+        try { tableMetadata = JSON.parse(lineAttrString); } catch (_) {}
+      }
+      if (!tableMetadata) tableMetadata = getTableLineMetadata(lineNum, ed, docManager);
+      if (!tableMetadata || typeof tableMetadata.cols !== 'number') return;
+      console.debug(`${genericLogPrefix} event`, { inputType, data: evt.originalEvent && evt.originalEvent.data });
+
+      const rawData = evt.originalEvent && typeof evt.originalEvent.data === 'string' ? evt.originalEvent.data : ' ';
+
+      const insertedText = normalizeSoftWhitespace(
+        rawData
+          .replace(/[\u00A0\r\n\t]/g, ' ') // NBSP sanitized back to space for stability
+          .replace(new RegExp(DELIMITER, 'g'), ' ')
+          .replace(/[\u200B\u200C\u200D\uFEFF]/g, '')
+          .replace(/\s+/g, ' ')
+      );
+
+      if (!insertedText) { evt.preventDefault(); return; }
+
+      const lineText = rep.lines.atIndex(lineNum)?.text || '';
+      const cells = lineText.split(DELIMITER);
+      let currentOffset = 0;
+      let targetCellIndex = -1;
+      let cellStartCol = 0;
+      let cellEndCol = 0;
+      for (let i = 0; i < cells.length; i++) {
+        const len = cells[i]?.length ?? 0;
+        const end = currentOffset + len;
+        if (selStart[1] >= currentOffset && selStart[1] <= end) {
+          targetCellIndex = i;
+          cellStartCol = currentOffset;
+          cellEndCol = end;
+          break;
+        }
+        currentOffset += len + DELIMITER.length;
+      }
+      if (targetCellIndex === -1 || selEnd[1] > cellEndCol) { evt.preventDefault(); console.debug(`${genericLogPrefix} abort: selection outside cell`, { selStart, selEnd, cellStartCol, cellEndCol }); return; }
+
+      evt.preventDefault();
+      evt.stopPropagation();
+      if (typeof evt.stopImmediatePropagation === 'function') evt.stopImmediatePropagation();
+
+      try {
+        ed.ace_callWithAce((ace) => {
+          ace.ace_fastIncorp(10);
+          const freshRep = ace.ace_getRep();
+          const freshSelStart = freshRep.selStart;
+          const freshSelEnd = freshRep.selEnd;
+
+          ace.ace_performDocumentReplaceRange(freshSelStart, freshSelEnd, insertedText);
+
+          const afterRep = ace.ace_getRep();
+          const lineEntry = afterRep.lines.atIndex(lineNum);
+          const maxLen = lineEntry ? lineEntry.text.length : 0;
+          const startCol = Math.min(Math.max(freshSelStart[1], 0), maxLen);
+          const endCol = Math.min(startCol + insertedText.length, maxLen);
+          if (endCol > startCol) {
+            ace.ace_performDocumentApplyAttributesToRange([lineNum, startCol], [lineNum, endCol], [[ATTR_CELL, String(targetCellIndex)]]);
+          }
+
+          ed.ep_data_tables_applyMeta(lineNum, tableMetadata.tblId, tableMetadata.row, tableMetadata.cols, afterRep, ed, null, docManager);
+
+          const newCaretPos = [lineNum, endCol];
+          ace.ace_performSelectionChange(newCaretPos, newCaretPos, false);
+        }, 'tableGenericInsertText', true);
+      } catch (e) {
+        console.error(`${genericLogPrefix} ERROR handling generic insertText:`, e);
+      }
+    });
+
+    $inner.on('beforeinput', (evt) => {
+      const autoLogPrefix = '[ep_data_tables:beforeinputAutoReplaceHandler]';
+      const inputType = (evt.originalEvent && evt.originalEvent.inputType) || '';
+
+      if ((evt && evt._epDataTablesHandled) || (evt.originalEvent && evt.originalEvent._epDataTablesHandled)) return;
+
+      if (!isIOSUA()) return;
+
+      const rep = ed.ace_getRep();
+      if (!rep || !rep.selStart) return;
+      const selStart = rep.selStart;
+      const selEnd = rep.selEnd;
+      const lineNum = selStart[0];
+
+      const dataStr = (evt.originalEvent && typeof evt.originalEvent.data === 'string') ? evt.originalEvent.data : '';
+      const hasSelection = !(selStart[0] === selEnd[0] && selStart[1] === selEnd[1]);
+      const looksLikeIOSAutoReplace = inputType === 'insertText' && dataStr.length > 1;
+      const insertTextNull = inputType === 'insertText' && dataStr === '' && !hasSelection;
+      const shouldHandle = INPUTTYPE_REPLACEMENT_TYPES.has(inputType) || looksLikeIOSAutoReplace || (inputType === 'insertText' && (hasSelection || insertTextNull));
+      if (!shouldHandle) return;
+
+      let lineAttrString = docManager.getAttributeOnLine(lineNum, ATTR_TABLE_JSON);
+      let tableMetadata = null;
+      if (lineAttrString) {
+        try { tableMetadata = JSON.parse(lineAttrString); } catch (_) {}
+      }
+      if (!tableMetadata) tableMetadata = getTableLineMetadata(lineNum, ed, docManager);
+      if (!tableMetadata || typeof tableMetadata.cols !== 'number' || typeof tableMetadata.tblId === 'undefined' || typeof tableMetadata.row === 'undefined') {
+        return;
+      }
+
+      const lineText = rep.lines.atIndex(lineNum)?.text || '';
+      const cells = lineText.split(DELIMITER);
+      let currentOffset = 0;
+      let targetCellIndex = -1;
+      let cellStartCol = 0;
+      let cellEndCol = 0;
+      for (let i = 0; i < cells.length; i++) {
+        const cellLength = cells[i]?.length ?? 0;
+        const cellEndColThisIteration = currentOffset + cellLength;
+        if (selStart[1] >= currentOffset && selStart[1] <= cellEndColThisIteration) {
+          targetCellIndex = i;
+          cellStartCol = currentOffset;
+          cellEndCol = cellEndColThisIteration;
+          break;
+        }
+        currentOffset += cellLength + DELIMITER.length;
+      }
+
+      if (targetCellIndex !== -1 && selEnd[1] === cellEndCol + DELIMITER.length) {
+        selEnd[1] = cellEndCol;
+      }
+
+      if (targetCellIndex === -1 || selEnd[1] > cellEndCol) {
+        evt.preventDefault();
+        return;
+      }
+
+      let insertedText = dataStr;
+      if (!insertedText) {
+        if (insertTextNull) {
+          evt.preventDefault();
+          evt.stopPropagation();
+          if (typeof evt.stopImmediatePropagation === 'function') evt.stopImmediatePropagation();
+
+          setTimeout(() => {
+            try {
+              ed.ace_callWithAce((aceInstance) => {
+                aceInstance.ace_fastIncorp(10);
+                const freshRep = aceInstance.ace_getRep();
+                const freshSelStart = freshRep.selStart;
+                const freshSelEnd = freshRep.selEnd;
+                aceInstance.ace_performDocumentReplaceRange(freshSelStart, freshSelEnd, ' ');
+
+                const afterRep = aceInstance.ace_getRep();
+                const maxLen = Math.max(0, afterRep.lines.atIndex(lineNum)?.text?.length || 0);
+                const startCol = Math.min(Math.max(freshSelStart[1], 0), maxLen);
+                const endCol = Math.min(startCol + 1, maxLen);
+                if (endCol > startCol) {
+                  aceInstance.ace_performDocumentApplyAttributesToRange(
+                    [lineNum, startCol], [lineNum, endCol], [[ATTR_CELL, String(targetCellIndex)]]
+                  );
+                }
+
+                ed.ep_data_tables_applyMeta(
+                  lineNum, tableMetadata.tblId, tableMetadata.row, tableMetadata.cols,
+                  afterRep, ed, null, docManager
+                );
+
+                const newCaretPos = [lineNum, endCol];
+                aceInstance.ace_performSelectionChange(newCaretPos, newCaretPos, false);
+                aceInstance.ace_fastIncorp(10);
+              }, 'iosPredictiveCommit', true);
+            } catch (e) {
+              console.error(`${autoLogPrefix} ERROR fixing predictive commit:`, e);
+            }
+          }, 0);
+          return;
+        } else {
+          if (INPUTTYPE_REPLACEMENT_TYPES.has(inputType) || hasSelection) {
+            evt.preventDefault();
+            evt.stopPropagation();
+            if (typeof evt.stopImmediatePropagation === 'function') evt.stopImmediatePropagation();
+          }
+          return;
+        }
+      }
+
+      insertedText = normalizeSoftWhitespace(
+        insertedText
+          .replace(new RegExp(DELIMITER, 'g'), ' ')
+          .replace(/[\u200B\u200C\u200D\uFEFF]/g, '')
+      );
+
+      evt.preventDefault();
+      evt.stopPropagation();
+      if (typeof evt.stopImmediatePropagation === 'function') evt.stopImmediatePropagation();
+
+      try {
+        setTimeout(() => {
+          ed.ace_callWithAce((aceInstance) => {
+            aceInstance.ace_fastIncorp(10);
+            const freshRep = aceInstance.ace_getRep();
+            const freshSelStart = freshRep.selStart;
+            const freshSelEnd = freshRep.selEnd;
+
+            aceInstance.ace_performDocumentReplaceRange(freshSelStart, freshSelEnd, insertedText);
+
+            const repAfterReplace = aceInstance.ace_getRep();
+            const freshLineIndex = freshSelStart[0];
+            const freshLineEntry = repAfterReplace.lines.atIndex(freshLineIndex);
+            const maxLen = Math.max(0, (freshLineEntry && freshLineEntry.text) ? freshLineEntry.text.length : 0);
+            const startCol = Math.min(Math.max(freshSelStart[1], 0), maxLen);
+            const endColRaw = startCol + insertedText.length;
+            const endCol = Math.min(endColRaw, maxLen);
+            if (endCol > startCol) {
+              aceInstance.ace_performDocumentApplyAttributesToRange(
+                [freshLineIndex, startCol], [freshLineIndex, endCol], [[ATTR_CELL, String(targetCellIndex)]]
+              );
+            }
+
+            ed.ep_data_tables_applyMeta(
+              freshLineIndex,
+              tableMetadata.tblId,
+              tableMetadata.row,
+              tableMetadata.cols,
+              repAfterReplace,
+              ed,
+              null,
+              docManager
+            );
+
+            const newCaretCol = endCol;
+            const newCaretPos = [freshLineIndex, newCaretCol];
+            aceInstance.ace_performSelectionChange(newCaretPos, newCaretPos, false);
+            aceInstance.ace_fastIncorp(10);
+
+            if (editor && editor.ep_data_tables_last_clicked && editor.ep_data_tables_last_clicked.tblId === tableMetadata.tblId) {
+              const freshLineText = (freshLineEntry && freshLineEntry.text) || '';
+              const freshCells = freshLineText.split(DELIMITER);
+              let freshOffset = 0;
+              for (let i = 0; i < targetCellIndex; i++) {
+                freshOffset += (freshCells[i]?.length ?? 0) + DELIMITER.length;
+              }
+              const newRelativePos = newCaretCol - freshOffset;
+              editor.ep_data_tables_last_clicked = {
+                lineNum: freshLineIndex,
+                tblId: tableMetadata.tblId,
+                cellIndex: targetCellIndex,
+                relativePos: newRelativePos < 0 ? 0 : newRelativePos,
+              };
+            }
+          }, 'tableAutoReplaceTextOperations', true);
+        }, 0);
+      } catch (error) {
+        console.error(`${autoLogPrefix} ERROR during auto-replace handling:`, error);
+      }
+    });
+
     $inner.on('compositionstart', (evt) => {
       if (!isAndroidUA()) return;
       const rep = ed.ace_getRep();
@@ -2626,8 +2958,6 @@ exports.aceInitialized = (h, ctx) => {
       handledCurrentComposition = false;
       suppressBeforeInputInsertTextDuringComposition = false;
     });
-
-    // Android Chrome composition handling for whitespace (space) to prevent DOM mutation breaking delimiters
     $inner.on('compositionupdate', (evt) => {
       const compLogPrefix = '[ep_data_tables:compositionHandler]';
 
@@ -2639,20 +2969,17 @@ exports.aceInitialized = (h, ctx) => {
       const selEnd = rep.selEnd;
       const lineNum = selStart[0];
 
-      // Ensure we are inside a table line
       let lineAttrString = docManager.getAttributeOnLine(lineNum, ATTR_TABLE_JSON);
       let tableMetadata = null;
       if (lineAttrString) { try { tableMetadata = JSON.parse(lineAttrString); } catch (_) {} }
       if (!tableMetadata) tableMetadata = getTableLineMetadata(lineNum, ed, docManager);
       if (!tableMetadata || typeof tableMetadata.cols !== 'number') return;
 
-      // Only act on whitespace-only composition updates (space/non-breaking space)
       const d = evt.originalEvent && typeof evt.originalEvent.data === 'string' ? evt.originalEvent.data : '';
       if (evt.type === 'compositionupdate') {
-        const isWhitespaceOnly = d && d.replace(/\u00A0/g, ' ').trim() === '';
+        const isWhitespaceOnly = d && normalizeSoftWhitespace(d).trim() === '';
         if (!isWhitespaceOnly) return;
 
-        // Compute target cell and clamp selection to cell boundaries
         const lineText = rep.lines.atIndex(lineNum)?.text || '';
         const cells = lineText.split(DELIMITER);
         let currentOffset = 0;
@@ -2672,12 +2999,13 @@ exports.aceInitialized = (h, ctx) => {
         }
         if (targetCellIndex === -1 || selEnd[1] > cellEndCol) return;
 
-        // Prevent composition DOM mutation and insert sanitized space via Ace
         evt.preventDefault();
         evt.stopPropagation();
         if (typeof evt.stopImmediatePropagation === 'function') evt.stopImmediatePropagation();
 
-        let insertedText = d.replace(/\u00A0/g, ' ');
+        let insertedText = d
+          .replace(/[\u00A0\r\n\t]/g, ' ')
+          .replace(/\s+/g, ' ');
         if (insertedText.length === 0) insertedText = ' ';
 
         try {
@@ -2689,7 +3017,6 @@ exports.aceInitialized = (h, ctx) => {
               const freshSelEnd = freshRep.selEnd;
               aceInstance.ace_performDocumentReplaceRange(freshSelStart, freshSelEnd, insertedText);
 
-              // Clamp attribute application to current line bounds and use fresh line index
               const repAfterReplace = aceInstance.ace_getRep();
               const freshLineIndex = freshSelStart[0];
               const freshLineEntry = repAfterReplace.lines.atIndex(freshLineIndex);
@@ -2719,7 +3046,6 @@ exports.aceInitialized = (h, ctx) => {
               aceInstance.ace_performSelectionChange(newCaretPos, newCaretPos, false);
               aceInstance.ace_fastIncorp(10);
               if (editor && editor.ep_data_tables_last_clicked && editor.ep_data_tables_last_clicked.tblId === tableMetadata.tblId) {
-                // Recompute cellStartCol for fresh line
                 const freshLineText = (freshLineEntry && freshLineEntry.text) || '';
                 const freshCells = freshLineText.split(DELIMITER);
                 let freshOffset = 0;
@@ -2736,7 +3062,6 @@ exports.aceInitialized = (h, ctx) => {
               }
             }, 'tableCompositionSpaceInsert', true);
           }, 0);
-          // Suppress all subsequent beforeinput insertText events in this composition session
           suppressBeforeInputInsertTextDuringComposition = true;
         } catch (error) {
           console.error(`${compLogPrefix} ERROR inserting space during composition:`, error);
@@ -2744,7 +3069,6 @@ exports.aceInitialized = (h, ctx) => {
       }
     });
 
-    // Composition end cleanup
     $inner.on('compositionend', () => {
       if (isAndroidChromeComposition) {
         isAndroidChromeComposition = false;
@@ -2753,15 +3077,12 @@ exports.aceInitialized = (h, ctx) => {
       }
     });
 
-    // *** DRAG AND DROP EVENT LISTENERS ***
    // log(`${callWithAceLogPrefix} Attaching drag and drop event listeners to $inner (inner iframe body).`);
-    
-    // Prevent drops that could damage table structure
+
     $inner.on('drop', (evt) => {
       const dropLogPrefix = '[ep_data_tables:dropHandler]';
      // log(`${dropLogPrefix} DROP EVENT TRIGGERED. Event object:`, evt);
 
-      // Block drops directly targeted at a table element regardless of selection state
       const targetEl = evt.target;
       if (targetEl && typeof targetEl.closest === 'function' && targetEl.closest('table.dataTable')) {
         evt.preventDefault();
@@ -2777,14 +3098,13 @@ exports.aceInitialized = (h, ctx) => {
       const rep = ed.ace_getRep();
       if (!rep || !rep.selStart) {
        // log(`${dropLogPrefix} WARNING: Could not get representation or selection. Allowing default drop.`);
-        return; // Allow default
+        return;
       }
 
       const selStart = rep.selStart;
       const lineNum = selStart[0];
      // log(`${dropLogPrefix} Current line number: ${lineNum}.`);
 
-      // Check if we're dropping onto a table line
      // log(`${dropLogPrefix} Checking if line ${lineNum} is a table line by fetching '${ATTR_TABLE_JSON}' attribute.`);
       let lineAttrString = docManager.getAttributeOnLine(lineNum, ATTR_TABLE_JSON);
       let isTableLine = !!lineAttrString;
@@ -2802,11 +3122,9 @@ exports.aceInitialized = (h, ctx) => {
       }
     });
 
-    // Also prevent dragover to ensure drop events are properly handled
     $inner.on('dragover', (evt) => {
       const dragLogPrefix = '[ep_data_tables:dragoverHandler]';
-      
-      // If hovering over a table, signal not-allowed and block default
+
       const targetEl = evt.target;
       if (targetEl && typeof targetEl.closest === 'function' && targetEl.closest('table.dataTable')) {
         if (evt.originalEvent && evt.originalEvent.dataTransfer) {
@@ -2819,13 +3137,12 @@ exports.aceInitialized = (h, ctx) => {
 
       const rep = ed.ace_getRep();
       if (!rep || !rep.selStart) {
-        return; // Allow default
+        return;
       }
 
       const selStart = rep.selStart;
       const lineNum = selStart[0];
 
-      // Check if we're dragging over a table line
      // log(`${dragLogPrefix} Checking if line ${lineNum} is a table line by fetching '${ATTR_TABLE_JSON}' attribute.`);
       let lineAttrString = docManager.getAttributeOnLine(lineNum, ATTR_TABLE_JSON);
       let isTableLine = !!lineAttrString;
@@ -2840,7 +3157,6 @@ exports.aceInitialized = (h, ctx) => {
       }
     });
 
-    // Guard against dragenter into table areas
     $inner.on('dragenter', (evt) => {
       const targetEl = evt.target;
       if (targetEl && typeof targetEl.closest === 'function' && targetEl.closest('table.dataTable')) {
@@ -2852,7 +3168,6 @@ exports.aceInitialized = (h, ctx) => {
       }
     });
 
-    // *** EXISTING PASTE LISTENER ***
    // log(`${callWithAceLogPrefix} Attaching paste event listener to $inner (inner iframe body).`);
     $inner.on('paste', (evt) => {
       const pasteLogPrefix = '[ep_data_tables:pasteHandler]';
@@ -2863,7 +3178,7 @@ exports.aceInitialized = (h, ctx) => {
       if (!rep || !rep.selStart) {
        // log(`${pasteLogPrefix} WARNING: Could not get representation or selection. Allowing default paste.`);
         console.warn(`${pasteLogPrefix} Could not get rep or selStart.`);
-        return; // Allow default
+        return;
       }
      // log(`${pasteLogPrefix} Rep obtained. selStart:`, rep.selStart, `selEnd:`, rep.selEnd);
       const selStart = rep.selStart;
@@ -2871,7 +3186,6 @@ exports.aceInitialized = (h, ctx) => {
       const lineNum = selStart[0];
      // log(`${pasteLogPrefix} Current line number: ${lineNum}. Column start: ${selStart[1]}, Column end: ${selEnd[1]}.`);
 
-      // NEW: Check if selection spans multiple lines
       if (selStart[0] !== selEnd[0]) {
        // log(`${pasteLogPrefix} WARNING: Selection spans multiple lines. Preventing paste to protect table structure.`);
         evt.preventDefault();
@@ -2883,7 +3197,6 @@ exports.aceInitialized = (h, ctx) => {
       let tableMetadata = null;
 
       if (!lineAttrString) {
-        // Block-styled row? Reconstruct metadata from the DOM.
        // log(`${pasteLogPrefix} No '${ATTR_TABLE_JSON}' attribute found. Checking if this is a block-styled table row via DOM reconstruction.`);
         const fallbackMeta = getTableLineMetadata(lineNum, ed, docManager);
         if (fallbackMeta) {
@@ -2895,7 +3208,7 @@ exports.aceInitialized = (h, ctx) => {
 
       if (!lineAttrString) {
        // log(`${pasteLogPrefix} Line ${lineNum} is NOT a table line (no '${ATTR_TABLE_JSON}' attribute found and no DOM reconstruction possible). Allowing default paste.`);
-        return; // Not a table line
+        return;
       }
      // log(`${pasteLogPrefix} Line ${lineNum} IS a table line. Attribute string: "${lineAttrString}".`);
 
@@ -2908,16 +3221,15 @@ exports.aceInitialized = (h, ctx) => {
         if (!tableMetadata || typeof tableMetadata.cols !== 'number' || typeof tableMetadata.tblId === 'undefined' || typeof tableMetadata.row === 'undefined') {
          // log(`${pasteLogPrefix} WARNING: Invalid or incomplete table metadata on line ${lineNum}. Allowing default paste. Metadata:`, tableMetadata);
           console.warn(`${pasteLogPrefix} Invalid table metadata for line ${lineNum}.`);
-          return; // Allow default
+          return;
         }
        // log(`${pasteLogPrefix} Table metadata validated successfully: tblId=${tableMetadata.tblId}, row=${tableMetadata.row}, cols=${tableMetadata.cols}.`);
       } catch(e) {
         console.error(`${pasteLogPrefix} ERROR parsing table metadata for line ${lineNum}:`, e);
        // log(`${pasteLogPrefix} Metadata parse error. Allowing default paste. Error details:`, { message: e.message, stack: e.stack });
-        return; // Allow default
+        return;
       }
 
-      // NEW: Validate selection is within cell boundaries
       const lineText = rep.lines.atIndex(lineNum)?.text || '';
       const cells = lineText.split(DELIMITER);
       let currentOffset = 0;
@@ -2928,7 +3240,7 @@ exports.aceInitialized = (h, ctx) => {
       for (let i = 0; i < cells.length; i++) {
         const cellLength = cells[i]?.length ?? 0;
         const cellEndColThisIteration = currentOffset + cellLength;
-        
+
         if (selStart[1] >= currentOffset && selStart[1] <= cellEndColThisIteration) {
           targetCellIndex = i;
           cellStartCol = currentOffset;
@@ -2941,7 +3253,7 @@ exports.aceInitialized = (h, ctx) => {
       /* allow "…cell content + delimiter" selections */
       if (targetCellIndex !== -1 &&
           selEnd[1] === cellEndCol + DELIMITER.length) {
-        selEnd[1] = cellEndCol;              // clamp
+        selEnd[1] = cellEndCol;
       }
       if (targetCellIndex === -1 || selEnd[1] > cellEndCol) {
        // log(`${pasteLogPrefix} WARNING: Selection spans cell boundaries or is outside cells. Preventing paste to protect table structure.`);
@@ -2953,28 +3265,26 @@ exports.aceInitialized = (h, ctx) => {
       const clipboardData = evt.originalEvent.clipboardData || window.clipboardData;
       if (!clipboardData) {
        // log(`${pasteLogPrefix} WARNING: No clipboard data found. Allowing default paste.`);
-        return; // Allow default
+        return;
       }
      // log(`${pasteLogPrefix} Clipboard data object obtained:`, clipboardData);
 
-      // Allow default handling (so ep_hyperlinked_text plugin can process) if rich HTML is present
       const types = clipboardData.types || [];
       if (types.includes('text/html') && clipboardData.getData('text/html')) {
        // log(`${pasteLogPrefix} Detected text/html in clipboard – deferring to other plugins and default paste.`);
-        return; // Do not intercept
+        return;
       }
 
      // log(`${pasteLogPrefix} Getting 'text/plain' from clipboard.`);
       const pastedTextRaw = clipboardData.getData('text/plain');
      // log(`${pasteLogPrefix} Pasted text raw: "${pastedTextRaw}" (Type: ${typeof pastedTextRaw})`);
 
-      // ENHANCED: More thorough sanitization of pasted content
       let pastedText = pastedTextRaw
-        .replace(/(\r\n|\n|\r)/gm, " ") // Replace newlines with space
-        .replace(new RegExp(DELIMITER, 'g'), ' ') // Strip our internal delimiter
-        .replace(/\t/g, " ") // Replace tabs with space
-        .replace(/\s+/g, " ") // Normalize whitespace
-        .trim(); // Trim leading/trailing whitespace
+        .replace(/(\r\n|\n|\r)/gm, " ")
+        .replace(new RegExp(DELIMITER, 'g'), ' ')
+        .replace(/\t/g, " ")
+        .replace(/\s+/g, " ")
+        .trim();
 
      // log(`${pasteLogPrefix} Pasted text after sanitization: "${pastedText}"`);
 
@@ -2985,20 +3295,14 @@ exports.aceInitialized = (h, ctx) => {
         if (types && types.includes('text/html')) {
            // log(`${pasteLogPrefix} Clipboard also contains HTML:`, clipboardData.getData('text/html'));
         }
-        return; // Allow default if no plain text
+        return;
       }
      // log(`${pasteLogPrefix} Plain text obtained from clipboard: "${pastedText}". Length: ${pastedText.length}.`);
 
-      // NEW: Check if paste would exceed cell boundaries
       const currentCellText = cells[targetCellIndex] || '';
       const selectionLength = selEnd[1] - selStart[1];
       const newCellLength = currentCellText.length - selectionLength + pastedText.length;
-      
-      // Soft safety-valve: Etherpad can technically handle very long lines but
-      // extremely large cells slow down rendering.  8 000 chars ≈ five classic
-      // 'Lorem Ipsum' paragraphs and feels like a reasonable upper bound while
-      // still letting users paste substantive text.  Increase/decrease as you
-      // see fit or set to `Infinity` to remove the cap entirely.
+
       const MAX_CELL_LENGTH = 8000;
       if (newCellLength > MAX_CELL_LENGTH) {
        // log(`${pasteLogPrefix} WARNING: Paste would exceed maximum cell length (${newCellLength} > ${MAX_CELL_LENGTH}). Truncating paste.`);
@@ -3014,8 +3318,6 @@ exports.aceInitialized = (h, ctx) => {
 
      // log(`${pasteLogPrefix} INTERCEPTING paste of plain text into table line ${lineNum}. PREVENTING DEFAULT browser action.`);
       evt.preventDefault();
-      // Prevent other plugins from handling the same paste event once we
-      // have intercepted it inside a table cell.
       evt.stopPropagation();
       if (typeof evt.stopImmediatePropagation === 'function') evt.stopImmediatePropagation();
 
@@ -3024,9 +3326,9 @@ exports.aceInitialized = (h, ctx) => {
         ed.ace_callWithAce((aceInstance) => {
             const callAceLogPrefix = `${pasteLogPrefix}[ace_callWithAceOps]`;
            // log(`${callAceLogPrefix} Entered ace_callWithAce for paste operations. selStart:`, selStart, `selEnd:`, selEnd);
-            
+
            // log(`${callAceLogPrefix} Original line text from initial rep: "${rep.lines.atIndex(lineNum).text}". SelStartCol: ${selStart[1]}, SelEndCol: ${selEnd[1]}.`);
-            
+
            // log(`${callAceLogPrefix} Calling aceInstance.ace_performDocumentReplaceRange to insert text: "${pastedText}".`);
             aceInstance.ace_performDocumentReplaceRange(selStart, selEnd, pastedText);
            // log(`${callAceLogPrefix} ace_performDocumentReplaceRange successful.`);
@@ -3034,7 +3336,7 @@ exports.aceInitialized = (h, ctx) => {
            // log(`${callAceLogPrefix} Preparing to re-apply tbljson attribute to line ${lineNum}.`);
             const repAfterReplace = aceInstance.ace_getRep();
            // log(`${callAceLogPrefix} Fetched rep after replace for applyMeta. Line ${lineNum} text now: "${repAfterReplace.lines.atIndex(lineNum).text}"`);
-            
+
             ed.ep_data_tables_applyMeta(
               lineNum,
               tableMetadata.tblId,
@@ -3052,12 +3354,11 @@ exports.aceInitialized = (h, ctx) => {
            // log(`${callAceLogPrefix} New calculated caret position: [${newCaretPos}]. Setting selection.`);
             aceInstance.ace_performSelectionChange(newCaretPos, newCaretPos, false);
            // log(`${callAceLogPrefix} Selection change successful.`);
-            
+
            // log(`${callAceLogPrefix} Requesting fastIncorp(10) for sync.`);
             aceInstance.ace_fastIncorp(10);
            // log(`${callAceLogPrefix} fastIncorp requested.`);
 
-            // Update stored click/caret info
             if (editor && editor.ep_data_tables_last_clicked && editor.ep_data_tables_last_clicked.tblId === tableMetadata.tblId) {
                const newRelativePos = newCaretCol - cellStartCol;
                editor.ep_data_tables_last_clicked = {
@@ -3081,63 +3382,57 @@ exports.aceInitialized = (h, ctx) => {
     });
    // log(`${callWithAceLogPrefix} Paste event listener attached.`);
 
-    // *** NEW: Column resize listeners ***
    // log(`${callWithAceLogPrefix} Attaching column resize listeners...`);
-    
-    // Get the iframe documents for proper event delegation
+
     const $iframeOuter = $('iframe[name="ace_outer"]');
     const $iframeInner = $iframeOuter.contents().find('iframe[name="ace_inner"]');
     const innerDoc = $iframeInner.contents();
     const outerDoc = $iframeOuter.contents();
-    
+
    // log(`${callWithAceLogPrefix} Found iframe documents: outer=${outerDoc.length}, inner=${innerDoc.length}`);
-    
-    // Mousedown on resize handles
+
     $inner.on('mousedown', '.ep-data_tables-resize-handle', (evt) => {
       const resizeLogPrefix = '[ep_data_tables:resizeMousedown]';
      // log(`${resizeLogPrefix} Resize handle mousedown detected`);
-      
-      // Only handle left mouse button clicks
+
       if (evt.button !== 0) {
        // log(`${resizeLogPrefix} Ignoring non-left mouse button: ${evt.button}`);
         return;
       }
-      
-      // Check if this is related to an image element to avoid conflicts
+
       const target = evt.target;
       const $target = $(target);
       const isImageRelated = $target.closest('.inline-image, .image-placeholder, .image-inner').length > 0;
       const isImageResizeHandle = $target.hasClass('image-resize-handle') || $target.closest('.image-resize-handle').length > 0;
-      
+
       if (isImageRelated || isImageResizeHandle) {
        // log(`${resizeLogPrefix} Click detected on image-related element or image resize handle, ignoring for table resize`);
         return;
       }
-      
+
       evt.preventDefault();
       evt.stopPropagation();
-      
+
       const handle = evt.target;
       const columnIndex = parseInt(handle.getAttribute('data-column'), 10);
       const table = handle.closest('table.dataTable');
       const lineNode = table.closest('div.ace-line');
-      
+
      // log(`${resizeLogPrefix} Parsed resize target: columnIndex=${columnIndex}, table=${!!table}, lineNode=${!!lineNode}`);
-      
+
       if (table && lineNode && !isNaN(columnIndex)) {
-        // Get table metadata
         const tblId = table.getAttribute('data-tblId');
         const rep = ed.ace_getRep();
-        
+
         if (!rep || !rep.lines) {
           console.error(`${resizeLogPrefix} Cannot get editor representation`);
           return;
         }
-        
+
         const lineNum = rep.lines.indexOfKey(lineNode.id);
-        
+
        // log(`${resizeLogPrefix} Table info: tblId=${tblId}, lineNum=${lineNum}`);
-        
+
         if (tblId && lineNum !== -1) {
           try {
             const lineAttrString = docManager.getAttributeOnLine(lineNum, 'tbljson');
@@ -3147,16 +3442,14 @@ exports.aceInitialized = (h, ctx) => {
                // log(`${resizeLogPrefix} Starting resize with metadata:`, metadata);
                 startColumnResize(table, columnIndex, evt.clientX, metadata, lineNum);
                // log(`${resizeLogPrefix} Started resize for column ${columnIndex}`);
-                
-                // DEBUG: Verify global state is set
+
                // log(`${resizeLogPrefix} Global resize state: isResizing=${isResizing}, targetTable=${!!resizeTargetTable}, targetColumn=${resizeTargetColumn}`);
               } else {
                // log(`${resizeLogPrefix} Table ID mismatch: ${metadata.tblId} vs ${tblId}`);
               }
             } else {
              // log(`${resizeLogPrefix} No table metadata found for line ${lineNum}, trying DOM reconstruction...`);
-              
-              // Fallback: Reconstruct metadata from DOM (same logic as ace_doDatatableOptions)
+
               const rep = ed.ace_getRep();
               if (rep && rep.lines) {
                 const lineEntry = rep.lines.atIndex(lineNum);
@@ -3168,7 +3461,6 @@ exports.aceInitialized = (h, ctx) => {
                     if (domTblId === tblId && domRow !== null) {
                       const domCells = tableInDOM.querySelectorAll('td');
                       if (domCells.length > 0) {
-                        // Extract column widths from DOM cells
                         const columnWidths = [];
                         domCells.forEach(cell => {
                           const style = cell.getAttribute('style') || '';
@@ -3176,12 +3468,10 @@ exports.aceInitialized = (h, ctx) => {
                           if (widthMatch) {
                             columnWidths.push(parseFloat(widthMatch[1]));
                           } else {
-                            // Fallback to equal distribution if no width found
                             columnWidths.push(100 / domCells.length);
                           }
                         });
-                        
-                        // Reconstruct metadata from DOM with preserved column widths
+
                         const reconstructedMetadata = {
                           tblId: domTblId,
                           row: parseInt(domRow, 10),
@@ -3189,11 +3479,10 @@ exports.aceInitialized = (h, ctx) => {
                           columnWidths: columnWidths
                         };
                        // log(`${resizeLogPrefix} Reconstructed metadata from DOM:`, reconstructedMetadata);
-                        
+
                         startColumnResize(table, columnIndex, evt.clientX, reconstructedMetadata, lineNum);
                        // log(`${resizeLogPrefix} Started resize for column ${columnIndex} using reconstructed metadata`);
-                        
-                        // DEBUG: Verify global state is set
+
                        // log(`${resizeLogPrefix} Global resize state: isResizing=${isResizing}, targetTable=${!!resizeTargetTable}, targetColumn=${resizeTargetColumn}`);
     } else {
                        // log(`${resizeLogPrefix} DOM table found but no cells detected`);
@@ -3221,30 +3510,26 @@ exports.aceInitialized = (h, ctx) => {
        // log(`${resizeLogPrefix} Invalid resize target:`, { table: !!table, lineNode: !!lineNode, columnIndex });
       }
     });
-    
-    // Enhanced mousemove and mouseup handlers - attach to multiple contexts for better coverage
+
     const setupGlobalHandlers = () => {
       const mouseupLogPrefix = '[ep_data_tables:resizeMouseup]';
       const mousemoveLogPrefix = '[ep_data_tables:resizeMousemove]';
-      
-      // Mousemove handler
+
       const handleMousemove = (evt) => {
         if (isResizing) {
           evt.preventDefault();
           updateColumnResize(evt.clientX);
         }
       };
-      
-      // Mouseup handler with enhanced debugging
+
       const handleMouseup = (evt) => {
        // log(`${mouseupLogPrefix} Mouseup detected on ${evt.target.tagName || 'unknown'}. isResizing: ${isResizing}`);
-        
+
         if (isResizing) {
          // log(`${mouseupLogPrefix} Processing resize completion...`);
           evt.preventDefault();
           evt.stopPropagation();
-          
-          // Add a small delay to ensure all DOM updates are complete
+
           setTimeout(() => {
            // log(`${mouseupLogPrefix} Executing finishColumnResize after delay...`);
             finishColumnResize(ed, docManager);
@@ -3254,59 +3539,50 @@ exports.aceInitialized = (h, ctx) => {
          // log(`${mouseupLogPrefix} Not in resize mode, ignoring mouseup.`);
         }
       };
-      
-      // Attach to multiple contexts to ensure we catch the event
+
      // log(`${callWithAceLogPrefix} Attaching global mousemove/mouseup handlers to multiple contexts...`);
-      
-      // 1. Main document (outside iframes)
+
       $(document).on('mousemove', handleMousemove);
       $(document).on('mouseup', handleMouseup);
      // log(`${callWithAceLogPrefix} Attached to main document`);
-      
-      // 2. Outer iframe document  
+
       if (outerDoc.length > 0) {
         outerDoc.on('mousemove', handleMousemove);
         outerDoc.on('mouseup', handleMouseup);
        // log(`${callWithAceLogPrefix} Attached to outer iframe document`);
       }
-      
-      // 3. Inner iframe document
+
       if (innerDoc.length > 0) {
         innerDoc.on('mousemove', handleMousemove);
         innerDoc.on('mouseup', handleMouseup);
        // log(`${callWithAceLogPrefix} Attached to inner iframe document`);
       }
-      
-      // 4. Inner iframe body (the editing area)
+
       $inner.on('mousemove', handleMousemove);
       $inner.on('mouseup', handleMouseup);
      // log(`${callWithAceLogPrefix} Attached to inner iframe body`);
-      
-      // 5. Add a failsafe - listen for any mouse events during resize
+
       const failsafeMouseup = (evt) => {
         if (isResizing) {
          // log(`${mouseupLogPrefix} FAILSAFE: Detected mouse event during resize: ${evt.type}`);
           if (evt.type === 'mouseup' || evt.type === 'mousedown' || evt.type === 'click') {
            // log(`${mouseupLogPrefix} FAILSAFE: Triggering resize completion due to ${evt.type}`);
             setTimeout(() => {
-              if (isResizing) { // Double-check we're still resizing
+              if (isResizing) {
                 finishColumnResize(ed, docManager);
               }
             }, 100);
           }
         }
       };
-      
-      // Attach failsafe to main document with capture=true to catch events early
+
       document.addEventListener('mouseup', failsafeMouseup, true);
       document.addEventListener('mousedown', failsafeMouseup, true);
       document.addEventListener('click', failsafeMouseup, true);
      // log(`${callWithAceLogPrefix} Attached failsafe event handlers`);
-      
-      // *** DRAG PREVENTION FOR TABLE ELEMENTS ***
+
       const preventTableDrag = (evt) => {
         const target = evt.target;
-        // Block ANY drag gesture that originates within a table (including spans/text inside cells)
         const inTable = target && typeof target.closest === 'function' && target.closest('table.dataTable');
         if (inTable) {
          // log('[ep_data_tables:dragPrevention] Preventing drag operation originating from inside table');
@@ -3318,14 +3594,12 @@ exports.aceInitialized = (h, ctx) => {
           return false;
         }
       };
-      
-      // Add drag event listeners to prevent table dragging
+
       $inner.on('dragstart', preventTableDrag);
       $inner.on('drag', preventTableDrag);
       $inner.on('dragend', preventTableDrag);
      // log(`${callWithAceLogPrefix} Attached drag prevention handlers to inner body`);
 
-      // Attach drag prevention broadly to cover iframe boundaries and the host document
       if (innerDoc.length > 0) {
         innerDoc.on('dragstart', preventTableDrag);
         innerDoc.on('drag', preventTableDrag);
@@ -3340,32 +3614,27 @@ exports.aceInitialized = (h, ctx) => {
       $(document).on('drag', preventTableDrag);
       $(document).on('dragend', preventTableDrag);
     };
-    
-    // Setup the global handlers
+
     setupGlobalHandlers();
-    
+
    // log(`${callWithAceLogPrefix} Column resize listeners attached successfully.`);
 
   }, 'tablePasteAndResizeListeners', true);
  // log(`${logPrefix} ace_callWithAce for listeners setup completed.`);
 
-  // Helper function to apply the metadata attribute to a line
   function applyTableLineMetadataAttribute (lineNum, tblId, rowIndex, numCols, rep, editorInfo, attributeString = null, documentAttributeManager = null) {
     const funcName = 'applyTableLineMetadataAttribute';
    // log(`${logPrefix}:${funcName}: START - Applying METADATA attribute to line ${lineNum}`, {tblId, rowIndex, numCols});
 
     let finalMetadata;
-    
-    // If attributeString is provided, check if it contains columnWidths
+
     if (attributeString) {
       try {
         const providedMetadata = JSON.parse(attributeString);
         if (providedMetadata.columnWidths && Array.isArray(providedMetadata.columnWidths) && providedMetadata.columnWidths.length === numCols) {
-          // Already has valid columnWidths, use as-is
           finalMetadata = providedMetadata;
          // log(`${logPrefix}:${funcName}: Using provided metadata with existing columnWidths`);
         } else {
-          // Has metadata but missing/invalid columnWidths, extract from DOM
           finalMetadata = providedMetadata;
          // log(`${logPrefix}:${funcName}: Provided metadata missing columnWidths, attempting DOM extraction`);
            }
@@ -3374,12 +3643,10 @@ exports.aceInitialized = (h, ctx) => {
         finalMetadata = null;
       }
     }
-    
-    // If we don't have complete metadata or need to extract columnWidths
+
     if (!finalMetadata || !finalMetadata.columnWidths) {
       let columnWidths = null;
-      
-      // Try to extract existing column widths from DOM if available
+
       try {
         const lineEntry = rep.lines.atIndex(lineNum);
         if (lineEntry && lineEntry.lineNode) {
@@ -3389,7 +3656,6 @@ exports.aceInitialized = (h, ctx) => {
             if (domTblId === tblId) {
               const domCells = tableInDOM.querySelectorAll('td');
               if (domCells.length === numCols) {
-                // Extract column widths from DOM cells
                 columnWidths = [];
                 domCells.forEach(cell => {
                   const style = cell.getAttribute('style') || '';
@@ -3397,7 +3663,6 @@ exports.aceInitialized = (h, ctx) => {
                   if (widthMatch) {
                     columnWidths.push(parseFloat(widthMatch[1]));
                   } else {
-                    // Fallback to equal distribution if no width found
                     columnWidths.push(100 / numCols);
                   }
                 });
@@ -3409,15 +3674,13 @@ exports.aceInitialized = (h, ctx) => {
            } catch (e) {
        // log(`${logPrefix}:${funcName}: Error extracting column widths from DOM:`, e);
       }
-      
-      // Build final metadata
+
       finalMetadata = finalMetadata || {
         tblId: tblId,
         row: rowIndex,
         cols: numCols
       };
-      
-      // Add column widths if we found them
+
       if (columnWidths && columnWidths.length === numCols) {
         finalMetadata.columnWidths = columnWidths;
       }
@@ -3425,9 +3688,8 @@ exports.aceInitialized = (h, ctx) => {
 
     const finalAttributeString = JSON.stringify(finalMetadata);
    // log(`${logPrefix}:${funcName}: Final metadata attribute string: ${finalAttributeString}`);
-    
+
     try {
-       // Get current line info
        const lineEntry = rep.lines.atIndex(lineNum);
        if (!lineEntry) {
           // log(`${logPrefix}:${funcName}: ERROR - Could not find line entry for line number ${lineNum}`);
@@ -3436,15 +3698,14 @@ exports.aceInitialized = (h, ctx) => {
        const lineLength = Math.max(1, lineEntry.text.length);
       // log(`${logPrefix}:${funcName}: Line ${lineNum} text length: ${lineLength}`);
 
-       // Simple attribute application - just add the tbljson attribute
        const attributes = [[ATTR_TABLE_JSON, finalAttributeString]];
        const start = [lineNum, 0];
        const end = [lineNum, lineLength];
-       
+
       // log(`${logPrefix}:${funcName}: Applying tbljson attribute to range [${start}]-[${end}]`);
        editorInfo.ace_performDocumentApplyAttributesToRange(start, end, attributes);
       // log(`${logPrefix}:${funcName}: Successfully applied tbljson attribute to line ${lineNum}`);
-        
+
     } catch(e) {
         console.error(`[ep_data_tables] ${logPrefix}:${funcName}: Error applying metadata attribute on line ${lineNum}:`, e);
     }
@@ -3457,16 +3718,14 @@ exports.aceInitialized = (h, ctx) => {
     rows = Math.max(1, rows); cols = Math.max(1, cols);
    // log(`${funcName}: Ensuring minimum 1 row, 1 col.`);
 
-    // --- Phase 1: Prepare Data --- 
     const tblId   = rand();
    // log(`${funcName}: Generated table ID: ${tblId}`);
-    const initialCellContent = ' '; // Start with a single space per cell
+    const initialCellContent = ' ';
     const lineTxt = Array.from({ length: cols }).fill(initialCellContent).join(DELIMITER);
    // log(`${funcName}: Constructed initial line text for ${cols} cols: "${lineTxt}"`);
     const block = Array.from({ length: rows }).fill(lineTxt).join('\n') + '\n';
    // log(`${funcName}: Constructed block for ${rows} rows:\n${block}`);
 
-    // Get current selection BEFORE making changes using ace_getRep()
    // log(`${funcName}: Getting current representation and selection...`);
     const currentRepInitial = ed.ace_getRep(); 
     if (!currentRepInitial || !currentRepInitial.selStart || !currentRepInitial.selEnd) {
@@ -3476,25 +3735,21 @@ exports.aceInitialized = (h, ctx) => {
     }
     const start = currentRepInitial.selStart;
     const end = currentRepInitial.selEnd;
-    const initialStartLine = start[0]; // Store the starting line number
+    const initialStartLine = start[0];
    // log(`${funcName}: Current selection from initial rep:`, { start, end });
 
-    // --- Phase 2: Insert Text Block --- 
    // log(`${funcName}: Phase 2 - Inserting text block...`);
     ed.ace_performDocumentReplaceRange(start, end, block);
    // log(`${funcName}: Inserted block of delimited text lines.`);
    // log(`${funcName}: Requesting text sync (ace_fastIncorp 20)...`);
-    ed.ace_fastIncorp(20); // Sync text insertion
+    ed.ace_fastIncorp(20);
    // log(`${funcName}: Text sync requested.`);
 
-    // --- Phase 3: Apply Metadata Attributes --- 
    // log(`${funcName}: Phase 3 - Applying metadata attributes to ${rows} inserted lines...`);
-    // Need rep to be updated after text insertion to apply attributes correctly
-    const currentRep = ed.ace_getRep(); // Get potentially updated rep
+    const currentRep = ed.ace_getRep();
     if (!currentRep || !currentRep.lines) {
         console.error(`[ep_data_tables] ${funcName}: Could not get updated rep after text insertion. Cannot apply attributes reliably.`);
        // log(`${funcName}: END - Error getting updated rep`);
-        // Maybe attempt to continue without rep? Risky.
         return; 
     }
    // log(`${funcName}: Fetched updated rep for attribute application.`);
@@ -3512,10 +3767,9 @@ exports.aceInitialized = (h, ctx) => {
       const cells = lineText.split(DELIMITER);
       let offset = 0;
 
-      // Apply cell-specific attributes to trigger authorship span splitting
       for (let c = 0; c < cols; c++) {
         const cellContent = (c < cells.length) ? cells[c] || '' : '';
-        if (cellContent.length > 0) { // Only apply to non-empty cells
+        if (cellContent.length > 0) {
           const cellStart = [lineNumToApply, offset];
           const cellEnd = [lineNumToApply, offset + cellContent.length];
          // log(`${funcName}: Applying ${ATTR_CELL} attribute to Line ${lineNumToApply} Col ${c} Range ${offset}-${offset + cellContent.length}`);
@@ -3527,18 +3781,15 @@ exports.aceInitialized = (h, ctx) => {
         }
       }
 
-      // Call the module-level helper, passing necessary context (currentRep, ed)
-      // Note: documentAttributeManager not available in this context for new table creation
       applyTableLineMetadataAttribute(lineNumToApply, tblId, r, cols, currentRep, ed, null, null); 
     }
    // log(`${funcName}: Finished applying metadata attributes.`);
    // log(`${funcName}: Requesting attribute sync (ace_fastIncorp 20)...`);
-    ed.ace_fastIncorp(20); // Final sync after attributes
+    ed.ace_fastIncorp(20);
    // log(`${funcName}: Attribute sync requested.`);
 
-    // --- Phase 4: Set Caret Position --- 
    // log(`${funcName}: Phase 4 - Setting final caret position...`);
-    const finalCaretLine = initialStartLine + rows; // Line number after the last inserted row
+    const finalCaretLine = initialStartLine + rows;
     const finalCaretPos = [finalCaretLine, 0];
    // log(`${funcName}: Target caret position:`, finalCaretPos);
     try {
@@ -3555,50 +3806,44 @@ exports.aceInitialized = (h, ctx) => {
   ed.ace_doDatatableOptions = (action) => {
     const funcName = 'ace_doDatatableOptions';
    // log(`${funcName}: START - Processing action: ${action}`);
-    
-    // Get the last clicked cell info to determine which table to operate on
+
     const editor = ed.ep_data_tables_editor;
     if (!editor) {
       console.error(`[ep_data_tables] ${funcName}: Could not get editor reference.`);
       return;
     }
-    
+
     const lastClick = editor.ep_data_tables_last_clicked;
     if (!lastClick || !lastClick.tblId) {
      // log(`${funcName}: No table selected. Please click on a table cell first.`);
       console.warn('[ep_data_tables] No table selected. Please click on a table cell first.');
       return;
     }
-    
+
    // log(`${funcName}: Operating on table ${lastClick.tblId}, clicked line ${lastClick.lineNum}, cell ${lastClick.cellIndex}`);
-    
+
     try {
-      // Get current representation and document manager
       const currentRep = ed.ace_getRep();
       if (!currentRep || !currentRep.lines) {
         console.error(`[ep_data_tables] ${funcName}: Could not get current representation.`);
         return;
       }
-      
-      // Use the stored documentAttributeManager reference
+
       const docManager = ed.ep_data_tables_docManager;
       if (!docManager) {
         console.error(`[ep_data_tables] ${funcName}: Could not get document attribute manager from stored reference.`);
         return;
       }
-      
+
      // log(`${funcName}: Successfully obtained documentAttributeManager from stored reference.`);
-      
-      // Find all lines that belong to this table
+
       const tableLines = [];
       const totalLines = currentRep.lines.length();
-      
+
       for (let lineIndex = 0; lineIndex < totalLines; lineIndex++) {
         try {
-          // Use the same robust approach as acePostWriteDomLineHTML to find nested tables
           let lineAttrString = docManager.getAttributeOnLine(lineIndex, ATTR_TABLE_JSON);
-          
-          // If no attribute found directly, check if there's a table in the DOM even though attribute is missing
+
           if (!lineAttrString) {
             const lineEntry = currentRep.lines.atIndex(lineIndex);
             if (lineEntry && lineEntry.lineNode) {
@@ -3609,7 +3854,6 @@ exports.aceInitialized = (h, ctx) => {
                 if (domTblId && domRow !== null) {
                   const domCells = tableInDOM.querySelectorAll('td');
                   if (domCells.length > 0) {
-                    // Reconstruct metadata from DOM
                     const reconstructedMetadata = {
                       tblId: domTblId,
                       row: parseInt(domRow, 10),
@@ -3622,7 +3866,7 @@ exports.aceInitialized = (h, ctx) => {
               }
             }
           }
-          
+
           if (lineAttrString) {
             const lineMetadata = JSON.parse(lineAttrString);
             if (lineMetadata.tblId === lastClick.tblId) {
@@ -3642,27 +3886,22 @@ exports.aceInitialized = (h, ctx) => {
           continue;
         }
       }
-      
+
       if (tableLines.length === 0) {
        // log(`${funcName}: No table lines found for table ${lastClick.tblId}`);
         return;
       }
-      
-      // Sort by row number to ensure correct order
+
       tableLines.sort((a, b) => a.row - b.row);
      // log(`${funcName}: Found ${tableLines.length} table lines`);
-      
-      // Determine table dimensions and target indices with robust matching
+
       const numRows = tableLines.length;
       const numCols = tableLines[0].cols;
-      
-      // More robust way to find the target row - match by both line number AND row metadata
+
       let targetRowIndex = -1;
-      
-      // First try to match by line number
+
       targetRowIndex = tableLines.findIndex(line => line.lineIndex === lastClick.lineNum);
-      
-      // If that fails, try to match by finding the row that contains the clicked table
+
       if (targetRowIndex === -1) {
        // log(`${funcName}: Direct line number match failed, searching by DOM structure...`);
         const clickedLineEntry = currentRep.lines.atIndex(lastClick.lineNum);
@@ -3678,46 +3917,43 @@ exports.aceInitialized = (h, ctx) => {
           }
         }
       }
-      
-      // If still not found, default to first row but log the issue
+
       if (targetRowIndex === -1) {
        // log(`${funcName}: Warning: Could not find target row, defaulting to row 0`);
         targetRowIndex = 0;
       }
-      
+
       const targetColIndex = lastClick.cellIndex || 0;
-      
+
      // log(`${funcName}: Table dimensions: ${numRows} rows x ${numCols} cols. Target: row ${targetRowIndex}, col ${targetColIndex}`);
-      
-      // Perform table operations with both text and metadata updates
+
       let newNumCols = numCols;
       let success = false;
-      
+
       switch (action) {
-        case 'addTblRowA': // Insert row above
+        case 'addTblRowA':
          // log(`${funcName}: Inserting row above row ${targetRowIndex}`);
           success = addTableRowAboveWithText(tableLines, targetRowIndex, numCols, lastClick.tblId, ed, docManager);
           break;
-          
-        case 'addTblRowB': // Insert row below
+
+        case 'addTblRowB':
          // log(`${funcName}: Inserting row below row ${targetRowIndex}`);
           success = addTableRowBelowWithText(tableLines, targetRowIndex, numCols, lastClick.tblId, ed, docManager);
           break;
-          
-        case 'addTblColL': // Insert column left
+
+        case 'addTblColL':
          // log(`${funcName}: Inserting column left of column ${targetColIndex}`);
           newNumCols = numCols + 1;
           success = addTableColumnLeftWithText(tableLines, targetColIndex, ed, docManager);
           break;
-          
-        case 'addTblColR': // Insert column right
+
+        case 'addTblColR':
          // log(`${funcName}: Inserting column right of column ${targetColIndex}`);
           newNumCols = numCols + 1;
           success = addTableColumnRightWithText(tableLines, targetColIndex, ed, docManager);
           break;
-          
-        case 'delTblRow': // Delete row
-          // Show confirmation prompt for row deletion
+
+        case 'delTblRow':
           const rowConfirmMessage = `Are you sure you want to delete Row ${targetRowIndex + 1} and all content within?`;
           if (!confirm(rowConfirmMessage)) {
            // log(`${funcName}: Row deletion cancelled by user`);
@@ -3726,9 +3962,8 @@ exports.aceInitialized = (h, ctx) => {
          // log(`${funcName}: Deleting row ${targetRowIndex}`);
           success = deleteTableRowWithText(tableLines, targetRowIndex, ed, docManager);
           break;
-          
-        case 'delTblCol': // Delete column
-          // Show confirmation prompt for column deletion
+
+        case 'delTblCol':
           const colConfirmMessage = `Are you sure you want to delete Column ${targetColIndex + 1} and all content within?`;
           if (!confirm(colConfirmMessage)) {
            // log(`${funcName}: Column deletion cancelled by user`);
@@ -3738,36 +3973,33 @@ exports.aceInitialized = (h, ctx) => {
           newNumCols = numCols - 1;
           success = deleteTableColumnWithText(tableLines, targetColIndex, ed, docManager);
           break;
-          
+
         default:
          // log(`${funcName}: Unknown action: ${action}`);
           return;
       }
-      
+
       if (!success) {
         console.error(`[ep_data_tables] ${funcName}: Table operation failed for action: ${action}`);
         return;
       }
-      
+
      // log(`${funcName}: Table operation completed successfully with text and metadata synchronization`);
-      
+
     } catch (error) {
       console.error(`[ep_data_tables] ${funcName}: Error during table operation:`, error);
      // log(`${funcName}: Error details:`, { message: error.message, stack: error.stack });
     }
   };
 
-  // Helper functions for table operations with text updates
   function addTableRowAboveWithText(tableLines, targetRowIndex, numCols, tblId, editorInfo, docManager) {
     try {
       const targetLine = tableLines[targetRowIndex];
       const newLineText = Array.from({ length: numCols }).fill(' ').join(DELIMITER);
       const insertLineIndex = targetLine.lineIndex;
-      
-      // Insert new line in text
+
       editorInfo.ace_performDocumentReplaceRange([insertLineIndex, 0], [insertLineIndex, 0], newLineText + '\n');
-      
-      // Apply cell-specific attributes to the new row for authorship
+
       const rep = editorInfo.ace_getRep();
       const cells = newLineText.split(DELIMITER);
       let offset = 0;
@@ -3783,14 +4015,12 @@ exports.aceInitialized = (h, ctx) => {
           offset += DELIMITER.length;
         }
       }
-      
-      // Preserve column widths from existing metadata or extract from DOM
+
       let columnWidths = targetLine.metadata.columnWidths;
       if (!columnWidths) {
-        // Extract from DOM for block-styled rows
         try {
           const rep = editorInfo.ace_getRep();
-          const lineEntry = rep.lines.atIndex(targetLine.lineIndex + 1); // +1 because we inserted a line
+          const lineEntry = rep.lines.atIndex(targetLine.lineIndex + 1);
           if (lineEntry && lineEntry.lineNode) {
             const tableInDOM = lineEntry.lineNode.querySelector(`table.dataTable[data-tblId="${tblId}"]`);
             if (tableInDOM) {
@@ -3814,20 +4044,18 @@ exports.aceInitialized = (h, ctx) => {
           console.error('[ep_data_tables] addTableRowAbove: Error extracting column widths from DOM:', e);
         }
       }
-      
-      // Update metadata for all subsequent rows
+
       for (let i = targetRowIndex; i < tableLines.length; i++) {
-        const lineToUpdate = tableLines[i].lineIndex + 1; // +1 because we inserted a line
+        const lineToUpdate = tableLines[i].lineIndex + 1;
         const newRowIndex = tableLines[i].metadata.row + 1;
         const newMetadata = { ...tableLines[i].metadata, row: newRowIndex, columnWidths };
-        
+
         applyTableLineMetadataAttribute(lineToUpdate, tblId, newRowIndex, numCols, editorInfo.ace_getRep(), editorInfo, JSON.stringify(newMetadata), docManager);
       }
-      
-      // Apply metadata to the new row
+
       const newMetadata = { tblId, row: targetLine.metadata.row, cols: numCols, columnWidths };
       applyTableLineMetadataAttribute(insertLineIndex, tblId, targetLine.metadata.row, numCols, editorInfo.ace_getRep(), editorInfo, JSON.stringify(newMetadata), docManager);
-      
+
       editorInfo.ace_fastIncorp(10);
       return true;
     } catch (e) {
@@ -3835,17 +4063,15 @@ exports.aceInitialized = (h, ctx) => {
       return false;
     }
   }
-  
+
   function addTableRowBelowWithText(tableLines, targetRowIndex, numCols, tblId, editorInfo, docManager) {
     try {
       const targetLine = tableLines[targetRowIndex];
       const newLineText = Array.from({ length: numCols }).fill(' ').join(DELIMITER);
       const insertLineIndex = targetLine.lineIndex + 1;
-      
-      // Insert new line in text
+
       editorInfo.ace_performDocumentReplaceRange([insertLineIndex, 0], [insertLineIndex, 0], newLineText + '\n');
-      
-      // Apply cell-specific attributes to the new row for authorship
+
       const rep = editorInfo.ace_getRep();
       const cells = newLineText.split(DELIMITER);
       let offset = 0;
@@ -3861,11 +4087,9 @@ exports.aceInitialized = (h, ctx) => {
           offset += DELIMITER.length;
         }
       }
-      
-      // Preserve column widths from existing metadata or extract from DOM
+
       let columnWidths = targetLine.metadata.columnWidths;
       if (!columnWidths) {
-        // Extract from DOM for block-styled rows
         try {
           const rep = editorInfo.ace_getRep();
           const lineEntry = rep.lines.atIndex(targetLine.lineIndex);
@@ -3892,20 +4116,18 @@ exports.aceInitialized = (h, ctx) => {
           console.error('[ep_data_tables] addTableRowBelow: Error extracting column widths from DOM:', e);
         }
       }
-      
-      // Update metadata for all subsequent rows
+
       for (let i = targetRowIndex + 1; i < tableLines.length; i++) {
-        const lineToUpdate = tableLines[i].lineIndex + 1; // +1 because we inserted a line
+        const lineToUpdate = tableLines[i].lineIndex + 1;
         const newRowIndex = tableLines[i].metadata.row + 1;
         const newMetadata = { ...tableLines[i].metadata, row: newRowIndex, columnWidths };
-        
+
         applyTableLineMetadataAttribute(lineToUpdate, tblId, newRowIndex, numCols, editorInfo.ace_getRep(), editorInfo, JSON.stringify(newMetadata), docManager);
       }
-      
-      // Apply metadata to the new row
+
       const newMetadata = { tblId, row: targetLine.metadata.row + 1, cols: numCols, columnWidths };
       applyTableLineMetadataAttribute(insertLineIndex, tblId, targetLine.metadata.row + 1, numCols, editorInfo.ace_getRep(), editorInfo, JSON.stringify(newMetadata), docManager);
-      
+
       editorInfo.ace_fastIncorp(10);
       return true;
     } catch (e) {
@@ -3913,40 +4135,35 @@ exports.aceInitialized = (h, ctx) => {
       return false;
     }
   }
-  
+
   function addTableColumnLeftWithText(tableLines, targetColIndex, editorInfo, docManager) {
     const funcName = 'addTableColumnLeftWithText';
     try {
-      // Process each line individually like table creation does
       for (const tableLine of tableLines) {
         const lineText = tableLine.lineText;
         const cells = lineText.split(DELIMITER);
-        
-        // Calculate the exact insertion position - stop BEFORE the target column's delimiter
+
         let insertPos = 0;
         for (let i = 0; i < targetColIndex; i++) {
           insertPos += (cells[i]?.length ?? 0) + DELIMITER.length;
         }
-        
-        // Insert blank cell then delimiter (BLANK + separator)
+
         const textToInsert = ' ' + DELIMITER;
         const insertStart = [tableLine.lineIndex, insertPos];
         const insertEnd = [tableLine.lineIndex, insertPos];
-        
+
         editorInfo.ace_performDocumentReplaceRange(insertStart, insertEnd, textToInsert);
-        
-        // Immediately apply authorship attributes like table creation does
+
         const rep = editorInfo.ace_getRep();
         const lineEntry = rep.lines.atIndex(tableLine.lineIndex);
         if (lineEntry) {
           const newLineText = lineEntry.text || '';
           const newCells = newLineText.split(DELIMITER);
           let offset = 0;
-          
-          // Apply cell-specific attributes to ALL cells (like table creation)
-          for (let c = 0; c < tableLine.cols + 1; c++) { // +1 for the new column
+
+          for (let c = 0; c < tableLine.cols + 1; c++) {
             const cellContent = (c < newCells.length) ? newCells[c] || '' : '';
-            if (cellContent.length > 0) { // Only apply to non-empty cells
+            if (cellContent.length > 0) {
               const cellStart = [tableLine.lineIndex, offset];
               const cellEnd = [tableLine.lineIndex, offset + cellContent.length];
              // log(`[ep_data_tables] ${funcName}: Applying ${ATTR_CELL} attribute to Line ${tableLine.lineIndex} Col ${c} Range ${offset}-${offset + cellContent.length}`);
@@ -3958,20 +4175,16 @@ exports.aceInitialized = (h, ctx) => {
             }
           }
         }
-        
-        // Reset all column widths to equal distribution when adding a column
-        // This avoids complex width calculations and ensures robust behavior
+
         const newColCount = tableLine.cols + 1;
         const equalWidth = 100 / newColCount;
         const normalizedWidths = Array(newColCount).fill(equalWidth);
       // log(`[ep_data_tables] addTableColumnLeft: Reset all column widths to equal distribution: ${newColCount} columns at ${equalWidth.toFixed(1)}% each`);
-        
-        // Apply updated metadata
+
         const newMetadata = { ...tableLine.metadata, cols: tableLine.cols + 1, columnWidths: normalizedWidths };
         applyTableLineMetadataAttribute(tableLine.lineIndex, tableLine.metadata.tblId, tableLine.metadata.row, tableLine.cols + 1, editorInfo.ace_getRep(), editorInfo, JSON.stringify(newMetadata), docManager);
       }
-      
-      // Final sync
+
       editorInfo.ace_fastIncorp(10);
       return true;
     } catch (e) {
@@ -3979,41 +4192,36 @@ exports.aceInitialized = (h, ctx) => {
       return false;
     }
   }
-  
+
   function addTableColumnRightWithText(tableLines, targetColIndex, editorInfo, docManager) {
     const funcName = 'addTableColumnRightWithText';
     try {
-      // Process each line individually like table creation does
       for (const tableLine of tableLines) {
         const lineText = tableLine.lineText;
         const cells = lineText.split(DELIMITER);
-        
-        // Calculate the exact insertion position - stop BEFORE the target column's trailing delimiter
+
         let insertPos = 0;
         for (let i = 0; i <= targetColIndex; i++) {
           insertPos += (cells[i]?.length ?? 0);
           if (i < targetColIndex) insertPos += DELIMITER.length;
         }
-        
-        // Insert delimiter then blank cell (separator + BLANK)
+
         const textToInsert = DELIMITER + ' ';
         const insertStart = [tableLine.lineIndex, insertPos];
         const insertEnd = [tableLine.lineIndex, insertPos];
-        
+
         editorInfo.ace_performDocumentReplaceRange(insertStart, insertEnd, textToInsert);
-        
-        // Immediately apply authorship attributes like table creation does
+
         const rep = editorInfo.ace_getRep();
         const lineEntry = rep.lines.atIndex(tableLine.lineIndex);
         if (lineEntry) {
           const newLineText = lineEntry.text || '';
           const newCells = newLineText.split(DELIMITER);
           let offset = 0;
-          
-          // Apply cell-specific attributes to ALL cells (like table creation)
-          for (let c = 0; c < tableLine.cols + 1; c++) { // +1 for the new column
+
+          for (let c = 0; c < tableLine.cols + 1; c++) {
             const cellContent = (c < newCells.length) ? newCells[c] || '' : '';
-            if (cellContent.length > 0) { // Only apply to non-empty cells
+            if (cellContent.length > 0) {
               const cellStart = [tableLine.lineIndex, offset];
               const cellEnd = [tableLine.lineIndex, offset + cellContent.length];
              // log(`[ep_data_tables] ${funcName}: Applying ${ATTR_CELL} attribute to Line ${tableLine.lineIndex} Col ${c} Range ${offset}-${offset + cellContent.length}`);
@@ -4025,20 +4233,16 @@ exports.aceInitialized = (h, ctx) => {
             }
           }
         }
-        
-        // Reset all column widths to equal distribution when adding a column
-        // This avoids complex width calculations and ensures robust behavior
+
         const newColCount = tableLine.cols + 1;
         const equalWidth = 100 / newColCount;
         const normalizedWidths = Array(newColCount).fill(equalWidth);
        // log(`[ep_data_tables] addTableColumnRight: Reset all column widths to equal distribution: ${newColCount} columns at ${equalWidth.toFixed(1)}% each`);
-        
-        // Apply updated metadata
+
         const newMetadata = { ...tableLine.metadata, cols: tableLine.cols + 1, columnWidths: normalizedWidths };
         applyTableLineMetadataAttribute(tableLine.lineIndex, tableLine.metadata.tblId, tableLine.metadata.row, tableLine.cols + 1, editorInfo.ace_getRep(), editorInfo, JSON.stringify(newMetadata), docManager);
       }
-      
-      // Final sync
+
       editorInfo.ace_fastIncorp(10);
       return true;
     } catch (e) {
@@ -4046,36 +4250,29 @@ exports.aceInitialized = (h, ctx) => {
       return false;
     }
   }
-  
+
   function deleteTableRowWithText(tableLines, targetRowIndex, editorInfo, docManager) {
     try {
       const targetLine = tableLines[targetRowIndex];
-      
-      // Special handling for deleting the first row (row index 0)
-      // Insert a blank line to prevent the table from getting stuck at line 1
+
       if (targetRowIndex === 0) {
        // log('[ep_data_tables] Deleting first row (row 0) - inserting blank line to prevent table from getting stuck');
         const insertStart = [targetLine.lineIndex, 0];
         editorInfo.ace_performDocumentReplaceRange(insertStart, insertStart, '\n');
-        
-        // Now delete the table line (which is now at lineIndex + 1)
+
         const deleteStart = [targetLine.lineIndex + 1, 0];
         const deleteEnd = [targetLine.lineIndex + 2, 0];
         editorInfo.ace_performDocumentReplaceRange(deleteStart, deleteEnd, '');
       } else {
-        // Delete the entire line normally
       const deleteStart = [targetLine.lineIndex, 0];
       const deleteEnd = [targetLine.lineIndex + 1, 0];
       editorInfo.ace_performDocumentReplaceRange(deleteStart, deleteEnd, '');
       }
-      
-      // Extract column widths from target line before deletion for preserving in remaining rows
+
       let columnWidths = targetLine.metadata.columnWidths;
       if (!columnWidths) {
-        // Extract from DOM for block-styled rows
         try {
           const rep = editorInfo.ace_getRep();
-          // Check any remaining table line for column widths
           for (const tableLine of tableLines) {
             if (tableLine.lineIndex !== targetLine.lineIndex) {
               const lineEntry = rep.lines.atIndex(tableLine.lineIndex >= targetLine.lineIndex ? tableLine.lineIndex - 1 : tableLine.lineIndex);
@@ -4105,16 +4302,15 @@ exports.aceInitialized = (h, ctx) => {
           console.error('[ep_data_tables] deleteTableRow: Error extracting column widths from DOM:', e);
         }
       }
-      
-      // Update metadata for all subsequent rows
+
       for (let i = targetRowIndex + 1; i < tableLines.length; i++) {
-        const lineToUpdate = tableLines[i].lineIndex - 1; // -1 because we deleted a line
+        const lineToUpdate = tableLines[i].lineIndex - 1;
         const newRowIndex = tableLines[i].metadata.row - 1;
         const newMetadata = { ...tableLines[i].metadata, row: newRowIndex, columnWidths };
-        
+
         applyTableLineMetadataAttribute(lineToUpdate, tableLines[i].metadata.tblId, newRowIndex, tableLines[i].cols, editorInfo.ace_getRep(), editorInfo, JSON.stringify(newMetadata), docManager);
       }
-      
+
       editorInfo.ace_fastIncorp(10);
       return true;
     } catch (e) {
@@ -4122,62 +4318,50 @@ exports.aceInitialized = (h, ctx) => {
       return false;
     }
   }
-  
   function deleteTableColumnWithText(tableLines, targetColIndex, editorInfo, docManager) {
     try {
-      // Update text content for all table lines using precise character deletion
       for (const tableLine of tableLines) {
         const lineText = tableLine.lineText;
         const cells = lineText.split(DELIMITER);
-        
+
         if (targetColIndex >= cells.length) {
          // log(`[ep_data_tables] Warning: Target column ${targetColIndex} doesn't exist in line with ${cells.length} columns`);
           continue;
         }
-        
-        // Calculate the exact character range to delete
+
         let deleteStart = 0;
         let deleteEnd = 0;
-        
-        // Calculate start position
+
         for (let i = 0; i < targetColIndex; i++) {
           deleteStart += (cells[i]?.length ?? 0) + DELIMITER.length;
         }
-        
-        // Calculate end position
+
         deleteEnd = deleteStart + (cells[targetColIndex]?.length ?? 0);
-        
-        // Include the delimiter in deletion
+
         if (targetColIndex === 0 && cells.length > 1) {
-          // If deleting first column, include the delimiter after it
           deleteEnd += DELIMITER.length;
         } else if (targetColIndex > 0) {
-          // If deleting any other column, include the delimiter before it
           deleteStart -= DELIMITER.length;
         }
-        
+
        // log(`[ep_data_tables] Deleting column ${targetColIndex} from line ${tableLine.lineIndex}: chars ${deleteStart}-${deleteEnd} from "${lineText}"`);
-        
-        // Perform the precise deletion
+
         const rangeStart = [tableLine.lineIndex, deleteStart];
         const rangeEnd = [tableLine.lineIndex, deleteEnd];
-        
+
         editorInfo.ace_performDocumentReplaceRange(rangeStart, rangeEnd, '');
-        
-        // Reset all column widths to equal distribution when deleting a column
-        // This avoids complex width calculations and ensures robust behavior
+
         const newColCount = tableLine.cols - 1;
         if (newColCount > 0) {
           const equalWidth = 100 / newColCount;
           const normalizedWidths = Array(newColCount).fill(equalWidth);
          // log(`[ep_data_tables] deleteTableColumn: Reset all column widths to equal distribution: ${newColCount} columns at ${equalWidth.toFixed(1)}% each`);
-        
-        // Update metadata
+
           const newMetadata = { ...tableLine.metadata, cols: newColCount, columnWidths: normalizedWidths };
           applyTableLineMetadataAttribute(tableLine.lineIndex, tableLine.metadata.tblId, tableLine.metadata.row, newColCount, editorInfo.ace_getRep(), editorInfo, JSON.stringify(newMetadata), docManager);
         }
       }
-      
+
       editorInfo.ace_fastIncorp(10);
       return true;
     } catch (e) {
@@ -4185,45 +4369,37 @@ exports.aceInitialized = (h, ctx) => {
       return false;
     }
   }
-  
-  // ... existing code ...
+
 
  // log('aceInitialized: END - helpers defined.');
 };
 
-// ───────────────────── required no‑op stubs ─────────────────────
 exports.aceStartLineAndCharForPoint = () => { return undefined; };
 exports.aceEndLineAndCharForPoint   = () => { return undefined; };
 
-// NEW: Style protection for table cells
 exports.aceSetAuthorStyle = (hook, ctx) => {
   const logPrefix = '[ep_data_tables:aceSetAuthorStyle]';
  // log(`${logPrefix} START`, { hook, ctx });
 
-  // If no selection or no style to apply, allow default
   if (!ctx || !ctx.rep || !ctx.rep.selStart || !ctx.rep.selEnd || !ctx.key) {
    // log(`${logPrefix} No selection or style key. Allowing default.`);
     return;
   }
 
-  // Check if selection is within a table
   const startLine = ctx.rep.selStart[0];
   const endLine = ctx.rep.selEnd[0];
-  
-  // If selection spans multiple lines, prevent style application
+
   if (startLine !== endLine) {
    // log(`${logPrefix} Selection spans multiple lines. Preventing style application to protect table structure.`);
     return false;
   }
 
-  // Check if the line is a table line
   const lineAttrString = ctx.documentAttributeManager?.getAttributeOnLine(startLine, ATTR_TABLE_JSON);
   if (!lineAttrString) {
    // log(`${logPrefix} Line ${startLine} is not a table line. Allowing default style application.`);
     return;
   }
 
-  // List of styles that could break table structure
   const BLOCKED_STYLES = [
     'list', 'listType', 'indent', 'align', 'heading', 'code', 'quote',
     'horizontalrule', 'pagebreak', 'linebreak', 'clear'
@@ -4234,7 +4410,6 @@ exports.aceSetAuthorStyle = (hook, ctx) => {
     return false;
   }
 
-  // For allowed styles, ensure they only apply within cell boundaries
   try {
     const tableMetadata = JSON.parse(lineAttrString);
     if (!tableMetadata || typeof tableMetadata.cols !== 'number') {
@@ -4248,11 +4423,10 @@ exports.aceSetAuthorStyle = (hook, ctx) => {
     let selectionStartCell = -1;
     let selectionEndCell = -1;
 
-    // Find which cells the selection spans
     for (let i = 0; i < cells.length; i++) {
       const cellLength = cells[i]?.length ?? 0;
       const cellEndCol = currentOffset + cellLength;
-      
+
       if (ctx.rep.selStart[1] >= currentOffset && ctx.rep.selStart[1] <= cellEndCol) {
         selectionStartCell = i;
       }
@@ -4262,62 +4436,53 @@ exports.aceSetAuthorStyle = (hook, ctx) => {
       currentOffset += cellLength + DELIMITER.length;
     }
 
-    // If selection spans multiple cells, prevent style application
     if (selectionStartCell !== selectionEndCell) {
      // log(`${logPrefix} Selection spans multiple cells. Preventing style application to protect table structure.`);
       return false;
     }
 
-    // If selection includes cell delimiters, prevent style application
     const cellStartCol = cells.slice(0, selectionStartCell).reduce((acc, cell) => acc + cell.length + DELIMITER.length, 0);
     const cellEndCol = cellStartCol + cells[selectionStartCell].length;
-    
+
     if (ctx.rep.selStart[1] <= cellStartCol || ctx.rep.selEnd[1] >= cellEndCol) {
      // log(`${logPrefix} Selection includes cell delimiters. Preventing style application to protect table structure.`);
       return false;
     }
 
    // log(`${logPrefix} Style '${ctx.key}' allowed within cell boundaries.`);
-    return; // Allow the style to be applied
+    return;
   } catch (e) {
     console.error(`${logPrefix} Error processing style application:`, e);
    // log(`${logPrefix} Error details:`, { message: e.message, stack: e.stack });
-    return false; // Prevent style application on error
+    return false;
   }
 };
 
 exports.aceEditorCSS                = () => { 
-  // Path relative to Etherpad's static/plugins/ directory
-  // Format should be: pluginName/path/to/file.css
   return ['ep_data_tables/static/css/datatables-editor.css', 'ep_data_tables/static/css/caret.css'];
 };
 
-// Register TABLE as a block element, hoping it influences rendering behavior
 exports.aceRegisterBlockElements = () => ['table'];
 
-// NEW: Column resize helper functions (adapted from images plugin)
 const startColumnResize = (table, columnIndex, startX, metadata, lineNum) => {
   const funcName = 'startColumnResize';
  // log(`${funcName}: Starting resize for column ${columnIndex}`);
-  
+
   isResizing = true;
   resizeStartX = startX;
-  resizeCurrentX = startX; // Initialize current position
+  resizeCurrentX = startX;
   resizeTargetTable = table;
   resizeTargetColumn = columnIndex;
   resizeTableMetadata = metadata;
   resizeLineNum = lineNum;
-  
-  // Get current column widths
+
   const numCols = metadata.cols;
   resizeOriginalWidths = metadata.columnWidths ? [...metadata.columnWidths] : Array(numCols).fill(100 / numCols);
-  
+
  // log(`${funcName}: Original widths:`, resizeOriginalWidths);
-  
-  // Create visual overlay instead of modifying table directly
+
   createResizeOverlay(table, columnIndex);
-  
-  // Prevent text selection during resize
+
   document.body.style.userSelect = 'none';
   document.body.style.webkitUserSelect = 'none';
   document.body.style.mozUserSelect = 'none';
@@ -4325,12 +4490,10 @@ const startColumnResize = (table, columnIndex, startX, metadata, lineNum) => {
 };
 
 const createResizeOverlay = (table, columnIndex) => {
-  // Create a visual overlay that shows resize feedback using the same positioning logic as image plugin
   if (resizeOverlay) {
     resizeOverlay.remove();
   }
-  
-  // Get all the necessary container references like image plugin
+
   const $innerIframe = $('iframe[name="ace_outer"]').contents().find('iframe[name="ace_inner"]');
   if ($innerIframe.length === 0) {
     console.error('[ep_data_tables] createResizeOverlay: Could not find inner iframe');
@@ -4339,51 +4502,47 @@ const createResizeOverlay = (table, columnIndex) => {
 
   const innerDocBody = $innerIframe.contents().find('body')[0];
   const padOuter = $('iframe[name="ace_outer"]').contents().find('body');
-  
+
   if (!innerDocBody || padOuter.length === 0) {
     console.error('[ep_data_tables] createResizeOverlay: Could not find required container elements');
           return;
       }
 
-  // Find all tables that belong to the same table (same tblId)
   const tblId = table.getAttribute('data-tblId');
   if (!tblId) {
     console.error('[ep_data_tables] createResizeOverlay: No tblId found on table');
     return;
   }
-  
+
   const allTableRows = innerDocBody.querySelectorAll(`table.dataTable[data-tblId="${tblId}"]`);
   if (allTableRows.length === 0) {
     console.error('[ep_data_tables] createResizeOverlay: No table rows found for tblId:', tblId);
     return;
   }
-  
-  // Calculate the bounding box that encompasses all table rows
+
   let minTop = Infinity;
   let maxBottom = -Infinity;
   let tableLeft = 0;
   let tableWidth = 0;
-  
+
   Array.from(allTableRows).forEach((tableRow, index) => {
     const rect = tableRow.getBoundingClientRect();
     minTop = Math.min(minTop, rect.top);
     maxBottom = Math.max(maxBottom, rect.bottom);
-    
-    // Use the first table row for horizontal positioning
+
     if (index === 0) {
       tableLeft = rect.left;
       tableWidth = rect.width;
     }
   });
-  
+
   const totalTableHeight = maxBottom - minTop;
-  
+
  // log(`createResizeOverlay: Found ${allTableRows.length} table rows, total height: ${totalTableHeight}px`);
-  
-  // Calculate positioning using the same method as image plugin
+
   let innerBodyRect, innerIframeRect, outerBodyRect;
   let scrollTopInner, scrollLeftInner, scrollTopOuter, scrollLeftOuter;
-  
+
   try {
     innerBodyRect = innerDocBody.getBoundingClientRect();
     innerIframeRect = $innerIframe[0].getBoundingClientRect();
@@ -4396,44 +4555,38 @@ const createResizeOverlay = (table, columnIndex) => {
     console.error('[ep_data_tables] createResizeOverlay: Error getting container rects/scrolls:', e);
     return;
   }
-  
-  // Get table position relative to inner body using the full table bounds
+
   const tableTopRelInner = minTop - innerBodyRect.top + scrollTopInner;
   const tableLeftRelInner = tableLeft - innerBodyRect.left + scrollLeftInner;
-  
-  // Calculate position in outer body coordinates (like image plugin)
+
   const innerFrameTopRelOuter = innerIframeRect.top - outerBodyRect.top + scrollTopOuter;
   const innerFrameLeftRelOuter = innerIframeRect.left - outerBodyRect.left + scrollLeftOuter;
-  
+
   const overlayTopOuter = innerFrameTopRelOuter + tableTopRelInner;
   const overlayLeftOuter = innerFrameLeftRelOuter + tableLeftRelInner;
-  
-  // Apply padding and manual offsets like image plugin
+
   const outerPadding = window.getComputedStyle(padOuter[0]);
   const outerPaddingTop = parseFloat(outerPadding.paddingTop) || 0;
   const outerPaddingLeft = parseFloat(outerPadding.paddingLeft) || 0;
-  
-  // Use the same manual offsets as image plugin
+
   const MANUAL_OFFSET_TOP = 6;
   const MANUAL_OFFSET_LEFT = 39;
-  
+
   const finalOverlayTop = overlayTopOuter + outerPaddingTop + MANUAL_OFFSET_TOP;
   const finalOverlayLeft = overlayLeftOuter + outerPaddingLeft + MANUAL_OFFSET_LEFT;
-  
-  // Calculate the position for the blue line at the right edge of the target column
+
   const tds = table.querySelectorAll('td');
   const tds_array = Array.from(tds);
   let linePosition = 0;
-  
+
   if (columnIndex < tds_array.length) {
     const currentTd = tds_array[columnIndex];
     const currentTdRect = currentTd.getBoundingClientRect();
-    const currentRelativeLeft = currentTdRect.left - tableLeft; // Use tableLeft instead of tableRect.left
+    const currentRelativeLeft = currentTdRect.left - tableLeft;
     const currentWidth = currentTdRect.width;
     linePosition = currentRelativeLeft + currentWidth;
   }
-  
-  // Create overlay container (invisible background) that spans the entire table height
+
   resizeOverlay = document.createElement('div');
   resizeOverlay.className = 'ep-data_tables-resize-overlay';
   resizeOverlay.style.cssText = `
@@ -4447,8 +4600,7 @@ const createResizeOverlay = (table, columnIndex) => {
     background: transparent;
     box-sizing: border-box;
   `;
-  
-  // Create the blue vertical line (Google Docs style) spanning the full table height
+
   const resizeLine = document.createElement('div');
   resizeLine.className = 'resize-line';
   resizeLine.style.cssText = `
@@ -4461,61 +4613,53 @@ const createResizeOverlay = (table, columnIndex) => {
     z-index: 1001;
   `;
   resizeOverlay.appendChild(resizeLine);
-  
-  // Append to outer body like image plugin does with its outline
+
   padOuter.append(resizeOverlay);
-  
+
  // log('createResizeOverlay: Created Google Docs style blue line overlay spanning entire table height');
 };
 
 const updateColumnResize = (currentX) => {
   if (!isResizing || !resizeTargetTable || !resizeOverlay) return;
-  
-  resizeCurrentX = currentX; // Store current position for finishColumnResize
+
+  resizeCurrentX = currentX;
   const deltaX = currentX - resizeStartX;
-  
-  // Get the table width from the first row for percentage calculation
+
   const tblId = resizeTargetTable.getAttribute('data-tblId');
   if (!tblId) return;
-  
-  // Find the first table row to get consistent width measurements
+
   const $innerIframe = $('iframe[name="ace_outer"]').contents().find('iframe[name="ace_inner"]');
   const innerDocBody = $innerIframe.contents().find('body')[0];
   const firstTableRow = innerDocBody.querySelector(`table.dataTable[data-tblId="${tblId}"]`);
-  
+
   if (!firstTableRow) return;
-  
+
   const tableRect = firstTableRow.getBoundingClientRect();
   const deltaPercent = (deltaX / tableRect.width) * 100;
-  
-  // Calculate new widths for final application
+
   const newWidths = [...resizeOriginalWidths];
   const currentColumn = resizeTargetColumn;
   const nextColumn = currentColumn + 1;
-  
+
   if (nextColumn < newWidths.length) {
     const transfer = Math.min(deltaPercent, newWidths[nextColumn] - 5);
     const actualTransfer = Math.max(transfer, -(newWidths[currentColumn] - 5));
-    
+
     newWidths[currentColumn] += actualTransfer;
     newWidths[nextColumn] -= actualTransfer;
-    
-    // Update the blue line position to show the new column boundary
+
     const resizeLine = resizeOverlay.querySelector('.resize-line');
     if (resizeLine) {
-      // Calculate new position based on the updated column width
       const newColumnWidth = (newWidths[currentColumn] / 100) * tableRect.width;
-      
-      // Find the original left position relative to the first table row
+
       const tds = firstTableRow.querySelectorAll('td');
       const tds_array = Array.from(tds);
-      
+
       if (currentColumn < tds_array.length) {
         const currentTd = tds_array[currentColumn];
         const currentTdRect = currentTd.getBoundingClientRect();
         const currentRelativeLeft = currentTdRect.left - tableRect.left;
-        
-        // New line position is the original left position plus the new width
+
         const newLinePosition = currentRelativeLeft + newColumnWidth;
         resizeLine.style.left = newLinePosition + 'px';
       }
@@ -4531,75 +4675,66 @@ const finishColumnResize = (editorInfo, docManager) => {
 
   const funcName = 'finishColumnResize';
  // log(`${funcName}: Finishing resize`);
-  
-  // Calculate final widths from actual mouse movement
+
   const tableRect = resizeTargetTable.getBoundingClientRect();
   const deltaX = resizeCurrentX - resizeStartX;
   const deltaPercent = (deltaX / tableRect.width) * 100;
-  
+
  // log(`${funcName}: Mouse moved ${deltaX}px (${deltaPercent.toFixed(1)}%)`);
-  
+
   const finalWidths = [...resizeOriginalWidths];
   const currentColumn = resizeTargetColumn;
   const nextColumn = currentColumn + 1;
-  
+
   if (nextColumn < finalWidths.length) {
-    // Transfer width between columns with minimum constraints
     const transfer = Math.min(deltaPercent, finalWidths[nextColumn] - 5);
     const actualTransfer = Math.max(transfer, -(finalWidths[currentColumn] - 5));
-    
+
     finalWidths[currentColumn] += actualTransfer;
     finalWidths[nextColumn] -= actualTransfer;
-    
+
    // log(`${funcName}: Transferred ${actualTransfer.toFixed(1)}% from column ${nextColumn} to column ${currentColumn}`);
   }
-  
-  // Normalize widths
+
   const totalWidth = finalWidths.reduce((sum, width) => sum + width, 0);
   if (totalWidth > 0) {
     finalWidths.forEach((width, index) => {
       finalWidths[index] = (width / totalWidth) * 100;
     });
   }
-  
+
  // log(`${funcName}: Final normalized widths:`, finalWidths.map(w => w.toFixed(1) + '%'));
-  
-  // Clean up overlay
+
   if (resizeOverlay) {
     resizeOverlay.remove();
     resizeOverlay = null;
   }
-  
-  // Clean up global styles
+
   document.body.style.userSelect = '';
   document.body.style.webkitUserSelect = '';
   document.body.style.mozUserSelect = '';
   document.body.style.msUserSelect = '';
-  
-  // Set isResizing to false BEFORE making changes
+
   isResizing = false;
-  
-  // Apply updated metadata to ALL rows in the table (not just the resized row)
+
   editorInfo.ace_callWithAce((ace) => {
     const callWithAceLogPrefix = `${funcName}[ace_callWithAce]`;
    // log(`${callWithAceLogPrefix}: Finding and updating all table rows with tblId: ${resizeTableMetadata.tblId}`);
-    
+
     try {
       const rep = ace.ace_getRep();
       if (!rep || !rep.lines) {
         console.error(`${callWithAceLogPrefix}: Invalid rep`);
         return;
       }
-      
-      // Find all lines that belong to this table
+
       const tableLines = [];
       const totalLines = rep.lines.length();
-      
+
       for (let lineIndex = 0; lineIndex < totalLines; lineIndex++) {
         try {
-          // Get line metadata to check if it belongs to our table
           let lineAttrString = docManager.getAttributeOnLine(lineIndex, ATTR_TABLE_JSON);
-          
+
           if (lineAttrString) {
             const lineMetadata = JSON.parse(lineAttrString);
             if (lineMetadata.tblId === resizeTableMetadata.tblId) {
@@ -4609,7 +4744,6 @@ const finishColumnResize = (editorInfo, docManager) => {
               });
               }
           } else {
-            // Fallback: Check if there's a table in the DOM even though attribute is missing (block styles)
             const lineEntry = rep.lines.atIndex(lineIndex);
             if (lineEntry && lineEntry.lineNode) {
               const tableInDOM = lineEntry.lineNode.querySelector('table.dataTable[data-tblId]');
@@ -4619,7 +4753,6 @@ const finishColumnResize = (editorInfo, docManager) => {
                 if (domTblId === resizeTableMetadata.tblId && domRow !== null) {
                   const domCells = tableInDOM.querySelectorAll('td');
                   if (domCells.length > 0) {
-                    // Extract column widths from DOM cells
                     const columnWidths = [];
                     domCells.forEach(cell => {
                       const style = cell.getAttribute('style') || '';
@@ -4627,12 +4760,10 @@ const finishColumnResize = (editorInfo, docManager) => {
                       if (widthMatch) {
                         columnWidths.push(parseFloat(widthMatch[1]));
                       } else {
-                        // Fallback to equal distribution if no width found
                         columnWidths.push(100 / domCells.length);
                       }
                     });
-                    
-                    // Reconstruct metadata from DOM with preserved column widths
+
                     const reconstructedMetadata = {
                       tblId: domTblId,
                       row: parseInt(domRow, 10),
@@ -4650,47 +4781,43 @@ const finishColumnResize = (editorInfo, docManager) => {
             }
                   }
               } catch (e) {
-          continue; // Skip lines with invalid metadata
+          continue;
         }
       }
-      
+
      // log(`${callWithAceLogPrefix}: Found ${tableLines.length} table lines to update`);
-      
-      // Update all table lines with new column widths
+
       for (const tableLine of tableLines) {
         const updatedMetadata = { ...tableLine.metadata, columnWidths: finalWidths };
         const updatedMetadataString = JSON.stringify(updatedMetadata);
-        
-        // Get the full line range for this table line
+
         const lineEntry = rep.lines.atIndex(tableLine.lineIndex);
         if (!lineEntry) {
           console.error(`${callWithAceLogPrefix}: Could not get line entry for line ${tableLine.lineIndex}`);
           continue;
         }
-        
+
         const lineLength = Math.max(1, lineEntry.text.length);
         const rangeStart = [tableLine.lineIndex, 0];
         const rangeEnd = [tableLine.lineIndex, lineLength];
-        
+
        // log(`${callWithAceLogPrefix}: Updating line ${tableLine.lineIndex} (row ${tableLine.metadata.row}) with new column widths`);
-        
-        // Apply the updated metadata attribute directly
+
         ace.ace_performDocumentApplyAttributesToRange(rangeStart, rangeEnd, [
           [ATTR_TABLE_JSON, updatedMetadataString]
         ]);
       }
-      
+
      // log(`${callWithAceLogPrefix}: Successfully applied updated column widths to all ${tableLines.length} table rows`);
-      
+
     } catch (error) {
       console.error(`${callWithAceLogPrefix}: Error applying updated metadata:`, error);
      // log(`${callWithAceLogPrefix}: Error details:`, { message: error.message, stack: error.stack });
     }
   }, 'applyTableResizeToAllRows', true);
-  
+
  // log(`${funcName}: Column width update initiated for all table rows via ace_callWithAce`);
-  
-  // Reset state
+
   resizeStartX = 0;
   resizeCurrentX = 0;
   resizeTargetTable = null;
@@ -4698,11 +4825,10 @@ const finishColumnResize = (editorInfo, docManager) => {
   resizeOriginalWidths = [];
   resizeTableMetadata = null;
   resizeLineNum = -1;
-  
+
  // log(`${funcName}: Resize complete - state reset`);
 };
 
-// NEW: Undo/Redo protection
 exports.aceUndoRedo = (hook, ctx) => {
   const logPrefix = '[ep_data_tables:aceUndoRedo]';
  // log(`${logPrefix} START`, { hook, ctx });
@@ -4712,11 +4838,9 @@ exports.aceUndoRedo = (hook, ctx) => {
     return;
   }
 
-  // Get the affected line range
   const startLine = ctx.rep.selStart[0];
   const endLine = ctx.rep.selEnd[0];
 
-  // Check if any affected lines are table lines
   let hasTableLines = false;
   let tableLines = [];
 
@@ -4735,7 +4859,6 @@ exports.aceUndoRedo = (hook, ctx) => {
 
  // log(`${logPrefix} Table lines affected:`, { tableLines });
 
-  // Validate table structure after undo/redo
   try {
     for (const line of tableLines) {
       const lineAttrString = ctx.documentAttributeManager?.getAttributeOnLine(line, ATTR_TABLE_JSON);
@@ -4744,23 +4867,19 @@ exports.aceUndoRedo = (hook, ctx) => {
       const tableMetadata = JSON.parse(lineAttrString);
       if (!tableMetadata || typeof tableMetadata.cols !== 'number') {
        // log(`${logPrefix} Invalid table metadata after undo/redo. Attempting recovery.`);
-        // Attempt to recover table structure
         const lineText = ctx.rep.lines.atIndex(line)?.text || '';
         const cells = lineText.split(DELIMITER);
-        
-        // If we have valid cells, try to reconstruct the table metadata
+
         if (cells.length > 1) {
           const newMetadata = {
             cols: cells.length,
             rows: 1,
             cells: cells.map((_, i) => ({ col: i, row: 0 }))
           };
-          
-          // Apply the recovered metadata
+
           ctx.documentAttributeManager.setAttributeOnLine(line, ATTR_TABLE_JSON, JSON.stringify(newMetadata));
          // log(`${logPrefix} Recovered table structure for line ${line}`);
         } else {
-          // If we can't recover, remove the table attribute
           ctx.documentAttributeManager.removeAttributeOnLine(line, ATTR_TABLE_JSON);
          // log(`${logPrefix} Removed invalid table attribute from line ${line}`);
         }
@@ -4770,4 +4889,4 @@ exports.aceUndoRedo = (hook, ctx) => {
     console.error(`${logPrefix} Error during undo/redo validation:`, e);
    // log(`${logPrefix} Error details:`, { message: e.message, stack: e.stack });
   }
-};
+};