oasis-editor 0.0.75 → 0.0.77

package/dist/app/controllers/EditorCommandsController.d.ts

@@ -1,24 +1,15 @@
 import { EditorParagraphListStyle, EditorParagraphStyle, EditorSection, EditorState, EditorTextStyle } from '../../core/model.js';
 import { TextCaseMode } from '../../core/commands/text.js';
-import { EditorTransactionOptions } from '../../ui/editorHistory.js';
 import { BooleanStyleKey, ParagraphStyleKey, ToolbarStyleState } from '../../ui/toolbarStyleState.js';
 import { EditorLogger } from '../../utils/logger.js';
-import { SelectedImageRun } from '../../core/commands/image.js';
+import { EditorTransactionPort, FocusInputPort, SelectedImageQueryPort } from './controllerPorts.js';
 
-export interface EditorCommandsControllerDeps {
+export interface EditorCommandsControllerDeps extends EditorTransactionPort, FocusInputPort, SelectedImageQueryPort {
     state: EditorState;
     logger: EditorLogger;
-    applyState: (next: EditorState) => void;
-    applyTransactionalState: (producer: (current: EditorState) => EditorState, options?: EditorTransactionOptions) => void;
     applySelectionAwareTextCommand: (command: (current: EditorState) => EditorState) => void;
-    applySelectionAwareParagraphCommand: (command: (current: EditorState) => EditorState) => void;
-    applyTableAwareParagraphEdit: (current: EditorState, edit: (tempState: EditorState) => EditorState) => EditorState;
-    focusInput: () => void;
-    clearPreferredColumn: () => void;
-    resetTransactionGrouping: () => void;
     toolbarStyleState: () => ToolbarStyleState;
     selectionCollapsed: () => boolean;
-    selectedImageRun: () => SelectedImageRun | null;
     openLinkDialog: (initialHref: string) => void;
     openImageAltDialog: (initialAlt: string) => void;
     openImageCaptionDialog: (initialCaption: string) => void;

package/dist/app/controllers/EditorKeyboardDeps.d.ts

@@ -1,23 +1,19 @@
 import { EditorDocument, EditorPosition, EditorState } from '../../core/model.js';
 import { BooleanStyleKey } from '../../ui/toolbarStyleState.js';
-import { SelectedImageRun } from '../../core/commands/image.js';
+import { EditorTransactionPort, FocusInputPort, SelectedImageQueryPort } from './controllerPorts.js';
 
 /**
  * The capability surface the keyboard controller and key bindings operate on.
  * Extracted to its own leaf module so `EditorCommandRegistry` (which references
  * it from key-binding signatures) and `useEditorKeyboard` (which implements the
  * controller) can both depend on it without forming an import cycle.
+ *
+ * Shared transaction/focus/image-selection members come from the capability
+ * ports in `controllerPorts.ts`; only keyboard-specific members live here (I1).
  */
-export interface EditorKeyboardDeps {
+export interface EditorKeyboardDeps extends EditorTransactionPort, FocusInputPort, SelectedImageQueryPort {
     state: () => EditorState;
     isReadOnly: () => boolean;
-    clearPreferredColumn: () => void;
-    resetTransactionGrouping: () => void;
-    applyState: (state: EditorState) => void;
-    applyTransactionalState: (transform: (state: EditorState) => EditorState) => void;
-    applyTableAwareParagraphEdit: (state: EditorState, edit: (state: EditorState) => EditorState) => EditorState;
-    applySelectionAwareParagraphCommand: (command: (state: EditorState) => EditorState) => void;
-    focusInput: () => void;
     commandsController: {
         promptForImageAlt: () => void;
         promptForLink: () => void;
@@ -30,7 +26,6 @@ export interface EditorKeyboardDeps {
         }) => boolean;
         handleListTab: (direction: "indent" | "outdent") => boolean;
     };
-    selectedImageRun: () => SelectedImageRun | null;
     setForcePlainTextPaste: (value: boolean) => void;
     moveSelectionByWord: (direction: "left" | "right", extend: boolean) => boolean;
     moveSelectionToDocumentBoundary: (boundary: "start" | "end", extend: boolean) => boolean;

package/dist/app/controllers/controllerPorts.d.ts

@@ -0,0 +1,33 @@
+import { EditorState } from '../../core/model.js';
+import { EditorTransactionOptions } from '../../ui/editorHistory.js';
+import { SelectedImageRun } from '../../core/commands/image.js';
+
+/**
+ * Capability ports shared by the editor controllers (I1). The controller
+ * dependency bags used to redeclare these same members independently; grouping
+ * them into small, named ports removes that duplication and lets a controller
+ * (or a test fabricating deps) depend on just the capabilities it actually
+ * uses, rather than a 20+-member catch-all interface.
+ */
+/**
+ * Applies document changes through the editor's transaction/history machinery.
+ * Covers the plain apply, the transactional producer (optionally grouped), the
+ * table-aware paragraph edit, the selection-aware paragraph command, and the
+ * transaction-grouping bookkeeping.
+ */
+export interface EditorTransactionPort {
+    applyState: (next: EditorState) => void;
+    applyTransactionalState: (producer: (current: EditorState) => EditorState, options?: EditorTransactionOptions) => void;
+    applyTableAwareParagraphEdit: (current: EditorState, edit: (tempState: EditorState) => EditorState) => EditorState;
+    applySelectionAwareParagraphCommand: (command: (current: EditorState) => EditorState) => void;
+    clearPreferredColumn: () => void;
+    resetTransactionGrouping: () => void;
+}
+/** Returns keyboard focus to the hidden editing input. */
+export interface FocusInputPort {
+    focusInput: () => void;
+}
+/** Reads the currently selected inline image run, when one is selected. */
+export interface SelectedImageQueryPort {
+    selectedImageRun: () => SelectedImageRun | null;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "oasis-editor",
-  "version": "0.0.75",
+  "version": "0.0.77",
   "type": "module",
   "repository": {
     "type": "git",