wysiwygido 0.1.0 → 0.2.1

package/CHANGELOG.md

@@ -4,10 +4,28 @@ All notable changes to this project are documented here. The format follows [Kee
 
 ## [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.
 
-## [0.1.0] - first public release
+## [0.1.1] - 2026-10-06
+
+### Fixed
+- `wysiwygido/package.json` can be imported (it is now listed in `exports`), which tools that read the package version expect.
+
+## [0.1.0] - 2026-10-05 - first public release
 
 The package is named `wysiwygido` (the `wysiwyg-editor` name on npm belongs to another project). Builds are not minified and ship with source maps; your bundler minifies.
 
@@ -41,5 +59,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.0...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

@@ -7,7 +7,7 @@ A modular rich-text editor in TypeScript, inspired by [CKEditor 5](https://ckedi
 built on [ProseMirror](https://prosemirror.net/). The long-term goal is a **Google Docs-style editor for the web**:
 paged layout, comments, suggestions, real-time collaboration, `.docx` import/export, and a backend to store and share documents.
 
-Everything is opt-in plugins; the core is small. It is **not published to npm yet** (the package will be named `wysiwygido`): clone, `pnpm install`, `pnpm build`.
+Everything is opt-in plugins; the core is small. Install from npm (the first release is tagged `next`): `pnpm add wysiwygido@next`, then `import { createEditor } from 'wysiwygido'` and `import 'wysiwygido/style.css'`. To work on the repository itself: clone, `pnpm install`, `pnpm dev`.
 
 ```sh
 pnpm install
@@ -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

package/dist/adapter.js

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

package/dist/{src-oDoQgMwC.js → src-BRR721LM.js}

@@ -3508,12 +3508,7 @@ var Editor = class {
 	* Needs the optional `docx` package (loaded only when you call this).
 	*/
 	async exportDocx(options = {}) {
-		let mod;
-		try {
-			mod = await import("./docx.js");
-		} catch {
-			throw new Error("Creating a .docx needs the \"docx\" package. Install it with: pnpm add docx");
-		}
+		const mod = await this.loadDocx("Creating a .docx", "docx");
 		const { download: save, ...rest } = options;
 		const blob = await mod.exportDocx(this, rest);
 		if (save) {
@@ -3526,15 +3521,18 @@ var Editor = class {
 		});
 		return blob;
 	}
-	/** Replace the document with the content of a .docx file (one undo step). Resolves with the converter's warnings. Needs the optional `mammoth` package. */
-	async importDocx(source) {
-		let mod;
+	async loadDocx(what, pkg) {
+		const load = this.config.docx;
+		if (!load) throw new Error(`${what} needs the docx module. Pass it when you create the editor: createEditor({ docx: () => import('wysiwygido/docx') }) and install the "${pkg}" package (pnpm add docx mammoth).`);
 		try {
-			mod = await import("./docx.js");
+			return await load();
 		} catch {
-			throw new Error("Opening a .docx needs the \"mammoth\" package. Install it with: pnpm add mammoth");
+			throw new Error(`${what} needs the "${pkg}" package. Install it with: pnpm add docx mammoth`);
 		}
-		const warnings = await mod.importDocx(this, source);
+	}
+	/** Replace the document with the content of a .docx file (one undo step). Resolves with the converter's warnings. Needs the optional `mammoth` package. */
+	async importDocx(source) {
+		const warnings = await (await this.loadDocx("Opening a .docx", "mammoth")).importDocx(this, source);
 		this.emit("import", {
 			format: "docx",
 			warnings
@@ -14493,10 +14491,12 @@ function Equations(options = {}) {
 	const loadKatex = () => {
 		katexPromise ??= (async () => {
 			const k = options.katex;
-			if (typeof k === "function") return k();
+			if (typeof k === "function") {
+				const m = await k();
+				return "default" in m && m.default ? m.default : m;
+			}
 			if (k) return k;
-			const mod = await import("katex");
-			return mod.default ?? mod;
+			throw new Error("KaTeX is not set up. Pass it when you add the plugin: Equations({ katex: () => import('katex') }) and install the \"katex\" package.");
 		})();
 		return katexPromise;
 	};
@@ -14801,10 +14801,12 @@ function Mermaid(options = {}) {
 	const load = () => {
 		mermaidPromise ??= (async () => {
 			const m = options.mermaid;
-			if (typeof m === "function") return m();
+			if (typeof m === "function") {
+				const mod = await m();
+				return "default" in mod && mod.default ? mod.default : mod;
+			}
 			if (m) return m;
-			const mod = await import("mermaid");
-			return mod.default ?? mod;
+			throw new Error("Mermaid is not set up. Pass it when you add the plugin: Mermaid({ mermaid: () => import('mermaid') }) and install the \"mermaid\" package.");
 		})();
 		return mermaidPromise;
 	};
@@ -16856,7 +16858,7 @@ function PdfEpub(options = {}) {
 		name: "pdf-epub",
 		setup(editor) {
 			editor.registerCommand("importPdf", (e, source) => {
-				import("./pdf.js").then((m) => m.importPdf(e, source, options.pdf)).then((warnings) => e.emit("import", {
+				(options.loadPdf ? options.loadPdf() : Promise.reject(/* @__PURE__ */ new Error("PDF support is not set up. Pass loadPdf: () => import('wysiwygido/pdf') and install pdfjs-dist."))).then((m) => m.importPdf(e, source, options.pdf)).then((warnings) => e.emit("import", {
 					format: "pdf",
 					warnings
 				})).catch((err) => fail(e, err));
@@ -16874,7 +16876,7 @@ function PdfEpub(options = {}) {
 				return true;
 			});
 			editor.registerCommand("exportEpub", (e, name) => {
-				import("./epub.js").then(async (m) => {
+				(options.loadEpub ? options.loadEpub() : Promise.reject(/* @__PURE__ */ new Error("EPUB support is not set up. Pass loadEpub: () => import('wysiwygido/epub') and install jszip."))).then(async (m) => {
 					const blob = await m.exportEpub(e, options.epub);
 					if (name !== "") download(blob, `${(name ?? options.epub?.title ?? "document").replace(/[^\w .-]/g, "_")}.epub`, "application/epub+zip");
 					e.emit("export", {
@@ -17608,4 +17610,4 @@ function createEditor(config) {
 //#endregion
 export { colName as $, getOutline as $t, Mermaid as A, cleanFileName as An, ConflictError as At, openImageEditor as B, Ribbon as Bn, CommentStore as Bt, DEFAULT_EMBED_PROVIDERS as C, Editor as Cn, Templates as Ct, MemoryDraftStore as D, IndexedDBFileStore as Dn, createFetchProvider as Dt, IndexedDBDraftStore as E, printDocument as En, DEFAULT_AI_ACTIONS as Et, addFiles as F, download as Fn, VersionStore as Ft, formatBytes as G, ICONS as Gn, createLanguageToolProvider as Gt, NEUTRAL as H, RestrictedEditing as Hn, TableOfContents as Ht, matchesAccept as I, exportHTML as In, Versions as It, foldEnds as J, registerIcon as Jn, FindReplace as Jt, CodeAdvanced as K, hasIcon as Kn, Footnotes as Kt, openFileManager as L, WordCount as Ln, localStorageVersions as Lt, MATH_SNIPPETS as M, fileKind as Mn, createEndpointSaver as Mt, FileManager as N, isRasterImage as Nn, createHttpSaver as Nt, Offline as O, MemoryFileStore as On, Autosave as Ot, DEFAULT_BLOCKED as P, uniqueName as Pn, Mentions as Pt, TableFormulas as Q, Outline as Qt, readImageSize as R, getStats as Rn, TrackChanges as Rt, parseOptions as S, markerStyle as Sn, DEFAULT_TEMPLATES as St, resolveEmbed as T, marginContent as Tn, AIAssistant as Tt, applyAdjustments as U, SPECIAL_CHARACTERS as Un, SpellCheck as Ut, FILTER_PRESETS as V, applyContributions as Vn, Comments as Vt, boxBlur as W, SpecialCharacters as Wn, cleanIssues as Wt, parseDiagram as X, registerLocale as Xn, findMatches as Xt, Diagram as Y, isRtlLocale as Yn, buildMatcher as Yt, renderDiagram as Z, translate as Zn, isRiskyRegex as Zt, collectCaptions as _, Essentials as _n, BalloonToolbar as _t, CodeEditor as a, FONT_SIZES as an, findMatchingBracket as at, cleanValue as b, isGoogleDocsHTML as bn, currentBlock as bt, toEmailHTML as c, Autoformat as cn, resolveLanguage as ct, PdfEpub as d, Image$1 as dn, formatHtml as dt, PAGE_SIZES as en, computeFormulasInHTML as et, Recording as f, Link as fn, MergeFields as ft, Captions as g, BasicStyles as gn, SlashCommands as gt, Columns as h, Heading as hn, DEFAULT_SLASH_COMMANDS as ht, splitSlides as i, FONT_FAMILIES as in, CodeEditing as it, Equations as j, createFileStore as jn, DocumentClient as jt, MERMAID_TEMPLATES as k, ResilientFileStore as kn, ApiError as kt, toEmailText as l, Table as ln, simpleHighlight as lt, Charts as m, List as mn, renderMergeFields as mt, defaultPlugins as n, paginate as nn, formatValue as nt, createCodeEditor as o, Fonts as on, CodeBlocks as ot, isSafeClip as p, Blocks as pn, getMergeFields as pt, foldEnd as q, icon as qn, FormatPainter as qt, defineEditorElement as r, TaskList as rn, isErrorValue as rt, languageForFilename as s, Alignment as sn, DEFAULT_LANGUAGES as st, createEditor as t, Pages as tn, evaluateGrid as tt, definePlugin as u, Colors as un, SourceEditing as ut, FIELD_META as v, cleanPastedHTML as vn, Office as vt, Embeds as w, buildPrintHTML as wn, Direction as wt, listFields as x, isWordHTML as xn, setBlockAttrs as xt, FormFields as y, hasPasteableText as yn, ParagraphFormat as yt, rejectReason as z, DEFAULT_RIBBON as zn, getChanges as zt };
 
-//# sourceMappingURL=src-oDoQgMwC.js.map
+//# sourceMappingURL=src-BRR721LM.js.map