@stll/folio-core 0.61.0 → 0.63.0

package/dist/managers/FindReplaceManager.js

@@ -1,3 +1,4 @@
+import { replaceEligibility } from "../utils/findReplace.js";
 import { replaceTextInDocument } from "../utils/replaceText.js";
 //#region src/managers/FindReplaceManager.ts
 /**
@@ -34,11 +35,11 @@ var FindReplaceManager = class {
 	* first match. The result is kept even when `matches` is empty so callers can
 	* surface a "no results" state.
 	*/
-	setMatches(matches) {
+	setMatches(matches, currentIndex = 0) {
 		this.result = {
 			matches,
 			totalCount: matches.length,
-			currentIndex: 0
+			currentIndex: Math.max(0, Math.min(currentIndex, matches.length - 1))
 		};
 		return this.result;
 	}
@@ -86,7 +87,7 @@ var FindReplaceManager = class {
 		const result = this.result;
 		if (!result || result.matches.length === 0) return null;
 		const match = result.matches[result.currentIndex];
-		if (!match) return null;
+		if (!match || replaceEligibility(match).status === "blocked") return null;
 		try {
 			return replaceTextInDocument(document, toReplaceRange(match), replaceText);
 		} catch {
@@ -95,26 +96,31 @@ var FindReplaceManager = class {
 	}
 	/**
 	* Replace every match. Matches are replaced from the end of the document
-	* backwards so earlier offsets stay valid as the text shifts. Clears the
-	* active result and returns the new document plus the match count, or null
+	* backwards so earlier offsets stay valid as the text shifts. Ineligible
+	* matches are skipped and counted. Clears the active result, or returns null
 	* when there is nothing to replace.
 	*/
 	replaceAll(document, matches, replaceText) {
 		if (matches.length === 0) return null;
-		const sortedMatches = [...matches].toSorted((a, b) => {
+		const eligibleMatches = matches.filter((match) => replaceEligibility(match).status === "allowed");
+		let skippedCount = matches.length - eligibleMatches.length;
+		let replacedCount = 0;
+		const sortedMatches = [...eligibleMatches].toSorted((a, b) => {
 			if (a.paragraphIndex !== b.paragraphIndex) return b.paragraphIndex - a.paragraphIndex;
 			return b.startOffset - a.startOffset;
 		});
 		let nextDocument = document;
 		for (const match of sortedMatches) try {
 			nextDocument = replaceTextInDocument(nextDocument, toReplaceRange(match), replaceText);
+			replacedCount++;
 		} catch {
-			continue;
+			skippedCount++;
 		}
-		this.result = null;
+		if (replacedCount > 0) this.result = null;
 		return {
 			document: nextDocument,
-			replacedCount: matches.length
+			replacedCount,
+			skippedCount
 		};
 	}
 };

package/dist/managers/HistoryManager.d.ts

@@ -1,7 +1,7 @@
 import { Subscribable } from "./Subscribable.js";
 //#region src/managers/HistoryManager.d.ts
 /** History entry containing state and metadata. */
-type HistoryEntry<T> = {
+export type HistoryEntry<T> = {
   /** The state at this point. */
   state: T;
   /** Timestamp when this entry was created. */
@@ -10,7 +10,7 @@ type HistoryEntry<T> = {
   description?: string;
 };
 /** Reactive snapshot adapters render from. */
-type HistorySnapshot<T> = {
+export type HistorySnapshot<T> = {
   /** Current state. */
   state: T;
   /** Whether undo is available. */
@@ -22,7 +22,7 @@ type HistorySnapshot<T> = {
   /** Number of entries in the redo stack. */
   redoCount: number;
 };
-type HistoryManagerOptions<T> = {
+export type HistoryManagerOptions<T> = {
   /** Maximum number of entries in the undo stack (default: 100). */
   maxEntries?: number;
   /** Time in ms within which rapid pushes are grouped (default: 500). */
@@ -31,11 +31,11 @@ type HistoryManagerOptions<T> = {
   isEqual?: (a: T, b: T) => boolean;
 };
 /** Default equality check using JSON stringify. */
-declare const defaultHistoryIsEqual: <T>(a: T, b: T) => boolean;
+export declare const defaultHistoryIsEqual: <T>(a: T, b: T) => boolean;
 /** History action a keyboard chord maps to. */
-type HistoryShortcut = "undo" | "redo";
+export type HistoryShortcut = "undo" | "redo";
 /** Minimal keyboard-event shape the shortcut classifier reads. */
-type HistoryShortcutEvent = {
+export type HistoryShortcutEvent = {
   key: string;
   ctrlKey: boolean;
   metaKey: boolean;
@@ -49,8 +49,8 @@ type HistoryShortcutEvent = {
  * past an exact `=== "z"` check and never trigger redo. Ctrl/Cmd+Z is undo;
  * Ctrl/Cmd+Shift+Z and Ctrl/Cmd+Y are redo.
  */
-declare const classifyHistoryShortcut: (event: HistoryShortcutEvent) => HistoryShortcut | null;
-declare class HistoryManager<T> extends Subscribable<HistorySnapshot<T>> {
+export declare const classifyHistoryShortcut: (event: HistoryShortcutEvent) => HistoryShortcut | null;
+export declare class HistoryManager<T> extends Subscribable<HistorySnapshot<T>> {
   private currentState;
   private readonly initialState;
   private undoStack;
@@ -98,5 +98,4 @@ declare class HistoryManager<T> extends Subscribable<HistorySnapshot<T>> {
   transformAll(fn: (state: T) => T): void;
   private emit;
 }
-//#endregion
-export { HistoryEntry, HistoryManager, HistoryManagerOptions, HistoryShortcut, HistoryShortcutEvent, HistorySnapshot, classifyHistoryShortcut, defaultHistoryIsEqual };
+//#endregion

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