wysiwygido 0.2.1 → 0.2.2

package/CHANGELOG.md

@@ -2,6 +2,13 @@
 
 All notable changes to this project are documented here. The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/) and the project uses [Semantic Versioning](https://semver.org/). Until 1.0, minor versions may contain breaking changes; they are listed under "Changed" or "Removed".
 
+## 0.2.2
+
+- Added: right-click menu (`ContextMenu`, in the default set) with table, list, link, picture and text-format items, and a `contextMenu(context)` hook for plugins to add their own.
+- Added: `addRowBefore`, `addColumnBefore`, `toggleHeaderColumn`, `selectTable`, `selectRow`, `selectColumn`, `distributeColumns`, `listStyle` and `restartNumbering` commands.
+- Fixed: a table reduced to one row, one column or one empty cell could not be deleted. Deleting its last row or column now removes the table, and Backspace/Delete in an empty single cell does too.
+- Changed: `bulletList` / `orderedList` inside a list of the other kind now convert it instead of lifting out.
+
 ## [Unreleased]
 
 ## [0.2.1] - 2026-10-11

package/README.md

@@ -461,6 +461,30 @@ returns an unsubscribe function, and `editor.emit('my-event', payload)` tells ot
 `registerIcon(name, svgInner)` adds an icon for ribbon buttons. See `demo/custom-plugin` for a complete third-party plugin, and `src/plugins/` for the built-in ones.
 Plugins are fixed when the editor is created (the schema cannot change afterwards); commands, toolbar layout and listeners can change at any time.
 
+## Right-click menu
+
+`ContextMenu` is in `defaultPlugins`. Right-click shows cut/copy/paste and then what applies at the click: table tools in a table (insert/delete
+rows and columns, merge/split, header row/column, cell colour, select, even column widths), list tools in a list (bulleted/numbered/checklist,
+indent, numbering style, restart numbering), link tools on a link (open, copy address, edit, remove), picture tools on a picture (alt text, caption,
+size, crop, edit, delete), and text formatting on a selection. It opens from the keyboard with the Menu key or Shift+F10, works with the arrow keys,
+Escape closes it, and Shift + right-click gives the browser's own menu. A read-only editor only gets copy, open link and select all.
+Deleting the last row or column of a table now removes the table, and Backspace/Delete in an empty one-cell table removes it too.
+
+Add your own lines from any plugin:
+
+```ts
+definePlugin({
+  name: 'my-menu',
+  contextMenu({ closest, readonly }) {
+    if (readonly || !closest('blockquote')) return [];
+    return ['-', { label: 'Remove quote', command: 'blockQuote' }, { label: 'Say hi', run: (editor) => alert('hi') }];
+  },
+});
+```
+
+Items take `label`, `command`/`args` or `run`, `icon`, `shortcut`, `disabled`, `checked`, `danger`, `readOnly` and `items` (a submenu); `'-'` is a separator.
+Leave the plugin out of `plugins` to have no custom menu.
+
 ## Known limitations
 
 - **Pagination is visual.** The document stays one ProseMirror doc; blocks are measured in the browser and spaced across

package/dist/adapter.js

@@ -1,4 +1,4 @@
-import { t as createEditor } from "./src-BRR721LM.js";
+import { t as createEditor } from "./src-DFClH3tv.js";
 //#region src/adapter.ts
 /**
 * Framework-neutral binding for anything that needs a "value in, value out" control: Angular's `ControlValueAccessor`, Svelte, Solid,

package/dist/index.d.ts

@@ -2,7 +2,7 @@ import { Editor, type EditorConfig } from './editor.js';
 import { type PageOptions } from './plugins/index.js';
 export { Editor } from './editor.js';
 export type { EditorConfig, DocxExportOptions } from './editor.js';
-export type { EditorPlugin, ToolbarItem, ToolbarEntry, ToolbarGroup, ToolbarOptions, Command, RibbonContribution, EditorEvent } from './types.js';
+export type { EditorPlugin, ToolbarItem, ToolbarEntry, ToolbarGroup, ToolbarOptions, Command, ContextMenuContext, ContextMenuEntry, ContextMenuItem, RibbonContribution, EditorEvent } from './types.js';
 export { definePlugin } from './types.js';
 export * from './plugins/index.js';
 export declare const defaultPlugins: import("./types.js").EditorPlugin[];

package/dist/plugins/context-menu.d.ts

@@ -0,0 +1,19 @@
+import type { Editor } from '../editor.js';
+import type { ContextMenuContext, ContextMenuEntry, ContextMenuItem, EditorPlugin } from '../types.js';
+export interface ContextMenuOptions {
+    /** Extra items added at the top, for this editor only (plugins add theirs with the `contextMenu` hook). */
+    extra?: (context: ContextMenuContext) => ContextMenuEntry[];
+}
+/** Remove what a read-only editor must not offer, then tidy the separators: none first, last or doubled, and no empty fly-outs. */
+export declare function tidyEntries(entries: ContextMenuEntry[], readOnlyEditor: boolean): ContextMenuEntry[];
+/** Everything a plugin offers for the current selection, grouped by plugin order. */
+export declare function buildContextMenu(editor: Editor, event: MouseEvent | null, extra?: ContextMenuOptions['extra']): ContextMenuEntry[];
+/**
+ * The right-click menu. It shows what applies at the click: clipboard actions, then the items each plugin adds for the
+ * selection (table tools in a table, list tools in a list, link tools on a link, picture tools on a picture…). Plugins add
+ * items with the `contextMenu(context)` hook. Hold Shift while right-clicking to get the browser's own menu (spelling
+ * suggestions from the browser's spell checker live there). It opens from the keyboard with the Menu key or Shift+F10.
+ */
+export declare function ContextMenu(options?: ContextMenuOptions): EditorPlugin;
+/** Select everything: an item other plugins can reuse. */
+export declare const selectAllItem: ContextMenuItem;

package/dist/plugins/helpers.d.ts

@@ -70,3 +70,9 @@ export declare function docIndex<T>(name: string, match: (n: PMNode) => boolean,
         rev: number;
     };
 };
+/** Where the link (or any mark) at the selection starts and ends: the whole run of text that carries the same mark. */
+export declare function markRunAt(state: EditorState, markName: string): {
+    mark: import('prosemirror-model').Mark;
+    from: number;
+    to: number;
+} | null;

package/dist/plugins/index.d.ts

@@ -5,6 +5,8 @@ export { List } from './list.js';
 export { Blocks } from './blocks.js';
 export { Link } from './link.js';
 export { Image } from './image.js';
+export { ContextMenu, buildContextMenu, tidyEntries } from './context-menu.js';
+export type { ContextMenuOptions } from './context-menu.js';
 export { Table } from './table.js';
 export { Autoformat } from './autoformat.js';
 export { Alignment } from './alignment.js';

package/dist/react.js

@@ -1,4 +1,4 @@
-import { t as createEditor } from "./src-BRR721LM.js";
+import { t as createEditor } from "./src-DFClH3tv.js";
 import { createElement, forwardRef, useEffect, useImperativeHandle, useLayoutEffect, useRef } from "react";
 //#region src/react.ts
 /** React wrapper (needs the optional `react` peer dependency). */