@stll/folio-core 0.43.0 → 0.44.0

package/dist/prosemirror/extensions/core/ParagraphExtension.d.ts

@@ -21,6 +21,19 @@ declare function getParagraphAlignment(state: EditorState): document_d_exports.P
 declare function getParagraphTabs(state: EditorState): document_d_exports.TabStop[] | null;
 declare function getStyleId(state: EditorState): string | null;
 declare function getParagraphBidi(state: EditorState): boolean;
+/**
+ * What a generated table of contents needs from its caller.
+ *
+ * The title is the caller's because this layer has no locale: a command in
+ * `@stll/folio-core` cannot know whether the document should read "Table of
+ * Contents", "Obsah" or "Inhaltsverzeichnis", and a hardcoded English string
+ * is wrong in every document that is not in English. The host passes the
+ * string it already renders its own UI with.
+ */
+type GenerateTableOfContentsOptions = {
+  /** Heading text for the table, in the document's language. */
+  title: string;
+};
 declare const ParagraphExtension: (options?: Partial<Record<string, unknown>> | undefined) => NodeExtension;
 //#endregion
-export { ParagraphExtension, ResolvedStyleAttrs, getParagraphAlignment, getParagraphBidi, getParagraphTabs, getStyleId };
+export { GenerateTableOfContentsOptions, ParagraphExtension, ResolvedStyleAttrs, getParagraphAlignment, getParagraphBidi, getParagraphTabs, getStyleId };

package/dist/prosemirror/extensions/core/ParagraphExtension.js

@@ -1,3 +1,4 @@
+import { BUILT_IN_STYLE_NAME } from "../../../docx/builtInStyles.js";
 import { PROSE_PARAGRAPH_SOURCE_TOKEN_ATTR } from "../../../docx/paragraphPropertySource.js";
 import { PARAGRAPH_ALIGNMENT_VALUES } from "../../../types/documentEnumValues.js";
 import { paragraphToStyle } from "../../../utils/formatToStyle.js";
@@ -8,6 +9,7 @@ import { autospacingMatchesBase } from "../../autospacingBase.js";
 import { directParagraphAlignment } from "../../paragraphAlignment.js";
 import { directionIsRtl } from "../../paragraphDirection.js";
 import { withDirectParagraphSpacing } from "../../paragraphSpacing.js";
+import { getDocumentBuiltInStyles } from "../../plugins/documentStyles.js";
 import { listAttrsFromResolvedStyle, paragraphAttrsFromResolvedStyle } from "../../styles/resolvedStyleAttrs.js";
 import { createNodeExtension } from "../create.js";
 import { Fragment } from "prosemirror-model";
@@ -248,6 +250,7 @@ const paragraphNodeSpec = {
 		bookmarks: { default: null },
 		_emptyHyperlinks: { default: null },
 		_originalFormatting: { default: null },
+		_resolvedFormatting: { default: void 0 },
 		_autospacingBase: { default: null },
 		_sectionProperties: { default: null },
 		_propertyChanges: { default: null },
@@ -602,8 +605,9 @@ const ParagraphExtension = createNodeExtension({
 			}),
 			insertSectionBreak: (breakType) => setParagraphAttr("sectionBreakType", breakType),
 			removeSectionBreak: () => setParagraphAttr("sectionBreakType", null),
-			generateTOC: () => (state, dispatch) => {
-				const headings = collectHeadings(state.doc);
+			generateTOC: ({ title }) => (state, dispatch) => {
+				const builtInStyles = getDocumentBuiltInStyles(state);
+				const headings = collectHeadings(state.doc, builtInStyles);
 				if (headings.length === 0) return false;
 				if (!dispatch) return true;
 				const { schema: s } = state;
@@ -630,10 +634,11 @@ const ParagraphExtension = createNodeExtension({
 					}
 				}
 				const tocNodes = [];
+				const tocHeadingStyleId = builtInStyles.styleIdForBuiltInName(BUILT_IN_STYLE_NAME.tocHeading);
 				tocNodes.push(s.node("paragraph", {
-					styleId: "TOCHeading",
+					...tocHeadingStyleId === void 0 ? {} : { styleId: tocHeadingStyleId },
 					alignment: "center"
-				}, [s.text("Table of Contents", s.marks["bold"] ? [s.marks["bold"].create()] : [])]));
+				}, [s.text(title, s.marks["bold"] ? [s.marks["bold"].create()] : [])]));
 				const DEFAULT_MARGIN_TWIPS = 1440;
 				let tocTabStopTwips = 12240 - 2 * DEFAULT_MARGIN_TWIPS;
 				let tabStopResolved = false;
@@ -650,7 +655,7 @@ const ParagraphExtension = createNodeExtension({
 				const canPageNumber = Boolean(s.nodes["field"] && s.nodes["tab"]);
 				for (const entry of bookmarkEntries) {
 					const indent = entry.level * 720;
-					const tocStyleId = `TOC${entry.level + 1}`;
+					const tocStyleId = builtInStyles.styleIdForTableOfContentsLevel(entry.level + 1);
 					if (!s.marks["hyperlink"]) continue;
 					const linkMark = s.marks["hyperlink"].create({ href: `#${entry.name}` });
 					const content = [s.text(entry.text, [linkMark])];
@@ -663,7 +668,7 @@ const ParagraphExtension = createNodeExtension({
 						dirty: true
 					}));
 					tocNodes.push(s.node("paragraph", {
-						styleId: tocStyleId,
+						...tocStyleId === void 0 ? {} : { styleId: tocStyleId },
 						indentLeft: indent > 0 ? indent : null,
 						...canPageNumber ? { tabs: [{
 							position: tocTabStopTwips,

package/dist/prosemirror/extensions/features/EmptyParagraphFormatExtension.js

@@ -7,9 +7,9 @@ const emptyParagraphFormatKey = new PluginKey("emptyParagraphFormat");
 * Run-formatting properties the painter does NOT reproduce from
 * `defaultTextFormatting` on its own (it forwards only font family + size).
 * When an empty paragraph's defaults carry any of these, typed text must
-* acquire real marks or it would render unstyled. Kept in sync with the
-* properties `textFormattingToMarks` can turn into marks — listing one it
-* can't (e.g. allCaps) would gate work that produces nothing.
+* acquire real marks or it would render unstyled. Every property listed here
+* must be one `textFormattingToMarks` can turn into a mark, or the gate would
+* open for work that produces nothing.
 */
 function hasNonFontDefaults(dtf) {
 	return !!(dtf.bold || dtf.italic || dtf.underline || dtf.strike || dtf.doubleStrike || dtf.color || dtf.highlight || dtf.vertAlign || dtf.rtl);

package/dist/prosemirror/extensions/features/PasteCleanupExtension.d.ts

@@ -11,7 +11,10 @@ import { Extension } from "../types.js";
  *    default clipboard parser; ProseMirror chains every plugin's
  *    `transformPastedHTML`, so this cooperates with the inliner rather than
  *    replacing it, and `<style>` blocks are left intact for it to resolve.
- * 2. `Mod-Alt-v` — "paste without formatting", inserting clipboard text with
+ * 2. `transformPasted` — drops unpaired bookmark boundaries, then points
+ *    pasted headings at the open document's own heading style (see
+ *    {@link retargetPastedHeadingStyles}).
+ * 3. `Mod-Alt-v` — "paste without formatting", inserting clipboard text with
  *    the source formatting stripped (see {@link pasteWithoutFormatting}).
  */
 type PasteCleanupOptions = {

package/dist/prosemirror/extensions/features/PasteCleanupExtension.js

@@ -2,6 +2,7 @@ import { pasteWithoutFormatting } from "../../commands/pastePlainText.js";
 import { createExtension } from "../create.js";
 import { Priority } from "../types.js";
 import { cleanPastedHtml, removeUnpairedBookmarkBoundaries } from "./pasteCleanup.js";
+import { retargetPastedHeadingStyles } from "./pastedHeadingStyles.js";
 import { Plugin } from "prosemirror-state";
 //#region src/prosemirror/extensions/features/PasteCleanupExtension.ts
 /**
@@ -15,7 +16,10 @@ import { Plugin } from "prosemirror-state";
 *    default clipboard parser; ProseMirror chains every plugin's
 *    `transformPastedHTML`, so this cooperates with the inliner rather than
 *    replacing it, and `<style>` blocks are left intact for it to resolve.
-* 2. `Mod-Alt-v` — "paste without formatting", inserting clipboard text with
+* 2. `transformPasted` — drops unpaired bookmark boundaries, then points
+*    pasted headings at the open document's own heading style (see
+*    {@link retargetPastedHeadingStyles}).
+* 3. `Mod-Alt-v` — "paste without formatting", inserting clipboard text with
 *    the source formatting stripped (see {@link pasteWithoutFormatting}).
 */
 const PasteCleanupExtension = createExtension({
@@ -28,7 +32,7 @@ const PasteCleanupExtension = createExtension({
 					const internalClipboardToken = options.getInternalClipboardToken?.();
 					return cleanPastedHtml(html, { ...internalClipboardToken ? { internalClipboardToken } : {} });
 				},
-				transformPasted: removeUnpairedBookmarkBoundaries
+				transformPasted: (slice, view) => retargetPastedHeadingStyles(removeUnpairedBookmarkBoundaries(slice), view)
 			} })],
 			keyboardShortcuts: { "Mod-Alt-v": pasteWithoutFormatting }
 		};

package/dist/prosemirror/extensions/features/pastedHeadingStyles.d.ts

@@ -0,0 +1,7 @@
+import { Slice } from "prosemirror-model";
+import { EditorView } from "prosemirror-view";
+//#region src/prosemirror/extensions/features/pastedHeadingStyles.d.ts
+/** A `transformPasted` hook; returns the slice unchanged when nothing matches. */
+declare const retargetPastedHeadingStyles: (slice: Slice, view: EditorView) => Slice;
+//#endregion
+export { retargetPastedHeadingStyles };

package/dist/prosemirror/extensions/features/pastedHeadingStyles.js

@@ -0,0 +1,74 @@
+import { isHeadingOutlineLevel } from "../../../docx/builtInStyles.js";
+import { getDocumentBuiltInStyles, getDocumentStyleResolver } from "../../plugins/documentStyles.js";
+import { Fragment, Slice } from "prosemirror-model";
+//#region src/prosemirror/extensions/features/pastedHeadingStyles.ts
+/**
+* Retarget pasted heading paragraphs at the open document's own heading style.
+*
+* The schema's `h1`–`h6` paste rule runs inside `parseDOM`, which sees no
+* document, so it can only write the English built-in id `Heading1`…`Heading6`.
+* In a document written by a localized Word the heading style is `Nadpis1` or
+* `berschrift2`, and in one folio generated from a style set the deeper levels
+* may not exist at all, so that id resolves to nothing and the pasted heading
+* loses the document's heading formatting.
+*
+* The paragraph still classifies as a heading either way — `parseDOM` also sets
+* `outlineLevel`, which is what `docx/builtInStyles.ts` reads first. This is
+* about which style the text picks up.
+*
+* Deliberately narrow: a paragraph is retargeted only when the document defines
+* no style under the id it carries. Pasting between two folio documents, or
+* within one, never reaches it. Creating a style stays an explicit command —
+* minting one here would edit `styles.xml` as a side effect of a clipboard
+* action — so a level the document does not define falls back to the deepest
+* heading it does. An `<h5>` pasted into a set that stops at `heading 4` lands
+* on that one rather than keeping an id nothing resolves.
+*/
+/**
+* The document's style for this heading level, else its deepest shallower one.
+* Never deeper: promoting an `<h5>` to `heading 1` would restructure the
+* document's outline, while demoting it to the deepest level it has preserves
+* the ordering of everything around it.
+*/
+const nearestHeadingStyleId = (outlineLevel, styles) => {
+	for (let level = outlineLevel; level >= 0; level -= 1) {
+		const styleId = styles.styleIdForHeadingLevel(level);
+		if (styleId !== void 0) return styleId;
+	}
+};
+const retargetedStyleId = (node, view) => {
+	const styleId = node.attrs["styleId"];
+	if (typeof styleId !== "string") return;
+	const outlineLevel = node.attrs["outlineLevel"];
+	if (typeof outlineLevel !== "number" || !isHeadingOutlineLevel(outlineLevel)) return;
+	const resolver = getDocumentStyleResolver(view.state);
+	if (resolver === null || resolver.getStyle(styleId) !== void 0) return;
+	const target = nearestHeadingStyleId(outlineLevel, getDocumentBuiltInStyles(view.state));
+	return target === styleId ? void 0 : target;
+};
+const retargetFragment = (fragment, view) => {
+	const children = [];
+	let changed = false;
+	fragment.forEach((node) => {
+		const content = retargetFragment(node.content, view);
+		const styleId = node.type.name === "paragraph" ? retargetedStyleId(node, view) : void 0;
+		if (styleId === void 0 && content === node.content) {
+			children.push(node);
+			return;
+		}
+		changed = true;
+		const retargeted = styleId === void 0 ? node : node.type.create({
+			...node.attrs,
+			styleId
+		}, content, node.marks);
+		children.push(styleId === void 0 ? node.copy(content) : retargeted);
+	});
+	return changed ? Fragment.fromArray(children) : fragment;
+};
+/** A `transformPasted` hook; returns the slice unchanged when nothing matches. */
+const retargetPastedHeadingStyles = (slice, view) => {
+	const content = retargetFragment(slice.content, view);
+	return content === slice.content ? slice : new Slice(content, slice.openStart, slice.openEnd);
+};
+//#endregion
+export { retargetPastedHeadingStyles };

package/dist/prosemirror/extensions/marks/markUtils.d.ts

@@ -21,10 +21,18 @@ declare function isMarkActive(state: EditorState, markType: MarkType, attrs?: Re
  * Get the current value of a mark attribute
  */
 declare function getMarkAttr(state: EditorState, markType: MarkType, attr: string): unknown;
+type AuthoredRunFormattingCarrier = "preserve" | "reconstruct";
 /**
- * Convert TextFormatting to marks array (used to restore formatting on empty paragraphs)
+ * Convert TextFormatting to ProseMirror marks
  */
-declare function textFormattingToMarks(formatting: document_d_exports.TextFormatting, schema: Schema): Mark[];
+type TextFormattingToMarksOptions = {
+  overrideFormatting: document_d_exports.TextFormatting | undefined;
+  /** Direct standard font properties whose authored provenance must survive. */
+  directFormatting?: document_d_exports.TextFormatting | undefined;
+  /** Whether direct authorship is reconstructible from structural marks and the style context. */
+  authoredCarrier?: AuthoredRunFormattingCarrier;
+};
+declare function textFormattingToMarks(formatting: document_d_exports.TextFormatting | undefined, schema: Schema, options?: TextFormattingToMarksOptions): Mark[];
 /**
  * Clear all text formatting (remove all marks)
  */
@@ -38,4 +46,4 @@ declare function createSetMarkCommand(markType: MarkType, attrs?: Record<string,
  */
 declare function createRemoveMarkCommand(markType: MarkType): Command;
 //#endregion
-export { clearFontSizeForAllScripts, clearFormatting, createRemoveMarkCommand, createSetMarkCommand, getMarkAttr, isMarkActive, removeMark, setFontSizeForAllScripts, setMark, textFormattingToMarks, toggleMarkForAllScripts, toggleUnderlineMark };
+export { AuthoredRunFormattingCarrier, clearFontSizeForAllScripts, clearFormatting, createRemoveMarkCommand, createSetMarkCommand, getMarkAttr, isMarkActive, removeMark, setFontSizeForAllScripts, setMark, textFormattingToMarks, toggleMarkForAllScripts, toggleUnderlineMark };

package/dist/prosemirror/extensions/marks/markUtils.js

@@ -1,8 +1,11 @@
 import { FONT_THEME_VALUES } from "../../../types/documentEnumValues.js";
 import { mergeFontFamily } from "../../../utils/fontFamilyMerge.js";
+import { normalizeHorizontalScalePercent } from "../../../utils/horizontalScale.js";
 import { expectFontFamilyMarkAttrs, expectRunFormattingOverrideMarkAttrs } from "../../attrs/index.js";
+import { shadingToRunShadingAttrs } from "../../conversion/runShadingMark.js";
 import { selectRunFormattingCarrierRepresentations } from "../../runFormattingInlineCarriers.js";
 import { hasRunFormattingOverrideAttrs } from "../../runFormattingProvenance.js";
+import { COMPLEX_SCRIPT_RUN_PROPERTY_KEYS } from "../../schema/marks.js";
 import { applyRunFormattingOverrideMark, buildRunFormattingOverrideAttrs } from "./RunFormattingOverrideExtension.js";
 import { toggleMark } from "prosemirror-commands";
 //#region src/prosemirror/extensions/marks/markUtils.ts
@@ -328,30 +331,85 @@ function getMarkAttr(state, markType, attr) {
 	});
 	return value;
 }
-/**
-* Convert TextFormatting to marks array (used to restore formatting on empty paragraphs)
-*/
-function textFormattingToMarks(formatting, schema) {
+const addDirectFontProvenance = (marks, schema, directFormatting) => {
+	const directFontProperties = [];
+	if (directFormatting?.fontFamily !== void 0) directFontProperties.push("fontFamily");
+	if (directFormatting?.fontSize !== void 0) directFontProperties.push("fontSize");
+	if (directFormatting?.color !== void 0) directFontProperties.push("color");
+	if (directFontProperties.length === 0) return;
+	const index = marks.findIndex(({ type }) => type.name === "runFormattingOverride");
+	const existing = index >= 0 ? marks.at(index) : void 0;
+	const override = schema.mark("runFormattingOverride", {
+		...existing?.attrs,
+		directFontProperties
+	});
+	if (index >= 0) {
+		marks[index] = override;
+		return;
+	}
+	marks.push(override);
+};
+const COMPLEX_SCRIPT_MIRRORS = [
+	{
+		ordinary: "bold",
+		complex: "boldCs"
+	},
+	{
+		ordinary: "italic",
+		complex: "italicCs"
+	},
+	{
+		ordinary: "fontSize",
+		complex: "fontSizeCs"
+	}
+];
+const addComplexScriptAbsenceProvenance = (marks, schema, directFormatting) => {
+	const absent = COMPLEX_SCRIPT_MIRRORS.filter(({ ordinary, complex }) => directFormatting?.[ordinary] !== void 0 && directFormatting[complex] === void 0).map(({ complex }) => complex);
+	if (absent.length === 0) return;
+	const index = marks.findIndex(({ type }) => type.name === "runFormattingOverride");
+	const existing = index >= 0 ? marks.at(index) : void 0;
+	const existingAbsences = new Set(existing?.attrs["complexScriptPropertyAbsences"] ?? []);
+	for (const property of absent) existingAbsences.add(property);
+	const override = schema.mark("runFormattingOverride", {
+		...existing?.attrs,
+		complexScriptPropertyAbsences: COMPLEX_SCRIPT_RUN_PROPERTY_KEYS.filter((property) => existingAbsences.has(property))
+	});
+	if (index >= 0) {
+		marks[index] = override;
+		return;
+	}
+	marks.push(override);
+};
+function textFormattingToMarks(formatting, schema, options) {
+	if (!formatting) return [];
 	const marks = [];
-	const overrideAttrs = buildRunFormattingOverrideAttrs(formatting);
-	if (overrideAttrs && schema.marks["runFormattingOverride"]) marks.push(schema.marks["runFormattingOverride"].create(overrideAttrs));
-	if (formatting.bold && schema.marks["bold"]) marks.push(schema.marks["bold"].create());
-	if (formatting.italic && schema.marks["italic"]) marks.push(schema.marks["italic"].create());
-	if (formatting.underline && schema.marks["underline"]) marks.push(schema.marks["underline"].create({
+	const overrideFormatting = options ? options.overrideFormatting : formatting;
+	let overrideAttrs;
+	if (options?.authoredCarrier === "reconstruct") overrideAttrs = buildRunFormattingOverrideAttrs(overrideFormatting, { type: "structural-only" });
+	else if (options) overrideAttrs = buildRunFormattingOverrideAttrs(overrideFormatting, {
+		type: "authored-baseline",
+		formatting: options.directFormatting
+	});
+	else overrideAttrs = buildRunFormattingOverrideAttrs(overrideFormatting);
+	if (overrideAttrs) marks.push(schema.mark("runFormattingOverride", overrideAttrs));
+	if (formatting.bold) marks.push(schema.mark("bold"));
+	if (formatting.italic) marks.push(schema.mark("italic"));
+	if (formatting.underline && formatting.underline.style !== "none") marks.push(schema.mark("underline", {
 		style: formatting.underline.style,
 		color: formatting.underline.color
 	}));
-	if (formatting.strike && schema.marks["strike"]) marks.push(schema.marks["strike"].create());
-	if (formatting.doubleStrike && schema.marks["strike"]) marks.push(schema.marks["strike"].create({ double: true }));
-	if (formatting.color && schema.marks["textColor"]) marks.push(schema.marks["textColor"].create({
+	if (formatting.strike || formatting.doubleStrike) marks.push(schema.mark("strike", { double: formatting.doubleStrike || false }));
+	if (formatting.color && !formatting.color.auto) marks.push(schema.mark("textColor", {
 		rgb: formatting.color.rgb,
 		themeColor: formatting.color.themeColor,
 		themeTint: formatting.color.themeTint,
 		themeShade: formatting.color.themeShade
 	}));
-	if (formatting.highlight && schema.marks["highlight"]) marks.push(schema.marks["highlight"].create({ color: formatting.highlight }));
-	if (formatting.fontSize !== void 0 && schema.marks["fontSize"]) marks.push(schema.marks["fontSize"].create({ size: formatting.fontSize }));
-	if (formatting.fontFamily && schema.marks["fontFamily"]) marks.push(schema.marks["fontFamily"].create({
+	if (formatting.highlight && formatting.highlight !== "none") marks.push(schema.mark("highlight", { color: formatting.highlight }));
+	const runShadingMarkAttrs = shadingToRunShadingAttrs(formatting.shading);
+	if (runShadingMarkAttrs) marks.push(schema.mark("runShading", runShadingMarkAttrs));
+	if (formatting.fontSize) marks.push(schema.mark("fontSize", { size: formatting.fontSize }));
+	if (formatting.fontFamily) marks.push(schema.mark("fontFamily", {
 		ascii: formatting.fontFamily.ascii,
 		hAnsi: formatting.fontFamily.hAnsi,
 		eastAsia: formatting.fontFamily.eastAsia,
@@ -362,10 +420,31 @@ function textFormattingToMarks(formatting, schema) {
 		eastAsiaTheme: formatting.fontFamily.eastAsiaTheme,
 		csTheme: formatting.fontFamily.csTheme
 	}));
-	if (formatting.language && schema.marks["language"]) marks.push(schema.marks["language"].create(formatting.language));
-	if (formatting.vertAlign === "superscript" && schema.marks["superscript"]) marks.push(schema.marks["superscript"].create());
-	if (formatting.vertAlign === "subscript" && schema.marks["subscript"]) marks.push(schema.marks["subscript"].create());
-	if (formatting.rtl && schema.marks["rtl"]) marks.push(schema.marks["rtl"].create());
+	if (formatting.language) marks.push(schema.mark("language", formatting.language));
+	if (formatting.vertAlign === "superscript") marks.push(schema.mark("superscript"));
+	else if (formatting.vertAlign === "subscript") marks.push(schema.mark("subscript"));
+	if (formatting.allCaps) marks.push(schema.mark("allCaps"));
+	if (formatting.smallCaps) marks.push(schema.mark("smallCaps"));
+	const spacing = typeof formatting.spacing === "number" ? formatting.spacing : null;
+	const position = typeof formatting.position === "number" ? formatting.position : null;
+	const scale = normalizeHorizontalScalePercent(formatting.scale) ?? null;
+	const kerning = typeof formatting.kerning === "number" ? formatting.kerning : null;
+	if (spacing !== null || position !== null || scale !== null || kerning !== null) marks.push(schema.mark("characterSpacing", {
+		spacing,
+		position,
+		scale,
+		kerning
+	}));
+	if (formatting.hidden === true) marks.push(schema.mark("hidden"));
+	if (formatting.emboss) marks.push(schema.mark("emboss"));
+	if (formatting.imprint) marks.push(schema.mark("imprint"));
+	if (formatting.shadow) marks.push(schema.mark("textShadow"));
+	if (formatting.emphasisMark && formatting.emphasisMark !== "none") marks.push(schema.mark("emphasisMark", { type: formatting.emphasisMark }));
+	if (formatting.outline) marks.push(schema.mark("textOutline"));
+	if (formatting.rtl) marks.push(schema.mark("rtl"));
+	if (formatting.effect && formatting.effect !== "none") marks.push(schema.mark("textEffect", { effect: formatting.effect }));
+	addDirectFontProvenance(marks, schema, options?.directFormatting);
+	if (options?.authoredCarrier === "preserve") addComplexScriptAbsenceProvenance(marks, schema, options.directFormatting);
 	return marks;
 }
 /**

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

@@ -1,5 +1,5 @@
 import { readParagraphAttrs } from "../../attrs/index.js";
-import { expectBookmarkBoundaryAttrs, readBookmarkBoundaryAttrs } from "../../bookmarkBoundaryAttrs.js";
+import { expectBookmarkBoundaryAttrs, isDisplacedByCustomXml, readBookmarkBoundaryAttrs } from "../../bookmarkBoundaryAttrs.js";
 import { findInvalidBookmarkBoundaryIds } from "../../bookmarkBoundaryIntegrity.js";
 import { createNodeExtension } from "../create.js";
 import { Plugin } from "prosemirror-state";
@@ -60,7 +60,8 @@ const BookmarkBoundaryExtension = createNodeExtension({
 			id: {},
 			name: { default: null },
 			colFirst: { default: null },
-			colLast: { default: null }
+			colLast: { default: null },
+			displacedByCustomXml: { default: null }
 		},
 		parseDOM: [{
 			tag: "span[data-docx-bookmark-boundary]",
@@ -73,12 +74,14 @@ const BookmarkBoundaryExtension = createNodeExtension({
 				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 displaced = dom.getAttribute("data-docx-bookmark-displaced");
 				return {
 					type,
 					id,
 					...name ? { name } : {},
 					...colFirst !== void 0 ? { colFirst } : {},
-					...colLast !== void 0 ? { colLast } : {}
+					...colLast !== void 0 ? { colLast } : {},
+					...isDisplacedByCustomXml(displaced) ? { displacedByCustomXml: displaced } : {}
 				};
 			}
 		}],
@@ -90,6 +93,7 @@ const BookmarkBoundaryExtension = createNodeExtension({
 				...attrs.type === "start" ? { "data-docx-bookmark-name": attrs.name } : {},
 				...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 } : {},
 				"aria-hidden": "true",
 				contenteditable: "false",
 				style: "display: none;",

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

@@ -49,7 +49,8 @@ const ImageExtension = createNodeExtension({
 			_docxRawXml: { default: null },
 			_docxRawXmlMode: { default: null },
 			_docxRawImageFingerprint: { default: null },
-			_docxObjectPreview: { default: null }
+			_docxObjectPreview: { default: null },
+			_docxRunFormatting: { default: null }
 		},
 		parseDOM: [{
 			tag: "img[src]",

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

@@ -369,6 +369,7 @@ const ShapeExtension = createNodeExtension({
 		attrs: {
 			shapeType: { default: "rect" },
 			geometryAdjustments: { default: null },
+			_docxRunFormatting: { default: null },
 			shapeId: { default: null },
 			width: { default: 100 },
 			height: { default: 80 },

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

@@ -1,3 +1,4 @@
+import { setTableLookFlags } from "../../../docx/tableLook.js";
 import { TABLE_CELL_TEXT_DIRECTION_VALUES, TABLE_WIDTH_TYPE_VALUES } from "../../../types/documentEnumValues.js";
 import { isValidHexColor, resolveColor } from "../../../utils/colorResolver.js";
 import { expectTableAttrs, expectTableCellAttrs, expectTableRowAttrs, mergeTableAttrs, mergeTableCellAttrs, mergeTableRowAttrs } from "../../attrs/index.js";
@@ -1618,7 +1619,20 @@ const TablePluginExtension = createExtension({
 					};
 					const conditionals = styleData.conditionals ?? {};
 					const tableBorders = styleData.tableBorders;
-					tr = tr.setNodeMarkup(tablePos, void 0, mergeTableAttrs(table, { styleId: styleData.styleId }));
+					tr = tr.setNodeMarkup(tablePos, void 0, mergeTableAttrs(table, {
+						styleId: styleData.styleId,
+						look: setTableLookFlags({
+							look: expectTableAttrs(table).look,
+							flags: {
+								firstRow: look.firstRow === true,
+								lastRow: look.lastRow === true,
+								firstColumn: look.firstCol === true,
+								lastColumn: look.lastCol === true,
+								noHBand: look.noHBand === true,
+								noVBand: look.noVBand === true
+							}
+						})
+					}));
 					let dataRowIndex = 0;
 					let rowOffset = tablePos + 1;
 					for (let rowIdx = 0; rowIdx < totalRows; rowIdx++) {

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

@@ -2,7 +2,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 { ResolvedStyleAttrs } from "./core/ParagraphExtension.js";
+import { GenerateTableOfContentsOptions, ResolvedStyleAttrs } from "./core/ParagraphExtension.js";
 import { BorderPreset, TableBorderPreset } from "./nodes/TableExtension.js";
 import { Command, Plugin } from "prosemirror-state";
 import { MarkSpec, NodeSpec, Schema } from "prosemirror-model";
@@ -106,7 +106,7 @@ type FolioCommandArguments = {
   setRtl: [];
   setLtr: [];
   setTabs: [tabs: document_d_exports.TabStop[]];
-  generateTOC: [];
+  generateTOC: [options: GenerateTableOfContentsOptions];
   insertTable: [rows: number, cols: number];
   addRowAbove: [];
   addRowBelow: [];

package/dist/prosemirror/index.d.ts

@@ -10,7 +10,7 @@ import { getHyperlinkAttrs, getSelectedText, isHyperlinkActive } from "./extensi
 import { clearFontFamily, clearFontSize, clearHighlight, clearTextColor, insertHyperlink, removeHyperlink, setFontFamily, setFontSize, setHighlight, setHyperlink, setTextColor, toggleBold, toggleItalic, toggleStrike, toggleSubscript, toggleSuperscript, toggleUnderline } from "./commands/formatting.js";
 import { insertImageFromFile } from "./commands/image.js";
 import { getListInfo, isInList } from "./extensions/features/ListExtension.js";
-import { addTabStop, alignCenter, alignJustify, alignLeft, alignRight, applyStyle, clearStyle, decreaseIndent, decreaseListLevel, generateTOC, increaseIndent, increaseListLevel, removeList, removeTabStop, setAlignment, setIndentFirstLine, setIndentLeft, setIndentRight, setLineSpacing, setLtr, setRtl, toggleBidi, toggleBulletList, toggleNumberedList } from "./commands/paragraph.js";
+import { addTabStop, alignCenter, alignJustify, alignLeft, alignRight, applyStyle, clearStyle, decreaseIndent, decreaseListLevel, generateTableOfContents, increaseIndent, increaseListLevel, removeList, removeTabStop, setAlignment, setIndentFirstLine, setIndentLeft, setIndentRight, setLineSpacing, setLtr, setRtl, toggleBidi, toggleBulletList, toggleNumberedList } from "./commands/paragraph.js";
 import { addColumnLeft, addColumnRight, addRowAbove, addRowBelow, applyTableStyle, autoFitContents, deleteColumn, deleteRow, deleteTable, distributeColumns, insertTable, mergeCells, removeTableBorders, selectColumn, selectRow, selectTable, setAllTableBorders, setCellBorder, setCellFillColor, setCellMargins, setCellTextDirection, setCellVerticalAlign, setInsideTableBorders, setOutsideTableBorders, setRowHeight, setTableBorderColor, setTableBorderPreset, setTableBorderWidth, setTableBorders, setTableProperties, splitCell, toggleHeaderRow, toggleNoWrap } from "./commands/table.js";
 import { insertPageBreak } from "./commands/pageBreak.js";
 import "./commands/index.js";
@@ -22,8 +22,8 @@ import { SelectionChangeCallback, SelectionContext, createSelectionTrackerPlugin
 import { ensureParaIdsInState } from "./extensions/features/ParaIdAllocatorExtension.js";
 import "./styles/index.js";
 import { SelectionState, extractSelectionState } from "./selectionState.js";
-import { createDocumentStylesPlugin, documentStylesKey, getDocumentStyleResolver } from "./plugins/documentStyles.js";
+import { createDocumentStylesPlugin, documentStylesKey, getDocumentBuiltInStyles, getDocumentStyleResolver } from "./plugins/documentStyles.js";
 import "./plugins/index.js";
 import { insertPageBreakInView, insertTableInView, insertTableOfContentsInView } from "./insertOperations.js";
 import { TextSelection } from "prosemirror-state";
-export { type BorderPreset, type CapturedTextFormatting, type FontFamilyAttrs, type FontSizeAttrs, type HyperlinkAttrs, type ImageAttrs, PAINTABLE_MARK_NAMES, type ParagraphAttrs, type ProseMirrorDocumentValidationIssue, type ResolvedParagraphStyle, type SelectionChangeCallback, type SelectionContext, type SelectionState, StyleResolver, type TableBorderPreset, type TableContextInfo, type TextColorAttrs, TextSelection, type ToProseDocOptions, type UnderlineAttrs, type ValidateProseMirrorDocumentResult, addColumnLeft, addColumnRight, addRowAbove, addRowBelow, addTabStop, alignCenter, alignJustify, alignLeft, alignRight, applyFormatMarks, applyStyle, applyTableStyle, assertValidProseMirrorDocument, autoFitContents, captureFormatMarks, clearFontFamily, clearFontSize, clearFormatting, clearHighlight, clearStyle, clearTextColor, createDocumentStylesPlugin, createEmptyDoc, createSelectionTrackerPlugin, createStyleResolver, decreaseIndent, decreaseListLevel, deleteColumn, deleteRow, deleteTable, distributeColumns, documentStylesKey, ensureParaIdsInState, extractSelectionContext, extractSelectionState, formatProseMirrorDocumentIssues, fromProseDoc, generateTOC, getDocumentStyleResolver, getHyperlinkAttrs, getListInfo, getMarkAttr, getParagraphAlignment, getParagraphBidi, getSelectedText, getSelectionContext, getStyleId, getTableContext, increaseIndent, increaseListLevel, insertHyperlink, insertImageFromFile, insertPageBreak, insertPageBreakInView, insertTable, insertTableInView, insertTableOfContentsInView, isHyperlinkActive, isInList, isInTableCell as isInTable, isMarkActive, mergeCells, removeHyperlink, removeList, removeTabStop, removeTableBorders, schema, selectColumn, selectRow, selectTable, selectionTrackerKey, setAlignment, setAllTableBorders, setCellBorder, setCellFillColor, setCellMargins, setCellTextDirection, setCellVerticalAlign, setFontFamily, setFontSize, setHighlight, setHyperlink, setIndentFirstLine, setIndentLeft, setIndentRight, setInsideTableBorders, setLineSpacing, setLtr, setOutsideTableBorders, setRowHeight, setRtl, setTableBorderColor, setTableBorderPreset, setTableBorderWidth, setTableBorders, setTableProperties, setTextColor, singletonManager, splitCell, toProseDoc, toggleBidi, toggleBold, toggleBulletList, toggleHeaderRow, toggleItalic, toggleNoWrap, toggleNumberedList, toggleStrike, toggleSubscript, toggleSuperscript, toggleUnderline, updateDocumentContent, validateProseMirrorDocument };
+export { type BorderPreset, type CapturedTextFormatting, type FontFamilyAttrs, type FontSizeAttrs, type HyperlinkAttrs, type ImageAttrs, PAINTABLE_MARK_NAMES, type ParagraphAttrs, type ProseMirrorDocumentValidationIssue, type ResolvedParagraphStyle, type SelectionChangeCallback, type SelectionContext, type SelectionState, StyleResolver, type TableBorderPreset, type TableContextInfo, type TextColorAttrs, TextSelection, type ToProseDocOptions, type UnderlineAttrs, type ValidateProseMirrorDocumentResult, addColumnLeft, addColumnRight, addRowAbove, addRowBelow, addTabStop, alignCenter, alignJustify, alignLeft, alignRight, applyFormatMarks, applyStyle, applyTableStyle, assertValidProseMirrorDocument, autoFitContents, captureFormatMarks, clearFontFamily, clearFontSize, clearFormatting, clearHighlight, clearStyle, clearTextColor, createDocumentStylesPlugin, createEmptyDoc, createSelectionTrackerPlugin, createStyleResolver, decreaseIndent, decreaseListLevel, deleteColumn, deleteRow, deleteTable, distributeColumns, documentStylesKey, ensureParaIdsInState, extractSelectionContext, extractSelectionState, formatProseMirrorDocumentIssues, fromProseDoc, generateTableOfContents, getDocumentBuiltInStyles, getDocumentStyleResolver, getHyperlinkAttrs, getListInfo, getMarkAttr, getParagraphAlignment, getParagraphBidi, getSelectedText, getSelectionContext, getStyleId, getTableContext, increaseIndent, increaseListLevel, insertHyperlink, insertImageFromFile, insertPageBreak, insertPageBreakInView, insertTable, insertTableInView, insertTableOfContentsInView, isHyperlinkActive, isInList, isInTableCell as isInTable, isMarkActive, mergeCells, removeHyperlink, removeList, removeTabStop, removeTableBorders, schema, selectColumn, selectRow, selectTable, selectionTrackerKey, setAlignment, setAllTableBorders, setCellBorder, setCellFillColor, setCellMargins, setCellTextDirection, setCellVerticalAlign, setFontFamily, setFontSize, setHighlight, setHyperlink, setIndentFirstLine, setIndentLeft, setIndentRight, setInsideTableBorders, setLineSpacing, setLtr, setOutsideTableBorders, setRowHeight, setRtl, setTableBorderColor, setTableBorderPreset, setTableBorderWidth, setTableBorders, setTableProperties, setTextColor, singletonManager, splitCell, toProseDoc, toggleBidi, toggleBold, toggleBulletList, toggleHeaderRow, toggleItalic, toggleNoWrap, toggleNumberedList, toggleStrike, toggleSubscript, toggleSuperscript, toggleUnderline, updateDocumentContent, validateProseMirrorDocument };

package/dist/prosemirror/index.js

@@ -2,7 +2,7 @@ import { PAINTABLE_MARK_NAMES, applyFormatMarks, captureFormatMarks } from "./co
 import { clearFontFamily, clearFontSize, clearHighlight, clearTextColor, insertHyperlink, removeHyperlink, setFontFamily, setFontSize, setHighlight, setHyperlink, setTextColor, toggleBold, toggleItalic, toggleStrike, toggleSubscript, toggleSuperscript, toggleUnderline } from "./commands/formatting.js";
 import { insertImageFromFile } from "./commands/image.js";
 import { insertPageBreak } from "./commands/pageBreak.js";
-import { addTabStop, alignCenter, alignJustify, alignLeft, alignRight, applyStyle, clearStyle, decreaseIndent, decreaseListLevel, generateTOC, increaseIndent, increaseListLevel, removeList, removeTabStop, setAlignment, setIndentFirstLine, setIndentLeft, setIndentRight, setLineSpacing, setLtr, setRtl, toggleBidi, toggleBulletList, toggleNumberedList } from "./commands/paragraph.js";
+import { addTabStop, alignCenter, alignJustify, alignLeft, alignRight, applyStyle, clearStyle, decreaseIndent, decreaseListLevel, generateTableOfContents, increaseIndent, increaseListLevel, removeList, removeTabStop, setAlignment, setIndentFirstLine, setIndentLeft, setIndentRight, setLineSpacing, setLtr, setRtl, toggleBidi, toggleBulletList, toggleNumberedList } from "./commands/paragraph.js";
 import { addColumnLeft, addColumnRight, addRowAbove, addRowBelow, applyTableStyle, autoFitContents, deleteColumn, deleteRow, deleteTable, distributeColumns, insertTable, mergeCells, removeTableBorders, selectColumn, selectRow, selectTable, setAllTableBorders, setCellBorder, setCellFillColor, setCellMargins, setCellTextDirection, setCellVerticalAlign, setInsideTableBorders, setOutsideTableBorders, setRowHeight, setTableBorderColor, setTableBorderPreset, setTableBorderWidth, setTableBorders, setTableProperties, splitCell, toggleHeaderRow, toggleNoWrap } from "./commands/table.js";
 import { fromProseDoc, updateDocumentContent } from "./conversion/fromProseDoc.js";
 import { createEmptyDoc, toProseDoc } from "./conversion/toProseDoc.js";
@@ -13,11 +13,11 @@ import { getHyperlinkAttrs, getSelectedText, isHyperlinkActive } from "./extensi
 import { clearFormatting, getMarkAttr, isMarkActive } from "./extensions/marks/markUtils.js";
 import { getTableContext, isInTable as isInTableCell } from "./extensions/nodes/TableExtension.js";
 import { insertPageBreakInView, insertTableInView, insertTableOfContentsInView } from "./insertOperations.js";
-import { createDocumentStylesPlugin, documentStylesKey, getDocumentStyleResolver } from "./plugins/documentStyles.js";
+import { createDocumentStylesPlugin, documentStylesKey, getDocumentBuiltInStyles, getDocumentStyleResolver } from "./plugins/documentStyles.js";
 import { createSelectionTrackerPlugin, extractSelectionContext, getSelectionContext, selectionTrackerKey } from "./plugins/selectionTracker.js";
 import { schema, singletonManager } from "./schema/index.js";
 import { extractSelectionState } from "./selectionState.js";
 import { StyleResolver, createStyleResolver } from "./styles/styleResolver.js";
 import { assertValidProseMirrorDocument, formatProseMirrorDocumentIssues, validateProseMirrorDocument } from "./validation.js";
 import { TextSelection } from "prosemirror-state";
-export { PAINTABLE_MARK_NAMES, StyleResolver, TextSelection, addColumnLeft, addColumnRight, addRowAbove, addRowBelow, addTabStop, alignCenter, alignJustify, alignLeft, alignRight, applyFormatMarks, applyStyle, applyTableStyle, assertValidProseMirrorDocument, autoFitContents, captureFormatMarks, clearFontFamily, clearFontSize, clearFormatting, clearHighlight, clearStyle, clearTextColor, createDocumentStylesPlugin, createEmptyDoc, createSelectionTrackerPlugin, createStyleResolver, decreaseIndent, decreaseListLevel, deleteColumn, deleteRow, deleteTable, distributeColumns, documentStylesKey, ensureParaIdsInState, extractSelectionContext, extractSelectionState, formatProseMirrorDocumentIssues, fromProseDoc, generateTOC, getDocumentStyleResolver, getHyperlinkAttrs, getListInfo, getMarkAttr, getParagraphAlignment, getParagraphBidi, getSelectedText, getSelectionContext, getStyleId, getTableContext, increaseIndent, increaseListLevel, insertHyperlink, insertImageFromFile, insertPageBreak, insertPageBreakInView, insertTable, insertTableInView, insertTableOfContentsInView, isHyperlinkActive, isInList, isInTableCell as isInTable, isMarkActive, mergeCells, removeHyperlink, removeList, removeTabStop, removeTableBorders, schema, selectColumn, selectRow, selectTable, selectionTrackerKey, setAlignment, setAllTableBorders, setCellBorder, setCellFillColor, setCellMargins, setCellTextDirection, setCellVerticalAlign, setFontFamily, setFontSize, setHighlight, setHyperlink, setIndentFirstLine, setIndentLeft, setIndentRight, setInsideTableBorders, setLineSpacing, setLtr, setOutsideTableBorders, setRowHeight, setRtl, setTableBorderColor, setTableBorderPreset, setTableBorderWidth, setTableBorders, setTableProperties, setTextColor, singletonManager, splitCell, toProseDoc, toggleBidi, toggleBold, toggleBulletList, toggleHeaderRow, toggleItalic, toggleNoWrap, toggleNumberedList, toggleStrike, toggleSubscript, toggleSuperscript, toggleUnderline, updateDocumentContent, validateProseMirrorDocument };
+export { PAINTABLE_MARK_NAMES, StyleResolver, TextSelection, addColumnLeft, addColumnRight, addRowAbove, addRowBelow, addTabStop, alignCenter, alignJustify, alignLeft, alignRight, applyFormatMarks, applyStyle, applyTableStyle, assertValidProseMirrorDocument, autoFitContents, captureFormatMarks, clearFontFamily, clearFontSize, clearFormatting, clearHighlight, clearStyle, clearTextColor, createDocumentStylesPlugin, createEmptyDoc, createSelectionTrackerPlugin, createStyleResolver, decreaseIndent, decreaseListLevel, deleteColumn, deleteRow, deleteTable, distributeColumns, documentStylesKey, ensureParaIdsInState, extractSelectionContext, extractSelectionState, formatProseMirrorDocumentIssues, fromProseDoc, generateTableOfContents, getDocumentBuiltInStyles, getDocumentStyleResolver, getHyperlinkAttrs, getListInfo, getMarkAttr, getParagraphAlignment, getParagraphBidi, getSelectedText, getSelectionContext, getStyleId, getTableContext, increaseIndent, increaseListLevel, insertHyperlink, insertImageFromFile, insertPageBreak, insertPageBreakInView, insertTable, insertTableInView, insertTableOfContentsInView, isHyperlinkActive, isInList, isInTableCell as isInTable, isMarkActive, mergeCells, removeHyperlink, removeList, removeTabStop, removeTableBorders, schema, selectColumn, selectRow, selectTable, selectionTrackerKey, setAlignment, setAllTableBorders, setCellBorder, setCellFillColor, setCellMargins, setCellTextDirection, setCellVerticalAlign, setFontFamily, setFontSize, setHighlight, setHyperlink, setIndentFirstLine, setIndentLeft, setIndentRight, setInsideTableBorders, setLineSpacing, setLtr, setOutsideTableBorders, setRowHeight, setRtl, setTableBorderColor, setTableBorderPreset, setTableBorderWidth, setTableBorders, setTableProperties, setTextColor, singletonManager, splitCell, toProseDoc, toggleBidi, toggleBold, toggleBulletList, toggleHeaderRow, toggleItalic, toggleNoWrap, toggleNumberedList, toggleStrike, toggleSubscript, toggleSuperscript, toggleUnderline, updateDocumentContent, validateProseMirrorDocument };

package/dist/prosemirror/insertOperations.d.ts

@@ -1,11 +1,18 @@
+import { GenerateTableOfContentsOptions } from "./extensions/core/ParagraphExtension.js";
 import { insertImageFromFile } from "./commands/image.js";
+import "./commands/index.js";
 import { EditorView } from "prosemirror-view";
 //#region src/prosemirror/insertOperations.d.ts
 /** Insert a `rows × columns` table at the current selection. */
 declare function insertTableInView(view: EditorView, rows: number, columns: number): boolean;
 /** Insert a page break at the current selection. */
 declare function insertPageBreakInView(view: EditorView): boolean;
-/** Generate (or refresh) a table of contents from the document's headings. */
-declare function insertTableOfContentsInView(view: EditorView): boolean;
+/**
+ * Generate (or refresh) a table of contents from the document's headings.
+ *
+ * `title` is the caller's because this layer has no locale — see
+ * {@link GenerateTableOfContentsOptions}.
+ */
+declare function insertTableOfContentsInView(view: EditorView, options: GenerateTableOfContentsOptions): boolean;
 //#endregion
 export { insertImageFromFile, insertPageBreakInView, insertTableInView, insertTableOfContentsInView };

package/dist/prosemirror/insertOperations.js

@@ -1,6 +1,6 @@
 import { insertImageFromFile } from "./commands/image.js";
 import { insertPageBreak } from "./commands/pageBreak.js";
-import { generateTOC } from "./commands/paragraph.js";
+import { generateTableOfContents } from "./commands/paragraph.js";
 import { insertTable } from "./commands/table.js";
 //#region src/prosemirror/insertOperations.ts
 /** Insert a `rows × columns` table at the current selection. */
@@ -11,9 +11,14 @@ function insertTableInView(view, rows, columns) {
 function insertPageBreakInView(view) {
 	return insertPageBreak(view.state, view.dispatch);
 }
-/** Generate (or refresh) a table of contents from the document's headings. */
-function insertTableOfContentsInView(view) {
-	return generateTOC(view.state, view.dispatch);
+/**
+* Generate (or refresh) a table of contents from the document's headings.
+*
+* `title` is the caller's because this layer has no locale — see
+* {@link GenerateTableOfContentsOptions}.
+*/
+function insertTableOfContentsInView(view, options) {
+	return generateTableOfContents(options)(view.state, view.dispatch);
 }
 //#endregion
 export { insertImageFromFile, insertPageBreakInView, insertTableInView, insertTableOfContentsInView };