@stll/folio-core 0.63.0 → 0.64.0

package/dist/prosemirror/plugins/contentControlWidgets.d.ts

@@ -1,6 +1,6 @@
 import { ContentControlBoundError, ContentControlLockedError, ContentControlTypeError } from "../../content-controls/errors.js";
 import "../../content-controls/index.js";
-import { Plugin } from "prosemirror-state";
+import { EditorState, Plugin, PluginKey } from "prosemirror-state";
 import { EditorView } from "prosemirror-view";
 //#region src/prosemirror/plugins/contentControlWidgets.d.ts
 export type ContentControlWidgetAnchor = {
@@ -49,10 +49,10 @@ type HandleContentControlWidgetClickOptions = {
 };
 export declare const contentControlWidgetsPluginKey: Readonly<{
   key: string;
-  createKey: () => import("prosemirror-state").PluginKey<unknown>;
+  createKey: () => PluginKey<unknown>;
   owns: (plugin: Plugin<unknown>) => boolean;
-  get: (state: import("prosemirror-state").EditorState) => Plugin<unknown> | undefined;
-  getState: (state: import("prosemirror-state").EditorState) => unknown;
+  get: (state: EditorState) => Plugin<unknown> | undefined;
+  getState: (state: EditorState) => unknown;
 }>;
 /**
  * CustomEvent name dispatched on the editor view DOM whenever the plugin

package/dist/prosemirror/plugins/documentStyleState.d.ts

@@ -1,13 +1,13 @@
 import { document_d_exports } from "../../types/document.js";
 import { BuiltInStyleIndex } from "../../docx/builtInStyles.js";
 import { StyleResolver } from "../styles/styleResolver.js";
-import { EditorState } from "prosemirror-state";
+import { EditorState, Plugin, PluginKey } from "prosemirror-state";
 //#region src/prosemirror/plugins/documentStyleState.d.ts
 export declare const documentStylesKey: Readonly<{
   key: string;
-  createKey: () => import("prosemirror-state").PluginKey<StyleResolver | null>;
-  owns: (plugin: import("prosemirror-state").Plugin<StyleResolver | null>) => boolean;
-  get: (state: EditorState) => import("prosemirror-state").Plugin<StyleResolver | null> | undefined;
+  createKey: () => PluginKey<StyleResolver | null>;
+  owns: (plugin: Plugin<StyleResolver | null>) => boolean;
+  get: (state: EditorState) => Plugin<StyleResolver | null> | undefined;
   getState: (state: EditorState) => StyleResolver | null | undefined;
 }>;
 /** Read the document's StyleResolver, or null when the plugin isn't installed. */

package/dist/prosemirror/plugins/revisionIds.d.ts

@@ -1,7 +1,8 @@
 import { Node } from "prosemirror-model";
+import { TaggedErrorClass } from "better-result";
 //#region src/prosemirror/plugins/revisionIds.d.ts
-declare const RevisionIdAllocationError_base: import("better-result").TaggedErrorClass<"RevisionIdAllocationError">;
-export declare class RevisionIdAllocationError extends RevisionIdAllocationError_base<{
+declare const RevisionIdAllocationErrorBase: TaggedErrorClass<"RevisionIdAllocationError">;
+export declare class RevisionIdAllocationError extends RevisionIdAllocationErrorBase<{
   message: string;
   first: number;
   next: number;

package/dist/prosemirror/plugins/revisionIds.js

@@ -22,7 +22,8 @@ import { MAX_REVISION_ID } from "@stll/docx-core/model";
 */
 let counter = 1;
 const occupiedIds = /* @__PURE__ */ new Set();
-var RevisionIdAllocationError = class extends TaggedError("RevisionIdAllocationError") {};
+const RevisionIdAllocationErrorBase = TaggedError("RevisionIdAllocationError");
+var RevisionIdAllocationError = class extends RevisionIdAllocationErrorBase {};
 /** Batches use contiguous ids; on rollover prefer the largest unused interval. */
 const largestFreeIntervalStart = (reservedIds) => {
 	let first = 1;

package/dist/prosemirror/plugins/selectionTracker.d.ts

@@ -1,6 +1,6 @@
 import { document_d_exports } from "../../types/document.js";
 import { ListState } from "../listState.js";
-import { EditorState, Plugin } from "prosemirror-state";
+import { EditorState, Plugin, PluginKey } from "prosemirror-state";
 //#region src/prosemirror/plugins/selectionTracker.d.ts
 /**
  * Selection context for toolbar state
@@ -32,7 +32,7 @@ export type SelectionContext = {
  */
 export declare const selectionTrackerKey: Readonly<{
   key: string;
-  createKey: () => import("prosemirror-state").PluginKey<SelectionContext>;
+  createKey: () => PluginKey<SelectionContext>;
   owns: (plugin: Plugin<SelectionContext>) => boolean;
   get: (state: EditorState) => Plugin<SelectionContext> | undefined;
   getState: (state: EditorState) => SelectionContext | undefined;

package/dist/prosemirror/plugins/suggestionMode.d.ts

@@ -1,10 +1,10 @@
 import { Slice } from "prosemirror-model";
-import { EditorState, Plugin, Transaction } from "prosemirror-state";
+import { EditorState, Plugin, PluginKey, Transaction } from "prosemirror-state";
 import { EditorView } from "prosemirror-view";
 //#region src/prosemirror/plugins/suggestionMode.d.ts
 export declare const suggestionModeKey: Readonly<{
   key: string;
-  createKey: () => import("prosemirror-state").PluginKey<SuggestionModeState>;
+  createKey: () => PluginKey<SuggestionModeState>;
   owns: (plugin: Plugin<SuggestionModeState>) => boolean;
   get: (state: EditorState) => Plugin<SuggestionModeState> | undefined;
   getState: (state: EditorState) => SuggestionModeState | undefined;

package/dist/prosemirror/plugins/templateDirectives.d.ts

@@ -1,6 +1,6 @@
 import { DocScanState } from "./createDocScanPlugin.js";
 import { Node } from "prosemirror-model";
-import { EditorState } from "prosemirror-state";
+import { EditorState, Plugin, PluginKey } from "prosemirror-state";
 import { DirectiveKind } from "@stll/template-conditions";
 //#region src/prosemirror/plugins/templateDirectives.d.ts
 export type DirectiveRange = {
@@ -52,15 +52,15 @@ export declare const computeBlockDepths: (ranges: readonly DirectiveRange[]) =>
 export declare const scanDirectives: (doc: Node) => DirectiveRange[];
 export declare const templateDirectivesKey: Readonly<{
   key: string;
-  createKey: () => import("prosemirror-state").PluginKey<DocScanState<undefined, DirectiveRange>>;
-  owns: (plugin: import("prosemirror-state").Plugin<DocScanState<undefined, DirectiveRange>>) => boolean;
-  get: (state: EditorState) => import("prosemirror-state").Plugin<DocScanState<undefined, DirectiveRange>> | undefined;
+  createKey: () => PluginKey<DocScanState<undefined, DirectiveRange>>;
+  owns: (plugin: Plugin<DocScanState<undefined, DirectiveRange>>) => boolean;
+  get: (state: EditorState) => Plugin<DocScanState<undefined, DirectiveRange>> | undefined;
   getState: (state: EditorState) => DocScanState<undefined, DirectiveRange> | undefined;
 }>;
 export type TemplateDirectivesPluginOptions = {
   onRangesChange?: (ranges: readonly DirectiveRange[]) => void;
 };
-export declare const createTemplateDirectivesPlugin: ({ onRangesChange }?: TemplateDirectivesPluginOptions) => import("prosemirror-state").Plugin<DocScanState<undefined, DirectiveRange>>;
+export declare const createTemplateDirectivesPlugin: ({ onRangesChange }?: TemplateDirectivesPluginOptions) => Plugin<DocScanState<undefined, DirectiveRange>>;
 export declare const getTemplateDirectives: (state: EditorState) => readonly DirectiveRange[];
 //#endregion
 export type { DirectiveKind };

package/dist/prosemirror/plugins/templatePreviewValues.d.ts

@@ -1,4 +1,4 @@
-import { Plugin } from "prosemirror-state";
+import { EditorState, Plugin, PluginKey } from "prosemirror-state";
 import { DecorationSet, EditorView } from "prosemirror-view";
 //#region src/prosemirror/plugins/templatePreviewValues.d.ts
 /** One formatted span of a rich preview value. The flags layer over the
@@ -89,10 +89,10 @@ type TemplatePreviewState = {
 };
 export declare const templatePreviewValuesKey: Readonly<{
   key: string;
-  createKey: () => import("prosemirror-state").PluginKey<TemplatePreviewState>;
+  createKey: () => PluginKey<TemplatePreviewState>;
   owns: (plugin: Plugin<TemplatePreviewState>) => boolean;
-  get: (state: import("prosemirror-state").EditorState) => Plugin<TemplatePreviewState> | undefined;
-  getState: (state: import("prosemirror-state").EditorState) => TemplatePreviewState | undefined;
+  get: (state: EditorState) => Plugin<TemplatePreviewState> | undefined;
+  getState: (state: EditorState) => TemplatePreviewState | undefined;
 }>;
 export declare function createTemplatePreviewValuesPlugin(): Plugin<TemplatePreviewState>;
 /** Push (or clear, with `null`) the live fill preview into the editor. */

package/dist/prosemirror/plugins/templateSlashMenu.d.ts

@@ -1,4 +1,4 @@
-import { EditorState, Plugin, Transaction } from "prosemirror-state";
+import { EditorState, Plugin, PluginKey, Transaction } from "prosemirror-state";
 //#region src/prosemirror/plugins/templateSlashMenu.d.ts
 export type TemplateSlashMenuState = {
   active: false;
@@ -36,7 +36,7 @@ export type TemplateSlashMenuPluginOptions = {
 };
 export declare const templateSlashMenuKey: Readonly<{
   key: string;
-  createKey: () => import("prosemirror-state").PluginKey<TemplateSlashMenuState>;
+  createKey: () => PluginKey<TemplateSlashMenuState>;
   owns: (plugin: Plugin<TemplateSlashMenuState>) => boolean;
   get: (state: EditorState) => Plugin<TemplateSlashMenuState> | undefined;
   getState: (state: EditorState) => TemplateSlashMenuState | undefined;

package/dist/prosemirror/preservedXmlReview.d.ts

@@ -1,5 +1,5 @@
-import { Mark, Node } from "prosemirror-model";
+import { Attrs, Mark, Node } from "prosemirror-model";
 //#region src/prosemirror/preservedXmlReview.d.ts
 /** A retained opaque deleted result becomes ordinary text when its last deletion resolves. */
-export declare const resolvedPreservedXmlAttrs: (node: Node, marks: readonly Mark[]) => import("prosemirror-model").Attrs;
+export declare const resolvedPreservedXmlAttrs: (node: Node, marks: readonly Mark[]) => Attrs;
 //#endregion

package/dist/prosemirror/runStyleFormatting.d.ts

@@ -52,8 +52,8 @@ export declare const resolveParagraphInheritedRunFormatting: (options: ResolvePa
     italic?: boolean | undefined;
     italicCs?: boolean | undefined;
     underline?: {
-      style: import("@stll/docx-core/model").UnderlineStyle;
-      color?: import("@stll/docx-core/model").ColorValue;
+      style: document_d_exports.UnderlineStyle;
+      color?: document_d_exports.ColorValue;
     } | undefined;
     strike?: boolean | undefined;
     doubleStrike?: boolean | undefined;
@@ -62,9 +62,9 @@ export declare const resolveParagraphInheritedRunFormatting: (options: ResolvePa
     allCaps?: boolean | undefined;
     hidden?: boolean | undefined;
     noProof?: boolean | undefined;
-    color?: import("@stll/docx-core/model").ColorValue | undefined;
+    color?: document_d_exports.ColorValue | undefined;
     highlight?: "black" | "blue" | "cyan" | "darkBlue" | "darkCyan" | "darkGray" | "darkGreen" | "darkMagenta" | "darkRed" | "darkYellow" | "green" | "lightGray" | "magenta" | "none" | "red" | "white" | "yellow" | undefined;
-    shading?: import("@stll/docx-core/model").ShadingProperties | undefined;
+    shading?: document_d_exports.ShadingProperties | undefined;
     fontSize?: number | undefined;
     fontSizeCs?: number | undefined;
     fontFamily?: {
@@ -87,8 +87,8 @@ export declare const resolveParagraphInheritedRunFormatting: (options: ResolvePa
     position?: number | undefined;
     scale?: number | undefined;
     kerning?: number | undefined;
-    effect?: import("@stll/docx-core/model").TextEffect | undefined;
-    emphasisMark?: import("@stll/docx-core/model").EmphasisMark | undefined;
+    effect?: document_d_exports.TextEffect | undefined;
+    emphasisMark?: document_d_exports.EmphasisMark | undefined;
     emboss?: boolean | undefined;
     imprint?: boolean | undefined;
     outline?: boolean | undefined;
@@ -96,7 +96,7 @@ export declare const resolveParagraphInheritedRunFormatting: (options: ResolvePa
     rtl?: boolean | undefined;
     cs?: boolean | undefined;
     styleId?: string | undefined;
-    preserved?: import("@stll/docx-core/model").PreservedMarkup | undefined;
+    preserved?: document_d_exports.PreservedMarkup | undefined;
   } | undefined;
   inheritedToggleCascade: {
     formatting: document_d_exports.TextFormatting | undefined;

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

@@ -1,9 +1,10 @@
 import { CharacterSpacingAttrs, CharacterStyleAttrs, CommentAttrs, EmphasisMarkAttrs, FontFamilyAttrs, FontSizeAttrs, FootnoteRefAttrs, HighlightAttrs, HyperlinkAttrs, InlineWrapperAttrs, InlineWrapperKind, InlineWrapperLayer, LanguageAttrs, RunFormattingOverrideAttrs, RunIdentityMarkAttrs, RunPropertyChangeMarkAttrs, RunShadingAttrs, StrikeAttrs, TextColorAttrs, TextEffectAttrs, TrackedChangeMarkAttrs, TrackedRevisionAncestor, UnderlineAttrs } from "./marks.js";
 import { BlockCustomXmlAttrs, BlockSdtAttrs, BookmarkBoundaryAttrs, FieldAttrs, HardBreakAttrs, ImageAttrs, ImagePositionAttrs, MathAttrs, PageBreakRunAttrs, ParagraphAttrs, ParagraphPropertyChangeAttrs, PreservedBlockAttrs, PreservedXmlAttrs, PreservedXmlLevel, SdtAttrs, ShapeAttrs, SymbolAttrs, TabAttrs, TableAttrs, TableCellAttrs, TableRowAttrs, TextBoxAttrs } from "./nodes.js";
 import { ExtensionManager } from "../extensions/ExtensionManager.js";
+import { Schema } from "prosemirror-model";
 //#region src/prosemirror/schema/index.d.ts
 export declare const singletonManager: ExtensionManager;
-export declare const schema: import("prosemirror-model").Schema<any, any>;
+export declare const schema: Schema;
 /**
  * Export types for convenience
  */

package/dist/prosemirror/schema/index.js

@@ -2,13 +2,6 @@ import { ExtensionManager } from "../extensions/ExtensionManager.js";
 import { createStarterKit } from "../extensions/StarterKit.js";
 //#region src/prosemirror/schema/index.ts
 /**
-* ProseMirror Schema for DOCX Editor
-*
-* Singleton ExtensionManager that builds the schema and initializes runtime.
-* Legacy code imports `schema` and commands from here; new code should use
-* ExtensionManager directly.
-*/
-/**
 * Singleton ExtensionManager — builds schema + initializes runtime (plugins, commands, keymaps)
 */
 const mgr = new ExtensionManager(createStarterKit());

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

@@ -140,5 +140,5 @@ export declare class StyleResolver {
  */
 export declare function createStyleResolver(styleDefinitions: document_d_exports.StyleDefinitions | undefined): StyleResolver;
 /** The same ordered paragraph tiers, without unrelated run or paragraph fields. */
-export declare const resolveStyleParagraphNumbering: (resolver: StyleResolver, styleId: string | undefined | null) => import("@stll/docx-core/model").ParagraphNumberingOverride | undefined;
+export declare const resolveStyleParagraphNumbering: (resolver: StyleResolver, styleId: string | undefined | null) => document_d_exports.ParagraphNumberingOverride | undefined;
 //#endregion

package/dist/prosemirror/textInput.d.ts

@@ -1,3 +1,4 @@
+import { Mark } from "prosemirror-model";
 import { EditorState, Plugin, Transaction } from "prosemirror-state";
 import { EditorView } from "prosemirror-view";
 //#region src/prosemirror/textInput.d.ts
@@ -17,7 +18,7 @@ type FormattingMarksBesideLockedControlOptions = {
   from: number;
   to: number;
 };
-export declare const formattingMarksBesideLockedControl: ({ state, from, to }: FormattingMarksBesideLockedControlOptions) => import("prosemirror-model").Mark[] | undefined;
+export declare const formattingMarksBesideLockedControl: ({ state, from, to }: FormattingMarksBesideLockedControlOptions) => Mark[] | undefined;
 export declare const dispatchEditorTextInput: <TView extends TextInputDispatchTarget<TView>>(view: TView, input: string | TextInput) => void;
 export declare const getEditorInputTargetRange: (view: EditorView, event: InputEvent) => {
   from: number;
@@ -31,6 +32,6 @@ export declare const handleEditorBeforeInput: (view: EditorView, event: InputEve
  */
 export declare const afterNativeCompositionFlush: (callback: () => void) => void;
 /** Route committed text through the model before the browser mutates mark spans. */
-export declare const createTextInputPlugin: () => Plugin<any>;
+export declare const createTextInputPlugin: () => Plugin;
 //#endregion
 export {};

package/dist/prosemirror/yjsDocumentMetadata.d.ts

@@ -1,7 +1,8 @@
 import { Node } from "prosemirror-model";
-import { Result } from "better-result";
+import { Result, TaggedErrorClass } from "better-result";
 import * as Y from "yjs";
 //#region src/prosemirror/yjsDocumentMetadata.d.ts
+declare const FolioYjsAttrSchemaVersionErrorBase: TaggedErrorClass<"FolioYjsAttrSchemaVersionError">;
 /**
  * Carry a snapshot written under `version` forward to the next version,
  * rewriting the fragment in place and answering how many paragraphs changed.
@@ -15,15 +16,15 @@ export type FolioYjsAttrSchemaVersion = (typeof FOLIO_YJS_ATTR_SCHEMA_VERSIONS)[
  * The attr-schema version this build writes. Derived against the migration map
  * so the constant and the map cannot disagree.
  */
-export declare const FOLIO_YJS_ATTR_SCHEMA_VERSION = 14;
-declare const FolioYjsNoteReferenceSchemaError_base: import("better-result").TaggedErrorClass<"FolioYjsNoteReferenceSchemaError">;
-export declare class FolioYjsNoteReferenceSchemaError extends FolioYjsNoteReferenceSchemaError_base<{
+export declare const FOLIO_YJS_ATTR_SCHEMA_VERSION: 14;
+declare const FolioYjsNoteReferenceSchemaErrorBase: TaggedErrorClass<"FolioYjsNoteReferenceSchemaError">;
+export declare class FolioYjsNoteReferenceSchemaError extends FolioYjsNoteReferenceSchemaErrorBase<{
   message: string;
   schemaVersion: FolioYjsAttrSchemaVersion;
   requiredSchemaVersion: FolioYjsAttrSchemaVersion;
 }> {}
-declare const FolioYjsNumberingSourceSchemaError_base: import("better-result").TaggedErrorClass<"FolioYjsNumberingSourceSchemaError">;
-export declare class FolioYjsNumberingSourceSchemaError extends FolioYjsNumberingSourceSchemaError_base<{
+declare const FolioYjsNumberingSourceSchemaErrorBase: TaggedErrorClass<"FolioYjsNumberingSourceSchemaError">;
+export declare class FolioYjsNumberingSourceSchemaError extends FolioYjsNumberingSourceSchemaErrorBase<{
   message: string;
   schemaVersion: FolioYjsAttrSchemaVersion;
   requiredSchemaVersion: FolioYjsAttrSchemaVersion;
@@ -49,9 +50,8 @@ export declare const attrSchemaMigrationSteps: (fromVersion: FolioYjsAttrSchemaV
  * Returns how many elements the steps rewrote.
  */
 export declare const applyAttrSchemaMigrations: (ydoc: Y.Doc, fragment: Y.XmlFragment, fromVersion: FolioYjsAttrSchemaVersion) => number;
-declare const FolioYjsAttrSchemaVersionError_base: import("better-result").TaggedErrorClass<"FolioYjsAttrSchemaVersionError">;
 /** Raised when a snapshot's attr-schema marker is ahead of the running code. */
-export declare class FolioYjsAttrSchemaVersionError extends FolioYjsAttrSchemaVersionError_base<{
+export declare class FolioYjsAttrSchemaVersionError extends FolioYjsAttrSchemaVersionErrorBase<{
   message: string;
   /** The marker exactly as stored, so the host can log what it refused. */
   marker: unknown;

package/dist/prosemirror/yjsDocumentMetadata.js

@@ -4,6 +4,7 @@ import { mintSectionProperties, parseSectionBreakType } from "./sectionCarrier.j
 import { Result, TaggedError, panic } from "better-result";
 import { DRAWING_RAW_XML_MODES, outlineLevelFromStatedValue, paragraphNumberingFromSlots } from "@stll/docx-core/model";
 //#region src/prosemirror/yjsDocumentMetadata.ts
+const FolioYjsAttrSchemaVersionErrorBase = TaggedError("FolioYjsAttrSchemaVersionError");
 /**
 * Folio's own keys inside a collaboration document: one map, two independent
 * bindings.
@@ -512,8 +513,10 @@ const ATTR_SCHEMA_MIGRATIONS = {
 */
 const FOLIO_YJS_ATTR_SCHEMA_VERSION = 14;
 const STATED_NUMBERING_SOURCE_SCHEMA_VERSION = 13;
-var FolioYjsNoteReferenceSchemaError = class extends TaggedError("FolioYjsNoteReferenceSchemaError") {};
-var FolioYjsNumberingSourceSchemaError = class extends TaggedError("FolioYjsNumberingSourceSchemaError") {};
+const FolioYjsNoteReferenceSchemaErrorBase = TaggedError("FolioYjsNoteReferenceSchemaError");
+var FolioYjsNoteReferenceSchemaError = class extends FolioYjsNoteReferenceSchemaErrorBase {};
+const FolioYjsNumberingSourceSchemaErrorBase = TaggedError("FolioYjsNumberingSourceSchemaError");
+var FolioYjsNumberingSourceSchemaError = class extends FolioYjsNumberingSourceSchemaErrorBase {};
 /** Older snapshots can hold a resolved style reference where a stated override belongs. */
 const requireStatedNumberingSources = (fragment, schemaVersion) => {
 	if (schemaVersion >= STATED_NUMBERING_SOURCE_SCHEMA_VERSION) return;
@@ -601,7 +604,7 @@ const applyAttrSchemaMigrations = (ydoc, fragment, fromVersion) => {
 	return rewritten;
 };
 /** Raised when a snapshot's attr-schema marker is ahead of the running code. */
-var FolioYjsAttrSchemaVersionError = class extends TaggedError("FolioYjsAttrSchemaVersionError") {};
+var FolioYjsAttrSchemaVersionError = class extends FolioYjsAttrSchemaVersionErrorBase {};
 const isReadableVersion = (marker) => typeof marker === "number" && Number.isInteger(marker) && marker >= 0 && marker <= 14;
 /**
 * The attr-schema version a collaboration document was written under.

package/dist/redline.d.ts

@@ -1,7 +1,10 @@
 import { FolioAIEditAppliedOperation, FolioAIEditSkippedOperation } from "./ai-edits/types.js";
 import { FolioDocumentStoryHandle, FolioResolvedReviewedView } from "./ai-edits/headless.js";
 import { FolioDocumentPrivacyOptions, FolioDocumentPrivacyReport } from "./docx/metadataPrivacy.js";
+import { TaggedErrorClass } from "better-result";
 //#region src/redline.d.ts
+declare const GenerateRedlineDocxResourceImportErrorBase: TaggedErrorClass<"GenerateRedlineDocxResourceImportError">;
+declare const InvalidGenerateRedlineDocxOptionsErrorBase: TaggedErrorClass<"InvalidGenerateRedlineDocxOptionsError">;
 /** Options for {@link generateRedlineDocx}. */
 export type GenerateRedlineDocxOptions = {
   /** Author recorded on the generated tracked changes. (default: `"folio compare"`) */
@@ -13,16 +16,14 @@ export type GenerateRedlineDocxOptions = {
   /** Optional output-only package-metadata privacy transforms. */
   privacy?: FolioDocumentPrivacyOptions;
 };
-declare const InvalidGenerateRedlineDocxOptionsError_base: import("better-result").TaggedErrorClass<"InvalidGenerateRedlineDocxOptionsError">;
 /** Raised when a resolved input view is not `"original"` or `"final"`. */
-export declare class InvalidGenerateRedlineDocxOptionsError extends InvalidGenerateRedlineDocxOptionsError_base<{
+export declare class InvalidGenerateRedlineDocxOptionsError extends InvalidGenerateRedlineDocxOptionsErrorBase<{
   message: string;
   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. */
-export declare class GenerateRedlineDocxResourceImportError extends GenerateRedlineDocxResourceImportError_base<{
+export declare class GenerateRedlineDocxResourceImportError extends GenerateRedlineDocxResourceImportErrorBase<{
   message: string;
   detail: string;
 }> {}

package/dist/redline.js

@@ -24,10 +24,12 @@ import { TaggedError, panic } from "better-result";
 *
 * @packageDocumentation
 */
+const GenerateRedlineDocxResourceImportErrorBase = TaggedError("GenerateRedlineDocxResourceImportError");
+const InvalidGenerateRedlineDocxOptionsErrorBase = TaggedError("InvalidGenerateRedlineDocxOptionsError");
 /** Raised when a resolved input view is not `"original"` or `"final"`. */
-var InvalidGenerateRedlineDocxOptionsError = class extends TaggedError("InvalidGenerateRedlineDocxOptionsError") {};
+var InvalidGenerateRedlineDocxOptionsError = class extends InvalidGenerateRedlineDocxOptionsErrorBase {};
 /** Raised before body operations when revised resources cannot be imported atomically. */
-var GenerateRedlineDocxResourceImportError = class extends TaggedError("GenerateRedlineDocxResourceImportError") {};
+var GenerateRedlineDocxResourceImportError = class extends GenerateRedlineDocxResourceImportErrorBase {};
 const nextBaseBlockIdByIndex = (events) => {
 	const nextIds = Array.from({ length: events.length });
 	let nextId = null;

package/dist/redlineOperationLimit.d.ts

@@ -1,7 +1,8 @@
+import { TaggedErrorClass } from "better-result";
 //#region src/redlineOperationLimit.d.ts
 export declare const MAX_GENERATED_REDLINE_OPERATIONS = 10000;
-declare const GenerateRedlineDocxOperationLimitError_base: import("better-result").TaggedErrorClass<"GenerateRedlineDocxOperationLimitError">;
-export declare class GenerateRedlineDocxOperationLimitError extends GenerateRedlineDocxOperationLimitError_base<{
+declare const GenerateRedlineDocxOperationLimitErrorBase: TaggedErrorClass<"GenerateRedlineDocxOperationLimitError">;
+export declare class GenerateRedlineDocxOperationLimitError extends GenerateRedlineDocxOperationLimitErrorBase<{
   message: string;
 }> {}
 //#endregion

package/dist/redlineOperationLimit.js

@@ -1,6 +1,7 @@
 import { TaggedError } from "better-result";
 //#region src/redlineOperationLimit.ts
 const MAX_GENERATED_REDLINE_OPERATIONS = 1e4;
-var GenerateRedlineDocxOperationLimitError = class extends TaggedError("GenerateRedlineDocxOperationLimitError") {};
+const GenerateRedlineDocxOperationLimitErrorBase = TaggedError("GenerateRedlineDocxOperationLimitError");
+var GenerateRedlineDocxOperationLimitError = class extends GenerateRedlineDocxOperationLimitErrorBase {};
 //#endregion
 export { GenerateRedlineDocxOperationLimitError, MAX_GENERATED_REDLINE_OPERATIONS };

package/dist/render-dom/commentAnchorAttributes.d.ts

@@ -14,7 +14,7 @@
  * cannot come to answer differently.
  */
 /** The painted anchors inside a container, whichever comment they belong to. */
-export declare const COMMENT_ANCHOR_SELECTOR = "[data-comment-id]";
+export declare const COMMENT_ANCHOR_SELECTOR: "[data-comment-id]";
 /** What a painter, a reader and their test fakes all offer. */
 type CommentAnchor = {
   dataset: Record<string, string | undefined>;

package/dist/shaping/shaper.d.ts

@@ -1,23 +1,5 @@
+import { TaggedErrorClass } from "better-result";
 //#region src/shaping/shaper.d.ts
-/**
- * The boundary to the text shaper.
- *
- * Shaping is the one part of text layout that cannot be derived from code
- * points: Arabic letters take their form from their neighbours, lam-alef
- * ligates, Devanagari reorders and forms conjuncts, Hebrew points hang off the
- * letter they belong to. One implementation answers that question, in Rust, and
- * every caller reaches it through this module: a measurement in CSS pixels and
- * a PDF text matrix scale the same glyph ids and the same advances, so the two
- * cannot describe different text.
- *
- * The artifact is loaded on demand. It carries the OpenType layout engine and
- * the Unicode data that engine needs, and a document in Latin, Cyrillic or
- * Greek needs none of it: `getShaper` is called only once a run in a shaping
- * script is about to be measured or painted, and never before.
- *
- * The same artifact resolves the bidirectional algorithm, because splitting a
- * line into runs that each read one way is what shaping needs first.
- */
 /** Which way a run advances. Resolved by the producer, never guessed here. */
 export declare const SHAPING_DIRECTION: {
   readonly leftToRight: "ltr";
@@ -93,8 +75,8 @@ export type Shaper = {
   readonly shapeRun: (request: ShapeRunRequest) => ShapedRun;
   readonly resolveBidi: (request: ResolveBidiRequest) => BidiLine;
 };
-declare const ShaperError_base: import("better-result").TaggedErrorClass<"ShaperError">;
-export declare class ShaperError extends ShaperError_base<{
+declare const ShaperErrorBase: TaggedErrorClass<"ShaperError">;
+export declare class ShaperError extends ShaperErrorBase<{
   message: string;
   cause?: unknown;
 }> {}

package/dist/shaping/shaper.js

@@ -32,7 +32,8 @@ const BIDI_DIRECTION = {
 	/** Rules P2 and P3: the first strong character outside an isolate decides. */
 	auto: "auto"
 };
-var ShaperError = class extends TaggedError("ShaperError") {};
+const ShaperErrorBase = TaggedError("ShaperError");
+var ShaperError = class extends ShaperErrorBase {};
 /**
 * The flat buffer the WebAssembly entry returns:
 * `[unitsPerEm, glyphCount, (glyphId, cluster, xAdvance, yAdvance, xOffset,

package/dist/utils/clipboard.d.ts

@@ -137,7 +137,7 @@ export declare function createClipboardHandlers(options: {
   handlePaste: (event: ClipboardEvent) => void;
   handleKeyDown: (event: KeyboardEvent) => Promise<void>;
 };
-declare const _default: {
+declare const _default_1: {
   copyRuns: typeof copyRuns;
   copyParagraphs: typeof copyParagraphs;
   readFromClipboard: typeof readFromClipboard;
@@ -149,4 +149,4 @@ declare const _default: {
   createClipboardHandlers: typeof createClipboardHandlers;
 };
 //#endregion
-export { _default as default };
+export { _default_1 as default };

package/dist/utils/clipboard.js

@@ -666,7 +666,7 @@ function createClipboardHandlers(options) {
 		handleKeyDown
 	};
 }
-var clipboard_default = {
+const _default_1 = {
 	copyRuns,
 	copyParagraphs,
 	readFromClipboard,
@@ -678,4 +678,4 @@ var clipboard_default = {
 	createClipboardHandlers
 };
 //#endregion
-export { CLIPBOARD_TYPES, INTERNAL_CLIPBOARD_TYPE, cleanWordHtml, copyParagraphs, copyRuns, createClipboardHandlers, clipboard_default as default, getClipboardImageFiles, getStandaloneClipboardImageFiles, handlePasteEvent, htmlToRuns, isEditorHtml, isWordHtml, paragraphsToClipboardContent, parseClipboardHtml, readFromClipboard, runsToClipboardContent, sanitizeInboundClipboardHtml, writeToClipboard };
+export { CLIPBOARD_TYPES, INTERNAL_CLIPBOARD_TYPE, cleanWordHtml, copyParagraphs, copyRuns, createClipboardHandlers, _default_1 as default, getClipboardImageFiles, getStandaloneClipboardImageFiles, handlePasteEvent, htmlToRuns, isEditorHtml, isWordHtml, paragraphsToClipboardContent, parseClipboardHtml, readFromClipboard, runsToClipboardContent, sanitizeInboundClipboardHtml, writeToClipboard };

package/dist/utils/formatToStyle.d.ts

@@ -56,7 +56,7 @@ export type UnderlineDecorationCss = {
  * It is also what an underline CSS cannot spell parses back as; see
  * `underlineStyleFromCssDecoration`.
  */
-export declare const PLAIN_UNDERLINE = "single";
+export declare const PLAIN_UNDERLINE: "single";
 /**
  * Every `ST_Underline` member's CSS line. The one table: the ProseMirror mark's
  * `toDOM`, the DOM painter and `textToStyle` all render a run from this, so a

package/dist/utils/headingCollector.d.ts

@@ -5,6 +5,13 @@ import { Node } from "prosemirror-model";
  * Information about a heading found in the document.
  */
 export type HeadingInfo = {
+  /**
+   * Outline identity within this editing session: the paragraph's `paraId`,
+   * which the editor allocates for every body paragraph and which survives
+   * edits elsewhere in the document. A paragraph without one, or whose
+   * `paraId` an earlier heading already took, is identified by position.
+   */
+  id: string;
   /** The text content of the heading */
   text: string;
   /** Outline level (0 = Heading 1, 1 = Heading 2, etc.) */

package/dist/utils/headingCollector.js

@@ -1,6 +1,8 @@
 import { resolveHeadingLevel } from "../docx/builtInStyles.js";
 import { readOutlineLevelAttr } from "../prosemirror/outlineLevelAttr.js";
 //#region src/utils/headingCollector.ts
+/** Not hex, so it cannot collide with a `paraId` Word or the editor writes. */
+const POSITIONAL_HEADING_ID_PREFIX = "pos-";
 const RUN_IN_TITLE_MARKS = /* @__PURE__ */ new Set([
 	"bold",
 	"italic",
@@ -56,6 +58,7 @@ const headingText = (paragraph) => {
 */
 function collectHeadings(doc, styles) {
 	const headings = [];
+	const takenIds = /* @__PURE__ */ new Set();
 	doc.descendants((node, pos) => {
 		if (node.type.name !== "paragraph") return;
 		const level = resolveHeadingLevel({
@@ -64,7 +67,12 @@ function collectHeadings(doc, styles) {
 		}, styles);
 		if (level === void 0) return;
 		const text = headingText(node);
-		if (text.trim()) headings.push({
+		if (!text.trim()) return;
+		const paraId = node.attrs["paraId"];
+		const id = typeof paraId === "string" && paraId !== "" && !takenIds.has(paraId) ? paraId : `${POSITIONAL_HEADING_ID_PREFIX}${String(pos)}`;
+		takenIds.add(id);
+		headings.push({
+			id,
 			text: text.trim(),
 			level,
 			pmPos: pos

package/dist/utils/outlineHeadings.d.ts

@@ -0,0 +1,20 @@
+import { HeadingInfo } from "./headingCollector.js";
+import { Layout } from "../layout-engine/types.js";
+//#region src/utils/outlineHeadings.d.ts
+type ResolveOutlineHeadingsOptions = {
+  /** Headings collected from the document `layout` was computed from. */
+  collected: readonly HeadingInfo[];
+  layout: Layout | null;
+  previous: HeadingInfo[];
+};
+/**
+ * The outline's headings with page numbers from `layout`.
+ *
+ * A heading the layout does not place keeps the page number it last had under
+ * the same id, so the outline never shows a transient blank while a layout is
+ * pending. An unchanged entry is returned as its previous object and an
+ * unchanged list as the previous array, so consumers can skip work by identity.
+ */
+export declare const resolveOutlineHeadings: ({ collected, layout, previous }: ResolveOutlineHeadingsOptions) => HeadingInfo[];
+//#endregion
+export {};

package/dist/utils/outlineHeadings.js

@@ -0,0 +1,43 @@
+import { findPageIndexContainingPmPos } from "../layout-engine/pmPageIndex.js";
+//#region src/utils/outlineHeadings.ts
+const sameHeading = (a, b) => Object.values({
+	id: a.id === b.id,
+	text: a.text === b.text,
+	level: a.level === b.level,
+	pmPos: a.pmPos === b.pmPos,
+	pageNumber: (a.pageNumber ?? null) === (b.pageNumber ?? null)
+}).every(Boolean);
+const layoutPageNumber = (layout, pmPos) => {
+	const pageIndex = findPageIndexContainingPmPos(layout, pmPos);
+	return pageIndex === null ? null : layout.pages[pageIndex]?.number ?? null;
+};
+/**
+* The outline's headings with page numbers from `layout`.
+*
+* A heading the layout does not place keeps the page number it last had under
+* the same id, so the outline never shows a transient blank while a layout is
+* pending. An unchanged entry is returned as its previous object and an
+* unchanged list as the previous array, so consumers can skip work by identity.
+*/
+const resolveOutlineHeadings = ({ collected, layout, previous }) => {
+	const previousById = new Map(previous.map((heading) => [heading.id, heading]));
+	let changed = collected.length !== previous.length;
+	const next = [];
+	for (const [index, heading] of collected.entries()) {
+		const before = previousById.get(heading.id);
+		const pageNumber = (layout && layoutPageNumber(layout, heading.pmPos)) ?? before?.pageNumber ?? null;
+		const resolved = {
+			id: heading.id,
+			text: heading.text,
+			level: heading.level,
+			pmPos: heading.pmPos,
+			pageNumber
+		};
+		const kept = before && sameHeading(before, resolved) ? before : resolved;
+		if (kept !== previous[index]) changed = true;
+		next.push(kept);
+	}
+	return changed ? next : previous;
+};
+//#endregion
+export { resolveOutlineHeadings };