@mrsf/markdown-it-mrsf 0.4.5 → 0.4.6

package/dist/browser.js

@@ -37,9 +37,9 @@ function groupByLine(comments) {
   }
   return lineMap;
 }
-function resolveComments(loader, options) {
+function resolveComments(loader, options, env) {
   const showResolved = options.showResolved ?? true;
-  const doc = loader(options);
+  const doc = loader(options, env);
   if (!doc || !doc.comments || doc.comments.length === 0) {
     return null;
   }
@@ -54,8 +54,11 @@ function resolveComments(loader, options) {
 }
 
 // src/rules/core.ts
-function installCoreRule(md, lineMap, options = {}) {
+function installCoreRule(md, resolveComments2, options = {}) {
   md.core.ruler.push("mrsf_inject", (state) => {
+    const result = resolveComments2(state);
+    if (!result) return;
+    const { lineMap } = result;
     const tokens = state.tokens;
     const TokenCtor = state.Token;
     const processed = /* @__PURE__ */ new Set();
@@ -101,10 +104,18 @@ function installCoreRule(md, lineMap, options = {}) {
 }
 
 // src/rules/renderer.ts
-function installRendererRules(md) {
+function escapeAttribute(value) {
+  return value.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
+}
+function installRendererRules(md, options = {}) {
   md.renderer.rules["mrsf_data_script"] = (tokens, idx) => {
     const { threads } = tokens[idx].meta;
-    const data = JSON.stringify({ threads }).replace(/</g, "\\u003c");
+    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>`;
+    }
+    const data = payload.replace(/</g, "\\u003c");
     return `<script type="application/mrsf+json">${data}</script>`;
   };
 }
@@ -112,21 +123,26 @@ function installRendererRules(md) {
 // src/shared.ts
 function createMrsfPlugin(loader) {
   return function mrsfPlugin2(md, options = {}) {
-    const result = resolveComments(loader, options);
-    if (!result) return;
-    installCoreRule(md, result.lineMap, { lineHighlight: options.lineHighlight ?? false });
-    installRendererRules(md);
+    installCoreRule(
+      md,
+      (state) => resolveComments(loader, options, state.env),
+      { lineHighlight: options.lineHighlight ?? false }
+    );
+    installRendererRules(md, {
+      dataContainer: options.dataContainer,
+      dataElementId: options.dataElementId
+    });
   };
 }
 
 // src/browser.ts
-var mrsfPlugin = createMrsfPlugin((options) => {
+var mrsfPlugin = createMrsfPlugin((options, env) => {
   if (options.comments) {
     return options.comments;
   }
   if (options.loader) {
     try {
-      return options.loader();
+      return options.loader(options, env);
     } catch {
       return null;
     }

package/dist/browser.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "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"]
+  "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  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 * 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, SlimComment } 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\nexport interface ResolvedCommentData {\n  lineMap: LineMap;\n  comments: SlimComment[];\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  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 { lineMap } = result;\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\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\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  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    // Escape < to prevent script tag injection (XSS safety)\n    const data = payload.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    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}\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, 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/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": ["resolveComments", "mrsfPlugin"]
 }

package/dist/index.js

@@ -42,9 +42,9 @@ function groupByLine(comments) {
   }
   return lineMap;
 }
-function resolveComments(loader, options) {
+function resolveComments(loader, options, env) {
   const showResolved = options.showResolved ?? true;
-  const doc = loader(options);
+  const doc = loader(options, env);
   if (!doc || !doc.comments || doc.comments.length === 0) {
     return null;
   }
@@ -59,8 +59,11 @@ function resolveComments(loader, options) {
 }
 
 // src/rules/core.ts
-function installCoreRule(md, lineMap, options = {}) {
+function installCoreRule(md, resolveComments2, options = {}) {
   md.core.ruler.push("mrsf_inject", (state) => {
+    const result = resolveComments2(state);
+    if (!result) return;
+    const { lineMap } = result;
     const tokens = state.tokens;
     const TokenCtor = state.Token;
     const processed = /* @__PURE__ */ new Set();
@@ -106,10 +109,18 @@ function installCoreRule(md, lineMap, options = {}) {
 }
 
 // src/rules/renderer.ts
-function installRendererRules(md) {
+function escapeAttribute(value) {
+  return value.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
+}
+function installRendererRules(md, options = {}) {
   md.renderer.rules["mrsf_data_script"] = (tokens, idx) => {
     const { threads } = tokens[idx].meta;
-    const data = JSON.stringify({ threads }).replace(/</g, "\\u003c");
+    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>`;
+    }
+    const data = payload.replace(/</g, "\\u003c");
     return `<script type="application/mrsf+json">${data}</script>`;
   };
 }
@@ -117,21 +128,26 @@ function installRendererRules(md) {
 // src/shared.ts
 function createMrsfPlugin(loader) {
   return function mrsfPlugin2(md, options = {}) {
-    const result = resolveComments(loader, options);
-    if (!result) return;
-    installCoreRule(md, result.lineMap, { lineHighlight: options.lineHighlight ?? false });
-    installRendererRules(md);
+    installCoreRule(
+      md,
+      (state) => resolveComments(loader, options, state.env),
+      { lineHighlight: options.lineHighlight ?? false }
+    );
+    installRendererRules(md, {
+      dataContainer: options.dataContainer,
+      dataElementId: options.dataElementId
+    });
   };
 }
 
 // src/index.ts
-var mrsfPlugin = createMrsfPlugin((options) => {
+var mrsfPlugin = createMrsfPlugin((options, env) => {
   if (options.comments) {
     return options.comments;
   }
   if (options.loader) {
     try {
-      return options.loader();
+      return options.loader(options, env);
     } catch {
       return null;
     }

package/dist/index.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/index.ts", "../../shared/src/comments.ts", "../src/rules/core.ts", "../src/rules/renderer.ts", "../src/shared.ts"],
-  "sourcesContent": ["/**\n * @mrsf/markdown-it-mrsf \u2014 markdown-it plugin for MRSF review comments.\n *\n * This is the full-featured Node.js entry point. It supports all four\n * sidecar provisioning modes: `comments`, `loader`, `sidecarPath`, and\n * `documentPath`. The latter two require Node.js file-system APIs.\n *\n * In browser / bundler environments, the `\"browser\"` export condition in\n * package.json automatically resolves to the browser-safe entry, so you\n * never need to import a different path \u2014 just use:\n *\n * @example\n * ```ts\n * import MarkdownIt from \"markdown-it\";\n * import { mrsfPlugin } from \"@mrsf/markdown-it-mrsf\";\n *\n * const md = new MarkdownIt();\n * md.use(mrsfPlugin, { documentPath: \"docs/guide.md\" });\n * const html = md.render(markdownSource);\n * ```\n */\n\nimport { readFileSync } from \"node:fs\";\nimport path from \"node:path\";\nimport { parseSidecarContent } from \"@mrsf/cli\";\nimport type { MrsfPluginOptions } from \"./types.js\";\nimport { createMrsfPlugin } from \"./shared.js\";\n\n// Re-export types for consumers\nexport type { MrsfPluginOptions, SlimComment, CommentThread, LineMap, CommentLoader } from \"./types.js\";\n\n/**\n * The markdown-it plugin function (Node.js \u2014 full feature set).\n */\nexport const mrsfPlugin = createMrsfPlugin((options: MrsfPluginOptions) => {\n  // Priority 1: inline data\n  if (options.comments) {\n    return options.comments;\n  }\n\n  // Priority 2: custom loader function\n  if (options.loader) {\n    try {\n      return options.loader();\n    } catch {\n      return null;\n    }\n  }\n\n  // Priority 3: explicit sidecar path\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  // Priority 4: auto-discover from documentPath\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      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) return null;\n      return parseSidecarContent(raw, hint!);\n    } catch {\n      return null;\n    }\n  }\n\n  return null;\n});\n\nexport default mrsfPlugin;\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): { 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"],
-  "mappings": "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",
-  "names": ["mrsfPlugin"]
+  "sourcesContent": ["/**\n * @mrsf/markdown-it-mrsf \u2014 markdown-it plugin for MRSF review comments.\n *\n * This is the full-featured Node.js entry point. It supports all four\n * sidecar provisioning modes: `comments`, `loader`, `sidecarPath`, and\n * `documentPath`. The latter two require Node.js file-system APIs.\n *\n * In browser / bundler environments, the `\"browser\"` export condition in\n * package.json automatically resolves to the browser-safe entry, so you\n * never need to import a different path \u2014 just use:\n *\n * @example\n * ```ts\n * import MarkdownIt from \"markdown-it\";\n * import { mrsfPlugin } from \"@mrsf/markdown-it-mrsf\";\n *\n * const md = new MarkdownIt();\n * md.use(mrsfPlugin, { documentPath: \"docs/guide.md\" });\n * const html = md.render(markdownSource);\n * ```\n */\n\nimport { readFileSync } from \"node:fs\";\nimport path from \"node:path\";\nimport { parseSidecarContent } from \"@mrsf/cli\";\nimport type { MrsfPluginOptions } from \"./types.js\";\nimport { createMrsfPlugin } from \"./shared.js\";\n\n// Re-export types for consumers\nexport type { MrsfPluginOptions, SlimComment, CommentThread, LineMap, CommentLoader } from \"./types.js\";\n\n/**\n * The markdown-it plugin function (Node.js \u2014 full feature set).\n */\nexport const mrsfPlugin = createMrsfPlugin((options: MrsfPluginOptions, env?: unknown) => {\n  // Priority 1: inline data\n  if (options.comments) {\n    return options.comments;\n  }\n\n  // Priority 2: custom loader function\n  if (options.loader) {\n    try {\n      return options.loader(options, env);\n    } catch {\n      return null;\n    }\n  }\n\n  // Priority 3: explicit sidecar path\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  // Priority 4: auto-discover from documentPath\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      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) return null;\n      return parseSidecarContent(raw, hint!);\n    } catch {\n      return null;\n    }\n  }\n\n  return null;\n});\n\nexport default mrsfPlugin;\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 * 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, SlimComment } 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\nexport interface ResolvedCommentData {\n  lineMap: LineMap;\n  comments: SlimComment[];\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  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 { lineMap } = result;\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\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\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  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    // Escape < to prevent script tag injection (XSS safety)\n    const data = payload.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    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}\n"],
+  "mappings": ";AAsBA,SAAS,oBAAoB;AAC7B,OAAO,UAAU;AACjB,SAAS,2BAA2B;;;ACZ9B,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,SACA,KAAa;AAEb,QAAM,eAAe,QAAQ,gBAAgB;AAE7C,QAAM,MAAM,OAAO,SAAS,GAAG;AAC/B,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;;;ACrDO,SAAS,gBACd,IACAA,kBACA,UAA2B,CAAC,GACtB;AACN,KAAG,KAAK,MAAM,KAAK,eAAe,CAAC,UAAqB;AACtD,UAAM,SAASA,iBAAgB,KAAK;AACpC,QAAI,CAAC,OAAQ;AAEb,UAAM,EAAE,QAAQ,IAAI;AACpB,UAAM,SAAS,MAAM;AACrB,UAAM,YAAY,MAAM;AACxB,UAAM,YAAY,oBAAI,IAAY;AAElC,aAAS,IAAI,OAAO,SAAS,GAAG,KAAK,GAAG,KAAK;AAC3C,YAAM,QAAQ,OAAO,CAAC;AACtB,YAAM,MAAM,MAAM;AAClB,UAAI,CAAC,IAAK;AAGV,UAAI,MAAM,SAAS,SAAU;AAG7B,YAAM,aAAa,IAAI,CAAC,IAAI;AAC5B,YAAM,WAAW,IAAI,CAAC;AACtB,YAAM,QAAQ,kBAAkB,OAAO,UAAU,CAAC;AAClD,YAAM,QAAQ,wBAAwB,OAAO,UAAU,CAAC;AACxD,YAAM,QAAQ,sBAAsB,OAAO,QAAQ,CAAC;AAGpD,eAAS,QAAQ,IAAI,CAAC,GAAG,QAAQ,IAAI,CAAC,GAAG,SAAS;AAChD,cAAM,OAAO,QAAQ;AACrB,YAAI,UAAU,IAAI,IAAI,EAAG;AACzB,kBAAU,IAAI,IAAI;AAElB,cAAM,UAAU,QAAQ,IAAI,IAAI;AAChC,YAAI,WAAW,QAAQ,SAAS,GAAG;AACjC,cAAI,QAAQ,eAAe;AACzB,kBAAM,gBAAgB,MAAM,QAAQ,OAAO,KAAK;AAChD,gBAAI,CAAC,cAAc,SAAS,qBAAqB,GAAG;AAClD,oBAAM;AAAA,gBACJ;AAAA,gBACA,gBACI,GAAG,aAAa,yBAChB;AAAA,cACN;AAAA,YACF;AAAA,UACF;AACA,gBAAM,QAAQ,kBAAkB,OAAO,IAAI,CAAC;AAAA,QAC9C;AAAA,MACF;AAAA,IACF;AAGA,UAAM,aAA8B,CAAC;AACrC,eAAW,WAAW,QAAQ,OAAO,GAAG;AACtC,iBAAW,KAAK,GAAG,OAAO;AAAA,IAC5B;AACA,QAAI,WAAW,SAAS,GAAG;AACzB,YAAM,cAAc,IAAI,UAAU,oBAAoB,IAAI,CAAC;AAC3D,kBAAY,OAAO,EAAE,SAAS,WAAW;AACzC,aAAO,KAAK,WAAW;AAAA,IACzB;AAAA,EACF,CAAC;AACH;;;AC/EA,SAAS,gBAAgB,OAAuB;AAC9C,SAAO,MACJ,QAAQ,MAAM,OAAO,EACrB,QAAQ,MAAM,MAAM,EACpB,QAAQ,MAAM,MAAM,EACpB,QAAQ,MAAM,QAAQ;AAC3B;AAKO,SAAS,qBACd,IACA,UAA+B,CAAC,GAC1B;AACN,KAAG,SAAS,MAAM,kBAAkB,IAAI,CACtC,QACA,QACW;AACX,UAAM,EAAE,QAAQ,IAAI,OAAO,GAAG,EAAE;AAChC,UAAM,UAAU,KAAK,UAAU,EAAE,QAAQ,CAAC;AAC1C,QAAI,QAAQ,kBAAkB,WAAW;AACvC,YAAM,YAAY,QAAQ,iBAAiB;AAC3C,aAAO,YAAY,gBAAgB,SAAS,CAAC,qBAAqB,gBAAgB,OAAO,CAAC;AAAA,IAC5F;AAGA,UAAM,OAAO,QAAQ,QAAQ,MAAM,SAAS;AAC5C,WAAO,wCAAwC,IAAI;AAAA,EACrD;AACF;;;AC3BO,SAAS,iBAAiB,QAAuB;AACtD,SAAO,SAASC,YAAW,IAAgB,UAA6B,CAAC,GAAS;AAChF;AAAA,MACE;AAAA,MACA,CAAC,UAAU,gBAAgB,QAAQ,SAAS,MAAM,GAAG;AAAA,MACrD,EAAE,eAAe,QAAQ,iBAAiB,MAAM;AAAA,IAClD;AACA,yBAAqB,IAAI;AAAA,MACvB,eAAe,QAAQ;AAAA,MACvB,eAAe,QAAQ;AAAA,IACzB,CAAC;AAAA,EACH;AACF;;;AJIO,IAAM,aAAa,iBAAiB,CAAC,SAA4B,QAAkB;AAExF,MAAI,QAAQ,UAAU;AACpB,WAAO,QAAQ;AAAA,EACjB;AAGA,MAAI,QAAQ,QAAQ;AAClB,QAAI;AACF,aAAO,QAAQ,OAAO,SAAS,GAAG;AAAA,IACpC,QAAQ;AACN,aAAO;AAAA,IACT;AAAA,EACF;AAGA,MAAI,QAAQ,aAAa;AACvB,QAAI;AACF,YAAM,MAAM,KAAK,QAAQ,QAAQ,OAAO,QAAQ,IAAI,GAAG,QAAQ,WAAW;AAC1E,YAAM,UAAU,aAAa,KAAK,OAAO;AACzC,aAAO,oBAAoB,SAAS,GAAG;AAAA,IACzC,QAAQ;AACN,aAAO;AAAA,IACT;AAAA,EACF;AAGA,MAAI,QAAQ,cAAc;AACxB,QAAI;AACF,YAAM,MAAM,QAAQ,OAAO,QAAQ,IAAI;AACvC,YAAM,MAAM,KAAK,QAAQ,KAAK,QAAQ,YAAY;AAClD,YAAM,WAAW,MAAM;AACvB,YAAM,WAAW,MAAM;AAEvB,UAAI,MAAqB;AACzB,UAAI,OAAsB;AAC1B,UAAI;AACF,cAAM,aAAa,UAAU,OAAO;AACpC,eAAO;AAAA,MACT,QAAQ;AACN,YAAI;AACF,gBAAM,aAAa,UAAU,OAAO;AACpC,iBAAO;AAAA,QACT,QAAQ;AACN,iBAAO;AAAA,QACT;AAAA,MACF;AAEA,UAAI,CAAC,IAAK,QAAO;AACjB,aAAO,oBAAoB,KAAK,IAAK;AAAA,IACvC,QAAQ;AACN,aAAO;AAAA,IACT;AAAA,EACF;AAEA,SAAO;AACT,CAAC;AAED,IAAO,gBAAQ;",
+  "names": ["resolveComments", "mrsfPlugin"]
 }

package/dist/rules/core.d.ts

@@ -10,11 +10,15 @@
  * elements are created at runtime by the controller.
  */
 import type StateCore from "markdown-it/lib/rules_core/state_core.mjs";
-import type { LineMap } from "../types.js";
+import type { LineMap, SlimComment } from "../types.js";
 export interface CoreRuleOptions {
     /** Whether to add mrsf-line-highlight class on commented tokens. Default: false. */
     lineHighlight?: boolean;
 }
+export interface ResolvedCommentData {
+    lineMap: LineMap;
+    comments: SlimComment[];
+}
 /**
  * Install the MRSF core rule on a markdown-it instance.
  */
@@ -24,5 +28,5 @@ export declare function installCoreRule(md: {
             push: (name: string, fn: (state: StateCore) => void) => void;
         };
     };
-}, lineMap: LineMap, options?: CoreRuleOptions): void;
+}, resolveComments: (state: StateCore) => ResolvedCommentData | null, options?: CoreRuleOptions): void;
 //# sourceMappingURL=core.d.ts.map

package/dist/rules/renderer.d.ts

@@ -5,6 +5,10 @@
  *   - mrsf_data_script: renders a <script type="application/mrsf+json">
  *     containing serialized comment data for the MrsfController.
  */
+export interface RendererRuleOptions {
+    dataContainer?: "script" | "element";
+    dataElementId?: string;
+}
 /**
  * Install MRSF renderer rules on a markdown-it instance.
  */
@@ -12,5 +16,5 @@ export declare function installRendererRules(md: {
     renderer: {
         rules: Record<string, ((...args: any[]) => string) | undefined>;
     };
-}): void;
+}, options?: RendererRuleOptions): void;
 //# sourceMappingURL=renderer.d.ts.map

package/dist/types.d.ts

@@ -27,9 +27,20 @@ export interface MrsfPluginOptions {
      * Takes precedence over `sidecarPath` and `documentPath`.
      * Useful for integrations that manage their own sidecar state.
      */
-    loader?: () => MrsfDocument | null;
+    loader?: (options: MrsfPluginOptions, env?: unknown) => MrsfDocument | null;
     /** Whether to show resolved comments (default: true). */
     showResolved?: boolean;
+    /**
+     * How serialized review data should be embedded into rendered HTML.
+     * - `script`: emits `<script type="application/mrsf+json">` (default)
+     * - `element`: emits a hidden element with JSON in a data attribute
+     */
+    dataContainer?: "script" | "element";
+    /**
+     * Element id used when `dataContainer` is set to `element`.
+     * Default: `mrsf-comment-data`.
+     */
+    dataElementId?: string;
     /**
      * Enable interactive mode — adds action buttons with `data-mrsf-action`
      * attributes for host applications to hook into (default: false).
@@ -88,6 +99,6 @@ export interface CommentThread {
 }
 /** Comments grouped by their anchored source line. */
 export type LineMap = Map<number, CommentThread[]>;
-/** A function that loads sidecar data from plugin options. */
-export type CommentLoader = (options: MrsfPluginOptions) => MrsfDocument | null;
+/** A function that loads sidecar data from plugin options and render context. */
+export type CommentLoader = (options: MrsfPluginOptions, env?: unknown) => MrsfDocument | null;
 //# sourceMappingURL=types.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mrsf/markdown-it-mrsf",
-  "version": "0.4.5",
+  "version": "0.4.6",
   "description": "markdown-it plugin for rendering Sidemark/MRSF (Markdown Review Sidecar Format) review comments",
   "type": "module",
   "main": "./dist/index.js",