@powerduck/md-editor 0.7.1 → 0.8.2

package/dist/plugins/doclink.d.ts

@@ -0,0 +1,98 @@
+import type { MarkdownIt } from "markdown-it";
+import type { EditorView } from "@codemirror/view";
+/**
+ * A document / article item returned by the search hook.
+ */
+export interface DocItem {
+    /** Unique identifier */
+    id: string;
+    /** Document title */
+    title: string;
+    /** Document URL */
+    url: string;
+    /** Optional thumbnail URL (if known upfront) */
+    thumbnail?: string;
+    /** Optional description / excerpt (if known upfront) */
+    description?: string;
+    /** Allow arbitrary extra fields for consumer use */
+    [key: string]: unknown;
+}
+/**
+ * Fetched metadata for a document URL.
+ */
+export interface DocMeta {
+    title?: string;
+    thumbnail?: string;
+    description?: string;
+}
+/**
+ * Options for the document-link inserter.
+ */
+export interface DocLinkOptions {
+    /**
+     * Hook to search documents by query. Return a list of items (or a Promise).
+     * If not provided, the slash-triggered dropdown is disabled.
+     */
+    onDocSearch?: (query: string) => DocItem[] | Promise<DocItem[]>;
+    /**
+     * Hook to fetch metadata for a URL. Override this to use a backend proxy
+     * and avoid browser CORS restrictions. If not provided, a default fetch +
+     * DOMParser implementation is used (may fail on cross-origin URLs).
+     */
+    onFetchDocMeta?: (url: string) => Promise<DocMeta>;
+    /**
+     * Insert style when a document is selected.
+     * - 'card': always insert a :::doc-link preview card (falls back to link if no meta)
+     * - 'link': always insert a plain markdown link
+     * - 'auto' (default): insert card if metadata is available, link otherwise
+     */
+    insertStyle?: "card" | "link" | "auto";
+    /** Character that triggers the document search dropdown. Default: '/' */
+    triggerChar?: string;
+    /** Minimum query length before searching. Default: 0 */
+    minChars?: number;
+    /** Maximum items shown in dropdown. Default: 8 */
+    maxItems?: number;
+}
+/**
+ * Default implementation: fetch the URL and parse Open Graph / meta tags.
+ * This will fail on cross-origin URLs due to CORS; consumers should override
+ * with onFetchDocMeta using a backend proxy in production.
+ */
+export declare function defaultFetchDocMeta(url: string): Promise<DocMeta>;
+/** Parse OG / meta tags from an HTML string. */
+export declare function parseDocMeta(html: string, baseUrl: string): DocMeta;
+/**
+ * Detects the trigger character (default '/') in the editor and shows a
+ * floating document search dropdown. Handles keyboard navigation and inserts
+ * either a plain link or a :::doc-link preview card on selection.
+ */
+export declare class DocLinkController {
+    private view;
+    private options;
+    private dropdown;
+    private items;
+    private selectedIndex;
+    private trigger;
+    private searchAbort;
+    private destroyed;
+    constructor(view: EditorView, options?: DocLinkOptions);
+    /** Called on every CodeMirror update. */
+    update(): void;
+    /** Handle keyboard events for dropdown navigation. */
+    handleKey(event: KeyboardEvent): boolean;
+    private findTrigger;
+    private runSearch;
+    private show;
+    private renderDropdown;
+    private positionDropdown;
+    private selectItem;
+    /**
+     * Build the markdown insertion string for a selected document.
+     * Fetches metadata if needed and falls back to a plain link.
+     */
+    private buildInsertion;
+    hide(): void;
+    destroy(): void;
+}
+export declare function useDocLinkBlock(md: MarkdownIt): void;

package/dist/plugins/mention.d.ts

@@ -0,0 +1,69 @@
+import type { EditorView } from "@codemirror/view";
+/**
+ * A single item in the @mention dropdown.
+ */
+export interface MentionItem {
+    /** Unique identifier */
+    id: string;
+    /** Display label shown in the dropdown */
+    label: string;
+    /** Optional avatar URL */
+    avatar?: string;
+    /** Optional secondary text (e.g. email, role) */
+    description?: string;
+    /** Allow arbitrary extra fields for consumer use */
+    [key: string]: unknown;
+}
+/**
+ * Options for the mention controller.
+ */
+export interface MentionOptions {
+    /**
+     * Hook to search for mention items based on the query text after @.
+     * Return a list of items (or a Promise that resolves to one).
+     * If not provided, no dropdown is shown.
+     */
+    onMentionSearch?: (query: string) => MentionItem[] | Promise<MentionItem[]>;
+    /**
+     * Hook called when an item is selected. Return the text to insert at the
+     * cursor (replacing the @query). If not provided, defaults to `@${item.label}`.
+     */
+    onMentionSelect?: (item: MentionItem) => string;
+    /** Minimum query length before showing dropdown. Default: 0 (show on @). */
+    minChars?: number;
+    /** Maximum items shown in dropdown. Default: 8. */
+    maxItems?: number;
+}
+/**
+ * Detects @mention triggers in the editor and shows a floating dropdown.
+ * Handles keyboard navigation (ArrowUp/Down, Enter, Escape) and mouse click.
+ */
+export declare class MentionController {
+    private view;
+    private options;
+    private dropdown;
+    private items;
+    private selectedIndex;
+    private trigger;
+    private searchAbort;
+    private destroyed;
+    constructor(view: EditorView, options?: MentionOptions);
+    /**
+     * Called on every CodeMirror update. Detects @ triggers and manages
+     * the dropdown visibility.
+     */
+    update(): void;
+    /**
+     * Handle keyboard events for dropdown navigation.
+     * Returns true if the event was handled (and should not propagate).
+     */
+    handleKey(event: KeyboardEvent): boolean;
+    private findTrigger;
+    private runSearch;
+    private show;
+    private renderDropdown;
+    private positionDropdown;
+    private selectItem;
+    hide(): void;
+    destroy(): void;
+}

package/dist/plugins/mindmap.d.ts

@@ -5,6 +5,13 @@ import type { MarkdownIt } from "markdown-it";
  * asynchronously in hydrateMindmaps() because markdown-it renders strings
  * synchronously while markmap requires real DOM nodes.
  *
+ * NESTED FENCE SUPPORT: Unlike markdown-it's built-in fence rule (which
+ * closes a 3-backtick fence at the first 3-backtick line, losing nested
+ * code content), this custom block rule tracks nesting depth. A line with
+ * backticks + an info string (e.g. ```js) opens a nested fence; a line with
+ * only backticks closes one. The mindmap block only closes when depth
+ * returns to 0. This allows code examples inside mindmap outlines.
+ *
  * Usage (in the editor markdown source):
  *
  * ```mindmap

package/dist/plugins/popup.d.ts

@@ -9,6 +9,7 @@ export interface PopupConfig {
     title: string;
     fields: readonly PopupField[];
     submitLabel?: string;
+    theme?: 'light' | 'dark';
     onSubmit: (values: Record<string, string>) => void;
 }
 /**

package/dist/plugins/tasklist.d.ts

@@ -0,0 +1,7 @@
+import type { MarkdownIt } from "markdown-it";
+/**
+ * Lightweight task list (checkbox) support for markdown-it.
+ * Converts `- [ ]` and `- [x]` list items into checkboxes without
+ * requiring the full markdown-it-task-lists dependency.
+ */
+export declare function useTaskList(md: MarkdownIt): void;