@stll/folio-core 0.58.5 → 0.60.0

package/dist/prosemirror/plugins/templateSlashMenu.js

@@ -1,6 +1,26 @@
+import { createPluginKeyOwner } from "../pluginKeyOwner.js";
 import { getTemplateDirectives } from "./templateDirectives.js";
-import { Plugin, PluginKey } from "prosemirror-state";
+import { Plugin } from "prosemirror-state";
 //#region src/prosemirror/plugins/templateSlashMenu.ts
+/**
+* Template slash-menu trigger plugin.
+*
+* Watches the template editor for a `/` typed at a marker boundary (start of a
+* text block or right after whitespace) and tracks the query the author types
+* after it. The plugin owns only the *trigger* state — `{active, from, query}` —
+* and the keyboard contract while active; the floating menu UI and the actual
+* marker insertion live in the host (template-studio), which subscribes via
+* {@link TemplateSlashMenuPluginOptions.onChange} and resolves keys via
+* {@link TemplateSlashMenuPluginOptions.onKeyAction}.
+*
+* The trigger guard is deliberately strict so the menu never misfires inside
+* ordinary legal prose: dates (`30/06`), `and/or`, and URLs all have a non-space
+* char before the `/`, so only a leading or post-whitespace `/` opens the menu.
+*
+* Insertion is host-driven: a doc-changing transaction the host dispatches to
+* insert the marker carries a `clear` meta so the plugin tears down without the
+* generic doc-change reset racing the host's selection move.
+*/
 const IDLE = {
 	active: false,
 	from: null,
@@ -8,9 +28,7 @@ const IDLE = {
 	query: ""
 };
 const QUERY_CHAR = /[\p{L}\p{N}_.-]/u;
-const KEY_HOLDER_SYMBOL = Symbol.for("stll.folio.templateSlashMenuKey");
-const keyHolder = globalThis;
-const templateSlashMenuKey = keyHolder[KEY_HOLDER_SYMBOL] ?? (keyHolder[KEY_HOLDER_SYMBOL] = new PluginKey("templateSlashMenu"));
+const templateSlashMenuKey = createPluginKeyOwner("templateSlashMenu");
 /** Whether the char immediately before `pos` is a marker boundary (start of the
 *  text block or whitespace). This is the misfire guard: a `/` mid-token (dates,
 *  URLs, and/or) has a word char before it and never opens the menu. */
@@ -78,7 +96,7 @@ const tryOpenTrigger = (view) => {
 };
 const templateSlashMenuPlugin = (options = {}) => {
 	return new Plugin({
-		key: templateSlashMenuKey,
+		key: templateSlashMenuKey.createKey(),
 		state: {
 			init: () => IDLE,
 			apply: (tr, value, _oldState, newState) => {

package/dist/prosemirror/plugins/transactionInvariants.js

@@ -1,8 +1,29 @@
-import { paragraphNumberingReferenceId } from "../../docx/numberingReference.js";
+import { expectParagraphAttrs } from "../attrs/index.js";
+import { effectiveParagraphNumberingReference, paragraphNumberingSourcesFromBoundary } from "../numberingAttr.js";
+import { createPluginKeyOwner } from "../pluginKeyOwner.js";
 import { validateProseMirrorDocument } from "../validation.js";
 import { getDocumentNumbering, hasDocumentNumbering } from "./documentNumbering.js";
-import { Plugin, PluginKey } from "prosemirror-state";
+import { Plugin } from "prosemirror-state";
 //#region src/prosemirror/plugins/transactionInvariants.ts
+/**
+* Transaction invariants: a development and test aid that checks the editor
+* document after every transaction, so a command that leaves a document the
+* save path will refuse fails where it happens rather than at save.
+*
+* Off by default. {@link ExtensionManager} installs it when
+* `globalThis.__folioTransactionInvariants` is `{ enabled: true }` at the time
+* the runtime is initialized; the core test preload sets that flag, which turns
+* every editor test built on the extension manager into a validity check. A
+* host may set it in a development build. Production code never reads it
+* otherwise.
+*
+* The checks are the ones the document-model validator makes that the editor
+* state can answer on its own:
+* - the ProseMirror document is structurally valid (node and mark attributes,
+*   bookmark pairing), incrementally cached per node;
+* - every paragraph numbering reference names an instance the document's
+*   numbering defines.
+*/
 /** Whether new extension-manager runtimes install the invariant plugin. */
 const areTransactionInvariantsEnabled = () => globalThis.__folioTransactionInvariants?.enabled === true;
 const MAX_REPORTED_STEPS_LENGTH = 4e3;
@@ -27,7 +48,10 @@ const numberingReferenceIssues = (state) => {
 	const issues = [];
 	state.doc.descendants((node, pos) => {
 		if (node.type.name !== "paragraph") return true;
-		const numId = paragraphNumberingReferenceId(node.attrs["numPr"]);
+		const numId = effectiveParagraphNumberingReference(paragraphNumberingSourcesFromBoundary({
+			numPr: expectParagraphAttrs(node).numPr,
+			numPrFromStyle: expectParagraphAttrs(node).numPrFromStyle
+		}))?.numId;
 		if (numId !== void 0 && !numbering?.hasNumbering(numId)) issues.push({
 			path: `paragraph at ${pos}.numPr.numId`,
 			message: `Numbering definition ${numId} is missing.`,
@@ -65,14 +89,14 @@ const introducedIssues = (before, after, transactions) => {
 		return false;
 	});
 };
-const transactionInvariantsKey = new PluginKey("transactionInvariants");
+const transactionInvariantsKey = createPluginKeyOwner("transactionInvariants");
 /**
 * Throw a {@link TransactionInvariantError} naming the offending steps when a
 * document-changing transaction leaves the state with an issue it did not
 * have before.
 */
 const createTransactionInvariantPlugin = () => new Plugin({
-	key: transactionInvariantsKey,
+	key: transactionInvariantsKey.createKey(),
 	appendTransaction(transactions, oldState, newState) {
 		if (!transactions.some((transaction) => transaction.docChanged)) return null;
 		const issues = checkEditorStateInvariants(newState);

package/dist/prosemirror/schema/nodes.d.ts

@@ -346,8 +346,9 @@ type ParagraphPropertyChangeAttrs = Omit<document_d_exports.ParagraphPropertyCha
     provenance?: TrackedChangeProvenance;
     suggestionId?: string | null;
   };
-  previousFormatting?: Omit<document_d_exports.ParagraphFormatting, "numPr"> & {
+  previousFormatting?: Omit<document_d_exports.ParagraphFormatting, "numPr" | "numPrFromStyle"> & {
     numPr?: ParagraphAttrs["numPr"] | null;
+    numPrFromStyle?: ParagraphAttrs["numPrFromStyle"] | null;
   } & Partial<Pick<ParagraphAttrs, "listIsBullet" | "listIsLegal" | "listNumFmt" | "listMarker" | "listMarkerTemplate" | "listMarkerHidden" | "listMarkerFormatting" | "listMarkerAlignment" | "listMarkerSuffix" | "listMarkerAllCaps" | "listImplicitChildLevelAdvances" | "listFoldedMarkerSuffix" | "listMarkerSecondSlotOffsetTwips" | "listLevelNumFmts" | "listLevelStarts" | "listLevelTabs" | "listAbstractNumId" | "listStartOverride" | "lineSpacingExplicit" | "direction" | "_autospacingBase">>;
   currentFormatting?: document_d_exports.ParagraphFormatting;
 };

package/dist/prosemirror/selectionState.js

@@ -1,6 +1,7 @@
 import { FONT_THEME_VALUES } from "../types/documentEnumValues.js";
 import { expectFontFamilyMarkAttrs, expectFontSizeMarkAttrs, expectHighlightMarkAttrs, expectParagraphAttrs, expectStrikeMarkAttrs, expectTextColorMarkAttrs, expectUnderlineMarkAttrs } from "./attrs/index.js";
 import { resolveListState } from "./listState.js";
+import { effectiveParagraphNumbering, paragraphNumberingSourcesFromBoundary } from "./numberingAttr.js";
 import { directionIsRtl } from "./paragraphDirection.js";
 import { getDocumentNumbering } from "./plugins/documentNumbering.js";
 import { collectMarksInRange } from "./selectionMarks.js";
@@ -46,7 +47,10 @@ function extractSelectionSnapshot(state) {
 		styleId,
 		startParagraphIndex,
 		endParagraphIndex,
-		listState: resolveListState(getDocumentNumbering(state), paragraphFormatting.numPr)
+		listState: resolveListState(getDocumentNumbering(state), effectiveParagraphNumbering(paragraphNumberingSourcesFromBoundary({
+			numPr: paragraphAttrs?.numPr,
+			numPrFromStyle: paragraphAttrs?.numPrFromStyle
+		})))
 	};
 }
 /** Compatibility entry point used by existing React and Vue integrations. */

package/dist/prosemirror/storyListNumbering.js

@@ -1,6 +1,6 @@
 import { createNumberingIdAllocator } from "../docx/numberingIds.js";
 import { getCachedNumberingMap, isBulletLevel } from "../docx/numberingParser.js";
-import { paragraphNumberingLevel, paragraphNumberingReference, paragraphNumberingReferenceId } from "../docx/numberingReference.js";
+import { paragraphNumberingReference } from "../docx/numberingReference.js";
 import { expectParagraphAttrs } from "./attrs/index.js";
 import { completeNumberingForDoc, paragraphListReferences } from "./listInstanceReferences.js";
 import { paragraphNumberingAttr } from "./numberingAttr.js";
@@ -8,13 +8,12 @@ import { getPackageNumberingDefinitions } from "./plugins/documentNumbering.js";
 import { Transform } from "prosemirror-transform";
 //#region src/prosemirror/storyListNumbering.ts
 const remappedNumPr = (numPr, numIds) => {
-	const numId = paragraphNumberingReferenceId(numPr ?? void 0);
-	const next = numId === void 0 ? void 0 : numIds.get(numId);
+	if (numPr?.kind !== "reference") return numPr;
+	const next = numIds.get(numPr.numId);
 	if (next === void 0) return numPr;
-	const ilvl = paragraphNumberingLevel(numPr ?? void 0);
-	return paragraphNumberingAttr(paragraphNumberingReference(ilvl === void 0 ? { numId: next } : {
+	return paragraphNumberingAttr(paragraphNumberingReference(numPr.ilvl === void 0 ? { numId: next } : {
 		numId: next,
-		ilvl
+		ilvl: numPr.ilvl
 	}));
 };
 const remappedAbstractNumId = (abstractNumId, remap) => {
@@ -47,10 +46,10 @@ const storyListNumbering = (state, numbering) => {
 			const abstractId = change.previousFormatting?.listAbstractNumId;
 			if (typeof abstractId === "number") existingAbstractNumIds.add(abstractId);
 		}
-		const numId = paragraphNumberingReferenceId(attrs.numPr);
-		if (numId !== void 0 && !storyBase.has(numId) && definedMap?.hasNumbering(numId)) {
-			const level = definedMap.getLevel(numId, paragraphNumberingLevel(attrs.numPr) ?? 0);
-			if (!(level !== null && isBulletLevel(level) === (attrs.listIsBullet === true) && (attrs.listAbstractNumId ?? void 0) === (definedMap.getAbstractNumId(numId) ?? void 0))) colliding.add(numId);
+		const statedNumbering = attrs.numPr;
+		if (statedNumbering?.kind === "reference" && !storyBase.has(statedNumbering.numId) && definedMap?.hasNumbering(statedNumbering.numId)) {
+			const level = definedMap.getLevel(statedNumbering.numId, statedNumbering.ilvl ?? 0);
+			if (!(level !== null && isBulletLevel(level) === (attrs.listIsBullet === true) && (attrs.listAbstractNumId ?? void 0) === (definedMap.getAbstractNumId(statedNumbering.numId) ?? void 0))) colliding.add(statedNumbering.numId);
 		}
 		return false;
 	});
@@ -69,11 +68,11 @@ const storyListNumbering = (state, numbering) => {
 	state.doc.descendants((node, pos) => {
 		if (node.type.name !== "paragraph") return true;
 		const attrs = expectParagraphAttrs(node);
-		const numId = paragraphNumberingReferenceId(attrs.numPr);
+		const numId = attrs.numPr?.kind === "reference" ? attrs.numPr.numId : void 0;
 		const moves = numId !== void 0 && remap.numIds.has(numId);
 		const changes = attrs._propertyChanges?.map((change) => {
 			const previous = change.previousFormatting;
-			const previousNumId = paragraphNumberingReferenceId(previous?.numPr ?? void 0);
+			const previousNumId = previous?.numPr?.kind === "reference" ? previous.numPr.numId : void 0;
 			if (!previous || previousNumId === void 0 || !remap.numIds.has(previousNumId)) return change;
 			return {
 				...change,

package/dist/prosemirror/styles/paragraphStyleCascade.js

@@ -1,4 +1,4 @@
-import { mergeParagraphNumbering, paragraphNumberingReferenceId } from "../../docx/numberingReference.js";
+import { paragraphNumberingReferenceId } from "../../docx/numberingReference.js";
 import { mergeParagraphFormatting, mergeParagraphTabStops } from "../../utils/paragraphFormattingMerge.js";
 import { mergeTextFormatting } from "../../utils/textFormattingMerge.js";
 import { paragraphNumberingAttr } from "../numberingAttr.js";
@@ -103,11 +103,7 @@ function paragraphStyleCascadeAttrs({ styleId, formatting, styleResolver, tableP
 	set("direction", directionFromBidi(formatting?.bidi ?? stylePpr?.bidi));
 	set("defaultTextFormatting", resolveParagraphDefaultTextFormatting(styleId, formatting, styleResolver, { includeParagraphMarkRunProperties }));
 	const styleNumbering = stylePpr?.numPr;
-	if (styleNumbering?.kind === "reference" && (formatting?.numPr === void 0 || formatting.numPr.kind === "levelOnly")) {
-		const merged = mergeParagraphNumbering(styleNumbering, formatting?.numPr);
-		if (merged !== void 0) attrs.numPr = paragraphNumberingAttr(merged);
-		attrs.numPrFromStyle = paragraphNumberingAttr(styleNumbering);
-	}
+	if (styleNumbering?.kind === "reference" && (formatting?.numPr === void 0 || formatting.numPr.kind === "levelOnly")) attrs.numPrFromStyle = paragraphNumberingAttr(styleNumbering);
 	return {
 		attrs,
 		stylePpr

package/dist/prosemirror/styles/resolvedStyleAttrs.d.ts

@@ -4,6 +4,16 @@ import { ResolvedParagraphStyle } from "./styleResolver.js";
 import { NumberingMap } from "../../docx/numberingParser.js";
 import { DirectParagraphIndentation } from "../paragraphIndentation.js";
 //#region src/prosemirror/styles/resolvedStyleAttrs.d.ts
+/**
+ * Shared helper for projecting a resolved paragraph style onto ProseMirror
+ * paragraph node attrs.
+ *
+ * Both `applyStyle` (toolbar style picker) and the Enter handler's
+ * next-style switch need to write the same set of style-controlled attrs.
+ * Keeping the projection in one place ensures the two paths stay in sync —
+ * a style applied via the picker and a style applied on Enter produce
+ * identical paragraph attrs.
+ */
 type ResolvedStyleIdentity = {
   styleId: string;
   styleName?: string;
@@ -59,9 +69,6 @@ declare function listIndentationProvenancePatch({ direct, styleFormatting, numbe
  */
 declare function listLevelIndentRemovalPatch(attrs: Readonly<ParagraphAttrs>, numbering: NumberingMap | null | undefined): ParagraphAttrsPatch;
 /** Recompute every level-dependent attr when a paragraph changes list level. */
-declare function listLevelAttrPatch(attrs: Pick<ParagraphAttrs, "listImplicitChildLevelAdvances" | "_originalFormatting" | "_resolvedFormatting" | "_styleResolvedFormatting" | "numPr" | "numPrFromStyle" | "indentLeft" | "indentRight" | "indentFirstLine" | "hangingIndent">, numPr: {
-  numId: number;
-  ilvl: number;
-}, numbering: NumberingMap | null | undefined): ParagraphAttrsPatch;
+declare function listLevelAttrPatch(attrs: Pick<ParagraphAttrs, "listImplicitChildLevelAdvances" | "_originalFormatting" | "_resolvedFormatting" | "_styleResolvedFormatting" | "numPr" | "numPrFromStyle" | "indentLeft" | "indentRight" | "indentFirstLine" | "hangingIndent">, ilvl: number, numbering: NumberingMap | null | undefined): ParagraphAttrsPatch;
 //#endregion
 export { listAttrsFromNumbering, listAttrsFromResolvedStyle, listIndentationProvenancePatch, listLevelAttrPatch, listLevelIndentRemovalPatch, paragraphAttrsFromResolvedStyle };

package/dist/prosemirror/styles/resolvedStyleAttrs.js

@@ -4,21 +4,12 @@ import { tableOfContentsStyleLevel } from "../../utils/tableOfContentsStyle.js";
 import { setAutospacingBaseValue } from "../autospacingBase.js";
 import { CLEARED_LIST_RENDERING_ATTRS } from "../listMarker.js";
 import { listRenderingAttrPatch } from "../listRenderingAttrs.js";
-import { paragraphNumberingAttr } from "../numberingAttr.js";
+import { effectiveParagraphNumbering, effectiveParagraphNumberingReference, paragraphNumberingAttr, paragraphNumberingSourcesFromBoundary } from "../numberingAttr.js";
 import { styleResolvedParagraphFormatting } from "../paragraphFormattingProvenance.js";
 import { directParagraphIndentation, paragraphIndentationAttrPatch, paragraphIndentationFromFormatting, withDirectParagraphIndentation } from "../paragraphIndentation.js";
+import { panic } from "better-result";
 //#region src/prosemirror/styles/resolvedStyleAttrs.ts
 /**
-* Shared helper for projecting a resolved paragraph style onto ProseMirror
-* paragraph node attrs.
-*
-* Both `applyStyle` (toolbar style picker) and the Enter handler's
-* next-style switch need to write the same set of style-controlled attrs.
-* Keeping the projection in one place ensures the two paths stay in sync —
-* a style applied via the picker and a style applied on Enter produce
-* identical paragraph attrs.
-*/
-/**
 * The paragraph attrs a style definition controls. Applying a style resets
 * every one of these to the style's value (or `null` to clear), so a prior
 * style's properties (e.g. a heading's spacing) never leak through. Returns
@@ -82,10 +73,13 @@ function listAttrsFromResolvedStyle(resolved, numbering) {
 	const numPr = resolved.paragraphFormatting?.numPr;
 	if (numPr?.kind !== "reference") return null;
 	const { numId, ilvl = 0 } = numPr;
-	const attrs = listAttrsFromNumbering({
-		numId,
-		ilvl
-	}, numbering);
+	const attrs = {
+		...listAttrsFromNumbering({
+			numId,
+			ilvl
+		}, numbering),
+		numPr: null
+	};
 	attrs.numPrFromStyle = paragraphNumberingAttr(paragraphNumberingReference({
 		numId,
 		ilvl
@@ -173,7 +167,10 @@ function listIndentationProvenancePatch({ direct, styleFormatting, numberingSour
 * {@link listLevelIndentAttrPatch}.
 */
 function listLevelIndentRemovalPatch(attrs, numbering) {
-	if (attrs.numPr?.kind !== "reference") return {};
+	if (effectiveParagraphNumbering(paragraphNumberingSourcesFromBoundary({
+		numPr: attrs.numPr,
+		numPrFromStyle: attrs.numPrFromStyle
+	}))?.kind !== "reference") return {};
 	const direct = directParagraphIndentation(attrs);
 	return {
 		...listIndentationProvenancePatch({
@@ -187,15 +184,28 @@ function listLevelIndentRemovalPatch(attrs, numbering) {
 	};
 }
 /** Recompute every level-dependent attr when a paragraph changes list level. */
-function listLevelAttrPatch(attrs, numPr, numbering) {
+function listLevelAttrPatch(attrs, ilvl, numbering) {
+	const reference = effectiveParagraphNumberingReference(paragraphNumberingSourcesFromBoundary({
+		numPr: attrs.numPr,
+		numPrFromStyle: attrs.numPrFromStyle
+	}));
+	if (reference === void 0) panic("Cannot change list level without an effective numbering reference");
+	const numPr = {
+		numId: reference.numId,
+		ilvl
+	};
 	const direct = directParagraphIndentation(attrs);
 	return {
 		...listAttrsFromNumbering(numPr, numbering),
+		...attrs.numPr?.kind !== "reference" && attrs.numPrFromStyle?.kind === "reference" ? { numPr: paragraphNumberingAttr({
+			kind: "levelOnly",
+			ilvl: numPr.ilvl
+		}) } : {},
 		listImplicitChildLevelAdvances: attrs.listImplicitChildLevelAdvances ?? null,
 		...listIndentationProvenancePatch({
 			direct,
 			styleFormatting: attrs._styleResolvedFormatting,
-			numberingSource: attrs.numPrFromStyle == null ? "paragraph" : "style",
+			numberingSource: attrs.numPr?.kind === "reference" || attrs.numPrFromStyle == null ? "paragraph" : "style",
 			numPr,
 			numbering
 		}),

package/dist/prosemirror/yjsDocumentMetadata.d.ts

@@ -8,20 +8,26 @@ import * as Y from "yjs";
  */
 type AttrSchemaMigrationStep = (fragment: Y.XmlFragment) => number;
 /** Every attr-schema version this build reads, oldest first, with no gaps. */
-declare const FOLIO_YJS_ATTR_SCHEMA_VERSIONS: readonly [0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12];
+declare const FOLIO_YJS_ATTR_SCHEMA_VERSIONS: readonly [0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13];
 /** An attr-schema version this build can read. */
 type FolioYjsAttrSchemaVersion = (typeof FOLIO_YJS_ATTR_SCHEMA_VERSIONS)[number];
 /**
  * The attr-schema version this build writes. Derived against the migration map
  * so the constant and the map cannot disagree.
  */
-declare const FOLIO_YJS_ATTR_SCHEMA_VERSION = 12;
+declare const FOLIO_YJS_ATTR_SCHEMA_VERSION = 13;
 declare const FolioYjsNoteReferenceSchemaError_base: import("better-result").TaggedErrorClass<"FolioYjsNoteReferenceSchemaError">;
 declare class FolioYjsNoteReferenceSchemaError extends FolioYjsNoteReferenceSchemaError_base<{
   message: string;
   schemaVersion: FolioYjsAttrSchemaVersion;
   requiredSchemaVersion: FolioYjsAttrSchemaVersion;
 }> {}
+declare const FolioYjsNumberingSourceSchemaError_base: import("better-result").TaggedErrorClass<"FolioYjsNumberingSourceSchemaError">;
+declare class FolioYjsNumberingSourceSchemaError extends FolioYjsNumberingSourceSchemaError_base<{
+  message: string;
+  schemaVersion: FolioYjsAttrSchemaVersion;
+  requiredSchemaVersion: FolioYjsAttrSchemaVersion;
+}> {}
 /**
  * The steps that carry a snapshot written under `fromVersion` up to
  * {@link FOLIO_YJS_ATTR_SCHEMA_VERSION}, in order. Empty when the snapshot is
@@ -76,4 +82,4 @@ declare const writeYjsDocumentMetadata: (ydoc: Y.Doc, document: Node) => void;
 declare const readYjsParagraphSourceContract: (ydoc: Y.Doc) => string | null;
 declare const withParagraphSourceContract: (document: Node, contract: string) => Node;
 //#endregion
-export { FOLIO_YJS_ATTR_SCHEMA_VERSION, FolioYjsAttrSchemaVersion, FolioYjsAttrSchemaVersionError, FolioYjsNoteReferenceSchemaError, applyAttrSchemaMigrations, attrSchemaMigrationSteps, proseDocumentParagraphSourceContract, readYjsAttrSchemaVersion, readYjsParagraphSourceContract, withParagraphSourceContract, writeYjsAttrSchemaVersion, writeYjsDocumentMetadata };
+export { FOLIO_YJS_ATTR_SCHEMA_VERSION, FolioYjsAttrSchemaVersion, FolioYjsAttrSchemaVersionError, FolioYjsNoteReferenceSchemaError, FolioYjsNumberingSourceSchemaError, applyAttrSchemaMigrations, attrSchemaMigrationSteps, proseDocumentParagraphSourceContract, readYjsAttrSchemaVersion, readYjsParagraphSourceContract, withParagraphSourceContract, writeYjsAttrSchemaVersion, writeYjsDocumentMetadata };

package/dist/prosemirror/yjsDocumentMetadata.js

@@ -475,7 +475,8 @@ const FOLIO_YJS_ATTR_SCHEMA_VERSIONS = [
 	9,
 	10,
 	11,
-	12
+	12,
+	13
 ];
 /**
 * The one place a persisted attr-shape change is decided.
@@ -500,14 +501,44 @@ const ATTR_SCHEMA_MIGRATIONS = {
 	9: dropUnstatedPlaceholderFlags,
 	10: renamePageBreakRunOwnerMarkAttr,
 	11: stampMarkerOnly,
-	12: "current"
+	12: stampMarkerOnly,
+	13: "current"
 };
 /**
 * The attr-schema version this build writes. Derived against the migration map
 * so the constant and the map cannot disagree.
 */
-const FOLIO_YJS_ATTR_SCHEMA_VERSION = 12;
+const FOLIO_YJS_ATTR_SCHEMA_VERSION = 13;
 var FolioYjsNoteReferenceSchemaError = class extends TaggedError("FolioYjsNoteReferenceSchemaError") {};
+var FolioYjsNumberingSourceSchemaError = class extends TaggedError("FolioYjsNumberingSourceSchemaError") {};
+/** Older snapshots can hold a resolved style reference where a stated override belongs. */
+const requireStatedNumberingSources = (fragment, schemaVersion) => {
+	if (schemaVersion === 13) return;
+	const pending = [];
+	const visit = (node) => {
+		if ("getAttributes" in node) pending.push(node.getAttributes());
+		for (const child of node.toArray()) if (typeof child !== "string" && !isXmlText(child) && "toArray" in child) visit(child);
+	};
+	visit(fragment);
+	const seen = /* @__PURE__ */ new WeakSet();
+	while (pending.length > 0) {
+		const value = pending.pop();
+		if (typeof value !== "object" || value === null || seen.has(value)) continue;
+		seen.add(value);
+		if (Array.isArray(value)) {
+			for (const entry of value) pending.push(entry);
+			continue;
+		}
+		if (!isRecord(value)) continue;
+		const numbering = value["numPr"];
+		if (isRecord(value["numPrFromStyle"]) && isRecord(numbering) && (numbering["kind"] === "reference" || "numId" in numbering)) throw new FolioYjsNumberingSourceSchemaError({
+			schemaVersion,
+			requiredSchemaVersion: 13,
+			message: `Yjs schema ${schemaVersion} has ambiguous numbering ownership; schema 13 requires stated numbering overrides. Rebuild the collaboration state from the saved DOCX.`
+		});
+		for (const entry of Object.values(value)) pending.push(entry);
+	}
+};
 /** Check before any migration mutates the snapshot or any PM builder can drop text. */
 const requireNoteOccurrenceAttribution = (fragment, schemaVersion) => {
 	const visit = (node) => {
@@ -524,8 +555,8 @@ const requireNoteOccurrenceAttribution = (fragment, schemaVersion) => {
 				if (isRecord(reference) && isNoteReferenceOccurrenceId(reference["occurrenceId"])) continue;
 				throw new FolioYjsNoteReferenceSchemaError({
 					schemaVersion,
-					requiredSchemaVersion: 12,
-					message: `Yjs schema ${schemaVersion} has unattributed note references; schema 12 requires occurrence identities. Rebuild the collaboration state from the saved DOCX.`
+					requiredSchemaVersion: 13,
+					message: `Yjs schema ${schemaVersion} has unattributed note references; schema 13 requires occurrence identities. Rebuild the collaboration state from the saved DOCX.`
 				});
 			}
 		}
@@ -557,7 +588,8 @@ const attrSchemaMigrationSteps = (fromVersion) => FOLIO_YJS_ATTR_SCHEMA_VERSIONS
 */
 const applyAttrSchemaMigrations = (ydoc, fragment, fromVersion) => {
 	requireNoteOccurrenceAttribution(fragment, fromVersion);
-	if (fromVersion === 12) return 0;
+	requireStatedNumberingSources(fragment, fromVersion);
+	if (fromVersion === 13) return 0;
 	let rewritten = 0;
 	ydoc.transact(() => {
 		for (const step of attrSchemaMigrationSteps(fromVersion)) rewritten += step(fragment);
@@ -567,7 +599,7 @@ const applyAttrSchemaMigrations = (ydoc, fragment, fromVersion) => {
 };
 /** Raised when a snapshot's attr-schema marker is ahead of the running code. */
 var FolioYjsAttrSchemaVersionError = class extends TaggedError("FolioYjsAttrSchemaVersionError") {};
-const isReadableVersion = (marker) => typeof marker === "number" && Number.isInteger(marker) && marker >= 0 && marker <= 12;
+const isReadableVersion = (marker) => typeof marker === "number" && Number.isInteger(marker) && marker >= 0 && marker <= 13;
 /**
 * The attr-schema version a collaboration document was written under.
 *
@@ -585,7 +617,7 @@ const readYjsAttrSchemaVersion = (ydoc) => {
 	return Result.err(new FolioYjsAttrSchemaVersionError({
 		marker,
 		message: "The collaboration snapshot was written by a newer Folio attr schema than this build reads.",
-		supportedVersion: 12
+		supportedVersion: 13
 	}));
 };
 const proseDocumentParagraphSourceContract = (document) => {
@@ -593,7 +625,7 @@ const proseDocumentParagraphSourceContract = (document) => {
 };
 /** Stamp the attr-schema version of the build that wrote the current fragment. */
 const writeYjsAttrSchemaVersion = (ydoc) => {
-	ydoc.getMap(FOLIO_YJS_METADATA_MAP_NAME).set(ATTR_SCHEMA_VERSION_KEY, 12);
+	ydoc.getMap(FOLIO_YJS_METADATA_MAP_NAME).set(ATTR_SCHEMA_VERSION_KEY, 13);
 };
 /**
 * Write both metadata bindings for a freshly seeded collaboration document.
@@ -618,4 +650,4 @@ const withParagraphSourceContract = (document, contract) => {
 	}, document.content, document.marks);
 };
 //#endregion
-export { FOLIO_YJS_ATTR_SCHEMA_VERSION, FolioYjsAttrSchemaVersionError, FolioYjsNoteReferenceSchemaError, applyAttrSchemaMigrations, attrSchemaMigrationSteps, proseDocumentParagraphSourceContract, readYjsAttrSchemaVersion, readYjsParagraphSourceContract, withParagraphSourceContract, writeYjsAttrSchemaVersion, writeYjsDocumentMetadata };
+export { FOLIO_YJS_ATTR_SCHEMA_VERSION, FolioYjsAttrSchemaVersionError, FolioYjsNoteReferenceSchemaError, FolioYjsNumberingSourceSchemaError, applyAttrSchemaMigrations, attrSchemaMigrationSteps, proseDocumentParagraphSourceContract, readYjsAttrSchemaVersion, readYjsParagraphSourceContract, withParagraphSourceContract, writeYjsAttrSchemaVersion, writeYjsDocumentMetadata };

package/dist/redline.d.ts

@@ -20,6 +20,12 @@ declare class InvalidGenerateRedlineDocxOptionsError extends InvalidGenerateRedl
   option: "baseView" | "revisedView";
   receivedValue: unknown;
 }> {}
+declare const GenerateRedlineDocxResourceImportError_base: import("better-result").TaggedErrorClass<"GenerateRedlineDocxResourceImportError">;
+/** Raised before body operations when revised resources cannot be imported atomically. */
+declare class GenerateRedlineDocxResourceImportError extends GenerateRedlineDocxResourceImportError_base<{
+  message: string;
+  detail: string;
+}> {}
 /** A document story that could not be paired across the two input packages. */
 type GenerateRedlineUnprocessedStory = {
   /** Story in the base package, or `null` when it exists only in the revision. */
@@ -29,6 +35,14 @@ type GenerateRedlineUnprocessedStory = {
   /** Why the story could not be represented in the generated redline. */
   reason: "missing-base-story" | "missing-revised-story";
 };
+/** A source-undefined style cleared so it cannot acquire unrelated base meaning. */
+type GenerateRedlineReferenceWarning = {
+  /** Position in the revised story's ProseMirror projection. */
+  paragraphPosition: number;
+  story: FolioDocumentStoryHandle;
+  kind: "style";
+  id: string;
+};
 /** Result of {@link generateRedlineDocx}. */
 type GenerateRedlineDocxResult = {
   /** The base package with generated tracked changes. */
@@ -37,6 +51,8 @@ type GenerateRedlineDocxResult = {
   applied: FolioAIEditAppliedOperation[];
   /** Block operations that could not be applied. */
   skipped: FolioAIEditSkippedOperation[];
+  /** Undefined source references cleared to avoid binding to a base definition. */
+  referenceWarnings: GenerateRedlineReferenceWarning[];
   /** Package parts that could not be represented as story-scoped text edits. */
   unprocessedStories: GenerateRedlineUnprocessedStory[];
   /** Privacy transforms applied to the generated package. */
@@ -45,4 +61,4 @@ type GenerateRedlineDocxResult = {
 /** Compare two buffers and return tracked changes for every matched editable story. */
 declare const generateRedlineDocx: (base: ArrayBuffer, revised: ArrayBuffer, options?: GenerateRedlineDocxOptions) => Promise<GenerateRedlineDocxResult>;
 //#endregion
-export { GenerateRedlineDocxOptions, GenerateRedlineDocxResult, GenerateRedlineUnprocessedStory, InvalidGenerateRedlineDocxOptionsError, generateRedlineDocx };
+export { GenerateRedlineDocxOptions, GenerateRedlineDocxResourceImportError, GenerateRedlineDocxResult, GenerateRedlineReferenceWarning, GenerateRedlineUnprocessedStory, InvalidGenerateRedlineDocxOptionsError, generateRedlineDocx };