@powerduck/md-editor 0.7.1 → 0.8.2

package/README.md

@@ -22,6 +22,7 @@ High-performance embeddable Markdown editor built on the markdown-it ecosystem.
 - **Simple / Complex modes** -- toggle toolbar and status bar at runtime
 - **Light / Dark themes** -- CSS custom properties, inherits host design tokens
 - **React component** -- `forwardRef` with imperative handle
+- **Zero Chinese** -- all code, comments, and UI strings in American English
 
 ## Installation
 
@@ -246,6 +247,42 @@ npm run build           # vite build + d.ts generation
 
 ## Changelog
 
+### v0.8.2
+
+- **Fixed**: @mention and `/` doc-link dropdowns did not appear. Root cause: v0.8.1 mounted dropdowns inside `.md-editor-root` where ancestor `overflow:hidden` / stacking contexts could clip or misplace `position:fixed` elements. Reverted to `document.body` mounting with `position:fixed`, and added explicit light/dark colors via `data-theme` attribute (no dependency on editor-scoped CSS variables).
+- **Fixed**: Clicking toolbar button icons (SVG) did not open popups. Root cause: `mousedown` event bubbled to `document` and triggered the newly-opened Popup's outside-click handler (because `e.target` was the SVG, not the button). Fixed in two ways: Popup now uses `anchor.contains(target)` instead of `target !== anchor`; toolbar `mousedown` handler calls `e.stopPropagation()`.
+- **Fixed**: Task list checkboxes now render with a clear green checkmark when checked (`- [x]` or `- [X]`). Previously used native `accent-color` (orange) which was hard to distinguish in disabled state. Custom checkbox: gray border when unchecked, solid green with white checkmark when checked.
+- **Added**: Help dialog now includes a "Syntax" section with quick-reference guidance for task lists, @mentions, document links, math, mindmaps, and callouts.
+- **Fixed**: Help dialog and all popup-internal styles no longer use editor-scoped CSS variables (undefined when popup is on `document.body`), ensuring consistent light/dark rendering.
+- **Test**: 310 tests, all passing, zero unhandled errors.
+
+### v0.8.1
+
+- **Fixed**: Toolbar buttons now use `mousedown` + `preventDefault` instead of `click`, preventing the editor from losing focus and collapsing the selection before wrap operations. This fixes the long-standing issue where selecting text and clicking quote/list/other toolbar buttons replaced the selection with placeholder text ("quoted text", "list item").
+- **Fixed**: `toggleTaskList()` mixed-state logic. Previously, a mix of checked and unchecked items (or all-unchecked) removed all task markers. Now: mixed or all-unchecked → check all; all-checked → uncheck all. Also supports uppercase `[X]` markers.
+- **Fixed**: Code block copy button now falls back to `document.execCommand('copy')` when `navigator.clipboard` is unavailable (non-HTTPS contexts), instead of silently failing.
+- **Fixed**: @mention and doc-link dropdowns now close when the editor loses focus (blur), with a 150ms delay so clicks on the dropdown itself register first.
+- **Fixed**: @mention and doc-link dropdowns had transparent backgrounds because they used editor-scoped CSS variables (`--_surface`) while being appended to `document.body`. Now appended inside `.md-editor-root` with `position: fixed` (not clipped by `overflow: hidden`), so theme variables resolve correctly.
+- **Fixed**: Popup dialogs (image, video, YouTube, table, help, callout) now respect the editor theme. Previously always light-themed; now dark-themed when the editor is in dark mode.
+- **Test**: 310 tests, all passing, zero unhandled errors.
+
+### v0.8.0
+
+- **Added**: Document/article link inserter. Type `/` to open a searchable dropdown of documents. `onDocSearch(query)` returns matching documents; on selection, inserts either a plain markdown link or a `:::doc-link` preview card.
+- **Added**: `:::doc-link` preview card rendering — displays title, thumbnail, description, and domain as a clickable card. Auto-fetches Open Graph / meta tags via `onFetchDocMeta(url)` hook; falls back to plain link when metadata is unavailable or fetch fails.
+- **Added**: `insertStyle` option: `'auto'` (default, card when meta available), `'card'` (always card, fallback to link), `'link'` (always plain link).
+- **Added**: `docLink` option to `MarkdownEditorOptions` and `CodeEditorOptions`, with `triggerChar`, `minChars`, `maxItems` configuration.
+- **Added**: Toolbar button for document link insertion.
+- **Test**: 307 tests, all passing, zero unhandled errors.
+
+### v0.7.0
+
+- **Fixed**: Mindmap nested code fences no longer lose content. Custom block rule tracks fence nesting depth (lines with info string open, bare backticks close), so ` ```js ` inside a ` ```mindmap ` block is preserved.
+- **Added**: Task list (checkbox) toolbar button and `toggleTaskList()` API. Toggles `- [ ]` / `- [x]` on current line or selected lines. Renders as checkboxes in preview. Keyboard shortcut: `Ctrl+Shift+9`.
+- **Added**: @mention dropdown with configurable hooks. `onMentionSearch(query)` returns matching items, `onMentionSelect(item)` returns replacement text. Supports keyboard navigation (ArrowUp/Down, Enter, Escape), avatars, descriptions, `minChars`, and `maxItems` options.
+- **Added**: `mention` option to `MarkdownEditorOptions` and `CodeEditorOptions`.
+- **Test**: 281 tests, all passing, zero unhandled errors.
+
 ### v0.6.0
 
 - **Fixed**: Mindmap `transform: translate(NaN,NaN) scale(NaN)` console errors (hundreds per mindmap). Root cause: `autoFit: true` computed transform on zero-size SVG before layout, and d3-zoom scheduled hundreds of animation frames each throwing "Expected number". Fix: create with `autoFit: false`, set safe default transform immediately, defer `fit()` to next animation frame with dimension guard.

package/dist/Editor.d.ts

@@ -1,4 +1,6 @@
 import { EditorView } from '@codemirror/view';
+import { type MentionOptions } from './plugins/mention.js';
+import { type DocLinkOptions } from './plugins/doclink.js';
 export interface CodeEditorOptions {
     value: string;
     onChange?: (value: string) => void;
@@ -7,12 +9,18 @@ export interface CodeEditorOptions {
     placeholder?: string;
     /** Called when an image file is pasted or dropped into the editor. */
     onImageFile?: (file: File) => void;
+    /** @mention dropdown configuration */
+    mention?: MentionOptions;
+    /** Document link inserter configuration */
+    docLink?: DocLinkOptions;
 }
 export declare class CodeEditor {
     readonly view: EditorView;
     private lineNumbersCompartment;
     private customKeymapCompartment;
     private onImageFile?;
+    private mention;
+    private docLink;
     constructor(container: HTMLElement, options: CodeEditorOptions);
     private handlePaste;
     private handleDrop;
@@ -41,5 +49,17 @@ export declare class CodeEditor {
      */
     wrapLines(prefix: string, placeholder: string): void;
     focus(): void;
+    /** Insert @ at cursor and trigger the mention dropdown. */
+    insertMention(): void;
+    /** Insert trigger char at cursor and trigger the doc-link search dropdown. */
+    insertDocLink(): void;
+    /**
+     * Toggle task list (checkbox) markers on the current line or selected
+     * lines. If a line already has `- [ ]` or `- [x]`, the marker is removed.
+     * If a line has `- ` (plain list), it is converted to `- [ ] `. Otherwise
+     * `- [ ] ` is prepended. Lines with `- [x]` are toggled to `- [ ]` and
+     * vice versa when all selected lines are task items.
+     */
+    toggleTaskList(): void;
     destroy(): void;
 }

package/dist/icons.d.ts

@@ -10,6 +10,9 @@ export declare const icons: {
     readonly quote: string;
     readonly list: string;
     readonly listOrdered: string;
+    readonly taskList: string;
+    readonly mention: string;
+    readonly fileText: string;
     readonly table: string;
     readonly hr: string;
     readonly alert: string;