markdown-text-editor 1.7.0 → 1.9.0

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "markdown-text-editor",
-  "version": "1.7.0",
+  "version": "1.9.0",
   "type": "module",
-  "description": "Lightweight Markdown editor with hybrid WYSIWYG mode, real-time preview, and zero-config setup. Works with any backend via native textarea.",
+  "description": "A markdown editor that enhances your textarea instead of replacing it, so form submission, validation and required fields keep working. WYSIWYG hybrid mode, live preview, find and replace, RTL, TypeScript types. Works with any backend.",
   "funding": "https://ko-fi.com/nezanuha",
   "main": "./dist/markdown-text-editor.umd.js",
   "module": "./dist/markdown-text-editor.es.js",
@@ -32,7 +32,8 @@
     "build": "vite build",
     "preview": "vite preview",
     "prepublishOnly": "npm run build",
-    "postversion": "git push origin main --tags",
+    "version": "node scripts/check-changelog.mjs",
+    "postversion": "git push origin HEAD --follow-tags",
     "test": "node test/smoke.mjs",
     "typecheck": "tsc --noEmit --strict --lib es2020,dom --moduleResolution bundler --module esnext test/types.test.ts"
   },
@@ -60,7 +61,12 @@
     "csp compatible",
     "form markdown editor",
     "live preview",
-    "mde"
+    "mde",
+    "typescript",
+    "markdown-it",
+    "template editor",
+    "merge tags",
+    "placeholders"
   ],
   "author": "Nezanuha",
   "license": "MIT",
@@ -69,20 +75,20 @@
     "url": "https://github.com/nezanuha/markdown-text-editor/issues"
   },
   "dependencies": {
-    "dompurify": "^3.4.15",
-    "marked": "~18.0.12"
+    "dompurify": "^3.4.16",
+    "marked": "~18.0.14"
   },
   "devDependencies": {
     "@tailwindcss/postcss": "^4.3.3",
     "@tailwindcss/typography": "^0.5.20",
     "@tailwindcss/vite": "^4.3.3",
     "diff": "^9.0.0",
-    "frutjam": "^2.2.5",
-    "happy-dom": "^20.14.3",
+    "frutjam": "^2.2.6",
+    "happy-dom": "^20.14.5",
     "postcss": "^8.5.28",
     "tailwindcss": "^4.3.3",
     "typescript": "^7.0.2",
-    "vite": "^8.3.0",
+    "vite": "^8.3.1",
     "vite-plugin-css-injected-by-js": "^5.0.2"
   },
   "types": "./types/index.d.ts"

package/types/index.d.ts

@@ -65,7 +65,58 @@ export interface ImageTool {
     };
 }
 
-export type ToolbarEntry = ToolName | VariablesTool | ImageTool;
+/**
+ * A tool of your own. Extend `MarkdownEditor.Tool`, set `this.button` in the
+ * constructor, and implement `applySyntax()`.
+ *
+ * @example
+ * class ShoutTool extends MarkdownEditor.Tool {
+ *     constructor(editor) {
+ *         super(editor, 'Shout');
+ *         this.button = this.createButton('<svg>…</svg>');
+ *     }
+ *     applySyntax() { this.editor.insertText('**LOUD**'); }
+ * }
+ */
+export type CustomTool = new (editor: MarkdownEditor, config?: any) => {
+    /** Appended to the toolbar. Return `null` to render nothing. */
+    button: HTMLElement | null;
+};
+
+/**
+ * A toolbar button described rather than written as a class. The usual way to
+ * add your own tool.
+ *
+ * @example
+ * { custom: {
+ *     title: 'Insert accordion',
+ *     icon: '<svg>…</svg>',
+ *     action(editor) { editor.insertText('<div class="accordion">…</div>'); }
+ * }}
+ */
+export interface DeclarativeTool {
+    custom: {
+        /** Tooltip, and the source of the button's CSS class. Translatable via `labels`. */
+        title: string;
+        /** Inline SVG for the button face. */
+        icon?: string;
+        /** Runs on click. The event is passed on for handing to `MarkdownEditor.modal`. */
+        action: (editor: MarkdownEditor, event: Event) => void;
+        /**
+         * Keyboard shortcut, e.g. `'Ctrl+Shift+K'`. Appended to the tooltip, and
+         * takes precedence over a built-in using the same combination.
+         */
+        shortcut?: string;
+    };
+}
+
+export type ToolbarEntry =
+    | ToolName
+    | VariablesTool
+    | ImageTool
+    | DeclarativeTool
+    | CustomTool
+    | { tool: CustomTool; config?: any };
 
 /** Status bar fields. `false` hides the bar entirely. */
 export interface FooterOptions {
@@ -113,6 +164,15 @@ export interface MarkdownEditorOptions {
     /** Called on every content change with the current markdown. */
     onChange?: (value: string) => void;
 
+    /**
+     * Translations for the editor's own interface, keyed by the English text:
+     * tooltips, menu items, modal fields and buttons. Anything not listed stays
+     * in English. CSS class names are unaffected.
+     *
+     * @example labels: { Bold: 'Negrita', 'Insert variable': 'Insertar variable' }
+     */
+    labels?: Record<string, string>;
+
     /**
      * Replaces the markdown parser used for the preview. Must be synchronous and
      * return an HTML string. Affects the preview pane only; hybrid mode's live
@@ -138,12 +198,53 @@ export interface MarkdownEditorOptions {
     sanitizer?: (html: string) => string;
 }
 
+/** Base class for toolbar tools. Reach it as `MarkdownEditor.Tool`. */
+export declare class Tool {
+    constructor(editor: MarkdownEditor, title: string);
+    readonly editor: MarkdownEditor;
+    /** The element appended to the toolbar. Set it to `null` to render nothing. */
+    button: HTMLElement | null;
+    /** Builds the default square icon button. Override for a dropdown or similar. */
+    createButton(iconHtml?: string): HTMLElement | null;
+    /** Called when the button is clicked, or its shortcut is pressed. */
+    applySyntax(event?: Event): void;
+    /** Set to e.g. `'Ctrl+Shift+K'` to bind a shortcut. */
+    shortcut?: string;
+    /** Implement to release anything the tool registered. Called by `destroy()`. */
+    destroy?: () => void;
+}
+
 export default class MarkdownEditor {
     /**
      * @param selector A CSS selector for a `<textarea>`, or the element itself.
      */
     constructor(selector: string | HTMLTextAreaElement, options?: MarkdownEditorOptions);
 
+    /** Base class for writing your own toolbar tool. */
+    static Tool: typeof Tool;
+
+    /** The dialog helper the built-in link and image tools use. */
+    static modal: (event: Event, size: string, bodyHTML: string, label?: string) => HTMLDialogElement;
+
+    /** Returns the translation for a UI string, or the string itself. */
+    label(text: string): string;
+
+    /**
+     * Renders markdown to sanitized HTML exactly as the preview does, honouring
+     * the configured `renderer` and `sanitizer`. For custom tools that need to
+     * embed rendered content, such as a tooltip body.
+     */
+    renderMarkdown(markdown: string): string;
+
+    /**
+     * Builds a small toolbar bound to another textarea, for a custom tool that
+     * collects rich text in its own dialog. The tools are the real ones, and
+     * `labels` are inherited. Returns the element; append it where you like.
+     *
+     * No preview button is added, whatever you pass.
+     */
+    createToolbar(textarea: HTMLTextAreaElement, tools?: ToolbarEntry[]): HTMLDivElement;
+
     /** The original textarea. Its `.value` is always the current markdown. */
     readonly usertextarea: HTMLTextAreaElement;