@beyondwork/docx-react-component 1.0.59 → 1.0.61

package/src/io/ooxml/parse-paragraph-formatting.ts

@@ -132,11 +132,35 @@ function readShading(node: XmlElementNode): ParagraphShading | undefined {
   const val = node.attributes["w:val"] ?? node.attributes.val;
   const fill = node.attributes["w:fill"] ?? node.attributes.fill;
   const color = node.attributes["w:color"] ?? node.attributes.color;
-  if (!val && !fill && !color) return undefined;
+  const themeFill = node.attributes["w:themeFill"] ?? node.attributes.themeFill;
+  const themeFillTint = node.attributes["w:themeFillTint"] ?? node.attributes.themeFillTint;
+  const themeFillShade = node.attributes["w:themeFillShade"] ?? node.attributes.themeFillShade;
+  const themeColor = node.attributes["w:themeColor"] ?? node.attributes.themeColor;
+  const themeColorTint = node.attributes["w:themeColorTint"] ?? node.attributes.themeColorTint;
+  const themeColorShade = node.attributes["w:themeColorShade"] ?? node.attributes.themeColorShade;
+  if (
+    !val &&
+    !fill &&
+    !color &&
+    !themeFill &&
+    !themeFillTint &&
+    !themeFillShade &&
+    !themeColor &&
+    !themeColorTint &&
+    !themeColorShade
+  ) {
+    return undefined;
+  }
   return {
     ...(val ? { val } : {}),
     ...(fill ? { fill } : {}),
     ...(color ? { color } : {}),
+    ...(themeFill ? { themeFill } : {}),
+    ...(themeFillTint ? { themeFillTint } : {}),
+    ...(themeFillShade ? { themeFillShade } : {}),
+    ...(themeColor ? { themeColor } : {}),
+    ...(themeColorTint ? { themeColorTint } : {}),
+    ...(themeColorShade ? { themeColorShade } : {}),
   };
 }
 

package/src/io/ooxml/parse-settings.ts

@@ -3,6 +3,7 @@ import type {
   ClrSchemeMapping,
   ClrSchemeMappingSlot,
   DocumentSettings,
+  FootnoteProperties,
   ThemeColorSlot,
 } from "../../model/canonical-document.ts";
 import { parseXml } from "./xml-parser.ts";
@@ -51,6 +52,13 @@ export function parseSettingsXml(xml: string): DocumentSettings {
   const compatPartition = compat ? partitionCompat(compat) : undefined;
   const rootCompatFlags = readRootCompatFlags(settingsElement);
   const themeFontLangElement = findChildElementOptional(settingsElement, "themeFontLang");
+  const defaultTabStop = readDefaultTabStop(settingsElement);
+  const footnotePr = readFootnoteLikeProperties(
+    findChildElementOptional(settingsElement, "footnotePr"),
+  );
+  const endnotePr = readFootnoteLikeProperties(
+    findChildElementOptional(settingsElement, "endnotePr"),
+  );
   const clrSchemeMapping = parseClrSchemeMapping(settingsElement);
   const unmodelled = readUnmodelledSettingsChildren(settingsElement);
 
@@ -71,6 +79,9 @@ export function parseSettingsXml(xml: string): DocumentSettings {
     ...(themeFontLangElement
       ? { themeFontLang: { ...themeFontLangElement.attributes } }
       : {}),
+    ...(defaultTabStop !== undefined ? { defaultTabStop } : {}),
+    ...(footnotePr ? { footnotePr } : {}),
+    ...(endnotePr ? { endnotePr } : {}),
     ...(clrSchemeMapping !== undefined ? { clrSchemeMapping } : {}),
     ...(unmodelled.length > 0 ? { unmodelledSettingsChildren: unmodelled } : {}),
   };
@@ -86,6 +97,9 @@ const MODELLED_SETTINGS_CHILD_NAMES = new Set<string>([
   "zoom",
   "compat",
   "themeFontLang",
+  "defaultTabStop",
+  "footnotePr",
+  "endnotePr",
   "clrSchemeMapping",
 ]);
 
@@ -130,6 +144,83 @@ function readRootCompatFlags(
   return flags;
 }
 
+function readDefaultTabStop(
+  settingsElement: XmlElementNode,
+): number | undefined {
+  const element = findChildElementOptional(settingsElement, "defaultTabStop");
+  if (!element) return undefined;
+  const rawValue = element.attributes["w:val"] ?? element.attributes.val;
+  if (!rawValue) return undefined;
+  const parsed = Number.parseInt(rawValue, 10);
+  return Number.isFinite(parsed) ? parsed : undefined;
+}
+
+function readFootnoteLikeProperties(
+  element: XmlElementNode | undefined,
+): FootnoteProperties | undefined {
+  if (!element) return undefined;
+
+  const result: FootnoteProperties = {};
+  for (const child of element.children) {
+    if (child.type !== "element") continue;
+    const name = localName(child.name);
+    const val = child.attributes["w:val"] ?? child.attributes.val;
+
+    if (name === "pos") {
+      if (
+        val === "pageBottom" ||
+        val === "beneathText" ||
+        val === "sectEnd" ||
+        val === "docEnd"
+      ) {
+        result.pos = val;
+      }
+      continue;
+    }
+
+    if (name === "numFmt") {
+      if (
+        val === "decimal" ||
+        val === "upperRoman" ||
+        val === "lowerRoman" ||
+        val === "upperLetter" ||
+        val === "lowerLetter" ||
+        val === "ordinal" ||
+        val === "cardinalText" ||
+        val === "ordinalText" ||
+        val === "hex" ||
+        val === "chicago" ||
+        val === "bullet" ||
+        val === "ideographDigital" ||
+        val === "japaneseCounting" ||
+        val === "arabicAbjad" ||
+        val === "arabicAlpha" ||
+        val === "none"
+      ) {
+        result.numFmt = val;
+      }
+      continue;
+    }
+
+    if (name === "numStart") {
+      const parsed = Number.parseInt(val ?? "", 10);
+      if (Number.isFinite(parsed)) {
+        result.numStart = Math.max(1, parsed);
+      }
+      continue;
+    }
+
+    if (
+      name === "numRestart" &&
+      (val === "continuous" || val === "eachSect" || val === "eachPage")
+    ) {
+      result.numRestart = val;
+    }
+  }
+
+  return Object.keys(result).length > 0 ? result : undefined;
+}
+
 interface CompatPartition {
   compatSettings: CompatSetting[];
   compatFlags: Record<string, boolean>;
@@ -218,4 +309,3 @@ function readZoomLevel(
 
   return { zoomLevel: parsed };
 }
-

package/src/io/ooxml/workflow-payload.ts

@@ -13,6 +13,7 @@ import type {
   WorkflowWorkItem,
 } from "../../api/public-types.ts";
 import type { EditorStateNamespace, EditorStateLocation } from "../../api/editor-state-types.ts";
+import { sha256Hex } from "../source-package-provenance.ts";
 import {
   validateWorkflowPayloadEnvelope,
   type ValidatorIssue,
@@ -42,6 +43,8 @@ export interface EditorStatePayload {
   unknownNamespaces?: Array<{ name: string; rawXml: string }>;
 }
 
+const workflowAnchorHashEncoder = new TextEncoder();
+
 // ---------------------------------------------------------------------------
 // Schema 1.1 parser helpers (fail-closed per spec §8.2)
 // ---------------------------------------------------------------------------
@@ -747,7 +750,9 @@ function createAnchorBindingHash(
   from: number,
   to: number,
 ): string {
-  return `${serializeStoryTargetKey(storyTarget)}:${from}:${to}`;
+  return sha256Hex(
+    workflowAnchorHashEncoder.encode(`${serializeStoryTargetKey(storyTarget)}:${from}:${to}`),
+  );
 }
 
 function getPreservedExtensionsXml(sourcePackage: OpcPackage, payloadPartPath: string): string {

package/src/model/canonical-document.ts

@@ -346,14 +346,20 @@ export interface FootnoteDefinition {
  * footnote/endnote entries with `w:type="separator"` and
  * `w:type="continuationSeparator"`.
  *
- * Content is stored as raw inner XML (the run children of the <w:p>) so
- * Lane 3a page-chrome can render the horizontal rule without re-parsing.
+ * The canonical model keeps both the legacy run-only payload and the full
+ * first-paragraph XML. The paragraph form closes round-trip fidelity for
+ * imported separator paragraph properties, while the run form remains for
+ * back-compat with the current note-separator runtime helpers.
  */
 export interface FootnoteSeparators {
   /** Raw XML of the <w:r> children inside the separator paragraph. */
   separatorContent?: string;
+  /** Full XML of the first separator paragraph. */
+  separatorParagraphXml?: string;
   /** Raw XML of the <w:r> children inside the continuationSeparator paragraph. */
   continuationSeparatorContent?: string;
+  /** Full XML of the first continuation-separator paragraph. */
+  continuationSeparatorParagraphXml?: string;
 }
 
 export interface FootnoteCollection {
@@ -399,6 +405,22 @@ export interface CompatSetting {
 export interface DocumentSettings {
   evenAndOddHeaders?: boolean;
   zoomLevel?: "pageWidth" | "onePage" | number;
+  /**
+   * Document-wide default tab stop interval from `<w:defaultTabStop w:val>`.
+   * Value is stored in twips and feeds layout measurement whenever a paragraph
+   * does not declare an explicit next tab stop.
+   */
+  defaultTabStop?: number;
+  /**
+   * Settings-level default footnote configuration from `<w:footnotePr>`.
+   * Section-level `SectionProperties.footnotePr` overrides this when present.
+   */
+  footnotePr?: FootnoteProperties;
+  /**
+   * Settings-level default endnote configuration from `<w:endnotePr>`.
+   * Section-level `SectionProperties.endnotePr` overrides this when present.
+   */
+  endnotePr?: EndnoteProperties;
   /**
    * Ordered list of <w:compatSetting> entries inside <w:compat>. Insertion
    * order is preserved for serializer diff stability.
@@ -606,6 +628,18 @@ export interface ParagraphShading {
   fill?: string;
   color?: string;
   val?: string;
+  /**
+   * Theme shading references (§17.3.5). When `themeFill` is set and `fill`
+   * is absent or `"auto"`, render-time shading resolves through the theme
+   * color resolver. The raw theme attrs remain on the canonical model so
+   * export can round-trip the original `<w:shd>` byte-for-byte.
+   */
+  themeFill?: string;
+  themeFillTint?: string;
+  themeFillShade?: string;
+  themeColor?: string;
+  themeColorTint?: string;
+  themeColorShade?: string;
 }
 
 /** Body of an OOXML `<w:rPr>` (run properties). All fields optional; absence = "not specified at this level". */

package/src/model/snapshot.ts

@@ -28,6 +28,7 @@ export type EditorWarningCode =
   | "export_roundtrip_risk"
   | "comment_anchor_detached"
   | "revision_anchor_detached"
+  | "workflow_scope_invalidated"
   | "large_document_degraded"
   | "font_substitution"
   | "image_missing"
@@ -235,6 +236,7 @@ const EDITOR_WARNING_CODES = new Set<EditorWarningCode>([
   "export_roundtrip_risk",
   "comment_anchor_detached",
   "revision_anchor_detached",
+  "workflow_scope_invalidated",
   "large_document_degraded",
   "font_substitution",
   "image_missing",

package/src/runtime/diagnostics/build-diagnostic.ts

@@ -131,6 +131,7 @@ export function buildDiagnosticFromLegacyWarningCode(
     | "export_roundtrip_risk"
     | "comment_anchor_detached"
     | "revision_anchor_detached"
+    | "workflow_scope_invalidated"
     | "large_document_degraded"
     | "font_substitution"
     | "image_missing",
@@ -143,6 +144,7 @@ export function buildDiagnosticFromLegacyWarningCode(
     export_roundtrip_risk: "export.roundtrip_risk",
     comment_anchor_detached: "review.comment_anchor_detached",
     revision_anchor_detached: "review.revision_anchor_detached",
+    workflow_scope_invalidated: "runtime.workflow_scope_invalidated",
     large_document_degraded: "runtime.large_document_degraded",
     font_substitution: "runtime.font_substitution",
     image_missing: "runtime.image_missing",

package/src/runtime/diagnostics/code-metadata-table.ts

@@ -80,6 +80,15 @@ export const CODE_METADATA_TABLE: Readonly<
   "review.revision_anchor_detached": row("review", "info",
     "A tracked change's anchor was invalidated by a structural edit.",
     "retry-safe", { kind: "none" }, ["review", "tracked-change"], "review-revision-anchor-detached"),
+  "runtime.workflow_scope_invalidated": row("runtime", "warning",
+    "A workflow scope lost its trusted anchor and is no longer enforcing against live text.",
+    "requires-input",
+    {
+      kind: "fallback",
+      suggestion:
+        "Use warning.details.scopeId + warning.details.lastKnownRange to relocate the intended text, then reapply the scope.",
+    },
+    ["runtime", "workflow", "scope"], "runtime-workflow-scope-invalidated"),
   "runtime.large_document_degraded": row("runtime", "warning",
     "The document is large enough that some rendering optimizations have been relaxed.",
     "retry-safe", { kind: "none" }, ["runtime", "perf"], "runtime-large-document-degraded"),