@stll/folio-core 0.45.0 → 0.47.0

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

@@ -0,0 +1,23 @@
+import { Node } from "prosemirror-model";
+//#region src/prosemirror/extensions/nodes/bookmarkBoundaryDom.d.ts
+declare const bookmarkBoundaryAttrSpec: {
+  type: {};
+  id: {};
+  name: {
+    default: null;
+  };
+  colFirst: {
+    default: null;
+  };
+  colLast: {
+    default: null;
+  };
+  displacedByCustomXml: {
+    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 };

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

@@ -0,0 +1,57 @@
+import { expectBookmarkBoundaryAttrs, isDisplacedByCustomXml } from "../../bookmarkBoundaryAttrs.js";
+//#region src/prosemirror/extensions/nodes/bookmarkBoundaryDom.ts
+const readNonnegativeInteger = (value) => {
+	if (value === null || !/^(?:0|[1-9]\d*)$/.test(value)) return false;
+	const parsed = Number(value);
+	return Number.isSafeInteger(parsed) ? parsed : false;
+};
+const readOptionalColumn = (dom, attribute) => {
+	const value = dom.getAttribute(attribute);
+	return value === null ? void 0 : readNonnegativeInteger(value);
+};
+const bookmarkBoundaryAttrSpec = {
+	type: {},
+	id: {},
+	name: { default: null },
+	colFirst: { default: null },
+	colLast: { default: null },
+	displacedByCustomXml: { default: null }
+};
+/** `false` when the element does not describe a boundary ProseMirror can hold. */
+const parseBookmarkBoundaryDom = (dom) => {
+	if (typeof dom === "string") return false;
+	const type = dom.getAttribute("data-docx-bookmark-boundary");
+	const id = readNonnegativeInteger(dom.getAttribute("data-docx-bookmark-id"));
+	if (type !== "start" && type !== "end" || id === false) return false;
+	const name = dom.getAttribute("data-docx-bookmark-name");
+	if (type === "start" && !name) return false;
+	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 } : {},
+		...isDisplacedByCustomXml(displaced) ? { displacedByCustomXml: displaced } : {}
+	};
+};
+const bookmarkBoundaryDomAttributes = (node, internalClipboardToken) => {
+	const attrs = expectBookmarkBoundaryAttrs(node);
+	return {
+		"data-docx-bookmark-boundary": attrs.type,
+		"data-docx-bookmark-id": String(attrs.id),
+		...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;",
+		...internalClipboardToken === void 0 ? {} : { "data-docx-internal-clipboard": internalClipboardToken }
+	};
+};
+//#endregion
+export { bookmarkBoundaryAttrSpec, bookmarkBoundaryDomAttributes, parseBookmarkBoundaryDom };

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

@@ -2,20 +2,29 @@ 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 { SectionBreakType } from "../sectionCarrier.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";
 //#region src/prosemirror/extensions/types.d.ts
+/**
+ * A border a host asks folio to apply.
+ *
+ * `style` is what the model holds, not a narrower authoring union: a table
+ * style preset is built by reading a parsed `w:tblBorders` and handing it
+ * back, so a token the schema does not declare has to survive the round trip
+ * rather than be refused at the command.
+ */
 type TableCellBorderCommandSpec = {
-  style: string;
+  style: document_d_exports.BorderStyleValue;
   size?: number;
   color?: {
     rgb: string;
   };
 };
 type TableBorderCommandSpec = {
-  style: string;
+  style: document_d_exports.BorderStyleValue;
   size: number;
   color: {
     rgb: string;
@@ -98,7 +107,7 @@ type FolioCommandArguments = {
   setSpaceAfter: [twips: number];
   applyStyle: [styleId: string, resolvedAttrs?: ResolvedStyleAttrs];
   clearStyle: [];
-  insertSectionBreak: [breakType: "nextPage" | "continuous" | "oddPage" | "evenPage"];
+  insertSectionBreak: [breakType: SectionBreakType];
   removeSectionBreak: [];
   addTabStop: [position: number, alignment?: document_d_exports.TabStopAlignment, leader?: document_d_exports.TabLeader];
   removeTabStop: [position: number];

package/dist/prosemirror/index.d.ts

@@ -4,6 +4,7 @@ import { ResolvedParagraphStyle, StyleResolver, createStyleResolver } from "./st
 import { schema, singletonManager } from "./schema/index.js";
 import { getParagraphAlignment, getParagraphBidi, getStyleId } from "./extensions/core/ParagraphExtension.js";
 import { BorderPreset, TableBorderPreset, TableContextInfo, getTableContext, isInTable as isInTableCell } from "./extensions/nodes/TableExtension.js";
+import { TableBorderCommandSpec, TableCellBorderCommandSpec } from "./extensions/types.js";
 import { CapturedTextFormatting, PAINTABLE_MARK_NAMES, applyFormatMarks, captureFormatMarks } from "./commands/formatPainter.js";
 import { clearFormatting, getMarkAttr, isMarkActive } from "./extensions/marks/markUtils.js";
 import { getHyperlinkAttrs, getSelectedText, isHyperlinkActive } from "./extensions/marks/HyperlinkExtension.js";
@@ -14,10 +15,11 @@ import { addTabStop, alignCenter, alignJustify, alignLeft, alignRight, applyStyl
 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";
-import { fromProseDoc, updateDocumentContent } from "./conversion/fromProseDoc.js";
+import { FromProseDocOptions, ProjectionReuse, fromProseDoc, updateDocumentContent } from "./conversion/fromProseDoc.js";
 import { ToProseDocOptions, createEmptyDoc, toProseDoc } from "./conversion/toProseDoc.js";
 import { ProseMirrorDocumentValidationIssue, ValidateProseMirrorDocumentResult, assertValidProseMirrorDocument, formatProseMirrorDocumentIssues, validateProseMirrorDocument } from "./validation.js";
 import "./conversion/index.js";
+import { ActiveListState, ListState, ListType, NO_LIST_STATE, isInListState, listStateLevel, resolveListState, sameListState } from "./listState.js";
 import { SelectionChangeCallback, SelectionContext, createSelectionTrackerPlugin, extractSelectionContext, getSelectionContext, selectionTrackerKey } from "./plugins/selectionTracker.js";
 import { ensureParaIdsInState } from "./extensions/features/ParaIdAllocatorExtension.js";
 import "./styles/index.js";
@@ -26,4 +28,4 @@ import { createDocumentStylesPlugin, documentStylesKey, getDocumentBuiltInStyles
 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, 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 };
+export { type ActiveListState, type BorderPreset, type CapturedTextFormatting, type FontFamilyAttrs, type FontSizeAttrs, type FromProseDocOptions, type HyperlinkAttrs, type ImageAttrs, type ListState, type ListType, NO_LIST_STATE, PAINTABLE_MARK_NAMES, type ParagraphAttrs, type ProjectionReuse, type ProseMirrorDocumentValidationIssue, type ResolvedParagraphStyle, type SelectionChangeCallback, type SelectionContext, type SelectionState, StyleResolver, type TableBorderCommandSpec, type TableBorderPreset, type TableCellBorderCommandSpec, 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, isInListState, isInTableCell as isInTable, isMarkActive, listStateLevel, mergeCells, removeHyperlink, removeList, removeTabStop, removeTableBorders, resolveListState, sameListState, 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

@@ -13,6 +13,7 @@ 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 { NO_LIST_STATE, isInListState, listStateLevel, resolveListState, sameListState } from "./listState.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";
@@ -20,4 +21,4 @@ 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, 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 };
+export { NO_LIST_STATE, 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, isInListState, isInTableCell as isInTable, isMarkActive, listStateLevel, mergeCells, removeHyperlink, removeList, removeTabStop, removeTableBorders, resolveListState, sameListState, 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/inlineWrapperStack.d.ts

@@ -0,0 +1,39 @@
+import { document_d_exports } from "../types/document.js";
+import { InlineWrapperLayer } from "./schema/marks.js";
+//#region src/prosemirror/inlineWrapperStack.d.ts
+/** The DOM attribute that carries a serialised stack through copy and paste. */
+declare const INLINE_WRAPPER_STACK_ATTRIBUTE = "data-inline-wrapper";
+/** A layer with its keys in canonical order, absent fields left absent. */
+declare const inlineWrapperLayer: (layer: InlineWrapperLayer) => InlineWrapperLayer;
+/**
+ * The model member a layer describes, holding `content`.
+ *
+ * The inverse of the `WrapperLayer` projection: `toProseDoc` takes the model
+ * member apart into a layer and its content, and the save leg puts one back
+ * together. Both directions live here so a wrapper kind is spelled once.
+ */
+declare const inlineWrapperMember: (layer: InlineWrapperLayer, content: document_d_exports.InlineWrapper["content"]) => document_d_exports.InlineWrapper;
+/** `layers` in canonical form, or `null` when there is no wrapper to record. */
+declare const inlineWrapperStack: (layers: readonly InlineWrapperLayer[]) => readonly InlineWrapperLayer[] | null;
+declare const serializeInlineWrapperStack: (stack: readonly InlineWrapperLayer[]) => string;
+/**
+ * The key two stacks share exactly when they are the same nest of wrappers.
+ *
+ * The save leg groups adjacent inline leaves by it, so it has to be the
+ * factory's canonical spelling rather than whatever order an attrs object
+ * happens to carry: two leaves inside one `w:bdo` that keyed differently would
+ * be written as two `w:bdo` elements. The empty stack keys as the empty string,
+ * which is what "inside no wrapper" compares as.
+ */
+declare const inlineWrapperStackKey: (stack: readonly InlineWrapperLayer[]) => string;
+/**
+ * A stack read back from the DOM, or `null` when the markup carries none.
+ *
+ * Paste from outside the editor is the ordinary case: the attribute is absent,
+ * so the pasted leaf carries no wrapper. Markup that states the attribute but
+ * not a stack this build validates is read the same way — the text is what
+ * matters, and inventing a wrapper around it would change the document.
+ */
+declare const parseInlineWrapperStack: (serialized: string | null | undefined) => readonly InlineWrapperLayer[] | null;
+//#endregion
+export { INLINE_WRAPPER_STACK_ATTRIBUTE, inlineWrapperLayer, inlineWrapperMember, inlineWrapperStack, inlineWrapperStackKey, parseInlineWrapperStack, serializeInlineWrapperStack };

package/dist/prosemirror/inlineWrapperStack.js

@@ -0,0 +1,92 @@
+import { readInlineWrapperStack } from "./attrs/index.js";
+import { Result, panic } from "better-result";
+//#region src/prosemirror/inlineWrapperStack.ts
+/**
+* The one place an inline-wrapper layer is built, and the codec that carries a
+* stack through the DOM.
+*
+* Two layers describing the same wrapper have to be the same value, because
+* `fromProseDoc` groups inline leaves into runs by `JSON.stringify` over their
+* mark attrs: one wrapper spelled with its keys in two orders would split one
+* run into two. Object key order is insertion order in JavaScript, so the
+* factory fixes it and every construction site goes through the factory —
+* including the one that reads a stack back out of the DOM, where `JSON.parse`
+* preserves whatever order the markup happened to carry.
+*/
+/** The DOM attribute that carries a serialised stack through copy and paste. */
+const INLINE_WRAPPER_STACK_ATTRIBUTE = "data-inline-wrapper";
+/**
+* A tagged layer's keys in canonical order.
+*
+* `propertiesXml` is part of the layer, so it is part of the stack key the
+* save leg groups by: two adjacent smart tags whose properties differ are two
+* wrappers, and folding them into one would attribute the second tag's text to
+* the first tag's properties.
+*/
+const taggedLayer = (kind, layer) => {
+	const canonical = {
+		kind,
+		element: layer.element
+	};
+	if (layer.uri !== void 0) canonical.uri = layer.uri;
+	if (layer.propertiesXml !== void 0) canonical.propertiesXml = layer.propertiesXml;
+	return canonical;
+};
+/** A layer with its keys in canonical order, absent fields left absent. */
+const inlineWrapperLayer = (layer) => {
+	switch (layer.kind) {
+		case "bidi": return layer.direction === void 0 ? {
+			kind: "bidi",
+			control: layer.control
+		} : {
+			kind: "bidi",
+			control: layer.control,
+			direction: layer.direction
+		};
+		case "smartTag": return taggedLayer("smartTag", layer);
+		case "customXml": return taggedLayer("customXml", layer);
+		default: panic(`Unsupported inline wrapper layer: ${JSON.stringify(layer)}`);
+	}
+};
+/**
+* The model member a layer describes, holding `content`.
+*
+* The inverse of the `WrapperLayer` projection: `toProseDoc` takes the model
+* member apart into a layer and its content, and the save leg puts one back
+* together. Both directions live here so a wrapper kind is spelled once.
+*/
+const inlineWrapperMember = (layer, content) => ({
+	...inlineWrapperLayer(layer),
+	type: "inlineWrapper",
+	content
+});
+/** `layers` in canonical form, or `null` when there is no wrapper to record. */
+const inlineWrapperStack = (layers) => layers.length === 0 ? null : layers.map(inlineWrapperLayer);
+const serializeInlineWrapperStack = (stack) => JSON.stringify(stack);
+/**
+* The key two stacks share exactly when they are the same nest of wrappers.
+*
+* The save leg groups adjacent inline leaves by it, so it has to be the
+* factory's canonical spelling rather than whatever order an attrs object
+* happens to carry: two leaves inside one `w:bdo` that keyed differently would
+* be written as two `w:bdo` elements. The empty stack keys as the empty string,
+* which is what "inside no wrapper" compares as.
+*/
+const inlineWrapperStackKey = (stack) => stack.length === 0 ? "" : serializeInlineWrapperStack(stack.map(inlineWrapperLayer));
+/**
+* A stack read back from the DOM, or `null` when the markup carries none.
+*
+* Paste from outside the editor is the ordinary case: the attribute is absent,
+* so the pasted leaf carries no wrapper. Markup that states the attribute but
+* not a stack this build validates is read the same way — the text is what
+* matters, and inventing a wrapper around it would change the document.
+*/
+const parseInlineWrapperStack = (serialized) => {
+	if (!serialized) return null;
+	const parsed = Result.try(() => JSON.parse(serialized));
+	if (parsed.isErr()) return null;
+	const stack = readInlineWrapperStack(parsed.value);
+	return stack.ok ? stack.value.map(inlineWrapperLayer) : null;
+};
+//#endregion
+export { INLINE_WRAPPER_STACK_ATTRIBUTE, inlineWrapperLayer, inlineWrapperMember, inlineWrapperStack, inlineWrapperStackKey, parseInlineWrapperStack, serializeInlineWrapperStack };

package/dist/prosemirror/listMarker.d.ts

@@ -69,11 +69,11 @@ declare function cloneListCounterState(state: ListCounterState): ListCounterStat
  * paragraphs advance only the document view in which they exist.
  */
 declare function advanceVisibleListMarker(attrs: ParagraphAttrs, streams: ListCounterStreams): VisibleListMarker;
-declare function formatCounter(value: number, format: document_d_exports.NumberFormat | undefined): string;
+declare function formatCounter(value: number, format: document_d_exports.CounterFormat | undefined): string;
 type ResolveListTemplateOptions = {
   template: string;
   counters: number[];
-  levelFormats?: document_d_exports.NumberFormat[] | undefined;
+  levelFormats?: document_d_exports.CounterFormat[] | undefined;
   forceDecimal?: boolean | undefined;
 };
 declare function resolveListTemplate(options: ResolveListTemplateOptions): string;

package/dist/prosemirror/listMarker.js

@@ -1,6 +1,7 @@
 import { convertBulletToUnicode } from "../docx/bulletMarkers.js";
-import { isNumberingReference } from "../docx/numberingReference.js";
+import { paragraphNumberingLevel, paragraphNumberingReferenceId, sameStatedParagraphNumbering } from "../docx/numberingReference.js";
 import { formatOoxmlCounter } from "../docx/ooxmlCounterFormatter.js";
+import { isListNumPr } from "../layout-engine/types.js";
 import { LIST_RENDERING_ATTR_KEYS } from "./listRenderingAttrs.js";
 //#region src/prosemirror/listMarker.ts
 const MAX_LIST_LEVEL = 8;
@@ -61,12 +62,10 @@ function cloneListCounterState(state) {
 		...state.lastAdvancedNumId !== void 0 ? { lastAdvancedNumId: state.lastAdvancedNumId } : {}
 	};
 }
-const isListNumPr = (value) => value !== void 0 && value !== null;
-const sameListNumPr = (left, right) => left.numId === right.numId && left.ilvl === right.ilvl;
 function previousListAttrs(attrs) {
 	const previous = (attrs._propertyChanges?.find(({ previousFormatting }) => {
 		const previousNumPr = previousFormatting?.numPr;
-		return isListNumPr(previousNumPr) && (!attrs.numPr || !sameListNumPr(previousNumPr, attrs.numPr));
+		return isListNumPr(previousNumPr) && (!attrs.numPr || !sameStatedParagraphNumbering(previousNumPr, attrs.numPr));
 	}))?.previousFormatting;
 	if (!previous || !isListNumPr(previous.numPr)) return null;
 	return {
@@ -117,7 +116,7 @@ function advanceVisibleListMarker(attrs, streams) {
 		advances
 	};
 	const numberingWasAdded = attrs._propertyChanges?.some(({ previousFormatting }) => previousFormatting && Object.hasOwn(previousFormatting, "numPr") && previousFormatting.numPr == null);
-	const numberingChanged = previous?.numPr !== void 0 && !sameListNumPr(previous.numPr, attrs.numPr);
+	const numberingChanged = previous?.numPr !== void 0 && !sameStatedParagraphNumbering(previous.numPr, attrs.numPr);
 	const visible = advance(attrs, "final");
 	if (attrs.pPrMark?.kind !== "ins" && !numberingWasAdded && !numberingChanged) advance(attrs, "original");
 	else if (numberingChanged && previous) advance(previous, "original");
@@ -177,10 +176,10 @@ function formatNumberedMarker(counters, level) {
 }
 function advanceListMarker(attrs, state) {
 	const markerTemplate = attrs.listMarkerTemplate ?? attrs.listMarker;
-	const level = attrs.numPr?.ilvl ?? 0;
+	const level = paragraphNumberingLevel(attrs.numPr) ?? 0;
 	if (!Number.isInteger(level) || level < 0 || level > 8) return null;
-	const numId = attrs.numPr?.numId;
-	if (!isNumberingReference(numId)) {
+	const numId = paragraphNumberingReferenceId(attrs.numPr);
+	if (numId === void 0) {
 		let marker = null;
 		if (markerTemplate?.includes("%") && !attrs.listIsBullet) {
 			const counters = getLastListCounters(state);

package/dist/prosemirror/listRenderingAttrs.js

@@ -1,4 +1,14 @@
+import { paragraphNumberingLevel } from "@stll/docx-core/model";
 //#region src/prosemirror/listRenderingAttrs.ts
+/**
+* The one table that ties `Paragraph.listRendering` to the editor's `list*`
+* attrs. Both projections (model → attrs in `toProseDoc`, attrs → model in
+* `fromProseDoc`) and the cleared-attr set derive from it, so a field added
+* to `ListRendering` without a projection fails to compile instead of being
+* silently dropped on the way out of the editor.
+*
+* `level` and `numId` are not here: they travel in `numPr`.
+*/
 const LIST_RENDERING_ATTR_BY_FIELD = {
 	marker: "listMarker",
 	markerTemplate: "listMarkerTemplate",
@@ -70,7 +80,7 @@ const listRenderingFromAttrs = ({ attrs, numId }) => {
 	};
 	return {
 		marker: attrs.listMarker ?? "",
-		level: attrs.numPr?.ilvl ?? 0,
+		level: paragraphNumberingLevel(attrs.numPr) ?? 0,
 		numId,
 		isBullet: attrs.listIsBullet ?? false,
 		...definedFields(optional)

package/dist/prosemirror/listState.d.ts

@@ -0,0 +1,62 @@
+import { NumberingMap } from "../docx/numberingParser.js";
+import { ParagraphNumberingOverride } from "@stll/docx-core/model";
+//#region src/prosemirror/listState.d.ts
+/**
+ * Which list the selection sits in, for a toolbar.
+ *
+ * One union, in core, for both adapters. There used to be three declarations
+ * of this — React's `ui/ListButtons`, Vue's `utils/listState`, and a third in
+ * Vue's editor types whose `type` had widened to `string` — none importing
+ * another and none covered by a parity gate, so they drifted without anything
+ * able to see it.
+ *
+ * The union also retires the `isInList` flag, which restated `type !== "none"`,
+ * and the `numId` that was meaningful only when it was set: a state such as
+ * `{ type: "none", isInList: true, numId: 7, level: -1 }` was representable and
+ * meant nothing.
+ */
+type ListState = {
+  readonly type: "none";
+} | {
+  readonly type: "bullet";
+  readonly level: number;
+  readonly numId?: number;
+} | {
+  readonly type: "numbered";
+  readonly level: number;
+  readonly numId?: number;
+};
+/** The kinds of list a toolbar distinguishes. */
+type ListType = ListState["type"];
+/** The selection is in no list. */
+declare const NO_LIST_STATE: {
+  readonly type: "none";
+};
+/** A selection that is in a list, so it has a level. */
+type ActiveListState = Exclude<ListState, {
+  type: "none";
+}>;
+/**
+ * Whether the selection is in a list at all: the one reader over the
+ * discriminator, so no consumer spells the empty arm itself.
+ */
+declare const isInListState: (state: ListState | undefined) => state is ActiveListState;
+/** The list level the selection sits at, zero when it is in no list. */
+declare const listStateLevel: (state: ListState | undefined) => number;
+/**
+ * The toolbar's view of a paragraph's stated numbering.
+ *
+ * Which kind of list it is comes from the numbering definitions, through the
+ * registry's own reader: a level whose `w:numFmt` is `bullet` is a bullet list
+ * and anything else is a numbered one. The adapters used to decide it from the
+ * id — `numId === 1` meant bullets — which was true only of documents Folio
+ * had created itself, and read a hundred-item bulleted import as numbered.
+ *
+ * A cancellation and a level with no resolved id are not lists. Callers that
+ * have a style tier must merge it before asking for toolbar state.
+ */
+declare const resolveListState: (numbering: NumberingMap | null | undefined, numPr: ParagraphNumberingOverride | undefined) => ListState;
+/** Whether two toolbar list states say the same thing. */
+declare const sameListState: (left: ListState | undefined, right: ListState | undefined) => boolean;
+//#endregion
+export { ActiveListState, ListState, ListType, NO_LIST_STATE, isInListState, listStateLevel, resolveListState, sameListState };

package/dist/prosemirror/listState.js

@@ -0,0 +1,49 @@
+import { isBulletLevel } from "../docx/numberingParser.js";
+import { panic } from "better-result";
+import { resolveParagraphNumbering } from "@stll/docx-core/model";
+//#region src/prosemirror/listState.ts
+/** The selection is in no list. */
+const NO_LIST_STATE = { type: "none" };
+/**
+* Whether the selection is in a list at all: the one reader over the
+* discriminator, so no consumer spells the empty arm itself.
+*/
+const isInListState = (state) => state !== void 0 && state.type !== "none";
+/** The list level the selection sits at, zero when it is in no list. */
+const listStateLevel = (state) => isInListState(state) ? state.level : 0;
+/**
+* The toolbar's view of a paragraph's stated numbering.
+*
+* Which kind of list it is comes from the numbering definitions, through the
+* registry's own reader: a level whose `w:numFmt` is `bullet` is a bullet list
+* and anything else is a numbered one. The adapters used to decide it from the
+* id — `numId === 1` meant bullets — which was true only of documents Folio
+* had created itself, and read a hundred-item bulleted import as numbered.
+*
+* A cancellation and a level with no resolved id are not lists. Callers that
+* have a style tier must merge it before asking for toolbar state.
+*/
+const resolveListState = (numbering, numPr) => {
+	if (numPr === void 0) return NO_LIST_STATE;
+	const resolved = resolveParagraphNumbering(numPr);
+	if (resolved.kind === "none") return NO_LIST_STATE;
+	const { numId, ilvl: level } = resolved;
+	const definition = numbering?.getLevel(numId, level) ?? null;
+	return {
+		type: definition !== null && isBulletLevel(definition) ? "bullet" : "numbered",
+		level,
+		numId
+	};
+};
+/** Whether two toolbar list states say the same thing. */
+const sameListState = (left, right) => {
+	if (left === void 0 || right === void 0) return left === right;
+	switch (left.type) {
+		case "none": return right.type === left.type;
+		case "bullet":
+		case "numbered": return left.type === right.type && left.level === right.level && left.numId === right.numId;
+		default: return panic(`Unhandled list state ${JSON.stringify(left)}`);
+	}
+};
+//#endregion
+export { NO_LIST_STATE, isInListState, listStateLevel, resolveListState, sameListState };

package/dist/prosemirror/moveRangeBoundaryAttrs.d.ts

@@ -0,0 +1,13 @@
+import { document_d_exports } from "../types/document.js";
+import { ReadProseMirrorAttrsResult } from "./attrs/index.js";
+import { Node } from "prosemirror-model";
+//#region src/prosemirror/moveRangeBoundaryAttrs.d.ts
+type MoveRangeMarker = Extract<document_d_exports.ParagraphContent, {
+  type: "moveFromRangeStart" | "moveFromRangeEnd" | "moveToRangeStart" | "moveToRangeEnd";
+}>;
+/** Read one hidden move-range boundary from an untyped editor or clipboard attribute. */
+declare const readMoveRangeMarker: (value: unknown, path?: string) => ReadProseMirrorAttrsResult<MoveRangeMarker>;
+declare const readMoveRangeBoundaryAttrs: (node: Node) => ReadProseMirrorAttrsResult<MoveRangeMarker>;
+declare const expectMoveRangeBoundaryAttrs: (node: Node) => MoveRangeMarker;
+//#endregion
+export { MoveRangeMarker, expectMoveRangeBoundaryAttrs, readMoveRangeBoundaryAttrs, readMoveRangeMarker };

package/dist/prosemirror/moveRangeBoundaryAttrs.js

@@ -0,0 +1,114 @@
+import { panic } from "better-result";
+//#region src/prosemirror/moveRangeBoundaryAttrs.ts
+const MOVE_RANGE_START_TYPES = /* @__PURE__ */ new Set(["moveFromRangeStart", "moveToRangeStart"]);
+const MOVE_RANGE_END_TYPES = /* @__PURE__ */ new Set(["moveFromRangeEnd", "moveToRangeEnd"]);
+const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+const isNonNegativeSafeInteger = (value) => typeof value === "number" && Number.isSafeInteger(value) && value >= 0;
+const displacementOf = (value) => value === "next" || value === "prev" ? value : void 0;
+/** Read one hidden move-range boundary from an untyped editor or clipboard attribute. */
+const readMoveRangeMarker = (value, path = "moveRangeBoundary.attrs.marker") => {
+	const issues = [];
+	if (!isRecord(value)) return {
+		ok: false,
+		issues: [{
+			path,
+			message: "Expected a move range marker object."
+		}]
+	};
+	const type = value["type"];
+	const isStart = typeof type === "string" && MOVE_RANGE_START_TYPES.has(type);
+	const isEnd = typeof type === "string" && MOVE_RANGE_END_TYPES.has(type);
+	if (!isStart && !isEnd) issues.push({
+		path: `${path}.type`,
+		message: "Expected a move range marker type."
+	});
+	const id = value["id"];
+	if (!isNonNegativeSafeInteger(id)) issues.push({
+		path: `${path}.id`,
+		message: "Expected a non-negative safe integer."
+	});
+	const displacedByCustomXml = displacementOf(value["displacedByCustomXml"]);
+	if (value["displacedByCustomXml"] !== void 0 && displacedByCustomXml === void 0) issues.push({
+		path: `${path}.displacedByCustomXml`,
+		message: "Expected \"next\" or \"prev\"."
+	});
+	const name = value["name"];
+	const author = value["author"];
+	const date = value["date"];
+	const colFirst = value["colFirst"];
+	const colLast = value["colLast"];
+	if (isStart) {
+		if (typeof name !== "string" || name.trim().length === 0) issues.push({
+			path: `${path}.name`,
+			message: "Expected a non-empty string."
+		});
+		if (typeof author !== "string" || author.trim().length === 0) issues.push({
+			path: `${path}.author`,
+			message: "Expected a non-empty string."
+		});
+		if (date !== void 0 && typeof date !== "string") issues.push({
+			path: `${path}.date`,
+			message: "Expected a string."
+		});
+		for (const [key, column] of [["colFirst", colFirst], ["colLast", colLast]]) if (column !== void 0 && !isNonNegativeSafeInteger(column)) issues.push({
+			path: `${path}.${key}`,
+			message: "Expected a non-negative safe integer."
+		});
+	}
+	if (issues.length > 0 || !isNonNegativeSafeInteger(id) || !isStart && !isEnd) return {
+		ok: false,
+		issues
+	};
+	const displacement = displacedByCustomXml === void 0 ? {} : { displacedByCustomXml };
+	if (type === "moveFromRangeEnd" || type === "moveToRangeEnd") return {
+		ok: true,
+		value: {
+			type,
+			id,
+			...displacement
+		}
+	};
+	if (type !== "moveFromRangeStart" && type !== "moveToRangeStart" || typeof name !== "string" || typeof author !== "string") return {
+		ok: false,
+		issues
+	};
+	return {
+		ok: true,
+		value: {
+			type,
+			id,
+			name,
+			author,
+			...typeof date === "string" ? { date } : {},
+			...typeof colFirst === "number" ? { colFirst } : {},
+			...typeof colLast === "number" ? { colLast } : {},
+			...displacement
+		}
+	};
+};
+const attrsCache = /* @__PURE__ */ new WeakMap();
+const readMoveRangeBoundaryAttrs = (node) => {
+	const result = readMoveRangeMarker(node.attrs["marker"]);
+	if (node.type.name === "moveRangeBoundary") return result;
+	const issue = {
+		path: "moveRangeBoundary.type.name",
+		message: `Expected moveRangeBoundary, got ${node.type.name}.`
+	};
+	return result.ok ? {
+		ok: false,
+		issues: [issue]
+	} : {
+		ok: false,
+		issues: [issue, ...result.issues]
+	};
+};
+const expectMoveRangeBoundaryAttrs = (node) => {
+	const cached = attrsCache.get(node);
+	if (cached) return cached;
+	const result = readMoveRangeBoundaryAttrs(node);
+	if (!result.ok) panic(`Invalid ProseMirror move range boundary attrs:\n${result.issues.map((issue) => `${issue.path}: ${issue.message}`).join("\n")}`);
+	attrsCache.set(node, result.value);
+	return result.value;
+};
+//#endregion
+export { expectMoveRangeBoundaryAttrs, readMoveRangeBoundaryAttrs, readMoveRangeMarker };