@mrsf/marp-mrsf 0.4.8

package/dist/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/index.ts", "../../shared/src/comments.ts", "../src/rules/core.ts", "../src/rules/renderer.ts", "../src/shared.ts"],
+  "sourcesContent": ["import { readFileSync } from \"node:fs\";\nimport path from \"node:path\";\nimport { parseSidecarContent } from \"@mrsf/cli\";\nimport type { MrsfPluginOptions } from \"./types.js\";\nimport { createMarpPlugin } from \"./shared.js\";\nimport type { MrsfMarpPlugin } from \"./shared.js\";\n\nexport type { MrsfPluginOptions, SlimComment, CommentThread, LineMap, CommentLoader } from \"./types.js\";\nexport type { MrsfMarpPlugin, MarpitLike, MarpitPluginContext } from \"./shared.js\";\n\nexport const mrsfPlugin: MrsfMarpPlugin = createMarpPlugin((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) {\n    try {\n      const abs = path.resolve(options.cwd || process.cwd(), options.sidecarPath);\n      const content = readFileSync(abs, \"utf-8\");\n      return parseSidecarContent(content, abs);\n    } catch {\n      return null;\n    }\n  }\n\n  if (options.documentPath) {\n    try {\n      const cwd = options.cwd || process.cwd();\n      const abs = path.resolve(cwd, options.documentPath);\n      const yamlPath = abs + \".review.yaml\";\n      const jsonPath = abs + \".review.json\";\n\n      let raw: string | null = null;\n      let hint: string | null = null;\n\n      try {\n        raw = readFileSync(yamlPath, \"utf-8\");\n        hint = yamlPath;\n      } catch {\n        try {\n          raw = readFileSync(jsonPath, \"utf-8\");\n          hint = jsonPath;\n        } catch {\n          return null;\n        }\n      }\n\n      if (!raw) {\n        return null;\n      }\n\n      return parseSidecarContent(raw, hint!);\n    } catch {\n      return null;\n    }\n  }\n\n  return null;\n});\n\nexport default mrsfPlugin;", "/**\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    x_page: typeof c.x_page === \"number\" ? c.x_page : 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", "import type Token from \"markdown-it/lib/token.mjs\";\nimport type StateCore from \"markdown-it/lib/rules_core/state_core.mjs\";\nimport type { LineMap, CommentThread, SlimComment } from \"../types.js\";\n\nexport interface CoreRuleOptions {\n  lineHighlight?: boolean;\n}\n\nexport interface ResolvedCommentData {\n  lineMap: LineMap;\n  comments: SlimComment[];\n}\n\nfunction buildPageLineMap(tokens: Token[]): Map<number, number> {\n  const pageLineMap = new Map<number, number>();\n  let pageNumber = 0;\n\n  for (const token of tokens) {\n    if (token.type !== \"marpit_slide_open\" || !token.map) {\n      continue;\n    }\n\n    pageNumber += 1;\n    pageLineMap.set(pageNumber, token.map[0] + 1);\n  }\n\n  return pageLineMap;\n}\n\nfunction mergePageScopedThreads(\n  lineMap: LineMap,\n  comments: SlimComment[],\n  pageLineMap: Map<number, number>,\n): LineMap {\n  const merged: LineMap = new Map(\n    Array.from(lineMap.entries(), ([line, threads]) => [\n      line,\n      threads.map((thread) => ({\n        comment: thread.comment,\n        replies: [...thread.replies],\n      })),\n    ]),\n  );\n  const replyMap = new Map<string, SlimComment[]>();\n\n  for (const comment of comments) {\n    if (!comment.reply_to) {\n      continue;\n    }\n\n    const replies = replyMap.get(comment.reply_to) || [];\n    replies.push(comment);\n    replyMap.set(comment.reply_to, replies);\n  }\n\n  for (const comment of comments) {\n    if (comment.reply_to || comment.line != null || comment.x_page == null) {\n      continue;\n    }\n\n    const displayLine = pageLineMap.get(comment.x_page);\n    if (displayLine == null) {\n      continue;\n    }\n\n    const threadComment: SlimComment = {\n      ...comment,\n      line: displayLine,\n    };\n    const threadReplies = (replyMap.get(comment.id) || []).map((reply) => ({\n      ...reply,\n      line: reply.line ?? displayLine,\n    }));\n    const threads = merged.get(displayLine) || [];\n\n    threads.push({\n      comment: threadComment,\n      replies: threadReplies,\n    });\n    merged.set(displayLine, threads);\n  }\n\n  return merged;\n}\n\nexport function installCoreRule(\n  md: { core: { ruler: { push: (name: string, fn: (state: StateCore) => void) => void } } },\n  resolveComments: (state: StateCore) => ResolvedCommentData | null,\n  options: CoreRuleOptions = {},\n): void {\n  md.core.ruler.push(\"mrsf_inject\", (state: StateCore) => {\n    const result = resolveComments(state);\n    if (!result) return;\n\n  const pageLineMap = buildPageLineMap(state.tokens);\n  const lineMap = mergePageScopedThreads(result.lineMap, result.comments, pageLineMap);\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      if (token.type === \"inline\") continue;\n\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      for (let line0 = map[0]; line0 < map[1]; line0++) {\n        const line = line0 + 1;\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 ? `${existingClass} mrsf-line-highlight` : \"mrsf-line-highlight\",\n              );\n            }\n          }\n          token.attrSet(\"data-mrsf-line\", String(line));\n        }\n      }\n    }\n\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}", "import type { CommentThread } from \"../types.js\";\n\nexport interface RendererRuleOptions {\n  dataContainer?: \"script\" | \"element\";\n  dataElementId?: string;\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\nexport function installRendererRules(\n  md: { renderer: { rules: Record<string, ((...args: any[]) => string) | undefined> } },\n  options: RendererRuleOptions = {},\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    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    const data = payload.replace(/</g, \"\\\\u003c\");\n    return `<script type=\"application/mrsf+json\">${data}</script>`;\n  };\n}", "import type MarkdownIt from \"markdown-it\";\nimport { resolveComments } from \"@mrsf/plugin-shared\";\nimport type { CommentLoader, MrsfPluginOptions } from \"./types.js\";\nimport { installCoreRule } from \"./rules/core.js\";\nimport { installRendererRules } from \"./rules/renderer.js\";\n\nexport interface MarpitRenderResult {\n  html: string | string[];\n  css: string;\n  comments?: string[][];\n}\n\nexport interface MarpitLike {\n  render(markdown: string, env?: Record<string, unknown>): MarpitRenderResult;\n  use(plugin: (context: unknown, ...params: unknown[]) => unknown, ...params: unknown[]): unknown;\n  markdown?: MarkdownIt;\n}\n\nexport interface MarpitPluginContext {\n  marpit?: MarpitLike;\n  markdown?: MarkdownIt;\n}\n\nexport type MrsfMarpPlugin = (\n  context: MarpitPluginContext,\n  options?: MrsfPluginOptions,\n) => void;\n\nconst patchedRenderers = new WeakSet<MarpitLike>();\n\nexport function installMarkdownMrsfPlugin(\n  md: MarkdownIt,\n  options: MrsfPluginOptions,\n  loader: CommentLoader,\n): void {\n  installCoreRule(\n    md,\n    (state) => resolveComments(loader, options, state.env),\n    { lineHighlight: options.lineHighlight ?? false },\n  );\n  installRendererRules(md, {\n    dataContainer: options.dataContainer,\n    dataElementId: options.dataElementId,\n  });\n}\n\nexport function createMarpPlugin(loader: CommentLoader): MrsfMarpPlugin {\n  return function mrsfPlugin(\n    context: MarpitPluginContext,\n    options: MrsfPluginOptions = {},\n  ): void {\n    const markdown = context.markdown ?? context.marpit?.markdown;\n    if (markdown) {\n      installMarkdownMrsfPlugin(markdown, options, loader);\n    }\n\n    if (!context.marpit) {\n      return;\n    }\n\n    patchRender(context.marpit, options);\n  };\n}\n\nfunction patchRender(marpit: MarpitLike, options: MrsfPluginOptions): void {\n  if (patchedRenderers.has(marpit)) {\n    return;\n  }\n\n  const originalRender = marpit.render.bind(marpit);\n  marpit.render = (markdown: string, env?: Record<string, unknown>): MarpitRenderResult => {\n    const result = originalRender(markdown, env);\n    const fallbackHtml = Array.isArray(result.html)\n      ? originalRender(markdown, { ...(env ?? {}), htmlAsArray: false }).html\n      : null;\n\n    return {\n      ...result,\n      html: normalizeRenderedHtml(result.html, options, typeof fallbackHtml === \"string\" ? fallbackHtml : null),\n    };\n  };\n\n  patchedRenderers.add(marpit);\n}\n\nconst SCRIPT_RE = /<script type=\"application\\/mrsf\\+json\">[\\s\\S]*?<\\/script>/g;\n\nfunction normalizeRenderedHtml(\n  html: string | string[],\n  options: MrsfPluginOptions,\n  fallbackHtml: string | null = null,\n): string | string[] {\n  if (Array.isArray(html)) {\n    let payload: string | null = null;\n\n    const pages = html.map((pageHtml, index) => {\n      const extracted = extractPayloads(pageHtml);\n      if (extracted.payloads.length > 0) {\n        payload = extracted.payloads[extracted.payloads.length - 1];\n      }\n\n      return annotatePageFragment(extracted.html, index + 1, options);\n    });\n\n    if (!payload && fallbackHtml) {\n      const fallback = extractPayloads(fallbackHtml);\n      payload = fallback.payloads[fallback.payloads.length - 1] ?? null;\n    }\n\n    if (payload && pages.length > 0) {\n      pages[pages.length - 1] += payload;\n    }\n\n    return pages;\n  }\n\n  const extracted = extractPayloads(html);\n  const annotated = annotateSectionTags(extracted.html, options);\n\n  if (extracted.payloads.length === 0) {\n    return annotated;\n  }\n\n  const payload = extracted.payloads[extracted.payloads.length - 1];\n  return insertPayloadIntoContainer(annotated, payload);\n}\n\nfunction extractPayloads(html: string): { html: string; payloads: string[] } {\n  const payloads = html.match(SCRIPT_RE) ?? [];\n  return {\n    html: html.replace(SCRIPT_RE, \"\"),\n    payloads,\n  };\n}\n\nfunction annotatePageFragment(\n  html: string,\n  pageNumber: number,\n  options: MrsfPluginOptions,\n): string {\n  const attrName = resolvePageAttributeName(options);\n  return html.replace(/<([a-zA-Z][\\w:-]*)(\\s|>)/, `<$1 ${attrName}=\"${pageNumber}\"$2`);\n}\n\nfunction annotateSectionTags(html: string, options: MrsfPluginOptions): string {\n  if (html.includes(\"<svg\") && html.includes(\"data-marpit-svg\")) {\n    return annotateSvgPageTags(html, options);\n  }\n\n  const attrName = resolvePageAttributeName(options);\n  let pageNumber = 0;\n\n  return html.replace(/<section(\\s|>)/g, (_match, suffix: string) => {\n    pageNumber += 1;\n    return `<section ${attrName}=\"${pageNumber}\"${suffix}`;\n  });\n}\n\nfunction annotateSvgPageTags(html: string, options: MrsfPluginOptions): string {\n  const attrName = resolvePageAttributeName(options);\n  let pageNumber = 0;\n\n  return html.replace(/<svg\\b([^>]*)>/g, (_match, attrs: string) => {\n    if (!attrs.includes(\"data-marpit-svg\")) {\n      return `<svg${attrs}>`;\n    }\n\n    pageNumber += 1;\n    return `<svg${attrs} ${attrName}=\"${pageNumber}\">`;\n  });\n}\n\nfunction resolvePageAttributeName(_options: MrsfPluginOptions): string {\n  return \"data-mrsf-page\";\n}\n\nfunction insertPayloadIntoContainer(html: string, payload: string): string {\n  const closingTagIndex = html.lastIndexOf(\"</\");\n  if (closingTagIndex === -1) {\n    return html + payload;\n  }\n\n  return html.slice(0, closingTagIndex) + payload + html.slice(closingTagIndex);\n}"],
+  "mappings": "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",
+  "names": ["resolveComments", "mrsfPlugin", "payload", "extracted"]
+}

package/dist/rules/core.d.ts

@@ -0,0 +1,17 @@
+import type StateCore from "markdown-it/lib/rules_core/state_core.mjs";
+import type { LineMap, SlimComment } from "../types.js";
+export interface CoreRuleOptions {
+    lineHighlight?: boolean;
+}
+export interface ResolvedCommentData {
+    lineMap: LineMap;
+    comments: SlimComment[];
+}
+export declare function installCoreRule(md: {
+    core: {
+        ruler: {
+            push: (name: string, fn: (state: StateCore) => void) => void;
+        };
+    };
+}, resolveComments: (state: StateCore) => ResolvedCommentData | null, options?: CoreRuleOptions): void;
+//# sourceMappingURL=core.d.ts.map

package/dist/rules/renderer.d.ts

@@ -0,0 +1,10 @@
+export interface RendererRuleOptions {
+    dataContainer?: "script" | "element";
+    dataElementId?: string;
+}
+export declare function installRendererRules(md: {
+    renderer: {
+        rules: Record<string, ((...args: any[]) => string) | undefined>;
+    };
+}, options?: RendererRuleOptions): void;
+//# sourceMappingURL=renderer.d.ts.map

package/dist/shared.d.ts

@@ -0,0 +1,20 @@
+import type MarkdownIt from "markdown-it";
+import type { CommentLoader, MrsfPluginOptions } from "./types.js";
+export interface MarpitRenderResult {
+    html: string | string[];
+    css: string;
+    comments?: string[][];
+}
+export interface MarpitLike {
+    render(markdown: string, env?: Record<string, unknown>): MarpitRenderResult;
+    use(plugin: (context: unknown, ...params: unknown[]) => unknown, ...params: unknown[]): unknown;
+    markdown?: MarkdownIt;
+}
+export interface MarpitPluginContext {
+    marpit?: MarpitLike;
+    markdown?: MarkdownIt;
+}
+export type MrsfMarpPlugin = (context: MarpitPluginContext, options?: MrsfPluginOptions) => void;
+export declare function installMarkdownMrsfPlugin(md: MarkdownIt, options: MrsfPluginOptions, loader: CommentLoader): void;
+export declare function createMarpPlugin(loader: CommentLoader): MrsfMarpPlugin;
+//# sourceMappingURL=shared.d.ts.map

package/dist/style.css

@@ -0,0 +1,522 @@
+/*
+ * Sidemark — MRSF plugin default styles (overlay gutter architecture).
+ *
+ * Include via: import "@mrsf/plugin-shared/style.css"
+ * or <link rel="stylesheet" href=".../@mrsf/plugin-shared/dist/style.css">
+ *
+ * Customise with CSS custom properties (--mrsf-*).
+ *
+ * Layout:  The controller wraps the rendered markdown in an overlay root
+ * with position:relative, and creates absolute-positioned gutter columns
+ * on the left and/or right.  The plugins only add data-mrsf-line
+ * attributes — no visual DOM injection.
+ */
+
+/* ── Custom property defaults ────────────────────────────── */
+
+:root {
+  --mrsf-accent: #3794ff;
+  --mrsf-badge-bg: #007acc;
+  --mrsf-badge-fg: #fff;
+  --mrsf-badge-resolved-bg: #388a34;
+  --mrsf-add-bg: rgba(0, 122, 204, 0.12);
+  --mrsf-add-fg: #007acc;
+  --mrsf-add-border: rgba(0, 122, 204, 0.28);
+  --mrsf-tooltip-bg: #252526;
+  --mrsf-tooltip-fg: #cccccc;
+  --mrsf-tooltip-border: #454545;
+  --mrsf-highlight-bg: rgba(255, 213, 79, 0.25);
+  --mrsf-highlight-border: rgba(255, 213, 79, 0.7);
+  --mrsf-severity-high: #e74c3c;
+  --mrsf-severity-medium: #f39c12;
+  --mrsf-severity-low: #3498db;
+  --mrsf-gutter-width: 36px;
+  --mrsf-font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif;
+}
+
+@media (prefers-color-scheme: light) {
+  :root {
+    --mrsf-tooltip-bg: #f3f3f3;
+    --mrsf-tooltip-fg: #333333;
+    --mrsf-tooltip-border: #cccccc;
+  }
+}
+
+/* ── Overlay root (created by controller) ────────────────── */
+
+.mrsf-overlay-root {
+  position: relative;
+}
+
+.mrsf-gutter {
+  position: absolute;
+  top: 0;
+  bottom: 0;
+  width: var(--mrsf-gutter-width);
+  pointer-events: none;
+  z-index: 10;
+}
+
+.mrsf-gutter.is-hidden,
+.mrsf-line-highlight-layer.is-hidden {
+  display: none;
+}
+
+.mrsf-gutter-left {
+  left: calc(-1 * var(--mrsf-gutter-width) - 8px);
+}
+
+.mrsf-gutter-right {
+  right: calc(-1 * var(--mrsf-gutter-width) - 8px);
+}
+
+.mrsf-line-highlight-layer {
+  position: absolute;
+  inset: 0;
+  pointer-events: none;
+  z-index: 1;
+}
+
+.mrsf-line-highlight-overlay {
+  position: absolute;
+  left: 0;
+  right: 0;
+  border-left: 3px solid var(--mrsf-accent);
+  background: rgba(55, 148, 255, 0.06);
+  border-radius: 2px;
+  transition: background 0.15s ease;
+}
+
+.mrsf-line-highlight-overlay:hover {
+  background: rgba(55, 148, 255, 0.12);
+}
+
+/* ── Line highlight (CSS-only tinting for commented lines) ── */
+
+.mrsf-line-highlight {
+  border-left: 3px solid var(--mrsf-accent);
+  padding-left: 8px;
+  background: rgba(55, 148, 255, 0.06);
+  border-radius: 2px;
+  transition: background 0.15s ease;
+}
+
+.mrsf-line-highlight:hover {
+  background: rgba(55, 148, 255, 0.12);
+}
+
+/* ── Gutter items (badges & add buttons, positioned by JS) ── */
+
+.mrsf-gutter-item {
+  position: absolute;
+  left: 0;
+  right: 0;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  pointer-events: auto;
+}
+
+/* ── Badge ──────────────────────────────────────────────── */
+
+.mrsf-badge,
+.mrsf-gutter-add {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  gap: 2px;
+  font-size: 11px;
+  font-weight: 600;
+  line-height: 1;
+  min-height: 20px;
+  padding: 3px 8px;
+  border-radius: 999px;
+  user-select: none;
+  white-space: nowrap;
+  transition: opacity 0.15s ease, background 0.15s ease, border-color 0.15s ease;
+}
+
+.mrsf-badge {
+  cursor: pointer;
+  color: var(--mrsf-badge-fg);
+  background: var(--mrsf-badge-bg);
+  border: 1px solid transparent;
+  border-left: 3px solid transparent;
+}
+
+.mrsf-badge-resolved {
+  background: var(--mrsf-badge-resolved-bg);
+  opacity: 0.7;
+}
+
+.mrsf-badge-severity-high {
+  border-left-color: var(--mrsf-severity-high);
+}
+
+.mrsf-badge-severity-medium {
+  border-left-color: var(--mrsf-severity-medium);
+}
+
+/* ── Add button (in gutter) ─────────────────────────────── */
+
+.mrsf-gutter-add {
+  appearance: none;
+  opacity: 0.38;
+  pointer-events: auto;
+  border: 1px solid var(--mrsf-add-border);
+  background: var(--mrsf-add-bg);
+  color: var(--mrsf-add-fg);
+  cursor: pointer;
+  font-family: var(--mrsf-font-family);
+}
+
+@media (prefers-color-scheme: light) {
+  :root {
+    --mrsf-add-bg: rgba(0, 122, 204, 0.08);
+    --mrsf-add-border: rgba(0, 122, 204, 0.18);
+  }
+}
+
+.mrsf-gutter-add:hover,
+.mrsf-gutter-add:focus-visible {
+  opacity: 1;
+  background: rgba(0, 122, 204, 0.18);
+  border-color: rgba(0, 122, 204, 0.38);
+}
+
+.mrsf-gutter-add:focus-visible,
+.mrsf-badge:focus-visible {
+  outline: 2px solid var(--mrsf-accent);
+  outline-offset: 2px;
+}
+
+/* ── Tooltip (positioned by JS, appended to gutter item) ── */
+
+.mrsf-tooltip {
+  display: none;
+  position: absolute;
+  top: 100%;
+  z-index: 1000;
+  min-width: 300px;
+  max-width: 480px;
+  max-height: 400px;
+  overflow-y: auto;
+  padding: 8px;
+  margin-top: 4px;
+  border-radius: 6px;
+
+  background: var(--mrsf-tooltip-bg);
+  border: 1px solid var(--mrsf-tooltip-border);
+  box-shadow: 0 4px 16px rgba(0, 0, 0, 0.3);
+
+  font-family: var(--mrsf-font-family);
+  font-size: 13px;
+  line-height: 1.5;
+  color: var(--mrsf-tooltip-fg);
+}
+
+/* Left gutter: tooltip opens to the right */
+.mrsf-gutter-left .mrsf-tooltip {
+  left: 0;
+  right: auto;
+}
+
+/* Right gutter: tooltip opens to the left */
+.mrsf-gutter-right .mrsf-tooltip {
+  left: auto;
+  right: 0;
+}
+
+.mrsf-tooltip.mrsf-tooltip-visible {
+  display: block;
+  animation: mrsf-fade-in 0.15s ease;
+}
+
+@keyframes mrsf-fade-in {
+  from { opacity: 0; transform: translateY(-4px); }
+  to   { opacity: 1; transform: translateY(0); }
+}
+
+/* ── Thread / Comment ───────────────────────────────────── */
+
+.mrsf-thread {
+  padding: 4px 0;
+}
+
+.mrsf-thread + .mrsf-thread {
+  border-top: 1px solid var(--mrsf-tooltip-border);
+  margin-top: 4px;
+  padding-top: 8px;
+}
+
+.mrsf-comment {
+  padding: 4px 0;
+}
+
+.mrsf-comment.mrsf-resolved {
+  border-left: 2px solid var(--mrsf-badge-resolved-bg);
+  padding-left: 6px;
+}
+
+/* ── Replies ────────────────────────────────────────────── */
+
+.mrsf-replies {
+  margin-left: 16px;
+  padding-left: 8px;
+  border-left: 2px solid var(--mrsf-tooltip-border);
+}
+
+.mrsf-reply {
+  font-size: 12px;
+}
+
+/* ── Comment header ─────────────────────────────────────── */
+
+.mrsf-comment-header {
+  display: flex;
+  align-items: center;
+  gap: 6px;
+  flex-wrap: wrap;
+  margin-bottom: 2px;
+}
+
+.mrsf-author {
+  font-weight: 600;
+}
+
+.mrsf-date {
+  font-size: 11px;
+  opacity: 0.6;
+}
+
+.mrsf-severity {
+  font-size: 10px;
+  font-weight: 600;
+  padding: 1px 5px;
+  border-radius: 8px;
+  text-transform: uppercase;
+  letter-spacing: 0.3px;
+}
+
+.mrsf-severity-high {
+  background: rgba(231, 76, 60, 0.2);
+  color: var(--mrsf-severity-high);
+}
+
+.mrsf-severity-medium {
+  background: rgba(243, 156, 18, 0.2);
+  color: var(--mrsf-severity-medium);
+}
+
+.mrsf-severity-low {
+  background: rgba(52, 152, 219, 0.2);
+  color: var(--mrsf-severity-low);
+}
+
+.mrsf-type {
+  font-size: 10px;
+  padding: 1px 5px;
+  border-radius: 8px;
+  background: rgba(127, 127, 127, 0.15);
+  opacity: 0.8;
+}
+
+.mrsf-resolved-badge {
+  font-size: 10px;
+  color: var(--mrsf-badge-resolved-bg);
+  font-weight: 600;
+}
+
+/* ── Comment body ───────────────────────────────────────── */
+
+.mrsf-comment-body {
+  white-space: pre-wrap;
+  word-break: break-word;
+}
+
+/* ── Selected text quote in tooltip ─────────────────────── */
+
+.mrsf-selected-text {
+  font-family: monospace;
+  font-size: 0.85em;
+  background: rgba(127, 127, 127, 0.1);
+  border-left: 3px solid rgba(127, 127, 127, 0.3);
+  margin: 4px 0;
+  border-radius: 2px;
+}
+
+.mrsf-selected-text-summary {
+  padding: 4px 8px;
+  cursor: pointer;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+  display: block;
+  list-style: none;
+  color: var(--mrsf-fg, inherit);
+  opacity: 0.7;
+}
+
+.mrsf-selected-text-summary::-webkit-details-marker {
+  display: none;
+}
+
+.mrsf-selected-text-summary::before {
+  content: "▶ ";
+  font-size: 0.7em;
+  vertical-align: middle;
+  margin-right: 2px;
+}
+
+.mrsf-selected-text[open] > .mrsf-selected-text-summary {
+  display: none;
+}
+
+.mrsf-selected-text-full {
+  display: block;
+  padding: 4px 8px;
+  white-space: pre-wrap;
+  word-break: break-word;
+}
+
+/* ── Inline text highlight (overlay positioned by JS) ───── */
+
+.mrsf-highlight-overlay {
+  position: absolute;
+  background: var(--mrsf-highlight-bg);
+  border-bottom: 2px solid var(--mrsf-highlight-border);
+  border-radius: 2px;
+  pointer-events: none;
+  transition: background 0.15s ease;
+}
+
+/* ── Inline comment text highlight (<mark> by controller) ── */
+
+.mrsf-inline-highlight {
+  background: var(--mrsf-highlight-bg);
+  border-bottom: 2px solid var(--mrsf-highlight-border);
+  border-radius: 2px;
+  cursor: pointer;
+  transition: background 0.15s ease;
+}
+
+.mrsf-inline-highlight:hover {
+  background: rgba(255, 213, 79, 0.4);
+}
+
+/* Inline tooltip (appended to document.body, positioned by JS) */
+.mrsf-inline-tooltip {
+  position: fixed;
+  z-index: 1100;
+  min-width: 300px;
+  max-width: 480px;
+  max-height: 400px;
+  overflow-y: auto;
+  padding: 8px;
+  border-radius: 6px;
+  background: var(--mrsf-tooltip-bg);
+  border: 1px solid var(--mrsf-tooltip-border);
+  box-shadow: 0 4px 16px rgba(0, 0, 0, 0.3);
+  font-family: var(--mrsf-font-family);
+  font-size: 13px;
+  line-height: 1.5;
+  color: var(--mrsf-tooltip-fg);
+  white-space: normal;
+  animation: mrsf-fade-in 0.15s ease;
+}
+
+/* ── Interactive action buttons ─────────────────────────── */
+
+.mrsf-actions {
+  display: none;
+  gap: 4px;
+  margin-top: 4px;
+  padding-top: 4px;
+  border-top: 1px solid var(--mrsf-tooltip-border);
+}
+
+.mrsf-interactive .mrsf-actions {
+  display: flex;
+}
+
+.mrsf-tooltip-actions {
+  display: flex;
+  justify-content: flex-end;
+  gap: 6px;
+  margin-top: 8px;
+  padding-top: 6px;
+  border-top: 1px solid var(--mrsf-tooltip-border);
+}
+
+.mrsf-action-btn {
+  font-size: 11px;
+  padding: 2px 8px;
+  border-radius: 4px;
+  border: 1px solid var(--mrsf-tooltip-border);
+  background: transparent;
+  color: var(--mrsf-tooltip-fg);
+  cursor: pointer;
+  font-family: var(--mrsf-font-family);
+  transition: background 0.15s ease;
+}
+
+.mrsf-action-btn.mrsf-action-danger {
+  color: #d13438;
+  border-color: rgba(209, 52, 56, 0.7);
+}
+
+.mrsf-action-btn:hover {
+  background: rgba(127, 127, 127, 0.2);
+}
+
+/* ── Floating "Add comment" button (selection-based) ────── */
+
+/* ── Orphaned comments section (bottom of container) ────── */
+
+.mrsf-orphaned-section {
+  margin-top: 24px;
+  padding-top: 16px;
+  border-top: 2px dashed var(--mrsf-tooltip-border);
+}
+
+.mrsf-orphaned-heading {
+  font-family: var(--mrsf-font-family);
+  font-size: 12px;
+  font-weight: 600;
+  text-transform: uppercase;
+  letter-spacing: 0.5px;
+  color: #999;
+  margin-bottom: 8px;
+}
+
+.mrsf-orphaned-thread {
+  padding: 8px;
+  margin-bottom: 6px;
+  border-radius: 6px;
+  border: 1px solid var(--mrsf-tooltip-border);
+  background: rgba(127, 127, 127, 0.06);
+  opacity: 0.7;
+  font-family: var(--mrsf-font-family);
+  font-size: 13px;
+  line-height: 1.5;
+  color: var(--mrsf-tooltip-fg);
+}
+
+.mrsf-add-inline-button {
+  position: absolute;
+  z-index: 1200;
+  display: none;
+  font-size: 12px;
+  padding: 6px 10px;
+  border-radius: 6px;
+  border: 1px solid var(--mrsf-tooltip-border);
+  background: var(--mrsf-tooltip-bg);
+  color: var(--mrsf-tooltip-fg);
+  box-shadow: 0 4px 12px rgba(0, 0, 0, 0.25);
+  cursor: pointer;
+  font-family: var(--mrsf-font-family);
+}
+
+.mrsf-add-inline-button:hover {
+  background: rgba(127, 127, 127, 0.2);
+}