@stll/folio-core 0.45.0 → 0.47.0

package/dist/content-controls/mutateContentControls.js

@@ -1,4 +1,7 @@
 import { formatDate } from "../docx/fieldParser.js";
+import { cloneParagraphWithPropertySource } from "../docx/paragraphPropertySource.js";
+import { preservedSdtChild, withoutPreservedSdtChild } from "../docx/sdtProperties.js";
+import { checkboxDisplayContent } from "./checkboxDisplay.js";
 import { ContentControlBoundError, ContentControlLockedError, ContentControlTypeError } from "./errors.js";
 import { sanitizeXmlCharacters } from "@stll/docx-core";
 //#region src/content-controls/mutateContentControls.ts
@@ -93,22 +96,16 @@ function ensureSdtNotLocked(control, force) {
 	if (lock === "sdtLocked" || lock === "sdtContentLocked") throwLocked(control, lock);
 }
 function isRepeatingSection(control) {
-	const raw = control.properties.rawPropertiesXml;
-	return raw !== void 0 && REPEATING_SECTION_RE.test(raw);
+	return preservedSdtChild(control.properties.preserved, "repeatingSection") !== void 0;
 }
-const REPEATING_SECTION_RE = /<\w+:repeatingSection\b/u;
-const DATA_BINDING_RE = /<\w+:dataBinding\b(?<attrs>[^>]*)\/?>/iu;
 /**
-* Detect a `<w:dataBinding w:xpath="…"/>` (or alt-prefix variant) inside
-* the captured rawPropertiesXml + extract the xpath / storeItemID for
-* the error payload. Returns null when no binding is present.
+* The binding a `<w:dataBinding w:xpath="…"/>` states, for the error payload.
+*
+* Returns null when the control carries no binding.
 */
 function readDataBinding(control) {
-	const raw = control.properties.rawPropertiesXml;
-	if (raw === void 0) return null;
-	const match = DATA_BINDING_RE.exec(raw);
-	if (!match) return null;
-	const attrs = match.groups?.["attrs"] ?? "";
+	const attrs = preservedSdtChild(control.properties.preserved, "dataBinding");
+	if (attrs === void 0) return null;
 	const xpathMatch = /\bxpath="(?<xpath>[^"]*)"/iu.exec(attrs);
 	if (!xpathMatch) return null;
 	const xpath = xpathMatch.groups?.["xpath"] ?? "";
@@ -121,14 +118,13 @@ function readDataBinding(control) {
 }
 /**
 * Refuse content mutations on bound SDTs unless the caller passes
-* `{ force: true }`. When force is set, return the rawPropertiesXml
-* with the `<w:dataBinding>` element stripped so the caller's write
-* actually sticks on next Word open. See `ContentControlBoundError`
-* for the rationale.
+* `{ force: true }`. When force is set, return the property set without its
+* `<w:dataBinding>` child so the caller's write actually sticks on next Word
+* open. See `ContentControlBoundError` for the rationale.
 */
 function ensureContentNotBound(control, force) {
 	const binding = readDataBinding(control);
-	if (!binding) return { strippedRawPropertiesXml: void 0 };
+	if (!binding) return { wasBound: false };
 	if (!force) throw new ContentControlBoundError({
 		message: `Control "${control.properties.tag ?? control.properties.alias ?? "(unnamed)"}" is bound to ${binding.xpath}. Word regenerates the body from the bound XML on open; pass { force: true } to strip the binding inline, or remove it explicitly before writing.`,
 		xpath: binding.xpath,
@@ -136,9 +132,19 @@ function ensureContentNotBound(control, force) {
 		...control.properties.tag !== void 0 ? { tag: control.properties.tag } : {},
 		...control.properties.alias !== void 0 ? { alias: control.properties.alias } : {}
 	});
-	const raw = control.properties.rawPropertiesXml;
-	if (raw === void 0) return { strippedRawPropertiesXml: void 0 };
-	return { strippedRawPropertiesXml: raw.replaceAll(/<\w+:dataBinding\b[^>]*\/?>(?:[\s\S]*?<\/\w+:dataBinding>)?/giu, "") };
+	return {
+		wasBound: true,
+		unbound: withoutPreservedSdtChild(control.properties.preserved, "dataBinding")
+	};
+}
+/** Write a {@link BindingRemoval} onto a copy of a control's properties. */
+function applyBindingRemoval(properties, removal) {
+	if (!removal.wasBound) return;
+	if (removal.unbound === void 0) {
+		delete properties.preserved;
+		return;
+	}
+	properties.preserved = removal.unbound;
 }
 function mapBlock(block, match) {
 	if (block.type === "blockSdt") {
@@ -234,6 +240,20 @@ function makeParagraphFromText(rawText) {
 		}]
 	};
 }
+function makeCheckboxParagraph(control, checked) {
+	const paragraph = control.content.find((block) => block.type === "paragraph");
+	const run = paragraph?.content.find((item) => item.type === "run");
+	const content = [{
+		type: "run",
+		...run?.formatting !== void 0 ? { formatting: run.formatting } : {},
+		content: [checkboxDisplayContent(preservedSdtChild(control.properties.preserved, "checkbox"), checked)]
+	}];
+	if (!paragraph) return {
+		type: "paragraph",
+		content
+	};
+	return cloneParagraphWithPropertySource(paragraph, { content });
+}
 function cloneBlock(block) {
 	return structuredClone(block);
 }
@@ -257,11 +277,11 @@ function setContentControlContent(doc, filter, input, options = {}) {
 	const match = (control) => {
 		if (!controlMatchesFilter(control, filter)) return;
 		ensureContentNotLocked(control, options.force);
-		const { strippedRawPropertiesXml } = ensureContentNotBound(control, options.force);
+		const removal = ensureContentNotBound(control, options.force);
 		const blocks = typeof input === "string" ? [makeParagraphFromText(input)] : input.map(cloneBlock);
 		const properties = { ...control.properties };
 		properties.showingPlaceholder = false;
-		if (strippedRawPropertiesXml !== void 0) properties.rawPropertiesXml = strippedRawPropertiesXml;
+		applyBindingRemoval(properties, removal);
 		return {
 			...control,
 			properties,
@@ -279,7 +299,17 @@ function setContentControlValue(doc, filter, input, options = {}) {
 	const match = (control) => {
 		if (!controlMatchesFilter(control, filter)) return;
 		ensureContentNotLocked(control, options.force);
-		const { strippedRawPropertiesXml } = ensureContentNotBound(control, options.force);
+		const removal = ensureContentNotBound(control, options.force);
+		/** The control's properties, unbound, plus whatever this input sets. */
+		const nextProperties = (set) => {
+			const properties = {
+				...control.properties,
+				...set
+			};
+			properties.showingPlaceholder = false;
+			applyBindingRemoval(properties, removal);
+			return properties;
+		};
 		const sdtType = control.properties.sdtType;
 		if (input.kind === "dropdown") {
 			if (sdtType !== "dropdown" && sdtType !== "comboBox") throw new ContentControlTypeError({
@@ -300,12 +330,7 @@ function setContentControlValue(doc, filter, input, options = {}) {
 			const display = item?.displayText ?? input.value;
 			return {
 				...control,
-				properties: {
-					...control.properties,
-					dropdownLastValue: sanitizeXmlCharacters(input.value),
-					showingPlaceholder: false,
-					...strippedRawPropertiesXml !== void 0 ? { rawPropertiesXml: strippedRawPropertiesXml } : {}
-				},
+				properties: nextProperties({ dropdownLastValue: sanitizeXmlCharacters(input.value) }),
 				content: [makeParagraphFromText(display)]
 			};
 		}
@@ -317,16 +342,10 @@ function setContentControlValue(doc, filter, input, options = {}) {
 				...control.properties.tag !== void 0 ? { tag: control.properties.tag } : {},
 				...control.properties.alias !== void 0 ? { alias: control.properties.alias } : {}
 			});
-			const glyph = input.checked ? "☒" : "☐";
 			return {
 				...control,
-				properties: {
-					...control.properties,
-					checked: input.checked,
-					showingPlaceholder: false,
-					...strippedRawPropertiesXml !== void 0 ? { rawPropertiesXml: strippedRawPropertiesXml } : {}
-				},
-				content: [makeParagraphFromText(glyph)]
+				properties: nextProperties({ checked: input.checked }),
+				content: [makeCheckboxParagraph(control, input.checked)]
 			};
 		}
 		if (sdtType !== "date") throw new ContentControlTypeError({
@@ -339,12 +358,7 @@ function setContentControlValue(doc, filter, input, options = {}) {
 		const display = formatDateForSdtBody(input.date, control.properties.dateFormat);
 		return {
 			...control,
-			properties: {
-				...control.properties,
-				dateValueISO: input.date,
-				showingPlaceholder: false,
-				...strippedRawPropertiesXml !== void 0 ? { rawPropertiesXml: strippedRawPropertiesXml } : {}
-			},
+			properties: nextProperties({ dateValueISO: input.date }),
 			content: [makeParagraphFromText(display)]
 		};
 	};

package/dist/controller/contentControlWidgetController.d.ts

@@ -46,6 +46,7 @@ declare class ContentControlWidgetController extends Subscribable<ContentControl
   private readonly onPaintedClick;
   private readonly onKeyDown;
   private readonly onScroll;
+  private readonly onPointerDown;
   private open;
   private removeDismissListeners;
   private unbindView;

package/dist/controller/contentControlWidgetController.js

@@ -113,15 +113,18 @@ var ContentControlWidgetController = class extends Subscribable {
 		if (event.key === "Escape") this.close();
 	};
 	onScroll = () => this.close();
+	onPointerDown = () => this.close();
 	open(snapshot) {
 		this.removeDismissListeners();
 		this.ownerWindow = this.viewDom?.ownerDocument.defaultView ?? null;
 		this.ownerWindow?.addEventListener("keydown", this.onKeyDown);
+		this.ownerWindow?.addEventListener("pointerdown", this.onPointerDown);
 		this.ownerWindow?.addEventListener("scroll", this.onScroll, true);
 		this.setSnapshot(snapshot);
 	}
 	removeDismissListeners() {
 		this.ownerWindow?.removeEventListener("keydown", this.onKeyDown);
+		this.ownerWindow?.removeEventListener("pointerdown", this.onPointerDown);
 		this.ownerWindow?.removeEventListener("scroll", this.onScroll, true);
 		this.ownerWindow = null;
 	}

package/dist/controller/hiddenEditorApi.js

@@ -45,7 +45,9 @@ const createHiddenEditorApi = (deps) => {
 			return stateToDocument(view.state, deps.getDocumentContext());
 		},
 		focus: () => {
-			deps.getView()?.focus();
+			const view = deps.getView();
+			if (!view || view.hasFocus()) return;
+			view.focus();
 		},
 		blur: () => {
 			const view = deps.getView();

package/dist/controller/hiddenEditorManager.d.ts

@@ -5,9 +5,9 @@ import { RemoteSelection } from "../types/remote-selection.js";
 import { HiddenEditorApi } from "./hiddenEditorApi.js";
 import { EditorState, Plugin, Transaction } from "prosemirror-state";
 import { EditorView } from "prosemirror-view";
-import * as YProseMirror from "y-prosemirror";
 import * as Yjs from "yjs";
 import { XmlFragment } from "yjs";
+import * as YProseMirror from "y-prosemirror";
 //#region src/controller/hiddenEditorManager.d.ts
 type YProseMirrorModule = typeof YProseMirror;
 type YjsModule = typeof Yjs;

package/dist/controller/hiddenEditorManager.js

@@ -8,7 +8,7 @@ import { createDocumentNumberingPlugin } from "../prosemirror/plugins/documentNu
 import { createDocumentStylesPlugin } from "../prosemirror/plugins/documentStyles.js";
 import { schema } from "../prosemirror/schema/index.js";
 import { createTextInputPlugin } from "../prosemirror/textInput.js";
-import { proseDocumentParagraphSourceContract, readYjsParagraphSourceContract, withParagraphSourceContract, writeYjsParagraphSourceContract } from "../prosemirror/yjsParagraphSourceContract.js";
+import { applyAttrSchemaMigrations, proseDocumentParagraphSourceContract, readYjsAttrSchemaVersion, readYjsParagraphSourceContract, withParagraphSourceContract, writeYjsDocumentMetadata } from "../prosemirror/yjsDocumentMetadata.js";
 import { createHiddenEditorApi } from "./hiddenEditorApi.js";
 import { panic } from "better-result";
 import { EditorState } from "prosemirror-state";
@@ -129,12 +129,15 @@ function createHiddenEditorState(options) {
 			collaborationModules.yProseMirror.prosemirrorToYXmlFragment(seedState.doc, collaboration.yXmlFragment);
 			const collaborationDocument = collaboration.yXmlFragment.doc;
 			if (!collaborationDocument) panic("A collaboration fragment must belong to a Yjs document before seeding.");
-			if (proseDocumentParagraphSourceContract(seedState.doc)) writeYjsParagraphSourceContract(collaborationDocument, seedState.doc);
+			writeYjsDocumentMetadata(collaborationDocument, seedState.doc);
 			collaboration.onSeeded?.();
 		}
-		let { doc } = collaborationModules.yProseMirror.initProseMirrorDoc(collaboration.yXmlFragment, activeSchema);
 		const collaborationDocument = collaboration.yXmlFragment.doc;
 		if (!collaborationDocument) panic("A collaboration fragment must belong to a Yjs document before loading.");
+		const attrSchemaVersion = readYjsAttrSchemaVersion(collaborationDocument);
+		if (attrSchemaVersion.isErr()) throw attrSchemaVersion.error;
+		applyAttrSchemaMigrations(collaborationDocument, collaboration.yXmlFragment, attrSchemaVersion.value);
+		let { doc } = collaborationModules.yProseMirror.initProseMirrorDoc(collaboration.yXmlFragment, activeSchema);
 		const collaborationContract = readYjsParagraphSourceContract(collaborationDocument);
 		const localContract = proseDocumentParagraphSourceContract(localDoc);
 		if (localContract && collaborationContract !== localContract) panic("The collaboration state belongs to a different paragraph-property source.");

package/dist/controller/layoutPipeline.js

@@ -119,7 +119,8 @@ function runLayoutPipeline(deps, state, options = {}) {
 		const flowOpts = {
 			pageContentHeight,
 			fontAlternates,
-			...styles ? { styles } : {}
+			...styles ? { styles } : {},
+			...document === null ? {} : { defaultSize: 10 }
 		};
 		if (_theme !== void 0) flowOpts.theme = _theme;
 		if (defaultTabStop !== void 0) flowOpts.defaultTabStopTwips = defaultTabStop;
@@ -188,6 +189,7 @@ function runLayoutPipeline(deps, state, options = {}) {
 			const hfMeasureBlocks = (hfBlocks, hfWidth) => measureBlocks(hfBlocks, hfWidth, void 0, void 0, buildHeaderFooterFieldValues(hfBlocks, pageCount, hfClock, fieldInputs), { allowEndTabOverflow: true });
 			return {
 				...flowOpts.styles ? { styles: flowOpts.styles } : {},
+				...flowOpts.defaultSize === void 0 ? {} : { defaultSize: flowOpts.defaultSize },
 				..._theme !== void 0 ? { theme: _theme } : {},
 				fontAlternates,
 				measureBlocks: hfMeasureBlocks,
@@ -288,7 +290,8 @@ function runLayoutPipeline(deps, state, options = {}) {
 				marginBottom: blockMeasureInputs.physicalPageGeometry.marginBottoms
 			},
 			columnIndex: blockMeasureInputs.columnIndices,
-			columnCount: blockMeasureInputs.columnCounts
+			columnCount: blockMeasureInputs.columnCounts,
+			sectionAdvances: blockMeasureInputs.sectionAdvances
 		});
 		newBlocks = resolveEffectiveParagraphSpacingTree(newBlocks);
 		outcome.blocks = newBlocks;
@@ -338,6 +341,7 @@ function runLayoutPipeline(deps, state, options = {}) {
 			footnoteContentMap = buildFootnoteContentMap(documentFootnotes, footnoteRefs, contentWidth, (() => {
 				const footnoteOptions = { measureBlocks };
 				if (flowOpts.styles) footnoteOptions.styles = flowOpts.styles;
+				if (flowOpts.defaultSize !== void 0) footnoteOptions.defaultSize = flowOpts.defaultSize;
 				if (_theme !== void 0) footnoteOptions.theme = _theme;
 				footnoteOptions.fontAlternates = fontAlternates;
 				if (defaultTabStop !== void 0) footnoteOptions.defaultTabStopTwips = defaultTabStop;
@@ -416,7 +420,8 @@ function runLayoutPipeline(deps, state, options = {}) {
 						marginBottom: blockMeasureInputs.physicalPageGeometry.marginBottoms
 					},
 					columnIndex: blockMeasureInputs.columnIndices,
-					columnCount: blockMeasureInputs.columnCounts
+					columnCount: blockMeasureInputs.columnCounts,
+					sectionAdvances: blockMeasureInputs.sectionAdvances
 				}, values);
 				relayoutWithCurrentMeasures(layoutOptsUsed);
 				pendingArtifacts = {

package/dist/display-list/build/buildDisplayList.js

@@ -11,7 +11,21 @@ import { blockRegion, createPageComposer } from "./regions.js";
 import { paintTableFragment } from "./tablePrimitives.js";
 import { paintTextBoxFragment } from "./textBoxPrimitives.js";
 import { UNSUPPORTED_CONSTRUCT, UnsupportedCollector } from "./unsupported.js";
+import { headingLevelOf } from "@stll/docx-core/model";
 //#region src/display-list/build/buildDisplayList.ts
+/**
+* `Layout` + `BlockLookup` → `DisplayList`.
+*
+* The single source of truth for painting. Two backends consume the result and
+* neither may look behind it, so anything missing here is painted nowhere.
+*
+* Purity is a hard requirement, not a preference: no clock, no randomness, no
+* `globalThis.document`. The font and image tables intern in first-use page
+* order, and author colours are assigned per build, so two builds of one layout
+* are deeply equal. The one impure edge is the measure provider, which the
+* composition root installs and which is deterministic for a given font set;
+* that is the same seam line breaking already ran through, which is the point.
+*/
 /** Document-wide gaps are attributed to the first page, the only one certain to exist. */
 const FIRST_PAGE_INDEX = 0;
 /**
@@ -60,6 +74,11 @@ const paragraphTextOf = (block) => block.runs.map((run) => run.kind === "text" ?
 * Resolve everything that needs the whole document before any page is painted:
 * where each bookmark lands (a `#name` hyperlink cannot become a page target
 * until then) and the heading outline.
+*
+* The outline takes the levels {@link headingLevelOf} names and no others:
+* `w:outlineLvl` 9 is the reserved body-text value, not a tenth level, and a
+* `TOC Heading` paragraph carrying it would otherwise become a PDF bookmark
+* nested nine deep.
 */
 const collectDocumentTargets = (layout, blockLookup) => {
 	const bookmarkTargets = /* @__PURE__ */ new Map();
@@ -73,7 +92,7 @@ const collectDocumentTargets = (layout, blockLookup) => {
 			pageIndex,
 			yPx: fragment.y
 		});
-		const level = block.attrs?.outlineLevel;
+		const level = headingLevelOf(block.attrs?.outlineLevel);
 		if (level !== void 0 && fragment.continuesFromPrev !== true) {
 			const title = paragraphTextOf(block);
 			if (title.length > 0) outline.push({

package/dist/display-list/build/imagePrimitives.d.ts

@@ -15,7 +15,7 @@ declare class ImageTable {
   failureFor(src: string): string | undefined;
   snapshot(): readonly DisplayImageSource[];
 }
-type ImageVisualSource = Pick<ImageBlock, "src" | "opacity" | "cropTop" | "cropRight" | "cropBottom" | "cropLeft" | "borderWidth" | "borderColor" | "borderStyle" | "transform">;
+type ImageVisualSource = Pick<ImageBlock, "src" | "preview" | "opacity" | "brightness" | "contrast" | "cropTop" | "cropRight" | "cropBottom" | "cropLeft" | "borderWidth" | "borderColor" | "borderStyle" | "transform">;
 type PaintImageOptions = {
   readonly source: ImageVisualSource;
   readonly rect: DisplayRect;
@@ -24,9 +24,9 @@ type PaintImageOptions = {
   readonly label: string;
 };
 /**
- * The primitives one picture draws: the bitmap (rotated and/or washed as the
- * source asks) followed by its border. Empty when the bytes are unusable, with
- * the reason already reported.
+ * The primitives one picture draws: the bitmap or the drawn preview (rotated
+ * and/or washed as the source asks) followed by its border. Empty when the
+ * bytes are unusable, with the reason already reported.
  */
 declare const paintImage: ({ source, rect, context, label }: PaintImageOptions) => readonly DisplayPrimitive[];
 /** An anchored or block image fragment placed by the layout engine. */

package/dist/display-list/build/imagePrimitives.js

@@ -1,5 +1,6 @@
 import { parseRotationDegrees } from "../../utils/rotationBoundingBox.js";
 import { sanitizeImageSrc } from "../../utils/sanitizeImageSrc.js";
+import { paintPreview } from "./previewPrimitives.js";
 import { resolveBorderStroke } from "./strokes.js";
 import { UNSUPPORTED_CONSTRUCT } from "./unsupported.js";
 import { Result } from "better-result";
@@ -194,35 +195,54 @@ const cropOf = (source) => {
 		b
 	};
 };
-/**
-* The primitives one picture draws: the bitmap (rotated and/or washed as the
-* source asks) followed by its border. Empty when the bytes are unusable, with
-* the reason already reported.
-*/
-const paintImage = ({ source, rect, context, label }) => {
-	const primitives = [];
+const opacityOf = (source) => source.opacity == null ? 1 : Math.min(1, Math.max(0, source.opacity));
+const withOpacity = (children, opacity) => opacity === 1 || children.length === 0 ? children : [{
+	kind: "opacityGroup",
+	opacity,
+	children
+}];
+/** The bitmap one picture draws, or nothing, with the reason already reported. */
+const paintBitmap = ({ source, rect, context, label }) => {
 	const ref = context.images.intern(source.src);
 	if (ref === void 0) {
 		const reason = context.images.failureFor(source.src) ?? "image could not be decoded";
 		const construct = reason.includes("not PNG or JPEG") ? UNSUPPORTED_CONSTRUCT.imageFormat : UNSUPPORTED_CONSTRUCT.imageSource;
 		context.unsupported.report(construct, context.pageIndex, `${label}: ${reason}`);
-	} else {
-		const crop = cropOf(source);
-		const image = {
-			kind: "image",
-			image: ref,
-			rect,
-			...crop === void 0 ? {} : { crop },
-			opacity: source.opacity == null ? 1 : Math.min(1, Math.max(0, source.opacity))
-		};
+		return [];
+	}
+	const crop = cropOf(source);
+	return [{
+		kind: "image",
+		image: ref,
+		rect,
+		...crop === void 0 ? {} : { crop },
+		opacity: opacityOf(source),
+		...source.brightness == null ? {} : { brightness: source.brightness },
+		...source.contrast == null ? {} : { contrast: source.contrast }
+	}];
+};
+/**
+* The primitives one picture draws: the bitmap or the drawn preview (rotated
+* and/or washed as the source asks) followed by its border. Empty when the
+* bytes are unusable, with the reason already reported.
+*/
+const paintImage = ({ source, rect, context, label }) => {
+	const primitives = [];
+	const drawn = source.preview === void 0 ? paintBitmap({
+		source,
+		rect,
+		context,
+		label
+	}) : withOpacity(paintPreview(source.preview, rect), opacityOf(source));
+	if (drawn.length > 0) {
 		const degrees = parseRotationDegrees(source.transform);
-		if (degrees === 0) primitives.push(image);
+		if (degrees === 0) primitives.push(...drawn);
 		else primitives.push({
 			kind: "rotateGroup",
 			degrees,
 			originXPx: rect.xPx + rect.widthPx / 2,
 			originYPx: rect.yPx + rect.heightPx / 2,
-			children: [image]
+			children: drawn
 		});
 	}
 	if (source.borderWidth != null && source.borderWidth > 0) {

package/dist/display-list/build/pageBorderPrimitives.js

@@ -1,3 +1,4 @@
+import { cssBorderStyle } from "../../utils/borderCss.js";
 import { resolveColor } from "../../utils/colorResolver.js";
 import { eighthsToPixels, pointsToPixels } from "../../utils/units.js";
 import { resolveBorderStroke } from "./strokes.js";
@@ -25,7 +26,7 @@ const strokeOf = (border, theme, context) => {
 	if (!border) return;
 	const { stroke, unresolvedColor } = resolveBorderStroke({
 		width: border.size === void 0 || border.size === 0 ? HAIRLINE_WIDTH_PX : eighthsToPixels(border.size),
-		style: border.style,
+		style: cssBorderStyle(border.style),
 		color: resolveColor(border.color, theme)
 	});
 	if (unresolvedColor !== void 0) context.unsupported.report(UNSUPPORTED_CONSTRUCT.unresolvedColor, context.pageIndex, `page border colour ${unresolvedColor}`);