@stll/folio-core 0.54.2 → 0.56.0

package/dist/prosemirror/runFormattingFromMarks.js

@@ -203,6 +203,20 @@ const changedVisualFormattingGroups = (observedFormatting, expectedFormatting) =
 	}
 	return changed;
 };
+/** Overlay only changed visual marks; private authored properties stay with the run. */
+const runFormattingPatchFromMarks = (beforeMarks, afterMarks) => {
+	const observedMarks = (marks) => marks.filter(({ type }) => type.name !== "runFormattingOverride");
+	const before = marksToTextFormatting(observedMarks(beforeMarks));
+	const after = marksToTextFormatting(observedMarks(afterMarks));
+	const changed = changedVisualFormattingGroups(after, before);
+	const patch = before.styleId === after.styleId ? {} : { styleId: after.styleId ?? null };
+	const isFormattingKey = (key) => Object.hasOwn(RUN_FORMATTING_VISUAL_GROUPS, key);
+	for (const [key, group] of Object.entries(RUN_FORMATTING_VISUAL_GROUPS)) {
+		if (!isFormattingKey(key) || group === null || !changed.has(group)) continue;
+		Reflect.set(patch, key, after[key] ?? null);
+	}
+	return patch;
+};
 const VISUAL_BOOLEAN_FORMATTING_PROPERTIES = /* @__PURE__ */ new Set([
 	"allCaps",
 	"bold",
@@ -564,4 +578,4 @@ function marksToTextFormatting(marks, options) {
 	};
 }
 //#endregion
-export { marksToTextFormatting, sameFormattingValue };
+export { marksToTextFormatting, runFormattingPatchFromMarks, sameFormattingValue };

package/dist/prosemirror/runFormattingInlineCarriers.d.ts

@@ -1,7 +1,7 @@
 import { Mark, Node } from "prosemirror-model";
 import { Transaction } from "prosemirror-state";
 //#region src/prosemirror/runFormattingInlineCarriers.d.ts
-type RunFormattingInlineAtomDisposition = "break-run" | "field-run" | "not-a-run" | "page-break-carrier" | "preserved-xml-run" | "structured-field" | "symbol-run" | "tab-run" | "text-run";
+type RunFormattingInlineAtomDisposition = "break-run" | "field-run" | "not-a-run" | "note-marker-run" | "page-break-carrier" | "preserved-xml-run" | "structured-field" | "symbol-run" | "tab-run" | "text-run";
 /**
  * How every inline atom maps to a serialized run-formatting carrier.
  *
@@ -18,6 +18,7 @@ declare const RUN_FORMATTING_INLINE_ATOM_DISPOSITIONS: Readonly<{
   readonly image: "not-a-run";
   readonly math: "not-a-run";
   readonly moveRangeBoundary: "not-a-run";
+  readonly noteMarker: "note-marker-run";
   readonly pageBreakRun: "page-break-carrier";
   readonly preservedXml: "preserved-xml-run";
   readonly rangeAnchor: "not-a-run";

package/dist/prosemirror/runFormattingInlineCarriers.js

@@ -20,6 +20,7 @@ const RUN_FORMATTING_INLINE_ATOM_DISPOSITIONS = Object.freeze({
 	image: "not-a-run",
 	math: "not-a-run",
 	moveRangeBoundary: "not-a-run",
+	noteMarker: "note-marker-run",
 	pageBreakRun: "page-break-carrier",
 	preservedXml: "preserved-xml-run",
 	rangeAnchor: "not-a-run",
@@ -52,6 +53,7 @@ const CONTROL_CHARACTER_BY_DISPOSITION = Object.freeze({
 	"break-run": "\n",
 	"field-run": null,
 	"not-a-run": null,
+	"note-marker-run": null,
 	"page-break-carrier": null,
 	"preserved-xml-run": null,
 	"structured-field": null,
@@ -179,7 +181,8 @@ const runFormattingCarrierReviewText = (carrier) => {
 		case "tab-run":
 		case "break-run": return CONTROL_CHARACTER_BY_DISPOSITION[carrier.disposition];
 		case "text-run": return carrier.node.text ?? "";
-		case "page-break-carrier": return "";
+		case "page-break-carrier":
+		case "note-marker-run": return "";
 		case "symbol-run": {
 			const { char } = expectSymbolAttrs(carrier.node);
 			return decodeOoxmlSymbolCharacter(char) ?? "�";

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

@@ -107,6 +107,7 @@ type TrackedRevisionAncestor = {
   utcDate?: string;
   initials?: string;
   outerWrapperCount: number;
+  resolutionJoins?: document_d_exports.Insertion["resolutionJoins"];
 };
 type TrackedChangeMarkAttrs = {
   revisionId: number;
@@ -119,6 +120,7 @@ type TrackedChangeMarkAttrs = {
   moveKind?: "moveTo" | "moveFrom";
   /** Number of inline-wrapper layers authored outside this revision. */
   _docxOuterWrapperCount?: number;
+  _docxResolutionJoins?: document_d_exports.Insertion["resolutionJoins"];
   /** Outer revisions, in authored order, that ProseMirror cannot hold as nested marks. */
   _docxRevisionAncestors?: readonly TrackedRevisionAncestor[];
   /** Defaults to `"user"`; `"suggested"` for AI-proposed, non-serialized edits. */

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

@@ -44,6 +44,10 @@ declare const PRESERVED_XML_LEVELS: {
   readonly inline: "inline";
 };
 type PreservedXmlLevel = (typeof PRESERVED_XML_LEVELS)[keyof typeof PRESERVED_XML_LEVELS];
+/** The automatic number mark authored inside a note story, with no reader text. */
+type NoteMarkerAttrs = {
+  kind: "footnote" | "endnote";
+};
 /** A run or inline child folio does not model, carried through the editor untouched. */
 type PreservedXmlAttrs = {
   /** Replayable markup, as `captureVerbatimXml` wrote it. */
@@ -51,6 +55,8 @@ type PreservedXmlAttrs = {
   /** The visible text the markup puts on the line, empty when it shows none. */
   text: string;
   level: PreservedXmlLevel;
+  /** `PreservedInline.foldedListNumber`, for a capture the list marker stands in for. */
+  foldedListNumber?: document_d_exports.FoldedListNumber;
 };
 /** A block child folio does not model, carried through the editor untouched. */
 type PreservedBlockAttrs = {
@@ -166,6 +172,8 @@ type ParagraphAttrs = {
    * next marker letter.
    */
   listImplicitChildLevelAdvances?: number;
+  /** Cached inline LISTNUM display text appended after the resolved list template. */
+  listFoldedMarkerSuffix?: string;
   /**
    * When the marker text contains a TAB separator, this column offset (in
    * twips) is where the slot after the tab should land — used to align an
@@ -338,7 +346,7 @@ type ParagraphPropertyChangeAttrs = Omit<document_d_exports.ParagraphPropertyCha
   };
   previousFormatting?: Omit<document_d_exports.ParagraphFormatting, "numPr"> & {
     numPr?: ParagraphAttrs["numPr"] | null;
-  } & Partial<Pick<ParagraphAttrs, "listIsBullet" | "listIsLegal" | "listNumFmt" | "listMarker" | "listMarkerTemplate" | "listMarkerHidden" | "listMarkerFormatting" | "listMarkerAlignment" | "listMarkerSuffix" | "listMarkerAllCaps" | "listImplicitChildLevelAdvances" | "listMarkerSecondSlotOffsetTwips" | "listLevelNumFmts" | "listLevelStarts" | "listLevelTabs" | "listAbstractNumId" | "listStartOverride" | "lineSpacingExplicit" | "direction" | "_autospacingBase">>;
+  } & 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;
 };
 /**
@@ -1258,4 +1266,4 @@ type TableCellAttrs = {
   _docxVMergeContinuationCells?: unknown;
 };
 //#endregion
-export { AlternateContentAttrs, AuthoredEmuAttrs, BlockCustomXmlAttrs, BlockSdtAttrs, BookmarkBoundaryAttrs, CommentReferenceAttrs, FieldAttrs, HardBreakAttrs, ImageAttrs, ImagePositionAttrs, MathAttrs, PRESERVED_XML_LEVELS, PageBreakRunAttrs, ParagraphAttrs, ParagraphAttrsPatch, ParagraphPropertyChangeAttrs, PreservedBlockAttrs, PreservedXmlAttrs, PreservedXmlLevel, SdtAttrs, ShapeAttrs, SuggestedStructuralMarker, SymbolAttrs, TEXT_BOX_TEXT_BODY_CONTENT_STATE_TYPES, TabAttrs, TableAttrs, TableCellAttrs, TableRowAttrs, TextBoxAnchorAttrs, TextBoxAttrs, TextBoxTextBodyContentState };
+export { AlternateContentAttrs, AuthoredEmuAttrs, BlockCustomXmlAttrs, BlockSdtAttrs, BookmarkBoundaryAttrs, CommentReferenceAttrs, FieldAttrs, HardBreakAttrs, ImageAttrs, ImagePositionAttrs, MathAttrs, NoteMarkerAttrs, PRESERVED_XML_LEVELS, PageBreakRunAttrs, ParagraphAttrs, ParagraphAttrsPatch, ParagraphPropertyChangeAttrs, PreservedBlockAttrs, PreservedXmlAttrs, PreservedXmlLevel, SdtAttrs, ShapeAttrs, SuggestedStructuralMarker, SymbolAttrs, TEXT_BOX_TEXT_BODY_CONTENT_STATE_TYPES, TabAttrs, TableAttrs, TableCellAttrs, TableRowAttrs, TextBoxAnchorAttrs, TextBoxAttrs, TextBoxTextBodyContentState };

package/dist/prosemirror/textBoxAnchorAttrs.d.ts

@@ -1,5 +1,6 @@
 import { TextBoxAnchorAttrs } from "./schema/nodes.js";
-import { ReadProseMirrorAttrsResult } from "./attrs/index.js";
+import { ReadProseMirrorAttrsResult } from "../internal/prosemirrorAttrBoundary.js";
+import "./attrs/index.js";
 import { Node } from "prosemirror-model";
 //#region src/prosemirror/textBoxAnchorAttrs.d.ts
 declare const readTextBoxAnchorAttrs: (node: Node) => ReadProseMirrorAttrsResult<TextBoxAnchorAttrs>;

package/dist/prosemirror/textInput.js

@@ -4,7 +4,11 @@ const dispatchEditorTextInput = (view, input) => {
 	const { from, to } = typeof input === "string" ? view.state.selection : input;
 	const text = typeof input === "string" ? input : input.text;
 	const defaultTransaction = () => {
-		if (!(view.state.selection instanceof AllSelection)) return view.state.tr.insertText(text, from, to);
+		const { selection } = view.state;
+		if (!(selection instanceof AllSelection)) {
+			const tr = view.state.tr.insertText(text, from, to);
+			return !selection.empty && selection.from === from && selection.to === to ? tr.setSelection(TextSelection.create(tr.doc, from + text.length)) : tr;
+		}
 		const start = Selection.atStart(view.state.doc);
 		const end = Selection.atEnd(view.state.doc);
 		const last = end.$to.parent;

package/dist/prosemirror/trackedRevisionPath.js

@@ -18,7 +18,8 @@ const trackedRevisionLayerOf = (mark, node) => {
 		...attrs.date ? { date: attrs.date } : {},
 		...attrs.utcDate ? { utcDate: attrs.utcDate } : {},
 		...attrs.initials ? { initials: attrs.initials } : {},
-		outerWrapperCount: attrs._docxOuterWrapperCount ?? inlineWrapperStackOf(node).length
+		outerWrapperCount: attrs._docxOuterWrapperCount ?? inlineWrapperStackOf(node).length,
+		...attrs._docxResolutionJoins == null ? {} : { resolutionJoins: attrs._docxResolutionJoins }
 	};
 };
 /** The deletion's ancestor path, with the insertion it sits in as the outermost layer. */

package/dist/prosemirror/trackedRunInlineAtoms.d.ts

@@ -17,6 +17,7 @@ declare const TRACKED_RUN_INLINE_ATOM_DISPOSITIONS: Readonly<{
   readonly image: "carry";
   readonly math: "carry";
   readonly moveRangeBoundary: "carry";
+  readonly noteMarker: "carry";
   readonly pageBreakRun: "page-break-carrier";
   readonly preservedXml: "carry";
   readonly rangeAnchor: "transparent";

package/dist/prosemirror/trackedRunInlineAtoms.js

@@ -16,6 +16,7 @@ const TRACKED_RUN_INLINE_ATOM_DISPOSITIONS = Object.freeze({
 	image: "carry",
 	math: "carry",
 	moveRangeBoundary: "carry",
+	noteMarker: "carry",
 	pageBreakRun: "page-break-carrier",
 	preservedXml: "carry",
 	rangeAnchor: "transparent",

package/dist/prosemirror/validation.js

@@ -1,3 +1,4 @@
+import { readNoteMarkerAttrs } from "../internal/noteMarkerAttrs.js";
 import { readBlockCustomXmlAttrs, readBlockSdtAttrs, readCharacterSpacingMarkAttrs, readCharacterStyleMarkAttrs, readCommentMarkAttrs, readEmphasisMarkAttrs, readFieldAttrs, readFontFamilyMarkAttrs, readFontSizeMarkAttrs, readFootnoteRefMarkAttrs, readHardBreakAttrs, readHighlightMarkAttrs, readHyperlinkMarkAttrs, readImageAttrs, readInlineWrapperMarkAttrs, readLanguageMarkAttrs, readMathAttrs, readPageBreakRunAttrs, readParagraphAttrs, readPreservedBlockAttrs, readPreservedXmlAttrs, readRunFormattingOverrideMarkAttrs, readRunIdentityMarkAttrs, readRunPropertyChangeMarkAttrs, readRunShadingMarkAttrs, readSdtAttrs, readShapeAttrs, readStrikeMarkAttrs, readSymbolAttrs, readTabAttrs, readTableAttrs, readTableCellAttrs, readTableRowAttrs, readTextBoxAttrs, readTextColorMarkAttrs, readTextEffectMarkAttrs, readTrackedChangeMarkAttrs, readUnderlineMarkAttrs } from "./attrs/index.js";
 import { readBookmarkBoundaryAttrs } from "./bookmarkBoundaryAttrs.js";
 import { readCommentReferenceAttrs } from "./commentReferenceAttrs.js";
@@ -203,6 +204,9 @@ const validateNodeAttrs = (node, path, issues) => {
 		case "symbol":
 			appendAttrIssues(path, readSymbolAttrs(node), issues);
 			return;
+		case "noteMarker":
+			appendAttrIssues(path, readNoteMarkerAttrs(node), issues);
+			return;
 		case "preservedXml":
 			appendAttrIssues(path, readPreservedXmlAttrs(node), issues);
 			return;

package/dist/types/canonicalCapabilities.d.ts

@@ -0,0 +1,215 @@
+//#region src/types/canonicalCapabilities.d.ts
+/** Remaining seams to retire before the canonical session becomes the only authority. */
+declare const CANONICAL_GAP: {
+  readonly authorityRouting: "authority-routing";
+  readonly commands: "command-descriptors";
+  readonly suggesting: "adapter-suggesting";
+  readonly trackedHyperlinkResolution: "tracked-hyperlink-resolution";
+  readonly comments: "comment-model-edits";
+  readonly modelEdits: "direct-model-edits";
+  readonly sectionProperties: "section-properties";
+  readonly watermark: "watermark-model-edits";
+  readonly secondaryStories: "secondary-story-routing";
+  readonly collaboration: "collaboration-session";
+  readonly dispatch: "unclassified-transactions";
+  readonly save: "pm-save-projection";
+  readonly resourceReplacement: "canonical-resource-replacement";
+  readonly history: "pm-history";
+  readonly suggestionPlugin: "pm-suggestion-plugin";
+  readonly paragraphTracker: "pm-paragraph-tracker";
+  readonly tableGeometry: "pm-table-geometry";
+  readonly paragraphIdentity: "pm-paragraph-identity";
+  readonly documentOperations: "pm-document-operations";
+  readonly aiSnapshots: "pm-ai-snapshots";
+  readonly publicComments: "publicOps.comments";
+  readonly publicSuggestedMode: "publicOps.suggestedMode";
+  readonly publicTableProjection: "publicOps.tableProjection";
+  readonly publicUnsupportedInline: "publicOps.unsupportedInline";
+  readonly publicPendingParagraphMarkProperties: "publicOps.pendingParagraphMarkProperties";
+  readonly publicHeadlessSession: "publicOps.headlessSession";
+  readonly publicSecondaryStories: "publicOps.secondaryStories";
+};
+type CanonicalGap = (typeof CANONICAL_GAP)[keyof typeof CANONICAL_GAP];
+declare const CANONICAL_CAPABILITIES: {
+  readonly "authority-routing": {
+    readonly owner: "controller";
+    readonly kind: "routing";
+    readonly adapters: readonly ["react", "vue"];
+    readonly summary: "Explicit session selection and legacy authority routing.";
+  };
+  readonly "command-descriptors": {
+    readonly remainingCommands: {
+      readonly registry: "extension-commands";
+    };
+    readonly owner: "controller";
+    readonly kind: "refusal";
+    readonly adapters: readonly ["react", "vue"];
+    readonly summary: "Commands without canonical descriptors retain PM probing and hit the dispatch boundary.";
+  };
+  readonly "tracked-hyperlink-resolution": {
+    readonly owner: "controller";
+    readonly kind: "refusal";
+    readonly adapters: readonly ["react", "vue"];
+    readonly summary: "Hyperlink and TOC suggestions require serializable wrapper review provenance.";
+  };
+  readonly "adapter-suggesting": {
+    readonly owner: "adapters";
+    readonly kind: "refusal";
+    readonly adapters: readonly ["react", "vue"];
+    readonly summary: "Adapter suggesting controls and tracked secondary-story edits remain gated.";
+  };
+  readonly "comment-model-edits": {
+    readonly owner: "adapters";
+    readonly kind: "refusal";
+    readonly adapters: readonly ["react", "vue"];
+    readonly summary: "Comment mutations still use direct model changes.";
+  };
+  readonly "direct-model-edits": {
+    readonly owner: "adapters";
+    readonly kind: "refusal";
+    readonly adapters: readonly ["react", "vue"];
+    readonly summary: "Direct model and pending-suggestion snapshots bypass the canonical journal.";
+  };
+  readonly "section-properties": {
+    readonly owner: "adapters";
+    readonly kind: "routing";
+    readonly adapters: readonly ["react", "vue"];
+    readonly summary: "Section properties select canonical operations or legacy model changes.";
+  };
+  readonly "watermark-model-edits": {
+    readonly owner: "adapters";
+    readonly kind: "refusal";
+    readonly adapters: readonly ["vue"];
+    readonly summary: "Vue watermark mutations still change the model directly.";
+  };
+  readonly "secondary-story-routing": {
+    readonly owner: "controller";
+    readonly kind: "routing";
+    readonly adapters: readonly ["react", "vue"];
+    readonly summary: "Secondary-story creation, views and history still select their session authority.";
+  };
+  readonly "collaboration-session": {
+    readonly owner: "controller";
+    readonly kind: "refusal";
+    readonly adapters: readonly ["react", "vue"];
+    readonly summary: "Collaboration cannot activate a canonical session.";
+  };
+  readonly "unclassified-transactions": {
+    readonly owner: "controller";
+    readonly kind: "refusal";
+    readonly adapters: readonly ["react", "vue"];
+    readonly summary: "Unclassified native and plugin mutations are refused at the projection boundary.";
+  };
+  readonly "pm-save-projection": {
+    readonly owner: "controller";
+    readonly kind: "routing";
+    readonly adapters: readonly ["react", "vue"];
+    readonly summary: "Legacy save and read paths reconstruct documents from PM.";
+  };
+  readonly "canonical-resource-replacement": {
+    readonly owner: "controller";
+    readonly kind: "refusal";
+    readonly adapters: readonly ["react", "vue"];
+    readonly summary: "Canonical save refuses existing style, style-default, and media replacements the package writers cannot express.";
+  };
+  readonly "pm-history": {
+    readonly owner: "prosemirror";
+    readonly kind: "mutation-source";
+    readonly adapters: readonly ["react", "vue"];
+    readonly summary: "PM history remains installed for legacy sessions.";
+  };
+  readonly "pm-suggestion-plugin": {
+    readonly owner: "prosemirror";
+    readonly kind: "mutation-source";
+    readonly adapters: readonly ["react", "vue"];
+    readonly summary: "The legacy suggestion plugin produces PM transactions.";
+  };
+  readonly "pm-paragraph-tracker": {
+    readonly owner: "prosemirror";
+    readonly kind: "mutation-source";
+    readonly adapters: readonly ["react", "vue"];
+    readonly summary: "Dirty tracking and section bookkeeping still observe PM transactions.";
+  };
+  readonly "pm-table-geometry": {
+    readonly owner: "prosemirror";
+    readonly kind: "mutation-source";
+    readonly adapters: readonly ["react", "vue"];
+    readonly summary: "Table geometry, resize and repair still produce PM transactions.";
+  };
+  readonly "pm-paragraph-identity": {
+    readonly owner: "prosemirror";
+    readonly kind: "mutation-source";
+    readonly adapters: readonly ["react", "vue"];
+    readonly summary: "Legacy paragraph identity repair remains a PM append transaction.";
+  };
+  readonly "pm-document-operations": {
+    readonly owner: "document-operations";
+    readonly defaultSessionMutation: "pm-public-operations";
+    readonly kind: "mutation-source";
+    readonly adapters: readonly ["react", "vue"];
+    readonly summary: "Public document operations still execute against a held PM view.";
+  };
+  readonly "publicOps.comments": {
+    readonly owner: "document-operations";
+    readonly defaultSessionMutation: "pm-public-operations";
+    readonly kind: "refusal";
+    readonly adapters: readonly ["react", "vue"];
+    readonly summary: "Public comment operations refuse in canonical sessions; legacy sessions retain PM comments.";
+  };
+  readonly "publicOps.suggestedMode": {
+    readonly owner: "document-operations";
+    readonly defaultSessionMutation: "pm-public-operations";
+    readonly kind: "refusal";
+    readonly adapters: readonly ["react", "vue"];
+    readonly summary: "Public suggested mode refuses in canonical sessions until pending suggestions use the journal.";
+  };
+  readonly "publicOps.tableProjection": {
+    readonly owner: "document-operations";
+    readonly defaultSessionMutation: "pm-public-operations";
+    readonly kind: "refusal";
+    readonly adapters: readonly ["react", "vue"];
+    readonly summary: "Public table operations refuse while canonical projections require paragraph stories.";
+  };
+  readonly "publicOps.unsupportedInline": {
+    readonly owner: "document-operations";
+    readonly defaultSessionMutation: "pm-public-operations";
+    readonly kind: "refusal";
+    readonly adapters: readonly ["react", "vue"];
+    readonly summary: "Unsupported public payloads refuse with a typed compiler capability gap.";
+  };
+  readonly "publicOps.pendingParagraphMarkProperties": {
+    readonly owner: "document-operations";
+    readonly defaultSessionMutation: "pm-public-operations";
+    readonly kind: "refusal";
+    readonly adapters: readonly ["react", "vue"];
+    readonly summary: "Separate paragraph property edits refuse while the paragraph mark is pending deletion; atomic merge properties remain supported.";
+  };
+  readonly "publicOps.secondaryStories": {
+    readonly owner: "document-operations";
+    readonly defaultSessionMutation: "pm-public-operations";
+    readonly kind: "refusal";
+    readonly adapters: readonly ["react", "vue"];
+    readonly summary: "Public secondary-story batches refuse until canonical story routing is available.";
+  };
+  readonly "publicOps.headlessSession": {
+    readonly owner: "document-operations";
+    readonly defaultSessionMutation: "pm-headless-reviewer";
+    readonly kind: "mutation-source";
+    readonly adapters: readonly ["react", "vue"];
+    readonly summary: "The headless reviewer has no canonical session selector while its mutations remain PM-owned.";
+  };
+  readonly "pm-ai-snapshots": {
+    readonly owner: "ai-edits";
+    readonly kind: "mutation-source";
+    readonly adapters: readonly ["react", "vue"];
+    readonly summary: "Headless AI edits still use PM execution and snapshot undo.";
+  };
+};
+/**
+ * The gap argument is a typed tag counted by the source guard, not a runtime policy.
+ * Retire a gap by removing its sites and ledger entry.
+ */
+declare const usesCanonicalSession: (session: "canonical" | undefined, _gap: CanonicalGap) => boolean;
+declare const canonicalRefusalMessage: (gap: CanonicalGap, message: string) => string;
+//#endregion
+export { CANONICAL_CAPABILITIES, CANONICAL_GAP, CanonicalGap, canonicalRefusalMessage, usesCanonicalSession };

package/dist/types/canonicalCapabilities.js

@@ -0,0 +1,212 @@
+//#region src/types/canonicalCapabilities.ts
+/** Remaining seams to retire before the canonical session becomes the only authority. */
+const CANONICAL_GAP = {
+	authorityRouting: "authority-routing",
+	commands: "command-descriptors",
+	suggesting: "adapter-suggesting",
+	trackedHyperlinkResolution: "tracked-hyperlink-resolution",
+	comments: "comment-model-edits",
+	modelEdits: "direct-model-edits",
+	sectionProperties: "section-properties",
+	watermark: "watermark-model-edits",
+	secondaryStories: "secondary-story-routing",
+	collaboration: "collaboration-session",
+	dispatch: "unclassified-transactions",
+	save: "pm-save-projection",
+	resourceReplacement: "canonical-resource-replacement",
+	history: "pm-history",
+	suggestionPlugin: "pm-suggestion-plugin",
+	paragraphTracker: "pm-paragraph-tracker",
+	tableGeometry: "pm-table-geometry",
+	paragraphIdentity: "pm-paragraph-identity",
+	documentOperations: "pm-document-operations",
+	aiSnapshots: "pm-ai-snapshots",
+	publicComments: "publicOps.comments",
+	publicSuggestedMode: "publicOps.suggestedMode",
+	publicTableProjection: "publicOps.tableProjection",
+	publicUnsupportedInline: "publicOps.unsupportedInline",
+	publicPendingParagraphMarkProperties: "publicOps.pendingParagraphMarkProperties",
+	publicHeadlessSession: "publicOps.headlessSession",
+	publicSecondaryStories: "publicOps.secondaryStories"
+};
+const CANONICAL_CAPABILITIES = {
+	[CANONICAL_GAP.authorityRouting]: {
+		owner: "controller",
+		kind: "routing",
+		adapters: ["react", "vue"],
+		summary: "Explicit session selection and legacy authority routing."
+	},
+	[CANONICAL_GAP.commands]: {
+		remainingCommands: { registry: "extension-commands" },
+		owner: "controller",
+		kind: "refusal",
+		adapters: ["react", "vue"],
+		summary: "Commands without canonical descriptors retain PM probing and hit the dispatch boundary."
+	},
+	[CANONICAL_GAP.trackedHyperlinkResolution]: {
+		owner: "controller",
+		kind: "refusal",
+		adapters: ["react", "vue"],
+		summary: "Hyperlink and TOC suggestions require serializable wrapper review provenance."
+	},
+	[CANONICAL_GAP.suggesting]: {
+		owner: "adapters",
+		kind: "refusal",
+		adapters: ["react", "vue"],
+		summary: "Adapter suggesting controls and tracked secondary-story edits remain gated."
+	},
+	[CANONICAL_GAP.comments]: {
+		owner: "adapters",
+		kind: "refusal",
+		adapters: ["react", "vue"],
+		summary: "Comment mutations still use direct model changes."
+	},
+	[CANONICAL_GAP.modelEdits]: {
+		owner: "adapters",
+		kind: "refusal",
+		adapters: ["react", "vue"],
+		summary: "Direct model and pending-suggestion snapshots bypass the canonical journal."
+	},
+	[CANONICAL_GAP.sectionProperties]: {
+		owner: "adapters",
+		kind: "routing",
+		adapters: ["react", "vue"],
+		summary: "Section properties select canonical operations or legacy model changes."
+	},
+	[CANONICAL_GAP.watermark]: {
+		owner: "adapters",
+		kind: "refusal",
+		adapters: ["vue"],
+		summary: "Vue watermark mutations still change the model directly."
+	},
+	[CANONICAL_GAP.secondaryStories]: {
+		owner: "controller",
+		kind: "routing",
+		adapters: ["react", "vue"],
+		summary: "Secondary-story creation, views and history still select their session authority."
+	},
+	[CANONICAL_GAP.collaboration]: {
+		owner: "controller",
+		kind: "refusal",
+		adapters: ["react", "vue"],
+		summary: "Collaboration cannot activate a canonical session."
+	},
+	[CANONICAL_GAP.dispatch]: {
+		owner: "controller",
+		kind: "refusal",
+		adapters: ["react", "vue"],
+		summary: "Unclassified native and plugin mutations are refused at the projection boundary."
+	},
+	[CANONICAL_GAP.save]: {
+		owner: "controller",
+		kind: "routing",
+		adapters: ["react", "vue"],
+		summary: "Legacy save and read paths reconstruct documents from PM."
+	},
+	[CANONICAL_GAP.resourceReplacement]: {
+		owner: "controller",
+		kind: "refusal",
+		adapters: ["react", "vue"],
+		summary: "Canonical save refuses existing style, style-default, and media replacements the package writers cannot express."
+	},
+	[CANONICAL_GAP.history]: {
+		owner: "prosemirror",
+		kind: "mutation-source",
+		adapters: ["react", "vue"],
+		summary: "PM history remains installed for legacy sessions."
+	},
+	[CANONICAL_GAP.suggestionPlugin]: {
+		owner: "prosemirror",
+		kind: "mutation-source",
+		adapters: ["react", "vue"],
+		summary: "The legacy suggestion plugin produces PM transactions."
+	},
+	[CANONICAL_GAP.paragraphTracker]: {
+		owner: "prosemirror",
+		kind: "mutation-source",
+		adapters: ["react", "vue"],
+		summary: "Dirty tracking and section bookkeeping still observe PM transactions."
+	},
+	[CANONICAL_GAP.tableGeometry]: {
+		owner: "prosemirror",
+		kind: "mutation-source",
+		adapters: ["react", "vue"],
+		summary: "Table geometry, resize and repair still produce PM transactions."
+	},
+	[CANONICAL_GAP.paragraphIdentity]: {
+		owner: "prosemirror",
+		kind: "mutation-source",
+		adapters: ["react", "vue"],
+		summary: "Legacy paragraph identity repair remains a PM append transaction."
+	},
+	[CANONICAL_GAP.documentOperations]: {
+		owner: "document-operations",
+		defaultSessionMutation: "pm-public-operations",
+		kind: "mutation-source",
+		adapters: ["react", "vue"],
+		summary: "Public document operations still execute against a held PM view."
+	},
+	[CANONICAL_GAP.publicComments]: {
+		owner: "document-operations",
+		defaultSessionMutation: "pm-public-operations",
+		kind: "refusal",
+		adapters: ["react", "vue"],
+		summary: "Public comment operations refuse in canonical sessions; legacy sessions retain PM comments."
+	},
+	[CANONICAL_GAP.publicSuggestedMode]: {
+		owner: "document-operations",
+		defaultSessionMutation: "pm-public-operations",
+		kind: "refusal",
+		adapters: ["react", "vue"],
+		summary: "Public suggested mode refuses in canonical sessions until pending suggestions use the journal."
+	},
+	[CANONICAL_GAP.publicTableProjection]: {
+		owner: "document-operations",
+		defaultSessionMutation: "pm-public-operations",
+		kind: "refusal",
+		adapters: ["react", "vue"],
+		summary: "Public table operations refuse while canonical projections require paragraph stories."
+	},
+	[CANONICAL_GAP.publicUnsupportedInline]: {
+		owner: "document-operations",
+		defaultSessionMutation: "pm-public-operations",
+		kind: "refusal",
+		adapters: ["react", "vue"],
+		summary: "Unsupported public payloads refuse with a typed compiler capability gap."
+	},
+	[CANONICAL_GAP.publicPendingParagraphMarkProperties]: {
+		owner: "document-operations",
+		defaultSessionMutation: "pm-public-operations",
+		kind: "refusal",
+		adapters: ["react", "vue"],
+		summary: "Separate paragraph property edits refuse while the paragraph mark is pending deletion; atomic merge properties remain supported."
+	},
+	[CANONICAL_GAP.publicSecondaryStories]: {
+		owner: "document-operations",
+		defaultSessionMutation: "pm-public-operations",
+		kind: "refusal",
+		adapters: ["react", "vue"],
+		summary: "Public secondary-story batches refuse until canonical story routing is available."
+	},
+	[CANONICAL_GAP.publicHeadlessSession]: {
+		owner: "document-operations",
+		defaultSessionMutation: "pm-headless-reviewer",
+		kind: "mutation-source",
+		adapters: ["react", "vue"],
+		summary: "The headless reviewer has no canonical session selector while its mutations remain PM-owned."
+	},
+	[CANONICAL_GAP.aiSnapshots]: {
+		owner: "ai-edits",
+		kind: "mutation-source",
+		adapters: ["react", "vue"],
+		summary: "Headless AI edits still use PM execution and snapshot undo."
+	}
+};
+/**
+* The gap argument is a typed tag counted by the source guard, not a runtime policy.
+* Retire a gap by removing its sites and ledger entry.
+*/
+const usesCanonicalSession = (session, _gap) => session === "canonical";
+const canonicalRefusalMessage = (gap, message) => `[${gap}] ${message}`;
+//#endregion
+export { CANONICAL_CAPABILITIES, CANONICAL_GAP, canonicalRefusalMessage, usesCanonicalSession };

package/dist/types/canonicalSave.d.ts

@@ -0,0 +1,11 @@
+import { document_d_exports } from "./document.js";
+//#region src/types/canonicalSave.d.ts
+/** Committed model and conservative changes relative to its parsed source package. */
+type CanonicalSaveSnapshot = {
+  document: document_d_exports.Document;
+  version: number;
+  changedBlockIds: readonly string[];
+  structure: "stable" | "changed";
+};
+//#endregion
+export { CanonicalSaveSnapshot };