remons-render-markdown 2.0.1-beta.1 → 2.0.1-beta.4

package/dist/utils/cdn.d.ts

@@ -1,10 +1,17 @@
-/** 默认 CDN 配置 */
+/** 默认 CDN 配置（可通过 registerCdn 覆盖，供库使用方全局定制） */
 declare const defaultCdn: Record<string, string>;
+/**
+ * 注册/覆盖全局默认 CDN 地址（初始化时调用一次，全局生效）
+ * @param name CDN 名称，如 'mermaid'
+ * @param url 完整脚本 URL；传空字符串视为删除该注册
+ */
+export declare function registerCdn(name: string, url: string): void;
 /**
  * 获取 CDN URL
  * @param name CDN 名称，如 'mermaid'
  * @param cdn 外部传入的 CDN 配置，如 { mermaid: 'https://...' }
  * @returns CDN URL，优先使用外部传入的配置
+ * @throws 当外部配置与默认配置均无该名称时抛错，避免静默加载失败
  */
 export declare function getCdnUrl(name: string, cdn?: Record<string, string>): string;
 export default defaultCdn;

package/dist/utils/dom-contract.d.ts

@@ -0,0 +1,24 @@
+/**
+ * 跨模块共享的 DOM 契约常量（纯常量、无任何依赖）。
+ *
+ * 单独成模块的原因：这些标记同时被三方读写——
+ * - useIncrementalRender（morphdom diff 时据此保护 / 摘除节点）
+ * - RenderMarkdown（代码块工具栏、源码隐藏 class）
+ * - MermaidRenderer 的 DOM 扫描（图表挂载点身份与复用判据）
+ * 若各自定义字面量，任何一处改名都会静默破坏另外两处的行为，且不会报错。
+ */
+/**
+ * 标记「由 JS 动态插入、需跨增量渲染保留」的节点：
+ * 带此属性的节点在 morphdom diff 时不会被移除（如插件容器内的收起按钮、图表挂载点）。
+ */
+export declare const MD_PERSIST_ATTR = "data-md-persist";
+/** 已挂载节点的业务身份 key：morphdom 与插件恢复逻辑据此跨渲染匹配同一个节点 */
+export declare const MD_KEY_ATTR = "data-md-key";
+/** Mermaid 图表挂载点的 class（React Root 挂在这个 div 上） */
+export declare const MERMAID_ROOT_CLASS = "mermaid-react-root";
+/**
+ * 挂载点上记录的「当前展示的是哪份源码」指纹。
+ * 源码没变就直接复用这个节点（不重挂、不重渲染），变了才更新 props——
+ * 这是流式场景下图表不闪白、不丢缩放/全屏状态的关键。
+ */
+export declare const MERMAID_SRC_ATTR = "data-md-mermaid-src";

package/dist/utils/driver.d.ts

@@ -15,6 +15,9 @@ type Data = Array<{
 /**
  * 用于渲染引导
  * @param data 引导数据，数组结构，每一项为一个引导
+ *
+ * 语义：同一 data 引用只完整播放一次；播放过程中重复调用会被忽略（不再中途改写队列数据，
+ * 避免旧实现的 latestData 竞态：播放中更新 data 导致步骤与队列错位）。
  */
 export default function driverRender(data: Data): void;
 export {};

package/dist/utils/preload.d.ts

@@ -1,5 +1,5 @@
 /**
- * 获取 jsMap（默认配置）
+ * 可预加载的资源名→URL 映射（引用全局默认 CDN 配置，registerCdn 后自动生效）
  */
 export declare const jsMap: Record<string, string>;
 export declare function preload(cdnName: string | string[]): void;

package/package.json

@@ -1,95 +1,93 @@
-{
-  "name": "remons-render-markdown",
-  "version": "2.0.1-beta.1",
-  "description": "一个基于 React 的 Markdown 渲染组件，支持 GFM（GitHub Flavored Markdown）、代码高亮、Mermaid 图表、Tabs 渲染等功能。",
-  "type": "module",
-  "main": "./dist/index.mjs",
-  "module": "./dist/index.mjs",
-  "types": "./dist/index.d.ts",
-  "exports": {
-    ".": {
-      "import": "./dist/index.mjs",
-      "types": "./dist/index.d.ts"
-    },
-    "./dist/index.css": "./dist/index.css"
-  },
-  "files": [
-    "dist"
-  ],
-  "scripts": {
-    "build": "vite build",
-    "build:analyze": "vite-bundle-visualizer --output dist/stats.html --open",
-    "dev": "vite",
-    "lint": "eslint . --ext .ts,.tsx",
-    "format": "prettier --write .",
-    "changeset": "changeset",
-    "version": "changeset version",
-    "release": "changeset publish"
-  },
-  "keywords": [
-    "markdown",
-    "react",
-    "render",
-    "gfm",
-    "mermaid"
-  ],
-  "author": "remons",
-  "license": "MIT",
-  "peerDependencies": {
-    "@ant-design/icons": ">=5.0.0",
-    "react": ">=19.0.0",
-    "react-dom": ">=19.0.0"
-  },
-  "peerDependenciesMeta": {
-    "@ant-design/icons": {
-      "optional": false
-    }
-  },
-  "devDependencies": {
-    "@ant-design/icons": "^6.3.2",
-    "@changesets/cli": "^2.27.0",
-    "@types/react": "^19.0.0",
-    "@types/react-dom": "^19.0.0",
-    "@typescript-eslint/eslint-plugin": "^6.0.0",
-    "@typescript-eslint/parser": "^6.0.0",
-    "@vitejs/plugin-react": "^4.3.0",
-    "eslint": "^8.0.0",
-    "less": "^4.2.0",
-    "prettier": "^3.0.0",
-    "react": "^19.0.0",
-    "react-dom": "^19.0.0",
-    "terser": "^5.50.0",
-    "typescript": "^5.3.0",
-    "vite": "^8.0.0",
-    "vite-bundle-visualizer": "^1.2.1",
-    "vite-plugin-commonjs": "^0.10.4",
-    "vite-plugin-dts": "^4.0.0"
-  },
-  "publishConfig": {
-    "registry": "https://registry.npmjs.org/",
-    "access": "public"
-  },
-  "dependencies": {
-    "@mdit/plugin-alert": "^2.0.0",
-    "@mdit/plugin-tab": "^2.0.0",
-    "@panzoom/panzoom": "^4.6.2",
-    "classnames": "^2.5.1",
-    "driver.js": "^1.8.0",
-    "highlight.js": "^11.12.0",
-    "lodash.clonedeep": "^4.5.0",
-    "markdown-it": "^15.0.1",
-    "markdown-it-anchor": "^9.2.1",
-    "markdown-it-github-alerts": "^1.0.1",
-    "markdown-it-link-attributes": "^4.0.1",
-    "markdown-it-task-lists": "^2.1.1",
-    "markdown-it-toc-done-right": "^4.2.0",
-    "methods-r": "^2.0.0-rc.1",
-    "react": "^19.3.0",
-    "react-dom": "^19.3.0",
-    "viewerjs": "^1.11.9"
-  },
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/liRemons/render-markdown.git"
-  }
-}
+{
+  "name": "remons-render-markdown",
+  "version": "2.0.1-beta.4",
+  "description": "一个基于 React 的 Markdown 渲染组件，支持 GFM（GitHub Flavored Markdown）、代码高亮、Mermaid 图表、Tabs 渲染等功能。",
+  "type": "module",
+  "main": "./dist/index.mjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs"
+    },
+    "./style.css": "./dist/index.css",
+    "./dist/index.css": "./dist/index.css"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "vite build --config vite.lib.config.ts",
+    "build:analyze": "vite-bundle-visualizer --config vite.lib.config.ts --output dist/stats.html --open",
+    "dev": "vite",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint . --ext .ts,.tsx",
+    "format": "prettier --write .",
+    "changeset": "changeset",
+    "version": "changeset version",
+    "release": "changeset publish"
+  },
+  "keywords": [
+    "markdown",
+    "react",
+    "render",
+    "gfm",
+    "mermaid"
+  ],
+  "author": "remons",
+  "license": "MIT",
+  "peerDependencies": {
+    "@ant-design/icons": ">=5.0.0",
+    "highlight.js": ">=11.0.0",
+    "react": ">=18.0.0",
+    "react-dom": ">=18.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@ant-design/icons": {
+      "optional": false
+    }
+  },
+  "devDependencies": {
+    "@ant-design/icons": "^6.3.2",
+    "@changesets/cli": "^2.27.0",
+    "@types/react": "^18.3.0",
+    "@types/react-dom": "^18.3.0",
+    "@typescript-eslint/eslint-plugin": "^6.0.0",
+    "@typescript-eslint/parser": "^6.0.0",
+    "@vitejs/plugin-react": "^4.3.0",
+    "eslint": "^8.0.0",
+    "highlight.js": "^11.12.0",
+    "less": "^4.2.0",
+    "prettier": "^3.0.0",
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1",
+    "terser": "^5.50.0",
+    "typescript": "^5.3.0",
+    "vite": "^8.0.0",
+    "vite-bundle-visualizer": "^1.2.1",
+    "vite-plugin-dts": "^4.0.0"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/",
+    "access": "public"
+  },
+  "dependencies": {
+    "@mdit/plugin-tab": "^2.0.0",
+    "@panzoom/panzoom": "^4.6.2",
+    "classnames": "^2.5.1",
+    "driver.js": "^1.8.0",
+    "markdown-it": "^15.0.1",
+    "markdown-it-anchor": "^9.2.1",
+    "markdown-it-github-alerts": "^1.0.1",
+    "markdown-it-link-attributes": "^4.0.1",
+    "markdown-it-task-lists": "^2.1.1",
+    "methods-r": "^2.0.0-rc.1",
+    "morphdom": "^2.7.8",
+    "photoswipe": "^5.4.4"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/liRemons/render-markdown.git"
+  }
+}