rtf-codec 2.1.0 → 3.0.0

package/dist/read.js

@@ -3,7 +3,8 @@ import { RtfDiagnosticCodes, RtfInputTooLargeError, RtfNestingLimitExceededError
 import { appendBytes, asciiStringFromBytes, rtfBytesFromLatin1 } from "./bytes.js";
 import { halfPointsToPoints, pixelsToPoints, twipsToPoints } from "./units.js";
 import { applyCellDefinitionControlWord, newPendingCell, resolveBorder } from "./cell-format.js";
-import { NO_REVISION, bookmarkAnchorDescriptor, coalesceRunConstructs, provenanceDescriptors } from "./constructs.js";
+import { NO_REVISION, bookmarkAnchorDescriptor, coalesceRunConstructs, formFieldContentControl, formFieldControlType, provenanceDescriptors } from "./constructs.js";
+import { readEmbeddedObjectData } from "./embedded-object.js";
 import { decodeCodepageBytes } from "./codepage.js";
 import { groupHead, matchingGroupEnd } from "./group.js";
 import { HEADER_DESTINATIONS, readRtfHeader } from "./header.js";
@@ -22,6 +23,15 @@ const DESTINATION_KINDS = /* @__PURE__ */ new Map([
 	["listtext", "listText"],
 	["pntext", "listText"],
 	["upr", "unicodeWrapper"],
+	["formfield", "formField"],
+	["ffname", "formFieldName"],
+	["ffhelptext", "formFieldHelpText"],
+	["ffl", "formFieldListItem"],
+	["ffdeftext", "skip"],
+	["ffformat", "skip"],
+	["ffstattext", "skip"],
+	["ffentrymcr", "skip"],
+	["ffexitmcr", "skip"],
 	["footnote", "skip"],
 	["header", "skip"],
 	["headerl", "skip"],
@@ -46,10 +56,15 @@ const DESTINATION_KINDS = /* @__PURE__ */ new Map([
 	["atnicn", "skip"],
 	["bkmkstart", "bookmarkStart"],
 	["bkmkend", "bookmarkEnd"],
-	["object", "skip"],
-	["objdata", "skip"],
+	["object", "object"],
+	["objdata", "objectData"],
 	["objclass", "skip"],
 	["objname", "skip"],
+	["oleclsid", "skip"],
+	["objalias", "skip"],
+	["objsect", "skip"],
+	["objtime", "skip"],
+	["result", "skip"],
 	["do", "skip"],
 	["shp", "skip"],
 	["shptxt", "skip"],
@@ -67,6 +82,11 @@ const DESTINATION_KINDS = /* @__PURE__ */ new Map([
 	["fname", "skip"]
 ]);
 const SILENT_SKIP_DESTINATIONS = /* @__PURE__ */ new Set([
+	"ffdeftext",
+	"ffformat",
+	"ffstattext",
+	"ffentrymcr",
+	"ffexitmcr",
 	"pn",
 	"pnseclvl",
 	"nonshppict",
@@ -81,7 +101,11 @@ const SILENT_SKIP_DESTINATIONS = /* @__PURE__ */ new Set([
 	"atnicn",
 	"objclass",
 	"objname",
-	"objdata",
+	"oleclsid",
+	"objalias",
+	"objsect",
+	"objtime",
+	"result",
 	"shpinst",
 	"shptxt",
 	"ftnsep",
@@ -136,6 +160,21 @@ const SECTION_BREAK_TYPES = /* @__PURE__ */ new Map([
 	["sbkeven", "evenPage"],
 	["sbkodd", "oddPage"]
 ]);
+const OBJECT_DATA_HEX_DIGITS = "0123456789abcdef";
+function appendObjectDataHexText(objectData, text) {
+	let high = objectData.pendingHexNibble;
+	for (const character of text) {
+		const value = OBJECT_DATA_HEX_DIGITS.indexOf(character.toLowerCase());
+		if (value === -1) continue;
+		if (high === void 0) {
+			high = value;
+			continue;
+		}
+		objectData.bytes.push(high * 16 + value);
+		high = void 0;
+	}
+	objectData.pendingHexNibble = high;
+}
 function defaultCharacterState() {
 	return {
 		bold: false,
@@ -174,8 +213,15 @@ function cloneGroupState(state) {
 		para: { ...state.para },
 		field: state.field,
 		picture: state.picture,
+		pictureOwner: false,
+		objectData: state.objectData,
+		object: state.object,
+		objectDataOwner: false,
+		objectOwner: false,
+		resultOf: void 0,
 		bookmark: state.bookmark,
-		inUnicodeWrapper: state.inUnicodeWrapper
+		inUnicodeWrapper: state.inUnicodeWrapper,
+		isFieldGroup: state.isFieldGroup
 	};
 }
 function runKey(char, fontName, color, hyperlink) {
@@ -250,6 +296,31 @@ function horizontalSpanAt(definitions, index) {
 	while (definitions[index + span]?.horizontalMergeContinuation === true) span += 1;
 	return span;
 }
+function freshAccumulatorState() {
+	return {
+		blocks: [],
+		runs: [],
+		pendingRunKey: void 0,
+		pendingRunText: "",
+		pendingRunFields: {},
+		runProvenance: [],
+		pendingRunProvenance: [],
+		tableRows: [],
+		tableColumnRights: [],
+		rowCells: [],
+		cellBlocks: [],
+		pendingCellRights: [],
+		pendingCellDefinitions: [],
+		pendingCell: newPendingCell(),
+		rowLeftTwips: 0,
+		paragraphSerial: 0,
+		openBookmarks: /* @__PURE__ */ new Map(),
+		sectionBlockExtents: [],
+		cellBlockExtents: [],
+		pendingRunConstructs: [],
+		closingBookmarks: []
+	};
+}
 var ContentBuilder = class {
 	header;
 	sink;
@@ -275,6 +346,8 @@ var ContentBuilder = class {
 	cellBlockExtents = [];
 	pendingRunConstructs = [];
 	closingBookmarks = [];
+	openFormFields = [];
+	resultScratchStack = [];
 	constructor(header, sink) {
 		this.header = header;
 		this.sink = sink;
@@ -316,6 +389,39 @@ var ContentBuilder = class {
 		}
 		this.closingBookmarks.push(open);
 	}
+	startFormField() {
+		this.flushRun();
+		this.openFormFields.push({
+			paragraphSerial: this.paragraphSerial,
+			runIndex: this.runs.length
+		});
+	}
+	endFormField(descriptor) {
+		this.flushRun();
+		const open = this.openFormFields.pop();
+		if (open === void 0) return;
+		if (descriptor === void 0) {
+			this.sink({
+				code: RtfDiagnosticCodes.FORM_FIELD_KEYWORD_LOST,
+				severity: "warning",
+				message: "a form field's contentControl is dropped: its \\*\\fldinst instruction matched a form-field keyword partway through parsing but no longer did once the complete instruction was read"
+			});
+			return;
+		}
+		if (open.paragraphSerial !== this.paragraphSerial) {
+			this.sink({
+				code: RtfDiagnosticCodes.FORM_FIELD_SPAN_DROPPED,
+				severity: "warning",
+				message: "a form field's contentControl is dropped: its \\fldrslt content crossed a paragraph or table-cell boundary, and this reader's per-paragraph construct extent cannot span one"
+			});
+			return;
+		}
+		this.pendingRunConstructs.push({
+			descriptor,
+			startRun: open.runIndex,
+			endRun: this.runs.length
+		});
+	}
 	appendText(text, char, hyperlink) {
 		if (text.length === 0 || char.hidden) return;
 		const fontName = char.fontIndex === void 0 ? void 0 : this.header.fonts.get(char.fontIndex)?.name;
@@ -558,9 +664,77 @@ var ContentBuilder = class {
 		}
 		return widths;
 	}
-	addBlock(block) {
+	addBlocks(blocks, inTable) {
+		if (blocks.length === 0) return;
 		this.flushRun();
-		this.blocks.push(block);
+		(inTable ? this.cellBlocks : this.blocks).push(...blocks);
+	}
+	captureAccumulatorState() {
+		return {
+			blocks: this.blocks,
+			runs: this.runs,
+			pendingRunKey: this.pendingRunKey,
+			pendingRunText: this.pendingRunText,
+			pendingRunFields: this.pendingRunFields,
+			runProvenance: this.runProvenance,
+			pendingRunProvenance: this.pendingRunProvenance,
+			tableRows: this.tableRows,
+			tableColumnRights: this.tableColumnRights,
+			rowCells: this.rowCells,
+			cellBlocks: this.cellBlocks,
+			pendingCellRights: this.pendingCellRights,
+			pendingCellDefinitions: this.pendingCellDefinitions,
+			pendingCell: this.pendingCell,
+			rowLeftTwips: this.rowLeftTwips,
+			paragraphSerial: this.paragraphSerial,
+			openBookmarks: this.openBookmarks,
+			sectionBlockExtents: this.sectionBlockExtents,
+			cellBlockExtents: this.cellBlockExtents,
+			pendingRunConstructs: this.pendingRunConstructs,
+			closingBookmarks: this.closingBookmarks
+		};
+	}
+	restoreAccumulatorState(saved) {
+		this.blocks = saved.blocks;
+		this.runs = saved.runs;
+		this.pendingRunKey = saved.pendingRunKey;
+		this.pendingRunText = saved.pendingRunText;
+		this.pendingRunFields = saved.pendingRunFields;
+		this.runProvenance = saved.runProvenance;
+		this.pendingRunProvenance = saved.pendingRunProvenance;
+		this.tableRows = saved.tableRows;
+		this.tableColumnRights = saved.tableColumnRights;
+		this.rowCells = saved.rowCells;
+		this.cellBlocks = saved.cellBlocks;
+		this.pendingCellRights = saved.pendingCellRights;
+		this.pendingCellDefinitions = saved.pendingCellDefinitions;
+		this.pendingCell = saved.pendingCell;
+		this.rowLeftTwips = saved.rowLeftTwips;
+		this.paragraphSerial = saved.paragraphSerial;
+		this.openBookmarks = saved.openBookmarks;
+		this.sectionBlockExtents = saved.sectionBlockExtents;
+		this.cellBlockExtents = saved.cellBlockExtents;
+		this.pendingRunConstructs = saved.pendingRunConstructs;
+		this.closingBookmarks = saved.closingBookmarks;
+	}
+	beginResultScratch() {
+		this.flushRun();
+		this.resultScratchStack.push(this.captureAccumulatorState());
+		this.restoreAccumulatorState(freshAccumulatorState());
+	}
+	endResultScratch(para) {
+		this.endParagraph(para, false);
+		this.closeTable();
+		const blocks = [...this.blocks, ...this.cellBlocks];
+		const saved = this.resultScratchStack.pop();
+		if (saved !== void 0) this.restoreAccumulatorState(saved);
+		return blocks;
+	}
+	discardUnclosedResultScratches() {
+		while (this.resultScratchStack.length > 0) {
+			const saved = this.resultScratchStack.pop();
+			if (saved !== void 0) this.restoreAccumulatorState(saved);
+		}
 	}
 	endSection(section, para) {
 		this.endParagraph(para, false);
@@ -589,6 +763,7 @@ var ContentBuilder = class {
 		this.openBookmarks.clear();
 	}
 	finish(metadata, section, para) {
+		this.discardUnclosedResultScratches();
 		this.endSection(section, para);
 		if (this.sections.length === 0) this.sections.push({
 			...sectionGeometry(section),
@@ -700,9 +875,50 @@ function defaultPictureState() {
 		binary: []
 	};
 }
+function objectSizeHintClause(object) {
+	const widthTwips = object?.widthTwips;
+	const heightTwips = object?.heightTwips;
+	if (widthTwips !== void 0 && heightTwips !== void 0) return ` (the object's own \\objw/\\objh declared a ${twipsToPoints(widthTwips).toFixed(2)}pt x ${twipsToPoints(heightTwips).toFixed(2)}pt size)`;
+	if (widthTwips !== void 0) return ` (the object's own \\objw declared a ${twipsToPoints(widthTwips).toFixed(2)}pt width)`;
+	if (heightTwips !== void 0) return ` (the object's own \\objh declared a ${twipsToPoints(heightTwips).toFixed(2)}pt height)`;
+	return "";
+}
+function objectDataBytes(objectData) {
+	return Uint8Array.from(objectData.bytes);
+}
+function buildEmbeddedObject(objectData, object, sink) {
+	const bytes = objectDataBytes(objectData);
+	if (bytes.length === 0) {
+		sink({
+			code: RtfDiagnosticCodes.EMBEDDED_OBJECT_UNREADABLE,
+			severity: "warning",
+			message: `an \\object destination's \\objdata carried no payload${objectSizeHintClause(object)}`
+		});
+		return;
+	}
+	const embedded = readEmbeddedObjectData(bytes);
+	if (embedded === void 0) {
+		sink({
+			code: RtfDiagnosticCodes.EMBEDDED_OBJECT_UNREADABLE,
+			severity: "warning",
+			message: `an \\object destination's \\objdata is not a payload this reader produced (a real OLE object's OLESaveToStream data has no decoder here), so the object is dropped${objectSizeHintClause(object)}; its \\result fallback content, if any, is read in its place`
+		});
+		return;
+	}
+	return {
+		...embedded,
+		kind: "embeddedObject"
+	};
+}
 function toggleValue(param) {
 	return param === void 0 || param !== 0;
 }
+function formFieldValueBit(param) {
+	return param !== void 0 && param !== 0;
+}
+function formFieldValueNumber(param) {
+	return param ?? 0;
+}
 function readRtfDetail(input, options) {
 	options.signal?.throwIfAborted();
 	const maxInputBytes = options.maxInputBytes ?? 67108864;
@@ -726,8 +942,15 @@ function readRtfDetail(input, options) {
 		para: defaultParagraphState(),
 		field: void 0,
 		picture: void 0,
+		pictureOwner: false,
+		objectData: void 0,
+		object: void 0,
+		objectDataOwner: false,
+		objectOwner: false,
+		resultOf: void 0,
 		bookmark: void 0,
-		inUnicodeWrapper: false
+		inUnicodeWrapper: false,
+		isFieldGroup: false
 	};
 	const stack = [root];
 	let state = root;
@@ -755,6 +978,21 @@ function readRtfDetail(input, options) {
 			state.bookmark.name += text;
 			return;
 		}
+		if (state.destination === "formFieldName" && state.field?.formField !== void 0) {
+			state.field.formField.name += text;
+			return;
+		}
+		if (state.destination === "formFieldHelpText" && state.field?.formField !== void 0) {
+			state.field.formField.helpText += text;
+			return;
+		}
+		if (state.destination === "formFieldListItem" && state.field?.formField !== void 0) {
+			const items = state.field.formField.listItems;
+			const last = items.length - 1;
+			const current = items[last];
+			if (current !== void 0) items[last] = current + text;
+			return;
+		}
 	};
 	let index = 0;
 	let textOffset = 0;
@@ -767,7 +1005,24 @@ function readRtfDetail(input, options) {
 			const known = head.destination === void 0 ? void 0 : DESTINATION_KINDS.get(head.destination);
 			const isHeaderTable = head.destination !== void 0 && HEADER_DESTINATIONS.has(head.destination);
 			const wrapperChild = state.inUnicodeWrapper;
-			const kind = isHeaderTable || wrapperChild && head.destination !== "ud" ? "skip" : known ?? (head.ignorable ? "skip" : state.destination);
+			const objectState = state.object;
+			const isResultDestination = head.destination === "result" && objectState !== void 0;
+			const isDuplicateResult = isResultDestination && objectState.resultSeen;
+			if (objectState !== void 0 && isResultDestination) objectState.resultSeen = true;
+			if (isDuplicateResult) sink({
+				code: RtfDiagnosticCodes.EMBEDDED_OBJECT_UNREADABLE,
+				severity: "warning",
+				message: "an \\object destination has more than one \\result child, which RTF's own grammar does not allow; only the first is kept and this one is discarded"
+			});
+			const isObjectDataDestination = head.destination === "objdata" && known === "objectData";
+			const isDuplicateObjectData = isObjectDataDestination && objectState?.objectDataSeen === true;
+			if (isDuplicateObjectData) sink({
+				code: RtfDiagnosticCodes.EMBEDDED_OBJECT_UNREADABLE,
+				severity: "warning",
+				message: "an \\object destination has more than one \\objdata child, which RTF's own grammar does not allow; only the first is decoded and this one is discarded"
+			});
+			else if (isObjectDataDestination && objectState !== void 0) objectState.objectDataSeen = true;
+			const kind = isHeaderTable || wrapperChild && head.destination !== "ud" ? "skip" : isDuplicateObjectData || isDuplicateResult ? "skip" : isResultDestination ? "body" : known ?? (head.ignorable ? "skip" : state.destination);
 			if (head.destination !== void 0 && !isHeaderTable) {
 				if (head.ignorable && known === void 0) sink({
 					code: RtfDiagnosticCodes.UNKNOWN_DESTINATION_SKIPPED,
@@ -788,10 +1043,46 @@ function readRtfDetail(input, options) {
 			if (stack.length >= maxGroupDepth) throw new RtfNestingLimitExceededError(maxGroupDepth);
 			const child = cloneGroupState(state);
 			child.inUnicodeWrapper = kind === "unicodeWrapper";
+			child.isFieldGroup = head.destination === "field";
 			if (known !== void 0) {
 				child.destination = kind;
-				if (head.destination === "field") child.field = { instruction: "" };
-				if (kind === "picture") child.picture = defaultPictureState();
+				if (child.isFieldGroup) child.field = {
+					instruction: "",
+					formField: void 0,
+					formFieldStarted: false
+				};
+				if (head.destination === "formfield" && child.field !== void 0) child.field.formField = {
+					name: "",
+					helpText: "",
+					ownHelp: false,
+					listItems: [],
+					resultIndex: void 0,
+					defaultResultIndex: void 0,
+					protectedField: false
+				};
+				if (head.destination === "ffl" && child.field?.formField !== void 0) child.field.formField.listItems.push("");
+				if (kind === "picture") {
+					child.picture = defaultPictureState();
+					child.pictureOwner = true;
+				}
+				if (kind === "objectData") {
+					child.objectData = {
+						bytes: [],
+						pendingHexNibble: void 0
+					};
+					child.objectDataOwner = true;
+				}
+				if (kind === "object") {
+					child.object = {
+						decoded: false,
+						objectDataSeen: false,
+						resultSeen: false,
+						resultBlocks: void 0,
+						widthTwips: void 0,
+						heightTwips: void 0
+					};
+					child.objectOwner = true;
+				}
 				if (kind === "bookmarkStart" || kind === "bookmarkEnd") child.bookmark = {
 					name: "",
 					columnFirst: void 0,
@@ -799,6 +1090,15 @@ function readRtfDetail(input, options) {
 				};
 				index = head.contentStart;
 			} else index += 1;
+			if (objectState !== void 0 && isResultDestination) {
+				builder.beginResultScratch();
+				child.resultOf = objectState;
+				child.object = void 0;
+				child.para = {
+					...child.para,
+					inTable: false
+				};
+			}
 			stack.push(child);
 			state = child;
 			textOffset = 0;
@@ -806,9 +1106,26 @@ function readRtfDetail(input, options) {
 		}
 		if (token.kind === "groupEnd") {
 			flushBytes();
-			if (state.destination === "picture" && state.picture !== void 0) {
+			if (state.destination === "picture" && state.picture !== void 0 && state.pictureOwner) {
 				const image = buildPicture(state.picture, sink);
-				if (image !== void 0) builder.addBlock(image);
+				if (image !== void 0) builder.addBlocks([image], state.para.inTable);
+			}
+			if (state.destination === "objectData" && state.objectData !== void 0 && state.objectDataOwner) {
+				const embedded = buildEmbeddedObject(state.objectData, state.object, sink);
+				if (embedded !== void 0) {
+					builder.addBlocks([embedded], state.para.inTable);
+					if (state.object !== void 0) state.object.decoded = true;
+				}
+			}
+			if (state.resultOf !== void 0) state.resultOf.resultBlocks = builder.endResultScratch(state.para);
+			if (state.destination === "object" && state.object !== void 0 && state.objectOwner) {
+				const objectState = state.object;
+				if (!objectState.decoded && objectState.resultBlocks !== void 0) builder.addBlocks(objectState.resultBlocks, state.para.inTable);
+				if (!objectState.objectDataSeen) sink({
+					code: RtfDiagnosticCodes.EMBEDDED_OBJECT_UNREADABLE,
+					severity: "warning",
+					message: objectState.resultSeen ? "an \\object destination has no \\objdata payload at all; its \\result fallback content is used in its place" : "an \\object destination has neither \\objdata nor \\result content; the whole construct is dropped"
+				});
 			}
 			if (state.bookmark !== void 0) {
 				const bookmark = {
@@ -818,6 +1135,14 @@ function readRtfDetail(input, options) {
 				if (state.destination === "bookmarkStart") builder.startBookmark(bookmark, state.para);
 				else if (state.destination === "bookmarkEnd") builder.endBookmark(bookmark.name);
 			}
+			if (state.destination === "fieldInstruction" && state.field !== void 0 && !state.field.formFieldStarted && formFieldControlType(state.field.instruction) !== void 0) {
+				builder.startFormField();
+				state.field.formFieldStarted = true;
+			}
+			if (state.isFieldGroup && state.field?.formFieldStarted === true) {
+				const descriptor = formFieldContentControl(state.field.instruction, state.field.formField);
+				builder.endFormField(descriptor);
+			}
 			if (stack.length > 1) {
 				stack.pop();
 				const parent = stack[stack.length - 1];
@@ -835,6 +1160,7 @@ function readRtfDetail(input, options) {
 		if (token.kind === "text") {
 			const slice = textOffset === 0 ? token.bytes : token.bytes.subarray(textOffset);
 			if (state.destination === "picture" && state.picture !== void 0) state.picture.hex += asciiStringFromBytes(slice);
+			else if (state.destination === "objectData" && state.objectData !== void 0) appendObjectDataHexText(state.objectData, asciiStringFromBytes(slice));
 			else appendBytes(pendingBytes, slice);
 			index += 1;
 			textOffset = 0;
@@ -842,11 +1168,13 @@ function readRtfDetail(input, options) {
 		}
 		if (token.kind === "binary") {
 			if (state.destination === "picture" && state.picture !== void 0) appendBytes(state.picture.binary, token.bytes);
+			else if (state.destination === "objectData" && state.objectData !== void 0) appendBytes(state.objectData.bytes, token.bytes);
 			index += 1;
 			continue;
 		}
 		if (token.kind === "hex") {
 			if (state.destination === "picture" && state.picture !== void 0) state.picture.binary.push(token.byte);
+			else if (state.destination === "objectData" && state.objectData !== void 0) state.objectData.bytes.push(token.byte);
 			else pendingBytes.push(token.byte);
 			index += 1;
 			continue;
@@ -935,6 +1263,23 @@ function applyPictureControlWord(name, param, picture) {
 		default: return;
 	}
 }
+function applyFormFieldControlWord(name, param, formField) {
+	switch (name) {
+		case "ffres":
+			formField.resultIndex = formFieldValueNumber(param);
+			return true;
+		case "ffdefres":
+			formField.defaultResultIndex = formFieldValueNumber(param);
+			return true;
+		case "ffprot":
+			formField.protectedField = formFieldValueBit(param);
+			return true;
+		case "ffownhelp":
+			formField.ownHelp = toggleValue(param);
+			return true;
+		default: return false;
+	}
+}
 function applyCharacterControlWord(name, param, state, header) {
 	switch (name) {
 		case "plain":
@@ -1170,7 +1515,7 @@ function applyStructureControlWord(name, param, state, builder, section, sink) {
 			return true;
 		case "page":
 			builder.endParagraph(state.para, false);
-			builder.addBlock({ kind: "pageBreak" });
+			builder.addBlocks([{ kind: "pageBreak" }], state.para.inTable);
 			return true;
 		case "sect":
 			builder.endParagraph(state.para, true);
@@ -1185,6 +1530,12 @@ function applyControlWord(name, param, state, builder, header, section, sink) {
 		applyPictureControlWord(name, param, picture);
 		return;
 	}
+	const object = state.object;
+	if (state.destination === "object" && object !== void 0) {
+		if (name === "objw") object.widthTwips = param;
+		else if (name === "objh") object.heightTwips = param;
+		return;
+	}
 	const bookmark = state.bookmark;
 	if (bookmark !== void 0 && state.destination === "bookmarkStart") {
 		if (name === "bkmkcolf") bookmark.columnFirst = param;
@@ -1192,6 +1543,9 @@ function applyControlWord(name, param, state, builder, header, section, sink) {
 		return;
 	}
 	if (state.destination === "bookmarkEnd") return;
+	const formField = state.field?.formField;
+	if (state.destination === "formField" && formField !== void 0 && applyFormFieldControlWord(name, param, formField)) return;
+	if (state.destination === "formField" || state.destination === "formFieldName" || state.destination === "formFieldHelpText" || state.destination === "formFieldListItem") return;
 	if (applyCharacterControlWord(name, param, state, header)) return;
 	if (builder.applyCellDefinition(name, param)) return;
 	if (applyParagraphControlWord(name, param, state)) return;