dsh-md-plus 0.4.2 → 0.4.4

package/CHANGELOG.md

@@ -1,6 +1,20 @@
 # 更新日志
 
-## 0.4.2 —— 未发布
+## 0.4.4 —— 未发布
+
+- 修复表格折叠按钮在低阈值和展开/收起后漂移、消失的问题：补齐表格折叠高度规则、重置滚动位置，并给按钮阴影留出空间。
+
+## 0.4.3 —— 2026-10-30
+
+- 修复补高亮语言映射：`hbs` / `jade` / `tscn` / `tres` 分别使用 handlebars / pug / gdresource 语法着色。
+- 修复 Mermaid 12.1 在占位标签兜底路径下的图种识别：补充 `radar-beta`、`treemap-beta`、`venn-beta`、`ishikawa-beta`、`wardley-beta`、`cynefin-beta`、`treeView-beta`、`flowchart-elk` 等，并去掉无效裸关键字的误判。
+- 修复插件卸载后 debounce 扫描重新插入按钮、设置入口和折叠控件的问题，同时清理 `data-md-plus-zoom` 属性。
+- 修复 localStorage 不可用时设置保存和配色切换连当前会话都不生效的问题。
+- 修复运行时路由 ETag 只依赖文件大小和 mtime、内容更新后仍可能返回 304 的问题。
+- 同步能力展示页和 README 预览图到当前 DSH 样式，并把所有版本引用更新为 0.4.3。
+- 测试补到 78 条，新增别名语言、Mermaid 新图种、卸载清理、localStorage 降级和 ETag 回归用例。
+
+## 0.4.2 —— 2026-10-30
 
 - 修复鼠标悬浮表格或折叠内容时吞掉页面滚轮：移除表格容器的 `overscroll-behavior` containment，折叠态改为保留横向滚动、纵向 `overflow-y: clip`，并覆盖 DSH 宿主 `.tableScroll` 自带的横向 containment。
 - 修复宽表横向滚动条出现 / 消失时鼠标移入移出表格造成的上下跳动：取消 hover 阶段的 padding 切换，固定底部留白。

package/README.md

@@ -27,11 +27,13 @@ dsh plugin --profile desktop remove dsh-md-plus
 ```powershell
 npm install       # 顺带跑 prepare → build
 npm run build     # 产出 lib/ 下四个文件
-npm run check     # 语法检查 + 73 条测试（先 build 再跑，check 不含 build）
+npm run check     # 语法检查 + 78 条测试（先 build 再跑，check 不含 build）
 npm run preview   # 生成 preview.html（含真渲出来的 mermaid 图）
 npm run shot      # 用 headless Chrome 把 preview.html 截成 docs/preview.png
 ```
 
+`npm run preview` / `scripts/showcase.mjs` 需要读取 DSH 安装目录里的主题和前端资源；如果本机 DSH 是 `app.asar` 包，请先解包到目录，并把 `DSH_APP_DIR` 指向该目录。
+
 ## 已知限制
 
 - DSH 0.2.1-rc.4 的头部语言名由宿主决定：不认识的围栏只显示占位文案「代码块」。插件会从宿主的 React fiber 里兜底读取真实语言，读不到时才退回正文嗅探；宿主改 React 结构后这条兜底可能失效。

package/lib/client.js

@@ -178,6 +178,8 @@ window.__ModuleLoader__.load({
     var STYLE_ATTR = "data-md-plus-style";
     var RUNTIME_ATTR = "data-md-plus-runtime";
     var DEBOUNCE_MS = 160;
+    var memorySettings = null;
+    var memoryTheme = null;
     function readSettings() {
       var settings = { ...DEFAULT_SETTINGS };
       try {
@@ -194,11 +196,14 @@ window.__ModuleLoader__.load({
             if (Number.isFinite(value) && value >= 0) settings[key] = Math.min(4e3, Math.round(value));
           }
         }
+        memorySettings = { ...settings };
       } catch {
+        if (memorySettings !== null) return { ...DEFAULT_SETTINGS, ...memorySettings };
       }
       return settings;
     }
     function saveSettings(next) {
+      memorySettings = { ...next };
       try {
         window.localStorage.setItem(SETTINGS_KEY, JSON.stringify(next));
       } catch {
@@ -331,10 +336,10 @@ window.__ModuleLoader__.load({
       "gradle"
     ]);
     var MMD_LANGS = /* @__PURE__ */ new Set(["mermaid", "mermaidjs", "mmd"]);
-    var MMD_FLOW = /^\s*(flowchart|graph)(?:\s+(?:TD|TB|BT|RL|LR))?\s*;?\s*$/i;
-    var MMD_PIE = /^\s*pie(?:\s+title\b.*)?\s*;?\s*$/i;
+    var MMD_FLOW = /^\s*(flowchart(?:-elk)?|graph)(?:\s+(?:TD|TB|BT|RL|LR))?\s*;?\s*$/i;
+    var MMD_PIE = /^\s*pie(?:\s+(?:showData|title)\b.*)?\s*;?\s*$/i;
     var MMD_GIT = /^\s*gitGraph(?:\s+(?:LR|TB|BT|RL))?:?\s*;?\s*$/i;
-    var MMD_SINGLE = /^\s*(sequenceDiagram|classDiagram|stateDiagram(?:-v2)?|erDiagram|journey|gantt|mindmap|timeline|quadrantChart|xychart-beta|sankey-beta|block-beta|packet-beta|architecture-beta|usecase-beta|agentflow-beta|C4Context|requirementDiagram|kanban|radar|treemap|venn|ishikawa|wardley|cynefin|treeView|zenuml)\s*;?\s*$/i;
+    var MMD_SINGLE = /^\s*(sequenceDiagram|classDiagram|stateDiagram(?:-v2)?|erDiagram|journey|gantt|mindmap|timeline|quadrantChart|xychart-beta|sankey-beta|block-beta|packet-beta|architecture-beta|usecase-beta|agentflow-beta|C4Context|requirementDiagram|kanban|radar-beta|treemap(?:-beta)?|venn-beta|ishikawa(?:-beta)?|wardley-beta|cynefin-beta|treeView-beta|info|eventmodeling|swimlane-beta|railroad-beta|railroad-abnf-beta|railroad-ebnf-beta|railroad-peg-beta)\s*;?\s*$/i;
     function icon(paths) {
       var svg = "<svg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24' fill='none' stroke='black' stroke-width='2' stroke-linecap='round' stroke-linejoin='round'>" + paths + "</svg>";
       return 'url("data:image/svg+xml,' + encodeURIComponent(svg) + '")';
@@ -446,7 +451,7 @@ window.__ModuleLoader__.load({
       // 用 clip 而不是 hidden：hidden 会建立隐形滚动容器，鼠标在折叠内容上滚轮会被它吞掉。
       "." + FOLD_CLASS + "[" + FOLD_ATTR + '="on"]{max-height:var(--md-plus-fold-max-height);overflow:clip}',
       "." + FOLD_BTN_CLASS + "{display:block;white-space:nowrap;margin:8px auto 0;padding:4px 12px;border:1px solid var(--dsw-alias-border-secondary,rgb(127 127 127 / 22%));border-radius:999px;background:var(--dsw-alias-bg-base,#fff);color:var(--dsw-alias-label-primary);font:12px/18px var(--dsw-font-family-sans,system-ui,sans-serif);cursor:pointer;box-shadow:0 2px 8px rgb(0 0 0 / 12%);z-index:2}",
-      "." + FOLD_CLASS + "[" + FOLD_ATTR + '="on"] .' + FOLD_BTN_CLASS + "{position:absolute;left:50%;bottom:8px;transform:translateX(-50%);margin:0}",
+      "." + FOLD_CLASS + "[" + FOLD_ATTR + '="on"] .' + FOLD_BTN_CLASS + "{position:absolute;left:50%;bottom:12px;transform:translateX(-50%);margin:0}",
       // ── 图片点击放大 ────────────────────────────────────────────────
       '[class*="_markdown_"] img{cursor:zoom-in}',
       "." + IMG_MODAL_CLASS + "{position:fixed;inset:0;z-index:2147483000;display:flex;align-items:center;justify-content:center;padding:calc(var(--dsh-windows-titlebar-height,0px) + 16px) 24px 24px;background:rgb(0 0 0 / 72%)}",
@@ -524,7 +529,9 @@ window.__ModuleLoader__.load({
       TABLE + ".md-table-wide > table{width:100%;max-width:none;min-width:max-content}",
       // 折叠态保留横向滚动，但纵向必须 clip；横向滚动容器只有在
       // overscroll-behavior:auto 时才会把纵向滚轮交还给页面。
-      TABLE + "." + FOLD_CLASS + "[" + FOLD_ATTR + '="on"]{overflow-x:auto;overflow-y:clip}'
+      // 这里同时写明 min/max-height：基础表格规则的 max-height 特异性更高，不补会压过设置值；
+      // 最小高度保证极低阈值下「展开」按钮仍完整可见。
+      TABLE + "." + FOLD_CLASS + "[" + FOLD_ATTR + '="on"]{min-height:48px;max-height:var(--md-plus-fold-max-height);overflow-x:auto;overflow-y:clip}'
     ].join("\n");
     var scripts = /* @__PURE__ */ new Map();
     var pending = /* @__PURE__ */ new Set();
@@ -533,6 +540,7 @@ window.__ModuleLoader__.load({
     var rescanQueued = false;
     var injected = /* @__PURE__ */ new Set();
     var diagramSeq = 0;
+    var disposed = false;
     function injectStyle() {
       if (document.querySelector("style[" + STYLE_ATTR + "]") !== null) return;
       var tag = document.createElement("style");
@@ -675,6 +683,7 @@ window.__ModuleLoader__.load({
       ) != null;
     }
     function schedule(block) {
+      if (disposed) return;
       if (block !== void 0) pending.add(block);
       else rescanQueued = true;
       if (timer !== null) return;
@@ -682,6 +691,7 @@ window.__ModuleLoader__.load({
     }
     function flush() {
       timer = null;
+      if (disposed) return;
       if (rescanQueued) {
         rescanQueued = false;
         for (const block of document.querySelectorAll(BLOCK)) pending.add(block);
@@ -843,7 +853,7 @@ window.__ModuleLoader__.load({
       if (lang === "") return;
       if (DSH_LANGS.has(lang)) return;
       var api = await loadScript(HL_URL, HL_GLOBAL);
-      if (api === null || !api.supports(lang)) return;
+      if (disposed || api === null || !api.supports(lang)) return;
       if (!pre.isConnected) return;
       var code = pre.textContent ?? "";
       if (code.trim() === "") return;
@@ -855,6 +865,7 @@ window.__ModuleLoader__.load({
       } catch {
         return;
       }
+      if (disposed) return;
       if (typeof html !== "string" || html === "") return;
       if (!pre.isConnected || (pre.textContent ?? "") !== code) {
         schedule(block);
@@ -879,8 +890,13 @@ window.__ModuleLoader__.load({
     function getMermaidTheme() {
       try {
         var saved = window.localStorage.getItem(THEME_KEY);
-        if (saved !== null && THEME_ORDER.indexOf(saved) !== -1) return saved;
+        if (saved !== null && THEME_ORDER.indexOf(saved) !== -1) {
+          memoryTheme = saved;
+          return saved;
+        }
+        memoryTheme = null;
       } catch {
+        if (memoryTheme !== null) return memoryTheme;
       }
       return "blue";
     }
@@ -898,6 +914,7 @@ window.__ModuleLoader__.load({
       var current = getMermaidTheme();
       var index = THEME_ORDER.indexOf(current);
       var next = THEME_ORDER[(index + 1) % THEME_ORDER.length];
+      memoryTheme = next;
       try {
         window.localStorage.setItem(THEME_KEY, next);
       } catch {
@@ -911,16 +928,18 @@ window.__ModuleLoader__.load({
       var key = "mmd\0" + code;
       if (block.getAttribute(KEY_ATTR) === key) return;
       var api = await loadScript(MMD_URL, MMD_GLOBAL);
-      if (api === null) return;
+      if (disposed || api === null) return;
       if (!pre.isConnected) return;
       var svg;
       try {
         var dark = document.body.hasAttribute("data-ds-dark-theme");
         svg = await api.render("dsh-md-plus-mmd-" + ++diagramSeq, code, dark, getMermaidTheme());
       } catch (error) {
+        if (disposed) return;
         failDiagram(block, content, pre, key, error);
         return;
       }
+      if (disposed) return;
       if (typeof svg !== "string" || svg === "") return;
       if (svg.includes('aria-roledescription="error"')) {
         failDiagram(block, content, pre, key, new Error("mermaid \u8FD4\u56DE\u7684\u662F\u9519\u8BEF\u5361\u7247"));
@@ -1083,6 +1102,7 @@ window.__ModuleLoader__.load({
         target.setAttribute(FOLD_ATTR, "on");
         target.classList.add(FOLD_CLASS);
         target.style.setProperty("--md-plus-fold-max-height", limit + "px");
+        if (target.hasAttribute(TABLE_DONE_ATTR)) target.scrollTop = 0;
         var button = document.createElement("button");
         button.type = "button";
         button.className = FOLD_BTN_CLASS;
@@ -1099,6 +1119,7 @@ window.__ModuleLoader__.load({
         button.addEventListener("click", () => {
           var folded = target.getAttribute(FOLD_ATTR) === "on";
           target.setAttribute(FOLD_ATTR, folded ? "off" : "on");
+          if (target.hasAttribute(TABLE_DONE_ATTR)) target.scrollTop = 0;
           button.textContent = folded ? t("foldClose") : t("foldOpen");
           button.setAttribute("aria-expanded", folded ? "true" : "false");
           sync?.();
@@ -1394,6 +1415,7 @@ window.__ModuleLoader__.load({
           foldTable: readNumber(foldTable, DEFAULT_SETTINGS.foldTable),
           foldDiagram: readNumber(foldDiagram, DEFAULT_SETTINGS.foldDiagram)
         });
+        memoryTheme = themeSelect.value;
         try {
           window.localStorage.setItem(THEME_KEY, themeSelect.value);
         } catch {
@@ -1626,6 +1648,7 @@ window.__ModuleLoader__.load({
     function apply0(ctx) {
       if (typeof document === "undefined") return;
       ctx.effect(() => {
+        disposed = false;
         injectStyle();
         applyCodeFontSize();
         ensureSettingsButton();
@@ -1641,6 +1664,13 @@ window.__ModuleLoader__.load({
         });
         schedule();
         return () => {
+          disposed = true;
+          if (timer !== null) {
+            window.clearTimeout(timer);
+            timer = null;
+          }
+          pending.clear();
+          rescanQueued = false;
           observer.disconnect();
           document.removeEventListener("click", onDocumentClick, true);
           for (const node of injected) node.remove();
@@ -1650,7 +1680,7 @@ window.__ModuleLoader__.load({
           for (const node of document.querySelectorAll("." + FOLD_BTN_CLASS)) node.remove();
           for (const node of document.querySelectorAll("[" + FOLD_ATTR + "]")) resetFold(node);
           for (const node of document.querySelectorAll("." + TABLE_TOOLS_CLASS)) node.remove();
-          for (const attr of [DONE_ATTR, KEY_ATTR, WRAP_ATTR, MMD_ATTR, TABLE_DONE_ATTR, "data-md-plus-lang"]) {
+          for (const attr of [DONE_ATTR, KEY_ATTR, WRAP_ATTR, MMD_ATTR, TABLE_DONE_ATTR, "data-md-plus-lang", ZOOM_ATTR]) {
             for (const node of document.querySelectorAll("[" + attr + "]")) node.removeAttribute(attr);
           }
           for (const node of document.querySelectorAll("[data-md-plus-original-label]")) {