@stll/folio-core 0.46.0 → 0.47.1

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.js

@@ -15,6 +15,23 @@ import { Result, panic } from "better-result";
 */
 /** 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) {
@@ -26,9 +43,9 @@ const inlineWrapperLayer = (layer) => {
 			control: layer.control,
 			direction: layer.direction
 		};
-		default:
-			layer.kind;
-			panic(`Unsupported inline wrapper layer: ${JSON.stringify(layer)}`);
+		case "smartTag": return taggedLayer("smartTag", layer);
+		case "customXml": return taggedLayer("customXml", layer);
+		default: panic(`Unsupported inline wrapper layer: ${JSON.stringify(layer)}`);
 	}
 };
 /**

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 };

package/dist/prosemirror/numberedRefFields.js

@@ -1,4 +1,4 @@
-import { isNumberingReference } from "../docx/numberingReference.js";
+import { paragraphNumberingLevel, paragraphNumberingReferenceId } from "../docx/numberingReference.js";
 import { expectFieldAttrs, expectParagraphAttrs } from "./attrs/index.js";
 import { expectBookmarkBoundaryAttrs } from "./bookmarkBoundaryAttrs.js";
 import { advanceVisibleListMarker, createListCounterState, resolveListTemplateWithComponents } from "./listMarker.js";
@@ -79,10 +79,10 @@ function numberTargetForParagraph(node, contextStreams, streams) {
 	return visibleTarget;
 }
 function numberTargetForAdvancedMarker(attrs, resolvedMarker, state, contexts) {
-	const numId = attrs.numPr?.numId;
-	if (!isNumberingReference(numId) || attrs.listIsBullet || attrs.listMarkerHidden || attrs.listNumFmt === "none" || !resolvedMarker) return null;
+	const numId = paragraphNumberingReferenceId(attrs.numPr);
+	if (numId === void 0 || attrs.listIsBullet || attrs.listMarkerHidden || attrs.listNumFmt === "none" || !resolvedMarker) return null;
 	const marker = attrs.listMarkerAllCaps ? resolvedMarker.toLocaleUpperCase() : resolvedMarker;
-	const level = attrs.numPr?.ilvl ?? 0;
+	const level = paragraphNumberingLevel(attrs.numPr) ?? 0;
 	if (!Number.isInteger(level) || level < 0 || level > 8) return null;
 	const counters = state.counters.get(numId)?.slice(0, level + 1);
 	const levelFormats = attrs.listLevelNumFmts ?? (attrs.listNumFmt ? [attrs.listNumFmt] : void 0);

package/dist/prosemirror/numberingAttr.d.ts

@@ -0,0 +1,55 @@
+import { ParagraphNumberingOverride } from "@stll/docx-core/model";
+//#region src/prosemirror/numberingAttr.d.ts
+declare const PARAGRAPH_NUMBERING_ATTR: unique symbol;
+/**
+ * The only value a persisted `numPr` attr slot may hold.
+ *
+ * It is the model's union, minted by {@link paragraphNumberingAttr} and by
+ * nothing else. The brand is what makes the mint unavoidable: a
+ * `ParagraphFormatting.numPr` read off a model object, or a record assembled
+ * by hand, does not carry it and so cannot be assigned to an attr. That is the
+ * defect the two tiers kept trading — a model value stored verbatim in an attr
+ * (`toProseDoc`'s `_propertyChanges` projection) and an attr value stored
+ * verbatim in the model-typed `_originalFormatting`
+ * (`paragraphRejectOriginalFormatting`) — each of which read as the other's
+ * shape on the far side.
+ *
+ * Reading needs no unbranding: the brand is a phantom property, so an attr
+ * value is already a `ParagraphNumberingOverride` to every consumer.
+ */
+type ParagraphNumberingAttr = ParagraphNumberingOverride & {
+  readonly [PARAGRAPH_NUMBERING_ATTR]: true;
+};
+/** Mint the attr value for a stated override: the one model-to-attr crossing. */
+declare const paragraphNumberingAttr: (numbering: ParagraphNumberingOverride) => ParagraphNumberingAttr;
+/**
+ * The one shape check over a persisted `numPr` attr.
+ *
+ * The attr validator and the readers that go straight to `node.attrs` share
+ * it, so a snapshot shape can be accepted in one place and rejected in the
+ * other only by deleting this function.
+ *
+ * It is deliberately strict. ProseMirror's `computeAttrs` copies whatever a
+ * stored document holds into the node without validating, so the pre-union
+ * shape — the two `<w:numPr>` slots, where `numId` 0 meant a cancellation —
+ * would otherwise arrive as a `numPr` whose `kind` is `undefined`, which every
+ * `switch` over the union reads as the arm it is not. Returning `null` for it
+ * is what lets the caller refuse.
+ *
+ * `ilvl` is bounded below and not above: real packages carry levels past the
+ * nine the format defines, and docx-core preserves them.
+ */
+declare const paragraphNumberingFromAttrValue: (value: unknown) => ParagraphNumberingAttr | null;
+/**
+ * A paragraph's stated numbering, read straight from an unvalidated attrs
+ * record. `null` is the attr's absent state, which is what the node spec's
+ * default stores.
+ *
+ * A value that is present and not a {@link ParagraphNumberingAttr} panics
+ * rather than being ignored: it can only come from a document written under an
+ * attr schema this build does not read, and `yjsDocumentMetadata`'s version
+ * gate exists to make that unreachable.
+ */
+declare const readParagraphNumberingAttr: (value: unknown) => ParagraphNumberingAttr | null;
+//#endregion
+export { ParagraphNumberingAttr, paragraphNumberingAttr, paragraphNumberingFromAttrValue, readParagraphNumberingAttr };

package/dist/prosemirror/numberingAttr.js

@@ -0,0 +1,74 @@
+import { panic } from "better-result";
+import { NO_PARAGRAPH_NUMBERING, paragraphNumberingFromSlots, paragraphNumberingReference } from "@stll/docx-core/model";
+//#region src/prosemirror/numberingAttr.ts
+const branded = (numbering) => numbering;
+/** Mint the attr value for a stated override: the one model-to-attr crossing. */
+const paragraphNumberingAttr = (numbering) => {
+	switch (numbering.kind) {
+		case "none": return branded(NO_PARAGRAPH_NUMBERING);
+		case "reference": return branded(paragraphNumberingReference({
+			numId: numbering.numId,
+			ilvl: numbering.ilvl
+		}));
+		case "levelOnly": return branded({
+			kind: "levelOnly",
+			ilvl: numbering.ilvl
+		});
+		default: return panic(`Unhandled paragraph numbering ${JSON.stringify(numbering)}`);
+	}
+};
+/** A `<w:numPr>` slot value: an ordinal, so a non-integer or a negative is not one. */
+const isNumberingSlot = (value) => typeof value === "number" && Number.isInteger(value) && value >= 0;
+/**
+* The one shape check over a persisted `numPr` attr.
+*
+* The attr validator and the readers that go straight to `node.attrs` share
+* it, so a snapshot shape can be accepted in one place and rejected in the
+* other only by deleting this function.
+*
+* It is deliberately strict. ProseMirror's `computeAttrs` copies whatever a
+* stored document holds into the node without validating, so the pre-union
+* shape — the two `<w:numPr>` slots, where `numId` 0 meant a cancellation —
+* would otherwise arrive as a `numPr` whose `kind` is `undefined`, which every
+* `switch` over the union reads as the arm it is not. Returning `null` for it
+* is what lets the caller refuse.
+*
+* `ilvl` is bounded below and not above: real packages carry levels past the
+* nine the format defines, and docx-core preserves them.
+*/
+const paragraphNumberingFromAttrValue = (value) => {
+	if (value === null || typeof value !== "object" || Array.isArray(value)) return null;
+	const kind = Reflect.get(value, "kind");
+	if (kind === "none") return branded(NO_PARAGRAPH_NUMBERING);
+	const ilvl = Reflect.get(value, "ilvl");
+	if (kind === "levelOnly") return isNumberingSlot(ilvl) ? branded({
+		kind: "levelOnly",
+		ilvl
+	}) : null;
+	if (kind !== "reference") return null;
+	const numId = Reflect.get(value, "numId");
+	if (!isNumberingSlot(numId) || ilvl !== void 0 && !isNumberingSlot(ilvl)) return null;
+	const stated = paragraphNumberingFromSlots({
+		ilvl,
+		numId
+	});
+	return stated?.kind === "reference" ? branded(stated) : null;
+};
+/**
+* A paragraph's stated numbering, read straight from an unvalidated attrs
+* record. `null` is the attr's absent state, which is what the node spec's
+* default stores.
+*
+* A value that is present and not a {@link ParagraphNumberingAttr} panics
+* rather than being ignored: it can only come from a document written under an
+* attr schema this build does not read, and `yjsDocumentMetadata`'s version
+* gate exists to make that unreachable.
+*/
+const readParagraphNumberingAttr = (value) => {
+	if (value === void 0 || value === null) return null;
+	const numbering = paragraphNumberingFromAttrValue(value);
+	if (numbering === null) panic(`Invalid paragraph numPr attr: ${JSON.stringify(value)}`);
+	return numbering;
+};
+//#endregion
+export { paragraphNumberingAttr, paragraphNumberingFromAttrValue, readParagraphNumberingAttr };

package/dist/prosemirror/outlineLevelAttr.d.ts

@@ -0,0 +1,29 @@
+import { OutlineLevel } from "@stll/docx-core/model";
+//#region src/prosemirror/outlineLevelAttr.d.ts
+/**
+ * The one shape check over a persisted `outlineLevel` node attr.
+ *
+ * The attr validator and the readers that go straight to `node.attrs` share
+ * it, so a snapshot shape can be accepted in one place and rejected in the
+ * other only by deleting this function.
+ *
+ * It is deliberately strict. ProseMirror's `computeAttrs` copies whatever a
+ * stored document holds into the node without validating, so the pre-union
+ * shape — a bare `number`, where `9` meant body text — would otherwise arrive
+ * as an `outlineLevel` no consumer recognises and every consumer silently
+ * ignores. Returning `null` for it is what lets the caller refuse.
+ */
+declare const outlineLevelFromAttrValue: (value: unknown) => OutlineLevel | null;
+/**
+ * A paragraph's stated outline level, read straight from an unvalidated attrs
+ * record. `null` is the attr's absent state, which is what the node spec's
+ * default stores.
+ *
+ * A value that is present and not an {@link OutlineLevel} panics rather than
+ * being ignored: it can only come from a document written under an attr schema
+ * this build does not read, and `yjsDocumentMetadata`'s version gate exists to
+ * make that unreachable.
+ */
+declare const readOutlineLevelAttr: (value: unknown) => OutlineLevel | null;
+//#endregion
+export { outlineLevelFromAttrValue, readOutlineLevelAttr };

package/dist/prosemirror/outlineLevelAttr.js

@@ -0,0 +1,42 @@
+import { panic } from "better-result";
+import { headingOutlineLevel } from "@stll/docx-core/model";
+//#region src/prosemirror/outlineLevelAttr.ts
+/**
+* The one shape check over a persisted `outlineLevel` node attr.
+*
+* The attr validator and the readers that go straight to `node.attrs` share
+* it, so a snapshot shape can be accepted in one place and rejected in the
+* other only by deleting this function.
+*
+* It is deliberately strict. ProseMirror's `computeAttrs` copies whatever a
+* stored document holds into the node without validating, so the pre-union
+* shape — a bare `number`, where `9` meant body text — would otherwise arrive
+* as an `outlineLevel` no consumer recognises and every consumer silently
+* ignores. Returning `null` for it is what lets the caller refuse.
+*/
+const outlineLevelFromAttrValue = (value) => {
+	if (value === null || typeof value !== "object" || Array.isArray(value)) return null;
+	const kind = Reflect.get(value, "kind");
+	if (kind === "bodyText") return { kind: "bodyText" };
+	if (kind !== "heading") return null;
+	const level = Reflect.get(value, "level");
+	return typeof level === "number" ? headingOutlineLevel(level) ?? null : null;
+};
+/**
+* A paragraph's stated outline level, read straight from an unvalidated attrs
+* record. `null` is the attr's absent state, which is what the node spec's
+* default stores.
+*
+* A value that is present and not an {@link OutlineLevel} panics rather than
+* being ignored: it can only come from a document written under an attr schema
+* this build does not read, and `yjsDocumentMetadata`'s version gate exists to
+* make that unreachable.
+*/
+const readOutlineLevelAttr = (value) => {
+	if (value === void 0 || value === null) return null;
+	const outlineLevel = outlineLevelFromAttrValue(value);
+	if (outlineLevel === null) panic(`Invalid paragraph outlineLevel attr: ${JSON.stringify(value)}`);
+	return outlineLevel;
+};
+//#endregion
+export { outlineLevelFromAttrValue, readOutlineLevelAttr };