@extend-ai/react-docx 0.6.5 → 0.6.7

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 CrowdView Inc, dba Extend
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.cjs

@@ -12297,7 +12297,15 @@ var defaultStarterModel = {
     headerSections: [],
     footerSections: [],
     paragraphStyles: [
-      { id: "Normal", name: "Body", isDefault: true },
+      {
+        id: "Normal",
+        name: "Body",
+        isDefault: true,
+        // Word's blank-document default body typeface. Without this the body
+        // default fell through to a heading font / Times New Roman and did not
+        // match the "Calibri" shown in the toolbar.
+        runStyle: { fontFamily: "Calibri", fontSizePt: 11 }
+      },
       {
         id: "Heading1",
         name: "Heading 1",
@@ -12440,7 +12448,7 @@ function resolveDocumentInheritedFontFamily(model) {
     return cssFontFamily(defaultStyleFontFamily);
   }
   const paragraphStyleFontFamily = paragraphStyles.find(
-    (style) => Boolean(style.runStyle?.fontFamily?.trim())
+    (style) => style.headingLevel === void 0 && Boolean(style.runStyle?.fontFamily?.trim())
   )?.runStyle?.fontFamily;
   if (paragraphStyleFontFamily) {
     return cssFontFamily(paragraphStyleFontFamily);
@@ -14675,7 +14683,17 @@ function nodeAlreadyEndsAtExplicitPageBoundary(node) {
   }
   return paragraphHasExplicitPageBreak2(node) || paragraphHasPageBreakBefore2(node) || sectionBreakAfterParagraphStartsNewPage(node);
 }
+var docxHardPageBreakStartNodeIndexesByModel = /* @__PURE__ */ new WeakMap();
 function collectDocxHardPageBreakStartNodeIndexes(model) {
+  const cached = docxHardPageBreakStartNodeIndexesByModel.get(model);
+  if (cached) {
+    return cached;
+  }
+  const result = computeDocxHardPageBreakStartNodeIndexes(model);
+  docxHardPageBreakStartNodeIndexesByModel.set(model, result);
+  return result;
+}
+function computeDocxHardPageBreakStartNodeIndexes(model) {
   const breaks = collectTopLevelExplicitPageBreakStartNodeIndexes(model.nodes);
   const sections = resolveDocumentSectionsFromMetadata(model.metadata);
   for (let sectionIndex = 1; sectionIndex < sections.length; sectionIndex += 1) {
@@ -14699,7 +14717,17 @@ function collectDocxHardPageBreakStartNodeIndexes(model) {
   }
   return breaks;
 }
+var docxSectionStartPageBreakNodeIndexesByModel = /* @__PURE__ */ new WeakMap();
 function collectDocxSectionStartPageBreakNodeIndexes(model) {
+  const cached = docxSectionStartPageBreakNodeIndexesByModel.get(model);
+  if (cached) {
+    return cached;
+  }
+  const result = computeDocxSectionStartPageBreakNodeIndexes(model);
+  docxSectionStartPageBreakNodeIndexesByModel.set(model, result);
+  return result;
+}
+function computeDocxSectionStartPageBreakNodeIndexes(model) {
   const breaks = /* @__PURE__ */ new Set();
   const sections = resolveDocumentSectionsFromMetadata(model.metadata);
   for (let sectionIndex = 1; sectionIndex < sections.length; sectionIndex += 1) {
@@ -30096,6 +30124,8 @@ function DocxEditorViewer({
   const fileDragDepthRef = React.useRef(0);
   const tableDraftLayoutRefreshRafRef = React.useRef(null);
   const activeRangeFlushFrameRef = React.useRef(null);
+  const pendingEditableCaretRef = React.useRef(null);
+  const pointerSelectionDragRef = React.useRef({ down: false, moved: false });
   const deferredCollapsedSelectionSyncTimeoutRef = React.useRef(
     null
   );
@@ -34144,14 +34174,62 @@ function DocxEditorViewer({
     });
   }, [resolveParagraphBoundaryFromSelectionPoint]);
   const setActiveRangeFromSelection = React.useCallback(() => {
+    const session = editor.selectionSessionKind;
+    const rootElement = viewerRootRef.current;
+    const activeElement = document.activeElement;
+    const editorHasFocus = Boolean(
+      activeElement instanceof HTMLElement && activeElement.isContentEditable && rootElement && rootElement.contains(activeElement)
+    );
+    const liveSelection = window.getSelection();
+    const anchorNode = liveSelection?.anchorNode ?? null;
+    const collapsedElementAnchor = Boolean(
+      liveSelection && liveSelection.isCollapsed && liveSelection.rangeCount > 0 && anchorNode && anchorNode.nodeType !== Node.TEXT_NODE
+    );
+    const selectionDropped = Boolean(
+      editorHasFocus && (!liveSelection || liveSelection.rangeCount === 0)
+    );
+    if (collapsedElementAnchor || selectionDropped) {
+      if (session === "keyboard" || session === "composition") {
+        return;
+      }
+      const anchorElement = anchorNode instanceof Element ? anchorNode : anchorNode?.parentElement ?? null;
+      const destroyedHost = anchorElement?.closest(
+        "[data-docx-paragraph-host='true']"
+      ) ?? (editorHasFocus ? activeElement.closest(
+        "[data-docx-paragraph-host='true']"
+      ) : null);
+      const lastGoodRange = cloneTextRange(editor.activeTextRange);
+      if (lastGoodRange && destroyedHost) {
+        const normalizedLastGood = normalizeTextRange(lastGoodRange);
+        const lastGoodHost = resolveParagraphHostElement(
+          normalizedLastGood.start.location
+        );
+        if (lastGoodHost === destroyedHost) {
+          setSelectionFromDocxBoundaries(
+            normalizedLastGood.start,
+            normalizedLastGood.end
+          );
+        }
+      }
+      return;
+    }
     const range = resolveActiveRangeFromDomSelection();
     if (!range) {
+      if (editorHasFocus && editor.activeTextRange) {
+        return;
+      }
       editor.setActiveTextRange(void 0);
       return;
     }
     clearTableCellSelection();
     editor.setActiveTextRange(range);
-  }, [clearTableCellSelection, editor, resolveActiveRangeFromDomSelection]);
+  }, [
+    clearTableCellSelection,
+    editor,
+    resolveActiveRangeFromDomSelection,
+    resolveParagraphHostElement,
+    setSelectionFromDocxBoundaries
+  ]);
   const flushActiveRangeFromSelection = React.useCallback(() => {
     if (deferredCollapsedSelectionSyncTimeoutRef.current !== null) {
       window.clearTimeout(deferredCollapsedSelectionSyncTimeoutRef.current);
@@ -34165,6 +34243,73 @@ function DocxEditorViewer({
       setActiveRangeFromSelection();
     });
   }, [setActiveRangeFromSelection]);
+  React.useLayoutEffect(() => {
+    if (isReadOnly) {
+      return;
+    }
+    const session = editor.selectionSessionKind;
+    if (pointerSelectionDragRef.current.moved || session === "composition") {
+      return;
+    }
+    const rootElement = viewerRootRef.current;
+    if (!rootElement) {
+      return;
+    }
+    const activeElement = document.activeElement;
+    if (!(activeElement instanceof HTMLElement) || !activeElement.isContentEditable || !rootElement.contains(activeElement)) {
+      return;
+    }
+    const focusedHost = activeElement.closest(
+      "[data-docx-paragraph-host='true']"
+    );
+    if (!focusedHost) {
+      return;
+    }
+    const selection = window.getSelection();
+    if (!selection) {
+      return;
+    }
+    const liveRange = selection.rangeCount > 0 ? selection.getRangeAt(0) : void 0;
+    const anchorNode = selection.anchorNode;
+    const selectionInsideHost = Boolean(
+      liveRange && focusedHost.contains(liveRange.startContainer) && focusedHost.contains(liveRange.endContainer)
+    );
+    const anchorIsElement = Boolean(
+      anchorNode && anchorNode.nodeType !== Node.TEXT_NODE
+    );
+    const selectionWasDestroyed = !liveRange || !selectionInsideHost || selection.isCollapsed && anchorIsElement;
+    if (!selectionWasDestroyed) {
+      return;
+    }
+    const focusedNodeIndexAttr = focusedHost.getAttribute(
+      "data-docx-paragraph-node-index"
+    );
+    const focusedNodeIndex = focusedNodeIndexAttr != null ? Number.parseInt(focusedNodeIndexAttr, 10) : Number.NaN;
+    const pendingCaret = pendingEditableCaretRef.current;
+    if (pendingCaret && Number.isFinite(focusedNodeIndex) && pendingCaret.nodeIndex === focusedNodeIndex) {
+      const textLength = editableTextFromElement(focusedHost).length;
+      const safeStart = Math.max(0, Math.min(pendingCaret.start, textLength));
+      const safeEnd = Math.max(
+        safeStart,
+        Math.min(pendingCaret.end, textLength)
+      );
+      setSelectionWithinElementByTextOffsets(focusedHost, safeStart, safeEnd);
+      return;
+    }
+    if (session === "keyboard") {
+      return;
+    }
+    const range = editor.activeTextRange;
+    if (!range) {
+      return;
+    }
+    const normalized = normalizeTextRange(range);
+    const targetHost = resolveParagraphHostElement(normalized.start.location);
+    if (!targetHost || targetHost !== focusedHost) {
+      return;
+    }
+    setSelectionFromDocxBoundaries(normalized.start, normalized.end);
+  });
   const selectionIsExpandedWithinElement = React.useCallback(
     (element) => {
       const selection = window.getSelection();
@@ -34618,6 +34763,28 @@ function DocxEditorViewer({
       const collapsedCaretInsideEditableHost = Boolean(
         selectionRange.collapsed && activeElement instanceof HTMLElement && activeElement.isContentEditable && rootElement.contains(activeElement) && activeElement.contains(selectionRange.startContainer)
       );
+      const selectionWithinSingleEditableHost = Boolean(
+        activeElement instanceof HTMLElement && activeElement.isContentEditable && rootElement.contains(activeElement) && activeElement.contains(selectionRange.startContainer) && activeElement.contains(selectionRange.endContainer) && selectionRange.startContainer.nodeType === Node.TEXT_NODE && selectionRange.endContainer.nodeType === Node.TEXT_NODE
+      );
+      if (selectionWithinSingleEditableHost && activeElement instanceof HTMLElement) {
+        const host = activeElement.closest(
+          "[data-docx-paragraph-host='true']"
+        );
+        const nodeIndexAttr = host?.getAttribute(
+          "data-docx-paragraph-node-index"
+        );
+        const offsets = host ? selectionOffsetsWithinElement(host) : void 0;
+        if (host && nodeIndexAttr != null && offsets) {
+          const nodeIndex = Number.parseInt(nodeIndexAttr, 10);
+          if (Number.isFinite(nodeIndex)) {
+            pendingEditableCaretRef.current = {
+              nodeIndex,
+              start: offsets.start,
+              end: offsets.end
+            };
+          }
+        }
+      }
       if (collapsedCaretInsideEditableHost) {
         scheduleDeferredCollapsedSelectionSync();
         return;
@@ -34629,6 +34796,27 @@ function DocxEditorViewer({
       document.removeEventListener("selectionchange", handleSelectionChange);
     };
   }, [flushActiveRangeFromSelection, scheduleDeferredCollapsedSelectionSync]);
+  React.useEffect(() => {
+    const onPointerDown = () => {
+      pointerSelectionDragRef.current = { down: true, moved: false };
+    };
+    const onPointerMove = (event) => {
+      if (pointerSelectionDragRef.current.down && event.buttons !== 0) {
+        pointerSelectionDragRef.current.moved = true;
+      }
+    };
+    const onPointerUp = () => {
+      pointerSelectionDragRef.current = { down: false, moved: false };
+    };
+    window.addEventListener("pointerdown", onPointerDown, true);
+    window.addEventListener("pointermove", onPointerMove, true);
+    window.addEventListener("pointerup", onPointerUp, true);
+    return () => {
+      window.removeEventListener("pointerdown", onPointerDown, true);
+      window.removeEventListener("pointermove", onPointerMove, true);
+      window.removeEventListener("pointerup", onPointerUp, true);
+    };
+  }, []);
   const beginCrossNodeSelectionDrag = React.useCallback(
     (startBoundary, pointerId, startX, startY) => {
       tableSelectionDragRef.current = {
@@ -36864,6 +37052,8 @@ function DocxEditorViewer({
     if (Date.now() < paginationMeasurementSuspendUntilRef.current) {
       return;
     }
+    const rootElement = viewerRootRef.current;
+    const zoomScale = rootElement ? resolveEffectiveZoomScale(rootElement) : virtualizerMeasurementScale;
     const nextMeasuredHeights = {};
     editor.model.nodes.forEach((node, nodeIndex) => {
       if (node.type !== "table") {
@@ -36879,7 +37069,8 @@ function DocxEditorViewer({
         if (normalizedRowIndex >= node.rows.length || !visibleRowIndexes.has(normalizedRowIndex)) {
           return;
         }
-        const normalizedHeight = normalizeMeasuredTableRowHeightPx(rowHeightPx);
+        const documentRowHeightPx = Number.isFinite(zoomScale) && zoomScale > 0 ? rowHeightPx / zoomScale : rowHeightPx;
+        const normalizedHeight = normalizeMeasuredTableRowHeightPx(documentRowHeightPx);
         const previousHeight = measuredByRowIndex.get(normalizedRowIndex);
         measuredByRowIndex.set(
           normalizedRowIndex,
@@ -37008,6 +37199,7 @@ function DocxEditorViewer({
     tableColumnWidths,
     tableRowHeights,
     tableDraftLayoutEpoch,
+    virtualizerMeasurementScale,
     visibleTableRowIndexesByNodeIndex
   ]);
   const normalizeResizableHeights = React.useCallback(
@@ -42056,6 +42248,18 @@ function DocxEditorViewer({
         ...leadingCoverLayoutSpacer ? {
           minHeight: `${estimateParagraphLineHeightPx(node, nodeDocGridLinePitchPx) + EMPTY_PARAGRAPH_EXTRA_HEIGHT_PX + LEADING_COVER_SPACER_EXTRA_HEIGHT_PX}px`
         } : void 0,
+        // Carry the paragraph's run font on the editable host so text typed into
+        // it (which is a bare, not-yet-committed text node, not a styled run
+        // span) renders in the same font the committed run will use — i.e. the
+        // font shown in the toolbar — instead of inheriting a generic default.
+        // Rendered runs set their own font on their span, so this only affects
+        // freshly typed/empty content. When the paragraph has no explicit run
+        // font we leave it unset so the document default still applies.
+        ...(() => {
+          const runStyle = firstRunStyle(node);
+          const hostFontFamily = cssFontFamily(runStyle?.fontFamily);
+          return hostFontFamily ? { fontFamily: hostFontFamily } : {};
+        })(),
         outline: "none"
       };
       let fallbackParagraphRuns;
@@ -42281,6 +42485,16 @@ function DocxEditorViewer({
             if (!editable) {
               return;
             }
+            const mouseUpOffsets = selectionOffsetsWithinElement(
+              event.currentTarget
+            );
+            if (mouseUpOffsets) {
+              pendingEditableCaretRef.current = {
+                nodeIndex,
+                start: mouseUpOffsets.start,
+                end: mouseUpOffsets.end
+              };
+            }
             if (selectionIsExpandedWithinElement(event.currentTarget)) {
               flushActiveRangeFromSelection();
               cancelPendingPointerSelectionReconcile();
@@ -42325,6 +42539,14 @@ function DocxEditorViewer({
               nodeIndex,
               event.currentTarget.innerHTML
             );
+            const typedOffsets = selectionOffsetsWithinElement(
+              event.currentTarget
+            );
+            pendingEditableCaretRef.current = typedOffsets ? {
+              nodeIndex,
+              start: typedOffsets.start,
+              end: typedOffsets.end
+            } : null;
           },
           onCompositionStart: () => {
             if (!editable) {