@stll/folio-core 0.37.5 → 0.39.0

package/dist/compare/__fixtures__/body-sequence.d.ts

@@ -53,10 +53,14 @@ type TableProperties = {
     value: number;
     type: "auto" | "dxa" | "pct";
   };
+  /** `w:bidiVisual`. */
+  bidi?: boolean;
   /** `w:jc` on the table. */
   justification?: "left" | "center" | "right";
   /** `w:tblInd` in twips. */
   indent?: number;
+  /** `w:tblCellSpacing` in twips. */
+  cellSpacing?: number;
   /** `w:tblBorders`, single style on every side, in eighths of a point. */
   borderSize?: number;
   /** `w:shd` fill colour on the table, as six hex digits. */

package/dist/compare/__fixtures__/body-sequence.js

@@ -132,9 +132,9 @@ const MARGIN_SIDES = [
 const borders = (element, sides, size) => `<w:${element}>${sides.map((side) => `<w:${side} w:val="single" w:sz="${String(size)}" w:space="0" w:color="000000"/>`).join("")}</w:${element}>`;
 const margins = (element, value) => `<w:${element}>${MARGIN_SIDES.map((side) => `<w:${side} w:w="${String(value)}" w:type="dxa"/>`).join("")}</w:${element}>`;
 /**
-* `w:tblPr` children in the order CT_TblPrBase declares: tblStyle, tblW, jc,
-* tblInd, tblBorders, shd, tblLayout, tblCellMar, tblLook. `w:tblW` is always
-* written.
+* `w:tblPr` children in the order CT_TblPrBase declares: tblStyle, bidiVisual,
+* tblW, jc, tblCellSpacing, tblInd, tblBorders, shd, tblLayout, tblCellMar,
+* tblLook. `w:tblW` is always written.
 */
 const tableProperties = ({ properties }) => {
 	const width = properties?.width ?? {
@@ -143,8 +143,10 @@ const tableProperties = ({ properties }) => {
 	};
 	return `<w:tblPr>${[
 		...properties?.styleId === void 0 ? [] : [`<w:tblStyle w:val="${properties.styleId}"/>`],
+		...properties?.bidi === void 0 ? [] : [properties.bidi ? "<w:bidiVisual/>" : "<w:bidiVisual w:val=\"0\"/>"],
 		`<w:tblW w:w="${String(width.value)}" w:type="${width.type}"/>`,
 		...properties?.justification === void 0 ? [] : [`<w:jc w:val="${properties.justification}"/>`],
+		...properties?.cellSpacing === void 0 ? [] : [`<w:tblCellSpacing w:w="${String(properties.cellSpacing)}" w:type="dxa"/>`],
 		...properties?.indent === void 0 ? [] : [`<w:tblInd w:w="${String(properties.indent)}" w:type="dxa"/>`],
 		...properties?.borderSize === void 0 ? [] : [borders("tblBorders", BORDER_SIDES, properties.borderSize)],
 		...properties?.shadingFill === void 0 ? [] : [`<w:shd w:val="clear" w:color="auto" w:fill="${properties.shadingFill}"/>`],

package/dist/compare/compare.d.ts

@@ -1,9 +1,10 @@
+import { document_d_exports } from "../types/document.js";
 import { FolioAIEditSkipReason, FolioAIEditSnapshot } from "../ai-edits/types.js";
 import { WordDiffGranularity } from "../ai-edits/word-diff.js";
 import { FolioRevisionStamp } from "../ai-edits/apply.js";
 import { FolioDocumentStoryHandle, FolioDocxReviewer } from "../ai-edits/headless.js";
 import { CompareVerification } from "./verification.js";
-import { CompareChange, CompareDocxApplyError, CompareDocxError, CompareDocxFinalParagraphMarkError, CompareDocxOperationLimitError, CompareDocxOptions, CompareDocxParseError, CompareDocxSerializeError, CompareResult, CompareUnsupportedPart, InvalidCompareDocxOptionsError } from "./types.js";
+import { CompareChange, CompareCompatibility, CompareDocxApplyError, CompareDocxError, CompareDocxFinalParagraphMarkError, CompareDocxOperationLimitError, CompareDocxOptions, CompareDocxParseError, CompareDocxSerializeError, CompareResult, CompareUnsupportedPart, InvalidCompareDocxOptionsError } from "./types.js";
 import { CompareStoryPlan } from "./plan.js";
 import { Result } from "better-result";
 //#region src/compare/compare.d.ts
@@ -17,12 +18,26 @@ type ComparedStoryPair = {
   baseStory: FolioDocumentStoryHandle;
   targetStory: FolioDocumentStoryHandle;
   baseSnapshot: FolioAIEditSnapshot;
+  /** Raw base expectation when Folio-exact staging added an untracked carrier. */
+  rawBaseSnapshot?: FolioAIEditSnapshot;
   targetSnapshot: FolioAIEditSnapshot;
 };
+type FinalSectionComparison = {
+  status: "same";
+} | {
+  status: "stage";
+  previous: document_d_exports.SectionProperties;
+  target: document_d_exports.SectionProperties;
+} | {
+  status: "unsupported";
+  detail: string;
+};
 /** Everything the later stages need, and nothing they have to re-derive. */
 type ParsedComparison = {
   /** Token size a changed paragraph's redline is cut at. */
   granularity: WordDiffGranularity;
+  revisionFormat: "word" | "folio-exact";
+  terminalTableCarrierStaged: boolean;
   /**
    * The base package as it arrived. It is the result when nothing changed, but
    * only when it carried no revisions of its own: otherwise the compared base
@@ -36,6 +51,14 @@ type ParsedComparison = {
   pairs: readonly ComparedStoryPair[];
   /** Package-level numbering differences, which belong to no story. */
   numberingChanges: readonly CompareChange[];
+  targetNumbering: document_d_exports.NumberingDefinitions | null | undefined;
+  targetNumberingReferences: readonly {
+    numId: number;
+    level: number;
+  }[];
+  targetNumberingReferenceMap: ReadonlyMap<number, number>;
+  finalSectionComparison: FinalSectionComparison;
+  styleImportFailure: string | undefined;
   unsupported: readonly CompareUnsupportedPart[];
 };
 /** Stage 1: both packages to editor models, paired story by story. */
@@ -53,6 +76,7 @@ declare const planComparison: ({ pairs }: ParsedComparison) => Result<readonly P
 declare const getCompareSkipDisposition: (reason: FolioAIEditSkipReason) => "fatal" | "unwritable";
 /** What stage 3 produced: the change list, whether it was proven, and whether it wrote anything. */
 type AppliedComparison = {
+  compatibility: CompareCompatibility;
   changes: readonly CompareChange[];
   verification: CompareVerification;
   /**
@@ -76,7 +100,7 @@ type AppliedComparison = {
  * what you could not represent" and "give me nothing unless you can prove it"
  * are both legitimate asks and only the caller knows which one it is making.
  */
-declare const applyComparison: ({ reviewer, revisionStamp, granularity, numberingChanges }: ParsedComparison, planned: readonly PlannedStoryComparison[]) => Result<AppliedComparison, CompareDocxApplyError>;
+declare const applyComparison: ({ reviewer, revisionStamp, granularity, revisionFormat, terminalTableCarrierStaged, numberingChanges, targetNumbering, targetNumberingReferences, targetNumberingReferenceMap, finalSectionComparison, styleImportFailure, pairs }: ParsedComparison, planned: readonly PlannedStoryComparison[]) => Result<AppliedComparison, CompareDocxApplyError | CompareDocxOperationLimitError>;
 /**
  * Stage 4: the result package, with every ZIP entry date pinned.
  *