@rtif-sdk/web 1.5.0 → 1.7.0

package/dist/types.d.ts

@@ -1,4 +1,5 @@
-import type { IEditorEngine } from '@rtif-sdk/engine';
+import type { IEditorEngine, EditorState } from '@rtif-sdk/engine';
+import type { Selection } from '@rtif-sdk/core';
 /**
  * Configuration for creating a web editor instance.
  *
@@ -124,6 +125,16 @@ export interface WebEditorConfig {
      * ```
      */
     readonly virtualize?: boolean | VirtualizationConfig;
+    /**
+     * Enable the right-click context menu.
+     *
+     * - `true` or omitted — show the default context menu (Cut/Copy/Paste/Select All)
+     * - `false` — disable the custom context menu (browser default fires)
+     * - `ContextMenuConfig` object — customize items
+     *
+     * Default: `true`.
+     */
+    readonly contextMenu?: boolean | ContextMenuConfig;
 }
 /**
  * Configuration for block-level viewport virtualization.
@@ -204,6 +215,8 @@ export interface WebEditor {
      * Only present when the document exceeds the virtualization threshold.
      */
     readonly viewport: import('./virtual-viewport.js').VirtualViewport | null;
+    /** Context menu handle, or null if disabled. */
+    readonly contextMenu: ContextMenuHandle | null;
     /**
      * Focus the editor's contenteditable element.
      * If the editor was destroyed, this is a no-op.
@@ -225,6 +238,27 @@ export interface WebEditor {
      * After calling destroy(), the editor instance is inert.
      */
     destroy(): void;
+    /**
+     * Subscribe to a typed editor event.
+     *
+     * @param event - The event name (e.g., 'change', 'focus', 'error')
+     * @param listener - Callback invoked when the event fires
+     * @returns An unsubscribe function
+     *
+     * @example
+     * ```ts
+     * const off = editor.on('change', (e) => console.log(e.state));
+     * // later: off();
+     * ```
+     */
+    on<K extends keyof EditorEventMap>(event: K, listener: EditorEventListener<K>): () => void;
+    /**
+     * Remove a previously registered event listener.
+     *
+     * @param event - The event name
+     * @param listener - The exact listener function reference to remove
+     */
+    off<K extends keyof EditorEventMap>(event: K, listener: EditorEventListener<K>): void;
 }
 /**
  * Cached offset information for a single block in the document.
@@ -325,4 +359,171 @@ export interface Disposable {
     /** Unregister the resource. */
     dispose(): void;
 }
+/**
+ * Payload for the `change` event — fires after every document mutation.
+ *
+ * @example
+ * ```ts
+ * editor.on('change', (e) => save(e.state.doc));
+ * ```
+ */
+export interface EditorChangeEvent {
+    /** The editor state after the change. */
+    readonly state: EditorState;
+}
+/**
+ * Payload for the `selectionChange` event — fires on cursor moves
+ * that do not modify the document.
+ *
+ * @example
+ * ```ts
+ * editor.on('selectionChange', (e) => updateToolbar(e.selection));
+ * ```
+ */
+export interface EditorSelectionChangeEvent {
+    /** The selection after the change. */
+    readonly selection: Selection;
+}
+/**
+ * Payload for the `error` event — fires when a plugin or operation error occurs.
+ *
+ * @example
+ * ```ts
+ * editor.on('error', (e) => reportError(e.error, e.source));
+ * ```
+ */
+export interface EditorErrorEvent {
+    /** The error that occurred. */
+    readonly error: Error;
+    /** Source identifier (e.g., `"plugin:com.example.myplugin"`). */
+    readonly source: string;
+}
+/**
+ * Maps editor event names to their payload types.
+ *
+ * Events with `undefined` payloads fire listeners with no arguments.
+ *
+ * @example
+ * ```ts
+ * editor.on('change', (e) => { ... });  // e: EditorChangeEvent
+ * editor.on('focus', () => { ... });    // no argument
+ * ```
+ */
+export interface EditorEventMap {
+    /** Fires after every document mutation (dispatch, undo, redo). */
+    change: EditorChangeEvent;
+    /** Fires on cursor/selection moves that do not modify the document. */
+    selectionChange: EditorSelectionChangeEvent;
+    /** Fires when the editor gains focus. */
+    focus: undefined;
+    /** Fires when the editor loses focus. */
+    blur: undefined;
+    /** Fires once after the editor is created and the initial render is complete. */
+    ready: undefined;
+    /** Fires on plugin errors or operation failures. */
+    error: EditorErrorEvent;
+}
+/**
+ * Conditional listener type: no-arg for `undefined` payloads, typed arg otherwise.
+ */
+export type EditorEventListener<K extends keyof EditorEventMap> = EditorEventMap[K] extends undefined ? () => void : (event: EditorEventMap[K]) => void;
+/**
+ * Contextual information passed to context menu items for show/disabled logic.
+ *
+ * @example
+ * ```ts
+ * const canShow: ContextMenuActionItem['canShow'] = (ctx) => !ctx.isCollapsed;
+ * ```
+ */
+export interface ContextMenuContext {
+    /** True when the selection is collapsed (caret, no range). */
+    readonly isCollapsed: boolean;
+    /** True when the editor is in read-only mode. */
+    readonly readOnly: boolean;
+    /** The block type at the cursor position. */
+    readonly blockType: string;
+    /** Active marks at the cursor position. */
+    readonly marks: Record<string, unknown>;
+}
+/**
+ * A clickable action item in the context menu.
+ *
+ * @example
+ * ```ts
+ * const cutItem: ContextMenuActionItem = {
+ *   type: 'action',
+ *   id: 'cut',
+ *   label: 'Cut',
+ *   shortcutHint: '\u2318X',
+ *   action: () => document.execCommand('cut'),
+ * };
+ * ```
+ */
+export interface ContextMenuActionItem {
+    readonly type: 'action';
+    /** Unique identifier for this item. */
+    readonly id: string;
+    /** Display label. */
+    readonly label: string;
+    /** Optional icon text (emoji or single char). */
+    readonly icon?: string;
+    /** Optional keyboard shortcut hint (e.g., "\u2318X" or "Ctrl+X"). */
+    readonly shortcutHint?: string;
+    /** Action to execute when the item is clicked. */
+    readonly action: (editor: WebEditor) => void;
+    /** Return false to hide this item from the menu. Default: shown. */
+    readonly canShow?: (context: ContextMenuContext) => boolean;
+    /** Return true to render this item as disabled (grayed, not clickable). Default: enabled. */
+    readonly isDisabled?: (context: ContextMenuContext) => boolean;
+}
+/**
+ * A visual separator between context menu item groups.
+ */
+export interface ContextMenuSeparatorItem {
+    readonly type: 'separator';
+}
+/**
+ * Union type for all context menu item types.
+ */
+export type ContextMenuItem = ContextMenuActionItem | ContextMenuSeparatorItem;
+/**
+ * Configuration for the context menu.
+ *
+ * @example
+ * ```ts
+ * // Append a custom item after the defaults
+ * createWebEditor({
+ *   ...,
+ *   contextMenu: {
+ *     additionalItems: [
+ *       { type: 'separator' },
+ *       { type: 'action', id: 'debug', label: 'Debug', action: () => console.log('debug') },
+ *     ],
+ *   },
+ * });
+ * ```
+ */
+export interface ContextMenuConfig {
+    /** Replace the default items entirely. */
+    readonly items?: ReadonlyArray<ContextMenuItem>;
+    /** Append items after the defaults (ignored when `items` is provided). */
+    readonly additionalItems?: ReadonlyArray<ContextMenuItem>;
+}
+/**
+ * Handle for the context menu, returned on the {@link WebEditor} instance.
+ *
+ * @example
+ * ```ts
+ * editor.contextMenu?.show(100, 200);
+ * editor.contextMenu?.hide();
+ * ```
+ */
+export interface ContextMenuHandle extends Disposable {
+    /** Whether the context menu is currently open. */
+    readonly isOpen: boolean;
+    /** Show the context menu at the given viewport coordinates. */
+    show(x: number, y: number): void;
+    /** Hide the context menu if open. */
+    hide(): void;
+}
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rtif-sdk/web",
-  "version": "1.5.0",
+  "version": "1.7.0",
   "description": "RTIF web platform implementation (contenteditable)",
   "author": "coryrobinson42@gmail.com",
   "type": "module",
@@ -35,6 +35,7 @@
     "build": "tsc --build tsconfig.build.json",
     "test": "vitest run",
     "test:browser": "vitest run --config vitest.browser.config.ts",
+    "test:browser:xb": "vitest run --config vitest.browser-xb.config.ts",
     "prepublishOnly": "npm run build"
   },
   "dependencies": {

package/styles/all.css

@@ -18,3 +18,4 @@
 @import './drop-indicator.css';
 @import './pickers.css';
 @import './mention.css';
+@import './context-menu.css';

package/styles/context-menu.css

@@ -0,0 +1,58 @@
+/* --------------------------------------------------------
+ * RTIF Context Menu Styles
+ *
+ * Right-click menu for Cut/Copy/Paste/Select All.
+ * Positioned via JS (top/left). All visual properties
+ * are CSS-driven. Uses RTIF CSS custom properties.
+ * -------------------------------------------------------- */
+
+.rtif-context-menu {
+  position: fixed;
+  z-index: var(--rtif-z-popover, 9999);
+  background-color: var(--rtif-surface, #fff);
+  border: 1px solid var(--rtif-border, #d0d0d0);
+  border-radius: var(--rtif-radius, 6px);
+  box-shadow: var(--rtif-shadow, 0 4px 12px rgba(0, 0, 0, 0.15));
+  padding: 4px 0;
+  min-width: 180px;
+  font-family: var(--rtif-ui-font, system-ui, -apple-system, sans-serif);
+  font-size: var(--rtif-ui-font-size, 13px);
+  line-height: 1;
+  user-select: none;
+}
+
+.rtif-context-menu-separator {
+  height: 1px;
+  background-color: var(--rtif-border, #e0e0e0);
+  margin: 4px 0;
+}
+
+.rtif-context-menu-item {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  padding: 6px 12px;
+  cursor: pointer;
+  color: #333;
+}
+
+.rtif-context-menu-item[aria-disabled="true"] {
+  cursor: default;
+  color: #999;
+}
+
+.rtif-context-menu-item:not([aria-disabled="true"]):hover,
+.rtif-context-menu-item-highlighted:not([aria-disabled="true"]) {
+  background-color: var(--rtif-accent-color, #2563eb);
+  color: #fff;
+}
+
+.rtif-context-menu-item-highlighted:not([aria-disabled="true"]) .rtif-context-menu-item-shortcut {
+  color: rgba(255, 255, 255, 0.7);
+}
+
+.rtif-context-menu-item-shortcut {
+  margin-left: 24px;
+  color: #999;
+  font-size: 12px;
+}