@mrsf/marked-mrsf 0.4.7

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Wictor Wilén
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,44 @@
+# @mrsf/marked-mrsf
+
+A [Marked](https://github.com/markedjs/marked) plugin for rendering [MRSF (Sidemark)](https://github.com/wictorwilen/MRSF) review comments into HTML output.
+
+Like the other MRSF rendering plugins, it annotates rendered block elements with `data-mrsf-*` line metadata and appends a serialized comment payload for the shared client-side controller.
+
+## Install
+
+```bash
+npm install marked @mrsf/marked-mrsf
+```
+
+## Usage
+
+```ts
+import { Marked } from "marked";
+import { markedMrsf } from "@mrsf/marked-mrsf";
+
+const parser = new Marked();
+parser.use(markedMrsf({
+  documentPath: "docs/guide.md",
+}));
+
+const html = parser.parse(markdownSource);
+```
+
+For browser usage, pass `comments` or `loader` instead of `documentPath` / `sidecarPath`.
+
+## Stylesheet and Controller
+
+```ts
+import "@mrsf/marked-mrsf/style.css";
+import { refreshAll } from "@mrsf/marked-mrsf/controller";
+```
+
+The shared controller wires up gutter buttons, selection actions, and built-in dialogs, then dispatches `mrsf:*` events for your host app to persist.
+
+## Options
+
+The plugin accepts the same `MrsfPluginOptions` surface as the markdown-it and rehype packages: `comments`, `loader`, `documentPath`, `sidecarPath`, `showResolved`, `dataContainer`, `dataElementId`, `interactive`, `gutterPosition`, `gutterForInline`, `inlineHighlights`, `lineHighlight`, `theme`, and `cwd`.
+
+## License
+
+[MIT](../LICENSE)

package/dist/browser.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Browser-safe entry point for @mrsf/marked-mrsf.
+ */
+import type { MrsfPluginOptions } from "./types.js";
+export type { MrsfPluginOptions, SlimComment, CommentThread, LineMap, CommentLoader } from "./types.js";
+export declare const markedMrsf: (options?: MrsfPluginOptions) => import("marked").MarkedExtension;
+export default markedMrsf;
+//# sourceMappingURL=browser.d.ts.map

package/dist/browser.js

@@ -0,0 +1,272 @@
+// src/shared.ts
+import { Marked } from "marked";
+
+// ../shared/dist/comments.js
+function toSlimComments(doc) {
+  return doc.comments.map((c) => ({
+    id: c.id,
+    author: c.author || "Unknown",
+    text: c.text || "",
+    line: c.line ?? null,
+    end_line: c.end_line ?? null,
+    start_column: c.start_column ?? null,
+    end_column: c.end_column ?? null,
+    selected_text: c.selected_text || null,
+    resolved: !!c.resolved,
+    reply_to: c.reply_to || null,
+    severity: c.severity || null,
+    type: c.type || null,
+    timestamp: c.timestamp || null
+  }));
+}
+function groupByLine(comments) {
+  const rootComments = comments.filter((c) => !c.reply_to && c.line != null);
+  const replies = comments.filter((c) => c.reply_to);
+  const replyMap = /* @__PURE__ */ new Map();
+  for (const r of replies) {
+    const list = replyMap.get(r.reply_to) || [];
+    list.push(r);
+    replyMap.set(r.reply_to, list);
+  }
+  const lineMap = /* @__PURE__ */ new Map();
+  for (const c of rootComments) {
+    const line = c.line;
+    const threads = lineMap.get(line) || [];
+    threads.push({
+      comment: c,
+      replies: replyMap.get(c.id) || []
+    });
+    lineMap.set(line, threads);
+  }
+  return lineMap;
+}
+function resolveComments(loader, options, env) {
+  const showResolved = options.showResolved ?? true;
+  const doc = loader(options, env);
+  if (!doc || !doc.comments || doc.comments.length === 0) {
+    return null;
+  }
+  let comments = toSlimComments(doc);
+  if (!showResolved) {
+    comments = comments.filter((c) => !c.resolved);
+  }
+  if (comments.length === 0)
+    return null;
+  const lineMap = groupByLine(comments);
+  return { lineMap, comments };
+}
+
+// src/shared.ts
+var markedRuntime = new Marked();
+var BaseRenderer = markedRuntime.Renderer;
+var blockquoteRenderer = BaseRenderer.prototype.blockquote;
+var codeRenderer = BaseRenderer.prototype.code;
+var headingRenderer = BaseRenderer.prototype.heading;
+var hrRenderer = BaseRenderer.prototype.hr;
+var listItemRenderer = BaseRenderer.prototype.listitem;
+var paragraphRenderer = BaseRenderer.prototype.paragraph;
+var tableRenderer = BaseRenderer.prototype.table;
+function countLines(value) {
+  if (!value) return 1;
+  return value.split("\n").length;
+}
+function trimTrailingBlankLines(value) {
+  return value.replace(/\n+$/g, "");
+}
+function firstCommentLine(lineMap, startLine, endLine) {
+  for (let line = startLine; line <= endLine; line++) {
+    const threads = lineMap.get(line);
+    if (threads && threads.length > 0) {
+      return line;
+    }
+  }
+  return startLine;
+}
+function hasCommentInRange(lineMap, startLine, endLine) {
+  for (let line = startLine; line <= endLine; line++) {
+    const threads = lineMap.get(line);
+    if (threads && threads.length > 0) {
+      return true;
+    }
+  }
+  return false;
+}
+function stampBlock(token, startLine, lineMap) {
+  const raw = typeof token.raw === "string" ? token.raw : "";
+  const semantic = trimTrailingBlankLines(raw);
+  const endLine = startLine + countLines(semantic) - 1;
+  token.mrsfStartLine = startLine;
+  token.mrsfEndLine = endLine;
+  token.mrsfLine = firstCommentLine(lineMap, startLine, endLine);
+  token.mrsfLineHighlight = hasCommentInRange(lineMap, startLine, endLine);
+  if (token.type === "table") {
+    const tableToken = token;
+    tableToken.mrsfHeaderLine = startLine;
+    tableToken.mrsfRowLines = tableToken.rows.map((_, index) => startLine + 2 + index);
+  }
+  return startLine + countLines(raw) - 1;
+}
+function stampListItems(token, lineMap) {
+  let currentLine = token.mrsfStartLine ?? 1;
+  for (const item of token.items) {
+    const raw = typeof item.raw === "string" ? item.raw : "";
+    const semantic = trimTrailingBlankLines(raw);
+    const endLine = currentLine + countLines(semantic) - 1;
+    item.mrsfStartLine = currentLine;
+    item.mrsfEndLine = endLine;
+    item.mrsfLine = firstCommentLine(lineMap, currentLine, endLine);
+    item.mrsfLineHighlight = hasCommentInRange(lineMap, currentLine, endLine);
+    stampTokens(item.tokens, currentLine, lineMap);
+    currentLine += countLines(raw) - 1;
+  }
+}
+function stampTokens(tokens, startLine, lineMap) {
+  let currentLine = startLine;
+  for (const token of tokens) {
+    currentLine = stampBlock(token, currentLine, lineMap);
+    if (token.type === "blockquote") {
+      stampTokens(token.tokens, token.mrsfStartLine ?? currentLine, lineMap);
+    } else if (token.type === "list") {
+      stampListItems(token, lineMap);
+    }
+  }
+  return currentLine;
+}
+function escapeAttribute(value) {
+  return value.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
+}
+function buildAttrs(token, lineHighlight) {
+  if (token.mrsfStartLine == null || token.mrsfEndLine == null || token.mrsfLine == null) {
+    return "";
+  }
+  const attrs = [
+    `data-mrsf-line="${token.mrsfLine}"`,
+    `data-mrsf-start-line="${token.mrsfStartLine}"`,
+    `data-mrsf-end-line="${token.mrsfEndLine}"`
+  ];
+  if (lineHighlight && token.mrsfLineHighlight) {
+    attrs.push('class="mrsf-line-highlight"');
+  }
+  return attrs.length > 0 ? " " + attrs.join(" ") : "";
+}
+function addAttrs(html, attrs, tagName) {
+  if (!attrs) return html;
+  const pattern = tagName ? new RegExp(`^<${tagName}(?=[\\s>])`, "i") : /^<([a-z0-9-]+)(?=[\s>])/i;
+  return html.replace(pattern, (match) => match + attrs);
+}
+function flattenThreads(lineMap) {
+  const threads = [];
+  for (const lineThreads of lineMap.values()) {
+    threads.push(...lineThreads);
+  }
+  return threads;
+}
+function createDataContainer(options, threads) {
+  const payload = JSON.stringify({ threads });
+  if (options.dataContainer === "element") {
+    const elementId = options.dataElementId || "mrsf-comment-data";
+    return `<div id="${escapeAttribute(elementId)}" data-mrsf-json="${escapeAttribute(payload)}" aria-hidden="true"></div>`;
+  }
+  return `<script type="application/mrsf+json">${payload.replace(/</g, "\\u003c")}</script>`;
+}
+function renderAnnotatedTable(token, lineMap, lineHighlight) {
+  const baseHtml = tableRenderer.call(this, token);
+  const rowLines = [token.mrsfHeaderLine, ...token.mrsfRowLines ?? []];
+  let rowIndex = 0;
+  return baseHtml.replace(/<tr>/g, () => {
+    const line = rowLines[rowIndex++];
+    if (line == null) return "<tr>";
+    const hasComment = hasCommentInRange(lineMap, line, line);
+    const attrs = [
+      `data-mrsf-line="${line}"`,
+      `data-mrsf-start-line="${line}"`,
+      `data-mrsf-end-line="${line}"`
+    ];
+    if (lineHighlight && hasComment) {
+      attrs.push('class="mrsf-line-highlight"');
+    }
+    return `<tr ${attrs.join(" ")}>`;
+  });
+}
+function createMarkedMrsf(loader) {
+  return function markedMrsf2(options = {}) {
+    let currentLineMap = null;
+    let currentThreads = [];
+    return {
+      hooks: {
+        processAllTokens(tokens) {
+          const result = resolveComments(loader, options);
+          if (!result) {
+            currentLineMap = null;
+            currentThreads = [];
+            return tokens;
+          }
+          currentLineMap = result.lineMap;
+          currentThreads = flattenThreads(result.lineMap);
+          stampTokens(tokens, 1, result.lineMap);
+          return tokens;
+        },
+        postprocess(html) {
+          if (!currentLineMap || currentThreads.length === 0) {
+            return html;
+          }
+          return html + createDataContainer(options, currentThreads);
+        }
+      },
+      renderer: {
+        heading(token) {
+          return addAttrs(headingRenderer.call(this, token), buildAttrs(token, options.lineHighlight ?? false), `h${token.depth}`);
+        },
+        paragraph(token) {
+          return addAttrs(paragraphRenderer.call(this, token), buildAttrs(token, options.lineHighlight ?? false), "p");
+        },
+        code(token) {
+          return addAttrs(codeRenderer.call(this, token), buildAttrs(token, options.lineHighlight ?? false), "pre");
+        },
+        blockquote(token) {
+          return addAttrs(blockquoteRenderer.call(this, token), buildAttrs(token, options.lineHighlight ?? false), "blockquote");
+        },
+        listitem(token) {
+          return addAttrs(listItemRenderer.call(this, token), buildAttrs(token, options.lineHighlight ?? false), "li");
+        },
+        hr(token) {
+          return addAttrs(hrRenderer.call(this, token), buildAttrs(token, options.lineHighlight ?? false), "hr");
+        },
+        table(token) {
+          return renderAnnotatedTable.call(
+            this,
+            token,
+            currentLineMap ?? /* @__PURE__ */ new Map(),
+            options.lineHighlight ?? false
+          );
+        }
+      }
+    };
+  };
+}
+
+// src/browser.ts
+var markedMrsf = createMarkedMrsf((options, env) => {
+  if (options.comments) {
+    return options.comments;
+  }
+  if (options.loader) {
+    try {
+      return options.loader(options, env);
+    } catch {
+      return null;
+    }
+  }
+  if (options.sidecarPath || options.documentPath) {
+    console.warn(
+      "[@mrsf/marked-mrsf] sidecarPath and documentPath require Node.js. Use `comments` or `loader` options in browser environments."
+    );
+  }
+  return null;
+});
+var browser_default = markedMrsf;
+export {
+  browser_default as default,
+  markedMrsf
+};
+//# sourceMappingURL=browser.js.map

package/dist/browser.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/shared.ts", "../../shared/src/comments.ts", "../src/browser.ts"],
+  "sourcesContent": ["/**\n * Shared logic for @mrsf/marked-mrsf.\n */\n\nimport { Marked, type MarkedExtension, type Token, type Tokens } from \"marked\";\nimport { resolveComments } from \"@mrsf/plugin-shared\";\nimport type { CommentLoader, CommentThread, LineMap, MrsfPluginOptions } from \"./types.js\";\n\ntype TokenWithMrsf = Token & {\n  mrsfStartLine?: number;\n  mrsfEndLine?: number;\n  mrsfLine?: number;\n  mrsfLineHighlight?: boolean;\n  mrsfHeaderLine?: number;\n  mrsfRowLines?: number[];\n};\n\ntype ListItemWithMrsf = Tokens.ListItem & {\n  mrsfStartLine?: number;\n  mrsfEndLine?: number;\n  mrsfLine?: number;\n  mrsfLineHighlight?: boolean;\n};\n\nconst markedRuntime = new Marked();\nconst BaseRenderer = markedRuntime.Renderer;\n\nconst blockquoteRenderer = BaseRenderer.prototype.blockquote;\nconst codeRenderer = BaseRenderer.prototype.code;\nconst headingRenderer = BaseRenderer.prototype.heading;\nconst hrRenderer = BaseRenderer.prototype.hr;\nconst listItemRenderer = BaseRenderer.prototype.listitem;\nconst paragraphRenderer = BaseRenderer.prototype.paragraph;\nconst tableRenderer = BaseRenderer.prototype.table;\n\nfunction countLines(value: string): number {\n  if (!value) return 1;\n  return value.split(\"\\n\").length;\n}\n\nfunction trimTrailingBlankLines(value: string): string {\n  return value.replace(/\\n+$/g, \"\");\n}\n\nfunction firstCommentLine(lineMap: LineMap, startLine: number, endLine: number): number {\n  for (let line = startLine; line <= endLine; line++) {\n    const threads = lineMap.get(line);\n    if (threads && threads.length > 0) {\n      return line;\n    }\n  }\n  return startLine;\n}\n\nfunction hasCommentInRange(lineMap: LineMap, startLine: number, endLine: number): boolean {\n  for (let line = startLine; line <= endLine; line++) {\n    const threads = lineMap.get(line);\n    if (threads && threads.length > 0) {\n      return true;\n    }\n  }\n  return false;\n}\n\nfunction stampBlock(token: TokenWithMrsf, startLine: number, lineMap: LineMap): number {\n  const raw = typeof token.raw === \"string\" ? token.raw : \"\";\n  const semantic = trimTrailingBlankLines(raw);\n  const endLine = startLine + countLines(semantic) - 1;\n\n  token.mrsfStartLine = startLine;\n  token.mrsfEndLine = endLine;\n  token.mrsfLine = firstCommentLine(lineMap, startLine, endLine);\n  token.mrsfLineHighlight = hasCommentInRange(lineMap, startLine, endLine);\n\n  if (token.type === \"table\") {\n    const tableToken = token as Tokens.Table & TokenWithMrsf;\n    tableToken.mrsfHeaderLine = startLine;\n    tableToken.mrsfRowLines = tableToken.rows.map((_, index) => startLine + 2 + index);\n  }\n\n  return startLine + countLines(raw) - 1;\n}\n\nfunction stampListItems(token: Tokens.List & TokenWithMrsf, lineMap: LineMap): void {\n  let currentLine = token.mrsfStartLine ?? 1;\n\n  for (const item of token.items as ListItemWithMrsf[]) {\n    const raw = typeof item.raw === \"string\" ? item.raw : \"\";\n    const semantic = trimTrailingBlankLines(raw);\n    const endLine = currentLine + countLines(semantic) - 1;\n    item.mrsfStartLine = currentLine;\n    item.mrsfEndLine = endLine;\n    item.mrsfLine = firstCommentLine(lineMap, currentLine, endLine);\n    item.mrsfLineHighlight = hasCommentInRange(lineMap, currentLine, endLine);\n\n    stampTokens(item.tokens as TokenWithMrsf[], currentLine, lineMap);\n    currentLine += countLines(raw) - 1;\n  }\n}\n\nfunction stampTokens(tokens: TokenWithMrsf[], startLine: number, lineMap: LineMap): number {\n  let currentLine = startLine;\n\n  for (const token of tokens) {\n    currentLine = stampBlock(token, currentLine, lineMap);\n\n    if (token.type === \"blockquote\") {\n      stampTokens((token as Tokens.Blockquote).tokens as TokenWithMrsf[], token.mrsfStartLine ?? currentLine, lineMap);\n    } else if (token.type === \"list\") {\n      stampListItems(token as Tokens.List & TokenWithMrsf, lineMap);\n    }\n  }\n\n  return currentLine;\n}\n\nfunction escapeAttribute(value: string): string {\n  return value\n    .replace(/&/g, \"&amp;\")\n    .replace(/</g, \"&lt;\")\n    .replace(/>/g, \"&gt;\")\n    .replace(/\"/g, \"&quot;\");\n}\n\nfunction buildAttrs(token: { mrsfStartLine?: number; mrsfEndLine?: number; mrsfLine?: number; mrsfLineHighlight?: boolean }, lineHighlight: boolean): string {\n  if (token.mrsfStartLine == null || token.mrsfEndLine == null || token.mrsfLine == null) {\n    return \"\";\n  }\n\n  const attrs = [\n    `data-mrsf-line=\"${token.mrsfLine}\"`,\n    `data-mrsf-start-line=\"${token.mrsfStartLine}\"`,\n    `data-mrsf-end-line=\"${token.mrsfEndLine}\"`,\n  ];\n\n  if (lineHighlight && token.mrsfLineHighlight) {\n    attrs.push('class=\"mrsf-line-highlight\"');\n  }\n\n  return attrs.length > 0 ? \" \" + attrs.join(\" \") : \"\";\n}\n\nfunction addAttrs(html: string, attrs: string, tagName?: string): string {\n  if (!attrs) return html;\n  const pattern = tagName\n    ? new RegExp(`^<${tagName}(?=[\\\\s>])`, \"i\")\n    : /^<([a-z0-9-]+)(?=[\\s>])/i;\n  return html.replace(pattern, (match) => match + attrs);\n}\n\nfunction flattenThreads(lineMap: LineMap): CommentThread[] {\n  const threads: CommentThread[] = [];\n  for (const lineThreads of lineMap.values()) {\n    threads.push(...lineThreads);\n  }\n  return threads;\n}\n\nfunction createDataContainer(options: MrsfPluginOptions, threads: CommentThread[]): string {\n  const payload = JSON.stringify({ threads });\n  if (options.dataContainer === \"element\") {\n    const elementId = options.dataElementId || \"mrsf-comment-data\";\n    return `<div id=\"${escapeAttribute(elementId)}\" data-mrsf-json=\"${escapeAttribute(payload)}\" aria-hidden=\"true\"></div>`;\n  }\n\n  return `<script type=\"application/mrsf+json\">${payload.replace(/</g, \"\\\\u003c\")}</script>`;\n}\n\nfunction renderAnnotatedTable(\n  this: { parser: { parseInline: (tokens: Token[]) => string } },\n  token: Tokens.Table & TokenWithMrsf,\n  lineMap: LineMap,\n  lineHighlight: boolean,\n): string {\n  const baseHtml = tableRenderer.call(this, token);\n  const rowLines = [token.mrsfHeaderLine, ...(token.mrsfRowLines ?? [])];\n  let rowIndex = 0;\n\n  return baseHtml.replace(/<tr>/g, () => {\n    const line = rowLines[rowIndex++];\n    if (line == null) return \"<tr>\";\n\n    const hasComment = hasCommentInRange(lineMap, line, line);\n\n    const attrs = [\n      `data-mrsf-line=\"${line}\"`,\n      `data-mrsf-start-line=\"${line}\"`,\n      `data-mrsf-end-line=\"${line}\"`,\n    ];\n    if (lineHighlight && hasComment) {\n      attrs.push('class=\"mrsf-line-highlight\"');\n    }\n    return `<tr ${attrs.join(\" \")}>`;\n  });\n}\n\nexport function createMarkedMrsf(loader: CommentLoader) {\n  return function markedMrsf(options: MrsfPluginOptions = {}): MarkedExtension {\n    let currentLineMap: LineMap | null = null;\n    let currentThreads: CommentThread[] = [];\n\n    return {\n      hooks: {\n        processAllTokens(tokens) {\n          const result = resolveComments(loader, options);\n          if (!result) {\n            currentLineMap = null;\n            currentThreads = [];\n            return tokens;\n          }\n\n          currentLineMap = result.lineMap;\n          currentThreads = flattenThreads(result.lineMap);\n          stampTokens(tokens as TokenWithMrsf[], 1, result.lineMap);\n          return tokens;\n        },\n        postprocess(html) {\n          if (!currentLineMap || currentThreads.length === 0) {\n            return html;\n          }\n          return html + createDataContainer(options, currentThreads);\n        },\n      },\n      renderer: {\n        heading(token) {\n          return addAttrs(headingRenderer.call(this, token), buildAttrs(token as TokenWithMrsf, options.lineHighlight ?? false), `h${token.depth}`);\n        },\n        paragraph(token) {\n          return addAttrs(paragraphRenderer.call(this, token), buildAttrs(token as TokenWithMrsf, options.lineHighlight ?? false), \"p\");\n        },\n        code(token) {\n          return addAttrs(codeRenderer.call(this, token), buildAttrs(token as TokenWithMrsf, options.lineHighlight ?? false), \"pre\");\n        },\n        blockquote(token) {\n          return addAttrs(blockquoteRenderer.call(this, token), buildAttrs(token as TokenWithMrsf, options.lineHighlight ?? false), \"blockquote\");\n        },\n        listitem(token) {\n          return addAttrs(listItemRenderer.call(this, token), buildAttrs(token as ListItemWithMrsf, options.lineHighlight ?? false), \"li\");\n        },\n        hr(token) {\n          return addAttrs(hrRenderer.call(this, token), buildAttrs(token as TokenWithMrsf, options.lineHighlight ?? false), \"hr\");\n        },\n        table(token) {\n          return renderAnnotatedTable.call(\n            this,\n            token as Tokens.Table & TokenWithMrsf,\n            currentLineMap ?? new Map(),\n            options.lineHighlight ?? false,\n          );\n        },\n      },\n    };\n  };\n}", "/**\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  env?: unknown,\n): { lineMap: LineMap; comments: SlimComment[] } | null {\n  const showResolved = options.showResolved ?? true;\n\n  const doc = loader(options, env);\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 * Browser-safe entry point for @mrsf/marked-mrsf.\n */\n\nimport type { MrsfPluginOptions } from \"./types.js\";\nimport { createMarkedMrsf } from \"./shared.js\";\n\nexport type { MrsfPluginOptions, SlimComment, CommentThread, LineMap, CommentLoader } from \"./types.js\";\n\nexport const markedMrsf = createMarkedMrsf((options: MrsfPluginOptions, env?: unknown) => {\n  if (options.comments) {\n    return options.comments;\n  }\n\n  if (options.loader) {\n    try {\n      return options.loader(options, env);\n    } catch {\n      return null;\n    }\n  }\n\n  if (options.sidecarPath || options.documentPath) {\n    console.warn(\n      \"[@mrsf/marked-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 markedMrsf;"],
+  "mappings": "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",
+  "names": ["markedMrsf"]
+}

package/dist/controller.d.ts

@@ -0,0 +1,169 @@
+/**
+ * Sidemark — MrsfController: overlay gutter architecture.
+ *
+ * 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:
+ *   import { MrsfController } from "@mrsf/plugin-shared/controller";
+ *
+ *   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?, ... }
+ */
+import type { CommentThread } from "./types.js";
+export type MrsfAction = "resolve" | "unresolve" | "reply" | "edit" | "delete" | "navigate" | "add";
+export interface MrsfActionDetail {
+    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 mutationObserver;
+    private styleInjected;
+    private inlineMarks;
+    private inlineTooltipEl;
+    private orphanedSection;
+    private refreshQueued;
+    private handleResizeBound;
+    private handleMutationBound;
+    private handleClickBound;
+    private handleSelectionBound;
+    constructor(container: HTMLElement, options?: MrsfControllerOptions);
+    /** Remove all controller DOM and listeners. */
+    destroy(): void;
+    /** Recalculate gutter positions after async layout changes such as Mermaid renders. */
+    refresh(): void;
+    private loadCommentData;
+    private buildThreadMap;
+    private findCommentById;
+    private orderThreadsForDisplay;
+    private setupOverlayStructure;
+    private createGutter;
+    /** Build badge/add-button elements for each line in the gutter(s). */
+    private renderGutterItems;
+    private primaryGutter;
+    private shouldExpandRange;
+    private addVisibleLinesForElement;
+    /** 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;
+    private suppressAddItemsThatShareBadgeTargets;
+    private handleMutations;
+    private isExternalContentMutation;
+    private isControllerOwnedNode;
+    private queueRefresh;
+    private findDirectElementForLine;
+    private calculateItemTop;
+    /**
+     * 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 applyThemeVariables;
+    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 selectionBelongsToContainer;
+    private findSelectionAnchor;
+    private ensureFloatingAddButton;
+    private hideFloatingAddButton;
+    private showFloatingAddButton;
+    private injectStyles;
+    private closeOverlay;
+    private openForm;
+    private openConfirm;
+}
+export declare function refreshAll(): void;
+export declare function autoInit(): void;
+//# sourceMappingURL=controller.d.ts.map