@powerduck/md-editor 0.3.0 → 0.6.0

package/dist/index.d.ts

@@ -1,6 +1,21 @@
 import './styles/editor.css';
 export type EditorMode = 'simple' | 'complex';
 export type EditorTheme = 'light' | 'dark';
+/** Per-item toolbar override. */
+export interface ToolbarItemOverride {
+    /** Show this item. Default: true */
+    show?: boolean;
+    /** Custom tooltip / aria-label */
+    label?: string;
+    /** Custom icon as HTML string */
+    icon?: string;
+}
+/**
+ * Toolbar configuration. Either:
+ * - An array of action names to show (include-list), or
+ * - A record of action-name -> override for fine-grained control.
+ */
+export type ToolbarConfig = string[] | Record<string, ToolbarItemOverride>;
 export interface MarkdownEditorOptions {
     /** Initial content */
     value?: string;
@@ -13,21 +28,20 @@ export interface MarkdownEditorOptions {
     mindmap?: boolean;
     /** Enable syntax highlighting for code blocks. Default: true. */
     codeHighlight?: boolean;
+    /** Enable admonition/tip blocks. Default: true. */
+    tips?: boolean;
     /** Show the preview pane. Default: true. */
     preview?: boolean;
     onChange?: (value: string) => void;
+    /** Configure which toolbar items show, and their labels/icons. */
+    toolbar?: ToolbarConfig;
     /**
-     * Preview debounce in milliseconds. Defaults to adaptive based on document
-     * length (see adaptiveDebounceMs). Pass false to disable debounce (not
-     * recommended for large documents).
+     * Hook for image upload. Called when a user pastes, drops, or selects an
+     * image file via the image popup. Return a Promise that resolves to the
+     * image URL. The URL is inserted as `![alt](url)` at the cursor.
      */
+    onImageUpload?: (file: File) => Promise<string>;
     renderDebounce?: number | false;
-    /**
-     * Auto-preview on every edit. Default: true.
-     * For very large documents (hundreds of thousands of characters), set to
-     * false and trigger preview manually via the "Refresh preview" button or
-     * renderNow() to eliminate all rendering overhead during typing.
-     */
     autoPreview?: boolean;
 }
 export declare class MarkdownEditor {
@@ -47,17 +61,31 @@ export declare class MarkdownEditor {
     private autoPreview;
     private renderDebounceOpt;
     private onChange?;
+    private onImageUpload?;
+    private toolbarConfig?;
+    private shortcuts;
     private scheduledRender;
     private scheduledWait;
     constructor(container: HTMLElement | string, options?: MarkdownEditorOptions);
     private buildLayout;
+    private isActionVisible;
+    private getActionLabel;
+    private getActionIcon;
     private buildToolbar;
     private buildStatusBar;
+    private setupKeyboardShortcuts;
+    private executeAction;
     private showImagePopup;
     private showVideoPopup;
     private showYouTubePopup;
+    private showTablePopup;
+    private generateTable;
+    private showHelpPopup;
+    private handleImageFile;
+    private showTipsPopup;
     private setupCopyHandler;
     private insertSnippet;
+    private wrapSnippet;
     private togglePreview;
     private requestPreviewRender;
     private renderPreview;
@@ -65,17 +93,15 @@ export declare class MarkdownEditor {
     getValue(): string;
     setValue(value: string): void;
     getHtml(): string;
-    /** Manually trigger a preview render (use when autoPreview is false). */
     renderNow(): void;
     setAutoPreview(auto: boolean): void;
-    /** Switch between simple and complex modes at runtime. */
     setMode(mode: EditorMode): void;
     setTheme(theme: EditorTheme): void;
     focus(): void;
     destroy(): void;
 }
 export { CodeEditor } from './Editor.js';
-export { Renderer, type RendererOptions } from './Renderer.js';
+export { Renderer, renderMarkdown, type RendererOptions } from './Renderer.js';
 export { Toolbar, type ToolbarAction } from './Toolbar.js';
 export { StatusBar, countText } from './StatusBar.js';
 export { IncrementalRenderer } from './perf/IncrementalRenderer.js';
@@ -84,3 +110,4 @@ export { debounce, adaptiveDebounceMs, scheduleIdle, cancelIdle } from './perf/s
 export { icons, type IconName } from './icons.js';
 export { Popup, type PopupConfig, type PopupField } from './plugins/popup.js';
 export { extractYouTubeId, youTubeEmbedMarkdown, imageMarkdown, videoMarkdown, isVideoFile } from './plugins/media.js';
+export { DEFAULT_SHORTCUTS, matchShortcut, formatShortcut, formatShortcutHtml, type ShortcutDef } from './plugins/keyboard.js';