This is an automated email from the ASF dual-hosted git repository.

robinv8 pushed a commit to branch fix/formula-observer-313
in repository https://gitbox.apache.org/repos/asf/answer-plugins.git

commit 35aad90661c2ee6b9c58f0cba9eb084903472f66
Author: robin <[email protected]>
AuthorDate: Tue Nov 10 15:41:38 2026 +0800

    fix(editor-formula): prevent self-triggered rendering loops
---
 editor-formula/README.md            |  13 ++
 editor-formula/hooks.ts             |  28 ++--
 editor-formula/package.json         |   1 +
 editor-formula/pnpm-lock.yaml       | 272 ++++++++++++++++++++++++++++++++++++
 editor-formula/tests/hooks.test.cjs | 143 +++++++++++++++++++
 5 files changed, 447 insertions(+), 10 deletions(-)

diff --git a/editor-formula/README.md b/editor-formula/README.md
index 618c1b2..6ee970a 100644
--- a/editor-formula/README.md
+++ b/editor-formula/README.md
@@ -1,3 +1,16 @@
 # formula plugin
 This plugin is used to extend the toolbar of the markdown editor of the answer 
project.
 It provides a toolbar button to insert a formula into the markdown editor.
+
+## Regression tests
+
+After installing the locked dependencies with pnpm 8, run:
+
+```sh
+node --test tests/hooks.test.cjs
+```
+
+The tests execute the real hook with React, jsdom, and the locked KaTeX 
version.
+They cover incomplete/mixed delimiters, subsequent edits, text-node updates,
+ref initialization, StrictMode, target replacement, and observer cleanup. A
+callback limit makes a self-triggering observer fail instead of hanging Node.
diff --git a/editor-formula/hooks.ts b/editor-formula/hooks.ts
index 16037e5..6376b1b 100644
--- a/editor-formula/hooks.ts
+++ b/editor-formula/hooks.ts
@@ -19,7 +19,7 @@
 
 import { useEffect, RefObject } from 'react';
 
-// @ts-ignore
+// @ts-expect-error KaTeX does not declare its source auto-render entry.
 import katexRender from 'katex/contrib/auto-render/auto-render';
 
 const useRenderFormula = (element: HTMLElement | RefObject<HTMLElement> | 
null) => {
@@ -53,19 +53,27 @@ const useRenderFormula = (element: HTMLElement | 
RefObject<HTMLElement> | null)
     } else {
       targetElement = element.current;
     }
-    render(targetElement);
-    const observer = new MutationObserver(() => {
-      render(targetElement);
-    });
+    if (!targetElement) {
+      return;
+    }
 
-    observer.observe(targetElement, {
-      childList: true,
-      subtree: true,
-    });
+    const options = { childList: true, characterData: true, subtree: true };
+    const renderAndObserve = () => {
+      // KaTeX can replace text nodes even when no complete formula is found.
+      // Do not observe those writes: they would schedule another render 
forever.
+      observer.disconnect();
+      try {
+        render(targetElement);
+      } finally {
+        observer.observe(targetElement, options);
+      }
+    };
+    const observer = new MutationObserver(renderAndObserve);
+    renderAndObserve();
 
     return () => {
       observer.disconnect();
-    }
+    };
   }, [element]);
 };
 
diff --git a/editor-formula/package.json b/editor-formula/package.json
index d56d614..65cae0d 100644
--- a/editor-formula/package.json
+++ b/editor-formula/package.json
@@ -36,6 +36,7 @@
     "eslint": "^8.45.0",
     "eslint-plugin-react-hooks": "^4.6.0",
     "eslint-plugin-react-refresh": "^0.4.3",
+    "jsdom": "26.1.0",
     "typescript": "5.4.2",
     "vite": "^4.4.5",
     "vite-plugin-css-injected-by-js": "^3.3.0",
diff --git a/editor-formula/pnpm-lock.yaml b/editor-formula/pnpm-lock.yaml
index 2199ebf..1d9c88c 100644
--- a/editor-formula/pnpm-lock.yaml
+++ b/editor-formula/pnpm-lock.yaml
@@ -43,6 +43,9 @@ devDependencies:
   eslint-plugin-react-refresh:
     specifier: ^0.4.3
     version: 0.4.7([email protected])
+  jsdom:
+    specifier: 26.1.0
+    version: 26.1.0
   typescript:
     specifier: 5.4.2
     version: 5.4.2
@@ -58,6 +61,16 @@ devDependencies:
 
 packages:
 
+  /@asamuzakjp/[email protected]:
+    resolution: {integrity: 
sha512-K1A6z8tS3XsmCMM86xoWdn7Fkdn9m6RSVtocUrJYIwZnFVkng/PvkEoWtOWmP+Scc6saYWHWZYbndEEXxl24jw==}
+    dependencies:
+      '@csstools/css-calc': 
2.1.4(@csstools/[email protected])(@csstools/[email protected])
+      '@csstools/css-color-parser': 
3.1.0(@csstools/[email protected])(@csstools/[email protected])
+      '@csstools/css-parser-algorithms': 3.0.5(@csstools/[email protected])
+      '@csstools/css-tokenizer': 3.0.4
+      lru-cache: 10.4.3
+    dev: true
+
   /@babel/[email protected]:
     resolution: {integrity: 
sha512-7MbVt6xrwFQbunH2DNQsAP5sTGxfqQtErvBIvIMi6EQnbgUOuVYanvREcmFrOPhoXBrTtjhhP+lW+o5UfK+tDg==}
     engines: {node: '>=6.9.0'}
@@ -92,6 +105,49 @@ packages:
       to-fast-properties: 2.0.0
     dev: true
 
+  /@csstools/[email protected]:
+    resolution: {integrity: 
sha512-S11EXWJyy0Mz5SYvRmY8nJYTFFd1LCNV+7cXyAgQtOOuzb4EsgfqDufL+9esx72/eLhsRdGZwaldu/h+E4t4BA==}
+    engines: {node: '>=18'}
+    dev: true
+
+  
/@csstools/[email protected](@csstools/[email protected])(@csstools/[email protected]):
+    resolution: {integrity: 
sha512-3N8oaj+0juUw/1H3YwmDDJXCgTB1gKU6Hc/bB502u9zR0q2vd786XJH9QfrKIEgFlZmhZiq6epXl4rHqhzsIgQ==}
+    engines: {node: '>=18'}
+    peerDependencies:
+      '@csstools/css-parser-algorithms': ^3.0.5
+      '@csstools/css-tokenizer': ^3.0.4
+    dependencies:
+      '@csstools/css-parser-algorithms': 3.0.5(@csstools/[email protected])
+      '@csstools/css-tokenizer': 3.0.4
+    dev: true
+
+  
/@csstools/[email protected](@csstools/[email protected])(@csstools/[email protected]):
+    resolution: {integrity: 
sha512-nbtKwh3a6xNVIp/VRuXV64yTKnb1IjTAEEh3irzS+HkKjAOYLTGNb9pmVNntZ8iVBHcWDA2Dof0QtPgFI1BaTA==}
+    engines: {node: '>=18'}
+    peerDependencies:
+      '@csstools/css-parser-algorithms': ^3.0.5
+      '@csstools/css-tokenizer': ^3.0.4
+    dependencies:
+      '@csstools/color-helpers': 5.1.0
+      '@csstools/css-calc': 
2.1.4(@csstools/[email protected])(@csstools/[email protected])
+      '@csstools/css-parser-algorithms': 3.0.5(@csstools/[email protected])
+      '@csstools/css-tokenizer': 3.0.4
+    dev: true
+
+  /@csstools/[email protected](@csstools/[email protected]):
+    resolution: {integrity: 
sha512-DaDeUkXZKjdGhgYaHNJTV9pV7Y9B3b644jCLs9Upc3VeNGg6LWARAT6O+Q+/COo+2gg/bM5rhpMAtf70WqfBdQ==}
+    engines: {node: '>=18'}
+    peerDependencies:
+      '@csstools/css-tokenizer': ^3.0.4
+    dependencies:
+      '@csstools/css-tokenizer': 3.0.4
+    dev: true
+
+  /@csstools/[email protected]:
+    resolution: {integrity: 
sha512-Vd/9EVDiu6PPJt9yAh6roZP6El1xHrdvIVGjyBsHR0RYwNHgL7FJPyIIW4fANJNG6FtyZfvlRPpFI4ZM/lubvw==}
+    engines: {node: '>=18'}
+    dev: true
+
   /@esbuild/[email protected]:
     resolution: {integrity: 
sha512-Nz4rJcchGDtENV0eMKUNa6L12zz2zBDXuhj/Vjh18zGqB44Bi7MBMSXjgunJgjRhCmKOjnPuZp4Mb6OKqtMHLQ==}
     engines: {node: '>=12'}
@@ -925,6 +981,11 @@ packages:
     hasBin: true
     dev: true
 
+  /[email protected]:
+    resolution: {integrity: 
sha512-MnA+YT8fwfJPgBx3m60MNqakm30XOkyIoH1y6huTQvC0PwZG7ki8NacLBcrPbNoo8vEZy7Jpuk7+jMO+CUovTQ==}
+    engines: {node: '>= 14'}
+    dev: true
+
   /[email protected]:
     resolution: {integrity: 
sha512-j3fVLgvTo527anyYyJOGTYJbG+vnnQYvE0m5mmkc1TK+nxAppkCLMIL0aZ4dblVCNoGShhm+kzE4ZUykBoMg4g==}
     dependencies:
@@ -1042,10 +1103,26 @@ packages:
       which: 2.0.2
     dev: true
 
+  /[email protected]:
+    resolution: {integrity: 
sha512-2z+rWdzbbSZv6/rhtvzvqeZQHrBaqgogqt85sqFNbabZOuFbCVFb8kPeEtZjiKkbrm395irpNKiYeFeLiQnFPg==}
+    engines: {node: '>=18'}
+    dependencies:
+      '@asamuzakjp/css-color': 3.2.0
+      rrweb-cssom: 0.8.0
+    dev: true
+
   /[email protected]:
     resolution: {integrity: 
sha512-M1uQkMl8rQK/szD0LNhtqxIPLpimGm8sOBwU7lLnCpSbTyY3yeU1Vc7l4KT5zT4s/yOxHH5O7tIuuLOCnLADRw==}
     dev: false
 
+  /[email protected]:
+    resolution: {integrity: 
sha512-ZYP5VBHshaDAiVZxjbRVcFJpc+4xGgT0bK3vzy1HLN8jTO975HEbuYzZJcHoQEY5K1a0z8YayJkyVETa08eNTg==}
+    engines: {node: '>=18'}
+    dependencies:
+      whatwg-mimetype: 4.0.0
+      whatwg-url: 14.2.0
+    dev: true
+
   /[email protected]:
     resolution: {integrity: 
sha512-e/1zu3xH5MQryN2zdVaF0OrdNLUbvWxzMbi+iNA6Bky7l1RoP8a2fIbRocyHclXt/arDrrR6lL3TqFD9pMQTsg==}
     dev: true
@@ -1062,6 +1139,10 @@ packages:
       ms: 2.1.2
     dev: true
 
+  /[email protected]:
+    resolution: {integrity: 
sha512-YpgQiITW3JXGntzdUmyUR1V812Hn8T1YVXhCu+wO3OpS4eU9l4YdD3qjyiKdV6mvV29zapkMeD390UVEf2lkUg==}
+    dev: true
+
   /[email protected]:
     resolution: {integrity: 
sha512-oIPzksmTg4/MriiaYGO+okXDT7ztn/w3Eptv/+gSIdMdKsJo0u4CfYNFJPy+4SKMuCqGw2wxnA+URMg3t8a/bQ==}
     dev: true
@@ -1097,6 +1178,11 @@ packages:
     engines: {node: '>=0.12'}
     dev: true
 
+  /[email protected]:
+    resolution: {integrity: 
sha512-aN97NXWF6AWBTahfVOIrB/NShkzi5H7F9r1s9mD3cDj4Ko5f2qhhVoYMibXF7GlLveb/D2ioWay8lxI97Ven3g==}
+    engines: {node: '>=0.12'}
+    dev: true
+
   /[email protected]:
     resolution: {integrity: 
sha512-ceqxoedUrcayh7Y7ZX6NdbbDzGROiyVBgC4PriJThBKSVPWnnFHZAkfI1lJT8QFkOwH4qOS2SJkS4wvpGl8BpA==}
     engines: {node: '>=12'}
@@ -1405,18 +1491,52 @@ packages:
     hasBin: true
     dev: true
 
+  /[email protected]:
+    resolution: {integrity: 
sha512-Y22oTqIU4uuPgEemfz7NDJz6OeKf12Lsu+QC+s3BVpda64lTiMYCyGwg5ki4vFxkMwQdeZDl2adZoqUgdFuTgQ==}
+    engines: {node: '>=18'}
+    dependencies:
+      whatwg-encoding: 3.1.1
+    dev: true
+
   /[email protected]:
     resolution: {integrity: 
sha512-KknJ50kTInJ7qIScF3jeaFRpMpE8/lfiTdzf/twXyPBLAGrLRTmkz3AdTnKeh40X8k9L2fdYwEp/42WGXIRGcg==}
     dependencies:
       void-elements: 3.1.0
     dev: false
 
+  /[email protected]:
+    resolution: {integrity: 
sha512-T1gkAiYYDWYx3V5Bmyu7HcfcvL7mUrTWiM6yOfa3PIphViJ/gFPbvidQ+veqSOHci/PxBcDabeUNCzpOODJZig==}
+    engines: {node: '>= 14'}
+    dependencies:
+      agent-base: 7.1.4
+      debug: 4.3.4
+    transitivePeerDependencies:
+      - supports-color
+    dev: true
+
+  /[email protected]:
+    resolution: {integrity: 
sha512-vK9P5/iUfdl95AI+JVyUuIcVtd4ofvtrOr3HNtM2yxC9bnMbEdp3x01OhQNnjb8IJYi38VlTE3mBXwcfvywuSw==}
+    engines: {node: '>= 14'}
+    dependencies:
+      agent-base: 7.1.4
+      debug: 4.3.4
+    transitivePeerDependencies:
+      - supports-color
+    dev: true
+
   /[email protected]:
     resolution: {integrity: 
sha512-41pvpVbW9rhZPk5xjCX2TPJi2861LEig/YRhUkY+1FQ2IQPS0bKUDYnEqY8XPPbB48h1uIwLnP9iiEfuSl20CA==}
     dependencies:
       '@babel/runtime': 7.24.6
     dev: false
 
+  /[email protected]:
+    resolution: {integrity: 
sha512-4fCk79wshMdzMp2rH06qWrJE4iolqLhCUH+OiuIgU++RB0+94NlDL81atO7GX55uUKueo0txHNtvEyI6D7WdMw==}
+    engines: {node: '>=0.10.0'}
+    dependencies:
+      safer-buffer: 2.1.2
+    dev: true
+
   /[email protected]:
     resolution: {integrity: 
sha512-5Fytz/IraMjqpwfd34ke28PTVMjZjJG2MPn5t7OE4eUCUNf8BAa7b5WUS9/Qvr6mwOQS7Mk6vdsMno5he+T8Xw==}
     engines: {node: '>= 4'}
@@ -1487,6 +1607,10 @@ packages:
     engines: {node: '>=8'}
     dev: true
 
+  /[email protected]:
+    resolution: {integrity: 
sha512-bCYeRA2rVibKZd+s2625gGnGF/t7DSqDs4dP7CrLA1m7jKWz6pps0LpYLJN8Q64HtmPKJ1hrN3nzPNKFEKOUiQ==}
+    dev: true
+
   /[email protected]:
     resolution: {integrity: 
sha512-RHxMLp9lnKHGHRng9QFhRCMbYAcVpn69smSGcq3f36xjgVVWThj4qqLbTLlq7Ssj8B+fIQ1EuCEGI2lKsyQeIw==}
     dev: true
@@ -1506,6 +1630,41 @@ packages:
       argparse: 2.0.1
     dev: true
 
+  /[email protected]:
+    resolution: {integrity: 
sha512-Cvc9WUhxSMEo4McES3P7oK3QaXldCfNWp7pl2NNeiIFlCoLr3kfq9kb1fxftiwk1FLV7CvpvDfonxtzUDeSOPg==}
+    engines: {node: '>=18'}
+    peerDependencies:
+      canvas: ^3.0.0
+    peerDependenciesMeta:
+      canvas:
+        optional: true
+    dependencies:
+      cssstyle: 4.6.0
+      data-urls: 5.0.0
+      decimal.js: 10.6.0
+      html-encoding-sniffer: 4.0.0
+      http-proxy-agent: 7.0.2
+      https-proxy-agent: 7.0.6
+      is-potential-custom-element-name: 1.0.1
+      nwsapi: 2.2.28
+      parse5: 7.3.0
+      rrweb-cssom: 0.8.0
+      saxes: 6.0.0
+      symbol-tree: 3.2.4
+      tough-cookie: 5.1.2
+      w3c-xmlserializer: 5.0.0
+      webidl-conversions: 7.0.0
+      whatwg-encoding: 3.1.1
+      whatwg-mimetype: 4.0.0
+      whatwg-url: 14.2.0
+      ws: 8.22.2
+      xml-name-validator: 5.0.0
+    transitivePeerDependencies:
+      - bufferutil
+      - supports-color
+      - utf-8-validate
+    dev: true
+
   /[email protected]:
     resolution: {integrity: 
sha512-4bV5BfR2mqfQTJm+V5tPPdf+ZpuhiIvTuAB5g8kcrXOZpTT/QwwVRWBywX1ozr6lEuPdbHxwaJlm9G6mI2sfSQ==}
     dev: true
@@ -1579,6 +1738,10 @@ packages:
       js-tokens: 4.0.0
     dev: false
 
+  /[email protected]:
+    resolution: {integrity: 
sha512-JNAzZcXrCt42VGLuYz0zfAzDfAvJWW6AfYlDBQyDV5DClI2m5sAmK+OIO7s59XfsRsWHp02jAJrRadPRGTt6SQ==}
+    dev: true
+
   /[email protected]:
     resolution: {integrity: 
sha512-Jo6dJ04CmSjuznwJSS3pUeWmd/H0ffTlkXXgwZi+eq1UCmqQwCh+eLsYOYCwY991i2Fah4h1BEMCx4qThGbsiA==}
     engines: {node: '>=10'}
@@ -1642,6 +1805,10 @@ packages:
     resolution: {integrity: 
sha512-OWND8ei3VtNC9h7V60qff3SVobHr996CTwgxubgyQYEpg290h9J0buyECNNJexkFm5sOajh5G116RYA1c8ZMSw==}
     dev: true
 
+  /[email protected]:
+    resolution: {integrity: 
sha512-IlVB7OS7qrOsVYlpnFIkETjMwT9jwvmocJmmM+GZU/PAB3uGi9Ezd7vcWhWBUnSc0ya4ppmQITOyP1ez9gg8cg==}
+    dev: true
+
   /[email protected]:
     resolution: {integrity: 
sha512-rJgTQnkUnH1sFw8yT6VSU3zD3sWmu6sZhIseY8VX+GRu3P6F7Fu+JNDoXfklElbLJSnc3FUQHVe4cU5hj+BcUg==}
     engines: {node: '>=0.10.0'}
@@ -1686,6 +1853,12 @@ packages:
       callsites: 3.1.0
     dev: true
 
+  /[email protected]:
+    resolution: {integrity: 
sha512-IInvU7fabl34qmi9gY8XOVxhYyMyuH2xUNpb2q8/Y+7552KlejkRvqvD19nMoUW/uQGGbqNpA6Tufu5FL5BZgw==}
+    dependencies:
+      entities: 6.0.1
+    dev: true
+
   /[email protected]:
     resolution: {integrity: 
sha512-b7uo2UCUOYZcnF/3ID0lulOJi/bafxa1xPe7ZPsammBSpjSWQkjNxlt635YGS2MiR9GjvuXCtz2emr3jbsz98g==}
     dev: true
@@ -1895,12 +2068,27 @@ packages:
       fsevents: 2.3.3
     dev: true
 
+  /[email protected]:
+    resolution: {integrity: 
sha512-guoltQEx+9aMf2gDZ0s62EcV8lsXR+0w8915TC3ITdn2YueuNjdAYh/levpU9nFaoChh9RUS5ZdQMrKfVEN9tw==}
+    dev: true
+
   /[email protected]:
     resolution: {integrity: 
sha512-5l4VyZR86LZ/lDxZTR6jqL8AFE2S0IFLMP26AbjsLVADxHdhB/c0GUsH+y39UfCi3dzz8OlQuPmnaJOMoDHQBA==}
     dependencies:
       queue-microtask: 1.2.3
     dev: true
 
+  /[email protected]:
+    resolution: {integrity: 
sha512-YZo3K82SD7Riyi0E1EQPojLz7kpepnSQI9IyPbHHg1XXXevb5dJI7tpyN2ADxGcQbHG7vcyRHk0cbwqcQriUtg==}
+    dev: true
+
+  /[email protected]:
+    resolution: {integrity: 
sha512-xAg7SOnEhrm5zI3puOOKyy1OMcMlIJZYNJY7xLBwSze0UjhPLnWfj2GF2EpT0jmzaJKIWKHLsaSSajf35bcYnA==}
+    engines: {node: '>=v12.22.7'}
+    dependencies:
+      xmlchars: 2.2.0
+    dev: true
+
   /[email protected]:
     resolution: {integrity: 
sha512-UOShsPwz7NrMUqhR6t0hWjFduvOzbtv7toDH1/hIrfRNIDBnnBWd0CwJTGvTpngVlmwGCdP9/Zl/tVrDqcuYzQ==}
     dependencies:
@@ -1988,10 +2176,25 @@ packages:
     engines: {node: '>= 0.4'}
     dev: true
 
+  /[email protected]:
+    resolution: {integrity: 
sha512-9QNk5KwDF+Bvz+PyObkmSYjI5ksVUYtjW7AU22r2NKcfLJcXp96hkDWU3+XndOsUb+AQ9QhfzfCT2O+CNWT5Tw==}
+    dev: true
+
   /[email protected]:
     resolution: {integrity: 
sha512-N+8UisAXDGk8PFXP4HAzVR9nbfmVJ3zYLAWiTIoqC5v5isinhr+r5uaO8+7r3BMfuNIufIsA7RdpVgacC2cSpw==}
     dev: true
 
+  /[email protected]:
+    resolution: {integrity: 
sha512-Je6p7pkk+KMzMv2XXKmAE3McmolOQFdxkKw0R8EYNr7sELW46JqnNeTX8ybPiQgvg1ymCoF8LXs5fzFaZvJPTA==}
+    dev: true
+
+  /[email protected]:
+    resolution: {integrity: 
sha512-WMi/OQ2axVTf/ykqCQgXiIct+mSQDFdH2fkwhPwgEwvJ1kSzZRiinb0zF2Xb8u4+OqPChmyI6MEu4EezNJz+FQ==}
+    hasBin: true
+    dependencies:
+      tldts-core: 6.1.86
+    dev: true
+
   /[email protected]:
     resolution: {integrity: 
sha512-/OaKK0xYrs3DmxRYqL/yDc+FxFUVYhDlXMhRmv3z915w2HF1tnN1omB354j8VUGO/hbRzyD6Y3sA7v7GS/ceog==}
     engines: {node: '>=4'}
@@ -2009,6 +2212,20 @@ packages:
     engines: {node: '>=10'}
     dev: true
 
+  /[email protected]:
+    resolution: {integrity: 
sha512-FVDYdxtnj0G6Qm/DhNPSb8Ju59ULcup3tuJxkFb5K8Bv2pUXILbf0xZWU8PX8Ov19OXljbUyveOFwRMwkXzO+A==}
+    engines: {node: '>=16'}
+    dependencies:
+      tldts: 6.1.86
+    dev: true
+
+  /[email protected]:
+    resolution: {integrity: 
sha512-hdF5ZgjTqgAntKkklYw0R03MG2x/bSzTtkxmIRw/sTNV8YXsCJ1tfLAX23lhxhHJlEf3CRCOCGGWw3vI3GaSPw==}
+    engines: {node: '>=18'}
+    dependencies:
+      punycode: 2.3.1
+    dev: true
+
   /[email protected]([email protected]):
     resolution: {integrity: 
sha512-UQMIo7pb8WRomKR1/+MFVLTroIvDVtMX3K6OUir8ynLyzB8Jeriont2bTAtmNPa1ekAgN7YPDyf6V+ygrdU+eQ==}
     engines: {node: '>=16'}
@@ -2168,12 +2385,45 @@ packages:
       typescript: 5.4.2
     dev: true
 
+  /[email protected]:
+    resolution: {integrity: 
sha512-o8qghlI8NZHU1lLPrpi2+Uq7abh4GGPpYANlalzWxyWteJOCsr/P+oPBA49TOLu5FTZO4d3F9MnWJfiMo4BkmA==}
+    engines: {node: '>=18'}
+    dependencies:
+      xml-name-validator: 5.0.0
+    dev: true
+
   /[email protected]:
     resolution: {integrity: 
sha512-rpJyN222KWIvHJ/F53XSZv0Zl/accqHR8et1kpaMTD/fLCRxtV8iX8czMzY7sVZupTI3zcUTg8eycS2kNF9l6w==}
     dependencies:
       loose-envify: 1.4.0
     dev: false
 
+  /[email protected]:
+    resolution: {integrity: 
sha512-VwddBukDzu71offAQR975unBIGqfKZpM+8ZX6ySk8nYhVoo5CYaZyzt3YBvYtRtO+aoGlqxPg/B87NGVZ/fu6g==}
+    engines: {node: '>=12'}
+    dev: true
+
+  /[email protected]:
+    resolution: {integrity: 
sha512-6qN4hJdMwfYBtE3YBTTHhoeuUrDBPZmbQaxWAqSALV/MeEnR5z1xd8UKud2RAkFoPkmB+hli1TZSnyi84xz1vQ==}
+    engines: {node: '>=18'}
+    deprecated: Use @exodus/bytes instead for a more spec-conformant and 
faster implementation
+    dependencies:
+      iconv-lite: 0.6.3
+    dev: true
+
+  /[email protected]:
+    resolution: {integrity: 
sha512-QaKxh0eNIi2mE9p2vEdzfagOKHCcj1pJ56EEHGQOVxp8r9/iszLUUV7v89x9O1p/T+NlTM5W7jW6+cz4Fq1YVg==}
+    engines: {node: '>=18'}
+    dev: true
+
+  /[email protected]:
+    resolution: {integrity: 
sha512-De72GdQZzNTUBBChsXueQUnPKDkg/5A5zp7pFDuQAj5UFoENpiACU0wlCvzpAGnTkj++ihpKwKyYewn/XNUbKw==}
+    engines: {node: '>=18'}
+    dependencies:
+      tr46: 5.1.1
+      webidl-conversions: 7.0.0
+    dev: true
+
   /[email protected]:
     resolution: {integrity: 
sha512-BLI3Tl1TW3Pvl70l3yq3Y64i+awpwXqsGBYWkkqMtnbXgrMD+yj7rhW0kuEDxzJaYXGjEW5ogapKNMEKNMjibA==}
     engines: {node: '>= 8'}
@@ -2191,6 +2441,28 @@ packages:
     resolution: {integrity: 
sha512-l4Sp/DRseor9wL6EvV2+TuQn63dMkPjZ/sp9XkghTEbV9KlPS1xUsZ3u7/IQO4wxtcFB4bgpQPRcR3QCvezPcQ==}
     dev: true
 
+  /[email protected]:
+    resolution: {integrity: 
sha512-/rEZ2ejown2N5gxVTHUu9bVVC7ttu0/Tgzf5hbTOixR3Fs7mbbXgn2DbdbcKgJOmpQMtrIUWivtYuVMnp/W/yA==}
+    engines: {node: '>=10.0.0'}
+    peerDependencies:
+      bufferutil: ^4.0.1
+      utf-8-validate: '>=5.0.2'
+    peerDependenciesMeta:
+      bufferutil:
+        optional: true
+      utf-8-validate:
+        optional: true
+    dev: true
+
+  /[email protected]:
+    resolution: {integrity: 
sha512-EvGK8EJ3DhaHfbRlETOWAS5pO9MZITeauHKJyb8wyajUfQUenkIg2MvLDTZ4T/TgIcm3HU0TFBgWWboAZ30UHg==}
+    engines: {node: '>=18'}
+    dev: true
+
+  /[email protected]:
+    resolution: {integrity: 
sha512-JZnDKK8B0RCDw84FNdDAIpZK+JuJw+s7Lz8nksI7SIuU3UXJJslUthsi+uWBUYOwPFwW7W7PRLRfUKpxjtjFCw==}
+    dev: true
+
   /[email protected]:
     resolution: {integrity: 
sha512-3wdGidZyq5PB084XLES5TpOSRA3wjXAlIWMhum2kRcv/41Sn2emQ0dycQW4uZXLejwKvg6EsvbdlVL+FYEct7A==}
     dev: true
diff --git a/editor-formula/tests/hooks.test.cjs 
b/editor-formula/tests/hooks.test.cjs
new file mode 100644
index 0000000..6a6afe7
--- /dev/null
+++ b/editor-formula/tests/hooks.test.cjs
@@ -0,0 +1,143 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements.  See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership.  The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License.  You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+
+const assert = require('node:assert/strict');
+const { test } = require('node:test');
+const fs = require('node:fs');
+const path = require('node:path');
+const Module = require('node:module');
+const ts = require('typescript');
+const { JSDOM } = require('jsdom');
+const React = require('react');
+const { createRoot } = require('react-dom/client');
+const { act } = require('react-dom/test-utils');
+
+const dom = new JSDOM('<!doctype html><body></body>');
+Object.assign(global, {
+  window: dom.window, document: dom.window.document,
+  HTMLElement: dom.window.HTMLElement, Node: dom.window.Node,
+  IS_REACT_ACT_ENVIRONMENT: true,
+});
+let callbacks = 0;
+let cutoff = false;
+global.MutationObserver = class extends dom.window.MutationObserver {
+  constructor(callback) {
+    super((...args) => {
+      // A regression must fail quickly, rather than hang the test process.
+      if (++callbacks > 20) {
+        cutoff = true;
+        this.disconnect();
+        return;
+      }
+      callback(...args);
+    });
+  }
+};
+
+// Transpile the real hook. Node needs the published CJS entry for KaTeX's
+// browser-oriented extensionless import; the implementation/version is 
unchanged.
+const source = path.resolve(__dirname, '../hooks.ts');
+const hookModule = new Module(source, module);
+hookModule.filename = source;
+hookModule.paths = module.paths;
+const originalRequire = hookModule.require.bind(hookModule);
+hookModule.require = (id) => originalRequire(
+  id === 'katex/contrib/auto-render/auto-render'
+    ? 'katex/dist/contrib/auto-render.js' : id,
+);
+hookModule._compile(ts.transpileModule(fs.readFileSync(source, 'utf8'), {
+  compilerOptions: { esModuleInterop: true, module: ts.ModuleKind.CommonJS, 
target: ts.ScriptTarget.ES2020 },
+}).outputText, source);
+const { useRenderFormula } = hookModule.exports;
+const settle = () => act(() => new Promise((resolve) => setTimeout(resolve, 
10)));
+
+async function mount(element, strict = false) {
+  callbacks = 0;
+  cutoff = false;
+  const host = document.createElement('div');
+  document.body.append(host);
+  const root = createRoot(host);
+  function App({ target }) { useRenderFormula(target); return null; }
+  const view = (target) => strict
+    ? React.createElement(React.StrictMode, null, React.createElement(App, { 
target }))
+    : React.createElement(App, { target });
+  await act(() => root.render(view(element)));
+  return {
+    update: (target) => act(() => root.render(view(target))),
+    unmount: async () => { await act(() => root.unmount()); host.remove(); },
+  };
+}
+
+for (const input of ['$ $$', '$$ $', '$$', '$', '\\(', 'text $$x$$ tail', 
'\\(x\\)']) {
+  test(`settles after rendering ${JSON.stringify(input)} and continues 
observing`, async () => {
+    const target = document.createElement('div');
+    const app = await mount(target);
+    target.textContent = input;
+    await settle();
+    assert.equal(cutoff, false);
+    assert.equal(callbacks, 1, 'KaTeX writes must not schedule another 
callback');
+    assert.equal(target.querySelectorAll('.katex').length,
+      input === 'text $$x$$ tail' || input === '\\(x\\)' ? 1 : 0);
+    target.textContent = '\\(y+1\\)';
+    await settle();
+    assert.equal(callbacks, 2, 'later user edits must still be rendered');
+    assert.equal(target.querySelectorAll('.katex').length, 1);
+    await app.unmount();
+  });
+}
+
+test('observes characterData, disconnects on replacement and on unmount', 
async () => {
+  const first = document.createElement('div');
+  const text = document.createTextNode('plain');
+  first.append(text);
+  const app = await mount(first);
+  text.data = '\\(a\\)';
+  await settle();
+  assert.equal(first.querySelectorAll('.katex').length, 1);
+  const second = document.createElement('div');
+  second.textContent = '$$b$$';
+  await app.update(second);
+  assert.equal(second.querySelectorAll('.katex').length, 1);
+  const count = callbacks;
+  first.textContent = '$$old$$';
+  await settle();
+  assert.equal(callbacks, count, 'old target must be disconnected');
+  await app.unmount();
+  second.textContent = '$$after$$';
+  await settle();
+  assert.equal(callbacks, count, 'unmounted target must be disconnected');
+});
+
+test('null elements and empty refs are safe; ref reads after DOM commit in 
StrictMode', async () => {
+  const app = await mount(null);
+  await app.update({ current: null });
+  await app.unmount();
+  const host = document.createElement('div');
+  document.body.append(host);
+  const root = createRoot(host);
+  function Formula() {
+    const ref = React.useRef(null);
+    useRenderFormula(ref);
+    return React.createElement('article', { ref }, '$$x$$');
+  }
+  await act(() => root.render(React.createElement(React.StrictMode, null, 
React.createElement(Formula))));
+  assert.equal(host.querySelectorAll('.katex').length, 1);
+  await act(() => root.unmount());
+  host.remove();
+});

Reply via email to