@stll/folio-core 0.62.0 → 0.63.1

package/dist/prosemirror/canonicalSelectionRange.js

@@ -1,3 +1,4 @@
+import { CellSelection } from "prosemirror-tables";
 import { AllSelection, Selection } from "prosemirror-state";
 //#region src/prosemirror/canonicalSelectionRange.ts
 /** Document edges denote the first and last editable content gaps. */
@@ -8,6 +9,7 @@ const canonicalContentPosition = (doc, position) => {
 };
 /** Whole-document selection addresses paragraph content rather than document edges. */
 const canonicalSelectionRange = ({ doc, selection }) => {
+	if (selection instanceof CellSelection) throw new TypeError("A cell selection has no canonical linear range.");
 	if (selection instanceof AllSelection) return {
 		from: canonicalContentPosition(doc, selection.from),
 		to: canonicalContentPosition(doc, selection.to)
@@ -17,5 +19,22 @@ const canonicalSelectionRange = ({ doc, selection }) => {
 		to: selection.to
 	};
 };
+/** Cell selections address each selected cell independently, in document order. */
+const canonicalCellSelectionRanges = (selection) => {
+	const ranges = [];
+	selection.forEachCell((cell, cellPosition) => {
+		cell.descendants((node, position) => {
+			if (!node.isTextblock) return true;
+			ranges.push({
+				from: cellPosition + 1 + position + 1,
+				to: cellPosition + 1 + position + 1 + node.content.size
+			});
+			return false;
+		});
+	});
+	return ranges.toSorted((left, right) => left.from - right.from);
+};
+/** A selection is either one linear range or a document-ordered set of cell ranges. */
+const canonicalSelectionRanges = (state) => state.selection instanceof CellSelection ? canonicalCellSelectionRanges(state.selection) : [canonicalSelectionRange(state)];
 //#endregion
-export { canonicalContentPosition, canonicalSelectionRange };
+export { canonicalCellSelectionRanges, canonicalContentPosition, canonicalSelectionRange, canonicalSelectionRanges };

package/dist/prosemirror/cellDragSelection.d.ts

@@ -5,20 +5,20 @@ import { EditorView } from "prosemirror-view";
  * drags stay text selections. Kept only for backward-compatible imports; will be
  * removed in a future major.
  */
-declare const CELL_SELECT_OVERFLOW_PX = 5;
+export declare const CELL_SELECT_OVERFLOW_PX = 5;
 /**
  * Walk up from a PM position to the enclosing `tableCell`/`tableHeader` and
  * return its `before(d)` position (what `CellSelection` resolves against), or
  * null when the position isn't inside a table cell.
  */
-declare function findCellPosFromPmPos(view: EditorView, pmPos: number): number | null;
+export declare function findCellPosFromPmPos(view: EditorView, pmPos: number): number | null;
 /** Dispatch a `CellSelection` spanning the two cell positions. */
-declare function applyCellSelection(view: EditorView, anchorCellPos: number, headCellPos: number): boolean;
+export declare function applyCellSelection(view: EditorView, anchorCellPos: number, headCellPos: number): boolean;
 /**
  * Per-gesture state machine for cell-drag selection. Create one per pointer
  * handler; drive it from mousedown/mousemove/mouseup.
  */
-type CellDragTracker = {
+export type CellDragTracker = {
   /** mousedown: record the cell under the press (or null when outside a table). */
   begin(cellPos: number | null): void;
   /**
@@ -31,6 +31,5 @@ type CellDragTracker = {
   /** True while a cell drag is actively producing CellSelections. */
   readonly isCellDragging: boolean;
 };
-declare function createCellDragTracker(): CellDragTracker;
-//#endregion
-export { CELL_SELECT_OVERFLOW_PX, CellDragTracker, applyCellSelection, createCellDragTracker, findCellPosFromPmPos };
+export declare function createCellDragTracker(): CellDragTracker;
+//#endregion

package/dist/prosemirror/cellDragSelection.js

@@ -1,6 +1,15 @@
 import { CellSelection } from "prosemirror-tables";
 //#region src/prosemirror/cellDragSelection.ts
 /**
+* Drag-to-select table cells, shared by the React and Vue pages-pointer
+* handlers. A pointer drag that starts inside a table cell and crosses into
+* another cell is promoted from a text selection to a prosemirror-tables
+* `CellSelection` (so multi-cell ops — delete row/column, fill, merge — become
+* reachable by dragging). Pure `(view, pmPos, clientX) → boolean` logic; the
+* adapters own the DOM event wiring and the active-view resolution (body vs
+* header/footer).
+*/
+/**
 * @deprecated No longer used. The tracker ignores pointer overflow so same-cell
 * drags stay text selections. Kept only for backward-compatible imports; will be
 * removed in a future major.

package/dist/prosemirror/clearRunColor.d.ts

@@ -1,6 +1,5 @@
 import { Command } from "prosemirror-state";
 //#region src/prosemirror/clearRunColor.d.ts
 /** Clearing direct color reveals the run's character/paragraph style color. */
-declare const clearRunColor: () => Command;
-//#endregion
-export { clearRunColor };
+export declare const clearRunColor: () => Command;
+//#endregion

package/dist/prosemirror/clearRunColor.js

@@ -34,11 +34,14 @@ const clearRunColor = () => (state, dispatch) => {
 		doc: state.doc,
 		from,
 		to
-	})) applyMarksToRunFormattingRepresentation({
-		tr,
-		representation,
-		marks: clearedMarks(representation.node, representation.position)
-	});
+	})) {
+		const marks = clearedMarks(representation.node, representation.position);
+		applyMarksToRunFormattingRepresentation({
+			tr,
+			representation,
+			marks
+		});
+	}
 	dispatch(tr.scrollIntoView());
 	return true;
 };

package/dist/prosemirror/clipboardIntent.d.ts

@@ -1,7 +1,6 @@
 import { Slice } from "prosemirror-model";
 import { EditorView } from "prosemirror-view";
 //#region src/prosemirror/clipboardIntent.d.ts
-declare const registerClipboardIntentHandler: (view: EditorView, handler: (slice: Slice, plain: boolean) => boolean) => void;
-declare const dispatchClipboardIntent: (view: EditorView, slice: Slice) => boolean | undefined;
-//#endregion
-export { dispatchClipboardIntent, registerClipboardIntentHandler };
+export declare const registerClipboardIntentHandler: (view: EditorView, handler: (slice: Slice, plain: boolean) => boolean) => void;
+export declare const dispatchClipboardIntent: (view: EditorView, slice: Slice) => boolean | undefined;
+//#endregion

package/dist/prosemirror/commands/clearParagraphIndent.d.ts

@@ -1,6 +1,5 @@
 import { Command } from "prosemirror-state";
 //#region src/prosemirror/commands/clearParagraphIndent.d.ts
 /** Clear indentation at paragraph start before Backspace joins paragraphs. */
-declare const clearIndentOnBackspace: Command;
-//#endregion
-export { clearIndentOnBackspace };
+export declare const clearIndentOnBackspace: Command;
+//#endregion

package/dist/prosemirror/commands/comments.d.ts

@@ -4,13 +4,13 @@ import { Mapping } from "prosemirror-transform";
 /**
  * Add a comment mark to the current selection.
  */
-declare function addCommentMark(commentId: number): Command;
+export declare function addCommentMark(commentId: number): Command;
 /**
  * Remove a comment mark by ID from the entire document.
  */
-declare function removeCommentMark(commentId: number): Command;
+export declare function removeCommentMark(commentId: number): Command;
 type ResolveMode = "accept" | "reject";
-type ParagraphBoundaryChange = {
+export type ParagraphBoundaryChange = {
   from: number;
   to: number;
   type: "insertion" | "deletion";
@@ -18,38 +18,38 @@ type ParagraphBoundaryChange = {
   date?: string;
   revisionId?: number;
 };
-declare function findParagraphBoundaryChangeAtPosition(state: EditorState, pos: number): ParagraphBoundaryChange | null;
+export declare function findParagraphBoundaryChangeAtPosition(state: EditorState, pos: number): ParagraphBoundaryChange | null;
 /**
  * Accept a tracked change at the given range.
  * - Insertion: remove mark, keep text
  * - Deletion: remove mark AND text
  */
-declare function acceptChange(from: number, to: number): Command;
+export declare function acceptChange(from: number, to: number): Command;
 /**
  * Reject a tracked change at the given range.
  * - Insertion: remove mark AND text
  * - Deletion: remove mark, keep text
  */
-declare function rejectChange(from: number, to: number): Command;
+export declare function rejectChange(from: number, to: number): Command;
 /**
  * Accept all tracked changes in the document. Returns `false` while pending
  * suggestions are present because this command cannot restage them.
  */
-declare function acceptAllChanges(): Command;
+export declare function acceptAllChanges(): Command;
 /**
  * Reject all tracked changes in the document.
  */
-declare function rejectAllChanges(): Command;
+export declare function rejectAllChanges(): Command;
 /**
  * Resolve a complete state synchronously for a headless reader or writer.
  *
  * Uses the same single-step resolver as the interactive editor command.
  */
-declare function resolveAllChangesInHeadlessState(state: EditorState, mode: ResolveMode): EditorState;
+export declare function resolveAllChangesInHeadlessState(state: EditorState, mode: ResolveMode): EditorState;
 /**
  * Resolve a story and retain its position map for callers addressing the tracked source.
  */
-declare const resolveAllChangesInHeadlessStateWithMapping: (state: EditorState, mode: ResolveMode) => {
+export declare const resolveAllChangesInHeadlessStateWithMapping: (state: EditorState, mode: ResolveMode) => {
   state: EditorState;
   mapping: Mapping;
 };
@@ -59,7 +59,7 @@ declare const resolveAllChangesInHeadlessStateWithMapping: (state: EditorState,
  * never existed). A replace operation typically passes two ids; standalone
  * text, formatting, paragraph, section, and table revisions pass a single id.
  */
-declare function findAIEditRevisionRange(state: EditorState, revisionIds: number | readonly number[]): {
+export declare function findAIEditRevisionRange(state: EditorState, revisionIds: number | readonly number[]): {
   from: number;
   to: number;
 } | null;
@@ -69,13 +69,13 @@ declare function findAIEditRevisionRange(state: EditorState, revisionIds: number
  * full id list for a replace (one id per side). Returns false when
  * none of the ids match anything in the doc.
  */
-declare function acceptAIEditRevision(revisionIds: number | readonly number[]): Command;
+export declare function acceptAIEditRevision(revisionIds: number | readonly number[]): Command;
 /**
  * Reject the tracked-change marks belonging to an AI-edit operation.
  * See {@link acceptAIEditRevision} for the id semantics.
  */
-declare function rejectAIEditRevision(revisionIds: number | readonly number[]): Command;
-type SuggestionKind = "insertion" | "deletion" | "formatting" | "insertBlock" | "insertTable" | "insertRow" | "deleteRow" | "insertColumn" | "deleteColumn";
+export declare function rejectAIEditRevision(revisionIds: number | readonly number[]): Command;
+export type SuggestionKind = "insertion" | "deletion" | "formatting" | "insertBlock" | "insertTable" | "insertRow" | "deleteRow" | "insertColumn" | "deleteColumn";
 /**
  * How a suggestion is applied when accepted:
  * - `"tracked"` — converts to a normal OOXML tracked change (`w:ins`/`w:del`,
@@ -87,8 +87,8 @@ type SuggestionKind = "insertion" | "deletion" | "formatting" | "insertBlock" |
  *   resolves the whole group in one transaction; this flag lets the host
  *   message that some parts landed directly.
  */
-type SuggestionAppliedAs = "tracked" | "direct" | "mixed";
-type FolioSuggestion = {
+export type SuggestionAppliedAs = "tracked" | "direct" | "mixed";
+export type FolioSuggestion = {
   suggestionId: string;
   /** Contiguous document ranges the suggestion covers, in document order. */
   ranges: readonly {
@@ -105,20 +105,20 @@ type FolioSuggestion = {
  * contiguous ranges it covers, which kinds of change it contains, and how
  * accepting it applies (tracked vs direct).
  */
-declare function getSuggestions(state: EditorState): FolioSuggestion[];
+export declare function getSuggestions(state: EditorState): FolioSuggestion[];
 /** The suggestion a revision belongs to, or `null` for an ordinary tracked change. */
-declare function suggestionIdOfRevision(state: EditorState, revisionId: number): string | null;
+export declare function suggestionIdOfRevision(state: EditorState, revisionId: number): string | null;
 /**
  * The document range covering every mark belonging to `suggestionId`, plus the
  * revision ids those marks carry. Returns null when the suggestion is absent
  * (already accepted/rejected, or never existed).
  */
-declare function findSuggestionRange(state: EditorState, suggestionId: string): {
+export declare function findSuggestionRange(state: EditorState, suggestionId: string): {
   from: number;
   to: number;
   revisionIds: number[];
 } | null;
-type AcceptSuggestionOptions = {
+export type AcceptSuggestionOptions = {
   author: string;
   /**
    * Date stamped on the resulting user tracked change (serialized as `w:date`);
@@ -135,9 +135,9 @@ type AcceptSuggestionOptions = {
  * everything else becomes a tracked change. See {@link getSuggestions} for the
  * per-suggestion `appliedAs`.
  */
-declare function acceptSuggestion(suggestionId: string, options: AcceptSuggestionOptions): Command;
+export declare function acceptSuggestion(suggestionId: string, options: AcceptSuggestionOptions): Command;
 /** Accept every suggestion in the document. */
-declare function acceptAllSuggestions(options: AcceptSuggestionOptions): Command;
+export declare function acceptAllSuggestions(options: AcceptSuggestionOptions): Command;
 /**
  * Reject one suggestion: inverse-apply it in a single transaction. Runs BOTH
  * phases so a heterogeneous group (one `suggestionId` spanning whole-node
@@ -152,9 +152,9 @@ declare function acceptAllSuggestions(options: AcceptSuggestionOptions): Command
  * so phase 1 empties its text and phase 2 removes the now-empty node; a whole
  * inserted table has no matching revision, so only phase 2 removes it.
  */
-declare function rejectSuggestion(suggestionId: string): Command;
+export declare function rejectSuggestion(suggestionId: string): Command;
 /** Reject every suggestion in the document. */
-declare function rejectAllSuggestions(): Command;
+export declare function rejectAllSuggestions(): Command;
 type ChangeRange = {
   from: number;
   to: number;
@@ -166,7 +166,7 @@ type ChangeRange = {
  * of that mark (expanding to cover all adjacent nodes with the same
  * revision ID). If from !== to (range selection), returns {from, to}.
  */
-declare function findChangeAtPosition(state: EditorState, from: number, to: number): {
+export declare function findChangeAtPosition(state: EditorState, from: number, to: number): {
   from: number;
   to: number;
 };
@@ -175,12 +175,12 @@ declare function findChangeAtPosition(state: EditorState, from: number, to: numb
  * range of the change (including adjacent text nodes that share the same
  * insertion/deletion mark instance), not just the first text node.
  */
-declare function findNextChange(state: EditorState, startPos: number): ChangeRange | null;
+export declare function findNextChange(state: EditorState, startPos: number): ChangeRange | null;
 /**
  * Find the previous tracked change before the given position. Returns the
  * full range of the change (including adjacent text nodes that share the
  * same insertion/deletion mark instance), not just the last text node.
  */
-declare function findPreviousChange(state: EditorState, startPos: number): ChangeRange | null;
+export declare function findPreviousChange(state: EditorState, startPos: number): ChangeRange | null;
 //#endregion
-export { AcceptSuggestionOptions, FolioSuggestion, ParagraphBoundaryChange, SuggestionAppliedAs, SuggestionKind, acceptAIEditRevision, acceptAllChanges, acceptAllSuggestions, acceptChange, acceptSuggestion, addCommentMark, findAIEditRevisionRange, findChangeAtPosition, findNextChange, findParagraphBoundaryChangeAtPosition, findPreviousChange, findSuggestionRange, getSuggestions, rejectAIEditRevision, rejectAllChanges, rejectAllSuggestions, rejectChange, rejectSuggestion, removeCommentMark, resolveAllChangesInHeadlessState, resolveAllChangesInHeadlessStateWithMapping, suggestionIdOfRevision };
+export {};