wysiwygido 0.1.1 → 0.2.2

package/CHANGELOG.md

@@ -2,8 +2,28 @@
 
 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
+
+The first release that includes the 0.2.0 changes below: 0.2.0 itself was never published to npm.
+
+### Fixed
+- Tables and lists pasted from Word (and Google Docs) were far too loose: every cell and list item carried the browser's 1em paragraph margins, so a one-line table row was about 70 px tall. Paragraphs inside table cells and list items now have no margin, and cell padding and line height are compact (`--wy-cell-pad-y`, `--wy-cell-pad-x`, `--wy-cell-line-height` adjust them). Spacing set on purpose through the paragraph menu still applies.
+
+## [0.2.0] - 2026-10-06
+
+### Changed (breaking)
+- Optional packages are no longer imported by the editor itself. Angular's esbuild builder (and webpack-based builds) failed with `Could not resolve "katex"` (also `mermaid`, `docx`, `mammoth`, `jszip`, `pdfjs-dist`) when those packages were not installed, even though the code only loaded them lazily. Now you pass a loader: `createEditor({ docx: () => import('wysiwygido/docx') })`, `Equations({ katex: () => import('katex') })`, `Mermaid({ mermaid: () => import('mermaid') })`, `PdfEpub({ loadPdf, loadEpub })`. Without one, the feature explains what to add. `pnpm check:optional` fails the build if the main entry ever imports an optional package again.
+- Verified in real apps: React, Vue, Svelte (Vite) and Angular 20 builds, plus a no-build page loading the package from a CDN.
+
 ### Changed
 - Large documents: plugins that derive data from the whole document (captions, table of contents, outline, footnotes, comment anchors) update incrementally instead of rescanning on every keystroke; the word count waits for a pause on big documents; Markdown export is linear. Typing at 10,000 blocks: 33 ms to 1.3 ms per key.
 
@@ -46,6 +66,8 @@ A modular rich-text editor on ProseMirror with a plugin architecture. Everything
 ### Known limitations
 See the README section "Known limitations".
 
-[Unreleased]: https://github.com/galihlasahido/wysiwyg-editor/compare/v0.1.1...HEAD
+[Unreleased]: https://github.com/galihlasahido/wysiwyg-editor/compare/v0.2.1...HEAD
+[0.2.1]: https://github.com/galihlasahido/wysiwyg-editor/compare/v0.1.1...v0.2.1
+[0.2.0]: https://github.com/galihlasahido/wysiwyg-editor/compare/v0.1.1...v0.2.0
 [0.1.1]: https://github.com/galihlasahido/wysiwyg-editor/compare/v0.1.0...v0.1.1
 [0.1.0]: https://github.com/galihlasahido/wysiwyg-editor/releases/tag/v0.1.0

package/README.md

@@ -72,6 +72,18 @@ new Editor({
 });
 ```
 
+**Optional packages are passed in, not imported by the editor.** `docx`, `mammoth`, `katex`, `mermaid`, `pdfjs-dist`, `jszip` and `yjs` are optional. The main entry never imports them (a check in `pnpm check:optional` enforces it), so Angular, webpack, Next.js and esbuild builds work without them installed. When you want a feature, install its package and hand the editor a loader:
+
+```ts
+createEditor({ element, docx: () => import('wysiwygido/docx'),                        // pnpm add docx mammoth
+  plugins: [...defaultPlugins,
+    Equations({ katex: () => import('katex') }),                                      // pnpm add katex
+    Mermaid({ mermaid: () => import('mermaid') }),                                    // pnpm add mermaid
+    PdfEpub({ loadPdf: () => import('wysiwygido/pdf'), loadEpub: () => import('wysiwygido/epub') })] }); // pdfjs-dist, jszip
+```
+
+Without a loader the feature says what to add (`exportDocx()` rejects with the exact line to write). Collaboration is its own entry, `wysiwygido/collab`.
+
 Entry points (optional peer dependencies are only needed for the ones you import):
 
 | Import | Contents | Needs |
@@ -120,7 +132,7 @@ preview, rename, download, delete, multi-select) and `attachment` chips for non-
 unique clean names). `editImage` / `openImageEditor` edit a picture on a canvas: crop (free or fixed ratio), rotate, flip and straighten, resize, brightness, contrast,
 saturation, warmth, blur, nine filters, freehand pen and highlighter, text, undo and redo, zoom (buttons, Ctrl/Cmd + wheel, 100% / Fit) and pan (Space + drag), PNG / JPEG / WebP output. A picture from another site needs CORS; pass `fetchImage` (your own proxy) to edit it anyway. Give `resolveUrl` your upload function to make attachments work for every reader.
 
-**Equations and diagrams** (optional peers `katex` and `mermaid`, loaded only when used): `Equations()` adds inline `$…$` and display
+**Equations and diagrams** (optional peers `katex` and `mermaid`, passed in as shown above and loaded only when used): `Equations({ katex: () => import('katex') })` adds inline `$…$` and display
 LaTeX equations drawn by KaTeX with MathML for screen readers; type `$x^2$`, use the ∑ / ∫ buttons or double-click to edit in a dialog with templates
 (fraction, sum, integral, matrix …) and a live preview; invalid LaTeX shows the error in place. `Mermaid()` adds text-written diagrams (flowchart, sequence,
 class, state, ER, Gantt, pie, mind map) with starter templates and a live preview; it forces `securityLevel: 'strict'`, draws labels as SVG text, strips scripts from the
@@ -153,7 +165,7 @@ Markdown), so exports show it. A reference to a deleted caption says "Missing re
 
 **Recording and dictation**: `Recording()` adds `recordAudio`, `recordScreen`, `stopRecording`, `cancelRecording` and `toggleDictation`. The browser asks permission each time, a bar shows the time while recording, Esc cancels and the tracks are always released. A recording becomes a player in the text, embedded as a data URL (capped by `maxBytes`) or stored by your `upload(blob, kind)` function (recommended for anything long); `maxSeconds` stops it automatically. Dictation uses the browser's speech recognition (Chrome, Edge, Safari; not Firefox), types only text at the cursor, and can be set to a language with `dictationLang`. Word and Markdown export keep a link or label, not the media.
 
-**PDF import and EPUB export**: `PdfEpub()` adds `openPdf` / `importPdf(blob)` and `exportEpub(name?)`; without the plugin use `importPdf` from `wysiwygido/pdf` and `exportEpub` from `wysiwygido/epub`. They need the optional packages `pdfjs-dist` and `jszip` (PDF import also needs `pdf: { workerSrc }`, the URL where you serve pdf.js's worker; with Vite `import workerSrc from 'pdfjs-dist/build/pdf.worker.min.mjs?url'`). PDF import reads **text only**: paragraphs (joined across line ends, hyphenation repaired), headings from larger type and bullet or numbered lists; pictures, tables, multi-column layouts and scanned pages are not recovered (a scan is reported as having no text). The EPUB 3 file starts a chapter at each top-level heading, packs embedded pictures, writes a navigation document, and reduces anything scripted (players, forms) to text; remote pictures are not packed.
+**PDF import and EPUB export**: `PdfEpub({ loadPdf: () => import('wysiwygido/pdf'), loadEpub: () => import('wysiwygido/epub') })` adds `openPdf` / `importPdf(blob)` and `exportEpub(name?)`; without the plugin use `importPdf` from `wysiwygido/pdf` and `exportEpub` from `wysiwygido/epub`. They need the optional packages `pdfjs-dist` and `jszip` (PDF import also needs `pdf: { workerSrc }`, the URL where you serve pdf.js's worker; with Vite `import workerSrc from 'pdfjs-dist/build/pdf.worker.min.mjs?url'`). PDF import reads **text only**: paragraphs (joined across line ends, hyphenation repaired), headings from larger type and bullet or numbered lists; pictures, tables, multi-column layouts and scanned pages are not recovered (a scan is reported as having no text). The EPUB 3 file starts a chapter at each top-level heading, packs embedded pictures, writes a navigation document, and reduces anything scripted (players, forms) to text; remote pictures are not packed.
 
 **AI suggestions, review and chat** (options of `AIAssistant`, all through your own `provider`; the request carries `action: 'complete' | 'review' | 'chat'`):
 `inline: true` (or `{ delayMs, minChars, maxChars }`) shows a grey continuation at the end of a paragraph after you pause: Tab accepts, Esc or any typing dismisses it (one line, plain text, never markup). `aiReview` sends each plain paragraph to the provider and applies the answers as **tracked changes** (needs `TrackChanges`); paragraphs edited meanwhile are skipped, a reply of several lines is ignored, and one Undo takes the whole review back. `chat: true` adds an `aiChat` panel that sends your question, the selection and the document text (up to `contextChars`) and shows replies as text, with "Insert into document" (parsed as Markdown, raw HTML disabled). Document text is sent to your provider: put API keys and any filtering on your server.
@@ -369,7 +381,7 @@ Errors: throw (or return a non-2xx status from `createFetchProvider`) and the pa
 ## Creating a .docx from your code
 
 `editor.exportDocx(options?)` builds the Word file and resolves with a `Blob`; call it from a button, a shortcut, an editor event or before an upload.
-It needs the optional `docx` package, which is loaded only when you call it.
+It needs the optional `docx` package, which is loaded only when you call it: pass `docx: () => import('wysiwygido/docx')` to `createEditor` (see above).
 
 ```ts
 const blob = await editor.exportDocx();                           // just the file
@@ -449,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-oDoQgMwC.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/editor.d.ts

@@ -26,6 +26,12 @@ export interface EditorConfig {
     onChange?: (html: string) => void;
     /** Uploads an image file and resolves to its URL. Defaults to embedding as a Base64 data URL. */
     uploadImage?: (file: File) => Promise<string>;
+    /**
+     * How to load the optional `.docx` support: `docx: () => import('wysiwygido/docx')` (and `pnpm add docx mammoth`). It is a function you pass
+     * rather than something the editor imports itself, so bundlers (Angular, webpack, esbuild) never have to resolve the optional packages.
+     * Without it `exportDocx()` and `importDocx()` throw an error that says what to add.
+     */
+    docx?: () => Promise<typeof import('./docx.js')>;
     /** Start in read-only mode. */
     readOnly?: boolean;
     /** Text direction of the document. Default 'ltr'. */
@@ -70,6 +76,7 @@ export declare class Editor {
      * Needs the optional `docx` package (loaded only when you call this).
      */
     exportDocx(options?: DocxExportOptions): Promise<Blob>;
+    private loadDocx;
     /** Replace the document with the content of a .docx file (one undo step). Resolves with the converter's warnings. Needs the optional `mammoth` package. */
     importDocx(source: Blob | ArrayBuffer): Promise<string[]>;
     private buildToolbar;

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/plugins/math.d.ts

@@ -4,8 +4,10 @@ export interface KatexLike {
     renderToString(tex: string, options?: Record<string, unknown>): string;
 }
 export interface EquationsOptions {
-    /** KaTeX, or a function that loads it. Default: `import('katex')` (an optional peer dependency). */
-    katex?: KatexLike | (() => Promise<KatexLike>);
+    /** KaTeX, or a function that loads it: `() => import('katex')` (an optional peer dependency you install). A module with a `default` export is accepted too. */
+    katex?: KatexLike | (() => Promise<KatexLike | {
+        default: KatexLike;
+    }>);
     /** Replace the renderer entirely. Return HTML (scripts are removed from it). Throw to show an error. */
     render?: (tex: string, display: boolean) => string | Promise<string>;
     /** Extra KaTeX macros, e.g. `{ '\\RR': '\\mathbb{R}' }`. */

package/dist/plugins/mermaid.d.ts

@@ -7,8 +7,10 @@ export interface MermaidLike {
     }>;
 }
 export interface MermaidOptions {
-    /** Mermaid, or a function that loads it. Default: `import('mermaid')` (an optional peer dependency). */
-    mermaid?: MermaidLike | (() => Promise<MermaidLike>);
+    /** Mermaid, or a function that loads it: `() => import('mermaid')` (an optional peer dependency you install). A module with a `default` export is accepted too. */
+    mermaid?: MermaidLike | (() => Promise<MermaidLike | {
+        default: MermaidLike;
+    }>);
     /** Extra Mermaid configuration. `securityLevel` stays 'strict' whatever you pass. */
     config?: Record<string, unknown>;
     /** Longest diagram source accepted, in characters. Default 20000. */

package/dist/plugins/pdf-epub.d.ts

@@ -2,6 +2,10 @@ import type { EditorPlugin } from '../types.js';
 import type { EpubOptions } from '../epub.js';
 import type { PdfImportOptions } from '../pdf.js';
 export interface PdfEpubOptions {
+    /** How to load PDF support: `() => import('wysiwygido/pdf')` (and `pnpm add pdfjs-dist`). */
+    loadPdf?: () => Promise<typeof import('../pdf.js')>;
+    /** How to load EPUB support: `() => import('wysiwygido/epub')` (and `pnpm add jszip`). */
+    loadEpub?: () => Promise<typeof import('../epub.js')>;
     pdf?: PdfImportOptions;
     epub?: EpubOptions;
 }

package/dist/react.js

@@ -1,4 +1,4 @@
-import { t as createEditor } from "./src-oDoQgMwC.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). */