@stll/folio-core 0.61.0 → 0.63.0

package/dist/prosemirror/extensions/nodes/ShapeExtension.d.ts

@@ -2,17 +2,17 @@ import { document_d_exports } from "../../../types/document.js";
 import { ShapeAttrs as ShapeAttrs$1 } from "../../schema/nodes.js";
 import { NodeExtension } from "../types.js";
 //#region src/prosemirror/extensions/nodes/ShapeExtension.d.ts
-type ShapeAttrs = ShapeAttrs$1;
-declare function sanitizeColor(value: string | null | undefined): string | null;
-declare function sanitizeTransform(value: string | null | undefined): string | null;
-declare function sanitizeSvgId(value: string | null | undefined): string | null;
-declare function sanitizeShapeDimension(value: number | null | undefined, fallback: number): number;
-declare function strokeDashArrayForOutlineStyle(outlineStyle: string | undefined): string | undefined;
+export type ShapeAttrs = ShapeAttrs$1;
+export declare function sanitizeColor(value: string | null | undefined): string | null;
+export declare function sanitizeTransform(value: string | null | undefined): string | null;
+export declare function sanitizeSvgId(value: string | null | undefined): string | null;
+export declare function sanitizeShapeDimension(value: number | null | undefined, fallback: number): number;
+export declare function strokeDashArrayForOutlineStyle(outlineStyle: string | undefined): string | undefined;
 type RightBracePaths = {
   fill: string;
   outline: string;
 };
-declare function buildRightBracePaths(w: number, h: number, adjustments: readonly document_d_exports.ShapeGeometryAdjustment[]): RightBracePaths;
+export declare function buildRightBracePaths(w: number, h: number, adjustments: readonly document_d_exports.ShapeGeometryAdjustment[]): RightBracePaths;
 /**
  * Build the `points` string for a polygon-based shape preset.
  *
@@ -24,12 +24,12 @@ declare function buildRightBracePaths(w: number, h: number, adjustments: readonl
  * Pure and DOM-free so it can be unit tested without a happy-dom / jsdom
  * setup; `createShapeElement` wraps the result in an `<svg:polygon>` node.
  */
-declare function buildShapePolygonPoints(type: string, w: number, h: number): string | null;
+export declare function buildShapePolygonPoints(type: string, w: number, h: number): string | null;
 type GradientStop = {
   position: number;
   color: string;
 };
-declare function parseGradientStops(raw: string | undefined): GradientStop[];
-declare const ShapeExtension: (options?: Partial<Record<string, unknown>> | undefined) => NodeExtension;
+export declare function parseGradientStops(raw: string | undefined): GradientStop[];
+export declare const ShapeExtension: (options?: Partial<Record<string, unknown>> | undefined) => NodeExtension;
 //#endregion
-export { ShapeAttrs, ShapeExtension, buildRightBracePaths, buildShapePolygonPoints, parseGradientStops, sanitizeColor, sanitizeShapeDimension, sanitizeSvgId, sanitizeTransform, strokeDashArrayForOutlineStyle };
+export {};

package/dist/prosemirror/extensions/nodes/ShapeExtension.js

@@ -2,12 +2,6 @@ import { expectShapeAttrs } from "../../attrs/index.js";
 import { parseShapeGeometryAdjustments } from "../../shapeGeometryAdjustments.js";
 import { createNodeExtension } from "../create.js";
 //#region src/prosemirror/extensions/nodes/ShapeExtension.ts
-/**
-* Shape Extension — inline shape node
-*
-* Renders basic shapes (rect, ellipse, line, etc.) as inline SVG elements.
-* Supports fill color, outline, transforms, and selection.
-*/
 const SVG_NS = "http://www.w3.org/2000/svg";
 /**
 * CSS color allowlist for SVG attribute values.
@@ -423,6 +417,7 @@ const ShapeExtension = createNodeExtension({
 				const position = parseShapePosition(d["position"]);
 				const outlineHeadEnd = parseShapeLineEnd(d["outlineHeadEnd"]);
 				const outlineTailEnd = parseShapeLineEnd(d["outlineTailEnd"]);
+				const outlineJoin = d["outlineJoin"] === "bevel" || d["outlineJoin"] === "miter" || d["outlineJoin"] === "round" ? d["outlineJoin"] : void 0;
 				return {
 					shapeType: d["shapeType"] || "rect",
 					...d["geometryAdjustments"] ? { geometryAdjustments: d["geometryAdjustments"] } : {},
@@ -438,6 +433,7 @@ const ShapeExtension = createNodeExtension({
 					...d["outlineColor"] ? { outlineColor: d["outlineColor"] } : {},
 					...d["outlineStyle"] ? { outlineStyle: d["outlineStyle"] } : {},
 					...d["outlineCap"] ? { outlineCap: d["outlineCap"] } : {},
+					...outlineJoin ? { outlineJoin } : {},
 					...outlineHeadEnd ? { outlineHeadEnd } : {},
 					...outlineTailEnd ? { outlineTailEnd } : {},
 					...d["transform"] ? { transform: d["transform"] } : {},
@@ -480,6 +476,7 @@ const ShapeExtension = createNodeExtension({
 			if (attrs.outlineColor) domAttrs["data-outline-color"] = attrs.outlineColor;
 			if (attrs.outlineStyle) domAttrs["data-outline-style"] = attrs.outlineStyle;
 			if (attrs.outlineCap) domAttrs["data-outline-cap"] = attrs.outlineCap;
+			if (attrs.outlineJoin) domAttrs["data-outline-join"] = attrs.outlineJoin;
 			if (attrs.outlineHeadEnd) domAttrs["data-outline-head-end"] = JSON.stringify(attrs.outlineHeadEnd);
 			if (attrs.outlineTailEnd) domAttrs["data-outline-tail-end"] = JSON.stringify(attrs.outlineTailEnd);
 			if (attrs.transform) domAttrs["data-transform"] = attrs.transform;
@@ -558,6 +555,8 @@ const ShapeExtension = createNodeExtension({
 			}
 			const geometryAdjustments = parseShapeGeometryAdjustments(attrs.geometryAdjustments) ?? [];
 			const shapeEl = createShapeElement(attrs.shapeType || "rect", w, h, geometryAdjustments);
+			if (attrs.outlineCap) shapeEl.setAttribute("stroke-linecap", attrs.outlineCap === "flat" ? "butt" : attrs.outlineCap);
+			if (attrs.outlineJoin && attrs.outlineJoin !== "miter") shapeEl.setAttribute("stroke-linejoin", attrs.outlineJoin);
 			const strokeDasharray = strokeDashArrayForOutlineStyle(attrs.outlineStyle);
 			if (strokeDasharray) shapeEl.setAttribute("stroke-dasharray", strokeDasharray);
 			svg.append(shapeEl);

package/dist/prosemirror/extensions/nodes/SymbolExtension.d.ts

@@ -1,5 +1,4 @@
 import { NodeExtension } from "../types.js";
 //#region src/prosemirror/extensions/nodes/SymbolExtension.d.ts
-declare const SymbolExtension: (options?: Partial<Record<string, unknown>> | undefined) => NodeExtension;
-//#endregion
-export { SymbolExtension };
+export declare const SymbolExtension: (options?: Partial<Record<string, unknown>> | undefined) => NodeExtension;
+//#endregion

package/dist/prosemirror/extensions/nodes/SymbolExtension.js

@@ -1,4 +1,4 @@
-import { decodeOoxmlSymbolCharacter } from "../../../utils/ooxmlSymbol.js";
+import { displayOoxmlSymbolCharacter } from "../../../utils/ooxmlSymbol.js";
 import { expectSymbolAttrs } from "../../attrs/index.js";
 import { createNodeExtension } from "../create.js";
 import { isOoxmlSymbolCharacter } from "@stll/docx-core/model";
@@ -32,13 +32,13 @@ const SymbolExtension = createNodeExtension({
 		}],
 		toDOM(node) {
 			const { font, char } = expectSymbolAttrs(node);
-			const decoded = decodeOoxmlSymbolCharacter(char);
+			const decoded = displayOoxmlSymbolCharacter(font, char);
 			return [
 				"span",
 				{
 					"data-docx-symbol-char": char,
 					"data-docx-symbol-font": font,
-					style: `font-family: "${escapeCssString(font)}";`
+					style: `font-family: "${escapeCssString(font)}", sans-serif;`
 				},
 				decoded ?? "�"
 			];

package/dist/prosemirror/extensions/nodes/TabExtension.d.ts

@@ -3,6 +3,5 @@ import { NodeExtension } from "../types.js";
 /**
  * Tab Extension — inline tab character node
  */
-declare const TabExtension: (options?: Partial<Record<string, unknown>> | undefined) => NodeExtension;
-//#endregion
-export { TabExtension };
+export declare const TabExtension: (options?: Partial<Record<string, unknown>> | undefined) => NodeExtension;
+//#endregion

package/dist/prosemirror/extensions/nodes/TableExtension.d.ts

@@ -3,7 +3,7 @@ import { AnyExtension, Extension, NodeExtension } from "../types.js";
 import { Node } from "prosemirror-model";
 import { Command, EditorState } from "prosemirror-state";
 //#region src/prosemirror/extensions/nodes/TableExtension.d.ts
-type TableContextInfo = {
+export type TableContextInfo = {
   isInTable: boolean;
   table?: Node;
   tablePos?: number;
@@ -22,14 +22,14 @@ declare function getTableContext(state: EditorState): TableContextInfo;
 declare function isInTableCell(state: EditorState): boolean;
 declare function goToNextCell(): Command;
 declare function goToPrevCell(): Command;
-declare const TableNodeExtension: (options?: Partial<Record<string, unknown>> | undefined) => NodeExtension;
-declare const TableRowExtension: (options?: Partial<Record<string, unknown>> | undefined) => NodeExtension;
-declare const TableCellExtension: (options?: Partial<Record<string, unknown>> | undefined) => NodeExtension;
-declare const TableHeaderExtension: (options?: Partial<Record<string, unknown>> | undefined) => NodeExtension;
-type BorderPreset = "all" | "outside" | "inside" | "none";
+export declare const TableNodeExtension: (options?: Partial<Record<string, unknown>> | undefined) => NodeExtension;
+export declare const TableRowExtension: (options?: Partial<Record<string, unknown>> | undefined) => NodeExtension;
+export declare const TableCellExtension: (options?: Partial<Record<string, unknown>> | undefined) => NodeExtension;
+export declare const TableHeaderExtension: (options?: Partial<Record<string, unknown>> | undefined) => NodeExtension;
+export type BorderPreset = "all" | "outside" | "inside" | "none";
 /** Whole-table border presets (Word's "All Borders" / "No Border"). */
-type TableBorderPreset = "all" | "none";
-declare const TablePluginExtension: (options?: Partial<Record<string, unknown>> | undefined) => Extension;
-declare function createTableExtensions(): AnyExtension[];
+export type TableBorderPreset = "all" | "none";
+export declare const TablePluginExtension: (options?: Partial<Record<string, unknown>> | undefined) => Extension;
+export declare function createTableExtensions(): AnyExtension[];
 //#endregion
-export { BorderPreset, TableBorderPreset, TableCellExtension, TableContextInfo, TableHeaderExtension, TableNodeExtension, TablePluginExtension, TableRowExtension, createTableExtensions, getTableContext, goToNextCell, goToPrevCell, isInTableCell as isInTable };
+export { getTableContext, goToNextCell, goToPrevCell, isInTableCell as isInTable };

package/dist/prosemirror/extensions/nodes/TableExtension.js

@@ -325,7 +325,7 @@ function buildCellBorderStyles(attrs) {
 function buildCellPaddingStyles(attrs) {
 	const margins = attrs.margins;
 	if (!margins) {
-		const px = Math.round(108 / 20 * 1.333);
+		const px = Math.round(7.1982);
 		return [`padding: ${px}px ${px}px`];
 	}
 	const toPixels = (twips) => twips !== void 0 && twips > 0 ? Math.round(twips / 20 * 1.333) : 0;
@@ -373,7 +373,7 @@ const statedCellWidth = (value, type) => ({
 	}
 });
 const tableCellSpec = {
-	content: "(paragraph | table | textBox | blockSdt | blockCustomXml | preservedBlock | blockBookmarkBoundary)+",
+	content: "(paragraph | table | textBox | blockSdt | blockCustomXml | preservedBlock | blockBookmarkBoundary | blockMoveRangeBoundary)+",
 	tableRole: "cell",
 	isolating: true,
 	attrs: {
@@ -443,7 +443,7 @@ const tableCellSpec = {
 	}
 };
 const tableHeaderSpec = {
-	content: "(paragraph | table | textBox | blockSdt | blockCustomXml | preservedBlock | blockBookmarkBoundary)+",
+	content: "(paragraph | table | textBox | blockSdt | blockCustomXml | preservedBlock | blockBookmarkBoundary | blockMoveRangeBoundary)+",
 	tableRole: "header_cell",
 	isolating: true,
 	attrs: {
@@ -1151,15 +1151,12 @@ const TablePluginExtension = createExtension({
 									right: isRightEdge ? noBorder : solidBorder
 								};
 								break;
-							case "none":
-								cellBorders = {
-									top: noBorder,
-									bottom: noBorder,
-									left: noBorder,
-									right: noBorder
-								};
-								break;
-							default: break;
+							case "none": cellBorders = {
+								top: noBorder,
+								bottom: noBorder,
+								left: noBorder,
+								right: noBorder
+							};
 						}
 						const attrs = getAttrs(pos, info.node);
 						const existingBorders = attrs.borders ?? {};
@@ -1887,8 +1884,9 @@ const TablePluginExtension = createExtension({
 				return false;
 			};
 		}
+		const activeCellKey = new PluginKey("activeCell");
 		const activeCellPlugin = new Plugin({
-			key: new PluginKey("activeCell"),
+			key: activeCellKey,
 			props: { decorations(state) {
 				const { selection } = state;
 				if (selection instanceof CellSelection) return DecorationSet.empty;

package/dist/prosemirror/extensions/nodes/TextBoxAnchorExtension.d.ts

@@ -11,7 +11,7 @@ type TextBoxAnchorOptions = {
   getInternalClipboardToken?: () => string;
 };
 /** The node name, for callers asking whether a paragraph holds any content. */
-declare const TEXT_BOX_ANCHOR_NODE_NAME = "textBoxAnchor";
-declare const TextBoxAnchorExtension: (options?: Partial<TextBoxAnchorOptions> | undefined) => NodeExtension;
+export declare const TEXT_BOX_ANCHOR_NODE_NAME = "textBoxAnchor";
+export declare const TextBoxAnchorExtension: (options?: Partial<TextBoxAnchorOptions> | undefined) => NodeExtension;
 //#endregion
-export { TEXT_BOX_ANCHOR_NODE_NAME, TextBoxAnchorExtension };
+export {};

package/dist/prosemirror/extensions/nodes/TextBoxExtension.d.ts

@@ -1,8 +1,7 @@
 import { TextBoxAttrs as TextBoxAttrs$1 } from "../../schema/nodes.js";
 import { NodeExtension } from "../types.js";
 //#region src/prosemirror/extensions/nodes/TextBoxExtension.d.ts
-type TextBoxAttrs = TextBoxAttrs$1;
-declare function parseTextBoxWordArt(raw: string): TextBoxAttrs["wordArt"];
-declare const TextBoxExtension: (options?: Partial<Record<string, unknown>> | undefined) => NodeExtension;
-//#endregion
-export { TextBoxAttrs, TextBoxExtension, parseTextBoxWordArt };
+export type TextBoxAttrs = TextBoxAttrs$1;
+export declare function parseTextBoxWordArt(raw: string): TextBoxAttrs["wordArt"];
+export declare const TextBoxExtension: (options?: Partial<Record<string, unknown>> | undefined) => NodeExtension;
+//#endregion

package/dist/prosemirror/extensions/nodes/bookmarkBoundaryDom.d.ts

@@ -1,6 +1,6 @@
 import { Node } from "prosemirror-model";
 //#region src/prosemirror/extensions/nodes/bookmarkBoundaryDom.d.ts
-declare const bookmarkBoundaryAttrSpec: {
+export declare const bookmarkBoundaryAttrSpec: {
   type: {};
   id: {};
   name: {
@@ -15,9 +15,11 @@ declare const bookmarkBoundaryAttrSpec: {
   displacedByCustomXml: {
     default: null;
   };
+  copyOriginAncestors: {
+    default: null;
+  };
 };
 /** `false` when the element does not describe a boundary ProseMirror can hold. */
-declare const parseBookmarkBoundaryDom: (dom: HTMLElement | string) => Record<string, unknown> | false;
-declare const bookmarkBoundaryDomAttributes: (node: Node, internalClipboardToken?: string) => Record<string, string>;
-//#endregion
-export { bookmarkBoundaryAttrSpec, bookmarkBoundaryDomAttributes, parseBookmarkBoundaryDom };
+export declare const parseBookmarkBoundaryDom: (dom: HTMLElement | string, internalClipboardToken?: string) => Record<string, unknown> | false;
+export declare const bookmarkBoundaryDomAttributes: (node: Node, internalClipboardToken?: string) => Record<string, string>;
+//#endregion

package/dist/prosemirror/extensions/nodes/bookmarkBoundaryDom.js

@@ -1,4 +1,5 @@
 import { expectBookmarkBoundaryAttrs, isDisplacedByCustomXml } from "../../bookmarkBoundaryAttrs.js";
+import { INTERNAL_CLIPBOARD_TOKEN_ATTRIBUTE, copyOriginAncestorsFromInternalDom, copyOriginDomAttribute } from "../../copyOriginDom.js";
 //#region src/prosemirror/extensions/nodes/bookmarkBoundaryDom.ts
 const readNonnegativeInteger = (value) => {
 	if (value === null || !/^(?:0|[1-9]\d*)$/.test(value)) return false;
@@ -15,10 +16,11 @@ const bookmarkBoundaryAttrSpec = {
 	name: { default: null },
 	colFirst: { default: null },
 	colLast: { default: null },
-	displacedByCustomXml: { default: null }
+	displacedByCustomXml: { default: null },
+	copyOriginAncestors: { default: null }
 };
 /** `false` when the element does not describe a boundary ProseMirror can hold. */
-const parseBookmarkBoundaryDom = (dom) => {
+const parseBookmarkBoundaryDom = (dom, internalClipboardToken) => {
 	if (typeof dom === "string") return false;
 	const type = dom.getAttribute("data-docx-bookmark-boundary");
 	const id = readNonnegativeInteger(dom.getAttribute("data-docx-bookmark-id"));
@@ -28,6 +30,8 @@ const parseBookmarkBoundaryDom = (dom) => {
 	const colFirst = readOptionalColumn(dom, "data-docx-bookmark-col-first");
 	const colLast = readOptionalColumn(dom, "data-docx-bookmark-col-last");
 	if (colFirst === false || colLast === false) return false;
+	const copyOriginAncestors = copyOriginAncestorsFromInternalDom(dom, internalClipboardToken);
+	if (copyOriginAncestors === false) return false;
 	const displaced = dom.getAttribute("data-docx-bookmark-displaced");
 	return {
 		type,
@@ -35,6 +39,7 @@ const parseBookmarkBoundaryDom = (dom) => {
 		...name ? { name } : {},
 		...colFirst !== void 0 ? { colFirst } : {},
 		...colLast !== void 0 ? { colLast } : {},
+		...copyOriginAncestors === void 0 ? {} : { copyOriginAncestors },
 		...isDisplacedByCustomXml(displaced) ? { displacedByCustomXml: displaced } : {}
 	};
 };
@@ -47,10 +52,11 @@ const bookmarkBoundaryDomAttributes = (node, internalClipboardToken) => {
 		...attrs.type === "start" && attrs.colFirst !== void 0 ? { "data-docx-bookmark-col-first": String(attrs.colFirst) } : {},
 		...attrs.type === "start" && attrs.colLast !== void 0 ? { "data-docx-bookmark-col-last": String(attrs.colLast) } : {},
 		...attrs.displacedByCustomXml !== void 0 ? { "data-docx-bookmark-displaced": attrs.displacedByCustomXml } : {},
+		...copyOriginDomAttribute(attrs.copyOriginAncestors, internalClipboardToken),
 		"aria-hidden": "true",
 		contenteditable: "false",
 		style: "display: none;",
-		...internalClipboardToken === void 0 ? {} : { "data-docx-internal-clipboard": internalClipboardToken }
+		...internalClipboardToken === void 0 ? {} : { [INTERNAL_CLIPBOARD_TOKEN_ATTRIBUTE]: internalClipboardToken }
 	};
 };
 //#endregion

package/dist/prosemirror/extensions/types.d.ts

@@ -1,7 +1,7 @@
 import { document_d_exports } from "../../types/document.js";
 import { TextColorAttrs } from "../schema/marks.js";
-import "../schema/index.js";
 import { TablePropertiesCommand } from "../../utils/tableOperations.js";
+import "../schema/index.js";
 import { SectionBreakType } from "../sectionCarrier.js";
 import { GenerateTableOfContentsOptions, ResolvedStyleAttrs } from "./core/ParagraphExtension.js";
 import { BorderPreset, TableBorderPreset } from "./nodes/TableExtension.js";
@@ -16,27 +16,27 @@ import { Command, Plugin } from "prosemirror-state";
  * back, so a token the schema does not declare has to survive the round trip
  * rather than be refused at the command.
  */
-type TableCellBorderCommandSpec = {
+export type TableCellBorderCommandSpec = {
   style: document_d_exports.BorderStyleValue;
   size?: number;
   color?: {
     rgb: string;
   };
 };
-type TableBorderCommandSpec = {
+export type TableBorderCommandSpec = {
   style: document_d_exports.BorderStyleValue;
   size: number;
   color: {
     rgb: string;
   };
 };
-type TableCellMarginsCommand = {
+export type TableCellMarginsCommand = {
   top?: number;
   bottom?: number;
   left?: number;
   right?: number;
 };
-type TableStyleCommand = {
+export type TableStyleCommand = {
   styleId: string;
   tableBorders?: Partial<Record<"top" | "bottom" | "left" | "right" | "insideH" | "insideV", TableCellBorderCommandSpec>>;
   conditionals?: Record<string, {
@@ -54,15 +54,15 @@ type TableStyleCommand = {
     noVBand?: boolean;
   };
 };
-type ExtensionPriority = number;
-declare const Priority: {
+export type ExtensionPriority = number;
+export declare const Priority: {
   readonly Highest: 0;
   readonly High: 50;
   readonly Default: 100;
   readonly Low: 150;
   readonly Lowest: 200;
 };
-type ExtensionContext = {
+export type ExtensionContext = {
   /**
    * The schema this runtime was built with. The documents the runtime edits
    * may be of another instance of it (header, footer and note editors each
@@ -72,7 +72,7 @@ type ExtensionContext = {
    */
   schema: Schema;
 };
-type FolioCommandArguments = {
+export type FolioCommandArguments = {
   toggleBold: [];
   toggleItalic: [];
   toggleUnderline: [];
@@ -160,46 +160,46 @@ type FolioCommandArguments = {
   setTableBorderColor: [color: string];
   setTableBorderWidth: [size: number];
 };
-type FolioCommandName = keyof FolioCommandArguments;
-type CommandFactory<Args extends readonly unknown[] = readonly unknown[]> = (...args: Args) => Command;
-type FolioCommandMap = Partial<{ [Name in FolioCommandName]: CommandFactory<FolioCommandArguments[Name]>; }>;
-type CommandMap = Record<string, (...args: any[]) => Command>;
-type ExtensionCommandMap = CommandMap & FolioCommandMap;
-type KeyboardShortcutMap = Record<string, Command>;
-type ExtensionRuntime = {
+export type FolioCommandName = keyof FolioCommandArguments;
+export type CommandFactory<Args extends readonly unknown[] = readonly unknown[]> = (...args: Args) => Command;
+export type FolioCommandMap = Partial<{ [Name in FolioCommandName]: CommandFactory<FolioCommandArguments[Name]>; }>;
+export type CommandMap = Record<string, (...args: any[]) => Command>;
+export type ExtensionCommandMap = CommandMap & FolioCommandMap;
+export type KeyboardShortcutMap = Record<string, Command>;
+export type ExtensionRuntime = {
   commands?: CommandMap;
   keyboardShortcuts?: KeyboardShortcutMap;
   plugins?: Plugin[];
 };
-type ExtensionConfig = {
+export type ExtensionConfig = {
   name: string;
   priority: ExtensionPriority;
   options: Record<string, unknown>;
 };
-type NodeExtensionConfig = {
+export type NodeExtensionConfig = {
   schemaNodeName: string;
   nodeSpec: NodeSpec;
 } & ExtensionConfig;
-type MarkExtensionConfig = {
+export type MarkExtensionConfig = {
   schemaMarkName: string;
   markSpec: MarkSpec;
 } & ExtensionConfig;
-type Extension = {
+export type Extension = {
   type: "extension";
   config: ExtensionConfig;
   onSchemaReady: (ctx: ExtensionContext) => ExtensionRuntime;
 };
-type NodeExtension = {
+export type NodeExtension = {
   type: "node";
   config: NodeExtensionConfig;
   onSchemaReady: (ctx: ExtensionContext) => ExtensionRuntime;
 };
-type MarkExtension = {
+export type MarkExtension = {
   type: "mark";
   config: MarkExtensionConfig;
   onSchemaReady: (ctx: ExtensionContext) => ExtensionRuntime;
 };
-type AnyExtension = Extension | NodeExtension | MarkExtension;
+export type AnyExtension = Extension | NodeExtension | MarkExtension;
 type ExtensionOptions = Record<string, unknown>;
 type ExtensionDefinitionWithDefaults<TOptions extends ExtensionOptions> = {
   name: string;
@@ -213,7 +213,7 @@ type ExtensionDefinitionWithoutDefaults<TOptions extends ExtensionOptions = Exte
   defaultOptions?: undefined;
   onSchemaReady: (ctx: ExtensionContext, options: Partial<TOptions>) => ExtensionRuntime;
 };
-type ExtensionDefinition<TOptions extends ExtensionOptions = ExtensionOptions> = ExtensionDefinitionWithDefaults<TOptions> | ExtensionDefinitionWithoutDefaults<TOptions>;
+export type ExtensionDefinition<TOptions extends ExtensionOptions = ExtensionOptions> = ExtensionDefinitionWithDefaults<TOptions> | ExtensionDefinitionWithoutDefaults<TOptions>;
 type NodeExtensionDefinitionWithDefaults<TOptions extends ExtensionOptions> = {
   name: string;
   priority?: ExtensionPriority;
@@ -230,7 +230,7 @@ type NodeExtensionDefinitionWithoutDefaults<TOptions extends ExtensionOptions =
   nodeSpec: NodeSpec | ((options: Partial<TOptions>) => NodeSpec);
   onSchemaReady?: (ctx: ExtensionContext, options: Partial<TOptions>) => ExtensionRuntime;
 };
-type NodeExtensionDefinition<TOptions extends ExtensionOptions = ExtensionOptions> = NodeExtensionDefinitionWithDefaults<TOptions> | NodeExtensionDefinitionWithoutDefaults<TOptions>;
+export type NodeExtensionDefinition<TOptions extends ExtensionOptions = ExtensionOptions> = NodeExtensionDefinitionWithDefaults<TOptions> | NodeExtensionDefinitionWithoutDefaults<TOptions>;
 type MarkExtensionDefinitionWithDefaults<TOptions extends ExtensionOptions> = {
   name: string;
   priority?: ExtensionPriority;
@@ -247,6 +247,6 @@ type MarkExtensionDefinitionWithoutDefaults<TOptions extends ExtensionOptions =
   markSpec: MarkSpec | ((options: Partial<TOptions>) => MarkSpec);
   onSchemaReady?: (ctx: ExtensionContext, options: Partial<TOptions>) => ExtensionRuntime;
 };
-type MarkExtensionDefinition<TOptions extends ExtensionOptions = ExtensionOptions> = MarkExtensionDefinitionWithDefaults<TOptions> | MarkExtensionDefinitionWithoutDefaults<TOptions>;
+export type MarkExtensionDefinition<TOptions extends ExtensionOptions = ExtensionOptions> = MarkExtensionDefinitionWithDefaults<TOptions> | MarkExtensionDefinitionWithoutDefaults<TOptions>;
 //#endregion
-export { AnyExtension, CommandFactory, CommandMap, Extension, ExtensionCommandMap, ExtensionConfig, ExtensionContext, ExtensionDefinition, ExtensionPriority, ExtensionRuntime, FolioCommandArguments, FolioCommandMap, FolioCommandName, KeyboardShortcutMap, MarkExtension, MarkExtensionConfig, MarkExtensionDefinition, NodeExtension, NodeExtensionConfig, NodeExtensionDefinition, Priority, TableBorderCommandSpec, TableCellBorderCommandSpec, TableCellMarginsCommand, type TablePropertiesCommand, TableStyleCommand };
+export type { TablePropertiesCommand };

package/dist/prosemirror/fieldRepresentation.d.ts

@@ -1,8 +1,9 @@
+import { FieldAttrs } from "./schema/nodes.js";
 import { Node } from "prosemirror-model";
 //#region src/prosemirror/fieldRepresentation.d.ts
+export declare const fieldCommentCoverage: (fieldKind: FieldAttrs["fieldKind"]) => "children" | "field";
 /** Current children alone decide whether a field needs editable structural content. */
-declare const fieldRequiresStructuredContent: (children: readonly Node[]) => boolean;
-/** Resolution returns text-only fields to the same atom representation as initial conversion. */
-declare const canonicalFieldNode: (node: Node) => Node;
-//#endregion
-export { canonicalFieldNode, fieldRequiresStructuredContent };
+export declare const fieldRequiresStructuredContent: (children: readonly Node[]) => boolean;
+/** Resolution collapses a field only when the atom can retain its result. */
+export declare const canonicalFieldNode: (node: Node) => Node;
+//#endregion

package/dist/prosemirror/fieldRepresentation.js

@@ -1,18 +1,30 @@
 import "./extensions/marks/InlineWrapperExtension.js";
+import { getInlineDisplayText } from "./inlineDisplayText.js";
+import "./runIdentity.js";
+import { Mark } from "prosemirror-model";
 //#region src/prosemirror/fieldRepresentation.ts
+const FIELD_COMMENT_COVERAGE = {
+	simple: "children",
+	complex: "field"
+};
+const fieldCommentCoverage = (fieldKind) => FIELD_COMMENT_COVERAGE[fieldKind];
 /** Current children alone decide whether a field needs editable structural content. */
-const fieldRequiresStructuredContent = (children) => children.some((child) => !child.isText || child.marks.some((mark) => mark.type.name === "hyperlink" || mark.type.name === "inlineWrapper" || mark.type.name === "insertion" || mark.type.name === "deletion"));
-/** Resolution returns text-only fields to the same atom representation as initial conversion. */
+const fieldRequiresStructuredContent = (children) => {
+	const first = children.at(0);
+	return children.some((child) => !child.isText || first !== void 0 && !Mark.sameSet(first.marks, child.marks) || child.marks.some((mark) => mark.type.name === "runIdentity" || mark.type.name === "footnoteRef" || mark.type.name === "hyperlink" || mark.type.name === "inlineWrapper" || mark.type.name === "insertion" || mark.type.name === "deletion"));
+};
+/** Resolution collapses a field only when the atom can retain its result. */
 const canonicalFieldNode = (node) => {
 	if (node.type.name !== "structuredField") return node;
+	const displayText = getInlineDisplayText(node);
 	const attrs = {
 		...node.attrs,
-		displayText: node.textContent
+		displayText
 	};
-	if (fieldRequiresStructuredContent(node.content.content)) return node.attrs["displayText"] === node.textContent ? node : node.type.create(attrs, node.content, node.marks);
+	if (fieldRequiresStructuredContent(node.content.content)) return node.attrs["displayText"] === displayText ? node : node.type.create(attrs, node.content, node.marks);
 	let marks = node.marks;
 	for (const mark of node.firstChild?.marks ?? []) marks = mark.addToSet(marks);
 	return node.type.schema.node("field", attrs, void 0, marks);
 };
 //#endregion
-export { canonicalFieldNode, fieldRequiresStructuredContent };
+export { canonicalFieldNode, fieldCommentCoverage, fieldRequiresStructuredContent };

package/dist/prosemirror/findReplaceSelection.d.ts

@@ -1,5 +1,6 @@
+import { document_d_exports } from "../types/document.js";
 import { DisplayMode } from "../managers/EditorModeManager.js";
-import { FindOptions } from "../utils/findReplace.js";
+import { FindMatch, FindOptions, FindSearchContext } from "../utils/findReplace.js";
 import { Node } from "prosemirror-model";
 import { EditorState } from "prosemirror-state";
 //#region src/prosemirror/findReplaceSelection.d.ts
@@ -11,7 +12,7 @@ import { EditorState } from "prosemirror-state";
  * offsets, so this declares exactly that subset and keeps core free of any
  * adapter-side type.
  */
-type FindMatchPosition = {
+export type FindMatchPosition = {
   /** Index of the paragraph containing the match. */
   paragraphIndex: number;
   /** Character offset of the match start within the paragraph. */
@@ -19,15 +20,29 @@ type FindMatchPosition = {
   /** Character offset of the match end within the paragraph. */
   endOffset: number;
 };
-type FindMatchRange = {
+export type FindMatchRange = {
   from: number;
   to: number;
+  /** Navigation anchors inside a logical match are excluded from decorations. */
+  excludedRanges?: {
+    from: number;
+    to: number;
+  }[];
+  /** Character subranges inside source atoms, whose text exceeds their PM size. */
+  atomicTextRanges?: {
+    from: number;
+    to: number;
+    startOffset: number;
+    endOffset: number;
+  }[];
 };
-type ProseMirrorFindMatch = FindMatchPosition & FindMatchRange & {
+export type ProseMirrorFindMatch = FindMatchPosition & FindMatchRange & {
   text: string;
 };
-declare function resolveFindMatchRange(doc: Node, match: FindMatchPosition): FindMatchRange | null;
-declare function findInProseMirrorDocument(doc: Node, searchText: string, options: FindOptions): ProseMirrorFindMatch[];
+export declare function resolveFindMatchRange(doc: Node, match: FindMatchPosition): FindMatchRange | null;
+/** Resolve a result set in one paragraph traversal, preserving result order. */
+export declare const resolveFindMatchRanges: (doc: Node, matches: readonly FindMatchPosition[]) => (FindMatchRange | null)[];
+export declare function findInProseMirrorDocument(doc: Node, searchText: string, options: FindOptions): ProseMirrorFindMatch[];
 type FindInMarkupViewOptions = {
   state: EditorState;
   markupView: DisplayMode;
@@ -35,6 +50,27 @@ type FindInMarkupViewOptions = {
   options: FindOptions;
 };
 /** Search the displayed story; returned ranges address the authored editor document. */
-declare const findInMarkupView: ({ state, markupView, searchText, options }: FindInMarkupViewOptions) => ProseMirrorFindMatch[];
+export declare const findInMarkupView: ({ state, markupView, searchText, options }: FindInMarkupViewOptions) => ProseMirrorFindMatch[];
+type FindInDisplayedDocumentOptions = {
+  document: document_d_exports.Document;
+  /**
+   * Live body editor state. A review view reads its body from this state's
+   * projection, so null defers that search until the body editor mounts.
+   * Hosts without an editor state omit it and search the package model.
+   */
+  state?: EditorState | null | undefined;
+  searchText: string;
+  options: FindOptions;
+  context?: FindSearchContext | undefined;
+};
+/**
+ * Search every story a display mode shows. All Markup searches the package
+ * stories. A resolved review view searches its body through the projection the
+ * layout paints, so body ranges address the authored editor document; anchored
+ * shapes, headers, footers, notes and comments keep the package search owner
+ * with the same display mode. Returns null while a review view has no body
+ * editor state to project.
+ */
+export declare const findInDisplayedDocument: ({ document, state, searchText, options, context }: FindInDisplayedDocumentOptions) => FindMatch[] | null;
 //#endregion
-export { FindMatchPosition, FindMatchRange, ProseMirrorFindMatch, findInMarkupView, findInProseMirrorDocument, resolveFindMatchRange };
+export {};