@stll/folio-core 0.0.1-placeholder.0 → 0.1.0

package/dist/prosemirror/extensions/nodes/TextBoxExtension.d.ts

@@ -0,0 +1,34 @@
+import { document_d_exports } from "../../../types/document.js";
+import { OutlineStyleAttr } from "../../../types/documentEnumValues.js";
+import { NodeExtension } from "../types.js";
+import { ImagePositionAttrs } from "../../schema/nodes.js";
+
+//#region src/prosemirror/extensions/nodes/TextBoxExtension.d.ts
+type TextBoxAttrs = {
+  /** Width in pixels */width?: number; /** Height in pixels */
+  height?: number; /** Unique identifier */
+  textBoxId?: string; /** Fill color as CSS color */
+  fillColor?: string; /** Outline width in pixels */
+  outlineWidth?: number; /** Outline color as CSS color */
+  outlineColor?: string; /** Outline dash style, or `"none"` for an explicit no-outline. */
+  outlineStyle?: OutlineStyleAttr; /** Internal margin top in pixels */
+  marginTop?: number; /** Internal margin bottom in pixels */
+  marginBottom?: number; /** Internal margin left in pixels */
+  marginLeft?: number; /** Internal margin right in pixels */
+  marginRight?: number; /** Vertical text alignment */
+  verticalAlign?: string; /** Display mode */
+  displayMode?: "inline" | "float" | "block"; /** CSS float direction */
+  cssFloat?: "left" | "right" | "none"; /** Wrap type */
+  wrapType?: document_d_exports.ImageWrap["type"]; /** OOXML wrapText direction for anchored text boxes (eigenpal #474). */
+  wrapText?: "bothSides" | "left" | "right" | "largest"; /** Wrap distance from top edge, in pixels (OOXML distT, EMU-converted). */
+  distTop?: number; /** Wrap distance from bottom edge, in pixels. */
+  distBottom?: number; /** Wrap distance from left edge, in pixels. */
+  distLeft?: number; /** Wrap distance from right edge, in pixels. */
+  distRight?: number; /** Position for floating/anchored text boxes. */
+  position?: ImagePositionAttrs; /** Original DOCX placement hint for save-path reconstruction. */
+  _docxPlacement?: "standalone" | "inlineWithPrevious"; /** Original DOCX paragraph group for standalone text-box reconstruction. */
+  _docxGroupId?: string;
+};
+declare const TextBoxExtension: (options?: Partial<Record<string, unknown>> | undefined) => NodeExtension;
+//#endregion
+export { TextBoxAttrs, TextBoxExtension };

package/dist/prosemirror/extensions/nodes/TextBoxExtension.js

@@ -0,0 +1,150 @@
+import { IMAGE_WRAP_TYPE_VALUES } from "../../../types/documentEnumValues.js";
+import { expectTextBoxAttrs } from "../../attrs/index.js";
+import { createNodeExtension } from "../create.js";
+//#region src/prosemirror/extensions/nodes/TextBoxExtension.ts
+function parseTextBoxPosition(raw) {
+	if (!raw) return;
+	try {
+		const parsed = JSON.parse(raw);
+		if (typeof parsed !== "object" || parsed === null) return;
+		return parsed;
+	} catch {
+		return;
+	}
+}
+function parseTextBoxWrapType(raw) {
+	for (const value of IMAGE_WRAP_TYPE_VALUES) if (value === raw) return value;
+}
+const TextBoxExtension = createNodeExtension({
+	name: "textBox",
+	schemaNodeName: "textBox",
+	nodeSpec: {
+		group: "block",
+		content: "(paragraph | table)+",
+		isolating: true,
+		draggable: true,
+		attrs: {
+			width: { default: 200 },
+			height: { default: null },
+			textBoxId: { default: null },
+			fillColor: { default: null },
+			outlineWidth: { default: null },
+			outlineColor: { default: null },
+			outlineStyle: { default: null },
+			marginTop: { default: 4 },
+			marginBottom: { default: 4 },
+			marginLeft: { default: 7 },
+			marginRight: { default: 7 },
+			verticalAlign: { default: null },
+			displayMode: { default: "inline" },
+			cssFloat: { default: null },
+			wrapType: { default: "inline" },
+			wrapText: { default: null },
+			distTop: { default: null },
+			distBottom: { default: null },
+			distLeft: { default: null },
+			distRight: { default: null },
+			position: { default: null },
+			_docxPlacement: { default: null },
+			_docxGroupId: { default: null }
+		},
+		parseDOM: [{
+			tag: "div.docx-textbox",
+			getAttrs(dom) {
+				if (!(dom instanceof HTMLElement)) return false;
+				const d = dom.dataset;
+				const position = parseTextBoxPosition(d["position"]);
+				const wrapType = parseTextBoxWrapType(d["wrapType"]);
+				return {
+					...d["width"] ? { width: Number(d["width"]) } : {},
+					...d["height"] ? { height: Number(d["height"]) } : {},
+					...d["textboxId"] ? { textBoxId: d["textboxId"] } : {},
+					...d["fillColor"] ? { fillColor: d["fillColor"] } : {},
+					...d["outlineWidth"] ? { outlineWidth: Number(d["outlineWidth"]) } : {},
+					...d["outlineColor"] ? { outlineColor: d["outlineColor"] } : {},
+					...d["outlineStyle"] ? { outlineStyle: d["outlineStyle"] } : {},
+					...d["marginTop"] ? { marginTop: Number(d["marginTop"]) } : {},
+					...d["marginBottom"] ? { marginBottom: Number(d["marginBottom"]) } : {},
+					...d["marginLeft"] ? { marginLeft: Number(d["marginLeft"]) } : {},
+					...d["marginRight"] ? { marginRight: Number(d["marginRight"]) } : {},
+					...d["verticalAlign"] ? { verticalAlign: d["verticalAlign"] } : {},
+					...d["displayMode"] ? { displayMode: d["displayMode"] } : {},
+					...d["cssFloat"] ? { cssFloat: d["cssFloat"] } : {},
+					...wrapType ? { wrapType } : {},
+					...d["wrapText"] ? { wrapText: d["wrapText"] } : {},
+					...d["distTop"] ? { distTop: Number(d["distTop"]) } : {},
+					...d["distBottom"] ? { distBottom: Number(d["distBottom"]) } : {},
+					...d["distLeft"] ? { distLeft: Number(d["distLeft"]) } : {},
+					...d["distRight"] ? { distRight: Number(d["distRight"]) } : {},
+					...position ? { position } : {}
+				};
+			}
+		}],
+		toDOM(node) {
+			const attrs = expectTextBoxAttrs(node);
+			const domAttrs = { class: "docx-textbox" };
+			if (attrs.width) domAttrs["data-width"] = String(attrs.width);
+			if (attrs.height) domAttrs["data-height"] = String(attrs.height);
+			if (attrs.textBoxId) domAttrs["data-textbox-id"] = attrs.textBoxId;
+			if (attrs.fillColor) domAttrs["data-fill-color"] = attrs.fillColor;
+			if (attrs.outlineWidth) domAttrs["data-outline-width"] = String(attrs.outlineWidth);
+			if (attrs.outlineColor) domAttrs["data-outline-color"] = attrs.outlineColor;
+			if (attrs.outlineStyle) domAttrs["data-outline-style"] = attrs.outlineStyle;
+			if (typeof attrs.marginTop === "number") domAttrs["data-margin-top"] = String(attrs.marginTop);
+			if (typeof attrs.marginBottom === "number") domAttrs["data-margin-bottom"] = String(attrs.marginBottom);
+			if (typeof attrs.marginLeft === "number") domAttrs["data-margin-left"] = String(attrs.marginLeft);
+			if (typeof attrs.marginRight === "number") domAttrs["data-margin-right"] = String(attrs.marginRight);
+			if (attrs.verticalAlign) domAttrs["data-vertical-align"] = attrs.verticalAlign;
+			if (attrs.displayMode) domAttrs["data-display-mode"] = attrs.displayMode;
+			if (attrs.cssFloat) domAttrs["data-css-float"] = attrs.cssFloat;
+			if (attrs.wrapType) domAttrs["data-wrap-type"] = attrs.wrapType;
+			if (attrs.wrapText) domAttrs["data-wrap-text"] = attrs.wrapText;
+			if (typeof attrs.distTop === "number") domAttrs["data-dist-top"] = String(attrs.distTop);
+			if (typeof attrs.distBottom === "number") domAttrs["data-dist-bottom"] = String(attrs.distBottom);
+			if (typeof attrs.distLeft === "number") domAttrs["data-dist-left"] = String(attrs.distLeft);
+			if (typeof attrs.distRight === "number") domAttrs["data-dist-right"] = String(attrs.distRight);
+			if (attrs.position) domAttrs["data-position"] = JSON.stringify(attrs.position);
+			const styles = [];
+			if (attrs.width) styles.push(`width: ${attrs.width}px`);
+			if (attrs.height) styles.push(`min-height: ${attrs.height}px`);
+			if (attrs.fillColor) styles.push(`background-color: ${attrs.fillColor}`);
+			if (attrs.outlineWidth && attrs.outlineWidth > 0) {
+				const style = attrs.outlineStyle || "solid";
+				const color = attrs.outlineColor || "#000000";
+				styles.push(`border: ${attrs.outlineWidth}px ${style} ${color}`);
+			} else if (attrs.outlineStyle !== "none") styles.push("border: 1px solid var(--doc-border, #d1d5db)");
+			const mt = attrs.marginTop ?? 4;
+			const mb = attrs.marginBottom ?? 4;
+			const ml = attrs.marginLeft ?? 7;
+			const mr = attrs.marginRight ?? 7;
+			styles.push(`padding: ${mt}px ${mr}px ${mb}px ${ml}px`);
+			if (attrs.verticalAlign === "middle" || attrs.verticalAlign === "center") {
+				styles.push("display: flex");
+				styles.push("flex-direction: column");
+				styles.push("justify-content: center");
+			} else if (attrs.verticalAlign === "bottom") {
+				styles.push("display: flex");
+				styles.push("flex-direction: column");
+				styles.push("justify-content: flex-end");
+			}
+			if (attrs.displayMode === "float" && attrs.cssFloat && attrs.cssFloat !== "none") {
+				styles.push(`float: ${attrs.cssFloat}`);
+				styles.push("margin: 4px 8px");
+			} else if (attrs.displayMode === "block") {
+				styles.push("margin-left: auto");
+				styles.push("margin-right: auto");
+			}
+			styles.push("box-sizing: border-box");
+			styles.push("overflow: hidden");
+			styles.push("position: relative");
+			domAttrs["style"] = styles.join("; ");
+			return [
+				"div",
+				domAttrs,
+				0
+			];
+		}
+	}
+});
+//#endregion
+export { TextBoxExtension };

package/dist/prosemirror/extensions/types.d.ts

@@ -0,0 +1,101 @@
+import { Command, Plugin } from "prosemirror-state";
+import { MarkSpec, NodeSpec, Schema } from "prosemirror-model";
+
+//#region src/prosemirror/extensions/types.d.ts
+type ExtensionPriority = number;
+declare const Priority: {
+  readonly Highest: 0;
+  readonly High: 50;
+  readonly Default: 100;
+  readonly Low: 150;
+  readonly Lowest: 200;
+};
+type ExtensionContext = {
+  schema: Schema;
+};
+type CommandMap = Record<string, (...args: any[]) => Command>;
+type KeyboardShortcutMap = Record<string, Command>;
+type ExtensionRuntime = {
+  commands?: CommandMap;
+  keyboardShortcuts?: KeyboardShortcutMap;
+  plugins?: Plugin[];
+};
+type ExtensionConfig = {
+  name: string;
+  priority: ExtensionPriority;
+  options: Record<string, unknown>;
+};
+type NodeExtensionConfig = {
+  schemaNodeName: string;
+  nodeSpec: NodeSpec;
+} & ExtensionConfig;
+type MarkExtensionConfig = {
+  schemaMarkName: string;
+  markSpec: MarkSpec;
+} & ExtensionConfig;
+type Extension = {
+  type: "extension";
+  config: ExtensionConfig;
+  onSchemaReady: (ctx: ExtensionContext) => ExtensionRuntime;
+};
+type NodeExtension = {
+  type: "node";
+  config: NodeExtensionConfig;
+  onSchemaReady: (ctx: ExtensionContext) => ExtensionRuntime;
+};
+type MarkExtension = {
+  type: "mark";
+  config: MarkExtensionConfig;
+  onSchemaReady: (ctx: ExtensionContext) => ExtensionRuntime;
+};
+type AnyExtension = Extension | NodeExtension | MarkExtension;
+type ExtensionOptions = Record<string, unknown>;
+type ExtensionDefinitionWithDefaults<TOptions extends ExtensionOptions> = {
+  name: string;
+  priority?: ExtensionPriority;
+  defaultOptions: TOptions;
+  onSchemaReady: (ctx: ExtensionContext, options: TOptions) => ExtensionRuntime;
+};
+type ExtensionDefinitionWithoutDefaults<TOptions extends ExtensionOptions = ExtensionOptions> = {
+  name: string;
+  priority?: ExtensionPriority;
+  defaultOptions?: undefined;
+  onSchemaReady: (ctx: ExtensionContext, options: Partial<TOptions>) => ExtensionRuntime;
+};
+type ExtensionDefinition<TOptions extends ExtensionOptions = ExtensionOptions> = ExtensionDefinitionWithDefaults<TOptions> | ExtensionDefinitionWithoutDefaults<TOptions>;
+type NodeExtensionDefinitionWithDefaults<TOptions extends ExtensionOptions> = {
+  name: string;
+  priority?: ExtensionPriority;
+  defaultOptions: TOptions;
+  schemaNodeName: string;
+  nodeSpec: NodeSpec | ((options: TOptions) => NodeSpec);
+  onSchemaReady?: (ctx: ExtensionContext, options: TOptions) => ExtensionRuntime;
+};
+type NodeExtensionDefinitionWithoutDefaults<TOptions extends ExtensionOptions = ExtensionOptions> = {
+  name: string;
+  priority?: ExtensionPriority;
+  defaultOptions?: undefined;
+  schemaNodeName: string;
+  nodeSpec: NodeSpec | ((options: Partial<TOptions>) => NodeSpec);
+  onSchemaReady?: (ctx: ExtensionContext, options: Partial<TOptions>) => ExtensionRuntime;
+};
+type NodeExtensionDefinition<TOptions extends ExtensionOptions = ExtensionOptions> = NodeExtensionDefinitionWithDefaults<TOptions> | NodeExtensionDefinitionWithoutDefaults<TOptions>;
+type MarkExtensionDefinitionWithDefaults<TOptions extends ExtensionOptions> = {
+  name: string;
+  priority?: ExtensionPriority;
+  defaultOptions: TOptions;
+  schemaMarkName: string;
+  markSpec: MarkSpec | ((options: TOptions) => MarkSpec);
+  onSchemaReady?: (ctx: ExtensionContext, options: TOptions) => ExtensionRuntime;
+};
+type MarkExtensionDefinitionWithoutDefaults<TOptions extends ExtensionOptions = ExtensionOptions> = {
+  name: string;
+  priority?: ExtensionPriority;
+  defaultOptions?: undefined;
+  schemaMarkName: string;
+  markSpec: MarkSpec | ((options: Partial<TOptions>) => MarkSpec);
+  onSchemaReady?: (ctx: ExtensionContext, options: Partial<TOptions>) => ExtensionRuntime;
+};
+type MarkExtensionDefinition<TOptions extends ExtensionOptions = ExtensionOptions> = MarkExtensionDefinitionWithDefaults<TOptions> | MarkExtensionDefinitionWithoutDefaults<TOptions>;
+//#endregion
+export { AnyExtension, CommandMap, Extension, ExtensionConfig, ExtensionContext, ExtensionDefinition, ExtensionPriority, ExtensionRuntime, KeyboardShortcutMap, MarkExtension, MarkExtensionConfig, MarkExtensionDefinition, NodeExtension, NodeExtensionConfig, NodeExtensionDefinition, Priority };

package/dist/prosemirror/extensions/types.js

@@ -0,0 +1,10 @@
+//#region src/prosemirror/extensions/types.ts
+const Priority = {
+	Highest: 0,
+	High: 50,
+	Default: 100,
+	Low: 150,
+	Lowest: 200
+};
+//#endregion
+export { Priority };

package/dist/prosemirror/findReplaceSelection.d.ts

@@ -0,0 +1,23 @@
+import { Node } from "prosemirror-model";
+
+//#region src/prosemirror/findReplaceSelection.d.ts
+/**
+ * Positional fields of a document search match that the range resolver needs.
+ *
+ * The React find-replace producer carries a richer match shape (content index,
+ * matched text) for its UI; resolution only consumes the paragraph-relative
+ * offsets, so this declares exactly that subset and keeps core free of any
+ * adapter-side type.
+ */
+type FindMatchPosition = {
+  /** Index of the paragraph containing the match. */paragraphIndex: number; /** Character offset of the match start within the paragraph. */
+  startOffset: number; /** Character offset of the match end within the paragraph. */
+  endOffset: number;
+};
+type FindMatchRange = {
+  from: number;
+  to: number;
+};
+declare function resolveFindMatchRange(doc: Node, match: FindMatchPosition): FindMatchRange | null;
+//#endregion
+export { FindMatchPosition, FindMatchRange, resolveFindMatchRange };

package/dist/prosemirror/findReplaceSelection.js

@@ -0,0 +1,86 @@
+//#region src/prosemirror/findReplaceSelection.ts
+function resolveFindMatchRange(doc, match) {
+	let paragraphIndex = 0;
+	let resolved = null;
+	const visitParagraph = (node, pos) => {
+		if (resolved) return false;
+		if (paragraphIndex !== match.paragraphIndex) {
+			paragraphIndex++;
+			return true;
+		}
+		resolved = resolveTextRangeInParagraph({
+			paragraph: node,
+			paragraphPos: pos,
+			startOffset: match.startOffset,
+			endOffset: match.endOffset
+		});
+		return false;
+	};
+	const walkBlocks = (container, contentStart) => {
+		let offset = 0;
+		for (let childIndex = 0; childIndex < container.childCount; childIndex++) {
+			const child = container.child(childIndex);
+			const childPos = contentStart + offset;
+			if (child.type.name === "paragraph") {
+				if (!visitParagraph(child, childPos)) return false;
+			} else if (child.type.name === "table" && !walkTable(child, childPos)) return false;
+			offset += child.nodeSize;
+		}
+		return true;
+	};
+	const walkTable = (table, tablePos) => {
+		let rowOffset = 0;
+		for (let rowIndex = 0; rowIndex < table.childCount; rowIndex++) {
+			const row = table.child(rowIndex);
+			if (row.type.name !== "tableRow") {
+				rowOffset += row.nodeSize;
+				continue;
+			}
+			const rowPos = tablePos + 1 + rowOffset;
+			let cellOffset = 0;
+			for (let cellIndex = 0; cellIndex < row.childCount; cellIndex++) {
+				const cell = row.child(cellIndex);
+				if (cell.type.name !== "tableCell" && cell.type.name !== "tableHeader") {
+					cellOffset += cell.nodeSize;
+					continue;
+				}
+				if (!walkBlocks(cell, rowPos + 1 + cellOffset + 1)) return false;
+				cellOffset += cell.nodeSize;
+			}
+			rowOffset += row.nodeSize;
+		}
+		return true;
+	};
+	walkBlocks(doc, 0);
+	return resolved;
+}
+function resolveTextRangeInParagraph({ paragraph, paragraphPos, startOffset, endOffset }) {
+	let textOffset = 0;
+	const range = {
+		from: null,
+		to: null
+	};
+	paragraph.descendants((node, pos) => {
+		const tokenLength = getSearchTextTokenLength(node);
+		if (tokenLength === 0) return true;
+		const textStart = textOffset;
+		const textEnd = textStart + tokenLength;
+		const nodeStart = paragraphPos + 1 + pos;
+		if (range.from === null && startOffset >= textStart && startOffset <= textEnd) range.from = nodeStart + Math.min(startOffset - textStart, node.nodeSize);
+		if (range.to === null && endOffset >= textStart && endOffset <= textEnd) range.to = nodeStart + Math.min(endOffset - textStart, node.nodeSize);
+		textOffset = textEnd;
+		return range.to === null;
+	});
+	if (range.from === null || range.to === null || range.from >= range.to) return null;
+	return {
+		from: range.from,
+		to: range.to
+	};
+}
+function getSearchTextTokenLength(node) {
+	if (node.isText) return node.text?.length ?? 0;
+	if (node.type.name === "tab" || node.type.name === "hardBreak") return 1;
+	return 0;
+}
+//#endregion
+export { resolveFindMatchRange };

package/dist/prosemirror/index.d.ts

@@ -0,0 +1,25 @@
+import { ImageAttrs, ParagraphAttrs } from "./schema/nodes.js";
+import { FontFamilyAttrs, FontSizeAttrs, HyperlinkAttrs, TextColorAttrs, UnderlineAttrs } from "./schema/marks.js";
+import { schema, singletonManager } from "./schema/index.js";
+import { PAINTABLE_MARK_NAMES, applyFormatMarks, captureFormatMarks } from "./commands/formatPainter.js";
+import { clearFormatting, getMarkAttr, isMarkActive } from "./extensions/marks/markUtils.js";
+import { getHyperlinkAttrs, getSelectedText, isHyperlinkActive } from "./extensions/marks/HyperlinkExtension.js";
+import { clearFontFamily, clearFontSize, clearHighlight, clearTextColor, insertHyperlink, removeHyperlink, setFontFamily, setFontSize, setHighlight, setHyperlink, setTextColor, toggleBold, toggleItalic, toggleStrike, toggleSubscript, toggleSuperscript, toggleUnderline } from "./commands/formatting.js";
+import { insertImageFromFile } from "./commands/image.js";
+import { getParagraphAlignment, getParagraphBidi, getStyleId } from "./extensions/core/ParagraphExtension.js";
+import { getListInfo, isInList } from "./extensions/features/ListExtension.js";
+import { addTabStop, alignCenter, alignJustify, alignLeft, alignRight, applyStyle, clearStyle, decreaseIndent, decreaseListLevel, generateTOC, increaseIndent, increaseListLevel, removeList, removeTabStop, setAlignment, setIndentFirstLine, setIndentLeft, setIndentRight, setLineSpacing, setLtr, setRtl, toggleBidi, toggleBulletList, toggleNumberedList } from "./commands/paragraph.js";
+import { BorderPreset, TableBorderPreset, TableContextInfo, getTableContext, isInTable as isInTableCell } from "./extensions/nodes/TableExtension.js";
+import { addColumnLeft, addColumnRight, addRowAbove, addRowBelow, applyTableStyle, autoFitContents, deleteColumn, deleteRow, deleteTable, distributeColumns, insertTable, mergeCells, removeTableBorders, selectColumn, selectRow, selectTable, setAllTableBorders, setCellBorder, setCellFillColor, setCellMargins, setCellTextDirection, setCellVerticalAlign, setInsideTableBorders, setOutsideTableBorders, setRowHeight, setTableBorderColor, setTableBorderPreset, setTableBorderWidth, setTableBorders, setTableProperties, splitCell, toggleHeaderRow, toggleNoWrap } from "./commands/table.js";
+import { insertPageBreak } from "./commands/pageBreak.js";
+import { fromProseDoc, updateDocumentContent } from "./conversion/fromProseDoc.js";
+import { ToProseDocOptions, createEmptyDoc, toProseDoc } from "./conversion/toProseDoc.js";
+import { ProseMirrorDocumentValidationIssue, ValidateProseMirrorDocumentResult, assertValidProseMirrorDocument, formatProseMirrorDocumentIssues, validateProseMirrorDocument } from "./validation.js";
+import { SelectionChangeCallback, SelectionContext, createSelectionTrackerPlugin, extractSelectionContext, getSelectionContext, selectionTrackerKey } from "./plugins/selectionTracker.js";
+import { ensureParaIdsInState } from "./extensions/features/ParaIdAllocatorExtension.js";
+import { ResolvedParagraphStyle, StyleResolver, createStyleResolver } from "./styles/styleResolver.js";
+import { SelectionState, extractSelectionState } from "./selectionState.js";
+import { createDocumentStylesPlugin, documentStylesKey, getDocumentStyleResolver } from "./plugins/documentStyles.js";
+import { insertPageBreakInView, insertTableInView, insertTableOfContentsInView } from "./insertOperations.js";
+import { TextSelection } from "prosemirror-state";
+export { type BorderPreset, type FontFamilyAttrs, type FontSizeAttrs, type HyperlinkAttrs, type ImageAttrs, PAINTABLE_MARK_NAMES, type ParagraphAttrs, type ProseMirrorDocumentValidationIssue, type ResolvedParagraphStyle, type SelectionChangeCallback, type SelectionContext, type SelectionState, StyleResolver, type TableBorderPreset, type TableContextInfo, type TextColorAttrs, TextSelection, type ToProseDocOptions, type UnderlineAttrs, type ValidateProseMirrorDocumentResult, addColumnLeft, addColumnRight, addRowAbove, addRowBelow, addTabStop, alignCenter, alignJustify, alignLeft, alignRight, applyFormatMarks, applyStyle, applyTableStyle, assertValidProseMirrorDocument, autoFitContents, captureFormatMarks, clearFontFamily, clearFontSize, clearFormatting, clearHighlight, clearStyle, clearTextColor, createDocumentStylesPlugin, createEmptyDoc, createSelectionTrackerPlugin, createStyleResolver, decreaseIndent, decreaseListLevel, deleteColumn, deleteRow, deleteTable, distributeColumns, documentStylesKey, ensureParaIdsInState, extractSelectionContext, extractSelectionState, formatProseMirrorDocumentIssues, fromProseDoc, generateTOC, getDocumentStyleResolver, getHyperlinkAttrs, getListInfo, getMarkAttr, getParagraphAlignment, getParagraphBidi, getSelectedText, getSelectionContext, getStyleId, getTableContext, increaseIndent, increaseListLevel, insertHyperlink, insertImageFromFile, insertPageBreak, insertPageBreakInView, insertTable, insertTableInView, insertTableOfContentsInView, isHyperlinkActive, isInList, isInTableCell as isInTable, isMarkActive, mergeCells, removeHyperlink, removeList, removeTabStop, removeTableBorders, schema, selectColumn, selectRow, selectTable, selectionTrackerKey, setAlignment, setAllTableBorders, setCellBorder, setCellFillColor, setCellMargins, setCellTextDirection, setCellVerticalAlign, setFontFamily, setFontSize, setHighlight, setHyperlink, setIndentFirstLine, setIndentLeft, setIndentRight, setInsideTableBorders, setLineSpacing, setLtr, setOutsideTableBorders, setRowHeight, setRtl, setTableBorderColor, setTableBorderPreset, setTableBorderWidth, setTableBorders, setTableProperties, setTextColor, singletonManager, splitCell, toProseDoc, toggleBidi, toggleBold, toggleBulletList, toggleHeaderRow, toggleItalic, toggleNoWrap, toggleNumberedList, toggleStrike, toggleSubscript, toggleSuperscript, toggleUnderline, updateDocumentContent, validateProseMirrorDocument };

package/dist/prosemirror/index.js

@@ -0,0 +1,23 @@
+import { assertValidProseMirrorDocument, formatProseMirrorDocumentIssues, validateProseMirrorDocument } from "./validation.js";
+import { fromProseDoc, updateDocumentContent } from "./conversion/fromProseDoc.js";
+import { StyleResolver, createStyleResolver } from "./styles/styleResolver.js";
+import { getParagraphAlignment, getParagraphBidi, getStyleId } from "./extensions/core/ParagraphExtension.js";
+import { createDocumentStylesPlugin, documentStylesKey, getDocumentStyleResolver } from "./plugins/documentStyles.js";
+import { clearFormatting, getMarkAttr, isMarkActive } from "./extensions/marks/markUtils.js";
+import { getTableContext, isInTable as isInTableCell } from "./extensions/nodes/TableExtension.js";
+import { getListInfo, isInList } from "./extensions/features/ListExtension.js";
+import { ensureParaIdsInState } from "./extensions/features/ParaIdAllocatorExtension.js";
+import { createSelectionTrackerPlugin, extractSelectionContext, getSelectionContext, selectionTrackerKey } from "./plugins/selectionTracker.js";
+import { getHyperlinkAttrs, getSelectedText, isHyperlinkActive } from "./extensions/marks/HyperlinkExtension.js";
+import { schema, singletonManager } from "./schema/index.js";
+import { createEmptyDoc, toProseDoc } from "./conversion/toProseDoc.js";
+import { addColumnLeft, addColumnRight, addRowAbove, addRowBelow, applyTableStyle, autoFitContents, deleteColumn, deleteRow, deleteTable, distributeColumns, insertTable, mergeCells, removeTableBorders, selectColumn, selectRow, selectTable, setAllTableBorders, setCellBorder, setCellFillColor, setCellMargins, setCellTextDirection, setCellVerticalAlign, setInsideTableBorders, setOutsideTableBorders, setRowHeight, setTableBorderColor, setTableBorderPreset, setTableBorderWidth, setTableBorders, setTableProperties, splitCell, toggleHeaderRow, toggleNoWrap } from "./commands/table.js";
+import { extractSelectionState } from "./selectionState.js";
+import { clearFontFamily, clearFontSize, clearHighlight, clearTextColor, insertHyperlink, removeHyperlink, setFontFamily, setFontSize, setHighlight, setHyperlink, setTextColor, toggleBold, toggleItalic, toggleStrike, toggleSubscript, toggleSuperscript, toggleUnderline } from "./commands/formatting.js";
+import { addTabStop, alignCenter, alignJustify, alignLeft, alignRight, applyStyle, clearStyle, decreaseIndent, decreaseListLevel, generateTOC, increaseIndent, increaseListLevel, removeList, removeTabStop, setAlignment, setIndentFirstLine, setIndentLeft, setIndentRight, setLineSpacing, setLtr, setRtl, toggleBidi, toggleBulletList, toggleNumberedList } from "./commands/paragraph.js";
+import { PAINTABLE_MARK_NAMES, applyFormatMarks, captureFormatMarks } from "./commands/formatPainter.js";
+import { insertPageBreak } from "./commands/pageBreak.js";
+import { insertImageFromFile } from "./commands/image.js";
+import { insertPageBreakInView, insertTableInView, insertTableOfContentsInView } from "./insertOperations.js";
+import { TextSelection } from "prosemirror-state";
+export { PAINTABLE_MARK_NAMES, StyleResolver, TextSelection, addColumnLeft, addColumnRight, addRowAbove, addRowBelow, addTabStop, alignCenter, alignJustify, alignLeft, alignRight, applyFormatMarks, applyStyle, applyTableStyle, assertValidProseMirrorDocument, autoFitContents, captureFormatMarks, clearFontFamily, clearFontSize, clearFormatting, clearHighlight, clearStyle, clearTextColor, createDocumentStylesPlugin, createEmptyDoc, createSelectionTrackerPlugin, createStyleResolver, decreaseIndent, decreaseListLevel, deleteColumn, deleteRow, deleteTable, distributeColumns, documentStylesKey, ensureParaIdsInState, extractSelectionContext, extractSelectionState, formatProseMirrorDocumentIssues, fromProseDoc, generateTOC, getDocumentStyleResolver, getHyperlinkAttrs, getListInfo, getMarkAttr, getParagraphAlignment, getParagraphBidi, getSelectedText, getSelectionContext, getStyleId, getTableContext, increaseIndent, increaseListLevel, insertHyperlink, insertImageFromFile, insertPageBreak, insertPageBreakInView, insertTable, insertTableInView, insertTableOfContentsInView, isHyperlinkActive, isInList, isInTableCell as isInTable, isMarkActive, mergeCells, removeHyperlink, removeList, removeTabStop, removeTableBorders, schema, selectColumn, selectRow, selectTable, selectionTrackerKey, setAlignment, setAllTableBorders, setCellBorder, setCellFillColor, setCellMargins, setCellTextDirection, setCellVerticalAlign, setFontFamily, setFontSize, setHighlight, setHyperlink, setIndentFirstLine, setIndentLeft, setIndentRight, setInsideTableBorders, setLineSpacing, setLtr, setOutsideTableBorders, setRowHeight, setRtl, setTableBorderColor, setTableBorderPreset, setTableBorderWidth, setTableBorders, setTableProperties, setTextColor, singletonManager, splitCell, toProseDoc, toggleBidi, toggleBold, toggleBulletList, toggleHeaderRow, toggleItalic, toggleNoWrap, toggleNumberedList, toggleStrike, toggleSubscript, toggleSuperscript, toggleUnderline, updateDocumentContent, validateProseMirrorDocument };

package/dist/prosemirror/insertOperations.d.ts

@@ -0,0 +1,12 @@
+import { insertImageFromFile } from "./commands/image.js";
+import { EditorView } from "prosemirror-view";
+
+//#region src/prosemirror/insertOperations.d.ts
+/** Insert a `rows × columns` table at the current selection. */
+declare function insertTableInView(view: EditorView, rows: number, columns: number): boolean;
+/** Insert a page break at the current selection. */
+declare function insertPageBreakInView(view: EditorView): boolean;
+/** Generate (or refresh) a table of contents from the document's headings. */
+declare function insertTableOfContentsInView(view: EditorView): boolean;
+//#endregion
+export { insertImageFromFile, insertPageBreakInView, insertTableInView, insertTableOfContentsInView };

package/dist/prosemirror/insertOperations.js

@@ -0,0 +1,19 @@
+import { insertTable } from "./commands/table.js";
+import { generateTOC } from "./commands/paragraph.js";
+import { insertPageBreak } from "./commands/pageBreak.js";
+import { insertImageFromFile } from "./commands/image.js";
+//#region src/prosemirror/insertOperations.ts
+/** Insert a `rows × columns` table at the current selection. */
+function insertTableInView(view, rows, columns) {
+	return insertTable(rows, columns)(view.state, view.dispatch);
+}
+/** Insert a page break at the current selection. */
+function insertPageBreakInView(view) {
+	return insertPageBreak(view.state, view.dispatch);
+}
+/** Generate (or refresh) a table of contents from the document's headings. */
+function insertTableOfContentsInView(view) {
+	return generateTOC(view.state, view.dispatch);
+}
+//#endregion
+export { insertImageFromFile, insertPageBreakInView, insertTableInView, insertTableOfContentsInView };

package/dist/prosemirror/paragraphDirection.d.ts

@@ -0,0 +1,42 @@
+//#region src/prosemirror/paragraphDirection.d.ts
+/**
+ * Paragraph base-direction modeled as a discriminated union.
+ *
+ * Replaces the prior `bidi` + `bidiAuto` PM-attribute flag pair, where
+ * combinations such as "auto + ltr" or "auto + undecided" were representable
+ * but never valid. The states are now mutually exclusive:
+ *
+ *   - absent (`null`/`undefined`): undecided — default LTR, eligible for
+ *     auto-detection.
+ *   - `{ source: "auto" }`: auto-detected RTL; re-evaluated as content changes.
+ *   - `{ source: "manual"; value }`: an explicit user toggle or imported
+ *     `w:bidi`; authoritative, never auto-revisited.
+ *
+ * The persisted/serialized model keeps the flat OOXML tri-state
+ * (`ParagraphFormatting.bidi: boolean | undefined`); `directionToBidi` /
+ * `directionFromBidi` bridge the two at the conversion boundary.
+ */
+type ParagraphDirection = {
+  source: "auto";
+} | {
+  source: "manual";
+  value: "rtl" | "ltr";
+};
+/** Whether the paragraph lays out and exports right-to-left. */
+declare const directionIsRtl: (direction: ParagraphDirection | null | undefined) => boolean;
+/**
+ * Auto-managed paragraphs (undecided, or previously auto-set) are the ones
+ * AutoBidiDetection may (re-)evaluate. A manual decision is left untouched.
+ */
+declare const directionIsAutoManaged: (direction: ParagraphDirection | null | undefined) => boolean;
+/** Map a direction to the serialized OOXML `w:bidi` tri-state. */
+declare const directionToBidi: (direction: ParagraphDirection | null | undefined) => boolean | undefined;
+/**
+ * Reconstruct a direction from a model `bidi` value (DOCX import / load): an
+ * explicit `true`/`false` is a manual decision, absence is undecided.
+ */
+declare const directionFromBidi: (bidi: boolean | null | undefined) => ParagraphDirection | null;
+/** Runtime guard for the PM attribute validator. */
+declare const isParagraphDirection: (value: unknown) => value is ParagraphDirection;
+//#endregion
+export { ParagraphDirection, directionFromBidi, directionIsAutoManaged, directionIsRtl, directionToBidi, isParagraphDirection };

package/dist/prosemirror/paragraphDirection.js

@@ -0,0 +1,33 @@
+//#region src/prosemirror/paragraphDirection.ts
+/** Whether the paragraph lays out and exports right-to-left. */
+const directionIsRtl = (direction) => direction?.source === "auto" || direction?.source === "manual" && direction.value === "rtl";
+/**
+* Auto-managed paragraphs (undecided, or previously auto-set) are the ones
+* AutoBidiDetection may (re-)evaluate. A manual decision is left untouched.
+*/
+const directionIsAutoManaged = (direction) => direction == null || direction.source === "auto";
+/** Map a direction to the serialized OOXML `w:bidi` tri-state. */
+const directionToBidi = (direction) => {
+	if (direction == null) return;
+	if (direction.source === "auto") return true;
+	return direction.value === "rtl";
+};
+/**
+* Reconstruct a direction from a model `bidi` value (DOCX import / load): an
+* explicit `true`/`false` is a manual decision, absence is undecided.
+*/
+const directionFromBidi = (bidi) => {
+	if (bidi == null) return null;
+	return {
+		source: "manual",
+		value: bidi ? "rtl" : "ltr"
+	};
+};
+/** Runtime guard for the PM attribute validator. */
+const isParagraphDirection = (value) => {
+	if (typeof value !== "object" || value === null || !("source" in value)) return false;
+	if (value.source === "auto") return !("value" in value);
+	return value.source === "manual" && "value" in value && (value.value === "rtl" || value.value === "ltr");
+};
+//#endregion
+export { directionFromBidi, directionIsAutoManaged, directionIsRtl, directionToBidi, isParagraphDirection };

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

@@ -0,0 +1,40 @@
+import { Plugin, PluginKey } from "prosemirror-state";
+import { DecorationSet } from "prosemirror-view";
+
+//#region src/prosemirror/plugins/aiCitationDecorations.d.ts
+declare const aiCitationDecorationsKey: PluginKey<AICitationDecorationState>;
+declare const SET_META = "set";
+declare const ACTIVE_META = "active";
+type AICitationRange = {
+  /** Stable id from the thread message. */id: string;
+  from: number;
+  to: number;
+};
+type AICitationDecorationState = {
+  citations: AICitationRange[];
+  activeId: string | null;
+  decorationSet: DecorationSet;
+};
+/**
+ * ProseMirror plugin that renders AI citations as inline highlights.
+ * Use {@link setAICitationsMeta} / {@link setActiveCitationMeta} to
+ * update which ranges are shown and which one is currently active
+ * (e.g., the one the user just clicked).
+ */
+declare function createAICitationDecorationsPlugin(): Plugin<AICitationDecorationState>;
+declare function setAICitationsMeta(citations: AICitationRange[]): {
+  key: PluginKey<AICitationDecorationState>;
+  payload: {
+    type: typeof SET_META;
+    citations: AICitationRange[];
+  };
+};
+declare function setActiveCitationMeta(activeId: string | null): {
+  key: PluginKey<AICitationDecorationState>;
+  payload: {
+    type: typeof ACTIVE_META;
+    activeId: string | null;
+  };
+};
+//#endregion
+export { AICitationRange, aiCitationDecorationsKey, createAICitationDecorationsPlugin, setAICitationsMeta, setActiveCitationMeta };