@stll/folio-core 0.54.2 → 0.55.0

package/dist/controller/hiddenEditorApi.js

@@ -1,17 +1,10 @@
+import { cloneDocumentWithParagraphPropertySources } from "../docx/paragraphPropertySource.js";
 import { fromProseDoc } from "../prosemirror/conversion/fromProseDoc.js";
 import { CellSelection } from "prosemirror-tables";
 import { NodeSelection, Selection, TextSelection } from "prosemirror-state";
 import { redo, undo } from "prosemirror-history";
 //#region src/controller/hiddenEditorApi.ts
 /**
-* Hidden-editor imperative API
-*
-* Framework-agnostic method surface for the off-screen ProseMirror editor.
-* Operates on an injected view accessor plus the document context and
-* destruction guard, so the same imperative handle can be driven from the
-* React component or a headless controller without depending on React.
-*/
-/**
 * Convert PM state to Document
 */
 const stateToDocument = (state, originalDoc) => {
@@ -39,11 +32,25 @@ const createHiddenEditorApi = (deps) => {
 		isViewRequested: deps.isViewRequested,
 		getState: () => deps.getView()?.state ?? null,
 		getView: () => deps.getView() ?? null,
+		setCanonicalMode: (mode) => !deps.isDestroying() && (deps.setCanonicalMode?.(mode) ?? false),
+		resolveCanonicalRevisions: (revisionIds, resolution) => !deps.isDestroying() && (deps.resolveCanonicalRevisions?.(revisionIds, resolution) ?? false),
+		getCanonicalDocument: () => {
+			const canonical = deps.getCanonicalDocument?.();
+			return canonical ? cloneDocumentWithParagraphPropertySources(canonical) : null;
+		},
 		getDocument: () => {
+			const canonical = deps.getCanonicalDocument?.();
+			if (canonical) return cloneDocumentWithParagraphPropertySources(canonical);
 			const view = deps.getView();
 			if (!view) return null;
 			return stateToDocument(view.state, deps.getDocumentContext());
 		},
+		updateCanonicalInputLifecycle: (action) => deps.canonicalOperations?.updateCanonicalInputLifecycle(action) ?? false,
+		applyCanonicalStoryHistory: (options) => deps.canonicalOperations?.applyCanonicalStoryHistory(options) ?? false,
+		applyCanonicalOperations: (ops) => deps.canonicalOperations?.applyCanonicalOperations(ops) ?? false,
+		getCanonicalStorySelection: (story) => deps.canonicalOperations?.getCanonicalStorySelection(story) ?? null,
+		getCanonicalStoryProjection: (story) => deps.canonicalOperations?.getCanonicalStoryProjection(story) ?? null,
+		replaceCanonicalStoryText: (options) => deps.canonicalOperations?.replaceCanonicalStoryText(options) ?? false,
 		focus: () => {
 			const view = deps.getView();
 			if (!view || view.hasFocus()) return;
@@ -62,24 +69,34 @@ const createHiddenEditorApi = (deps) => {
 		executeCommand: (command) => {
 			const view = deps.getView();
 			if (!view) return false;
+			const canonical = deps.executeCanonicalCommand?.(command);
+			if (canonical !== void 0) return canonical;
 			return command(view.state, (tr) => dispatchTr(view, tr), view);
 		},
 		undo: () => {
+			const canonical = deps.getCanonicalHistory?.();
+			if (canonical) return canonical.undo();
 			const view = deps.getView();
 			if (!view) return false;
 			return undo(view.state, (tr) => dispatchTr(view, tr));
 		},
 		redo: () => {
+			const canonical = deps.getCanonicalHistory?.();
+			if (canonical) return canonical.redo();
 			const view = deps.getView();
 			if (!view) return false;
 			return redo(view.state, (tr) => dispatchTr(view, tr));
 		},
 		canUndo: () => {
+			const canonical = deps.getCanonicalHistory?.();
+			if (canonical) return canonical.canUndo();
 			const view = deps.getView();
 			if (!view) return false;
 			return undo(view.state);
 		},
 		canRedo: () => {
+			const canonical = deps.getCanonicalHistory?.();
+			if (canonical) return canonical.canRedo();
 			const view = deps.getView();
 			if (!view) return false;
 			return redo(view.state);

package/dist/controller/hiddenEditorManager.d.ts

@@ -1,14 +1,19 @@
 import { document_d_exports } from "../types/document.js";
+import { HiddenEditorApi } from "./hiddenEditorApi.js";
 import { HiddenEditorStateReason } from "../layout-engine/layoutInstrumentation.js";
 import { ExtensionManager } from "../prosemirror/extensions/ExtensionManager.js";
 import { RemoteSelection } from "../types/remote-selection.js";
-import { HiddenEditorApi } from "./hiddenEditorApi.js";
+import { EditorMode } from "../managers/EditorModeManager.js";
 import { EditorState, Plugin, Transaction } from "prosemirror-state";
 import { EditorView } from "prosemirror-view";
 import * as Yjs from "yjs";
 import { XmlFragment } from "yjs";
 import * as YProseMirror from "y-prosemirror";
 //#region src/controller/hiddenEditorManager.d.ts
+declare const CanonicalSessionRefusalError_base: import("better-result").TaggedErrorClass<"CanonicalSessionRefusalError">;
+declare class CanonicalSessionRefusalError extends CanonicalSessionRefusalError_base<{
+  message: string;
+}> {}
 type YProseMirrorModule = typeof YProseMirror;
 type YjsModule = typeof Yjs;
 type CollaborationModules = {
@@ -55,6 +60,10 @@ type HiddenEditorManagerDeps = {
   getCollaborationModules: () => CollaborationModules | null;
   getPrecomputedInitialState: () => EditorState | null | undefined;
   getReadOnly: () => boolean;
+  getExperimentalSession?: () => "canonical" | undefined;
+  getEditingMode?: () => EditorMode;
+  getSuggestionAuthor?: () => string;
+  onSessionRefusal?: (reason: string) => void;
   /**
    * Identity of the loaded document as tracked by the adapter's loader: the
    * same value across internal edits (so typing does not trigger an external
@@ -102,4 +111,4 @@ type HiddenEditorManager = {
 };
 declare const createHiddenEditorManager: (deps: HiddenEditorManagerDeps) => HiddenEditorManager;
 //#endregion
-export { CollaborationModules, CreateHiddenEditorStateOptions, HiddenEditorManager, HiddenEditorManagerDeps, HiddenEditorTransactionUpdate, HiddenProseMirrorCollaboration, HiddenProseMirrorRemoteSelection, collectRemoteSelections, createHiddenEditorClipboardHandlers, createHiddenEditorManager, createHiddenEditorState };
+export { CanonicalSessionRefusalError, CollaborationModules, CreateHiddenEditorStateOptions, HiddenEditorManager, HiddenEditorManagerDeps, HiddenEditorTransactionUpdate, HiddenProseMirrorCollaboration, HiddenProseMirrorRemoteSelection, collectRemoteSelections, createHiddenEditorClipboardHandlers, createHiddenEditorManager, createHiddenEditorState };