@llui/markdown-editor 0.3.0 → 0.5.0

package/dist/plugins/frontmatter.js

@@ -0,0 +1,281 @@
+// YAML frontmatter plugin — the leading `---` … `---` metadata block.
+//
+// ## Why the block is an OPAQUE STRING, not parsed YAML
+//
+// Deliberate choice, and the requirement that drove it is round-trip fidelity:
+// what the author wrote must come back out byte-for-byte. Two options exist —
+// parse YAML properly, or don't parse it at all — and only the second is
+// achievable here:
+//
+//   - Parsing correctly means a real YAML 1.2 implementation (anchors, aliases,
+//     tags, flow/block collections, the five scalar styles, folded/literal block
+//     scalars with their indentation-indicator and chomping rules). Nothing
+//     smaller is *correct*, and a correct parser is not enough by itself: a
+//     round-trip also needs a comment- and style-preserving EMITTER, because
+//     `parse` → `stringify` normalizes quoting, key order, indentation and drops
+//     comments outright. That is a large dependency (this package deliberately
+//     dropped Prism from `@lexical/code` for exactly this reason — see
+//     `code-language.ts`) to buy a feature the editor does not need: it never
+//     interprets frontmatter, it only has to preserve it.
+//
+//   - The naive middle ground — split each line on the first `:` into a
+//     `Record<string, string>` — is what the reference implementation this was
+//     modelled on does, and it is strictly WORSE than not parsing. Nested maps,
+//     sequences, block scalars, quoted values containing `:`, comments and blank
+//     lines are all silently flattened or destroyed. A lossy parse presented as
+//     structured data is a data-loss bug wearing a feature's clothes.
+//
+// So the block is stored verbatim as a single `source` string and re-emitted
+// between two fences. Consumers that *want* structure own that choice: hand
+// `$getFrontmatter()` to whatever YAML library they already ship, or supply
+// `render` to draw a preview. The editor stays honest about not understanding it.
+//
+// The one unavoidable deviation from byte-for-byte: `$convertFromMarkdownString`
+// runs `normalizeMarkdown`, which `trimEnd()`s every line BEFORE any transformer
+// is consulted, so trailing whitespace inside the block is lost. That happens
+// upstream of every transformer and cannot be intercepted from one. YAML treats
+// trailing spaces as insignificant, so nothing meaningful changes. Likewise a
+// body that is empty or only blank lines normalizes to the canonical `---\n---`.
+//
+// ## The `---` collision with `hrPlugin`
+//
+// `hrPlugin`'s ELEMENT transformer matches `/^(---|\*\*\*|___)\s*$/`, so before
+// this plugin existed a leading frontmatter block parsed as a horizontal rule
+// followed by loose prose. Telling consumers to drop `hrPlugin` is not a fix:
+// `---` is legitimately both things, and which one it is depends on POSITION and
+// CLOSURE, not on which plugin is loaded.
+//
+// The resolution is structural, not ordering-based. `@lexical/markdown`'s
+// importer tries EVERY multiline-element transformer on a line before ANY
+// element transformer (`$importMultiline` runs first in `$importMarkdownNodes`;
+// export mirrors it with `[...multilineElement, ...element]`). This is therefore
+// a `multiline-element` transformer, which means it is consulted ahead of the
+// `hr` element transformer no matter where the two plugins sit in the array —
+// plugin ORDER cannot change the outcome, and neither can loading or omitting
+// `hrPlugin`.
+//
+// Claiming the line is then narrowed by `handleImportAfterStartMatch`, which
+// returns `null` — "not mine, try the next transformer" — unless BOTH hold:
+//
+//   1. the fence is on line 0 (frontmatter is only frontmatter at the very top
+//      of the document), and
+//   2. a closing `---` line exists somewhere below it.
+//
+// Declining falls through to `hrPlugin` (when loaded), so a `---` that is
+// genuinely a thematic break — mid-document, or an unclosed one on line 1 —
+// still becomes an `<hr>`. `replace` returns `false` so that TYPING `---` in the
+// editor is likewise left to the hr shortcut; frontmatter is only ever created
+// by importing markdown or by calling `$setFrontmatter`.
+//
+// The block closes at the FIRST subsequent line that is exactly `---`, which is
+// the rule Jekyll / gray-matter / Hugo apply. A `---` *inside* a value (e.g.
+// `title: a --- b`) is not a whole line and is preserved untouched.
+import { $getRoot } from 'lexical';
+import { $createLLuiDecoratorNode, $isLLuiDecoratorNode, LLuiDecoratorNode, decoratorBridge, } from '@llui/lexical';
+import { div, textarea } from '@llui/dom';
+import { renderedPreview } from './_preview.js';
+/** The decorator bridge id for the frontmatter block. */
+export const FRONTMATTER_BRIDGE_TYPE = 'frontmatter';
+function isFrontmatterData(value) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        typeof value.source === 'string');
+}
+/** A line consisting solely of `---` (trailing tabs/spaces tolerated — they are
+ * not content, and `normalizeMarkdown` has usually already trimmed them). */
+const FENCE = /^---[ \t]*$/;
+/** Render the fences back around an opaque body. An empty (or blank-only) body
+ * collapses to the canonical two-line form so the result stays idempotent. */
+export function serializeFrontmatter(source) {
+    return source === '' ? '---\n---' : `---\n${source}\n---`;
+}
+/**
+ * The index of the closing fence, or `-1` when `lines` does not open a
+ * frontmatter block (no fence on line 0) or never closes one.
+ *
+ * The single definition of "is this frontmatter?", shared by the importer and
+ * {@link splitFrontmatter} so the two can never disagree. A returned index is
+ * always `>= 1`, which is the property the importer's anti-rewind invariant
+ * rests on (see `handleImportAfterStartMatch`).
+ */
+function closingFenceIndex(lines) {
+    const first = lines[0];
+    if (first === undefined || !FENCE.test(first))
+        return -1;
+    for (let i = 1; i < lines.length; i++) {
+        const line = lines[i];
+        if (line !== undefined && FENCE.test(line))
+            return i;
+    }
+    return -1;
+}
+/**
+ * Split a leading frontmatter block off a markdown string: `[body, rest]`, or
+ * `null` when the document has none (no line-0 fence, or no closing fence).
+ * Exported because a consumer often needs the metadata BEFORE building an
+ * editor — the same predicate the importer uses, so the two never disagree.
+ */
+export function splitFrontmatter(markdown) {
+    const lines = markdown.split('\n');
+    const end = closingFenceIndex(lines);
+    if (end === -1)
+        return null;
+    return [lines.slice(1, end).join('\n'), lines.slice(end + 1).join('\n')];
+}
+// ── Document accessors (run inside `editor.read` / `editor.update`) ──────────
+/** The frontmatter node, if the document starts with one. */
+function $frontmatterNode() {
+    const first = $getRoot().getFirstChild();
+    return $isLLuiDecoratorNode(first) && first.getBridgeType() === FRONTMATTER_BRIDGE_TYPE
+        ? first
+        : null;
+}
+/** The document's frontmatter body, or `null` when it has none. */
+export function $getFrontmatter() {
+    const node = $frontmatterNode();
+    if (!node || !$isLLuiDecoratorNode(node))
+        return null;
+    const data = node.getData();
+    return isFrontmatterData(data) ? data.source : null;
+}
+/**
+ * Set (or, with `null`, remove) the document's frontmatter. The block is always
+ * kept as the FIRST child of the root — it is only frontmatter there, and the
+ * exporter relies on that position (see the transformer's `export`).
+ */
+export function $setFrontmatter(source) {
+    const existing = $frontmatterNode();
+    if (source === null) {
+        existing?.remove();
+        return;
+    }
+    if (existing && $isLLuiDecoratorNode(existing)) {
+        existing.setData({ source });
+        return;
+    }
+    const node = $createLLuiDecoratorNode(FRONTMATTER_BRIDGE_TYPE, { source });
+    const root = $getRoot();
+    const first = root.getFirstChild();
+    if (first)
+        first.insertBefore(node);
+    else
+        root.append(node);
+}
+// ── Transformer ─────────────────────────────────────────────────────────────
+const FRONTMATTER_TRANSFORMER = {
+    dependencies: [LLuiDecoratorNode],
+    export: (node) => {
+        if (!$isLLuiDecoratorNode(node) || node.getBridgeType() !== FRONTMATTER_BRIDGE_TYPE)
+            return null;
+        const data = node.getData();
+        if (!isFrontmatterData(data))
+            return null;
+        // Only the document's FIRST block can be emitted as fences: `---` anywhere
+        // else re-imports as a thematic break, which would silently destroy the
+        // metadata on the next round-trip. A stray block (dragged out of position,
+        // pasted into a quote, …) degrades to a visible ```yaml code fence instead —
+        // lossy in node type, but the text survives and the author can see why.
+        if ($getRoot().getFirstChild() !== node)
+            return '```yaml\n' + data.source + '\n```';
+        return serializeFrontmatter(data.source);
+    },
+    regExpStart: FENCE,
+    // Never consulted: `handleImportAfterStartMatch` below always returns a
+    // decision, so the default open/close scan is not reached. Declared because
+    // the shape requires the pair to be meaningful together.
+    regExpEnd: FENCE,
+    handleImportAfterStartMatch: ({ lines, rootNode, startLineIndex }) => {
+        // Frontmatter exists only at the very top of the document. Anywhere else a
+        // `---` is a thematic break — decline so `hrPlugin` (or plain prose) gets it.
+        //
+        // INVARIANT — do not relax this guard without also fixing the scan below.
+        // `$importMarkdownNodes` assigns `i = shiftedIndex` from the returned tuple,
+        // so a returned index <= `startLineIndex` REWINDS its loop and the importer
+        // spins forever (not a wrong parse — a hang). The scan starts at line 1, so
+        // pinning `startLineIndex` to 0 is what makes every returned index strictly
+        // greater. A positional relaxation must start the scan at `startLineIndex + 1`.
+        if (startLineIndex !== 0)
+            return null;
+        const end = closingFenceIndex(lines);
+        if (end !== -1) {
+            // Verbatim body: no trimming, no interpretation, blank lines preserved.
+            const source = lines.slice(1, end).join('\n');
+            rootNode.append($createLLuiDecoratorNode(FRONTMATTER_BRIDGE_TYPE, { source }));
+            return [true, end];
+        }
+        // Unclosed: this is a lone `---` on line 1, i.e. a horizontal rule.
+        return null;
+    },
+    // Typing `---` must never produce frontmatter — returning false hands the
+    // markdown shortcut back to `hrPlugin`. Use `$setFrontmatter` to create one.
+    replace: () => false,
+    type: 'multiline-element',
+};
+export { FRONTMATTER_TRANSFORMER };
+/** Keep editor-level key/paste handling out of the frontmatter island. */
+const stop = (e) => e.stopPropagation();
+export function frontmatterPlugin(opts = {}) {
+    const editable = opts.editable ?? true;
+    const bridge = decoratorBridge(FRONTMATTER_BRIDGE_TYPE, (data, api) => {
+        const children = [];
+        if (editable) {
+            children.push(
+            // A <textarea>, NOT a contenteditable div: newlines are load-bearing in
+            // YAML, and a contenteditable's `textContent` drops the <br>/<div> line
+            // structure the browser inserts, so committing from one silently
+            // flattens a multi-line block into a single line.
+            textarea({
+                'data-scope': 'md-frontmatter',
+                'data-part': 'source',
+                'aria-label': opts.label ?? 'Frontmatter',
+                placeholder: opts.placeholder ?? 'key: value',
+                spellcheck: 'false',
+                autocapitalize: 'off',
+                autocomplete: 'off',
+                value: data.at('source'),
+                // Grow with the content so the whole block stays visible.
+                rows: data.at('source').map((source) => String(Math.max(1, source.split('\n').length))),
+                onKeyDown: stop,
+                onBeforeInput: stop,
+                onPaste: stop,
+                // Commit on blur only: while the caret is inside, the node data is
+                // deliberately stale so the reactive `value` binding cannot rewrite
+                // what is being typed.
+                onBlur: (e) => {
+                    const source = e.target.value;
+                    if (source !== data.peek().source)
+                        api.update({ source });
+                },
+            }));
+        }
+        if (opts.render) {
+            children.push(renderedPreview(data.at('source'), opts.render));
+        }
+        return [
+            div({ 'data-scope': 'md-frontmatter', 'data-part': 'root', contenteditable: 'false' }, children),
+        ];
+    });
+    return {
+        name: 'frontmatter',
+        nodes: [LLuiDecoratorNode],
+        decorators: [bridge],
+        transformers: [FRONTMATTER_TRANSFORMER],
+        items: [
+            {
+                id: 'frontmatter',
+                label: 'Frontmatter',
+                icon: 'frontmatter',
+                group: 'insert',
+                keywords: ['frontmatter', 'yaml', 'metadata', 'front matter'],
+                // Idempotent: a document already carrying frontmatter is left alone
+                // rather than having its metadata blanked.
+                run: (editor) => editor.update(() => {
+                    if ($getFrontmatter() === null)
+                        $setFrontmatter('');
+                }),
+                surfaces: ['slash', 'context'],
+            },
+        ],
+    };
+}
+//# sourceMappingURL=frontmatter.js.map

package/dist/plugins/frontmatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter.js","sourceRoot":"","sources":["../../src/plugins/frontmatter.ts"],"names":[],"mappings":"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"}

package/dist/plugins/overlay.d.ts

@@ -4,6 +4,7 @@ export declare const OVERLAY_Z: {
     readonly contextMenu: 61;
     readonly floatingToolbar: 62;
     readonly tableTools: 63;
+    readonly codeLanguage: 64;
 };
 export interface OverlayRootConfig {
     /** Whether the overlay is shown. */

package/dist/plugins/overlay.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"overlay.d.ts","sourceRoot":"","sources":["../../src/plugins/overlay.ts"],"names":[],"mappings":"AAsBA,OAAO,EAOL,KAAK,UAAU,EACf,KAAK,MAAM,EACZ,MAAM,WAAW,CAAA;AAGlB,eAAO,MAAM,SAAS;;;;;CAKZ,CAAA;AAWV,MAAM,WAAW,iBAAiB;IAChC,oCAAoC;IACpC,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC,CAAA;IACrB,2CAA2C;IAC3C,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC,CAAA;IACjB,2CAA2C;IAC3C,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC,CAAA;IACjB,8CAA8C;IAC9C,MAAM,EAAE,MAAM,CAAA;IACd,8EAA8E;IAC9E,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,kFAAkF;IAClF,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC9B,sFAAsF;IACtF,MAAM,CAAC,EAAE,MAAM,UAAU,CAAA;IACzB,yCAAyC;IACzC,QAAQ,EAAE,MAAM,UAAU,CAAA;CAC3B;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,iBAAiB,GAAG,UAAU,CA2B9D;AAED;mDACmD;AACnD,wBAAgB,WAAW,CAAC,CAAC,SAAS;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CAEpE;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAoB5D"}
+{"version":3,"file":"overlay.d.ts","sourceRoot":"","sources":["../../src/plugins/overlay.ts"],"names":[],"mappings":"AAwBA,OAAO,EAOL,KAAK,UAAU,EACf,KAAK,MAAM,EACZ,MAAM,WAAW,CAAA;AAGlB,eAAO,MAAM,SAAS;;;;;;CAUZ,CAAA;AAWV,MAAM,WAAW,iBAAiB;IAChC,oCAAoC;IACpC,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC,CAAA;IACrB,2CAA2C;IAC3C,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC,CAAA;IACjB,2CAA2C;IAC3C,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC,CAAA;IACjB,8CAA8C;IAC9C,MAAM,EAAE,MAAM,CAAA;IACd,8EAA8E;IAC9E,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,kFAAkF;IAClF,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC9B,sFAAsF;IACtF,MAAM,CAAC,EAAE,MAAM,UAAU,CAAA;IACzB,yCAAyC;IACzC,QAAQ,EAAE,MAAM,UAAU,CAAA;CAC3B;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,iBAAiB,GAAG,UAAU,CA2B9D;AAED;mDACmD;AACnD,wBAAgB,WAAW,CAAC,CAAC,SAAS;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CAEpE;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAoB5D"}

package/dist/plugins/overlay.js

@@ -18,6 +18,8 @@
 //   61 — context menu                        — pointer-anchored
 //   62 — floating selection toolbar          — selection-anchored bubble
 //   63 — table tools                         — element-anchored, sits over a table
+//   64 — code-block language badge           — element-anchored, may sit INSIDE a
+//                                              table cell, so it must clear 63
 // The values live with each plugin's view; this comment is the source of truth.
 import { div, derived, onMount, portal, show, } from '@llui/dom';
 import { registerNestedLayer } from '@llui/components/utils';
@@ -26,6 +28,11 @@ export const OVERLAY_Z = {
     contextMenu: 61,
     floatingToolbar: 62,
     tableTools: 63,
+    // Strictly above `tableTools`: a fenced code block can live inside a table
+    // cell, in which case both surfaces are open at once. At an equal z-index the
+    // clickable one was decided by portal insertion order — i.e. by plugin array
+    // order — which is exactly the no-tie rule this scale exists to prevent.
+    codeLanguage: 64,
 };
 const toMountables = (r) => [...r];
 // Unique marker per overlay instance so its portal root can be located while

package/dist/plugins/overlay.js.map

@@ -1 +1 @@
-{"version":3,"file":"overlay.js","sourceRoot":"","sources":["../../src/plugins/overlay.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"overlay.js","sourceRoot":"","sources":["../../src/plugins/overlay.ts"],"names":[],"mappings":"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"}

package/dist/plugins/wikilink.d.ts

@@ -0,0 +1,110 @@
+import { TextNode, type EditorConfig, type LexicalEditor, type LexicalNode, type LexicalUpdateJSON, type NodeKey, type SerializedTextNode, type Spread } from 'lexical';
+import type { MarkdownPlugin } from './types.js';
+/** A parsed wikilink. `alias` is `null` when the target is shown verbatim. */
+export interface WikiLink {
+    target: string;
+    alias: string | null;
+}
+/**
+ * Parse the content BETWEEN the brackets. Returns `null` when the content is not
+ * a valid wikilink body.
+ *
+ * Deliberate choices, each load-bearing for exact round-tripping:
+ *   * split on the FIRST `|` only, so `[[a|b|c]]` has alias `b|c` and re-exports
+ *     byte-identically;
+ *   * an EMPTY alias (`[[a|]]`) normalizes to no alias — the alternative
+ *     (keeping `alias: ''`) would render a zero-width, unclickable node;
+ *   * NO trimming. `[[ a ]]` keeps its spaces, because trimming would make
+ *     import→export lossy. Presentation trimming is the host's call in
+ *     `onNavigate`/`resolve`, not the document's.
+ */
+export declare function parseWikiLinkInner(inner: string): WikiLink | null;
+/** Sanitize a target. Returns `null` when nothing usable survives. */
+export declare function sanitizeWikiLinkTarget(raw: string): string | null;
+/** Sanitize an alias. Returns `null` when nothing usable survives. */
+export declare function sanitizeWikiLinkAlias(raw: string | null): string | null;
+/**
+ * Serialize a wikilink back to markdown. Inverse of {@link parseWikiLinkInner}
+ * for every link built through this module's constructors — see
+ * {@link sanitizeWikiLinkTarget} for why that qualifier is load-bearing.
+ */
+export declare function formatWikiLink(link: WikiLink): string;
+export type SerializedWikiLinkNode = Spread<{
+    target: string;
+    alias: string | null;
+}, SerializedTextNode>;
+/**
+ * An atomic inline wikilink. Extends `TextNode` so the caret, selection and
+ * text formats behave exactly as they do for prose, while `token` mode keeps it
+ * indivisible: the user can delete it or move past it, but never edit its
+ * interior into a state where the visible alias disagrees with `__target`.
+ */
+export declare class WikiLinkNode extends TextNode {
+    __target: string;
+    __alias: string | null;
+    static getType(): string;
+    static clone(node: WikiLinkNode): WikiLinkNode;
+    constructor(target: string, alias: string | null, text?: string, key?: NodeKey);
+    static importJSON(serializedNode: SerializedWikiLinkNode): WikiLinkNode;
+    updateFromJSON(serializedNode: LexicalUpdateJSON<SerializedWikiLinkNode>): this;
+    exportJSON(): SerializedWikiLinkNode;
+    createDOM(config: EditorConfig, editor?: LexicalEditor): HTMLElement;
+    updateDOM(prevNode: this, dom: HTMLElement, config: EditorConfig): boolean;
+    getTarget(): string;
+    /**
+     * Repoint the link. The display text follows only when there is no alias.
+     * The value is sanitized (see {@link sanitizeWikiLinkTarget}); a target with
+     * nothing representable in it leaves the link untouched rather than producing
+     * one that corrupts the document on export.
+     */
+    setTarget(target: string): this;
+    getAlias(): string | null;
+    /** Set (or clear, with `null`) the alias; the display text follows. */
+    setAlias(alias: string | null): this;
+    getLink(): WikiLink;
+    canInsertTextBefore(): boolean;
+    canInsertTextAfter(): boolean;
+}
+/**
+ * Build a wikilink node. `target`/`alias` are sanitized to values the `[[…]]`
+ * syntax can express (see {@link sanitizeWikiLinkTarget}); a target with nothing
+ * usable left falls back to the literal text `Page` rather than yielding an
+ * invisible token.
+ */
+export declare function $createWikiLinkNode(target: string, alias?: string | null): WikiLinkNode;
+export declare function $isWikiLinkNode(node: LexicalNode | null | undefined): node is WikiLinkNode;
+/** A document the host offers as a link target while the user types `[[…`. */
+export interface DocCandidate {
+    /** The link target written into the document (`[[target]]`). */
+    readonly target: string;
+    /** Human-facing title shown in the results list (defaults to `target`). */
+    readonly title?: string;
+    /** A short one-line snippet shown under the title. */
+    readonly snippet?: string;
+    /** A longer content excerpt shown in the reference/preview pane. */
+    readonly preview?: string;
+}
+export interface WikiLinkPluginOptions {
+    /**
+     * Called when the user activates a wikilink. This is the host's resolution
+     * seam: `@llui/markdown-editor` knows nothing about what a target names.
+     *
+     * The notification travels the same route as every other plugin event —
+     * `ctx.emit` → the editor's update loop → this plugin's reducer → an effect —
+     * rather than a raw DOM event, so an activation is an ordinary TEA message
+     * that shows up in devtools, replay and agent traces.
+     */
+    onNavigate?: (link: WikiLink) => void;
+    /** Text used as the target when the insert command runs with no selection. */
+    placeholderTarget?: string;
+    /**
+     * Document-search seam: as the user types `[[query`, resolve matching
+     * documents to offer as link targets, with an optional content preview shown in
+     * the panel's reference pane. Sync or async (async is debounced; a stale
+     * response for a superseded query is dropped). When omitted, the panel never
+     * opens and `[[target]]` still works by typing the closing `]]`.
+     */
+    search?: (query: string) => readonly DocCandidate[] | Promise<readonly DocCandidate[]>;
+}
+export declare function wikilinkPlugin(opts?: WikiLinkPluginOptions): MarkdownPlugin;
+//# sourceMappingURL=wikilink.d.ts.map

package/dist/plugins/wikilink.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wikilink.d.ts","sourceRoot":"","sources":["../../src/plugins/wikilink.ts"],"names":[],"mappings":"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"}