html-react-parser 4.0.0 → 4.1.0

package/index.d.ts

@@ -38,6 +38,12 @@ export interface HTMLReactParserOptions {
     domNode: DOMNode
   ) => JSX.Element | object | void | undefined | null | false;
 
+  transform?: (
+    reactNode: JSX.Element | string,
+    domNode: DOMNode,
+    index: number
+  ) => JSX.Element | string | null;
+
   trim?: boolean;
 }
 

package/lib/dom-to-react.js

@@ -11,6 +11,7 @@ var canTextBeChildOfNode = utilities.canTextBeChildOfNode;
  * @param {DomElement[]} nodes - DOM nodes.
  * @param {object} [options={}] - Options.
  * @param {Function} [options.replace] - Replacer.
+ * @param {Function} [options.transform] - Transform.
  * @param {object} [options.library] - Library (React, Preact, etc.).
  * @returns - String or JSX element(s).
  */
@@ -26,6 +27,7 @@ function domToReact(nodes, options) {
   var node;
   var isWhitespace;
   var hasReplace = typeof options.replace === 'function';
+  var transform = options.transform || utilities.returnFirstArg;
   var replaceElement;
   var props;
   var children;
@@ -46,7 +48,7 @@ function domToReact(nodes, options) {
             key: replaceElement.key || i
           });
         }
-        result.push(replaceElement);
+        result.push(transform(replaceElement, node, i));
         continue;
       }
     }
@@ -68,7 +70,7 @@ function domToReact(nodes, options) {
 
       // We have a text node that's not whitespace and it can be nested
       // in its parent so add it to the results
-      result.push(node.data);
+      result.push(transform(node.data, node, i));
       continue;
     }
 
@@ -115,7 +117,7 @@ function domToReact(nodes, options) {
       props.key = i;
     }
 
-    result.push(createElement(node.name, props, children));
+    result.push(transform(createElement(node.name, props, children), node, i));
   }
 
   return result.length === 1 ? result[0] : result;

package/lib/utilities.js

@@ -120,11 +120,16 @@ function canTextBeChildOfNode(node) {
   return !elementsWithNoTextChildren.has(node.name);
 }
 
+function returnFirstArg(arg) {
+  return arg;
+}
+
 module.exports = {
   PRESERVE_CUSTOM_ATTRIBUTES: PRESERVE_CUSTOM_ATTRIBUTES,
   invertObject: invertObject,
   isCustomComponent: isCustomComponent,
   setStyleProp: setStyleProp,
   canTextBeChildOfNode: canTextBeChildOfNode,
-  elementsWithNoTextChildren: elementsWithNoTextChildren
+  elementsWithNoTextChildren: elementsWithNoTextChildren,
+  returnFirstArg: returnFirstArg
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "html-react-parser",
-  "version": "4.0.0",
+  "version": "4.1.0",
   "description": "HTML to React parser.",
   "author": "Mark <mark@remarkablemark.org>",
   "main": "index.js",
@@ -26,7 +26,7 @@
     "size-limit": "size-limit",
     "test": "jest --coverage --testPathIgnorePatterns test/integration/",
     "test:ci": "npm test -- --ci --colors",
-    "test:module": "node --experimental-modules test/module/index.mjs",
+    "test:module": "node --test test/module/",
     "test:integration": "npm run build && jest --env=jsdom test/integration/",
     "test:watch": "npm test -- --watch"
   },
@@ -51,31 +51,31 @@
     "style-to-js": "1.1.3"
   },
   "devDependencies": {
-    "@commitlint/cli": "17.6.5",
-    "@commitlint/config-conventional": "17.6.5",
-    "@rollup/plugin-commonjs": "25.0.0",
+    "@commitlint/cli": "17.6.7",
+    "@commitlint/config-conventional": "17.6.7",
+    "@rollup/plugin-commonjs": "25.0.3",
     "@rollup/plugin-node-resolve": "15.1.0",
-    "@size-limit/preset-big-lib": "8.2.4",
-    "@types/react": "18.2.7",
-    "@typescript-eslint/parser": "5.59.8",
+    "@size-limit/preset-big-lib": "8.2.6",
+    "@types/react": "18.2.15",
+    "@typescript-eslint/parser": "6.1.0",
     "benchmark": "2.1.4",
     "dtslint": "4.2.1",
-    "eslint": "8.41.0",
-    "eslint-plugin-prettier": "4.2.1",
+    "eslint": "8.45.0",
+    "eslint-plugin-prettier": "5.0.0",
     "husky": "8.0.3",
-    "jest": "29.5.0",
-    "jest-environment-jsdom": "29.5.0",
-    "lint-staged": "13.2.2",
+    "jest": "29.6.1",
+    "jest-environment-jsdom": "29.6.1",
+    "lint-staged": "13.2.3",
     "pinst": "3.0.0",
-    "preact": "10.15.1",
-    "prettier": "2.8.8",
+    "preact": "10.16.0",
+    "prettier": "3.0.0",
     "react": "18.2.0",
     "react-dom": "18.2.0",
     "rimraf": "5.0.1",
     "rollup": "2.79.1",
     "rollup-plugin-terser": "7.0.2",
-    "size-limit": "8.2.4",
-    "typescript": "5.0.4"
+    "size-limit": "8.2.6",
+    "typescript": "5.1.6"
   },
   "peerDependencies": {
     "react": "0.14 || 15 || 16 || 17 || 18"