@file-viewer/docx 0.3.25 → 0.3.27

package/README.md

@@ -37,6 +37,7 @@ const options = {
   preserveComplexFieldResults: true,
   updatePageReferences: false,
   hideWebHiddenContent: false,
+  externalLinkPolicy: "allow",
   progress: ev => console.log(ev.phase, ev.current, ev.total, ev.message)
 };
 
@@ -175,6 +176,8 @@ For Word-authored documents, keep `ignoreLastRenderedPageBreak: false`. Those ma
 
 `w:webHidden` is not hidden by default in this renderer because it only applies to Word's Web Layout view. In Print Layout, Word still displays the TOC tab before the page number and the cached `PAGEREF` result even when those runs are marked `w:webHidden`. Set `hideWebHiddenContent: true` only for an explicit Web Layout style preview.
 
+External hyperlinks remain active by default. Set `externalLinkPolicy: "block"` to omit their `href` while preserving their text and target metadata. Document-internal bookmark links remain active in either mode.
+
 Set `darkMode: true` to reproduce Word Online's "Switch Modes" dark appearance. Every color the renderer emits — text, backgrounds/highlights, borders, underlines, theme colors and DrawingML/VML shape fills and strokes — is converted with the same lightness-inversion algorithm Microsoft uses for this exact purpose (see `roosterjs`'s `getDarkColor`): the color is converted to CIE Lab, only the lightness (`L`) channel is inverted around a fixed base value (the `L` of `#333333`), and hue/chroma (`a`/`b`) are left untouched. That guarantees every color stays legible on a dark page — pure black becomes pure white, pure white becomes `#333333`, and an arbitrary color such as `rgb(99, 36, 35)` keeps its reddish hue while becoming light enough to read — without the hue-flipping side effects of a naive per-channel RGB invert. The toggle is purely a rendering-time CSS transform — it does not change the parsed document model — and every transformed color is wrapped in a CSS variable so that `@media print` can restore the exact original light-mode value; print output always renders with Word's normal light appearance regardless of `darkMode`.
 
 Header/footer selection follows the WordprocessingML print-layout rules: `first` header/footer references are used only when the section has `w:titlePg`, and `even` references are used only when document settings contain `w:evenAndOddHeaders`; otherwise the default/odd header is used. This prevents even-page empty headers from hiding the normal header in documents that merely contain unused even header references.

package/dist/docx-preview.d.ts

@@ -20,6 +20,7 @@ export interface Options {
     preserveComplexFieldResults: boolean;
     updatePageReferences: boolean;
     hideWebHiddenContent: boolean;
+    externalLinkPolicy: "allow" | "block";
     darkMode: boolean;
     debug: boolean;
     experimental: boolean;