@stll/folio-core 0.28.0 → 0.29.0

package/dist/prosemirror/plugins/pmTextScan.js

@@ -10,10 +10,24 @@ const collectBlockChunks = (doc) => {
 		if (node.isTextblock) {
 			const chunks = [];
 			node.descendants((child, offset) => {
-				if (child.isText && child.text !== void 0) chunks.push({
-					text: child.text,
-					start: pos + 1 + offset
-				});
+				if (child.isText && child.text !== void 0) {
+					const start = pos + 1 + offset;
+					chunks.push({
+						text: child.text,
+						start,
+						end: start + child.text.length
+					});
+					return false;
+				}
+				if (child.isLeaf && child.textContent) {
+					const start = pos + 1 + offset;
+					chunks.push({
+						text: child.textContent,
+						start,
+						end: start + child.nodeSize
+					});
+					return false;
+				}
 				return true;
 			});
 			if (chunks.length > 0) blocks.push(chunks);
@@ -24,14 +38,21 @@ const collectBlockChunks = (doc) => {
 	return blocks;
 };
 /** Map a joined-string offset back to its PM doc position. */
-const offsetToDocPos = (chunks, offset) => {
+const offsetToDocPos = (chunks, offset, bias = "start") => {
 	let consumed = 0;
 	for (const chunk of chunks) {
-		if (offset <= consumed + chunk.text.length) return chunk.start + (offset - consumed);
+		if (offset <= consumed + chunk.text.length) {
+			const localOffset = offset - consumed;
+			const end = chunk.end ?? chunk.start + chunk.text.length;
+			if (end - chunk.start === chunk.text.length) return chunk.start + localOffset;
+			if (localOffset === 0) return chunk.start;
+			if (localOffset === chunk.text.length || bias === "end") return end;
+			return chunk.start;
+		}
 		consumed += chunk.text.length;
 	}
 	const last = chunks.at(-1);
-	return last ? last.start + last.text.length : 0;
+	return last ? last.end ?? last.start + last.text.length : 0;
 };
 /** Join a block's chunks into the single string callers scan. */
 const joinChunks = (chunks) => chunks.map((c) => c.text).join("");

package/dist/prosemirror/plugins/templateDirectives.js

@@ -71,7 +71,7 @@ const scanDirectives = (doc) => {
 			const last = chunks.at(-1);
 			ranges.push({
 				from: chunks[0]?.start ?? 0,
-				to: last ? last.start + last.text.length : 0,
+				to: last ? last.end ?? last.start + last.text.length : 0,
 				kind: sole.meta.kind,
 				expr: directiveExpr(sole.meta),
 				block: true
@@ -82,7 +82,7 @@ const scanDirectives = (doc) => {
 			const clauseVersion = marker.meta.kind === "clause" ? marker.meta.version : void 0;
 			ranges.push({
 				from: offsetToDocPos(chunks, marker.start),
-				to: offsetToDocPos(chunks, marker.end),
+				to: offsetToDocPos(chunks, marker.end, "end"),
 				kind: marker.meta.kind,
 				expr: directiveExpr(marker.meta),
 				block: false,

package/dist/prosemirror/schema/index.d.ts

@@ -1,5 +1,5 @@
 import { CharacterSpacingAttrs, CharacterStyleAttrs, CommentAttrs, EmphasisMarkAttrs, FontFamilyAttrs, FontSizeAttrs, FootnoteRefAttrs, HighlightAttrs, HyperlinkAttrs, LanguageAttrs, RunFormattingOverrideAttrs, RunPropertyChangeMarkAttrs, RunShadingAttrs, StrikeAttrs, TextColorAttrs, TextEffectAttrs, TrackedChangeMarkAttrs, UnderlineAttrs } from "./marks.js";
-import { BlockSdtAttrs, FieldAttrs, HardBreakAttrs, ImageAttrs, ImagePositionAttrs, MathAttrs, ParagraphAttrs, ParagraphPropertyChangeAttrs, SdtAttrs, ShapeAttrs, SymbolAttrs, TabAttrs, TableAttrs, TableCellAttrs, TableRowAttrs, TextBoxAttrs } from "./nodes.js";
+import { BlockSdtAttrs, BookmarkBoundaryAttrs, FieldAttrs, HardBreakAttrs, ImageAttrs, ImagePositionAttrs, MathAttrs, ParagraphAttrs, ParagraphPropertyChangeAttrs, SdtAttrs, ShapeAttrs, SymbolAttrs, TabAttrs, TableAttrs, TableCellAttrs, TableRowAttrs, TextBoxAttrs } from "./nodes.js";
 import { ExtensionManager } from "../extensions/ExtensionManager.js";
 //#region src/prosemirror/schema/index.d.ts
 declare const singletonManager: ExtensionManager;
@@ -11,4 +11,4 @@ type DocxSchema = typeof schema;
 type DocxNode = ReturnType<typeof schema.node>;
 type DocxMark = ReturnType<typeof schema.mark>;
 //#endregion
-export { type BlockSdtAttrs, type CharacterSpacingAttrs, type CharacterStyleAttrs, type CommentAttrs, DocxMark, DocxNode, DocxSchema, type EmphasisMarkAttrs, type FieldAttrs, type FontFamilyAttrs, type FontSizeAttrs, type FootnoteRefAttrs, type HardBreakAttrs, type HighlightAttrs, type HyperlinkAttrs, type ImageAttrs, type ImagePositionAttrs, type LanguageAttrs, type MathAttrs, type ParagraphAttrs, type ParagraphPropertyChangeAttrs, type RunFormattingOverrideAttrs, type RunPropertyChangeMarkAttrs, type RunShadingAttrs, type SdtAttrs, type ShapeAttrs, type StrikeAttrs, type SymbolAttrs, type TabAttrs, type TableAttrs, type TableCellAttrs, type TableRowAttrs, type TextBoxAttrs, type TextColorAttrs, type TextEffectAttrs, type TrackedChangeMarkAttrs, type UnderlineAttrs, schema, singletonManager };
+export { type BlockSdtAttrs, type BookmarkBoundaryAttrs, type CharacterSpacingAttrs, type CharacterStyleAttrs, type CommentAttrs, DocxMark, DocxNode, DocxSchema, type EmphasisMarkAttrs, type FieldAttrs, type FontFamilyAttrs, type FontSizeAttrs, type FootnoteRefAttrs, type HardBreakAttrs, type HighlightAttrs, type HyperlinkAttrs, type ImageAttrs, type ImagePositionAttrs, type LanguageAttrs, type MathAttrs, type ParagraphAttrs, type ParagraphPropertyChangeAttrs, type RunFormattingOverrideAttrs, type RunPropertyChangeMarkAttrs, type RunShadingAttrs, type SdtAttrs, type ShapeAttrs, type StrikeAttrs, type SymbolAttrs, type TabAttrs, type TableAttrs, type TableCellAttrs, type TableRowAttrs, type TextBoxAttrs, type TextColorAttrs, type TextEffectAttrs, type TrackedChangeMarkAttrs, type UnderlineAttrs, schema, singletonManager };

package/dist/prosemirror/schema/marks.d.ts

@@ -121,7 +121,9 @@ type RunPropertyChangeMarkAttrs = {
   provenance: TrackedChangeProvenance;
   suggestionId?: string;
 };
-type RunFormattingOverrideAttrs = { [K in keyof Pick<document_d_exports.TextFormatting, "bold" | "italic" | "strike" | "doubleStrike" | "allCaps" | "smallCaps" | "hidden" | "emboss" | "imprint" | "shadow" | "outline" | "rtl">]?: false; } & {
+type RunFormattingOverrideAttrs = { [K in keyof Pick<document_d_exports.TextFormatting, "bold" | "italic" | "strike" | "allCaps" | "smallCaps" | "hidden" | "emboss" | "imprint" | "shadow" | "outline">]?: boolean; } & {
+  doubleStrike?: false;
+  rtl?: false;
   /** Independent complex-script weight (`w:bCs`). */
   boldCs?: boolean;
   /** Force complex-script formatting for the full run (`w:cs`). */

package/dist/prosemirror/schema/nodes.d.ts

@@ -15,6 +15,16 @@ type SymbolAttrs = {
   font: string;
   char: string;
 };
+type BookmarkBoundaryAttrs = {
+  type: "start";
+  id: number;
+  name: string;
+  colFirst?: number;
+  colLast?: number;
+} | {
+  type: "end";
+  id: number;
+};
 /**
  * Paragraph node attributes - maps to ParagraphFormatting
  */
@@ -292,6 +302,8 @@ type FieldAttrs = {
   instruction: string;
   /** Current/cached display text */
   displayText: string;
+  /** Imported cache that proved numbered REF resolution for this field. */
+  _numberedRefBaseline?: string;
   /** Whether the field came from w:fldSimple or a complex fldChar range */
   fieldKind: "simple" | "complex";
   /** Field is locked */
@@ -706,4 +718,4 @@ type TableCellAttrs = {
   _docxVMergeContinuationCells?: document_d_exports.TableCell[];
 };
 //#endregion
-export { BlockSdtAttrs, FieldAttrs, HardBreakAttrs, ImageAttrs, ImagePositionAttrs, MathAttrs, ParagraphAttrs, ParagraphPropertyChangeAttrs, SdtAttrs, ShapeAttrs, SuggestedStructuralMarker, SymbolAttrs, TabAttrs, TableAttrs, TableCellAttrs, TableRowAttrs, TextBoxAnchorAttrs, TextBoxAttrs };
+export { BlockSdtAttrs, BookmarkBoundaryAttrs, FieldAttrs, HardBreakAttrs, ImageAttrs, ImagePositionAttrs, MathAttrs, ParagraphAttrs, ParagraphPropertyChangeAttrs, SdtAttrs, ShapeAttrs, SuggestedStructuralMarker, SymbolAttrs, TabAttrs, TableAttrs, TableCellAttrs, TableRowAttrs, TextBoxAnchorAttrs, TextBoxAttrs };

package/dist/prosemirror/styles/styleResolver.d.ts

@@ -127,7 +127,6 @@ declare class StyleResolver {
    */
   hasStyle(styleId: string): boolean;
   private findDefaultStyle;
-  private mergeStyleIntoResult;
 }
 /**
  * Create a style resolver from document's style definitions

package/dist/prosemirror/styles/styleResolver.js

@@ -1,5 +1,5 @@
 import { mergeParagraphFormatting } from "../../utils/paragraphFormattingMerge.js";
-import { mergeTextFormatting } from "../../utils/textFormattingMerge.js";
+import { cascadeStyleTextFormatting } from "./styleToggleCascade.js";
 //#region src/prosemirror/styles/styleResolver.ts
 /**
 * Word's default-template Normal style, used as a last-resort fallback for a
@@ -102,21 +102,23 @@ var StyleResolver = class {
 	resolveParagraphStyleCascade(styleId, tableParagraphOverlay) {
 		const result = {};
 		if (this.docDefaults?.pPr) result.paragraphFormatting = { ...this.docDefaults.pPr };
-		if (this.docDefaults?.rPr) result.runFormatting = { ...this.docDefaults.rPr };
 		if (tableParagraphOverlay) {
 			const merged = mergeParagraphFormatting(result.paragraphFormatting, tableParagraphOverlay);
 			if (merged !== void 0) result.paragraphFormatting = merged;
 		}
-		if (!styleId) {
-			if (this.defaultParagraphStyle) this.mergeStyleIntoResult(result, this.defaultParagraphStyle);
-			return result;
-		}
-		const style = this.stylesById.get(styleId);
-		if (!style) {
-			if (this.defaultParagraphStyle) this.mergeStyleIntoResult(result, this.defaultParagraphStyle);
-			return result;
+		const style = styleId ? this.stylesById.get(styleId) ?? this.defaultParagraphStyle : this.defaultParagraphStyle;
+		if (style?.pPr) {
+			const merged = mergeParagraphFormatting(result.paragraphFormatting, style.pPr);
+			if (merged) result.paragraphFormatting = merged;
 		}
-		this.mergeStyleIntoResult(result, style);
+		const runFormatting = cascadeStyleTextFormatting([{
+			formatting: this.docDefaults?.rPr,
+			type: "defaults"
+		}, {
+			formatting: style?.rPr,
+			type: "style"
+		}]).formatting;
+		if (runFormatting) result.runFormatting = runFormatting;
 		return result;
 	}
 	/**
@@ -159,14 +161,15 @@ var StyleResolver = class {
 	* @returns Resolved text formatting
 	*/
 	resolveRunStyle(styleId) {
-		let result = {};
-		if (this.docDefaults?.rPr) result = { ...this.docDefaults.rPr };
-		const defaultCharacterRpr = this.defaultCharacterStyle?.rPr;
-		if (defaultCharacterRpr) result = mergeTextFormatting(result, defaultCharacterRpr) ?? {};
-		const style = styleId ? this.stylesById.get(styleId) : void 0;
-		if (!style?.rPr) return Object.keys(result).length > 0 ? result : void 0;
-		const merged = mergeTextFormatting(result, style.rPr);
-		return merged && Object.keys(merged).length > 0 ? merged : void 0;
+		const style = styleId ? this.stylesById.get(styleId) : this.defaultCharacterStyle;
+		const result = cascadeStyleTextFormatting([{
+			formatting: this.docDefaults?.rPr,
+			type: "defaults"
+		}, {
+			formatting: style?.rPr,
+			type: "style"
+		}]).formatting;
+		return result && Object.keys(result).length > 0 ? result : void 0;
 	}
 	/**
 	* Get a character style's own properties WITHOUT docDefaults.
@@ -213,16 +216,6 @@ var StyleResolver = class {
 		for (const style of this.stylesById.values()) if (style.type === type && style.default) return style;
 		if (type === "paragraph") return this.stylesById.get("Normal") ?? (this.docDefaults ? void 0 : BUILTIN_NORMAL_STYLE);
 	}
-	mergeStyleIntoResult(result, style) {
-		if (style.pPr) {
-			const merged = mergeParagraphFormatting(result.paragraphFormatting, style.pPr);
-			if (merged !== void 0) result.paragraphFormatting = merged;
-		}
-		if (style.rPr) {
-			const merged = mergeTextFormatting(result.runFormatting, style.rPr);
-			if (merged !== void 0) result.runFormatting = merged;
-		}
-	}
 };
 /**
 * Create a style resolver from document's style definitions

package/dist/prosemirror/styles/styleToggleCascade.d.ts

@@ -0,0 +1,37 @@
+import { document_d_exports } from "../../types/document.js";
+import { STYLE_TOGGLE_KEYS } from "../../utils/textFormattingMerge.js";
+//#region src/prosemirror/styles/styleToggleCascade.d.ts
+type StyleToggleKey = (typeof STYLE_TOGGLE_KEYS)[number];
+type ToggleState = {
+  value: boolean;
+  defaultsActive: boolean;
+};
+/** Internal formatting value whose toggle history survives copying and separate cascade passes. */
+type StyleTextFormattingCascade = {
+  formatting: document_d_exports.TextFormatting | undefined;
+  toggleStates: ReadonlyMap<StyleToggleKey, ToggleState>;
+  type: "styleToggleCascade";
+};
+type StyleToggleLevel = {
+  formatting: document_d_exports.TextFormatting | undefined;
+  type: "defaults" | "style" | "direct";
+} | {
+  cascade: StyleTextFormattingCascade;
+  type: "carried";
+};
+type StyleToggleCascadeOptions = {
+  /** Existing ordinary-property merge whose toggle fields this cascade replaces. */
+  ordinaryFormatting: document_d_exports.TextFormatting | undefined;
+};
+/**
+ * Resolve run formatting across OOXML style hierarchy levels.
+ *
+ * Ordinary properties retain Folio's existing low-to-high, last-defined merge. Toggle
+ * properties reverse inherited state when a style level states `true`; `false` leaves inherited
+ * style state unchanged, while direct formatting remains an absolute value. The returned value
+ * carries its toggle history explicitly, so paragraph and character style resolution may happen
+ * in separate passes without an object-identity contract.
+ */
+declare function cascadeStyleTextFormatting(levels: readonly StyleToggleLevel[], options?: StyleToggleCascadeOptions): StyleTextFormattingCascade;
+//#endregion
+export { cascadeStyleTextFormatting };

package/dist/prosemirror/styles/styleToggleCascade.js

@@ -0,0 +1,52 @@
+import { STYLE_TOGGLE_KEYS, mergeTextFormatting } from "../../utils/textFormattingMerge.js";
+//#region src/prosemirror/styles/styleToggleCascade.ts
+/**
+* Resolve run formatting across OOXML style hierarchy levels.
+*
+* Ordinary properties retain Folio's existing low-to-high, last-defined merge. Toggle
+* properties reverse inherited state when a style level states `true`; `false` leaves inherited
+* style state unchanged, while direct formatting remains an absolute value. The returned value
+* carries its toggle history explicitly, so paragraph and character style resolution may happen
+* in separate passes without an object-identity contract.
+*/
+function cascadeStyleTextFormatting(levels, options) {
+	let formatting = options ? mergeTextFormatting(void 0, options.ordinaryFormatting) : void 0;
+	const mergeOrdinaryFormatting = options === void 0;
+	const toggleStates = /* @__PURE__ */ new Map();
+	for (const level of levels) {
+		if (level.type === "carried") {
+			if (mergeOrdinaryFormatting) formatting = mergeTextFormatting(formatting, level.cascade.formatting);
+			for (const [key, state] of level.cascade.toggleStates) toggleStates.set(key, state);
+			continue;
+		}
+		if (!level.formatting) continue;
+		if (mergeOrdinaryFormatting) formatting = mergeTextFormatting(formatting, level.formatting);
+		for (const key of STYLE_TOGGLE_KEYS) {
+			const value = level.formatting[key];
+			if (value === void 0) continue;
+			const inherited = toggleStates.get(key);
+			if (level.type === "direct") toggleStates.set(key, {
+				value,
+				defaultsActive: false
+			});
+			else if (!value) continue;
+			else if (level.type === "defaults") toggleStates.set(key, {
+				value: true,
+				defaultsActive: true
+			});
+			else toggleStates.set(key, {
+				value: inherited?.defaultsActive === true ? true : !(inherited?.value ?? false),
+				defaultsActive: inherited?.defaultsActive === true
+			});
+		}
+	}
+	if (!formatting && toggleStates.size > 0) formatting = {};
+	for (const [key, state] of toggleStates) if (formatting) formatting[key] = state.value;
+	return {
+		formatting,
+		toggleStates,
+		type: "styleToggleCascade"
+	};
+}
+//#endregion
+export { cascadeStyleTextFormatting };

package/dist/prosemirror/validation.js

@@ -1,4 +1,5 @@
 import { readBlockSdtAttrs, readCharacterSpacingMarkAttrs, readCharacterStyleMarkAttrs, readCommentMarkAttrs, readEmphasisMarkAttrs, readFieldAttrs, readFontFamilyMarkAttrs, readFontSizeMarkAttrs, readFootnoteRefMarkAttrs, readHardBreakAttrs, readHighlightMarkAttrs, readHyperlinkMarkAttrs, readImageAttrs, readLanguageMarkAttrs, readMathAttrs, readParagraphAttrs, readRunFormattingOverrideMarkAttrs, readRunPropertyChangeMarkAttrs, readRunShadingMarkAttrs, readSdtAttrs, readShapeAttrs, readStrikeMarkAttrs, readSymbolAttrs, readTabAttrs, readTableAttrs, readTableCellAttrs, readTableRowAttrs, readTextBoxAttrs, readTextColorMarkAttrs, readTextEffectMarkAttrs, readTrackedChangeMarkAttrs, readUnderlineMarkAttrs } from "./attrs/index.js";
+import { readBookmarkBoundaryAttrs } from "./bookmarkBoundaryAttrs.js";
 import { readTextBoxAnchorAttrs } from "./textBoxAnchorAttrs.js";
 //#region src/prosemirror/validation.ts
 var ProseMirrorDocumentValidationError = class extends Error {
@@ -18,11 +19,71 @@ const validateProseMirrorDocument = (doc) => {
 		message: `Expected doc, got ${doc.type.name}.`
 	});
 	validateNode(doc, "doc", issues);
+	validateBookmarkBoundaryStructure(doc, issues);
 	return {
 		valid: issues.length === 0,
 		issues
 	};
 };
+const validateBookmarkBoundaryStructure = (doc, issues) => {
+	const open = /* @__PURE__ */ new Map();
+	const startedIds = /* @__PURE__ */ new Set();
+	const registerStart = (id, path) => {
+		if (startedIds.has(id)) {
+			issues.push({
+				path,
+				message: `Bookmark id ${id} has more than one start boundary.`
+			});
+			return;
+		}
+		startedIds.add(id);
+		open.set(id, {
+			id,
+			path
+		});
+	};
+	const registerEnd = (id, path) => {
+		if (!open.get(id)) {
+			issues.push({
+				path,
+				message: `Bookmark id ${id} has no open start boundary.`
+			});
+			return;
+		}
+		open.delete(id);
+	};
+	const visit = (node, path) => {
+		const paragraphAttrs = node.type.name === "paragraph" ? readParagraphAttrs(node) : null;
+		if (paragraphAttrs?.ok) for (const [index, bookmark] of (paragraphAttrs.value.bookmarks ?? []).entries()) registerStart(bookmark.id, `${path}.paragraph.attrs.bookmarks[${index}]`);
+		if (node.type.name === "bookmarkBoundary") {
+			const result = readBookmarkBoundaryAttrs(node);
+			if (result.ok) {
+				const attrs = result.value;
+				const hasHyperlink = node.marks.some((mark) => mark.type.name === "hyperlink");
+				const trackedChanges = node.marks.filter((mark) => mark.type.name === "insertion" || mark.type.name === "deletion");
+				if (trackedChanges.length > 1) issues.push({
+					path,
+					message: "Bookmark boundaries cannot carry multiple tracked-change parents."
+				});
+				else if (trackedChanges.length === 1 && !hasHyperlink) issues.push({
+					path,
+					message: "Bookmark boundaries inside tracked changes require a hyperlink serialization parent."
+				});
+				if (attrs.type === "start") registerStart(attrs.id, path);
+				else registerEnd(attrs.id, path);
+			}
+		}
+		node.forEach((child, _offset, index) => {
+			visit(child, `${path}.content[${index}]`);
+		});
+		if (paragraphAttrs?.ok) for (const [index, bookmark] of (paragraphAttrs.value.bookmarks ?? []).entries()) registerEnd(bookmark.id, `${path}.paragraph.attrs.bookmarks[${index}]`);
+	};
+	visit(doc, "doc");
+	for (const boundary of open.values()) issues.push({
+		path: boundary.path,
+		message: `Bookmark id ${boundary.id} has no matching end boundary.`
+	});
+};
 const assertValidProseMirrorDocument = (doc, context) => {
 	if (validDocumentCache.has(doc)) return;
 	const validation = validateProseMirrorDocument(doc);
@@ -50,6 +111,9 @@ const validateNodeAttrs = (node, path, issues) => {
 		case "horizontalRule":
 		case "pageBreak":
 		case "renderedPageBreak": return;
+		case "bookmarkBoundary":
+			appendAttrIssues(path, readBookmarkBoundaryAttrs(node), issues);
+			return;
 		case "tab":
 			appendAttrIssues(path, readTabAttrs(node), issues);
 			return;
@@ -77,6 +141,35 @@ const validateNodeAttrs = (node, path, issues) => {
 			return;
 		case "field":
 			appendAttrIssues(path, readFieldAttrs(node), issues);
+			if (node.childCount > 0) issues.push({
+				path: `${path}.content`,
+				message: "Ordinary fields cannot contain structured result children."
+			});
+			return;
+		case "structuredField":
+			{
+				const fieldAttrs = readFieldAttrs(node);
+				appendAttrIssues(path, fieldAttrs, issues);
+				if (fieldAttrs.ok) {
+					const hasStructuredHyperlink = node.content.content.some((child) => child.marks.some((mark) => mark.type.name === "hyperlink"));
+					if (fieldAttrs.value.fieldKind === "complex") issues.push({
+						path: `${path}.content`,
+						message: "Complex fields cannot contain structured result children."
+					});
+					else if (!hasStructuredHyperlink) issues.push({
+						path: `${path}.content`,
+						message: "Structured simple fields require hyperlink content."
+					});
+					node.forEach((child, _offset, index) => {
+						const childPath = `${path}.content[${index}]`;
+						const hasHyperlink = child.marks.some((mark) => mark.type.name === "hyperlink");
+						if (child.type.name === "bookmarkBoundary" && !hasHyperlink) issues.push({
+							path: childPath,
+							message: "Bookmark boundaries inside fields require a hyperlink parent."
+						});
+					});
+				}
+			}
 			return;
 		case "math":
 			appendAttrIssues(path, readMathAttrs(node), issues);

package/dist/utils/textFormattingMerge.d.ts

@@ -1,5 +1,13 @@
 import { document_d_exports } from "../types/document.js";
 //#region src/utils/textFormattingMerge.d.ts
+declare const STYLE_TOGGLE_KEYS: readonly ["bold", "boldCs", "italic", "italicCs", "allCaps", "emboss", "imprint", "outline", "shadow", "smallCaps", "strike", "hidden"];
+/**
+ * Merge the properties exposed by one resolved style definition.
+ *
+ * A false toggle at a child style level does not cancel the inherited state. The
+ * ordinary merge remains unchanged for direct formatting and non-toggle properties.
+ */
+declare function mergeStyleTextFormatting(target: document_d_exports.TextFormatting | undefined, source: document_d_exports.TextFormatting | undefined): document_d_exports.TextFormatting | undefined;
 declare function mergeTextFormatting(target: document_d_exports.TextFormatting | undefined, source: document_d_exports.TextFormatting | undefined): document_d_exports.TextFormatting | undefined;
 //#endregion
-export { mergeTextFormatting };
+export { STYLE_TOGGLE_KEYS, mergeStyleTextFormatting, mergeTextFormatting };

package/dist/utils/textFormattingMerge.js

@@ -1,5 +1,36 @@
 import { mergeFontFamily } from "./fontFamilyMerge.js";
 //#region src/utils/textFormattingMerge.ts
+const STYLE_TOGGLE_KEYS = [
+	"bold",
+	"boldCs",
+	"italic",
+	"italicCs",
+	"allCaps",
+	"emboss",
+	"imprint",
+	"outline",
+	"shadow",
+	"smallCaps",
+	"strike",
+	"hidden"
+];
+/**
+* Merge the properties exposed by one resolved style definition.
+*
+* A false toggle at a child style level does not cancel the inherited state. The
+* ordinary merge remains unchanged for direct formatting and non-toggle properties.
+*/
+function mergeStyleTextFormatting(target, source) {
+	const result = mergeTextFormatting(target, source);
+	if (!result || !source) return result;
+	for (const key of STYLE_TOGGLE_KEYS) {
+		if (source[key] !== false) continue;
+		const inherited = target?.[key];
+		if (inherited === void 0) Reflect.deleteProperty(result, key);
+		else result[key] = inherited;
+	}
+	return result;
+}
 function mergeTextFormatting(target, source) {
 	if (!source && !target) return;
 	if (!source) return target;
@@ -28,4 +59,4 @@ function mergeTextFormatting(target, source) {
 	return result;
 }
 //#endregion
-export { mergeTextFormatting };
+export { STYLE_TOGGLE_KEYS, mergeStyleTextFormatting, mergeTextFormatting };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stll/folio-core",
-  "version": "0.28.0",
+  "version": "0.29.0",
   "description": "Headless, framework-neutral core of folio: the OOXML (.docx) parser, document model, ProseMirror integration, and page-layout engine. No React.",
   "keywords": [
     "document-model",