@type32/codemirror-rich-obsidian-editor 0.0.24 → 0.0.26

package/dist/module.json

@@ -1,7 +1,7 @@
 {
   "name": "@type32/codemirror-rich-obsidian-editor",
   "configKey": "cmOfmEditor",
-  "version": "0.0.24",
+  "version": "0.0.26",
   "builder": {
     "@nuxt/module-builder": "1.0.2",
     "unbuild": "3.6.1"

package/dist/runtime/components/Editor/ImageEmbedComponent.vue.d.ts

@@ -2,5 +2,6 @@ type __VLS_Props = {
     filePath: string;
     display?: string;
 };
-declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
 export default _default;

package/dist/runtime/components/Editor/TestCustomCodeBlock.vue.d.ts

@@ -1,5 +1,6 @@
 type __VLS_Props = {
     codeContent?: string;
 };
-declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
 export default _default;

package/dist/runtime/components/Editor.client.vue.d.ts

@@ -10,10 +10,11 @@ type __VLS_Props = {
     debug?: boolean;
     searchOptions?: SearchOptions;
 };
-type __VLS_PublicProps = __VLS_Props & {
+type __VLS_ModelProps = {
     modelValue?: string;
 };
-declare const _default: import("vue").DefineComponent<__VLS_PublicProps, {
+type __VLS_PublicProps = __VLS_Props & __VLS_ModelProps;
+declare const __VLS_export: import("vue").DefineComponent<__VLS_PublicProps, {
     view: import("vue").ShallowRef<EditorView | undefined, EditorView | undefined>;
 }, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     "internal-link-click": (detail: InternalLinkClickDetail) => any;
@@ -24,4 +25,5 @@ declare const _default: import("vue").DefineComponent<__VLS_PublicProps, {
     "onExternal-link-click"?: ((detail: ExternalLinkClickDetail) => any) | undefined;
     "onUpdate:modelValue"?: ((value: string | undefined) => any) | undefined;
 }>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
 export default _default;

package/dist/runtime/composables/useDocumentUtils.js

@@ -1,7 +1,5 @@
 import { useAlfaaz } from "./useAlfaaz.js";
-import { markdown } from "@codemirror/lang-markdown";
-import { GFM } from "@lezer/markdown";
-import { CustomOFM } from "../editor/lezer-parsers/customOFMParsers.js";
+import { parseMarkdownToAST } from "../utils/markdownParser.js";
 export function useDocumentUtils() {
   const alfaaz = useAlfaaz();
   function getWordCount(text) {
@@ -32,9 +30,7 @@ export function useDocumentUtils() {
   function getTableOfContents(text) {
     const toc = [];
     if (!text) return toc;
-    const tree = markdown({
-      extensions: [GFM, CustomOFM, { remove: ["SetextHeading"] }]
-    }).language.parser.parse(text);
+    const tree = parseMarkdownToAST(text);
     tree.iterate({
       enter: (node) => {
         if (node.name.startsWith("ATXHeading")) {
@@ -61,9 +57,7 @@ export function useDocumentUtils() {
   function getAllTags(text) {
     const tags = [];
     if (!text) return tags;
-    const tree = markdown({
-      extensions: [GFM, CustomOFM, { remove: ["SetextHeading"] }]
-    }).language.parser.parse(text);
+    const tree = parseMarkdownToAST(text);
     let frontmatterEnd = 0;
     const frontmatterNode = tree.topNode.firstChild;
     if (frontmatterNode && frontmatterNode.name === "Frontmatter") {

package/dist/runtime/composables/useEditorFrontmatter.js

@@ -1,5 +1,6 @@
-import { load, dump } from "js-yaml";
+import { dump } from "js-yaml";
 import { useEditorUtils } from "./useEditorUtils.js";
+import { parseFrontmatter } from "../utils/frontmatter.js";
 export function useEditorFrontmatter(editor) {
   const editorUtils = useEditorUtils(editor);
   function getFrontmatter() {
@@ -7,25 +8,7 @@ export function useEditorFrontmatter(editor) {
     if (!doc) {
       return {};
     }
-    const ast = editorUtils.parseMarkdownToAST(doc);
-    const firstNode = ast.topNode.firstChild;
-    if (!firstNode || firstNode.name !== "YAMLFrontMatter") {
-      return {};
-    }
-    const contentNode = firstNode.getChild("YAMLContent");
-    const yamlContent = contentNode ? doc.slice(contentNode.from, contentNode.to) : "";
-    try {
-      const data = load(yamlContent);
-      if (data === null || data === void 0) {
-        return { data: {} };
-      }
-      if (typeof data === "object") {
-        return { data };
-      }
-      return { error: new Error("Frontmatter is not a valid object.") };
-    } catch (e) {
-      return { error: e };
-    }
+    return parseFrontmatter(doc);
   }
   function setFrontmatterProperties(properties) {
     const doc = editorUtils.getDoc() || "";

package/dist/runtime/composables/useEditorUtils.d.ts

@@ -1,6 +1,7 @@
 import type { SyntaxNode, Tree } from '@lezer/common';
 import type { Ref } from 'vue';
 import type { TransactionSpec } from '@codemirror/state';
+import { parseMarkdownToAST } from '../utils/markdownParser.js';
 import type { SearchMatch, SearchOptions } from '../editor/types/editor-types.js';
 export declare function useEditorUtils(editor: Ref<any>): {
     getDoc: () => string | undefined;
@@ -8,7 +9,7 @@ export declare function useEditorUtils(editor: Ref<any>): {
     getSelection: () => any;
     replaceSelection: (text: string) => void;
     dispatch: (...specs: TransactionSpec[]) => void;
-    parseMarkdownToAST: (markdownText: string) => Tree;
+    parseMarkdownToAST: typeof parseMarkdownToAST;
     getDocAst: () => Tree;
     findNodesByType: (tree: Tree, nodeTypeName: string) => SyntaxNode[];
     getDocNodesByType: (nodeTypeName: string) => SyntaxNode[];

package/dist/runtime/composables/useEditorUtils.js

@@ -1,8 +1,6 @@
 import { computed, ref, unref } from "vue";
 import { EditorView } from "@codemirror/view";
-import { markdown } from "@codemirror/lang-markdown";
-import { CustomOFM } from "../../runtime/editor/lezer-parsers/customOFMParsers";
-import { GFM } from "@lezer/markdown";
+import { parseMarkdownToAST } from "../utils/markdownParser.js";
 export function useEditorUtils(editor) {
   const view = computed(() => {
     const instance = unref(editor);
@@ -12,6 +10,18 @@ export function useEditorUtils(editor) {
   const searchResults = ref([]);
   const currentMatchIndex = ref(-1);
   const searchQuery = ref(null);
+  function createSearchRegex(options) {
+    return new RegExp(options.query, options.caseSensitive ? "g" : "gi");
+  }
+  function findAllMatches(doc, options) {
+    const matches = [];
+    const regex = createSearchRegex(options);
+    let match;
+    while ((match = regex.exec(doc)) !== null) {
+      matches.push({ from: match.index, to: match.index + match[0].length });
+    }
+    return matches;
+  }
   function getDoc() {
     return unref(view)?.state.doc.toString();
   }
@@ -29,15 +39,6 @@ export function useEditorUtils(editor) {
   function dispatch(...specs) {
     unref(view)?.dispatch(...specs);
   }
-  function parseMarkdownToAST(markdownText) {
-    return markdown({
-      extensions: [
-        GFM,
-        CustomOFM,
-        { remove: ["SetextHeading"] }
-      ]
-    }).language.parser.parse(markdownText);
-  }
   function getDocAst() {
     return parseMarkdownToAST(getDoc() || "");
   }
@@ -69,13 +70,7 @@ export function useEditorUtils(editor) {
       currentMatchIndex.value = -1;
       return;
     }
-    const matches = [];
-    const regex = new RegExp(options.query, options.caseSensitive ? "g" : "gi");
-    let match;
-    while ((match = regex.exec(doc)) !== null) {
-      matches.push({ from: match.index, to: match.index + match[0].length });
-    }
-    searchResults.value = matches;
+    searchResults.value = findAllMatches(doc, options);
     currentMatchIndex.value = -1;
   }
   function selectAndScrollToMatch(match) {
@@ -125,12 +120,7 @@ export function useEditorUtils(editor) {
     if (!searchQuery.value || !searchQuery.value.query) return;
     const doc = getDoc();
     if (!doc) return;
-    const matches = [];
-    const regex = new RegExp(searchQuery.value.query, searchQuery.value.caseSensitive ? "g" : "gi");
-    let match;
-    while ((match = regex.exec(doc)) !== null) {
-      matches.push({ from: match.index, to: match.index + match[0].length });
-    }
+    const matches = findAllMatches(doc, searchQuery.value);
     if (matches.length === 0) return;
     const changes = matches.map((m) => ({
       from: m.from,
@@ -155,6 +145,7 @@ export function useEditorUtils(editor) {
     replaceSelection,
     dispatch,
     parseMarkdownToAST,
+    // Re-exported from utils for convenience
     getDocAst,
     findNodesByType,
     getDocNodesByType,

package/dist/runtime/editor/plugins/codemirror-editor-plugins/editorInternalLinkAutocompletePlugin.js

@@ -27,30 +27,31 @@ function internalLinkSource(context) {
   const linkMap = context.state.facet(internalLinkMapFacet);
   const nameCounts = /* @__PURE__ */ new Map();
   linkMap.forEach((link) => {
-    nameCounts.set(link.internalLinkName, (nameCounts.get(link.internalLinkName) || 0) + 1);
+    nameCounts.set(link.name, (nameCounts.get(link.name) || 0) + 1);
   });
   const searchString = textBefore.toLowerCase();
   const options = linkMap.filter(
-    (link) => link.internalLinkName.toLowerCase().includes(searchString) || link.filePath && link.filePath.toLowerCase().includes(searchString)
+    (link) => link.name && link.name.toLowerCase().includes(searchString) || link.filePath && link.filePath.toLowerCase().includes(searchString)
   ).map((link) => {
-    const isDuplicate = (nameCounts.get(link.internalLinkName) || 0) > 1;
+    if (!link.name) return null;
+    const isDuplicate = (nameCounts.get(link.name) || 0) > 1;
     if (isDuplicate) {
       return {
-        label: link.filePath || link.internalLinkName,
-        detail: link.internalLinkName,
-        apply: link.filePath || link.internalLinkName
+        label: link.name,
+        detail: link.filePath,
+        apply: link.filePath || link.name
       };
     }
     return {
-      label: link.internalLinkName,
+      label: link.name,
       detail: link.filePath,
-      apply: `${link.internalLinkName}`
+      apply: `${link.name}`
     };
-  });
+  }).filter(Boolean);
   if (options.length === 0) return null;
   return {
     from,
-    options,
+    options: options || [],
     validFor: /^[^\]|]*/
   };
 }

package/dist/runtime/editor/plugins/codemirror-editor-plugins/editorLinkClickPlugin.js

@@ -25,14 +25,14 @@ export const editorLinkClickPlugin = EditorView.domEventHandlers({
       const path = anchor.dataset.path;
       if (!path) return true;
       const linkMap = view.state.facet(internalLinkMapFacet);
-      const linkInfo = linkMap.find((l) => l.internalLinkName === path);
+      const linkInfo = linkMap.find((l) => l.name === path || l.filePath === path);
       const type = anchor.dataset.type;
       const detail = {
-        path,
+        target: path,
         subpath: anchor.dataset.subpath,
         display: anchor.dataset.display,
         type: type || "internal-link",
-        redirectToPath: linkInfo?.redirectToPath
+        referenceId: anchor.dataset.referenceId || linkInfo?.referenceId
       };
       view.dom.dispatchEvent(new CustomEvent("internal-link-click", {
         bubbles: true,

package/dist/runtime/editor/plugins/codemirror-plugin-proses/createProsePlugin.d.ts

@@ -0,0 +1,53 @@
+import { Decoration, type DecorationSet } from '@codemirror/view';
+import { StateField } from '@codemirror/state';
+import type { EditorState, Range as EditorRange } from '@codemirror/state';
+/**
+ * Configuration options for creating a prose plugin
+ */
+export interface ProsePluginConfig {
+    /**
+     * Function to build decorations from the editor state
+     */
+    buildDecorations: (state: EditorState) => EditorRange<Decoration>[];
+    /**
+     * Whether to rebuild decorations on document changes (default: true)
+     */
+    rebuildOnDocChange?: boolean;
+    /**
+     * Whether to rebuild decorations on selection changes (default: false)
+     */
+    rebuildOnSelection?: boolean;
+    /**
+     * Whether to sort the decorations (default: true)
+     */
+    sortDecorations?: boolean;
+}
+/**
+ * Creates a CodeMirror StateField plugin for prose decorations with the standard pattern.
+ * This reduces boilerplate for simple prose plugins that follow the common pattern:
+ * - Build decorations from syntax tree
+ * - Update on document/selection changes
+ * - Provide decorations to editor view
+ *
+ * @param config Configuration object for the plugin
+ * @returns A CodeMirror StateField that can be added to the editor
+ *
+ * @example
+ * ```ts
+ * export const myPlugin = createProsePlugin({
+ *   buildDecorations: (state) => {
+ *     const decorations: EditorRange<Decoration>[] = []
+ *     syntaxTree(state).iterate({
+ *       enter(node) {
+ *         if (node.name === 'MyNode') {
+ *           decorations.push(myDecoration.range(node.from, node.to))
+ *         }
+ *       }
+ *     })
+ *     return decorations
+ *   },
+ *   rebuildOnSelection: true
+ * })
+ * ```
+ */
+export declare function createProsePlugin(config: ProsePluginConfig): StateField<DecorationSet>;

package/dist/runtime/editor/plugins/codemirror-plugin-proses/createProsePlugin.js

@@ -0,0 +1,23 @@
+import { EditorView } from "@codemirror/view";
+import { StateField, RangeSet } from "@codemirror/state";
+export function createProsePlugin(config) {
+  const {
+    buildDecorations,
+    rebuildOnDocChange = true,
+    rebuildOnSelection = false,
+    sortDecorations = true
+  } = config;
+  return StateField.define({
+    create(state) {
+      return RangeSet.of(buildDecorations(state), sortDecorations);
+    },
+    update(value, tr) {
+      const shouldRebuild = rebuildOnDocChange && tr.docChanged || rebuildOnSelection && tr.selection;
+      if (shouldRebuild) {
+        return RangeSet.of(buildDecorations(tr.state), sortDecorations);
+      }
+      return value.map(tr.changes);
+    },
+    provide: (f) => EditorView.decorations.from(f)
+  });
+}

package/dist/runtime/editor/plugins/codemirror-plugin-proses/proseHashtagCodemirrorViewPlugin.d.ts

@@ -1,3 +1 @@
-import { type DecorationSet } from '@codemirror/view';
-import { StateField } from '@codemirror/state';
-export declare const proseHashtagCodemirrorViewPlugin: StateField<DecorationSet>;
+export declare const proseHashtagCodemirrorViewPlugin: import("@codemirror/state").StateField<import("@codemirror/view").DecorationSet>;

package/dist/runtime/editor/plugins/codemirror-plugin-proses/proseHashtagCodemirrorViewPlugin.js

@@ -1,7 +1,6 @@
-import { EditorView } from "@codemirror/view";
-import { StateField, RangeSet } from "@codemirror/state";
 import { syntaxTree } from "@codemirror/language";
 import { decorationProseHashtag } from "../../utility/decorations.js";
+import { createProsePlugin } from "./createProsePlugin.js";
 function buildHashtagWrappers(state) {
   const decorations = [];
   syntaxTree(state).iterate({
@@ -13,15 +12,8 @@ function buildHashtagWrappers(state) {
   });
   return decorations;
 }
-export const proseHashtagCodemirrorViewPlugin = StateField.define({
-  create(state) {
-    return RangeSet.of(buildHashtagWrappers(state));
-  },
-  update(value, tr) {
-    if (tr.docChanged) {
-      return RangeSet.of(buildHashtagWrappers(tr.state));
-    }
-    return value.map(tr.changes);
-  },
-  provide: (f) => EditorView.decorations.from(f)
+export const proseHashtagCodemirrorViewPlugin = createProsePlugin({
+  buildDecorations: buildHashtagWrappers,
+  rebuildOnDocChange: true,
+  rebuildOnSelection: false
 });

package/dist/runtime/editor/plugins/codemirror-plugin-proses/proseInternalLinkCodemirrorViewPlugin.d.ts

@@ -1,6 +1,3 @@
 import { type DecorationSet } from '@codemirror/view';
 import { StateField } from '@codemirror/state';
-import type { EditorState } from '@codemirror/state';
-declare function isNodeRangeActive(state: EditorState, nodeFrom: number, nodeTo: number): boolean;
-export { isNodeRangeActive };
 export declare const proseInternalLinkCodemirrorViewPlugin: StateField<DecorationSet>;

package/dist/runtime/editor/plugins/codemirror-plugin-proses/proseInternalLinkCodemirrorViewPlugin.js

@@ -3,15 +3,7 @@ import { StateField, RangeSet } from "@codemirror/state";
 import { syntaxTree } from "@codemirror/language";
 import { internalLinkMapFacet } from "../linkMappingConfig.js";
 import { ProseVueComponentEmbedWidget } from "../codemirror-widgets/proseVueComponentEmbedWidget.js";
-import { cursorSelectionCoveredNode, toCursorNodePositions } from "../../utility/tools.js";
-function isNodeRangeActive(state, nodeFrom, nodeTo) {
-  const cursor = state.selection.main;
-  if (cursor.empty) {
-    return cursor.from >= nodeFrom && cursor.from <= nodeTo;
-  } else {
-    return Math.max(nodeFrom, cursor.from) < Math.min(nodeTo, cursor.to);
-  }
-}
+import { cursorSelectionCoveredNode, toCursorNodePositions, isNodeRangeActive } from "../../utility/tools.js";
 function buildInternalLinkDecorations(state) {
   const decorations = [];
   const linkMap = state.facet(internalLinkMapFacet);
@@ -22,7 +14,7 @@ function buildInternalLinkDecorations(state) {
         const pathNode = node.node.getChild("InternalLink")?.getChild("InternalPath");
         if (pathNode) {
           const path = state.doc.sliceString(pathNode.from, pathNode.to);
-          const linkInfo = linkMap.find((l) => l.internalLinkName === path || l.filePath === path);
+          const linkInfo = linkMap.find((l) => l.name === path || l.filePath === path);
           if (linkInfo?.embedComponent) {
             const line = state.doc.lineAt(node.from);
             const props = { linkData: linkInfo };
@@ -58,7 +50,7 @@ function buildInternalLinkDecorations(state) {
         const aliasNode = contentContainerNode.getChild("InternalDisplay");
         const subpath = subpathNode ? state.doc.sliceString(subpathNode.from, subpathNode.to) : void 0;
         const alias = aliasNode ? state.doc.sliceString(aliasNode.from, aliasNode.to) : void 0;
-        const linkInfo = linkMap.find((l) => l.internalLinkName === path || l.filePath === path);
+        const linkInfo = linkMap.find((l) => l.name === path || l.filePath === path);
         if (node.name === "Embed" && linkInfo?.embedComponent) {
           return false;
         }
@@ -71,6 +63,8 @@ function buildInternalLinkDecorations(state) {
         };
         if (!linkInfo) {
           linkAttributes["class"] += " cm-unresolved-link";
+        } else {
+          linkAttributes["data-reference-id"] = linkInfo.referenceId;
         }
         if (subpath) linkAttributes["data-subpath"] = subpath;
         if (alias) linkAttributes["data-display"] = alias;
@@ -100,7 +94,6 @@ function buildInternalLinkDecorations(state) {
   });
   return [...decorations, ...widgets];
 }
-export { isNodeRangeActive };
 export const proseInternalLinkCodemirrorViewPlugin = StateField.define({
   create(state) {
     return RangeSet.of(buildInternalLinkDecorations(state), true);

package/dist/runtime/editor/plugins/richTextPlugin.js

@@ -47,16 +47,20 @@ export default class RichEditPlugin {
   }
   update(update) {
     if (update.docChanged) {
-      let decorations = this.decorations.map(update.changes);
-      update.changes.iterChangedRanges((fromA, toA, fromB, toB) => {
-        const newWidgets = this.processRange(update.view, fromB, toB);
-        decorations = decorations.update({
-          filter: (f, t) => f < fromB || t > toB,
-          add: newWidgets,
-          sort: true
+      if (update.selectionSet) {
+        this.decorations = this.process(update.view);
+      } else {
+        let decorations = this.decorations.map(update.changes);
+        update.changes.iterChangedRanges((fromA, toA, fromB, toB) => {
+          const newWidgets = this.processRange(update.view, fromB, toB);
+          decorations = decorations.update({
+            filter: (f, t) => f < fromB || t > toB,
+            add: newWidgets,
+            sort: true
+          });
         });
-      });
-      this.decorations = decorations;
+        this.decorations = decorations;
+      }
     } else if (update.viewportChanged || update.selectionSet) {
       this.decorations = this.process(update.view);
     }
@@ -71,35 +75,33 @@ export default class RichEditPlugin {
   processRange(view, from, to) {
     const widgets = [];
     const [cursor] = view.state.selection.ranges;
-    for (let { from: from2, to: to2 } of view.visibleRanges) {
-      syntaxTree(view.state).iterate({
-        from: from2,
-        to: to2,
-        enter(node) {
-          const nodeName = node.name;
-          const nodeFrom = node.from;
-          const nodeTo = node.to;
-          if (nodeName === "HorizontalRule") {
-            if (cursorInNode(cursor?.from, cursor?.to, nodeFrom, nodeTo)) {
-              return;
-            }
-            const line = view.state.doc.lineAt(nodeFrom);
-            widgets.push(decorationHidden.range(nodeFrom, nodeTo));
-            widgets.push(Decoration.line({ attributes: { class: "hr" } }).range(line.from));
+    syntaxTree(view.state).iterate({
+      from,
+      to,
+      enter(node) {
+        const nodeName = node.name;
+        const nodeFrom = node.from;
+        const nodeTo = node.to;
+        if (nodeName === "HorizontalRule") {
+          if (cursorInNode(cursor?.from, cursor?.to, nodeFrom, nodeTo)) {
             return;
           }
-          if ((nodeName.startsWith("ATXHeading") || revealComponentMarkTokensOnCursor.includes(nodeName)) && cursorInNode(cursor?.from, cursor?.to, nodeFrom, nodeTo)) {
-            return false;
-          }
-          if (nodeName === "ListMark" && node.matchContext(["BulletList", "ListItem"]) && cursor?.from != nodeFrom && cursor?.from != nodeFrom + 1)
-            widgets.push(decorationBullet.range(nodeFrom, nodeTo));
-          if (hideComponentMarkTokens.includes(node.name))
-            widgets.push(decorationHidden.range(nodeFrom, nodeTo));
-          if (nodeName === "HeaderMark")
-            widgets.push(decorationHidden.range(nodeFrom, nodeTo + 1));
+          const line = view.state.doc.lineAt(nodeFrom);
+          widgets.push(decorationHidden.range(nodeFrom, nodeTo));
+          widgets.push(Decoration.line({ attributes: { class: "hr" } }).range(line.from));
+          return;
         }
-      });
-    }
+        if ((nodeName.startsWith("ATXHeading") || revealComponentMarkTokensOnCursor.includes(nodeName)) && cursorInNode(cursor?.from, cursor?.to, nodeFrom, nodeTo)) {
+          return false;
+        }
+        if (nodeName === "ListMark" && node.matchContext(["BulletList", "ListItem"]) && cursor?.from != nodeFrom && cursor?.from != nodeFrom + 1)
+          widgets.push(decorationBullet.range(nodeFrom, nodeTo));
+        if (hideComponentMarkTokens.includes(node.name))
+          widgets.push(decorationHidden.range(nodeFrom, nodeTo));
+        if (nodeName === "HeaderMark")
+          widgets.push(decorationHidden.range(nodeFrom, nodeTo + 1));
+      }
+    });
     return widgets;
   }
 }

package/dist/runtime/editor/types/editor-types.d.ts

@@ -2,11 +2,34 @@ import type { Component } from 'vue'
 import type { LanguageSupport } from '@codemirror/language'
 import type { SyntaxNode } from '@lezer/common'
 
+/**
+ * Represents a resolvable internal link within the editor.
+ * This is used to provide autocompletion and to resolve link targets.
+ */
 export interface InternalLink {
-    internalLinkName: string;
-    filePath?: string;
-    redirectToPath: string;
-    embedComponent?: Component;
+	/**
+	 * The display name of the link.
+	 * This is what appears in the autocompletion list and is used as the default link text.
+	 * It should be unique if `filePath` is not provided.
+	 */
+	name: string;
+	/**
+	 * An optional file path associated with the link.
+	 * Used to disambiguate links that have the same `name`.
+	 * When autocompleting a link with a duplicate name, this path is used as the link target.
+	 */
+	filePath?: string;
+	/**
+	 * A unique identifier for the internal link.
+	 * This value has no direct effect on the editor's behavior but is passed through
+	 * to click events, allowing developers to use it for their own logic (e.g., routing).
+	 */
+	referenceId: string;
+	/**
+	 * An optional Vue component to render when this link is embedded (e.g., `![[link]]`).
+	 * If not provided, embeds of this link will be rendered as standard links.
+	 */
+	embedComponent?: Component;
 }
 
 export interface InternalLinkNode {
@@ -15,12 +38,29 @@ export interface InternalLinkNode {
 	display?: string
 }
 
+/**
+ * Details about a clicked internal link.
+ * This object is emitted as the payload of the `internal-link-click` event.
+ */
 export interface InternalLinkClickDetail {
-    path: string;
-    subpath?: string;
-    display?: string;
-    type: 'embed' | 'internal-link';
-    redirectToPath?: string;
+	/**
+	 * The target of the link as specified in the markdown source.
+	 * This corresponds to the `path` part in `[[path#subpath|display]]`.
+	 * It can be either the `name` or `filePath` of an `InternalLink`.
+	 */
+	target: string;
+	/** The subpath of the link, if any. Corresponds to the `#subpath` part. */
+	subpath?: string;
+	/** The display text (alias) of the link, if any. Corresponds to the `|display` part. */
+	display?: string;
+	/** The type of interaction, either a direct link click or an embed. */
+	type: 'embed' | 'internal-link';
+	/**
+	 * The unique identifier (`referenceId`) of the resolved `InternalLink`.
+	 * This allows developers to identify which link was clicked, even if multiple links
+	 * share the same name or file path.
+	 */
+	referenceId?: string;
 }
 
 export interface ExternalLinkClickDetail {

package/dist/runtime/utils/frontmatter.js

@@ -1,14 +1,10 @@
 import { load } from "js-yaml";
-import { markdown } from "@codemirror/lang-markdown";
-import { GFM } from "@lezer/markdown";
-import { CustomOFM } from "../editor/lezer-parsers/customOFMParsers.js";
+import { parseMarkdownToAST } from "./markdownParser.js";
 export function parseFrontmatter(markdownText) {
   if (!markdownText) {
     return {};
   }
-  const tree = markdown({
-    extensions: [GFM, CustomOFM, { remove: ["SetextHeading"] }]
-  }).language.parser.parse(markdownText);
+  const tree = parseMarkdownToAST(markdownText);
   const firstNode = tree.topNode.firstChild;
   if (!firstNode || firstNode.name !== "YAMLFrontMatter") {
     return {};

package/dist/runtime/utils/internalLinks.js

@@ -1,11 +1,7 @@
-import { markdown } from "@codemirror/lang-markdown";
-import { GFM } from "@lezer/markdown";
-import { CustomOFM } from "../editor/lezer-parsers/customOFMParsers.js";
+import { parseMarkdownToAST } from "./markdownParser.js";
 export function getInternalLinks(markdownText) {
   const links = [];
-  const tree = markdown({
-    extensions: [GFM, CustomOFM, { remove: ["SetextHeading"] }]
-  }).language.parser.parse(markdownText);
+  const tree = parseMarkdownToAST(markdownText);
   tree.iterate({
     enter: (node) => {
       if (node.name === "InternalLink") {

package/dist/runtime/utils/markdownParser.d.ts

@@ -0,0 +1,12 @@
+import type { Tree } from '@lezer/common';
+/**
+ * Creates a markdown parser with standard OFM extensions
+ * This configuration is used consistently across the codebase
+ */
+export declare function createMarkdownParser(): import("@codemirror/language").LanguageSupport;
+/**
+ * Parses markdown text to AST using the standard OFM parser configuration
+ * @param markdownText The markdown text to parse
+ * @returns The parsed syntax tree
+ */
+export declare function parseMarkdownToAST(markdownText: string): Tree;

package/dist/runtime/utils/markdownParser.js

@@ -0,0 +1,11 @@
+import { markdown } from "@codemirror/lang-markdown";
+import { GFM } from "@lezer/markdown";
+import { CustomOFM } from "../editor/lezer-parsers/customOFMParsers.js";
+export function createMarkdownParser() {
+  return markdown({
+    extensions: [GFM, CustomOFM, { remove: ["SetextHeading"] }]
+  });
+}
+export function parseMarkdownToAST(markdownText) {
+  return createMarkdownParser().language.parser.parse(markdownText);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@type32/codemirror-rich-obsidian-editor",
-	"version": "0.0.24",
+	"version": "0.0.26",
 	"description": "OFM Editor Component for Nuxt.",
 	"repository": "Type-32/codemirror-rich-obsidian",
 	"license": "MIT",
@@ -35,45 +35,44 @@
 		"test:types": "bunx vue-tsc --noEmit && cd playground && bunx vue-tsc --noEmit"
 	},
 	"dependencies": {
-		"@codemirror/autocomplete": "^6.18.7",
+		"@codemirror/autocomplete": "^6.19.0",
 		"@codemirror/lang-json": "^6.0.2",
-		"@codemirror/lang-markdown": "^6.3.4",
+		"@codemirror/lang-markdown": "^6.4.0",
 		"@codemirror/lang-yaml": "^6.1.2",
 		"@codemirror/language": "^6.11.3",
 		"@codemirror/language-data": "^6.5.1",
 		"@hsorby/vue3-katex": "0.6.0-rc.7",
 		"@lezer/markdown": "^1.4.3",
 		"@nuxt/image": "1.10.0",
-		"@nuxt/kit": "^4.1.2",
-		"@nuxt/ui": "^4.0.0",
+		"@nuxt/kit": "^4.1.3",
+		"@nuxt/ui": "^4.0.1",
 		"alfaaz": "^1.1.0",
 		"codemirror": "^6.0.2",
 		"js-yaml": "^4.1.0",
-		"katex": "^0.16.22",
+		"katex": "^0.16.23",
 		"lezer-markdown-obsidian": "^0.0.3",
 		"markdown-it": "^14.1.0",
 		"markdown-it-obsidian-callouts": "^0.3.2",
 		"vue-codemirror6": "^1.3.22"
 	},
 	"devDependencies": {
-		"@iconify-json/lucide": "^1.2.68",
-		"@iconify-json/simple-icons": "^1.2.53",
+		"@iconify-json/lucide": "^1.2.69",
+		"@iconify-json/simple-icons": "^1.2.54",
 		"@nuxt/devtools": "^2.6.5",
 		"@nuxt/eslint-config": "^1.9.0",
 		"@nuxt/fonts": "0.11.4",
 		"@nuxt/icon": "1.15.0",
 		"@nuxt/module-builder": "^1.0.2",
-		"@nuxt/schema": "^4.1.2",
+		"@nuxt/schema": "^4.1.3",
 		"@nuxt/test-utils": "^3.19.2",
 		"@types/js-yaml": "^4.0.9",
 		"@types/node": "latest",
 		"changelogen": "^0.6.2",
-		"eslint": "^9.36.0",
-		"nuxt": "^4.1.2",
-		"typescript": "~5.9.2",
+		"eslint": "^9.37.0",
+		"nuxt": "^4.1.3",
+		"typescript": "~5.9.3",
 		"vitest": "^3.2.4",
-		"vue-tsc": "^3.0.8",
-		"alfaaz": "^1.1.0"
+		"vue-tsc": "^3.1.1"
 	},
 	"trustedDependencies": [
 		"@parcel/watcher",