@stll/folio-core 0.62.0 → 0.63.0

package/dist/managers/Subscribable.d.ts

@@ -9,7 +9,7 @@
  * - React: useSyncExternalStore(manager.subscribe, manager.getSnapshot)
  * - Vue: watchEffect(() => { manager.subscribe(triggerRef) })
  */
-declare abstract class Subscribable<TSnapshot> {
+export declare abstract class Subscribable<TSnapshot> {
   private readonly listeners;
   private snapshot;
   constructor(initialSnapshot: TSnapshot);
@@ -30,5 +30,4 @@ declare abstract class Subscribable<TSnapshot> {
   protected setSnapshot(snapshot: TSnapshot): void;
   private notify;
 }
-//#endregion
-export { Subscribable };
+//#endregion

package/dist/managers/TableSelectionManager.d.ts

@@ -4,7 +4,7 @@ import { TableAction, TableContext } from "../utils/tableOperations.js";
 import { CellCoordinates } from "./types.js";
 //#region src/managers/TableSelectionManager.d.ts
 /** Data attributes for table elements in the rendered DOM */
-declare const TABLE_DATA_ATTRIBUTES: {
+export declare const TABLE_DATA_ATTRIBUTES: {
   readonly TABLE_INDEX: "data-table-index";
   readonly ROW_INDEX: "data-row";
   readonly COLUMN_INDEX: "data-col";
@@ -14,18 +14,18 @@ declare const TABLE_DATA_ATTRIBUTES: {
  * Find table cell coordinates from a click target by walking up the DOM
  * and reading data attributes.
  */
-declare function findTableFromClick(target: EventTarget | null, container?: HTMLElement | null): CellCoordinates | null;
+export declare function findTableFromClick(target: EventTarget | null, container?: HTMLElement | null): CellCoordinates | null;
 /** Get a table from the document by index. */
-declare function getTableFromDocument(doc: document_d_exports.Document, tableIndex: number): document_d_exports.Table | null;
+export declare function getTableFromDocument(doc: document_d_exports.Document, tableIndex: number): document_d_exports.Table | null;
 /** Update a table in the document immutably. */
-declare function updateTableInDocument(doc: document_d_exports.Document, tableIndex: number, newTable: document_d_exports.Table): document_d_exports.Document;
+export declare function updateTableInDocument(doc: document_d_exports.Document, tableIndex: number, newTable: document_d_exports.Table): document_d_exports.Document;
 /** Delete a table from the document immutably. */
-declare function deleteTableFromDocument(doc: document_d_exports.Document, tableIndex: number): document_d_exports.Document;
+export declare function deleteTableFromDocument(doc: document_d_exports.Document, tableIndex: number): document_d_exports.Document;
 /**
  * Tracked table-selection state: the selected cell coordinates plus the derived
  * {@link TableContext} (and the resolved table) for the current document.
  */
-type TableSelectionState = {
+export type TableSelectionState = {
   context: TableContext | null;
   table: document_d_exports.Table | null;
   tableIndex: number | null;
@@ -39,7 +39,7 @@ type TableSelectionState = {
  *  - `deleted`: the table was removed and the selection cleared.
  *  - `updated`: the table was mutated; the selection now tracks the new table.
  */
-type TableActionResult = {
+export type TableActionResult = {
   type: "noop";
 } | {
   type: "deleted";
@@ -49,7 +49,7 @@ type TableActionResult = {
   document: document_d_exports.Document;
   context: TableContext;
 };
-declare class TableSelectionManager extends Subscribable<TableSelectionState> {
+export declare class TableSelectionManager extends Subscribable<TableSelectionState> {
   constructor();
   /**
    * Track cell coordinates before a document model is available. This supports
@@ -75,5 +75,4 @@ declare class TableSelectionManager extends Subscribable<TableSelectionState> {
    */
   handleAction(doc: document_d_exports.Document, action: TableAction): TableActionResult;
 }
-//#endregion
-export { TABLE_DATA_ATTRIBUTES, TableActionResult, TableSelectionManager, TableSelectionState, deleteTableFromDocument, findTableFromClick, getTableFromDocument, updateTableInDocument };
+//#endregion

package/dist/managers/TableSelectionManager.js

@@ -131,11 +131,12 @@ var TableSelectionManager = class extends Subscribable {
 			this.setSnapshot(EMPTY_SELECTION);
 			return null;
 		}
-		const context = createTableContext(table, {
+		const selection = {
 			tableIndex: coords.tableIndex,
 			rowIndex: coords.rowIndex,
 			columnIndex: coords.columnIndex
-		});
+		};
+		const context = createTableContext(table, selection);
 		this.setSnapshot({
 			context,
 			table,
@@ -208,17 +209,6 @@ var TableSelectionManager = class extends Subscribable {
 					document: newDoc
 				};
 			}
-			case "borderAll":
-			case "borderBottom":
-			case "borderInside":
-			case "borderLeft":
-			case "borderNone":
-			case "borderOutside":
-			case "borderRight":
-			case "borderTop":
-			case "selectColumn":
-			case "selectRow":
-			case "selectTable": break;
 		}
 		if (!newTable) return { type: "noop" };
 		const newDoc = updateTableInDocument(doc, tableIndex, newTable);

package/dist/managers/autoSaveCodec.d.ts

@@ -8,18 +8,17 @@ import { document_d_exports } from "../types/document.js";
  * envelope is a local draft of one editing session, so it is refused and
  * re-taken rather than migrated.
  */
-declare const AUTOSAVE_FORMAT_VERSION = 3;
-type DecodedAutoSave = {
+export declare const AUTOSAVE_FORMAT_VERSION = 3;
+export type DecodedAutoSave = {
   document: document_d_exports.Document;
   savedAt: string;
   version: typeof AUTOSAVE_FORMAT_VERSION;
 };
-type EncodedAutoSaveDocument = {
+export type EncodedAutoSaveDocument = {
   json: string;
 };
-declare const encodeAutoSaveDocument: (document: document_d_exports.Document) => EncodedAutoSaveDocument;
-declare const encodeAutoSaveEnvelopeFromDocument: (document: EncodedAutoSaveDocument, savedAt: string) => string;
-declare const encodeAutoSaveEnvelope: (document: document_d_exports.Document, savedAt: string) => string;
-declare const decodeAutoSaveEnvelope: (json: string) => DecodedAutoSave | null;
-//#endregion
-export { AUTOSAVE_FORMAT_VERSION, DecodedAutoSave, EncodedAutoSaveDocument, decodeAutoSaveEnvelope, encodeAutoSaveDocument, encodeAutoSaveEnvelope, encodeAutoSaveEnvelopeFromDocument };
+export declare const encodeAutoSaveDocument: (document: document_d_exports.Document) => EncodedAutoSaveDocument;
+export declare const encodeAutoSaveEnvelopeFromDocument: (document: EncodedAutoSaveDocument, savedAt: string) => string;
+export declare const encodeAutoSaveEnvelope: (document: document_d_exports.Document, savedAt: string) => string;
+export declare const decodeAutoSaveEnvelope: (json: string) => DecodedAutoSave | null;
+//#endregion

package/dist/managers/editorShortcuts.d.ts

@@ -1,16 +1,16 @@
 import { HistoryShortcutOwner } from "../prosemirror/extensions/core/HistoryExtension.js";
 import { EditorState, Transaction } from "prosemirror-state";
 //#region src/managers/editorShortcuts.d.ts
-declare const DEFAULT_KEYBOARD_SHORTCUT_SCOPE = "editor";
-declare function isMacPlatform(): boolean;
+export declare const DEFAULT_KEYBOARD_SHORTCUT_SCOPE = "editor";
+export declare function isMacPlatform(): boolean;
 /**
  * `target` is an input-like element that the user is typing into. We must
  * not intercept Delete/Backspace there — only when focus is in the editor
  * surface (or nowhere at all).
  */
-declare function isFocusInInputLike(target: EventTarget | null, editorDom: HTMLElement | null | undefined): boolean;
+export declare function isFocusInInputLike(target: EventTarget | null, editorDom: HTMLElement | null | undefined): boolean;
 /** The editor action a keydown maps to, or `none` when it is not a shortcut. */
-type EditorKeydownIntent = {
+export type EditorKeydownIntent = {
   type: "deleteSelectedTable";
 } | {
   type: "openFind";
@@ -26,10 +26,10 @@ type EditorKeydownIntent = {
  *  - `"history"`: undo and redo (Mod-z, Mod-y, Mod-Shift-z).
  *  - `"print"`: Cmd/Ctrl+P.
  */
-type HostShortcut = "history" | "print";
+export type HostShortcut = "history" | "print";
 /** Who answers the undo and redo keys when the host owns `hostShortcuts`. */
-declare const historyShortcutOwner: (hostShortcuts: readonly HostShortcut[]) => HistoryShortcutOwner;
-type ClassifyEditorKeydownOptions = {
+export declare const historyShortcutOwner: (hostShortcuts: readonly HostShortcut[]) => HistoryShortcutOwner;
+export type ClassifyEditorKeydownOptions = {
   /** Whether the platform uses Cmd (Mac) rather than Ctrl as the primary modifier. */
   isMac: boolean;
   /** Whether focus is in a non-editor input/textarea/contenteditable. */
@@ -43,23 +43,23 @@ type ClassifyEditorKeydownOptions = {
  *  - Cmd/Ctrl+P (no auto-repeat) → custom print, unless the host owns print
  *  - Delete/Backspace (no modifiers, focus not in an input) → delete selected table
  */
-declare function classifyEditorKeydown(e: Pick<KeyboardEvent, "key" | "metaKey" | "ctrlKey" | "shiftKey" | "altKey" | "repeat">, { isMac, isInputLike, hostShortcuts }: ClassifyEditorKeydownOptions): EditorKeydownIntent;
+export declare function classifyEditorKeydown(e: Pick<KeyboardEvent, "key" | "metaKey" | "ctrlKey" | "shiftKey" | "altKey" | "repeat">, { isMac, isInputLike, hostShortcuts }: ClassifyEditorKeydownOptions): EditorKeydownIntent;
 /**
  * Which key presses the editor's page-level shortcuts answer.
  *  - `"document"`: every press on the page.
  *  - `"editor"`: only a press whose target is inside the editor.
  *  - `"none"`: no page-level listener; the host dispatches shortcuts itself.
  */
-type KeyboardShortcutScope = "document" | "editor" | "none";
+export type KeyboardShortcutScope = "document" | "editor" | "none";
 /**
  * The containment surface a scope root has to offer. Structural rather than
  * `Element` so the predicate carries no DOM dependency and answers the same
  * under a server render and a DOM-less test runtime.
  */
-type ShortcutScopeRoot = {
+export type ShortcutScopeRoot = {
   contains(other: unknown): boolean;
 };
-type IsKeydownInShortcutScopeOptions = {
+export type IsKeydownInShortcutScopeOptions = {
   scope: KeyboardShortcutScope;
   /**
    * Elements a press must land inside under `"editor"`: the editor root plus
@@ -73,7 +73,7 @@ type IsKeydownInShortcutScopeOptions = {
  * the listener; this decides, from the event target alone, whether the press
  * belongs to this editor or to whatever else the host has on the page.
  */
-declare function isKeydownInShortcutScope(event: {
+export declare function isKeydownInShortcutScope(event: {
   target: unknown;
 }, { scope, roots }: IsKeydownInShortcutScopeOptions): boolean;
 /**
@@ -81,6 +81,5 @@ declare function isKeydownInShortcutScope(event: {
  * table, delete the table and return `true`. Returns `false` for any other
  * selection so the caller can fall back to a layout-overlay table selection.
  */
-declare function deleteSelectedTable(state: EditorState, dispatch: (tr: Transaction) => void): boolean;
-//#endregion
-export { ClassifyEditorKeydownOptions, DEFAULT_KEYBOARD_SHORTCUT_SCOPE, EditorKeydownIntent, HostShortcut, IsKeydownInShortcutScopeOptions, KeyboardShortcutScope, ShortcutScopeRoot, classifyEditorKeydown, deleteSelectedTable, historyShortcutOwner, isFocusInInputLike, isKeydownInShortcutScope, isMacPlatform };
+export declare function deleteSelectedTable(state: EditorState, dispatch: (tr: Transaction) => void): boolean;
+//#endregion

package/dist/managers/reviewDisplayMode.d.ts

@@ -1,8 +1,7 @@
 import { DisplayMode } from "./EditorModeManager.js";
 //#region src/managers/reviewDisplayMode.d.ts
 /** The host's reading of pending revisions; it never changes the saved document. */
-declare const REVIEW_DISPLAY_MODES: readonly ["all-markup", "final", "original"];
-type ReviewDisplayMode = (typeof REVIEW_DISPLAY_MODES)[number];
-declare const reviewDisplayModeToDisplayMode: (mode: ReviewDisplayMode) => DisplayMode;
-//#endregion
-export { REVIEW_DISPLAY_MODES, ReviewDisplayMode, reviewDisplayModeToDisplayMode };
+export declare const REVIEW_DISPLAY_MODES: readonly ["all-markup", "final", "original"];
+export type ReviewDisplayMode = (typeof REVIEW_DISPLAY_MODES)[number];
+export declare const reviewDisplayModeToDisplayMode: (mode: ReviewDisplayMode) => DisplayMode;
+//#endregion

package/dist/managers/types.d.ts

@@ -1,18 +1,18 @@
 import { ListNumberingMenuState } from "../prosemirror/listNumbering.js";
 //#region src/managers/types.d.ts
 /** Cell coordinates in a table */
-type CellCoordinates = {
+export type CellCoordinates = {
   tableIndex: number;
   rowIndex: number;
   columnIndex: number;
 };
 /** Viewport anchor (px) where the context menu opens. */
-type ContextMenuAnchor = {
+export type ContextMenuAnchor = {
   x: number;
   y: number;
 };
 /** ContextMenuManager snapshot. */
-type ContextMenuSnapshot = {
+export type ContextMenuSnapshot = {
   isOpen: boolean;
   position: ContextMenuAnchor;
   hasSelection: boolean;
@@ -26,9 +26,9 @@ type ContextMenuSnapshot = {
   listNumbering: ListNumberingMenuState;
 };
 /** Error severity levels */
-type ErrorSeverity = "error" | "warning" | "info";
+export type ErrorSeverity = "error" | "warning" | "info";
 /** Error notification */
-type ErrorNotification = {
+export type ErrorNotification = {
   id: string;
   message: string;
   severity: ErrorSeverity;
@@ -37,8 +37,7 @@ type ErrorNotification = {
   dismissed?: boolean;
 };
 /** ErrorManager snapshot */
-type ErrorManagerSnapshot = {
+export type ErrorManagerSnapshot = {
   notifications: ErrorNotification[];
 };
-//#endregion
-export { CellCoordinates, ContextMenuAnchor, ContextMenuSnapshot, ErrorManagerSnapshot, ErrorNotification, ErrorSeverity };
+//#endregion

package/dist/markdown/annotations.d.ts

@@ -1,13 +1,12 @@
 import { document_d_exports } from "../types/document.js";
 import { RenderContext } from "./types.js";
 //#region src/markdown/annotations.d.ts
-declare function wrapInsertion(ctx: RenderContext, info: document_d_exports.TrackedChangeInfo, inner: string): string;
-declare function wrapDeletion(ctx: RenderContext, info: document_d_exports.TrackedChangeInfo, inner: string): string;
-declare function wrapMoveFrom(ctx: RenderContext, info: document_d_exports.TrackedChangeInfo, inner: string): string;
-declare function wrapMoveTo(ctx: RenderContext, info: document_d_exports.TrackedChangeInfo, inner: string): string;
-declare function wrapComment(ctx: RenderContext, meta: {
+export declare function wrapInsertion(ctx: RenderContext, info: document_d_exports.TrackedChangeInfo, inner: string): string;
+export declare function wrapDeletion(ctx: RenderContext, info: document_d_exports.TrackedChangeInfo, inner: string): string;
+export declare function wrapMoveFrom(ctx: RenderContext, info: document_d_exports.TrackedChangeInfo, inner: string): string;
+export declare function wrapMoveTo(ctx: RenderContext, info: document_d_exports.TrackedChangeInfo, inner: string): string;
+export declare function wrapComment(ctx: RenderContext, meta: {
   id: number;
   author?: string;
 }, inner: string): string;
-//#endregion
-export { wrapComment, wrapDeletion, wrapInsertion, wrapMoveFrom, wrapMoveTo };
+//#endregion

package/dist/markdown/escape.d.ts

@@ -15,7 +15,7 @@
  * starts or in specific adjacency; we let the block-level renderer decide
  * when to escape those.
  */
-declare function escapeInline(text: string): string;
+export declare function escapeInline(text: string): string;
 /**
  * Cells use `|` as the column separator. The input is already markdown (each
  * cell is a rendered paragraph that ran through {@link escapeInline}), so a
@@ -24,15 +24,14 @@ declare function escapeInline(text: string): string;
  * treating it as a delimiter. Newlines become `<br>` to keep the row on one
  * line.
  */
-declare function escapeTableCell(text: string): string;
+export declare function escapeTableCell(text: string): string;
 /** Single-line Markdown blocks express inline breaks without their two-space syntax. */
-declare const inlineBreaksToHtml: (text: string) => string;
-declare function escapeLinkUrl(url: string): string;
+export declare const inlineBreaksToHtml: (text: string) => string;
+export declare function escapeLinkUrl(url: string): string;
 /**
  * Alt text inside `![alt](url)`. Raw (un-escaped) text, so escape the backslash
  * first, then the brackets that would confuse the link parser, and collapse
  * newlines so the alt stays single-line.
  */
-declare function escapeAltText(text: string): string;
-//#endregion
-export { escapeAltText, escapeInline, escapeLinkUrl, escapeTableCell, inlineBreaksToHtml };
+export declare function escapeAltText(text: string): string;
+//#endregion

package/dist/markdown/fromMarkdown.d.ts

@@ -5,6 +5,5 @@ import { document_d_exports } from "../types/document.js";
  * ready to hand to the editor (`<DocxEditor document={…} />`) and to re-export
  * via {@link toMarkdown}.
  */
-declare function fromMarkdown(markdown: string): document_d_exports.Document;
-//#endregion
-export { fromMarkdown };
+export declare function fromMarkdown(markdown: string): document_d_exports.Document;
+//#endregion

package/dist/markdown/images.d.ts

@@ -7,6 +7,5 @@ import { ImageRef, RenderContext } from "./types.js";
  * the existing ref is returned without re-encoding base64 or assigning a new
  * virtual path.
  */
-declare function registerImage(ctx: RenderContext, media: document_d_exports.MediaFile, image: document_d_exports.Image | undefined, paraId: string | undefined): ImageRef;
-//#endregion
-export { registerImage };
+export declare function registerImage(ctx: RenderContext, media: document_d_exports.MediaFile, image: document_d_exports.Image | undefined, paraId: string | undefined): ImageRef;
+//#endregion

package/dist/markdown/index.d.ts

@@ -6,12 +6,12 @@ import { fromMarkdown } from "./fromMarkdown.js";
  * Convert a parsed `Document` to a markdown string. Synchronous; pre-parse the
  * DOCX (e.g. via the editor or `parseDocx`) before calling.
  */
-declare function toMarkdown(doc: document_d_exports.Document, opts?: MarkdownOptions): string;
+export declare function toMarkdown(doc: document_d_exports.Document, opts?: MarkdownOptions): string;
 /**
  * Like {@link toMarkdown}, but also returns the registered images and any
  * non-fatal warnings. Use when post-processing image bytes or surfacing
  * diagnostics; skill bodies only need {@link toMarkdown}.
  */
-declare function toMarkdownResult(doc: document_d_exports.Document, opts?: MarkdownOptions): MarkdownResult;
+export declare function toMarkdownResult(doc: document_d_exports.Document, opts?: MarkdownOptions): MarkdownResult;
 //#endregion
-export { type ImageMeta, type ImageRef, type MarkdownOptions, type MarkdownResult, fromMarkdown, toMarkdown, toMarkdownResult };
+export { type ImageMeta, type ImageRef, type MarkdownOptions, type MarkdownResult, fromMarkdown };

package/dist/markdown/index.js

@@ -1,9 +1,33 @@
+import { withoutExhaustedComments } from "../docx/commentRangeIntegrity.js";
 import { fromMarkdown } from "./fromMarkdown.js";
 import { newContext } from "./internals.js";
 import { renderBlocks } from "./renderBlock.js";
 import { appendTrailers } from "./trailers.js";
 //#region src/markdown/index.ts
 /**
+* DOCX-document → Markdown converter. Ported from eigenpal/docx-editor PR #595,
+* scoped to the synchronous, continuous (non-paged) `Document → string` path
+* that the skills bridge needs. The upstream paged + async + image-handler
+* variants are intentionally not ported (skill bodies have no images today);
+* they can be added later from the same branch.
+*
+* The clean-markdown preset for an AI-facing skill body is:
+*
+* ```ts
+* toMarkdown(doc, {
+*   annotations: "strip",
+*   trackedChanges: "clean",
+*   comments: "strip",
+*   hyperlinks: "inline",
+*   footnotes: "strip",
+* });
+* ```
+*
+* GFM tables are emitted automatically (simple tables → pipe tables; merged or
+* nested cells → inline HTML `<table>`). Headers/footers never appear: they
+* live outside `document.content`, which is the only block stream walked here.
+*/
+/**
 * Convert a parsed `Document` to a markdown string. Synchronous; pre-parse the
 * DOCX (e.g. via the editor or `parseDocx`) before calling.
 */
@@ -19,8 +43,10 @@ function toMarkdownResult(doc, opts) {
 	return renderDocument(doc, opts);
 }
 function renderDocument(doc, opts = {}) {
-	const ctx = newContext(opts, doc.package.styles);
-	const markdown = appendTrailers(ctx, doc, renderBlocks(ctx, doc.package, doc.package.document.content));
+	doc = withoutExhaustedComments(doc);
+	const ctx = newContext(opts, doc.package.styles, doc.package.numbering);
+	const body = renderBlocks(ctx, doc.package, doc.package.document.content);
+	const markdown = appendTrailers(ctx, doc, body);
 	if (doc.warnings) ctx.warnings.unshift(...doc.warnings);
 	if (!markdown.trim()) ctx.warnings.push("document has no content");
 	return {

package/dist/markdown/internals.d.ts

@@ -10,20 +10,19 @@ import { MarkdownOptions, RenderContext } from "./types.js";
  * whether it is a heading or a quote, so rebuilding it per paragraph would
  * make the render quadratic.
  */
-declare function newContext(opts?: MarkdownOptions, styles?: document_d_exports.StyleDefinitions | undefined): RenderContext;
+export declare function newContext(opts?: MarkdownOptions, styles?: document_d_exports.StyleDefinitions | undefined, numberingDefinitions?: document_d_exports.NumberingDefinitions | undefined): RenderContext;
 /**
  * Push a warning into the context, deduplicating against existing entries so
  * recurring messages appear at most once.
  */
-declare function pushWarning(ctx: RenderContext, message: string): void;
+export declare function pushWarning(ctx: RenderContext, message: string): void;
 /**
  * Number a footnote or endnote reference in reading order and record its
  * note for the definitions trailer on the note's first reference. Returns the
  * bare token (`1`, `e1`) and the inline marker (`[^1]`, `[^e1]`).
  */
-declare function numberNoteReference(ctx: RenderContext, kind: NoteReferenceKind, refId: number): {
+export declare function numberNoteReference(ctx: RenderContext, kind: NoteReferenceKind, refId: number): {
   token: string;
   marker: string;
 };
-//#endregion
-export { newContext, numberNoteReference, pushWarning };
+//#endregion

package/dist/markdown/internals.js

@@ -1,4 +1,5 @@
 import { createBuiltInStyleIndex } from "../docx/builtInStyles.js";
+import { getCachedNumberingMap } from "../docx/numberingParser.js";
 import { createListLabelCounter } from "../prosemirror/listLabels.js";
 import { createStyleResolver, resolveStyleParagraphNumbering } from "../prosemirror/styles/styleResolver.js";
 import { createNoteReferenceNumbering, noteReferenceMarker, noteReferenceToken } from "../utils/noteReferenceLabels.js";
@@ -18,7 +19,7 @@ import { createNoteReferenceNumbering, noteReferenceMarker, noteReferenceToken }
 * whether it is a heading or a quote, so rebuilding it per paragraph would
 * make the render quadratic.
 */
-function newContext(opts = {}, styles) {
+function newContext(opts = {}, styles, numberingDefinitions) {
 	const resolver = createStyleResolver(styles);
 	const numbering = /* @__PURE__ */ new Map();
 	return {
@@ -43,7 +44,7 @@ function newContext(opts = {}, styles) {
 		commentRefs: [],
 		hyperlinkRefs: [],
 		imageCounter: 0,
-		nextListLabel: createListLabelCounter(),
+		nextListLabel: createListLabelCounter(numberingDefinitions ? getCachedNumberingMap(numberingDefinitions) : null),
 		listIndentWidths: []
 	};
 }

package/dist/markdown/renderBlock.d.ts

@@ -1,6 +1,5 @@
 import { document_d_exports } from "../types/document.js";
 import { RenderContext } from "./types.js";
 //#region src/markdown/renderBlock.d.ts
-declare function renderBlocks(ctx: RenderContext, pkg: document_d_exports.DocxPackage | undefined, blocks: document_d_exports.BlockContent[]): string;
-//#endregion
-export { renderBlocks };
+export declare function renderBlocks(ctx: RenderContext, pkg: document_d_exports.DocxPackage | undefined, blocks: document_d_exports.BlockContent[]): string;
+//#endregion

package/dist/markdown/renderBlock.js

@@ -54,7 +54,11 @@ function renderBlocks(ctx, pkg, blocks) {
 				};
 			}
 			case "bookmarkStart":
-			case "bookmarkEnd": return { type: "delimiter" };
+			case "bookmarkEnd":
+			case "moveFromRangeStart":
+			case "moveFromRangeEnd":
+			case "moveToRangeStart":
+			case "moveToRangeEnd": return { type: "delimiter" };
 			default: panic(`Unsupported block content in markdown: ${JSON.stringify(block)}`);
 		}
 	};

package/dist/markdown/renderParagraph.d.ts

@@ -5,9 +5,9 @@ import { RenderContext } from "./types.js";
  * Render a paragraph and return the block text. No surrounding blank line: the
  * caller joins blocks.
  */
-declare function renderParagraph(ctx: RenderContext, pkg: document_d_exports.DocxPackage | undefined, para: document_d_exports.Paragraph): string;
+export declare function renderParagraph(ctx: RenderContext, pkg: document_d_exports.DocxPackage | undefined, para: document_d_exports.Paragraph): string;
 /** List items declare the boundary needed to preserve their Markdown structure. */
-type RenderedParagraph = {
+export type RenderedParagraph = {
   type: "paragraph";
   markdown: string;
 } | {
@@ -21,6 +21,5 @@ type RenderedParagraph = {
  * heading, and a level that hides its marker (`w:vanish`) or that its list
  * does not define as prose, as every other reader reads them.
  */
-declare function renderParagraphBlock(ctx: RenderContext, pkg: document_d_exports.DocxPackage | undefined, para: document_d_exports.Paragraph): RenderedParagraph;
-//#endregion
-export { RenderedParagraph, renderParagraph, renderParagraphBlock };
+export declare function renderParagraphBlock(ctx: RenderContext, pkg: document_d_exports.DocxPackage | undefined, para: document_d_exports.Paragraph): RenderedParagraph;
+//#endregion

package/dist/markdown/renderParagraph.js

@@ -1,8 +1,8 @@
 import { isQuoteStyle, resolveHeadingLevel } from "../docx/builtInStyles.js";
-import { resolveCachedListRendering, resolveListRenderingDefinition } from "../docx/listRendering.js";
 import { getCachedNumberingMap } from "../docx/numberingParser.js";
-import { mergeParagraphNumbering } from "../docx/numberingReference.js";
 import { listLabelAttrsFromRendering } from "../prosemirror/listLabels.js";
+import { effectiveParagraphNumberingReference, paragraphNumberingAttr } from "../prosemirror/numberingAttr.js";
+import { resolveParagraphList } from "../prosemirror/paragraphList.js";
 import { inlineBreaksToHtml } from "./escape.js";
 import { renderParagraphInline } from "./renderRuns.js";
 //#region src/markdown/renderParagraph.ts
@@ -21,6 +21,8 @@ import { renderParagraphInline } from "./renderRuns.js";
 */
 /** Markdown has six heading levels; Word has nine. */
 const MAX_MARKDOWN_HEADING_LEVEL = 6;
+/** Explicit projection carried by canonical models that are not attached to a package. */
+const standaloneListRendering = (para) => para.listRendering;
 /**
 * Render a paragraph and return the block text. No surrounding blank line: the
 * caller joins blocks.
@@ -35,26 +37,48 @@ function renderParagraph(ctx, pkg, para) {
 * does not define as prose, as every other reader reads them.
 */
 function renderParagraphBlock(ctx, pkg, para) {
-	const numPrFromStyle = ctx.paragraphNumbering(para.formatting?.styleId) ?? para.formatting?.numPrFromStyle;
-	const numPr = mergeParagraphNumbering(numPrFromStyle, para.formatting?.numPr);
-	let list = para.listRendering;
-	if (numPr?.kind === "none" || pkg?.numbering !== void 0 && numPr === void 0) list = void 0;
-	else if (pkg?.numbering !== void 0 && numPr?.kind === "reference") list = resolveCachedListRendering(para.listRendering, resolveListRenderingDefinition(numPr, getCachedNumberingMap(pkg.numbering))) ?? void 0;
-	const counterAttrs = listLabelAttrsFromRendering(list, {
+	const inherited = ctx.paragraphNumbering(para.formatting?.styleId);
+	const inheritedReference = effectiveParagraphNumberingReference({
+		numPr: void 0,
+		numPrFromStyle: inherited
+	});
+	const sources = {
 		numPr: para.formatting?.numPr,
-		numPrFromStyle
+		numPrFromStyle: para.formatting?.numPrFromStyle
+	};
+	const numbering = pkg?.numbering ? getCachedNumberingMap(pkg.numbering) : null;
+	const resolvedList = resolveParagraphList({
+		...sources,
+		inheritedReference: inheritedReference ?? null
+	}, numbering, standaloneListRendering(para));
+	const resolvedRendering = resolvedList.kind === "marker" ? resolvedList.rendering : void 0;
+	const counterAttrs = listLabelAttrsFromRendering(resolvedRendering, {
+		...sources,
+		numPrFromStyle: resolvedList.kind === "none" ? void 0 : inherited ?? sources.numPrFromStyle
 	});
+	if (sources.numPr === void 0 && sources.numPrFromStyle !== void 0 && inheritedReference === void 0 && para.propertyChanges !== void 0 && para.propertyChanges.length > 0) counterAttrs.numPr = paragraphNumberingAttr({ kind: "none" });
 	if (para.pPrMark) counterAttrs.pPrMark = para.pPrMark;
 	let originalList;
-	if (para.propertyChanges) counterAttrs._propertyChanges = para.propertyChanges.map(({ previousFormatting, ...change }) => {
+	if (para.propertyChanges && ctx.opts.trackedChanges !== "clean") counterAttrs._propertyChanges = para.propertyChanges.map(({ previousFormatting, ...change }) => {
 		if (!previousFormatting) return change;
-		const previousInherited = ctx.paragraphNumbering(previousFormatting.styleId) ?? previousFormatting.numPrFromStyle;
-		const previousNumbering = mergeParagraphNumbering(previousInherited, previousFormatting.numPr);
-		const previousRendering = pkg?.numbering !== void 0 && previousNumbering?.kind === "reference" ? resolveListRenderingDefinition(previousNumbering, getCachedNumberingMap(pkg.numbering)).rendering ?? void 0 : void 0;
+		const previousInherited = ctx.paragraphNumbering(previousFormatting.styleId);
+		const previousInheritedReference = effectiveParagraphNumberingReference({
+			numPr: void 0,
+			numPrFromStyle: previousInherited
+		});
+		const previousSources = {
+			numPr: previousFormatting.numPr,
+			numPrFromStyle: previousFormatting.numPrFromStyle
+		};
+		const previousList = resolveParagraphList({
+			...previousSources,
+			inheritedReference: previousInheritedReference ?? null
+		}, numbering);
+		const previousRendering = previousList.kind === "marker" ? previousList.rendering : void 0;
 		originalList ??= previousRendering;
 		const previousAttrs = listLabelAttrsFromRendering(previousRendering, {
-			numPr: previousFormatting.numPr,
-			numPrFromStyle: previousInherited
+			...previousSources,
+			numPrFromStyle: previousList.kind === "none" ? void 0 : previousInherited ?? previousSources.numPrFromStyle
 		});
 		return {
 			...change,
@@ -66,7 +90,8 @@ function renderParagraphBlock(ctx, pkg, para) {
 			}
 		};
 	});
-	const label = ctx.nextListLabel(counterAttrs);
+	const countedList = ctx.nextListLabel(counterAttrs, resolvedRendering);
+	const label = countedList.kind === "marker" ? countedList.label : void 0;
 	const inline = renderParagraphInline(ctx, pkg, para.content, para.paraId);
 	const styleId = para.formatting?.styleId;
 	const headingLevel = markdownHeadingLevel(ctx, para);
@@ -83,7 +108,7 @@ function renderParagraphBlock(ctx, pkg, para) {
 			type: "paragraph"
 		};
 	}
-	const visibleList = list ?? originalList;
+	const visibleList = resolvedRendering ?? (sources.numPr?.kind === "levelOnly" ? void 0 : originalList);
 	if (visibleList && label !== void 0) return renderListItem(ctx, visibleList, label, inline);
 	ctx.listIndentWidths = [];
 	if (isQuoteStyle(styleId, ctx.builtInStyles)) return {

package/dist/markdown/renderRuns.d.ts

@@ -6,7 +6,7 @@ import { RenderContext } from "./types.js";
  * so the output reads cleanly (`***bold italic***`), not the reverse.
  */
 type MarkKey = "bold" | "italic" | "code" | "strike";
-declare function applyMarks(text: string, marks: readonly MarkKey[]): string;
+export declare function applyMarks(text: string, marks: readonly MarkKey[]): string;
 /**
  * The character beside a run's delimiters: `""` at the paragraph's edge,
  * `undefined` when it cannot be told (read as a letter, the strictest case).
@@ -20,6 +20,6 @@ type RunNeighbors = {
  * Render the full inline content of a paragraph, tracking comment-range
  * boundaries to apply the configured wrapper.
  */
-declare function renderParagraphInline(ctx: RenderContext, pkg: document_d_exports.DocxPackage | undefined, content: readonly document_d_exports.ParagraphContent[], paraId: string | undefined, edges?: RunNeighbors): string;
+export declare function renderParagraphInline(ctx: RenderContext, pkg: document_d_exports.DocxPackage | undefined, content: readonly document_d_exports.ParagraphContent[], paraId: string | undefined, edges?: RunNeighbors): string;
 //#endregion
-export { applyMarks, renderParagraphInline };
+export {};