@bdocs/plugin-math 1.0.0

package/LICENSE

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

package/dist/client/index.css

@@ -0,0 +1,7 @@
+@import url("https://cdn.jsdelivr.net/npm/katex@0.16.11/dist/katex.min.css");
+
+.math-block {
+  overflow-x: auto;
+  overflow-y: hidden;
+  padding: 0.5rem 0;
+}

package/dist/client/index.d.mts

@@ -0,0 +1,19 @@
+import * as _$react_jsx_runtime0 from "react/jsx-runtime";
+
+//#region src/client/Math.d.ts
+interface MathProps {
+  children: string;
+}
+declare function Math({
+  children
+}: MathProps): _$react_jsx_runtime0.JSX.Element;
+//#endregion
+//#region src/client/BlockMath.d.ts
+interface BlockMathProps {
+  children: string;
+}
+declare function BlockMath({
+  children
+}: BlockMathProps): _$react_jsx_runtime0.JSX.Element;
+//#endregion
+export { BlockMath, Math };

package/dist/client/index.mjs

@@ -0,0 +1,29 @@
+import { useMemo } from "react";
+import katex from "katex";
+import { jsx } from "react/jsx-runtime";
+//#region src/client/Math.tsx
+function Math({ children }) {
+	return /* @__PURE__ */ jsx("span", { dangerouslySetInnerHTML: { __html: useMemo(() => {
+		try {
+			return katex.renderToString(children, { displayMode: false });
+		} catch {
+			return children;
+		}
+	}, [children]) } });
+}
+//#endregion
+//#region src/client/BlockMath.tsx
+function BlockMath({ children }) {
+	return /* @__PURE__ */ jsx("div", {
+		className: "math-block my-6 flex justify-center overflow-x-auto",
+		dangerouslySetInnerHTML: { __html: useMemo(() => {
+			try {
+				return katex.renderToString(children, { displayMode: true });
+			} catch {
+				return children;
+			}
+		}, [children]) }
+	});
+}
+//#endregion
+export { BlockMath, Math };

package/dist/node/index.d.mts

@@ -0,0 +1,6 @@
+import { BoltdocsPlugin } from "boltdocs";
+
+//#region src/node/index.d.ts
+declare function mathPlugin(): BoltdocsPlugin;
+//#endregion
+export { mathPlugin as default };

package/dist/node/index.mjs

@@ -0,0 +1,47 @@
+//#region src/node/source-transform.ts
+function escapeJsString(content) {
+	return content.replace(/\\/g, "\\\\").replace(/"/g, "\\\"").replace(/\n/g, "\\n");
+}
+function preprocessMath(source) {
+	const placeholders = [];
+	let result = source.replace(/(`{3,})[\s\S]*?\1/g, (match) => {
+		placeholders.push(match);
+		return `\0MATH_PH_${placeholders.length - 1}\0`;
+	});
+	result = result.replace(/(`[^`\n]+`)/g, (match) => {
+		placeholders.push(match);
+		return `\0MATH_PH_${placeholders.length - 1}\0`;
+	});
+	result = result.replace(/^---[\s\S]*?---\n*/m, (match) => {
+		placeholders.push(match);
+		return `\0MATH_PH_${placeholders.length - 1}\0`;
+	});
+	result = result.replace(/\$\$([\s\S]*?)\$\$/g, (_, content) => {
+		return `<BlockMath>{"${escapeJsString(content.trim())}"}</BlockMath>`;
+	});
+	result = result.replace(/(?<!\$)\$(?!\$)(.+?)\$(?!\$)/g, (_, content) => {
+		return `<Math>{"${escapeJsString(content)}"}</Math>`;
+	});
+	while (result.includes("\0MATH_PH_")) result = result.replace(/\0MATH_PH_(\d+)\0/g, (_, idx) => {
+		return placeholders[parseInt(idx)];
+	});
+	return result;
+}
+function transformSource(_ctx, params) {
+	return { code: preprocessMath(params.code) };
+}
+//#endregion
+//#region src/node/index.ts
+function mathPlugin() {
+	return {
+		name: "boltdocs-plugin-math",
+		version: "0.1.0",
+		hooks: { transformSource },
+		components: {
+			Math: "@bdocs/plugin-math/client",
+			BlockMath: "@bdocs/plugin-math/client"
+		}
+	};
+}
+//#endregion
+export { mathPlugin as default };

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@bdocs/plugin-math",
+  "version": "1.0.0",
+  "description": "KaTeX math plugin for Boltdocs",
+  "main": "dist/node/index.js",
+  "module": "dist/node/index.mjs",
+  "types": "dist/node/index.d.ts",
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/node/index.d.mts",
+      "import": "./dist/node/index.mjs"
+    },
+    "./client": {
+      "types": "./dist/client/index.d.mts",
+      "import": "./dist/client/index.mjs"
+    },
+    "./style.css": "./dist/client/index.css"
+  },
+  "author": "Jesus Alcala",
+  "license": "MIT",
+  "type": "module",
+  "dependencies": {
+    "katex": "^0.16.11"
+  },
+  "peerDependencies": {
+    "@bdocs/dui": "^0.2.0",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "boltdocs": "2.9.0"
+  },
+  "devDependencies": {
+    "@types/katex": "^0.16.7",
+    "@types/node": "^22.0.0",
+    "@types/react": "^19.0.0",
+    "@types/react-dom": "^19.0.0",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "tsdown": "^0.21.7",
+    "typescript": "^5.9.3",
+    "boltdocs": "2.9.0"
+  },
+  "scripts": {
+    "build": "tsdown --config-loader unrun && node -e \"require('fs').cpSync('src/client/index.css', 'dist/client/index.css')\"",
+    "dev": "tsdown --watch --config-loader unrun",
+    "test": "vitest run"
+  }
+}