@underverse-ui/underverse 1.0.204 → 1.0.205

package/dist/{chunk-CKKLFVOY.js → chunk-Z63YNF3N.js}

@@ -1,6 +1,6 @@
 import {
   EmojiGridButton
-} from "./chunk-ZUAIBY2Z.js";
+} from "./chunk-IXEFOLUD.js";
 import {
   EMOJI_LIST
 } from "./chunk-4TYW5K4J.js";
@@ -8,7 +8,7 @@ import {
   Tooltip,
   cn,
   useSmartTranslations
-} from "./chunk-GSBRTFP2.js";
+} from "./chunk-XJR7E6QB.js";
 
 // src/components/EmojiPicker.tsx
 import { useEffect, useMemo, useRef, useState } from "react";
@@ -203,4 +203,4 @@ export {
   EmojiPicker,
   EmojiPicker_default
 };
-//# sourceMappingURL=chunk-CKKLFVOY.js.map
+//# sourceMappingURL=chunk-Z63YNF3N.js.map

package/dist/index.cjs

@@ -2028,16 +2028,19 @@ var init_TranslationContext = __esm({
         },
         [locale, translations]
       );
-      return /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(GlobalI18nProvider, { i18n, children: /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(TranslationContext.Provider, { value: { locale, t }, children }) });
+      const value = React6.useMemo(() => ({ locale, t }), [locale, t]);
+      return /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(GlobalI18nProvider, { i18n, children: /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(TranslationContext.Provider, { value, children }) });
     };
     useUnderverseTranslations = (namespace) => {
       const context = React6.useContext(TranslationContext);
-      if (!context) {
-        return (key) => {
-          return getUnderverseDefaultTranslation("en", namespace, key);
-        };
-      }
-      return context.t(namespace);
+      return React6.useMemo(() => {
+        if (!context) {
+          return (key) => {
+            return getUnderverseDefaultTranslation("en", namespace, key);
+          };
+        }
+        return context.t(namespace);
+      }, [context, namespace]);
     };
     useUnderverseLocale = () => {
       const context = React6.useContext(TranslationContext);
@@ -2191,10 +2194,10 @@ function useSmartTranslations(namespace) {
       setEnvironmentLocale(detected);
     }
   }, [forceInternal, internalLocale, nextIntlBridge]);
-  if (forceInternal) {
-    return internalT;
-  }
-  return (key) => {
+  return React8.useCallback((key) => {
+    if (forceInternal) {
+      return internalT(key);
+    }
     const resolvedEnvironmentLocale = environmentLocale && environmentLocale !== internalLocale ? environmentLocale : null;
     const primaryLocale = nextIntlBridge?.locale ?? resolvedEnvironmentLocale ?? internalLocale;
     const fallbackLocale = resolvedEnvironmentLocale && resolvedEnvironmentLocale !== primaryLocale ? resolvedEnvironmentLocale : null;
@@ -2223,7 +2226,7 @@ function useSmartTranslations(namespace) {
       return internalValue;
     }
     return key;
-  };
+  }, [environmentLocale, forceInternal, internalLocale, internalT, namespace, nextIntlBridge]);
 }
 function useSmartLocale() {
   const forceInternal = React8.useContext(ForceInternalContext);
@@ -5774,6 +5777,25 @@ function resolveEventElement(target) {
   if (target instanceof Node) return target.parentElement;
   return null;
 }
+function isPointOverRenderedText(root, clientX, clientY) {
+  const view = root.ownerDocument.defaultView;
+  if (!view) return false;
+  const walker = root.ownerDocument.createTreeWalker(root, view.NodeFilter.SHOW_TEXT);
+  let textNode = walker.nextNode();
+  while (textNode) {
+    if (textNode.textContent?.length) {
+      const range = root.ownerDocument.createRange();
+      range.selectNodeContents(textNode);
+      const textRects = Array.from(range.getClientRects());
+      range.detach?.();
+      if (textRects.some((rect) => clientX >= rect.left && clientX <= rect.right && clientY >= rect.top && clientY <= rect.bottom)) {
+        return true;
+      }
+    }
+    textNode = walker.nextNode();
+  }
+  return false;
+}
 function getSelectionTableCell(view) {
   const browserSelection = window.getSelection();
   const anchorElement = resolveEventElement(browserSelection?.anchorNode ?? null);
@@ -44299,6 +44321,22 @@ function buildLogicalRowMetrics({
     };
   });
 }
+function getTableCellTextSelectionRange(editor, cellPos) {
+  const cellNode = editor.state.doc.nodeAt(cellPos);
+  if (!cellNode || cellNode.type.name !== "tableCell" && cellNode.type.name !== "tableHeader") {
+    return null;
+  }
+  let from = null;
+  let to = null;
+  cellNode.descendants((node, relativePos) => {
+    if (!node.isText || node.nodeSize === 0) return true;
+    const textStart = cellPos + 1 + relativePos;
+    from ?? (from = textStart);
+    to = textStart + node.nodeSize;
+    return true;
+  });
+  return from !== null && to !== null && from < to ? { from, to } : null;
+}
 function buildTableControlLayout(editor, surface, cell) {
   const row = cell.closest("tr");
   const table = cell.closest("table");
@@ -44404,6 +44442,9 @@ function buildTableHoverState({
   layout,
   surface
 }) {
+  if (event.buttons !== 0) {
+    return DEFAULT_TABLE_HOVER_STATE;
+  }
   const surfaceRect = surface.getBoundingClientRect();
   const relativeX = event.clientX - surfaceRect.left + surface.scrollLeft;
   const relativeY = event.clientY - surfaceRect.top + surface.scrollTop;
@@ -44413,8 +44454,8 @@ function buildTableHoverState({
   const directTableMenu = targetElement?.closest?.("[data-table-control='table-menu']");
   const directAddColumn = targetElement?.closest?.("[data-table-control='add-column']");
   const directAddRow = targetElement?.closest?.("[data-table-control='add-row']");
-  const directRowHandleIndex = directRowHandle instanceof HTMLElement ? Number.parseInt(directRowHandle.dataset.rowHandleIndex ?? "", 10) : Number.NaN;
-  const directColumnHandleIndex = directColumnHandle instanceof HTMLElement ? Number.parseInt(directColumnHandle.dataset.columnHandleIndex ?? "", 10) : Number.NaN;
+  const directRowHandleIndex = directRowHandle instanceof HTMLElement && relativeX <= layout.tableLeft ? Number.parseInt(directRowHandle.dataset.rowHandleIndex ?? "", 10) : Number.NaN;
+  const directColumnHandleIndex = directColumnHandle instanceof HTMLElement && relativeY <= layout.tableTop ? Number.parseInt(directColumnHandle.dataset.columnHandleIndex ?? "", 10) : Number.NaN;
   const visibleBounds = getVisibleTableBounds(layout);
   const rowRailTop = layout.wrapperTop + layout.wrapperHeight;
   const isMouseInTable = relativeX >= layout.tableLeft && relativeX <= layout.tableLeft + layout.tableWidth && relativeY >= layout.tableTop && relativeY <= layout.tableTop + layout.tableHeight;
@@ -44733,7 +44774,8 @@ function TableRowHandles({
         "data-row-handle-index": rowHandle.index,
         style: {
           top: Math.max(8, rowHandle.center - 12),
-          left: rowHandleLeft
+          left: rowHandleLeft,
+          pointerEvents: visible ? "auto" : "none"
         },
         children: /* @__PURE__ */ (0, import_jsx_runtime99.jsx)(
           Tooltip,
@@ -44766,7 +44808,10 @@ function TableRowHandles({
                     style: {
                       opacity: isShown ? 1 : 0,
                       transform: isShown ? "scale(1)" : `scale(${IDLE_HANDLE_SCALE})`,
-                      pointerEvents: isShown ? "auto" : "none"
+                      // The idle marker is only a location hint. Keeping it
+                      // pointer-transparent prevents it from stealing a text
+                      // selection near the first character of a table cell.
+                      pointerEvents: visible ? "auto" : "none"
                     },
                     children: visible ? /* @__PURE__ */ (0, import_jsx_runtime99.jsx)(import_lucide_react55.GripVertical, { className: "h-3.5 w-3.5" }) : /* @__PURE__ */ (0, import_jsx_runtime99.jsx)("div", { className: "h-3 w-1 rounded-full bg-muted-foreground/50 hover:bg-muted-foreground" })
                   }
@@ -44804,7 +44849,8 @@ function TableColumnHandles({
         "data-column-handle-index": columnHandle.index,
         style: {
           top: columnHandleTop,
-          left: Math.max(8, columnHandle.center - 12)
+          left: Math.max(8, columnHandle.center - 12),
+          pointerEvents: visible ? "auto" : "none"
         },
         children: /* @__PURE__ */ (0, import_jsx_runtime99.jsx)(
           Tooltip,
@@ -44837,7 +44883,7 @@ function TableColumnHandles({
                     style: {
                       opacity: isShown ? 1 : 0,
                       transform: isShown ? "scale(1)" : `scale(${IDLE_HANDLE_SCALE})`,
-                      pointerEvents: isShown ? "auto" : "none"
+                      pointerEvents: visible ? "auto" : "none"
                     },
                     children: visible ? /* @__PURE__ */ (0, import_jsx_runtime99.jsx)(import_lucide_react55.GripHorizontal, { className: "h-3.5 w-3.5" }) : /* @__PURE__ */ (0, import_jsx_runtime99.jsx)("div", { className: "h-1 w-3 rounded-full bg-muted-foreground/50 hover:bg-muted-foreground" })
                   }
@@ -45085,6 +45131,7 @@ function applyTableSize(editor, snapshot, dimensions) {
 // src/components/UEditor/table-controls.tsx
 var import_jsx_runtime101 = require("react/jsx-runtime");
 var TABLE_MENU_TOP_OFFSET = 10;
+var AXIS_HANDLE_RADIUS = 12;
 function nearestIndex(centers, position) {
   let bestIndex = 0;
   let bestDistance = Number.POSITIVE_INFINITY;
@@ -45262,6 +45309,20 @@ function TableControls({ editor, containerRef, showCellInspector = true }) {
       const surface2 = containerRef.current;
       const nextLayout = surface2 ? buildTableControlLayout(editor, surface2, cell) : null;
       if (!nextLayout) return;
+      if (isPointOverRenderedText(cell, event.clientX, event.clientY)) {
+        const textSelection = getTableCellTextSelectionRange(editor, nextLayout.cellPos);
+        if (textSelection) {
+          event.preventDefault();
+          const didSelectText = editor.commands.setTextSelection(textSelection);
+          if (didSelectText) {
+            editor.view.focus();
+            layoutRef.current = nextLayout;
+            setLayout(nextLayout);
+            setHoverState(DEFAULT_TABLE_HOVER_STATE);
+            return;
+          }
+        }
+      }
       const didSelect = editor.commands.setCellSelection({
         anchorCell: nextLayout.cellPos,
         headCell: nextLayout.cellPos
@@ -45728,8 +45789,8 @@ function TableControls({ editor, containerRef, showCellInspector = true }) {
   }
   const menuTop = Math.max(8, layout.tableTop - TABLE_MENU_TOP_OFFSET);
   const menuLeft = Math.max(8, layout.tableLeft);
-  const rowHandleLeft = layout.tableLeft - 12;
-  const columnHandleTop = layout.tableTop - 12;
+  const rowHandleLeft = layout.tableLeft - AXIS_HANDLE_RADIUS;
+  const columnHandleTop = layout.tableTop - AXIS_HANDLE_RADIUS;
   return /* @__PURE__ */ (0, import_jsx_runtime101.jsxs)(import_jsx_runtime101.Fragment, { children: [
     /* @__PURE__ */ (0, import_jsx_runtime101.jsx)(
       TableRowHandles,
@@ -46916,6 +46977,73 @@ function TableFormulaBar({ editor }) {
   );
 }
 
+// src/components/UEditor/use-editor-output.ts
+var React91 = __toESM(require("react"), 1);
+function normalizeDebounceMs(value) {
+  return typeof value === "number" && Number.isFinite(value) && value > 0 ? value : 0;
+}
+function useUEditorOutput({
+  onChange,
+  onHtmlChange,
+  onJsonChange,
+  outputDebounceMs
+}) {
+  const callbacksRef = React91.useRef({});
+  const pendingEditorRef = React91.useRef(null);
+  const timeoutRef = React91.useRef(null);
+  const debounceMs = normalizeDebounceMs(outputDebounceMs);
+  callbacksRef.current = { onChange, onHtmlChange, onJsonChange };
+  const flushOutputUpdates = React91.useCallback(() => {
+    if (timeoutRef.current !== null) {
+      clearTimeout(timeoutRef.current);
+      timeoutRef.current = null;
+    }
+    const editor = pendingEditorRef.current;
+    pendingEditorRef.current = null;
+    if (!editor || editor.isDestroyed) return;
+    const callbacks = callbacksRef.current;
+    if (callbacks.onChange || callbacks.onHtmlChange) {
+      const html = editor.getHTML();
+      callbacks.onChange?.(html);
+      callbacks.onHtmlChange?.(html);
+    }
+    if (callbacks.onJsonChange) {
+      callbacks.onJsonChange(editor.getJSON());
+    }
+  }, []);
+  const scheduleOutputUpdate = React91.useCallback((editor) => {
+    const callbacks = callbacksRef.current;
+    if (!callbacks.onChange && !callbacks.onHtmlChange && !callbacks.onJsonChange) return;
+    pendingEditorRef.current = editor;
+    if (timeoutRef.current !== null) {
+      clearTimeout(timeoutRef.current);
+      timeoutRef.current = null;
+    }
+    if (debounceMs === 0) {
+      flushOutputUpdates();
+      return;
+    }
+    timeoutRef.current = setTimeout(flushOutputUpdates, debounceMs);
+  }, [debounceMs, flushOutputUpdates]);
+  React91.useEffect(() => {
+    if (!pendingEditorRef.current || timeoutRef.current === null) return;
+    clearTimeout(timeoutRef.current);
+    timeoutRef.current = debounceMs === 0 ? null : setTimeout(flushOutputUpdates, debounceMs);
+    if (debounceMs === 0) flushOutputUpdates();
+  }, [debounceMs, flushOutputUpdates]);
+  React91.useEffect(() => () => {
+    if (timeoutRef.current !== null) {
+      clearTimeout(timeoutRef.current);
+      timeoutRef.current = null;
+    }
+    pendingEditorRef.current = null;
+  }, []);
+  return {
+    flushOutputUpdates,
+    scheduleOutputUpdate
+  };
+}
+
 // src/components/UEditor/UEditor.tsx
 var import_jsx_runtime104 = require("react/jsx-runtime");
 var LazyMenuBar = import_react84.default.lazy(async () => {
@@ -46927,6 +47055,7 @@ var UEditor = import_react84.default.forwardRef(({
   onChange,
   onHtmlChange,
   onJsonChange,
+  outputDebounceMs = 0,
   uploadImage,
   uploadImageForSave,
   uploadImageConcurrency = 3,
@@ -46972,6 +47101,12 @@ var UEditor = import_react84.default.forwardRef(({
   const formulaRangePickRef = (0, import_react84.useRef)(null);
   const formulaRangeSurfaceRef = (0, import_react84.useRef)(null);
   const [formulaRangeHighlight, setFormulaRangeHighlight] = import_react84.default.useState(null);
+  const { flushOutputUpdates, scheduleOutputUpdate } = useUEditorOutput({
+    onChange,
+    onHtmlChange,
+    onJsonChange,
+    outputDebounceMs
+  });
   const scheduleFormulaRecalculate = import_react84.default.useCallback((editor2, options) => {
     if (editor2.isDestroyed || scheduledFormulaRecalculateRef.current) return;
     if (!options?.force && isEditingTableFormulaText(editor2)) return;
@@ -47113,14 +47248,7 @@ var UEditor = import_react84.default.forwardRef(({
           pendingFormulaTextRecalculateRef.current = false;
         }
       }
-      if (onChange || onHtmlChange) {
-        const html = editor2.getHTML();
-        onChange?.(html);
-        onHtmlChange?.(html);
-      }
-      if (onJsonChange) {
-        onJsonChange(editor2.getJSON());
-      }
+      scheduleOutputUpdate(editor2);
     },
     onSelectionUpdate: ({ editor: editor2 }) => {
       if (pendingFormulaTextRecalculateRef.current && !isEditingTableFormulaText(editor2)) {
@@ -47134,6 +47262,7 @@ var UEditor = import_react84.default.forwardRef(({
       const shouldRecalculate = pendingFormulaTextRecalculateRef.current;
       pendingFormulaTextRecalculateRef.current = false;
       if (shouldRecalculate) scheduleFormulaRecalculate(editor2, { force: true });
+      queueMicrotask(flushOutputUpdates);
     }
   });
   (0, import_react84.useEffect)(() => {