pass read only matcher in call back

Author: amitguptagwl

CHANGELOG.md

@@ -2,6 +2,9 @@
 
 Note: Due to some last quick changes on v4, detail of v4.5.3 & v4.5.4 are not updated here. v4.5.4x is the last tag of v4 in github repository. I'm extremely sorry for the confusion
 
+**5.5.8 / 2026-03-20**
+- pass read only matcher in callback
+
 **5.5.7 / 2026-03-19**
 - fix: entity expansion limits
 - update strnum package to 2.2.0

docs/CHECK_LIST.md

@@ -1,5 +1,6 @@
 Pre release
 * [ ] npm audit and yarn audit is done
+* [ ] update pem.d.ts when there is any change path-expression-matcher package
 * [ ] Change log has been updated
 * [ ] Added/updated documentation for new properties/features
 * [ ] `package-lock.json` reflects the right version : `npm install`

lib/fxbuilder.min.js

@@ -1,7 +1,11 @@
-// import type { Matcher, Expression } from 'path-expression-matcher';
+import type pem = require('./pem');
+type Expression = pem.Expression;
+type ReadonlyMatcher = pem.ReadonlyMatcher;
 
-type Matcher = unknown;
-type Expression = unknown;
+// jPath: true  → string
+// jPath: false → ReadonlyMatcher
+type JPathOrMatcher = string | ReadonlyMatcher;
+type JPathOrExpression = string | Expression;
 
 type ProcessEntitiesOptions = {
   /**
@@ -63,7 +67,7 @@ type ProcessEntitiesOptions = {
    * 
    * Defaults to `null`
    */
-  tagFilter?: ((tagName: string, jPathOrMatcher: string | Matcher) => boolean) | null;
+  tagFilter?: ((tagName: string, jPathOrMatcher: JPathOrMatcher) => boolean) | null;
 };
 
 type X2jOptions = {
@@ -108,7 +112,7 @@ type X2jOptions = {
    * 
    * Defaults to `true`
    */
-  ignoreAttributes?: boolean | (string | RegExp)[] | ((attrName: string, jPathOrMatcher: string | Matcher) => boolean);
+  ignoreAttributes?: boolean | (string | RegExp)[] | ((attrName: string, jPathOrMatcher: JPathOrMatcher) => boolean);
 
   /**
    * Whether to remove namespace string from tag and attribute names
@@ -175,7 +179,7 @@ type X2jOptions = {
    * 
    * Defaults to `(tagName, val, jPathOrMatcher, hasAttributes, isLeafNode) => val`
    */
-  tagValueProcessor?: (tagName: string, tagValue: string, jPathOrMatcher: string | Matcher, hasAttributes: boolean, isLeafNode: boolean) => unknown;
+  tagValueProcessor?: (tagName: string, tagValue: string, jPathOrMatcher: JPathOrMatcher, hasAttributes: boolean, isLeafNode: boolean) => unknown;
 
   /**
    * Control how attribute value should be parsed
@@ -188,7 +192,7 @@ type X2jOptions = {
    * 
    * Defaults to `(attrName, val, jPathOrMatcher) => val`
    */
-  attributeValueProcessor?: (attrName: string, attrValue: string, jPathOrMatcher: string | Matcher) => unknown;
+  attributeValueProcessor?: (attrName: string, attrValue: string, jPathOrMatcher: JPathOrMatcher) => unknown;
 
   /**
    * Options to pass to `strnum` for parsing numbers
@@ -206,7 +210,7 @@ type X2jOptions = {
    * 
    * Defaults to `[]`
    */
-  stopNodes?: (string | Expression)[];
+  stopNodes?: JPathOrExpression[];
 
   /**
    * List of tags without closing tags
@@ -233,7 +237,7 @@ type X2jOptions = {
    * 
    * Defaults to `() => false`
    */
-  isArray?: (tagName: string, jPathOrMatcher: string | Matcher, isLeafNode: boolean, isAttribute: boolean) => boolean;
+  isArray?: (tagName: string, jPathOrMatcher: JPathOrMatcher, isLeafNode: boolean, isAttribute: boolean) => boolean;
 
   /**
    * Whether to process default and DOCTYPE entities
@@ -295,7 +299,7 @@ type X2jOptions = {
    * 
    * Defaults to `(tagName, jPathOrMatcher, attrs) => tagName`
    */
-  updateTag?: (tagName: string, jPathOrMatcher: string | Matcher, attrs: { [k: string]: string }) => string | boolean;
+  updateTag?: (tagName: string, jPathOrMatcher: JPathOrMatcher, attrs: { [k: string]: string }) => string | boolean;
 
   /**
    * If true, adds a Symbol to all object nodes, accessible by {@link XMLParser.getMetaDataSymbol} with
@@ -477,7 +481,7 @@ type XmlBuilderOptions = {
    * 
    * Defaults to `[]`
    */
-  stopNodes?: (string | Expression)[];
+  stopNodes?: JPathOrExpression[];
 
   /**
    * Control how tag value should be parsed. Called only if tag value is not empty
@@ -589,7 +593,11 @@ declare namespace fxp {
     strnumOptions,
     validationOptions,
     ProcessEntitiesOptions,
+    Expression,
+    ReadonlyMatcher,
+    JPathOrMatcher,
+    JPathOrExpression,
   }
 }
 
-export = fxp;
+export = fxp;