@stll/folio-core 0.35.1 → 0.37.0

package/dist/compare/formatting.d.ts

@@ -1,16 +1,16 @@
-import { FolioAIBlock, FolioAIInlineFormatting } from "../ai-edits/types.js";
+import { FolioContentBlock, FolioContentInlineFormattingPatch } from "./content-types.js";
 //#region src/compare/formatting.d.ts
 /** One run of characters whose supported inline formatting differs. */
 type InlineFormattingSegment = {
   /** Zero-based UTF-16 offset into the block's visible text. */
   startOffset: number;
   endOffset: number;
-  /** Only the properties that differ, set to the target document's value. */
-  formatting: FolioAIInlineFormatting;
+  /** Differing properties set to the target value; null removes a direct property. */
+  formatting: FolioContentInlineFormattingPatch;
 };
 type InlineFormattingSegmentsOptions = {
-  baseBlock: FolioAIBlock;
-  targetBlock: FolioAIBlock;
+  baseBlock: FolioContentBlock;
+  targetBlock: FolioContentBlock;
   /** Refuse (return `null`) rather than build more segments than this. */
   maxSegments: number;
 };

package/dist/compare/formatting.js

@@ -1,6 +1,8 @@
-import { resolveColorToHex } from "../utils/colorResolver.js";
 //#region src/compare/formatting.ts
-const normalizeInlineFormattingColor = (color) => resolveColorToHex(color === void 0 ? void 0 : { rgb: color }, null);
+const HEX_COLOR = /^#?(?:[0-9A-Fa-f]{3}|[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$/u;
+const normalizeInlineFormattingColor = (color) => HEX_COLOR.test(color) ? color.replace(/^#/u, "").toUpperCase() : color;
+const normalizeEffectiveInlineFormattingColor = (color) => color === void 0 ? void 0 : normalizeInlineFormattingColor(color);
+const normalizeDirectInlineFormattingColor = (color) => color === null || color === void 0 ? color : normalizeInlineFormattingColor(color);
 const changedStringValue = (baseEffective, targetEffective, baseAuthored, targetAuthored) => {
 	if (baseAuthored !== targetAuthored) return targetAuthored ?? null;
 	return baseEffective === targetEffective ? void 0 : targetEffective ?? null;
@@ -14,7 +16,7 @@ const changedSupportedFormatting = (base, target) => {
 	const targetDirect = target.directFormatting ?? {};
 	const formatting = {};
 	const changedBoolean = (property) => {
-		if (baseDirect[property] !== targetDirect[property]) return targetDirect[property] === true;
+		if (baseDirect[property] !== targetDirect[property]) return targetDirect[property] ?? null;
 		return Boolean(base[property]) === Boolean(target[property]) ? void 0 : Boolean(target[property]);
 	};
 	for (const property of [
@@ -30,7 +32,7 @@ const changedSupportedFormatting = (base, target) => {
 	if (fontFamily !== void 0) formatting.fontFamily = fontFamily;
 	const fontSizePt = changedNumberValue(base.fontSizePt, target.fontSizePt, baseDirect.fontSizePt, targetDirect.fontSizePt);
 	if (fontSizePt !== void 0) formatting.fontSizePt = fontSizePt;
-	const color = changedStringValue(normalizeInlineFormattingColor(base.color), normalizeInlineFormattingColor(target.color), normalizeInlineFormattingColor(baseDirect.color ?? void 0), normalizeInlineFormattingColor(targetDirect.color ?? void 0));
+	const color = changedStringValue(normalizeEffectiveInlineFormattingColor(base.color), normalizeEffectiveInlineFormattingColor(target.color), normalizeDirectInlineFormattingColor(baseDirect.color), normalizeDirectInlineFormattingColor(targetDirect.color));
 	if (color !== void 0) formatting.color = color;
 	return formatting;
 };

package/dist/compare/plan.d.ts

@@ -1,6 +1,7 @@
 import { FolioAIEditOperation, FolioAIEditSnapshot } from "../ai-edits/types.js";
 import { TableGeometryPairing } from "../ai-edits/table-geometry.js";
 import { FolioDocumentStoryHandle } from "../ai-edits/headless.js";
+import { FolioContentComparisonWorkSession } from "./content.js";
 import { CompareChange } from "./types.js";
 //#region src/compare/plan.d.ts
 /**
@@ -42,11 +43,15 @@ type PlanStoryCompareOptions = {
   targetSnapshot: FolioAIEditSnapshot;
   /** Cap on generated operations; the caller turns `null` into its own error. */
   maxOperations: number;
+  /** Avoid structural fallback when copying the target table would lose package-bound content. */
+  wholeTableReplacement?: "allow" | "avoid";
+  /** Shared comparison budget across every story in one package. */
+  workSession?: FolioContentComparisonWorkSession;
 };
 /**
  * Plan one story's comparison, or `null` when it needs more operations than
  * `maxOperations`.
  */
-declare const planStoryCompare: ({ story, baseSnapshot, targetSnapshot, maxOperations }: PlanStoryCompareOptions) => CompareStoryPlan | null;
+declare const planStoryCompare: ({ story, baseSnapshot, targetSnapshot, maxOperations, wholeTableReplacement, workSession }: PlanStoryCompareOptions) => CompareStoryPlan | null;
 //#endregion
 export { CompareStoryPlan, CompareTableTemplateRequest, PlanStoryCompareOptions, planStoryCompare };