hinted-tree-merger 6.3.0 → 6.4.1

package/LICENSE

@@ -1,4 +1,4 @@
-Copyright (C) 2019-2025 by arlac77
+Copyright (C) 2019-2026 by arlac77
 
 Permission to use, copy, modify, and/or distribute this software for any
 purpose with or without fee is hereby granted.

package/README.md

@@ -74,22 +74,24 @@ const r = merge( undefined, [ { k:1, e:2}, { k:3 }]);
     *   [Parameters](#parameters-11)
 *   [matchingIndex](#matchingindex)
     *   [Parameters](#parameters-12)
+*   [toRegexp](#toregexp)
+    *   [Parameters](#parameters-13)
 *   [match](#match)
 *   [cmp](#cmp)
-    *   [Parameters](#parameters-13)
-*   [compareVersion](#compareversion)
     *   [Parameters](#parameters-14)
-*   [unionVersion](#unionversion)
+*   [compareVersion](#compareversion)
     *   [Parameters](#parameters-15)
+*   [unionVersion](#unionversion)
+    *   [Parameters](#parameters-16)
 *   [VersionMapper](#versionmapper)
 *   [mergeVersionsWithFilter](#mergeversionswithfilter)
-    *   [Parameters](#parameters-16)
-*   [mergeVersions](#mergeversions)
     *   [Parameters](#parameters-17)
-*   [mergeVersionsPreferNumeric](#mergeversionsprefernumeric)
+*   [mergeVersions](#mergeversions)
     *   [Parameters](#parameters-18)
-*   [walk](#walk)
+*   [mergeVersionsPreferNumeric](#mergeversionsprefernumeric)
     *   [Parameters](#parameters-19)
+*   [walk](#walk)
+    *   [Parameters](#parameters-20)
 
 ## hintFor
 
@@ -125,8 +127,8 @@ Skip merging use left side always.
 
 ### Parameters
 
-*   `a` **[Array](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array)** 
-*   `b` **[Array](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array)** 
+*   `a` **[Array](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array)\<any>**&#x20;
+*   `b` **[Array](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array)\<any>**&#x20;
 *   `path` **[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)**&#x20;
 *   `actions` **[Actions](#actions)**  (optional, default `nullAction`)
 *   `hints` **[Object](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object)**&#x20;
@@ -223,6 +225,17 @@ Returns **[Object](https://developer.mozilla.org/docs/Web/JavaScript/Reference/G
 
 Returns **[number](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number)**&#x20;
 
+## toRegexp
+
+try to from a regexp from str.
+Str must start with '/' and end with '/<flags>'
+
+### Parameters
+
+*   `str` **[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)**&#x20;
+
+Returns **([RegExp](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/RegExp) | [string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String))**&#x20;
+
 ## match
 
 url means highest version

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hinted-tree-merger",
-  "version": "6.3.0",
+  "version": "6.4.1",
   "publishConfig": {
     "access": "public",
     "provenance": true
@@ -42,14 +42,14 @@
   },
   "devDependencies": {
     "ava": "^6.4.1",
-    "browser-ava": "^2.3.47",
+    "browser-ava": "^2.3.50",
     "c8": "^10.1.3",
     "documentation": "^14.0.3",
     "semantic-release": "^25.0.2",
     "typescript": "^5.9.3"
   },
   "engines": {
-    "node": ">=24.11.1"
+    "node": ">=24.13.0"
   },
   "repository": {
     "type": "git",

package/src/merger.mjs

@@ -10,7 +10,8 @@ import {
   keyFor,
   hasDeleteHint,
   compareWithDefinedOrder,
-  sortObjectsByKeys
+  sortObjectsByKeys,
+  toRegexp
 } from "./util.mjs";
 import { hintFor } from "./hint.mjs";
 
@@ -20,7 +21,6 @@ import { hintFor } from "./hint.mjs";
  * @param {Object} hints
  */
 
-
 function appendPath(path, suffix, separator = "") {
   return path === undefined || path.length === 0
     ? suffix
@@ -36,8 +36,8 @@ export function mergeSkip(a, b, path, actions, hints) {
 
 /**
  *
- * @param {Array} a
- * @param {Array} b
+ * @param {Array<any>} a
+ * @param {Array<any>} b
  * @param {string} path
  * @param {Actions} actions
  * @param {Object} hints
@@ -56,6 +56,16 @@ export function mergeArrays(a, b, path, actions = nullAction, hints) {
           return false;
         }
 
+        value = toRegexp(value);
+        if(value instanceof RegExp) {
+          for(let i = 0; i < a.length; i++) {
+            if(typeof a[i] === 'string' && a[i].match(value)) {
+              a.splice(i, 1);
+              actions({ remove: value, path: appendPath(path, `[${i}]`) }, h);
+            }
+          }
+        }
+
         const i = a.indexOf(value);
         if (i >= 0) {
           a.splice(i, 1);

package/src/reanimate-hints.mjs

@@ -7,6 +7,7 @@ import {
 } from "./versions.mjs";
 import { mergeExpressions } from "./string-expressions.mjs";
 import { mergeSkip } from "./merger.mjs";
+import { toRegexp } from "./util.mjs";
 
 const mergeFunctions = [
   mergeVersions,
@@ -29,17 +30,11 @@ export function reanimateHints(hints) {
         }
         break;
       case "orderBy":
-        parents[parents.length - 1].orderBy = value.map(v => {
-          if (typeof v === "string" && v[0] === "/" && v.match(/\/[img]?$/)) {
-            const m = v.match(/\/([a-z]*)$/)
-            const inner = v.substring(1,v.length - m[0].length)
-            return new RegExp(inner,m[1]);
-          }
-          return v;
-        });
+        parents[parents.length - 1].orderBy = value.map(v => toRegexp(v));
         break;
     }
   }
 
   return hints;
 }
+

package/src/util.mjs

@@ -379,3 +379,18 @@ export function compareWithDefinedOrder(a, b, definedOrder) {
 
   return ai - bi;
 }
+
+/**
+ * try to from a regexp from str.
+ * Str must start with '/' and end with '/<flags>'
+ * @param {string} str 
+ * @returns {RegExp|string}
+ */
+export function toRegexp(str) {
+  if (typeof str === "string" && str[0] === "/" && str.match(/\/[a-z]*$/)) {
+    const m = str.match(/\/([a-z]*)$/);
+    const inner = str.substring(1, str.length - m[0].length);
+    return new RegExp(inner, m[1]);
+  }
+  return str;
+}

package/types/merger.d.mts

@@ -4,13 +4,13 @@
 export function mergeSkip(a: any, b: any, path: any, actions: any, hints: any): any;
 /**
  *
- * @param {Array} a
- * @param {Array} b
+ * @param {Array<any>} a
+ * @param {Array<any>} b
  * @param {string} path
  * @param {Actions} actions
  * @param {Object} hints
  */
-export function mergeArrays(a: any[], b: any[], path: string, actions: Actions, hints: any): any[];
+export function mergeArrays(a: Array<any>, b: Array<any>, path: string, actions: Actions, hints: any): any[];
 /**
  * Merge to values.
  * @param {any} a

package/types/util.d.mts

@@ -53,3 +53,10 @@ export function sortObjectsByKeys(source: any, compare: any): any;
  * @param {Array<RegExp|string>} definedOrder
  */
 export function compareWithDefinedOrder(a: any, b: any, definedOrder: Array<RegExp | string>): number;
+/**
+ * try to from a regexp from str.
+ * Str must start with '/' and end with '/<flags>'
+ * @param {string} str
+ * @returns {RegExp|string}
+ */
+export function toRegexp(str: string): RegExp | string;