@docfuse/plugins 0.1.0

package/dist/kroki.d.ts

@@ -0,0 +1,12 @@
+import { MarkdownPlugin } from '@docfuse/markdown';
+
+interface KrokiOptions {
+    server?: string;
+    /** Map Markdown fence labels to Kroki diagram types. */
+    languages?: Readonly<Record<string, string>>;
+    format?: 'svg' | 'png';
+}
+/** Render plugin-owned diagram fences through a Kroki-compatible server. */
+declare function kroki(options?: KrokiOptions): MarkdownPlugin;
+
+export { type KrokiOptions, kroki };

package/dist/kroki.js

@@ -0,0 +1,293 @@
+// src/kroki/index.ts
+import { defineMarkdownPlugin } from "@docfuse/markdown";
+import { strToU8, zlibSync } from "fflate";
+
+// src/shared/diagram.ts
+import { visit } from "unist-util-visit";
+function displayKind(kind) {
+  if (kind === "plantuml") return "PlantUML";
+  return kind.charAt(0).toUpperCase() + kind.slice(1);
+}
+var DIAGRAM_LABELS = {
+  en: {
+    copy: "Copy source",
+    source: "Show source",
+    preview: "Show preview",
+    expand: "Expand diagram",
+    close: "Close expanded diagram",
+    controls: "Diagram zoom controls",
+    zoomOut: "Zoom out",
+    zoomReset: "Reset zoom",
+    zoomIn: "Zoom in",
+    imageAlt: (kind) => `${displayKind(kind)} diagram`,
+    loadingPreview: "Diagram preview loads in the browser."
+  },
+  zh: {
+    copy: "\u590D\u5236\u56FE\u8868\u6E90\u7801",
+    source: "\u663E\u793A\u56FE\u8868\u6E90\u7801",
+    preview: "\u663E\u793A\u56FE\u8868\u9884\u89C8",
+    expand: "\u653E\u5927\u56FE\u8868",
+    close: "\u5173\u95ED\u56FE\u8868\u9884\u89C8",
+    controls: "\u56FE\u8868\u7F29\u653E\u63A7\u4EF6",
+    zoomOut: "\u7F29\u5C0F\u56FE\u8868",
+    zoomReset: "\u91CD\u7F6E\u56FE\u8868\u7F29\u653E",
+    zoomIn: "\u653E\u5927\u56FE\u8868",
+    imageAlt: (kind) => `${displayKind(kind)} \u56FE\u8868`,
+    loadingPreview: "\u56FE\u8868\u9884\u89C8\u5C06\u5728\u6D4F\u89C8\u5668\u4E2D\u52A0\u8F7D\u3002"
+  }
+};
+function labelsFromFile(file) {
+  if (!file || typeof file !== "object" || !("data" in file)) return DIAGRAM_LABELS.en;
+  const data = file.data;
+  if (!data || typeof data !== "object" || !("docfuseLocale" in data)) return DIAGRAM_LABELS.en;
+  const locale = typeof data.docfuseLocale === "string" ? data.docfuseLocale.toLowerCase() : "";
+  return locale === "zh" || locale.startsWith("zh-") ? DIAGRAM_LABELS.zh : DIAGRAM_LABELS.en;
+}
+function languageOf(node) {
+  const code = node.children.find(
+    (child) => child.type === "element" && child.tagName === "code"
+  );
+  if (!code) return void 0;
+  const classes = Array.isArray(code.properties.className) ? code.properties.className : [];
+  const language = classes.map(String).find((className) => className.startsWith("language-"))?.slice("language-".length).toLowerCase();
+  const source = code.children.filter((child) => child.type === "text").map((child) => child.value).join("");
+  return language ? { language, source } : void 0;
+}
+function action(name, label, properties = {}) {
+  return {
+    type: "element",
+    tagName: "button",
+    properties: { type: "button", dataDfDiagramAction: name, ariaLabel: label, ...properties },
+    children: [{ type: "text", value: label }]
+  };
+}
+function zoomControl(name, label) {
+  return {
+    type: "element",
+    tagName: "button",
+    properties: { type: "button", dataDfDiagramAction: name, ariaLabel: label, title: label },
+    children: [{ type: "text", value: label }]
+  };
+}
+function diagramFence(options) {
+  return () => (tree, file) => {
+    const labels = labelsFromFile(file);
+    visit(tree, "element", (node, index, parent) => {
+      if (!parent || index === void 0 || node.tagName !== "pre") return;
+      const fence = languageOf(node);
+      if (!fence || !options.languages.has(fence.language)) return;
+      const imageUrl = options.imageUrl?.(fence.source, fence.language);
+      const hasVisualPreview = Boolean(imageUrl || options.kind === "mermaid");
+      const preview = imageUrl ? {
+        type: "element",
+        tagName: "img",
+        properties: {
+          className: ["df-diagram-img"],
+          src: imageUrl,
+          alt: labels.imageAlt(options.kind),
+          loading: "lazy"
+        },
+        children: []
+      } : {
+        type: "element",
+        tagName: "div",
+        properties: { className: ["df-diagram-placeholder"] },
+        children: [{ type: "text", value: labels.loadingPreview }]
+      };
+      parent.children[index] = {
+        type: "element",
+        tagName: "figure",
+        properties: {
+          className: ["df-diagram-window"],
+          dataDfPluginDiagram: options.kind,
+          dataDfSource: fence.source,
+          ...options.moduleUrl ? { dataDfModuleUrl: options.moduleUrl } : {}
+        },
+        children: [
+          {
+            type: "element",
+            tagName: "figcaption",
+            properties: { className: ["df-diagram-toolbar"] },
+            children: [
+              {
+                type: "element",
+                tagName: "span",
+                properties: { className: ["df-diagram-title"] },
+                children: [{ type: "text", value: options.filename(fence.language) }]
+              },
+              {
+                type: "element",
+                tagName: "span",
+                properties: { className: ["df-diagram-actions"] },
+                children: [
+                  action("copy", labels.copy),
+                  action("source", labels.source, { dataDfDiagramPreviewLabel: labels.preview }),
+                  action("expand", labels.expand, { dataDfDiagramCloseLabel: labels.close })
+                ]
+              }
+            ]
+          },
+          {
+            type: "element",
+            tagName: "div",
+            properties: { className: ["df-diagram-stage"] },
+            children: [
+              {
+                type: "element",
+                tagName: "div",
+                properties: { className: ["df-diagram-preview"] },
+                children: [preview]
+              },
+              {
+                type: "element",
+                tagName: "pre",
+                properties: { className: ["df-diagram-source"], hidden: true },
+                children: [
+                  {
+                    type: "element",
+                    tagName: "code",
+                    properties: {},
+                    children: [{ type: "text", value: fence.source }]
+                  }
+                ]
+              },
+              ...hasVisualPreview ? [
+                {
+                  type: "element",
+                  tagName: "div",
+                  properties: {
+                    className: ["df-diagram-zoom-controls"],
+                    role: "group",
+                    ariaLabel: labels.controls
+                  },
+                  children: [
+                    zoomControl("zoom-out", labels.zoomOut),
+                    zoomControl("zoom-reset", labels.zoomReset),
+                    zoomControl("zoom-in", labels.zoomIn)
+                  ]
+                }
+              ] : []
+            ]
+          }
+        ]
+      };
+    });
+  };
+}
+
+// src/shared/markdownSource.ts
+function stripColumns(value, columns) {
+  let index = 0;
+  let consumed = 0;
+  while (index < value.length && consumed < columns) {
+    if (value[index] === " ") consumed += 1;
+    else if (value[index] === "	") consumed += 4 - consumed % 4;
+    else break;
+    index += 1;
+  }
+  return consumed >= columns ? value.slice(index) : void 0;
+}
+function containerContent(line, state) {
+  let value = line;
+  while (true) {
+    const quote = value.match(/^ {0,3}>[ \t]?/);
+    if (!quote) break;
+    value = value.slice(quote[0].length);
+  }
+  const continued = state.listIndent > 0 ? stripColumns(value, state.listIndent) : void 0;
+  const content = continued ?? value;
+  const item = content.match(/^ {0,3}(?:[-+*]|\d{1,9}[.)])([ \t]+)(.*)$/);
+  if (item) {
+    const body = item[2] ?? "";
+    state.listIndent = (continued === void 0 ? 0 : state.listIndent) + content.length - body.length;
+    return body;
+  }
+  if (continued !== void 0 || value.trim() === "") return content;
+  state.listIndent = 0;
+  return value;
+}
+function openingFence(line) {
+  const match = line.match(/^ {0,3}(`{3,}|~{3,})(.*)$/);
+  if (!match?.[1]) return void 0;
+  const marker = match[1][0];
+  const info = match[2]?.trim() ?? "";
+  if (marker === "`" && info.includes("`")) return void 0;
+  return {
+    marker,
+    size: match[1].length,
+    language: info.split(/\s+/, 1)[0]?.toLowerCase() ?? ""
+  };
+}
+function closesFence(line, fence) {
+  const match = line.match(/^ {0,3}(`+|~+)[ \t]*$/);
+  return Boolean(match?.[1]?.[0] === fence.marker && match[1].length >= fence.size);
+}
+function hasMarkdownFenceLanguage(source, languages) {
+  let open;
+  const container = { listIndent: 0 };
+  for (const line of source.split(/\r?\n/)) {
+    const content = containerContent(line, container);
+    if (open) {
+      if (closesFence(content, open)) open = void 0;
+      continue;
+    }
+    const fence = openingFence(content);
+    if (!fence) continue;
+    if (languages.has(fence.language)) return true;
+    open = fence;
+  }
+  return false;
+}
+
+// src/kroki/index.ts
+var PLUGIN_VERSION = "3";
+var DEFAULT_SERVER = "https://kroki.io";
+var DEFAULT_LANGUAGES = {
+  graphviz: "graphviz",
+  dot: "graphviz",
+  gv: "graphviz",
+  d2: "d2"
+};
+function encodeKroki(source) {
+  let binary = "";
+  for (const byte of zlibSync(strToU8(source), { level: 9 })) binary += String.fromCharCode(byte);
+  return btoa(binary).replaceAll("+", "-").replaceAll("/", "_").replace(/=+$/, "");
+}
+function krokiUrl(server, type, format, source) {
+  return `${server}/${encodeURIComponent(type)}/${format}/${encodeKroki(source)}`;
+}
+function kroki(options = {}) {
+  const server = options.server?.replace(/\/+$/, "") || DEFAULT_SERVER;
+  const languages = { ...DEFAULT_LANGUAGES, ...options.languages };
+  const format = options.format === "png" ? "png" : "svg";
+  const languageMap = Object.fromEntries(
+    Object.entries(languages).map(([language, type]) => [language.trim().toLowerCase(), type.trim().toLowerCase()]).filter(([language, type]) => language && type)
+  );
+  return defineMarkdownPlugin({
+    name: "kroki",
+    version: PLUGIN_VERSION,
+    cacheKey: { server, languages: languageMap, format },
+    browserCompiler: {
+      module: "@docfuse/plugins/kroki",
+      exportName: "kroki",
+      options: { server, languages: languageMap, format }
+    },
+    fenceLanguages: Object.keys(languageMap),
+    appliesTo: ({ source }) => hasMarkdownFenceLanguage(source, new Set(Object.keys(languageMap))),
+    assets: {
+      clients: [{ id: "kroki", module: "@docfuse/plugins/client/kroki" }],
+      styles: [{ id: "diagrams", module: "@docfuse/plugins/diagram.css" }]
+    },
+    rehypePlugins: [
+      diagramFence({
+        languages: new Set(Object.keys(languageMap)),
+        kind: "kroki",
+        filename: (language) => `diagram.${languageMap[language] ?? language}`,
+        imageUrl: (source, language) => krokiUrl(server, languageMap[language] ?? language, format, source)
+      })
+    ]
+  });
+}
+export {
+  kroki
+};

package/dist/link-card.d.ts

@@ -0,0 +1,9 @@
+import { MarkdownPlugin } from '@docfuse/markdown';
+
+interface LinkCardOptions {
+    internalHosts?: readonly string[];
+    includeRelative?: boolean;
+}
+declare function linkCard(options?: LinkCardOptions): MarkdownPlugin;
+
+export { type LinkCardOptions, linkCard };

package/dist/link-card.js

@@ -0,0 +1,87 @@
+// src/link-card/index.ts
+import { defineMarkdownPlugin } from "@docfuse/markdown";
+import { SKIP, visit } from "unist-util-visit";
+
+// src/shared/hast.ts
+function element(tagName, properties = {}, children = []) {
+  return { type: "element", tagName, properties, children };
+}
+
+// src/shared/urls.ts
+function hostnameOf(href) {
+  try {
+    return new URL(href).hostname.toLowerCase();
+  } catch {
+    return void 0;
+  }
+}
+function isInternalHost(host, internalHosts) {
+  return internalHosts.some((internal) => host === internal || host.endsWith(`.${internal}`));
+}
+
+// src/link-card/index.ts
+var PLUGIN_VERSION = "1";
+function isExternalHttpLink(href, internalHosts, includeRelative) {
+  if (!href) return false;
+  if (href.startsWith("/") || href.startsWith("#") || href.startsWith("mailto:"))
+    return includeRelative && href.startsWith("/");
+  if (!/^https?:\/\//i.test(href)) return false;
+  const host = hostnameOf(href);
+  return Boolean(host && !isInternalHost(host, internalHosts));
+}
+function textOf(node) {
+  if (node.type === "text") return node.value;
+  if ("children" in node) return node.children.map((child) => textOf(child)).join("");
+  return "";
+}
+function displayHost(href) {
+  try {
+    const url = new URL(href);
+    return url.hostname + (url.pathname === "/" ? "" : url.pathname);
+  } catch {
+    return href;
+  }
+}
+function linkCard(options = {}) {
+  const internalHosts = (options.internalHosts ?? []).map((host) => host.toLowerCase());
+  const includeRelative = options.includeRelative === true;
+  return defineMarkdownPlugin({
+    name: "link-card",
+    version: PLUGIN_VERSION,
+    cacheKey: { internalHosts, includeRelative },
+    browserCompiler: {
+      module: "@docfuse/plugins/link-card",
+      exportName: "linkCard",
+      options: { internalHosts, includeRelative }
+    },
+    rehypePlugins: [
+      () => (tree) => {
+        visit(tree, "element", (node, index, parent) => {
+          if (node.tagName !== "p" || !parent || index === void 0) return;
+          const meaningful = node.children.filter(
+            (child) => child.type !== "text" || child.value.trim() !== ""
+          );
+          const onlyChild = meaningful[0];
+          if (meaningful.length !== 1 || onlyChild?.type !== "element" || onlyChild.tagName !== "a") return;
+          const href = String(onlyChild.properties.href ?? "");
+          if (!isExternalHttpLink(href, internalHosts, includeRelative)) return;
+          if (onlyChild.properties.dataDfElement === "file-link") return;
+          const title = textOf(onlyChild).trim() || displayHost(href);
+          const meta = displayHost(href);
+          parent.children[index] = element(
+            "a",
+            { ...onlyChild.properties, className: ["df-link-card"], href, dataDfComponent: "link-card" },
+            [
+              element("strong", {}, [{ type: "text", value: title }]),
+              ...meta && meta !== title ? [element("span", {}, [{ type: "text", value: meta }])] : []
+            ]
+          );
+          return [SKIP, index];
+        });
+      }
+    ]
+  });
+}
+export {
+  linkCard
+};

package/dist/math.css

@@ -0,0 +1,3 @@
+/* KaTeX */
+@font-face{font-display:block;font-family:KaTeX_AMS;font-style:normal;font-weight:400;src:url(fonts/KaTeX_AMS-Regular.woff2) format("woff2")}@font-face{font-display:block;font-family:KaTeX_Caligraphic;font-style:normal;font-weight:700;src:url(fonts/KaTeX_Caligraphic-Bold.woff2) format("woff2")}@font-face{font-display:block;font-family:KaTeX_Caligraphic;font-style:normal;font-weight:400;src:url(fonts/KaTeX_Caligraphic-Regular.woff2) format("woff2")}@font-face{font-display:block;font-family:KaTeX_Fraktur;font-style:normal;font-weight:700;src:url(fonts/KaTeX_Fraktur-Bold.woff2) format("woff2")}@font-face{font-display:block;font-family:KaTeX_Fraktur;font-style:normal;font-weight:400;src:url(fonts/KaTeX_Fraktur-Regular.woff2) format("woff2")}@font-face{font-display:block;font-family:KaTeX_Main;font-style:normal;font-weight:700;src:url(fonts/KaTeX_Main-Bold.woff2) format("woff2")}@font-face{font-display:block;font-family:KaTeX_Main;font-style:italic;font-weight:700;src:url(fonts/KaTeX_Main-BoldItalic.woff2) format("woff2")}@font-face{font-display:block;font-family:KaTeX_Main;font-style:italic;font-weight:400;src:url(fonts/KaTeX_Main-Italic.woff2) format("woff2")}@font-face{font-display:block;font-family:KaTeX_Main;font-style:normal;font-weight:400;src:url(fonts/KaTeX_Main-Regular.woff2) format("woff2")}@font-face{font-display:block;font-family:KaTeX_Math;font-style:italic;font-weight:700;src:url(fonts/KaTeX_Math-BoldItalic.woff2) format("woff2")}@font-face{font-display:block;font-family:KaTeX_Math;font-style:italic;font-weight:400;src:url(fonts/KaTeX_Math-Italic.woff2) format("woff2")}@font-face{font-display:block;font-family:"KaTeX_SansSerif";font-style:normal;font-weight:700;src:url(fonts/KaTeX_SansSerif-Bold.woff2) format("woff2")}@font-face{font-display:block;font-family:"KaTeX_SansSerif";font-style:italic;font-weight:400;src:url(fonts/KaTeX_SansSerif-Italic.woff2) format("woff2")}@font-face{font-display:block;font-family:"KaTeX_SansSerif";font-style:normal;font-weight:400;src:url(fonts/KaTeX_SansSerif-Regular.woff2) format("woff2")}@font-face{font-display:block;font-family:KaTeX_Script;font-style:normal;font-weight:400;src:url(fonts/KaTeX_Script-Regular.woff2) format("woff2")}@font-face{font-display:block;font-family:KaTeX_Size1;font-style:normal;font-weight:400;src:url(fonts/KaTeX_Size1-Regular.woff2) format("woff2")}@font-face{font-display:block;font-family:KaTeX_Size2;font-style:normal;font-weight:400;src:url(fonts/KaTeX_Size2-Regular.woff2) format("woff2")}@font-face{font-display:block;font-family:KaTeX_Size3;font-style:normal;font-weight:400;src:url(fonts/KaTeX_Size3-Regular.woff2) format("woff2")}@font-face{font-display:block;font-family:KaTeX_Size4;font-style:normal;font-weight:400;src:url(fonts/KaTeX_Size4-Regular.woff2) format("woff2")}@font-face{font-display:block;font-family:KaTeX_Typewriter;font-style:normal;font-weight:400;src:url(fonts/KaTeX_Typewriter-Regular.woff2) format("woff2")}.katex{font:normal 1.21em KaTeX_Main,Times New Roman,serif;line-height:1.2;position:relative;text-indent:0;text-rendering:auto}.katex *{-ms-high-contrast-adjust:none!important;border-color:currentColor}.katex .katex-version:after{content:"0.17.0"}.katex .katex-mathml{border:0;-webkit-clip-path:inset(50%);clip-path:inset(50%);height:1px;overflow:hidden;padding:0;position:absolute;width:1px}.katex .katex-html>.newline{display:block}.katex .base{position:relative;white-space:nowrap;width:-webkit-min-content;width:-moz-min-content;width:min-content}.katex .base,.katex .strut{display:inline-block}.katex .textbf{font-weight:700}.katex .textit{font-style:italic}.katex .textrm{font-family:KaTeX_Main}.katex .textsf{font-family:KaTeX_SansSerif}.katex .texttt{font-family:KaTeX_Typewriter}.katex .mathnormal{font-family:KaTeX_Math;font-style:italic}.katex .mathit{font-family:KaTeX_Main;font-style:italic}.katex .mathrm{font-style:normal}.katex .mathbf{font-family:KaTeX_Main;font-weight:700}.katex .boldsymbol{font-family:KaTeX_Math;font-style:italic;font-weight:700}.katex .amsrm,.katex .mathbb,.katex .textbb{font-family:KaTeX_AMS}.katex .mathcal{font-family:KaTeX_Caligraphic}.katex .mathfrak,.katex .textfrak{font-family:KaTeX_Fraktur}.katex .mathboldfrak,.katex .textboldfrak{font-family:KaTeX_Fraktur;font-weight:700}.katex .mathtt{font-family:KaTeX_Typewriter}.katex .mathscr,.katex .textscr{font-family:KaTeX_Script}.katex .mathsf,.katex .textsf{font-family:KaTeX_SansSerif}.katex .mathboldsf,.katex .textboldsf{font-family:KaTeX_SansSerif;font-weight:700}.katex .mathitsf,.katex .mathsfit,.katex .textitsf{font-family:KaTeX_SansSerif;font-style:italic}.katex .mainrm{font-family:KaTeX_Main;font-style:normal}.katex .vlist-t{border-collapse:collapse;display:inline-table;table-layout:fixed}.katex .vlist-r{display:table-row}.katex .vlist{display:table-cell;position:relative;vertical-align:bottom}.katex .vlist>span{display:block;height:0;position:relative}.katex .vlist>span>span{display:inline-block}.katex .vlist>span>.pstrut{overflow:hidden;width:0}.katex .vlist-t2{margin-right:-2px}.katex .vlist-s{display:table-cell;font-size:1px;min-width:2px;vertical-align:bottom;width:2px}.katex .vbox{align-items:baseline;display:inline-flex;flex-direction:column}.katex .hbox{width:100%}.katex .hbox,.katex .thinbox{display:inline-flex;flex-direction:row}.katex .thinbox{max-width:0;width:0}.katex .msupsub{text-align:left}.katex .mfrac>span>span{text-align:center}.katex .mfrac .frac-line{border-bottom-style:solid;display:inline-block;width:100%}.katex .hdashline,.katex .hline,.katex .mfrac .frac-line,.katex .overline .overline-line,.katex .rule,.katex .underline .underline-line{min-height:1px}.katex .mspace{display:inline-block}.katex .smash{display:inline;line-height:0}.katex .clap,.katex .llap,.katex .rlap{position:relative;width:0}.katex .clap>.inner,.katex .llap>.inner,.katex .rlap>.inner{position:absolute}.katex .clap>.fix,.katex .llap>.fix,.katex .rlap>.fix{display:inline-block}.katex .llap>.inner{right:0}.katex .clap>.inner,.katex .rlap>.inner{left:0}.katex .clap>.inner>span{margin-left:-50%;margin-right:50%}.katex .rule{border:0 solid;display:inline-block;position:relative}.katex .hline,.katex .overline .overline-line,.katex .underline .underline-line{border-bottom-style:solid;display:inline-block;width:100%}.katex .hdashline{border-bottom-style:dashed;display:inline-block;width:100%}.katex .sqrt>.root{margin-left:.2777777778em;margin-right:-.5555555556em}.katex .fontsize-ensurer.reset-size1.size1,.katex .sizing.reset-size1.size1{font-size:1em}.katex .fontsize-ensurer.reset-size1.size2,.katex .sizing.reset-size1.size2{font-size:1.2em}.katex .fontsize-ensurer.reset-size1.size3,.katex .sizing.reset-size1.size3{font-size:1.4em}.katex .fontsize-ensurer.reset-size1.size4,.katex .sizing.reset-size1.size4{font-size:1.6em}.katex .fontsize-ensurer.reset-size1.size5,.katex .sizing.reset-size1.size5{font-size:1.8em}.katex .fontsize-ensurer.reset-size1.size6,.katex .sizing.reset-size1.size6{font-size:2em}.katex .fontsize-ensurer.reset-size1.size7,.katex .sizing.reset-size1.size7{font-size:2.4em}.katex .fontsize-ensurer.reset-size1.size8,.katex .sizing.reset-size1.size8{font-size:2.88em}.katex .fontsize-ensurer.reset-size1.size9,.katex .sizing.reset-size1.size9{font-size:3.456em}.katex .fontsize-ensurer.reset-size1.size10,.katex .sizing.reset-size1.size10{font-size:4.148em}.katex .fontsize-ensurer.reset-size1.size11,.katex .sizing.reset-size1.size11{font-size:4.976em}.katex .fontsize-ensurer.reset-size2.size1,.katex .sizing.reset-size2.size1{font-size:.8333333333em}.katex .fontsize-ensurer.reset-size2.size2,.katex .sizing.reset-size2.size2{font-size:1em}.katex .fontsize-ensurer.reset-size2.size3,.katex .sizing.reset-size2.size3{font-size:1.1666666667em}.katex .fontsize-ensurer.reset-size2.size4,.katex .sizing.reset-size2.size4{font-size:1.3333333333em}.katex .fontsize-ensurer.reset-size2.size5,.katex .sizing.reset-size2.size5{font-size:1.5em}.katex .fontsize-ensurer.reset-size2.size6,.katex .sizing.reset-size2.size6{font-size:1.6666666667em}.katex .fontsize-ensurer.reset-size2.size7,.katex .sizing.reset-size2.size7{font-size:2em}.katex .fontsize-ensurer.reset-size2.size8,.katex .sizing.reset-size2.size8{font-size:2.4em}.katex .fontsize-ensurer.reset-size2.size9,.katex .sizing.reset-size2.size9{font-size:2.88em}.katex .fontsize-ensurer.reset-size2.size10,.katex .sizing.reset-size2.size10{font-size:3.4566666667em}.katex .fontsize-ensurer.reset-size2.size11,.katex .sizing.reset-size2.size11{font-size:4.1466666667em}.katex .fontsize-ensurer.reset-size3.size1,.katex .sizing.reset-size3.size1{font-size:.7142857143em}.katex .fontsize-ensurer.reset-size3.size2,.katex .sizing.reset-size3.size2{font-size:.8571428571em}.katex .fontsize-ensurer.reset-size3.size3,.katex .sizing.reset-size3.size3{font-size:1em}.katex .fontsize-ensurer.reset-size3.size4,.katex .sizing.reset-size3.size4{font-size:1.1428571429em}.katex .fontsize-ensurer.reset-size3.size5,.katex .sizing.reset-size3.size5{font-size:1.2857142857em}.katex .fontsize-ensurer.reset-size3.size6,.katex .sizing.reset-size3.size6{font-size:1.4285714286em}.katex .fontsize-ensurer.reset-size3.size7,.katex .sizing.reset-size3.size7{font-size:1.7142857143em}.katex .fontsize-ensurer.reset-size3.size8,.katex .sizing.reset-size3.size8{font-size:2.0571428571em}.katex .fontsize-ensurer.reset-size3.size9,.katex .sizing.reset-size3.size9{font-size:2.4685714286em}.katex .fontsize-ensurer.reset-size3.size10,.katex .sizing.reset-size3.size10{font-size:2.9628571429em}.katex .fontsize-ensurer.reset-size3.size11,.katex .sizing.reset-size3.size11{font-size:3.5542857143em}.katex .fontsize-ensurer.reset-size4.size1,.katex .sizing.reset-size4.size1{font-size:.625em}.katex .fontsize-ensurer.reset-size4.size2,.katex .sizing.reset-size4.size2{font-size:.75em}.katex .fontsize-ensurer.reset-size4.size3,.katex .sizing.reset-size4.size3{font-size:.875em}.katex .fontsize-ensurer.reset-size4.size4,.katex .sizing.reset-size4.size4{font-size:1em}.katex .fontsize-ensurer.reset-size4.size5,.katex .sizing.reset-size4.size5{font-size:1.125em}.katex .fontsize-ensurer.reset-size4.size6,.katex .sizing.reset-size4.size6{font-size:1.25em}.katex .fontsize-ensurer.reset-size4.size7,.katex .sizing.reset-size4.size7{font-size:1.5em}.katex .fontsize-ensurer.reset-size4.size8,.katex .sizing.reset-size4.size8{font-size:1.8em}.katex .fontsize-ensurer.reset-size4.size9,.katex .sizing.reset-size4.size9{font-size:2.16em}.katex .fontsize-ensurer.reset-size4.size10,.katex .sizing.reset-size4.size10{font-size:2.5925em}.katex .fontsize-ensurer.reset-size4.size11,.katex .sizing.reset-size4.size11{font-size:3.11em}.katex .fontsize-ensurer.reset-size5.size1,.katex .sizing.reset-size5.size1{font-size:.5555555556em}.katex .fontsize-ensurer.reset-size5.size2,.katex .sizing.reset-size5.size2{font-size:.6666666667em}.katex .fontsize-ensurer.reset-size5.size3,.katex .sizing.reset-size5.size3{font-size:.7777777778em}.katex .fontsize-ensurer.reset-size5.size4,.katex .sizing.reset-size5.size4{font-size:.8888888889em}.katex .fontsize-ensurer.reset-size5.size5,.katex .sizing.reset-size5.size5{font-size:1em}.katex .fontsize-ensurer.reset-size5.size6,.katex .sizing.reset-size5.size6{font-size:1.1111111111em}.katex .fontsize-ensurer.reset-size5.size7,.katex .sizing.reset-size5.size7{font-size:1.3333333333em}.katex .fontsize-ensurer.reset-size5.size8,.katex .sizing.reset-size5.size8{font-size:1.6em}.katex .fontsize-ensurer.reset-size5.size9,.katex .sizing.reset-size5.size9{font-size:1.92em}.katex .fontsize-ensurer.reset-size5.size10,.katex .sizing.reset-size5.size10{font-size:2.3044444444em}.katex .fontsize-ensurer.reset-size5.size11,.katex .sizing.reset-size5.size11{font-size:2.7644444444em}.katex .fontsize-ensurer.reset-size6.size1,.katex .sizing.reset-size6.size1{font-size:.5em}.katex .fontsize-ensurer.reset-size6.size2,.katex .sizing.reset-size6.size2{font-size:.6em}.katex .fontsize-ensurer.reset-size6.size3,.katex .sizing.reset-size6.size3{font-size:.7em}.katex .fontsize-ensurer.reset-size6.size4,.katex .sizing.reset-size6.size4{font-size:.8em}.katex .fontsize-ensurer.reset-size6.size5,.katex .sizing.reset-size6.size5{font-size:.9em}.katex .fontsize-ensurer.reset-size6.size6,.katex .sizing.reset-size6.size6{font-size:1em}.katex .fontsize-ensurer.reset-size6.size7,.katex .sizing.reset-size6.size7{font-size:1.2em}.katex .fontsize-ensurer.reset-size6.size8,.katex .sizing.reset-size6.size8{font-size:1.44em}.katex .fontsize-ensurer.reset-size6.size9,.katex .sizing.reset-size6.size9{font-size:1.728em}.katex .fontsize-ensurer.reset-size6.size10,.katex .sizing.reset-size6.size10{font-size:2.074em}.katex .fontsize-ensurer.reset-size6.size11,.katex .sizing.reset-size6.size11{font-size:2.488em}.katex .fontsize-ensurer.reset-size7.size1,.katex .sizing.reset-size7.size1{font-size:.4166666667em}.katex .fontsize-ensurer.reset-size7.size2,.katex .sizing.reset-size7.size2{font-size:.5em}.katex .fontsize-ensurer.reset-size7.size3,.katex .sizing.reset-size7.size3{font-size:.5833333333em}.katex .fontsize-ensurer.reset-size7.size4,.katex .sizing.reset-size7.size4{font-size:.6666666667em}.katex .fontsize-ensurer.reset-size7.size5,.katex .sizing.reset-size7.size5{font-size:.75em}.katex .fontsize-ensurer.reset-size7.size6,.katex .sizing.reset-size7.size6{font-size:.8333333333em}.katex .fontsize-ensurer.reset-size7.size7,.katex .sizing.reset-size7.size7{font-size:1em}.katex .fontsize-ensurer.reset-size7.size8,.katex .sizing.reset-size7.size8{font-size:1.2em}.katex .fontsize-ensurer.reset-size7.size9,.katex .sizing.reset-size7.size9{font-size:1.44em}.katex .fontsize-ensurer.reset-size7.size10,.katex .sizing.reset-size7.size10{font-size:1.7283333333em}.katex .fontsize-ensurer.reset-size7.size11,.katex .sizing.reset-size7.size11{font-size:2.0733333333em}.katex .fontsize-ensurer.reset-size8.size1,.katex .sizing.reset-size8.size1{font-size:.3472222222em}.katex .fontsize-ensurer.reset-size8.size2,.katex .sizing.reset-size8.size2{font-size:.4166666667em}.katex .fontsize-ensurer.reset-size8.size3,.katex .sizing.reset-size8.size3{font-size:.4861111111em}.katex .fontsize-ensurer.reset-size8.size4,.katex .sizing.reset-size8.size4{font-size:.5555555556em}.katex .fontsize-ensurer.reset-size8.size5,.katex .sizing.reset-size8.size5{font-size:.625em}.katex .fontsize-ensurer.reset-size8.size6,.katex .sizing.reset-size8.size6{font-size:.6944444444em}.katex .fontsize-ensurer.reset-size8.size7,.katex .sizing.reset-size8.size7{font-size:.8333333333em}.katex .fontsize-ensurer.reset-size8.size8,.katex .sizing.reset-size8.size8{font-size:1em}.katex .fontsize-ensurer.reset-size8.size9,.katex .sizing.reset-size8.size9{font-size:1.2em}.katex .fontsize-ensurer.reset-size8.size10,.katex .sizing.reset-size8.size10{font-size:1.4402777778em}.katex .fontsize-ensurer.reset-size8.size11,.katex .sizing.reset-size8.size11{font-size:1.7277777778em}.katex .fontsize-ensurer.reset-size9.size1,.katex .sizing.reset-size9.size1{font-size:.2893518519em}.katex .fontsize-ensurer.reset-size9.size2,.katex .sizing.reset-size9.size2{font-size:.3472222222em}.katex .fontsize-ensurer.reset-size9.size3,.katex .sizing.reset-size9.size3{font-size:.4050925926em}.katex .fontsize-ensurer.reset-size9.size4,.katex .sizing.reset-size9.size4{font-size:.462962963em}.katex .fontsize-ensurer.reset-size9.size5,.katex .sizing.reset-size9.size5{font-size:.5208333333em}.katex .fontsize-ensurer.reset-size9.size6,.katex .sizing.reset-size9.size6{font-size:.5787037037em}.katex .fontsize-ensurer.reset-size9.size7,.katex .sizing.reset-size9.size7{font-size:.6944444444em}.katex .fontsize-ensurer.reset-size9.size8,.katex .sizing.reset-size9.size8{font-size:.8333333333em}.katex .fontsize-ensurer.reset-size9.size9,.katex .sizing.reset-size9.size9{font-size:1em}.katex .fontsize-ensurer.reset-size9.size10,.katex .sizing.reset-size9.size10{font-size:1.2002314815em}.katex .fontsize-ensurer.reset-size9.size11,.katex .sizing.reset-size9.size11{font-size:1.4398148148em}.katex .fontsize-ensurer.reset-size10.size1,.katex .sizing.reset-size10.size1{font-size:.2410800386em}.katex .fontsize-ensurer.reset-size10.size2,.katex .sizing.reset-size10.size2{font-size:.2892960463em}.katex .fontsize-ensurer.reset-size10.size3,.katex .sizing.reset-size10.size3{font-size:.337512054em}.katex .fontsize-ensurer.reset-size10.size4,.katex .sizing.reset-size10.size4{font-size:.3857280617em}.katex .fontsize-ensurer.reset-size10.size5,.katex .sizing.reset-size10.size5{font-size:.4339440694em}.katex .fontsize-ensurer.reset-size10.size6,.katex .sizing.reset-size10.size6{font-size:.4821600771em}.katex .fontsize-ensurer.reset-size10.size7,.katex .sizing.reset-size10.size7{font-size:.5785920926em}.katex .fontsize-ensurer.reset-size10.size8,.katex .sizing.reset-size10.size8{font-size:.6943105111em}.katex .fontsize-ensurer.reset-size10.size9,.katex .sizing.reset-size10.size9{font-size:.8331726133em}.katex .fontsize-ensurer.reset-size10.size10,.katex .sizing.reset-size10.size10{font-size:1em}.katex .fontsize-ensurer.reset-size10.size11,.katex .sizing.reset-size10.size11{font-size:1.1996142719em}.katex .fontsize-ensurer.reset-size11.size1,.katex .sizing.reset-size11.size1{font-size:.2009646302em}.katex .fontsize-ensurer.reset-size11.size2,.katex .sizing.reset-size11.size2{font-size:.2411575563em}.katex .fontsize-ensurer.reset-size11.size3,.katex .sizing.reset-size11.size3{font-size:.2813504823em}.katex .fontsize-ensurer.reset-size11.size4,.katex .sizing.reset-size11.size4{font-size:.3215434084em}.katex .fontsize-ensurer.reset-size11.size5,.katex .sizing.reset-size11.size5{font-size:.3617363344em}.katex .fontsize-ensurer.reset-size11.size6,.katex .sizing.reset-size11.size6{font-size:.4019292605em}.katex .fontsize-ensurer.reset-size11.size7,.katex .sizing.reset-size11.size7{font-size:.4823151125em}.katex .fontsize-ensurer.reset-size11.size8,.katex .sizing.reset-size11.size8{font-size:.578778135em}.katex .fontsize-ensurer.reset-size11.size9,.katex .sizing.reset-size11.size9{font-size:.6945337621em}.katex .fontsize-ensurer.reset-size11.size10,.katex .sizing.reset-size11.size10{font-size:.8336012862em}.katex .fontsize-ensurer.reset-size11.size11,.katex .sizing.reset-size11.size11{font-size:1em}.katex .delimsizing.size1{font-family:KaTeX_Size1}.katex .delimsizing.size2{font-family:KaTeX_Size2}.katex .delimsizing.size3{font-family:KaTeX_Size3}.katex .delimsizing.size4{font-family:KaTeX_Size4}.katex .delimsizing.mult .delim-size1>span{font-family:KaTeX_Size1}.katex .delimsizing.mult .delim-size4>span{font-family:KaTeX_Size4}.katex .nulldelimiter{display:inline-block;width:.12em}.katex .delimcenter,.katex .op-symbol{position:relative}.katex .op-symbol.small-op{font-family:KaTeX_Size1}.katex .op-symbol.large-op{font-family:KaTeX_Size2}.katex .accent>.vlist-t,.katex .op-limits>.vlist-t{text-align:center}.katex .accent .accent-body{position:relative}.katex .accent .accent-body:not(.accent-full){width:0}.katex .overlay{display:block}.katex .mtable .vertical-separator{display:inline-block;min-width:1px}.katex .mtable .arraycolsep{display:inline-block}.katex .mtable .col-align-c>.vlist-t{text-align:center}.katex .mtable .col-align-l>.vlist-t{text-align:left}.katex .mtable .col-align-r>.vlist-t{text-align:right}.katex .svg-align{text-align:left}.katex svg{fill:currentColor;stroke:currentColor;display:block;height:inherit;position:absolute;width:100%}.katex svg path{stroke:none}.katex svg{fill-rule:nonzero;fill-opacity:1;stroke-width:1;stroke-linecap:butt;stroke-linejoin:miter;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1}.katex img{border-style:none;max-height:none;max-width:none;min-height:0;min-width:0}.katex .stretchy{display:block;overflow:hidden;position:relative;width:100%}.katex .stretchy:after,.katex .stretchy:before{content:""}.katex .hide-tail{overflow:hidden;position:relative;width:100%}.katex .halfarrow-left{left:0;overflow:hidden;position:absolute;width:50.2%}.katex .halfarrow-right{overflow:hidden;position:absolute;right:0;width:50.2%}.katex .brace-left{left:0;overflow:hidden;position:absolute;width:25.1%}.katex .brace-center{left:25%;overflow:hidden;position:absolute;width:50%}.katex .brace-right{overflow:hidden;position:absolute;right:0;width:25.1%}.katex .x-arrow-pad{padding:0 .5em}.katex .cd-arrow-pad{padding:0 .55556em 0 .27778em}.katex .mover,.katex .munder,.katex .x-arrow{text-align:center}.katex .boxpad{padding:0 .3em}.katex .fbox,.katex .fcolorbox{border:.04em solid;box-sizing:border-box}.katex .cancel-pad{padding:0 .2em}.katex .cancel-lap{margin-left:-.2em;margin-right:-.2em}.katex .sout{border-bottom-style:solid;border-bottom-width:.08em}.katex .angl{border-right:.049em solid;border-top:.049em solid;box-sizing:border-box;margin-right:.03889em}.katex .anglpad{padding:0 .03889em}.katex .eqn-num:before{content:"(" counter(katexEqnNo) ")";counter-increment:katexEqnNo}.katex .mml-eqn-num:before{content:"(" counter(mmlEqnNo) ")";counter-increment:mmlEqnNo}.katex .mtr-glue{width:50%}.katex .cd-vert-arrow{display:inline-block;position:relative}.katex .cd-label-left{display:inline-block;position:absolute;right:calc(50% + .3em);text-align:left}.katex .cd-label-right{display:inline-block;left:calc(50% + .3em);position:absolute;text-align:right}.katex-display{display:block;margin:1em 0;text-align:center}.katex-display>.katex{display:block;text-align:center;white-space:nowrap}.katex-display>.katex>.katex-html{display:block;position:relative}.katex-display>.katex>.katex-html>.tag{position:absolute;right:0}.katex-display.leqno>.katex>.katex-html>.tag{left:0;right:auto}.katex-display.fleqn>.katex{padding-left:2em;text-align:left}body{counter-reset:katexEqnNo mmlEqnNo}
+

package/dist/math.d.ts

@@ -0,0 +1,19 @@
+import { MarkdownPlugin } from '@docfuse/markdown';
+
+interface MathOptions {
+    /** KaTeX should throw instead of rendering unsupported input. */
+    throwOnError?: boolean;
+    /** Color used by KaTeX when `throwOnError` is false. */
+    errorColor?: string;
+    /** Trust KaTeX commands that can emit URLs or HTML. Disabled by default. */
+    trust?: boolean;
+    /** KaTeX strictness policy. */
+    strict?: boolean | 'ignore' | 'warn' | 'error';
+    /** Macros passed to KaTeX. */
+    macros?: Readonly<Record<string, string>>;
+}
+/** Conservative opt-in detector; escaped dollar signs and code do not activate KaTeX. */
+declare function hasMathSyntax(source: string): boolean;
+declare function math(options?: MathOptions): MarkdownPlugin;
+
+export { type MathOptions, hasMathSyntax, math };

package/dist/math.js

@@ -0,0 +1,140 @@
+// src/math/index.ts
+import { defineMarkdownPlugin } from "@docfuse/markdown";
+import rehypeKatex from "rehype-katex";
+import remarkMath from "remark-math";
+
+// src/shared/markdownSource.ts
+function stripColumns(value, columns) {
+  let index = 0;
+  let consumed = 0;
+  while (index < value.length && consumed < columns) {
+    if (value[index] === " ") consumed += 1;
+    else if (value[index] === "	") consumed += 4 - consumed % 4;
+    else break;
+    index += 1;
+  }
+  return consumed >= columns ? value.slice(index) : void 0;
+}
+function containerContent(line, state) {
+  let value = line;
+  while (true) {
+    const quote = value.match(/^ {0,3}>[ \t]?/);
+    if (!quote) break;
+    value = value.slice(quote[0].length);
+  }
+  const continued = state.listIndent > 0 ? stripColumns(value, state.listIndent) : void 0;
+  const content = continued ?? value;
+  const item = content.match(/^ {0,3}(?:[-+*]|\d{1,9}[.)])([ \t]+)(.*)$/);
+  if (item) {
+    const body = item[2] ?? "";
+    state.listIndent = (continued === void 0 ? 0 : state.listIndent) + content.length - body.length;
+    return body;
+  }
+  if (continued !== void 0 || value.trim() === "") return content;
+  state.listIndent = 0;
+  return value;
+}
+function openingFence(line) {
+  const match = line.match(/^ {0,3}(`{3,}|~{3,})(.*)$/);
+  if (!match?.[1]) return void 0;
+  const marker = match[1][0];
+  const info = match[2]?.trim() ?? "";
+  if (marker === "`" && info.includes("`")) return void 0;
+  return {
+    marker,
+    size: match[1].length,
+    language: info.split(/\s+/, 1)[0]?.toLowerCase() ?? ""
+  };
+}
+function closesFence(line, fence) {
+  const match = line.match(/^ {0,3}(`+|~+)[ \t]*$/);
+  return Boolean(match?.[1]?.[0] === fence.marker && match[1].length >= fence.size);
+}
+function hasMarkdownFenceLanguage(source, languages) {
+  let open;
+  const container = { listIndent: 0 };
+  for (const line of source.split(/\r?\n/)) {
+    const content = containerContent(line, container);
+    if (open) {
+      if (closesFence(content, open)) open = void 0;
+      continue;
+    }
+    const fence = openingFence(content);
+    if (!fence) continue;
+    if (languages.has(fence.language)) return true;
+    open = fence;
+  }
+  return false;
+}
+function removeInlineCode(line) {
+  let result = "";
+  let index = 0;
+  while (index < line.length) {
+    if (line[index] !== "`") {
+      result += line[index];
+      index += 1;
+      continue;
+    }
+    let endOfOpening = index + 1;
+    while (line[endOfOpening] === "`") endOfOpening += 1;
+    const delimiter = line.slice(index, endOfOpening);
+    const closing = line.indexOf(delimiter, endOfOpening);
+    if (closing === -1) {
+      result += delimiter;
+      index = endOfOpening;
+      continue;
+    }
+    result += " ".repeat(closing + delimiter.length - index);
+    index = closing + delimiter.length;
+  }
+  return result;
+}
+function markdownProse(source) {
+  let open;
+  const container = { listIndent: 0 };
+  return source.split(/\r?\n/).map((line) => {
+    const content = containerContent(line, container);
+    if (open) {
+      if (closesFence(content, open)) open = void 0;
+      return "";
+    }
+    const fence = openingFence(content);
+    if (fence) {
+      open = fence;
+      return "";
+    }
+    if (/^(?: {4}|\t)/.test(content)) return "";
+    return removeInlineCode(content);
+  }).join("\n");
+}
+
+// src/math/index.ts
+var PLUGIN_VERSION = "3";
+function hasMathSyntax(source) {
+  const prose = markdownProse(source);
+  return hasMarkdownFenceLanguage(source, /* @__PURE__ */ new Set(["math"])) || /(^|[^\\])\$\$[\s\S]+?\$\$/.test(prose) || /(^|[^\\$])\$(?!\s)(?:\\.|[^$\n])+?(?<!\s)\$/.test(prose);
+}
+function math(options = {}) {
+  const resolved = {
+    throwOnError: options.throwOnError ?? false,
+    errorColor: options.errorColor ?? "#b42318",
+    trust: options.trust ?? false,
+    strict: options.strict ?? "warn",
+    macros: { ...options.macros ?? {} }
+  };
+  return defineMarkdownPlugin({
+    name: "math",
+    version: PLUGIN_VERSION,
+    cacheKey: resolved,
+    browserCompiler: { module: "@docfuse/plugins/math", exportName: "math", options: resolved },
+    appliesTo: ({ source }) => hasMathSyntax(source),
+    fenceLanguages: ["math"],
+    assets: { math: true },
+    remarkPlugins: [remarkMath],
+    rehypePlugins: [[rehypeKatex, resolved]]
+  });
+}
+export {
+  hasMathSyntax,
+  math
+};

package/dist/mermaid.d.ts

@@ -0,0 +1,10 @@
+import { MarkdownPlugin } from '@docfuse/markdown';
+
+interface MermaidOptions {
+    /** Optional browser ESM module. The bundled Mermaid runtime is used by default. */
+    moduleUrl?: string;
+}
+/** Enable Mermaid fenced code blocks as an opt-in official plugin. */
+declare function mermaid(options?: MermaidOptions): MarkdownPlugin;
+
+export { type MermaidOptions, mermaid };