@mrsf/markdown-it-mrsf 0.2.0 → 0.4.0

package/README.md

@@ -112,7 +112,12 @@ Customise with CSS custom properties:
 
 ## Interactive Mode
 
-Enable `interactive: true` to add action buttons (Resolve, Reply, Edit) inside tooltips. These render as `<button data-mrsf-action="..." data-mrsf-comment-id="...">` elements — inert without JavaScript.
+Enable `interactive: true` to add action buttons (Resolve, Reply, Edit) inside tooltips, plus:
+
+- Gutter “Add comment” buttons for each line badge
+- An inline “Add comment” floater that appears when users select text
+
+Buttons render as `<button data-mrsf-action="..." data-mrsf-comment-id="...">` elements — inert without JavaScript.
 
 ```ts
 md.use(mrsfPlugin, {
@@ -135,11 +140,15 @@ document.addEventListener("mrsf:resolve", (e) => {
 document.addEventListener("mrsf:reply", (e) => {
   console.log("Reply to:", e.detail.commentId);
 });
+
+document.addEventListener("mrsf:add", (e) => {
+  console.log("Add on line", e.detail.line, "selection", e.detail.selectionText);
+});
 ```
 
-Events dispatched: `mrsf:resolve`, `mrsf:unresolve`, `mrsf:reply`, `mrsf:edit`, `mrsf:navigate`.
+Events dispatched: `mrsf:add`, `mrsf:resolve`, `mrsf:unresolve`, `mrsf:reply`, `mrsf:edit`, `mrsf:navigate`.
 
-Each event's `detail` contains `{ commentId: string, line: number | null, action: string }`.
+Each event's `detail` contains `{ commentId: string | null, line: number | null, action: string, selectionText?: string | null, start_line?: number | null, end_line?: number | null, start_column?: number | null, end_column?: number | null }` (snake_case to align with the CLI SDK parameters).
 
 ## Options
 
@@ -154,6 +163,7 @@ Each event's `detail` contains `{ commentId: string, line: number | null, action
 | `gutterPosition` | `'left' \| 'tight' \| 'right'` | `'right'` | Badge position: left margin gutter, tight (before text), or floated right |
 | `gutterForInline` | `boolean` | `true` | Show gutter badge for comments that also have inline highlights |
 | `inlineHighlights` | `boolean` | `true` | Render inline text highlights for `selected_text` |
+| `lineHighlight` | `boolean` | `false` | Add background tint on commented lines |
 | `theme` | `'light' \| 'dark' \| 'auto'` | `'auto'` | Color scheme hint |
 | `cwd` | `string` | `process.cwd()` | Working directory for file resolution |
 
@@ -171,7 +181,8 @@ All rendered elements follow a strict data-attribute contract:
 
 - `data-mrsf-line` — source line number (1-based)
 - `data-mrsf-comment-id` — comment identifier
-- `data-mrsf-action` — action type (`resolve`, `unresolve`, `reply`, `edit`, `navigate`)
+- `data-mrsf-action` — action type (`add`, `resolve`, `unresolve`, `reply`, `edit`, `navigate`)
+- `data-mrsf-start-line`, `data-mrsf-end-line`, `data-mrsf-start-column`, `data-mrsf-end-column` — optional selection anchors when present
 
 ## License
 

package/dist/browser.js

@@ -53,117 +53,8 @@ function resolveComments(loader, options) {
   return { lineMap, comments };
 }
 
-// ../shared/dist/html.js
-function escapeHtml(str) {
-  return str.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
-}
-function formatTime(iso) {
-  if (!iso)
-    return "";
-  try {
-    const d = new Date(iso);
-    return d.toLocaleDateString(void 0, {
-      year: "numeric",
-      month: "short",
-      day: "numeric"
-    });
-  } catch {
-    return "";
-  }
-}
-function renderCommentHtml(comment, isReply, interactive) {
-  const resolvedClass = comment.resolved ? " mrsf-resolved" : "";
-  const replyClass = isReply ? " mrsf-reply" : "";
-  let html = `<span class="mrsf-comment${resolvedClass}${replyClass}" data-mrsf-comment-id="${escapeHtml(comment.id)}">`;
-  html += `<span class="mrsf-comment-header">`;
-  html += `<span class="mrsf-author">${escapeHtml(comment.author)}</span>`;
-  if (comment.timestamp) {
-    html += `<span class="mrsf-date">${escapeHtml(formatTime(comment.timestamp))}</span>`;
-  }
-  if (comment.severity) {
-    html += `<span class="mrsf-severity mrsf-severity-${escapeHtml(comment.severity)}">${escapeHtml(comment.severity)}</span>`;
-  }
-  if (comment.type) {
-    html += `<span class="mrsf-type">${escapeHtml(comment.type)}</span>`;
-  }
-  if (comment.resolved) {
-    html += `<span class="mrsf-resolved-badge">\u2713 resolved</span>`;
-  }
-  html += `</span>`;
-  if (comment.selected_text) {
-    html += `<span class="mrsf-selected-text">${escapeHtml(comment.selected_text)}</span>`;
-  }
-  html += `<span class="mrsf-comment-body">${escapeHtml(comment.text)}</span>`;
-  if (interactive) {
-    const line = comment.line != null ? String(comment.line) : "";
-    html += `<span class="mrsf-actions">`;
-    if (comment.resolved) {
-      html += `<button class="mrsf-action-btn" data-mrsf-action="unresolve" data-mrsf-comment-id="${escapeHtml(comment.id)}" data-mrsf-line="${line}">Unresolve</button>`;
-    } else {
-      html += `<button class="mrsf-action-btn" data-mrsf-action="resolve" data-mrsf-comment-id="${escapeHtml(comment.id)}" data-mrsf-line="${line}">Resolve</button>`;
-    }
-    html += `<button class="mrsf-action-btn" data-mrsf-action="reply" data-mrsf-comment-id="${escapeHtml(comment.id)}" data-mrsf-line="${line}">Reply</button>`;
-    html += `<button class="mrsf-action-btn" data-mrsf-action="edit" data-mrsf-comment-id="${escapeHtml(comment.id)}" data-mrsf-line="${line}">Edit</button>`;
-    html += `</span>`;
-  }
-  html += `</span>`;
-  return html;
-}
-function renderThreadHtml(thread, interactive) {
-  let html = `<span class="mrsf-thread">`;
-  html += renderCommentHtml(thread.comment, false, interactive);
-  if (thread.replies.length > 0) {
-    html += `<span class="mrsf-replies">`;
-    for (const reply of thread.replies) {
-      html += renderCommentHtml(reply, true, interactive);
-    }
-    html += `</span>`;
-  }
-  html += `</span>`;
-  return html;
-}
-
 // src/rules/core.ts
-function highlightInlineText(token, thread, interactive, Token) {
-  if (!token.children) return false;
-  const text = thread.comment.selected_text;
-  if (!text) return false;
-  const trimmed = text.trim();
-  if (!trimmed) return false;
-  for (let i = 0; i < token.children.length; i++) {
-    const child = token.children[i];
-    if (child.type !== "text") continue;
-    const idx = child.content.indexOf(trimmed);
-    if (idx === -1) continue;
-    const newTokens = [];
-    if (idx > 0) {
-      const before = new Token("text", "", 0);
-      before.content = child.content.slice(0, idx);
-      newTokens.push(before);
-    }
-    const open = new Token("mrsf_highlight_open", "mark", 1);
-    open.attrSet("class", "mrsf-highlight");
-    open.attrSet("data-mrsf-comment-id", thread.comment.id);
-    open.meta = { thread };
-    newTokens.push(open);
-    const matched = new Token("text", "", 0);
-    matched.content = trimmed;
-    newTokens.push(matched);
-    const close = new Token("mrsf_highlight_close", "mark", -1);
-    close.meta = { thread, interactive };
-    newTokens.push(close);
-    if (idx + trimmed.length < child.content.length) {
-      const after = new Token("text", "", 0);
-      after.content = child.content.slice(idx + trimmed.length);
-      newTokens.push(after);
-    }
-    token.children.splice(i, 1, ...newTokens);
-    return true;
-  }
-  return false;
-}
-function installCoreRule(md, lineMap, options) {
-  const { interactive, gutterPosition, gutterForInline, inlineHighlights } = options;
+function installCoreRule(md, lineMap, options = {}) {
   md.core.ruler.push("mrsf_inject", (state) => {
     const tokens = state.tokens;
     const TokenCtor = state.Token;
@@ -173,127 +64,57 @@ function installCoreRule(md, lineMap, options) {
       const map = token.map;
       if (!map) continue;
       if (token.type === "inline") continue;
+      const startLine1 = map[0] + 1;
+      const endLine1 = map[1];
+      token.attrSet("data-mrsf-line", String(startLine1));
+      token.attrSet("data-mrsf-start-line", String(startLine1));
+      token.attrSet("data-mrsf-end-line", String(endLine1));
       for (let line0 = map[0]; line0 < map[1]; line0++) {
         const line = line0 + 1;
         if (processed.has(line)) continue;
-        const threads = lineMap.get(line);
-        if (!threads || threads.length === 0) continue;
         processed.add(line);
-        const existingClass = token.attrGet("class") || "";
-        token.attrSet(
-          "class",
-          existingClass ? `${existingClass} mrsf-line-highlight` : "mrsf-line-highlight"
-        );
-        token.attrSet("data-mrsf-line", String(line));
-        const allHaveInline = inlineHighlights && threads.every((t) => !!t.comment.selected_text);
-        const showBadge = gutterForInline || !allHaveInline || !inlineHighlights;
-        if (showBadge) {
-          const badgeToken = new TokenCtor("mrsf_badge", "", 0);
-          badgeToken.meta = { line, threads, interactive, gutterPosition };
-          tokens.splice(i + 1, 0, badgeToken);
-        }
-        if (inlineHighlights) {
-          const offset = showBadge ? 2 : 1;
-          const inlineAfter = tokens[i + offset];
-          if (inlineAfter && inlineAfter.type === "inline") {
-            for (const thread of threads) {
-              if (thread.comment.selected_text) {
-                highlightInlineText(inlineAfter, thread, interactive, TokenCtor);
-              }
+        const threads = lineMap.get(line);
+        if (threads && threads.length > 0) {
+          if (options.lineHighlight) {
+            const existingClass = token.attrGet("class") || "";
+            if (!existingClass.includes("mrsf-line-highlight")) {
+              token.attrSet(
+                "class",
+                existingClass ? `${existingClass} mrsf-line-highlight` : "mrsf-line-highlight"
+              );
             }
           }
+          token.attrSet("data-mrsf-line", String(line));
         }
       }
     }
-    if (gutterPosition === "left" && processed.size > 0) {
-      const openToken = new TokenCtor("mrsf_gutter_open", "div", 1);
-      openToken.attrSet("class", "mrsf-gutter-container");
-      tokens.unshift(openToken);
-      const closeToken = new TokenCtor("mrsf_gutter_close", "div", -1);
-      tokens.push(closeToken);
+    const allThreads = [];
+    for (const threads of lineMap.values()) {
+      allThreads.push(...threads);
+    }
+    if (allThreads.length > 0) {
+      const scriptToken = new TokenCtor("mrsf_data_script", "", 0);
+      scriptToken.meta = { threads: allThreads };
+      tokens.push(scriptToken);
     }
   });
 }
 
 // src/rules/renderer.ts
 function installRendererRules(md) {
-  md.renderer.rules["mrsf_badge"] = (tokens, idx) => {
-    const { line, threads, interactive, gutterPosition } = tokens[idx].meta;
-    const total = threads.reduce(
-      (n, t) => n + 1 + t.replies.length,
-      0
-    );
-    const allResolved = threads.every((t) => t.comment.resolved);
-    const highestSeverity = threads.reduce((sev, t) => {
-      if (t.comment.severity === "high" || sev === "high") return "high";
-      if (t.comment.severity === "medium" || sev === "medium") return "medium";
-      if (t.comment.severity === "low" || sev === "low") return "low";
-      return sev;
-    }, null);
-    const resolvedClass = allResolved ? " mrsf-badge-resolved" : "";
-    const severityClass = highestSeverity === "high" || highestSeverity === "medium" ? ` mrsf-badge-severity-${highestSeverity}` : "";
-    const positionClass = ` mrsf-gutter-${gutterPosition}`;
-    const icon = allResolved ? "\u2713" : "\u{1F4AC}";
-    let html = `<span class="mrsf-tooltip-anchor${positionClass}">`;
-    html += `<span class="mrsf-badge${resolvedClass}${severityClass}" data-mrsf-line="${line}" data-mrsf-action="navigate" data-mrsf-comment-id="${escapeHtml(threads[0].comment.id)}" tabindex="0">${icon} ${total}</span>`;
-    html += `<span class="mrsf-tooltip" data-mrsf-line="${line}">`;
-    for (const thread of threads) {
-      html += renderThreadHtml(thread, interactive);
-    }
-    html += `</span>`;
-    html += `</span>`;
-    return html;
-  };
-  md.renderer.rules["mrsf_highlight_open"] = (tokens, idx) => {
-    const token = tokens[idx];
-    const cls = token.attrGet("class") || "mrsf-highlight";
-    const commentId = token.attrGet("data-mrsf-comment-id") || "";
-    const thread = token.meta?.thread;
-    let html = "";
-    if (thread) {
-      html += `<span class="mrsf-tooltip-anchor mrsf-inline-anchor">`;
-    }
-    html += `<mark class="${escapeHtml(cls)}" data-mrsf-comment-id="${escapeHtml(commentId)}" tabindex="0">`;
-    return html;
-  };
-  md.renderer.rules["mrsf_highlight_close"] = (tokens, idx) => {
-    const token = tokens[idx];
-    const meta = token.meta;
-    let html = "</mark>";
-    if (meta?.thread) {
-      const thread = meta.thread;
-      const interactive = meta.interactive;
-      html += `<span class="mrsf-tooltip mrsf-inline-tooltip">`;
-      html += renderThreadHtml(thread, interactive);
-      html += `</span>`;
-      html += `</span>`;
-    }
-    return html;
-  };
-  md.renderer.rules["mrsf_gutter_open"] = (tokens, idx) => {
-    const cls = tokens[idx].attrGet("class") || "mrsf-gutter-container";
-    return `<div class="${escapeHtml(cls)}">`;
-  };
-  md.renderer.rules["mrsf_gutter_close"] = () => {
-    return `</div>`;
+  md.renderer.rules["mrsf_data_script"] = (tokens, idx) => {
+    const { threads } = tokens[idx].meta;
+    const data = JSON.stringify({ threads }).replace(/</g, "\\u003c");
+    return `<script type="application/mrsf+json">${data}</script>`;
   };
 }
 
 // src/shared.ts
 function createMrsfPlugin(loader) {
   return function mrsfPlugin2(md, options = {}) {
-    const interactive = options.interactive ?? false;
-    const gutterPosition = options.gutterPosition ?? "right";
-    const gutterForInline = options.gutterForInline ?? true;
-    const inlineHighlights = options.inlineHighlights ?? true;
     const result = resolveComments(loader, options);
     if (!result) return;
-    installCoreRule(md, result.lineMap, {
-      interactive,
-      gutterPosition,
-      gutterForInline,
-      inlineHighlights
-    });
+    installCoreRule(md, result.lineMap, { lineHighlight: options.lineHighlight ?? false });
     installRendererRules(md);
   };
 }

package/dist/browser.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
-  "sources": ["../../shared/src/comments.ts", "../../shared/src/html.ts", "../src/rules/core.ts", "../src/rules/renderer.ts", "../src/shared.ts", "../src/browser.ts"],
-  "sourcesContent": ["/**\n * Shared comment loading and grouping logic for MRSF rendering plugins.\n */\n\nimport type { MrsfDocument } from \"@mrsf/cli\";\nimport type { MrsfPluginOptions, SlimComment, CommentThread, LineMap, CommentLoader } from \"./types.js\";\n\nexport type { CommentLoader };\n\n/**\n * Convert an MrsfDocument into a slim comment array.\n */\nexport function toSlimComments(doc: MrsfDocument): SlimComment[] {\n  return doc.comments.map((c) => ({\n    id: c.id,\n    author: c.author || \"Unknown\",\n    text: c.text || \"\",\n    line: c.line ?? null,\n    end_line: c.end_line ?? null,\n    start_column: c.start_column ?? null,\n    end_column: c.end_column ?? null,\n    selected_text: c.selected_text || null,\n    resolved: !!c.resolved,\n    reply_to: c.reply_to || null,\n    severity: c.severity || null,\n    type: c.type || null,\n    timestamp: c.timestamp || null,\n  }));\n}\n\n/**\n * Group comments by line number, threading replies under parents.\n */\nexport function groupByLine(comments: SlimComment[]): LineMap {\n  const rootComments = comments.filter((c) => !c.reply_to && c.line != null);\n  const replies = comments.filter((c) => c.reply_to);\n\n  const replyMap = new Map<string, SlimComment[]>();\n  for (const r of replies) {\n    const list = replyMap.get(r.reply_to!) || [];\n    list.push(r);\n    replyMap.set(r.reply_to!, list);\n  }\n\n  const lineMap: LineMap = new Map();\n  for (const c of rootComments) {\n    const line = c.line!;\n    const threads = lineMap.get(line) || [];\n    threads.push({\n      comment: c,\n      replies: replyMap.get(c.id) || [],\n    });\n    lineMap.set(line, threads);\n  }\n\n  return lineMap;\n}\n\n/**\n * Resolve options into a filtered LineMap ready for rendering.\n * Returns null if there are no comments to render.\n */\nexport function resolveComments(\n  loader: CommentLoader,\n  options: MrsfPluginOptions,\n): { lineMap: LineMap; comments: SlimComment[] } | null {\n  const showResolved = options.showResolved ?? true;\n\n  const doc = loader(options);\n  if (!doc || !doc.comments || doc.comments.length === 0) {\n    return null;\n  }\n\n  let comments = toSlimComments(doc);\n  if (!showResolved) {\n    comments = comments.filter((c) => !c.resolved);\n  }\n\n  if (comments.length === 0) return null;\n\n  const lineMap = groupByLine(comments);\n  return { lineMap, comments };\n}\n", "/**\n * Shared HTML rendering helpers for MRSF rendering plugins.\n *\n * These produce the HTML strings used in tooltips, badges, and comment\n * rendering. Both the markdown-it and rehype plugins use these functions\n * to ensure identical visual output.\n */\n\nimport type { CommentThread, SlimComment } from \"./types.js\";\n\nexport function escapeHtml(str: string): string {\n  return str\n    .replace(/&/g, \"&amp;\")\n    .replace(/</g, \"&lt;\")\n    .replace(/>/g, \"&gt;\")\n    .replace(/\"/g, \"&quot;\");\n}\n\nexport function formatTime(iso: string | null): string {\n  if (!iso) return \"\";\n  try {\n    const d = new Date(iso);\n    return d.toLocaleDateString(undefined, {\n      year: \"numeric\",\n      month: \"short\",\n      day: \"numeric\",\n    });\n  } catch {\n    return \"\";\n  }\n}\n\nexport function renderCommentHtml(\n  comment: SlimComment,\n  isReply: boolean,\n  interactive: boolean,\n): string {\n  const resolvedClass = comment.resolved ? \" mrsf-resolved\" : \"\";\n  const replyClass = isReply ? \" mrsf-reply\" : \"\";\n  let html = `<span class=\"mrsf-comment${resolvedClass}${replyClass}\" data-mrsf-comment-id=\"${escapeHtml(comment.id)}\">`;\n\n  // Header\n  html += `<span class=\"mrsf-comment-header\">`;\n  html += `<span class=\"mrsf-author\">${escapeHtml(comment.author)}</span>`;\n  if (comment.timestamp) {\n    html += `<span class=\"mrsf-date\">${escapeHtml(formatTime(comment.timestamp))}</span>`;\n  }\n  if (comment.severity) {\n    html += `<span class=\"mrsf-severity mrsf-severity-${escapeHtml(comment.severity)}\">${escapeHtml(comment.severity)}</span>`;\n  }\n  if (comment.type) {\n    html += `<span class=\"mrsf-type\">${escapeHtml(comment.type)}</span>`;\n  }\n  if (comment.resolved) {\n    html += `<span class=\"mrsf-resolved-badge\">\u2713 resolved</span>`;\n  }\n  html += `</span>`;\n\n  // Selected text quote\n  if (comment.selected_text) {\n    html += `<span class=\"mrsf-selected-text\">${escapeHtml(comment.selected_text)}</span>`;\n  }\n\n  // Body\n  html += `<span class=\"mrsf-comment-body\">${escapeHtml(comment.text)}</span>`;\n\n  // Action buttons (interactive mode)\n  if (interactive) {\n    const line = comment.line != null ? String(comment.line) : \"\";\n    html += `<span class=\"mrsf-actions\">`;\n    if (comment.resolved) {\n      html += `<button class=\"mrsf-action-btn\" data-mrsf-action=\"unresolve\" data-mrsf-comment-id=\"${escapeHtml(comment.id)}\" data-mrsf-line=\"${line}\">Unresolve</button>`;\n    } else {\n      html += `<button class=\"mrsf-action-btn\" data-mrsf-action=\"resolve\" data-mrsf-comment-id=\"${escapeHtml(comment.id)}\" data-mrsf-line=\"${line}\">Resolve</button>`;\n    }\n    html += `<button class=\"mrsf-action-btn\" data-mrsf-action=\"reply\" data-mrsf-comment-id=\"${escapeHtml(comment.id)}\" data-mrsf-line=\"${line}\">Reply</button>`;\n    html += `<button class=\"mrsf-action-btn\" data-mrsf-action=\"edit\" data-mrsf-comment-id=\"${escapeHtml(comment.id)}\" data-mrsf-line=\"${line}\">Edit</button>`;\n    html += `</span>`;\n  }\n\n  html += `</span>`;\n  return html;\n}\n\nexport function renderThreadHtml(thread: CommentThread, interactive: boolean): string {\n  let html = `<span class=\"mrsf-thread\">`;\n  html += renderCommentHtml(thread.comment, false, interactive);\n  if (thread.replies.length > 0) {\n    html += `<span class=\"mrsf-replies\">`;\n    for (const reply of thread.replies) {\n      html += renderCommentHtml(reply, true, interactive);\n    }\n    html += `</span>`;\n  }\n  html += `</span>`;\n  return html;\n}\n", "/**\n * MRSF markdown-it plugin \u2014 core rule.\n *\n * Walks the parsed token stream and injects `mrsf_badge` tokens\n * at lines that have comments, and wraps `selected_text` matches\n * with `mrsf_highlight_open`/`close` tokens (with tooltip metadata).\n */\n\nimport type Token from \"markdown-it/lib/token.mjs\";\nimport type { Nesting } from \"markdown-it/lib/token.mjs\";\nimport type StateCore from \"markdown-it/lib/rules_core/state_core.mjs\";\nimport type { LineMap, CommentThread } from \"../types.js\";\n\n/** Options forwarded from the plugin to the core rule. */\nexport interface CoreOptions {\n  interactive: boolean;\n  gutterPosition: \"left\" | \"tight\" | \"right\";\n  gutterForInline: boolean;\n  inlineHighlights: boolean;\n}\n\n/**\n * Find the token index for a given 1-based source line.\n * markdown-it tokens use `token.map = [startLine, endLine]` (0-based).\n */\nfunction findTokenIndexForLine(\n  tokens: Token[],\n  line: number,\n): number {\n  const line0 = line - 1; // convert to 0-based\n  for (let i = 0; i < tokens.length; i++) {\n    const map = tokens[i].map;\n    if (map && map[0] <= line0 && line0 < map[1]) {\n      return i;\n    }\n  }\n  return -1;\n}\n\n/**\n * Wrap occurrences of `text` inside inline token children with\n * highlight open/close tokens. Stores thread data on the tokens\n * so the renderer can produce an inline tooltip.\n */\nfunction highlightInlineText(\n  token: Token,\n  thread: CommentThread,\n  interactive: boolean,\n  Token: new (type: string, tag: string, nesting: Nesting) => Token,\n): boolean {\n  if (!token.children) return false;\n\n  const text = thread.comment.selected_text;\n  if (!text) return false;\n  const trimmed = text.trim();\n  if (!trimmed) return false;\n\n  for (let i = 0; i < token.children.length; i++) {\n    const child = token.children[i];\n    if (child.type !== \"text\") continue;\n\n    const idx = child.content.indexOf(trimmed);\n    if (idx === -1) continue;\n\n    // Split the text token into: before + highlight_open + matched + highlight_close + after\n    const newTokens: Token[] = [];\n\n    // Text before match\n    if (idx > 0) {\n      const before = new Token(\"text\", \"\", 0);\n      before.content = child.content.slice(0, idx);\n      newTokens.push(before);\n    }\n\n    // Highlight open \u2014 carries thread metadata for inline tooltip\n    const open = new Token(\"mrsf_highlight_open\", \"mark\", 1);\n    open.attrSet(\"class\", \"mrsf-highlight\");\n    open.attrSet(\"data-mrsf-comment-id\", thread.comment.id);\n    open.meta = { thread };\n    newTokens.push(open);\n\n    // Matched text\n    const matched = new Token(\"text\", \"\", 0);\n    matched.content = trimmed;\n    newTokens.push(matched);\n\n    // Highlight close \u2014 carries thread metadata for inline tooltip\n    const close = new Token(\"mrsf_highlight_close\", \"mark\", -1);\n    close.meta = { thread, interactive };\n    newTokens.push(close);\n\n    // Text after match\n    if (idx + trimmed.length < child.content.length) {\n      const after = new Token(\"text\", \"\", 0);\n      after.content = child.content.slice(idx + trimmed.length);\n      newTokens.push(after);\n    }\n\n    // Replace the original child with our new tokens\n    token.children.splice(i, 1, ...newTokens);\n    return true;\n  }\n\n  return false;\n}\n\n/**\n * Install the MRSF core rule on a markdown-it instance.\n */\nexport function installCoreRule(\n  md: { core: { ruler: { push: (name: string, fn: (state: StateCore) => void) => void } } },\n  lineMap: LineMap,\n  options: CoreOptions,\n): void {\n  const { interactive, gutterPosition, gutterForInline, inlineHighlights } = options;\n\n  md.core.ruler.push(\"mrsf_inject\", (state: StateCore) => {\n    const tokens = state.tokens;\n    const TokenCtor = state.Token;\n\n    // Track which lines we've already processed (to avoid double-injection\n    // when multiple tokens share the same source line).\n    const processed = new Set<number>();\n\n    // We iterate backwards so that inserting tokens doesn't shift indices\n    // for tokens we haven't visited yet.\n    for (let i = tokens.length - 1; i >= 0; i--) {\n      const token = tokens[i];\n      const map = token.map;\n      if (!map) continue;\n\n      // Skip inline tokens \u2014 they share the same map as their parent block.\n      // We must process the parent block (paragraph_open, heading_open, etc.)\n      // so the badge and class land on the correct rendered element.\n      if (token.type === \"inline\") continue;\n\n      // Check each line in this token's range for comments\n      for (let line0 = map[0]; line0 < map[1]; line0++) {\n        const line = line0 + 1; // 1-based\n        if (processed.has(line)) continue;\n\n        const threads = lineMap.get(line);\n        if (!threads || threads.length === 0) continue;\n        processed.add(line);\n\n        // Add line-highlight class to the block token\n        const existingClass = token.attrGet(\"class\") || \"\";\n        token.attrSet(\n          \"class\",\n          existingClass\n            ? `${existingClass} mrsf-line-highlight`\n            : \"mrsf-line-highlight\",\n        );\n        token.attrSet(\"data-mrsf-line\", String(line));\n\n        // Determine whether all threads on this line have inline highlights\n        const allHaveInline = inlineHighlights &&\n          threads.every((t) => !!t.comment.selected_text);\n\n        // Inject badge unless gutterForInline is false AND all threads are inline-highlighted\n        const showBadge = gutterForInline || !allHaveInline || !inlineHighlights;\n        if (showBadge) {\n          const badgeToken = new TokenCtor(\"mrsf_badge\", \"\", 0);\n          badgeToken.meta = { line, threads, interactive, gutterPosition };\n          tokens.splice(i + 1, 0, badgeToken);\n        }\n\n        // Highlight selected_text in the following inline token\n        if (inlineHighlights) {\n          const offset = showBadge ? 2 : 1;\n          const inlineAfter = tokens[i + offset];\n          if (inlineAfter && inlineAfter.type === \"inline\") {\n            for (const thread of threads) {\n              if (thread.comment.selected_text) {\n                highlightInlineText(inlineAfter, thread, interactive, TokenCtor);\n              }\n            }\n          }\n        }\n      }\n    }\n\n    // Wrap the entire output in a gutter container when using left gutter\n    if (gutterPosition === \"left\" && processed.size > 0) {\n      const openToken = new TokenCtor(\"mrsf_gutter_open\", \"div\", 1);\n      openToken.attrSet(\"class\", \"mrsf-gutter-container\");\n      tokens.unshift(openToken);\n      const closeToken = new TokenCtor(\"mrsf_gutter_close\", \"div\", -1 as Nesting);\n      tokens.push(closeToken);\n    }\n  });\n}\n", "/**\n * MRSF markdown-it plugin \u2014 renderer rules.\n *\n * Adds custom renderer rules for MRSF tokens:\n *   - mrsf_badge: renders badge + tooltip HTML (gutter)\n *   - mrsf_highlight_open/close: renders <mark> wrappers with inline tooltips\n */\n\nimport type { CommentThread } from \"../types.js\";\nimport { escapeHtml, renderThreadHtml } from \"@mrsf/plugin-shared\";\n\n/**\n * Install MRSF renderer rules on a markdown-it instance.\n */\nexport function installRendererRules(\n  md: { renderer: { rules: Record<string, ((...args: any[]) => string) | undefined> } },\n): void {\n  // Badge + tooltip (gutter)\n  md.renderer.rules[\"mrsf_badge\"] = (\n    tokens: { meta: { line: number; threads: CommentThread[]; interactive: boolean; gutterPosition: \"left\" | \"tight\" | \"right\" } }[],\n    idx: number,\n  ): string => {\n    const { line, threads, interactive, gutterPosition } = tokens[idx].meta;\n\n    const total = threads.reduce(\n      (n, t) => n + 1 + t.replies.length,\n      0,\n    );\n    const allResolved = threads.every((t) => t.comment.resolved);\n    const highestSeverity = threads.reduce<string | null>((sev, t) => {\n      if (t.comment.severity === \"high\" || sev === \"high\") return \"high\";\n      if (t.comment.severity === \"medium\" || sev === \"medium\") return \"medium\";\n      if (t.comment.severity === \"low\" || sev === \"low\") return \"low\";\n      return sev;\n    }, null);\n\n    const resolvedClass = allResolved ? \" mrsf-badge-resolved\" : \"\";\n    const severityClass = highestSeverity === \"high\" || highestSeverity === \"medium\"\n      ? ` mrsf-badge-severity-${highestSeverity}`\n      : \"\";\n    const positionClass = ` mrsf-gutter-${gutterPosition}`;\n\n    const icon = allResolved ? \"\u2713\" : \"\uD83D\uDCAC\";\n\n    let html = `<span class=\"mrsf-tooltip-anchor${positionClass}\">`;\n\n    // Badge\n    html += `<span class=\"mrsf-badge${resolvedClass}${severityClass}\" data-mrsf-line=\"${line}\" data-mrsf-action=\"navigate\" data-mrsf-comment-id=\"${escapeHtml(threads[0].comment.id)}\" tabindex=\"0\">${icon} ${total}</span>`;\n\n    // Tooltip\n    html += `<span class=\"mrsf-tooltip\" data-mrsf-line=\"${line}\">`;\n    for (const thread of threads) {\n      html += renderThreadHtml(thread, interactive);\n    }\n    html += `</span>`;\n\n    html += `</span>`;\n    return html;\n  };\n\n  // Highlight open \u2014 wraps in tooltip-anchor for inline hover (feature D)\n  md.renderer.rules[\"mrsf_highlight_open\"] = (\n    tokens: any[],\n    idx: number,\n  ): string => {\n    const token = tokens[idx];\n    const cls = token.attrGet(\"class\") || \"mrsf-highlight\";\n    const commentId = token.attrGet(\"data-mrsf-comment-id\") || \"\";\n    const thread = token.meta?.thread as CommentThread | undefined;\n\n    let html = \"\";\n    if (thread) {\n      html += `<span class=\"mrsf-tooltip-anchor mrsf-inline-anchor\">`;\n    }\n    html += `<mark class=\"${escapeHtml(cls)}\" data-mrsf-comment-id=\"${escapeHtml(commentId)}\" tabindex=\"0\">`;\n    return html;\n  };\n\n  // Highlight close \u2014 adds inline tooltip and closes tooltip-anchor\n  md.renderer.rules[\"mrsf_highlight_close\"] = (\n    tokens: any[],\n    idx: number,\n  ): string => {\n    const token = tokens[idx];\n    const meta = token.meta;\n    let html = \"</mark>\";\n\n    if (meta?.thread) {\n      const thread = meta.thread as CommentThread;\n      const interactive = meta.interactive as boolean;\n      html += `<span class=\"mrsf-tooltip mrsf-inline-tooltip\">`;\n      html += renderThreadHtml(thread, interactive);\n      html += `</span>`;\n      html += `</span>`;\n    }\n\n    return html;\n  };\n\n  // Gutter container wrapper (left gutter mode)\n  md.renderer.rules[\"mrsf_gutter_open\"] = (\n    tokens: any[],\n    idx: number,\n  ): string => {\n    const cls = tokens[idx].attrGet(\"class\") || \"mrsf-gutter-container\";\n    return `<div class=\"${escapeHtml(cls)}\">`;\n  };\n\n  md.renderer.rules[\"mrsf_gutter_close\"] = (): string => {\n    return `</div>`;\n  };\n}\n", "/**\n * Shared logic for @mrsf/markdown-it-mrsf.\n *\n * Contains the plugin factory using shared comment loading/grouping logic.\n */\n\nimport type MarkdownIt from \"markdown-it\";\nimport type { MrsfPluginOptions, CommentLoader } from \"./types.js\";\nimport { resolveComments } from \"@mrsf/plugin-shared\";\nimport { installCoreRule } from \"./rules/core.js\";\nimport { installRendererRules } from \"./rules/renderer.js\";\n\n/**\n * Create a markdown-it plugin function with the given comment loader.\n *\n * @param loader - Function that resolves sidecar data from plugin options\n * @returns A markdown-it plugin function\n */\nexport function createMrsfPlugin(loader: CommentLoader) {\n  return function mrsfPlugin(md: MarkdownIt, options: MrsfPluginOptions = {}): void {\n    const interactive = options.interactive ?? false;\n    const gutterPosition = options.gutterPosition ?? \"right\";\n    const gutterForInline = options.gutterForInline ?? true;\n    const inlineHighlights = options.inlineHighlights ?? true;\n\n    const result = resolveComments(loader, options);\n    if (!result) return;\n\n    installCoreRule(md, result.lineMap, {\n      interactive,\n      gutterPosition,\n      gutterForInline,\n      inlineHighlights,\n    });\n    installRendererRules(md);\n  };\n}\n", "/**\n * Browser-safe entry point for @mrsf/markdown-it-mrsf.\n *\n * This entry is automatically selected by bundlers (Vite, webpack, esbuild)\n * via the `\"browser\"` export condition in package.json. It supports the\n * `comments` and `loader` provisioning modes \u2014 no Node.js file-system APIs.\n *\n * You do NOT need to import this directly. Just use:\n *   import { mrsfPlugin } from \"@mrsf/markdown-it-mrsf\";\n *\n * Your bundler will resolve to this file automatically when targeting\n * a browser environment.\n */\n\nimport type { MrsfPluginOptions } from \"./types.js\";\nimport { createMrsfPlugin } from \"./shared.js\";\n\nexport type { MrsfPluginOptions, SlimComment, CommentThread, LineMap, CommentLoader } from \"./types.js\";\n\n/**\n * The markdown-it plugin function (browser-safe).\n *\n * Supports `comments` (inline data) and `loader` (custom function) options.\n */\nexport const mrsfPlugin = createMrsfPlugin((options: MrsfPluginOptions) => {\n  if (options.comments) {\n    return options.comments;\n  }\n\n  if (options.loader) {\n    try {\n      return options.loader();\n    } catch {\n      return null;\n    }\n  }\n\n  if (options.sidecarPath || options.documentPath) {\n    console.warn(\n      \"[@mrsf/markdown-it-mrsf] sidecarPath and documentPath require Node.js. \" +\n      \"Use `comments` or `loader` options in browser environments.\"\n    );\n  }\n\n  return null;\n});\n\nexport default mrsfPlugin;\n"],
-  "mappings": ";AAYM,SAAU,eAAe,KAAiB;AAC9C,SAAO,IAAI,SAAS,IAAI,CAAC,OAAO;IAC9B,IAAI,EAAE;IACN,QAAQ,EAAE,UAAU;IACpB,MAAM,EAAE,QAAQ;IAChB,MAAM,EAAE,QAAQ;IAChB,UAAU,EAAE,YAAY;IACxB,cAAc,EAAE,gBAAgB;IAChC,YAAY,EAAE,cAAc;IAC5B,eAAe,EAAE,iBAAiB;IAClC,UAAU,CAAC,CAAC,EAAE;IACd,UAAU,EAAE,YAAY;IACxB,UAAU,EAAE,YAAY;IACxB,MAAM,EAAE,QAAQ;IAChB,WAAW,EAAE,aAAa;IAC1B;AACJ;AAKM,SAAU,YAAY,UAAuB;AACjD,QAAM,eAAe,SAAS,OAAO,CAAC,MAAM,CAAC,EAAE,YAAY,EAAE,QAAQ,IAAI;AACzE,QAAM,UAAU,SAAS,OAAO,CAAC,MAAM,EAAE,QAAQ;AAEjD,QAAM,WAAW,oBAAI,IAAG;AACxB,aAAW,KAAK,SAAS;AACvB,UAAM,OAAO,SAAS,IAAI,EAAE,QAAS,KAAK,CAAA;AAC1C,SAAK,KAAK,CAAC;AACX,aAAS,IAAI,EAAE,UAAW,IAAI;EAChC;AAEA,QAAM,UAAmB,oBAAI,IAAG;AAChC,aAAW,KAAK,cAAc;AAC5B,UAAM,OAAO,EAAE;AACf,UAAM,UAAU,QAAQ,IAAI,IAAI,KAAK,CAAA;AACrC,YAAQ,KAAK;MACX,SAAS;MACT,SAAS,SAAS,IAAI,EAAE,EAAE,KAAK,CAAA;KAChC;AACD,YAAQ,IAAI,MAAM,OAAO;EAC3B;AAEA,SAAO;AACT;AAMM,SAAU,gBACd,QACA,SAA0B;AAE1B,QAAM,eAAe,QAAQ,gBAAgB;AAE7C,QAAM,MAAM,OAAO,OAAO;AAC1B,MAAI,CAAC,OAAO,CAAC,IAAI,YAAY,IAAI,SAAS,WAAW,GAAG;AACtD,WAAO;EACT;AAEA,MAAI,WAAW,eAAe,GAAG;AACjC,MAAI,CAAC,cAAc;AACjB,eAAW,SAAS,OAAO,CAAC,MAAM,CAAC,EAAE,QAAQ;EAC/C;AAEA,MAAI,SAAS,WAAW;AAAG,WAAO;AAElC,QAAM,UAAU,YAAY,QAAQ;AACpC,SAAO,EAAE,SAAS,SAAQ;AAC5B;;;ACxEM,SAAU,WAAW,KAAW;AACpC,SAAO,IACJ,QAAQ,MAAM,OAAO,EACrB,QAAQ,MAAM,MAAM,EACpB,QAAQ,MAAM,MAAM,EACpB,QAAQ,MAAM,QAAQ;AAC3B;AAEM,SAAU,WAAW,KAAkB;AAC3C,MAAI,CAAC;AAAK,WAAO;AACjB,MAAI;AACF,UAAM,IAAI,IAAI,KAAK,GAAG;AACtB,WAAO,EAAE,mBAAmB,QAAW;MACrC,MAAM;MACN,OAAO;MACP,KAAK;KACN;EACH,QAAQ;AACN,WAAO;EACT;AACF;AAEM,SAAU,kBACd,SACA,SACA,aAAoB;AAEpB,QAAM,gBAAgB,QAAQ,WAAW,mBAAmB;AAC5D,QAAM,aAAa,UAAU,gBAAgB;AAC7C,MAAI,OAAO,4BAA4B,aAAa,GAAG,UAAU,2BAA2B,WAAW,QAAQ,EAAE,CAAC;AAGlH,UAAQ;AACR,UAAQ,6BAA6B,WAAW,QAAQ,MAAM,CAAC;AAC/D,MAAI,QAAQ,WAAW;AACrB,YAAQ,2BAA2B,WAAW,WAAW,QAAQ,SAAS,CAAC,CAAC;EAC9E;AACA,MAAI,QAAQ,UAAU;AACpB,YAAQ,4CAA4C,WAAW,QAAQ,QAAQ,CAAC,KAAK,WAAW,QAAQ,QAAQ,CAAC;EACnH;AACA,MAAI,QAAQ,MAAM;AAChB,YAAQ,2BAA2B,WAAW,QAAQ,IAAI,CAAC;EAC7D;AACA,MAAI,QAAQ,UAAU;AACpB,YAAQ;EACV;AACA,UAAQ;AAGR,MAAI,QAAQ,eAAe;AACzB,YAAQ,oCAAoC,WAAW,QAAQ,aAAa,CAAC;EAC/E;AAGA,UAAQ,mCAAmC,WAAW,QAAQ,IAAI,CAAC;AAGnE,MAAI,aAAa;AACf,UAAM,OAAO,QAAQ,QAAQ,OAAO,OAAO,QAAQ,IAAI,IAAI;AAC3D,YAAQ;AACR,QAAI,QAAQ,UAAU;AACpB,cAAQ,sFAAsF,WAAW,QAAQ,EAAE,CAAC,qBAAqB,IAAI;IAC/I,OAAO;AACL,cAAQ,oFAAoF,WAAW,QAAQ,EAAE,CAAC,qBAAqB,IAAI;IAC7I;AACA,YAAQ,kFAAkF,WAAW,QAAQ,EAAE,CAAC,qBAAqB,IAAI;AACzI,YAAQ,iFAAiF,WAAW,QAAQ,EAAE,CAAC,qBAAqB,IAAI;AACxI,YAAQ;EACV;AAEA,UAAQ;AACR,SAAO;AACT;AAEM,SAAU,iBAAiB,QAAuB,aAAoB;AAC1E,MAAI,OAAO;AACX,UAAQ,kBAAkB,OAAO,SAAS,OAAO,WAAW;AAC5D,MAAI,OAAO,QAAQ,SAAS,GAAG;AAC7B,YAAQ;AACR,eAAW,SAAS,OAAO,SAAS;AAClC,cAAQ,kBAAkB,OAAO,MAAM,WAAW;IACpD;AACA,YAAQ;EACV;AACA,UAAQ;AACR,SAAO;AACT;;;ACpDA,SAAS,oBACP,OACA,QACA,aACA,OACS;AACT,MAAI,CAAC,MAAM,SAAU,QAAO;AAE5B,QAAM,OAAO,OAAO,QAAQ;AAC5B,MAAI,CAAC,KAAM,QAAO;AAClB,QAAM,UAAU,KAAK,KAAK;AAC1B,MAAI,CAAC,QAAS,QAAO;AAErB,WAAS,IAAI,GAAG,IAAI,MAAM,SAAS,QAAQ,KAAK;AAC9C,UAAM,QAAQ,MAAM,SAAS,CAAC;AAC9B,QAAI,MAAM,SAAS,OAAQ;AAE3B,UAAM,MAAM,MAAM,QAAQ,QAAQ,OAAO;AACzC,QAAI,QAAQ,GAAI;AAGhB,UAAM,YAAqB,CAAC;AAG5B,QAAI,MAAM,GAAG;AACX,YAAM,SAAS,IAAI,MAAM,QAAQ,IAAI,CAAC;AACtC,aAAO,UAAU,MAAM,QAAQ,MAAM,GAAG,GAAG;AAC3C,gBAAU,KAAK,MAAM;AAAA,IACvB;AAGA,UAAM,OAAO,IAAI,MAAM,uBAAuB,QAAQ,CAAC;AACvD,SAAK,QAAQ,SAAS,gBAAgB;AACtC,SAAK,QAAQ,wBAAwB,OAAO,QAAQ,EAAE;AACtD,SAAK,OAAO,EAAE,OAAO;AACrB,cAAU,KAAK,IAAI;AAGnB,UAAM,UAAU,IAAI,MAAM,QAAQ,IAAI,CAAC;AACvC,YAAQ,UAAU;AAClB,cAAU,KAAK,OAAO;AAGtB,UAAM,QAAQ,IAAI,MAAM,wBAAwB,QAAQ,EAAE;AAC1D,UAAM,OAAO,EAAE,QAAQ,YAAY;AACnC,cAAU,KAAK,KAAK;AAGpB,QAAI,MAAM,QAAQ,SAAS,MAAM,QAAQ,QAAQ;AAC/C,YAAM,QAAQ,IAAI,MAAM,QAAQ,IAAI,CAAC;AACrC,YAAM,UAAU,MAAM,QAAQ,MAAM,MAAM,QAAQ,MAAM;AACxD,gBAAU,KAAK,KAAK;AAAA,IACtB;AAGA,UAAM,SAAS,OAAO,GAAG,GAAG,GAAG,SAAS;AACxC,WAAO;AAAA,EACT;AAEA,SAAO;AACT;AAKO,SAAS,gBACd,IACA,SACA,SACM;AACN,QAAM,EAAE,aAAa,gBAAgB,iBAAiB,iBAAiB,IAAI;AAE3E,KAAG,KAAK,MAAM,KAAK,eAAe,CAAC,UAAqB;AACtD,UAAM,SAAS,MAAM;AACrB,UAAM,YAAY,MAAM;AAIxB,UAAM,YAAY,oBAAI,IAAY;AAIlC,aAAS,IAAI,OAAO,SAAS,GAAG,KAAK,GAAG,KAAK;AAC3C,YAAM,QAAQ,OAAO,CAAC;AACtB,YAAM,MAAM,MAAM;AAClB,UAAI,CAAC,IAAK;AAKV,UAAI,MAAM,SAAS,SAAU;AAG7B,eAAS,QAAQ,IAAI,CAAC,GAAG,QAAQ,IAAI,CAAC,GAAG,SAAS;AAChD,cAAM,OAAO,QAAQ;AACrB,YAAI,UAAU,IAAI,IAAI,EAAG;AAEzB,cAAM,UAAU,QAAQ,IAAI,IAAI;AAChC,YAAI,CAAC,WAAW,QAAQ,WAAW,EAAG;AACtC,kBAAU,IAAI,IAAI;AAGlB,cAAM,gBAAgB,MAAM,QAAQ,OAAO,KAAK;AAChD,cAAM;AAAA,UACJ;AAAA,UACA,gBACI,GAAG,aAAa,yBAChB;AAAA,QACN;AACA,cAAM,QAAQ,kBAAkB,OAAO,IAAI,CAAC;AAG5C,cAAM,gBAAgB,oBACpB,QAAQ,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,QAAQ,aAAa;AAGhD,cAAM,YAAY,mBAAmB,CAAC,iBAAiB,CAAC;AACxD,YAAI,WAAW;AACb,gBAAM,aAAa,IAAI,UAAU,cAAc,IAAI,CAAC;AACpD,qBAAW,OAAO,EAAE,MAAM,SAAS,aAAa,eAAe;AAC/D,iBAAO,OAAO,IAAI,GAAG,GAAG,UAAU;AAAA,QACpC;AAGA,YAAI,kBAAkB;AACpB,gBAAM,SAAS,YAAY,IAAI;AAC/B,gBAAM,cAAc,OAAO,IAAI,MAAM;AACrC,cAAI,eAAe,YAAY,SAAS,UAAU;AAChD,uBAAW,UAAU,SAAS;AAC5B,kBAAI,OAAO,QAAQ,eAAe;AAChC,oCAAoB,aAAa,QAAQ,aAAa,SAAS;AAAA,cACjE;AAAA,YACF;AAAA,UACF;AAAA,QACF;AAAA,MACF;AAAA,IACF;AAGA,QAAI,mBAAmB,UAAU,UAAU,OAAO,GAAG;AACnD,YAAM,YAAY,IAAI,UAAU,oBAAoB,OAAO,CAAC;AAC5D,gBAAU,QAAQ,SAAS,uBAAuB;AAClD,aAAO,QAAQ,SAAS;AACxB,YAAM,aAAa,IAAI,UAAU,qBAAqB,OAAO,EAAa;AAC1E,aAAO,KAAK,UAAU;AAAA,IACxB;AAAA,EACF,CAAC;AACH;;;ACjLO,SAAS,qBACd,IACM;AAEN,KAAG,SAAS,MAAM,YAAY,IAAI,CAChC,QACA,QACW;AACX,UAAM,EAAE,MAAM,SAAS,aAAa,eAAe,IAAI,OAAO,GAAG,EAAE;AAEnE,UAAM,QAAQ,QAAQ;AAAA,MACpB,CAAC,GAAG,MAAM,IAAI,IAAI,EAAE,QAAQ;AAAA,MAC5B;AAAA,IACF;AACA,UAAM,cAAc,QAAQ,MAAM,CAAC,MAAM,EAAE,QAAQ,QAAQ;AAC3D,UAAM,kBAAkB,QAAQ,OAAsB,CAAC,KAAK,MAAM;AAChE,UAAI,EAAE,QAAQ,aAAa,UAAU,QAAQ,OAAQ,QAAO;AAC5D,UAAI,EAAE,QAAQ,aAAa,YAAY,QAAQ,SAAU,QAAO;AAChE,UAAI,EAAE,QAAQ,aAAa,SAAS,QAAQ,MAAO,QAAO;AAC1D,aAAO;AAAA,IACT,GAAG,IAAI;AAEP,UAAM,gBAAgB,cAAc,yBAAyB;AAC7D,UAAM,gBAAgB,oBAAoB,UAAU,oBAAoB,WACpE,wBAAwB,eAAe,KACvC;AACJ,UAAM,gBAAgB,gBAAgB,cAAc;AAEpD,UAAM,OAAO,cAAc,WAAM;AAEjC,QAAI,OAAO,mCAAmC,aAAa;AAG3D,YAAQ,0BAA0B,aAAa,GAAG,aAAa,qBAAqB,IAAI,uDAAuD,WAAW,QAAQ,CAAC,EAAE,QAAQ,EAAE,CAAC,kBAAkB,IAAI,IAAI,KAAK;AAG/M,YAAQ,8CAA8C,IAAI;AAC1D,eAAW,UAAU,SAAS;AAC5B,cAAQ,iBAAiB,QAAQ,WAAW;AAAA,IAC9C;AACA,YAAQ;AAER,YAAQ;AACR,WAAO;AAAA,EACT;AAGA,KAAG,SAAS,MAAM,qBAAqB,IAAI,CACzC,QACA,QACW;AACX,UAAM,QAAQ,OAAO,GAAG;AACxB,UAAM,MAAM,MAAM,QAAQ,OAAO,KAAK;AACtC,UAAM,YAAY,MAAM,QAAQ,sBAAsB,KAAK;AAC3D,UAAM,SAAS,MAAM,MAAM;AAE3B,QAAI,OAAO;AACX,QAAI,QAAQ;AACV,cAAQ;AAAA,IACV;AACA,YAAQ,gBAAgB,WAAW,GAAG,CAAC,2BAA2B,WAAW,SAAS,CAAC;AACvF,WAAO;AAAA,EACT;AAGA,KAAG,SAAS,MAAM,sBAAsB,IAAI,CAC1C,QACA,QACW;AACX,UAAM,QAAQ,OAAO,GAAG;AACxB,UAAM,OAAO,MAAM;AACnB,QAAI,OAAO;AAEX,QAAI,MAAM,QAAQ;AAChB,YAAM,SAAS,KAAK;AACpB,YAAM,cAAc,KAAK;AACzB,cAAQ;AACR,cAAQ,iBAAiB,QAAQ,WAAW;AAC5C,cAAQ;AACR,cAAQ;AAAA,IACV;AAEA,WAAO;AAAA,EACT;AAGA,KAAG,SAAS,MAAM,kBAAkB,IAAI,CACtC,QACA,QACW;AACX,UAAM,MAAM,OAAO,GAAG,EAAE,QAAQ,OAAO,KAAK;AAC5C,WAAO,eAAe,WAAW,GAAG,CAAC;AAAA,EACvC;AAEA,KAAG,SAAS,MAAM,mBAAmB,IAAI,MAAc;AACrD,WAAO;AAAA,EACT;AACF;;;AC7FO,SAAS,iBAAiB,QAAuB;AACtD,SAAO,SAASA,YAAW,IAAgB,UAA6B,CAAC,GAAS;AAChF,UAAM,cAAc,QAAQ,eAAe;AAC3C,UAAM,iBAAiB,QAAQ,kBAAkB;AACjD,UAAM,kBAAkB,QAAQ,mBAAmB;AACnD,UAAM,mBAAmB,QAAQ,oBAAoB;AAErD,UAAM,SAAS,gBAAgB,QAAQ,OAAO;AAC9C,QAAI,CAAC,OAAQ;AAEb,oBAAgB,IAAI,OAAO,SAAS;AAAA,MAClC;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACF,CAAC;AACD,yBAAqB,EAAE;AAAA,EACzB;AACF;;;ACZO,IAAM,aAAa,iBAAiB,CAAC,YAA+B;AACzE,MAAI,QAAQ,UAAU;AACpB,WAAO,QAAQ;AAAA,EACjB;AAEA,MAAI,QAAQ,QAAQ;AAClB,QAAI;AACF,aAAO,QAAQ,OAAO;AAAA,IACxB,QAAQ;AACN,aAAO;AAAA,IACT;AAAA,EACF;AAEA,MAAI,QAAQ,eAAe,QAAQ,cAAc;AAC/C,YAAQ;AAAA,MACN;AAAA,IAEF;AAAA,EACF;AAEA,SAAO;AACT,CAAC;AAED,IAAO,kBAAQ;",
+  "sources": ["../../shared/src/comments.ts", "../src/rules/core.ts", "../src/rules/renderer.ts", "../src/shared.ts", "../src/browser.ts"],
+  "sourcesContent": ["/**\n * Shared comment loading and grouping logic for MRSF rendering plugins.\n */\n\nimport type { MrsfDocument } from \"@mrsf/cli\";\nimport type { MrsfPluginOptions, SlimComment, CommentThread, LineMap, CommentLoader } from \"./types.js\";\n\nexport type { CommentLoader };\n\n/**\n * Convert an MrsfDocument into a slim comment array.\n */\nexport function toSlimComments(doc: MrsfDocument): SlimComment[] {\n  return doc.comments.map((c) => ({\n    id: c.id,\n    author: c.author || \"Unknown\",\n    text: c.text || \"\",\n    line: c.line ?? null,\n    end_line: c.end_line ?? null,\n    start_column: c.start_column ?? null,\n    end_column: c.end_column ?? null,\n    selected_text: c.selected_text || null,\n    resolved: !!c.resolved,\n    reply_to: c.reply_to || null,\n    severity: c.severity || null,\n    type: c.type || null,\n    timestamp: c.timestamp || null,\n  }));\n}\n\n/**\n * Group comments by line number, threading replies under parents.\n */\nexport function groupByLine(comments: SlimComment[]): LineMap {\n  const rootComments = comments.filter((c) => !c.reply_to && c.line != null);\n  const replies = comments.filter((c) => c.reply_to);\n\n  const replyMap = new Map<string, SlimComment[]>();\n  for (const r of replies) {\n    const list = replyMap.get(r.reply_to!) || [];\n    list.push(r);\n    replyMap.set(r.reply_to!, list);\n  }\n\n  const lineMap: LineMap = new Map();\n  for (const c of rootComments) {\n    const line = c.line!;\n    const threads = lineMap.get(line) || [];\n    threads.push({\n      comment: c,\n      replies: replyMap.get(c.id) || [],\n    });\n    lineMap.set(line, threads);\n  }\n\n  return lineMap;\n}\n\n/**\n * Resolve options into a filtered LineMap ready for rendering.\n * Returns null if there are no comments to render.\n */\nexport function resolveComments(\n  loader: CommentLoader,\n  options: MrsfPluginOptions,\n): { lineMap: LineMap; comments: SlimComment[] } | null {\n  const showResolved = options.showResolved ?? true;\n\n  const doc = loader(options);\n  if (!doc || !doc.comments || doc.comments.length === 0) {\n    return null;\n  }\n\n  let comments = toSlimComments(doc);\n  if (!showResolved) {\n    comments = comments.filter((c) => !c.resolved);\n  }\n\n  if (comments.length === 0) return null;\n\n  const lineMap = groupByLine(comments);\n  return { lineMap, comments };\n}\n", "/**\n * MRSF markdown-it plugin \u2014 core rule (overlay gutter architecture).\n *\n * Walks the parsed token stream and annotates block tokens with\n * `data-mrsf-line` attributes. Adds `mrsf-line-highlight` class on\n * commented lines. Appends an `mrsf_data_script` token with serialized\n * comment data for the client-side MrsfController.\n *\n * NO visual tokens are injected \u2014 all badges, tooltips, and gutter\n * elements are created at runtime by the controller.\n */\n\nimport type Token from \"markdown-it/lib/token.mjs\";\nimport type { Nesting } from \"markdown-it/lib/token.mjs\";\nimport type StateCore from \"markdown-it/lib/rules_core/state_core.mjs\";\nimport type { LineMap, CommentThread } from \"../types.js\";\n\nexport interface CoreRuleOptions {\n  /** Whether to add mrsf-line-highlight class on commented tokens. Default: false. */\n  lineHighlight?: boolean;\n}\n\n/**\n * Install the MRSF core rule on a markdown-it instance.\n */\nexport function installCoreRule(\n  md: { core: { ruler: { push: (name: string, fn: (state: StateCore) => void) => void } } },\n  lineMap: LineMap,\n  options: CoreRuleOptions = {},\n): void {\n  md.core.ruler.push(\"mrsf_inject\", (state: StateCore) => {\n    const tokens = state.tokens;\n    const TokenCtor = state.Token;\n    const processed = new Set<number>();\n\n    for (let i = tokens.length - 1; i >= 0; i--) {\n      const token = tokens[i];\n      const map = token.map;\n      if (!map) continue;\n\n      // Skip inline tokens \u2014 process their parent block tokens only.\n      if (token.type === \"inline\") continue;\n\n      // Annotate the element with line range\n      const startLine1 = map[0] + 1;\n      const endLine1 = map[1];\n      token.attrSet(\"data-mrsf-line\", String(startLine1));\n      token.attrSet(\"data-mrsf-start-line\", String(startLine1));\n      token.attrSet(\"data-mrsf-end-line\", String(endLine1));\n\n      // Check each line in this token's range for comments\n      for (let line0 = map[0]; line0 < map[1]; line0++) {\n        const line = line0 + 1; // 1-based\n        if (processed.has(line)) continue;\n        processed.add(line);\n\n        const threads = lineMap.get(line);\n        if (threads && threads.length > 0) {\n          if (options.lineHighlight) {\n            const existingClass = token.attrGet(\"class\") || \"\";\n            if (!existingClass.includes(\"mrsf-line-highlight\")) {\n              token.attrSet(\n                \"class\",\n                existingClass\n                  ? `${existingClass} mrsf-line-highlight`\n                  : \"mrsf-line-highlight\",\n              );\n            }\n          }\n          token.attrSet(\"data-mrsf-line\", String(line));\n        }\n      }\n    }\n\n    // Append a data script token with all comment data\n    const allThreads: CommentThread[] = [];\n    for (const threads of lineMap.values()) {\n      allThreads.push(...threads);\n    }\n    if (allThreads.length > 0) {\n      const scriptToken = new TokenCtor(\"mrsf_data_script\", \"\", 0);\n      scriptToken.meta = { threads: allThreads };\n      tokens.push(scriptToken);\n    }\n  });\n}\n", "/**\n * MRSF markdown-it plugin \u2014 renderer rules (overlay gutter architecture).\n *\n * Adds a single custom renderer rule:\n *   - mrsf_data_script: renders a <script type=\"application/mrsf+json\">\n *     containing serialized comment data for the MrsfController.\n */\n\nimport type { CommentThread } from \"../types.js\";\n\n/**\n * Install MRSF renderer rules on a markdown-it instance.\n */\nexport function installRendererRules(\n  md: { renderer: { rules: Record<string, ((...args: any[]) => string) | undefined> } },\n): void {\n  md.renderer.rules[\"mrsf_data_script\"] = (\n    tokens: { meta: { threads: CommentThread[] } }[],\n    idx: number,\n  ): string => {\n    const { threads } = tokens[idx].meta;\n    // Escape < to prevent script tag injection (XSS safety)\n    const data = JSON.stringify({ threads }).replace(/</g, \"\\\\u003c\");\n    return `<script type=\"application/mrsf+json\">${data}</script>`;\n  };\n}\n", "/**\n * Shared logic for @mrsf/markdown-it-mrsf.\n *\n * Contains the plugin factory using shared comment loading/grouping logic.\n */\n\nimport type MarkdownIt from \"markdown-it\";\nimport type { MrsfPluginOptions, CommentLoader } from \"./types.js\";\nimport { resolveComments } from \"@mrsf/plugin-shared\";\nimport { installCoreRule } from \"./rules/core.js\";\nimport { installRendererRules } from \"./rules/renderer.js\";\n\n/**\n * Create a markdown-it plugin function with the given comment loader.\n *\n * @param loader - Function that resolves sidecar data from plugin options\n * @returns A markdown-it plugin function\n */\nexport function createMrsfPlugin(loader: CommentLoader) {\n  return function mrsfPlugin(md: MarkdownIt, options: MrsfPluginOptions = {}): void {\n    const result = resolveComments(loader, options);\n    if (!result) return;\n\n    installCoreRule(md, result.lineMap, { lineHighlight: options.lineHighlight ?? false });\n    installRendererRules(md);\n  };\n}\n", "/**\n * Browser-safe entry point for @mrsf/markdown-it-mrsf.\n *\n * This entry is automatically selected by bundlers (Vite, webpack, esbuild)\n * via the `\"browser\"` export condition in package.json. It supports the\n * `comments` and `loader` provisioning modes \u2014 no Node.js file-system APIs.\n *\n * You do NOT need to import this directly. Just use:\n *   import { mrsfPlugin } from \"@mrsf/markdown-it-mrsf\";\n *\n * Your bundler will resolve to this file automatically when targeting\n * a browser environment.\n */\n\nimport type { MrsfPluginOptions } from \"./types.js\";\nimport { createMrsfPlugin } from \"./shared.js\";\n\nexport type { MrsfPluginOptions, SlimComment, CommentThread, LineMap, CommentLoader } from \"./types.js\";\n\n/**\n * The markdown-it plugin function (browser-safe).\n *\n * Supports `comments` (inline data) and `loader` (custom function) options.\n */\nexport const mrsfPlugin = createMrsfPlugin((options: MrsfPluginOptions) => {\n  if (options.comments) {\n    return options.comments;\n  }\n\n  if (options.loader) {\n    try {\n      return options.loader();\n    } catch {\n      return null;\n    }\n  }\n\n  if (options.sidecarPath || options.documentPath) {\n    console.warn(\n      \"[@mrsf/markdown-it-mrsf] sidecarPath and documentPath require Node.js. \" +\n      \"Use `comments` or `loader` options in browser environments.\"\n    );\n  }\n\n  return null;\n});\n\nexport default mrsfPlugin;\n"],
+  "mappings": "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",
   "names": ["mrsfPlugin"]
 }

package/dist/controller.d.ts

@@ -1,23 +1,149 @@
 /**
- * Sidemark — Client-side event controller for interactive mode.
+ * Sidemark — MrsfController: overlay gutter architecture.
  *
- * Optional module that listens for clicks on `[data-mrsf-action]` elements
- * and dispatches CustomEvents on the document for host applications.
+ * The controller is the runtime engine for interactive MRSF rendering.
+ * It reads comment data from the DOM (embedded `<script type="application/mrsf+json">`)
+ * or constructor options, creates gutter overlay columns, positions
+ * badges/buttons at the correct vertical offsets, and handles all
+ * user interactions (tooltips, selection, action buttons).
  *
- * Usage (ESM):
- *   import "@mrsf/plugin-shared/controller";
+ * Usage:
+ *   import { MrsfController } from "@mrsf/plugin-shared/controller";
  *
- * Events dispatched:
- *   - mrsf:resolve   { commentId, line }
- *   - mrsf:unresolve { commentId, line }
- *   - mrsf:reply     { commentId, line }
- *   - mrsf:edit      { commentId, line }
- *   - mrsf:navigate  { commentId, line }
+ *   const ctrl = new MrsfController(document.querySelector(".my-content")!, {
+ *     interactive: true,
+ *     gutterPosition: "left",
+ *   });
+ *   // ctrl.destroy() to clean up
+ *
+ * Events dispatched on document:
+ *   - mrsf:resolve   { commentId, line, ... }
+ *   - mrsf:unresolve { commentId, line, ... }
+ *   - mrsf:reply     { commentId, line, ... }
+ *   - mrsf:edit      { commentId, line, ... }
+ *   - mrsf:delete    { commentId, line, ... }
+ *   - mrsf:navigate  { commentId, line, ... }
+ *   - mrsf:add       { commentId: null, line, selectionText?, ... }
+ *   - mrsf:submit    { action, commentId, text?, line?, ... }
  */
-export type MrsfAction = "resolve" | "unresolve" | "reply" | "edit" | "navigate";
+import type { CommentThread } from "./types.js";
+export type MrsfAction = "resolve" | "unresolve" | "reply" | "edit" | "delete" | "navigate" | "add";
 export interface MrsfActionDetail {
-    commentId: string;
+    commentId: string | null;
     line: number | null;
     action: MrsfAction;
+    selectionText?: string | null;
+    start_line?: number | null;
+    end_line?: number | null;
+    start_column?: number | null;
+    end_column?: number | null;
+}
+export interface MrsfSubmitDetail {
+    action: "add" | "edit" | "reply" | "resolve" | "unresolve" | "delete";
+    commentId: string | null;
+    text: string;
+    type?: string | null;
+    severity?: "low" | "medium" | "high" | null;
+    line?: number | null;
+    end_line?: number | null;
+    start_column?: number | null;
+    end_column?: number | null;
+    selection_text?: string | null;
+}
+export interface MrsfControllerOptions {
+    /** Show gutter on left or right side. Default: "right". */
+    gutterPosition?: "left" | "right";
+    /** Enable interactive actions (add, resolve, reply, etc.). Default: false. */
+    interactive?: boolean;
+    /** Comment data passed directly (overrides embedded script). */
+    comments?: CommentThread[];
+    /**
+     * Render inline text highlights for comments that have `selected_text`.
+     * Wraps matching text in `<mark>` elements with hover tooltips.
+     * Default: true.
+     */
+    inlineHighlights?: boolean;
+}
+export declare class MrsfController {
+    private container;
+    private opts;
+    private threads;
+    private gutterLeft;
+    private gutterRight;
+    private activeTooltip;
+    private floatingAddButton;
+    private overlayEl;
+    private lastSelectionText;
+    private resizeObserver;
+    private styleInjected;
+    private inlineMarks;
+    private inlineTooltipEl;
+    private orphanedSection;
+    private handleResizeBound;
+    private handleClickBound;
+    private handleSelectionBound;
+    constructor(container: HTMLElement, options?: MrsfControllerOptions);
+    /** Remove all controller DOM and listeners. */
+    destroy(): void;
+    private loadCommentData;
+    private buildThreadMap;
+    private setupOverlayStructure;
+    private createGutter;
+    /** Build badge/add-button elements for each line in the gutter(s). */
+    private renderGutterItems;
+    private primaryGutter;
+    /** Collect all unique line numbers from data-mrsf-line elements, expanding multi-line ranges. */
+    private collectLines;
+    private createBadgeItem;
+    private createAddItem;
+    private createAddButton;
+    /** Measure [data-mrsf-line] elements and set gutter item Y offsets. */
+    positionGutterItems(): void;
+    /**
+     * Find the element whose start-line/end-line range contains the given line.
+     * Used for positioning gutter items on expanded multi-line elements.
+     */
+    private findElementForLine;
+    /**
+     * Render orphaned comments (whose line doesn't match any DOM element)
+     * in a dedicated section at the bottom of the container.
+     */
+    private renderOrphanedSection;
+    /**
+     * For comments with `selected_text`, find the matching text in the DOM
+     * and wrap it in a `<mark class="mrsf-inline-highlight">` element with
+     * hover/click behaviour to show the comment tooltip.
+     */
+    private renderInlineHighlights;
+    /**
+     * Strip common inline markdown syntax so `selected_text` from source
+     * can be matched against rendered text content.
+     */
+    private static stripInlineMarkdown;
+    /**
+     * Walk text nodes inside `root` to find `text`, then wrap the matching
+     * range in a `<mark>` element. Falls back to markdown-stripped matching.
+     */
+    private wrapSelectedText;
+    private showInlineTooltip;
+    private hideInlineTimeout;
+    private scheduleHideInlineTooltip;
+    private cancelHideInlineTooltip;
+    private hideInlineTooltip;
+    /** Remove all inline marks, unwrapping their contents back to text. */
+    private removeInlineHighlights;
+    private toggleTooltip;
+    private showTooltip;
+    private hideTooltip;
+    private handleClick;
+    private handleSelectionChange;
+    private ensureFloatingAddButton;
+    private hideFloatingAddButton;
+    private showFloatingAddButton;
+    private injectStyles;
+    private closeOverlay;
+    private openForm;
+    private openConfirm;
 }
+export declare function autoInit(): void;
 //# sourceMappingURL=controller.d.ts.map