@witchcraft/expressit 0.0.2

package/dist/grammar/index.d.ts

@@ -0,0 +1,3 @@
+export { createTokens } from "./createTokens.js";
+export { ParserBase } from "./ParserBase.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/grammar/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/grammar/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA"}

package/dist/grammar/index.js

@@ -0,0 +1,6 @@
+import { createTokens } from "./createTokens.js";
+import { ParserBase } from "./ParserBase.js";
+export {
+  ParserBase,
+  createTokens
+};

package/dist/helpers/errors.d.ts

@@ -0,0 +1,9 @@
+import type { ERROR_CODES, ErrorInfo } from "../types/errors.js";
+export declare class BooleanParserLibraryError<T extends ERROR_CODES> extends Error {
+    version: string;
+    repo: string;
+    type: T;
+    info: ErrorInfo<T>;
+    constructor(type: T, info: ErrorInfo<T>, message?: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/helpers/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/helpers/errors.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAA;AAGhE,qBAAa,yBAAyB,CAAC,CAAC,SAAS,WAAW,CAAE,SAAQ,KAAK;IAC1E,OAAO,EAAE,MAAM,CAAU;IAEzB,IAAI,EAAE,MAAM,CAAa;IAEzB,IAAI,EAAE,CAAC,CAAA;IAEP,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,CAAA;gBAEN,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,MAAM;CAYzD"}

package/dist/helpers/errors.js

@@ -0,0 +1,41 @@
+var __defProp = Object.defineProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField = (obj, key, value) => {
+  __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+  return value;
+};
+import { pretty, crop, indent } from "@alanscodelog/utils";
+import { version, repository } from "../package.js";
+class BooleanParserLibraryError extends Error {
+  constructor(type, info, message) {
+    super(
+      message ? `${message}
+${pretty(info)}` : `This error should never happen, please file a bug report at ${repository}/issues with the following information: 
+${crop`
+					version: ${version}
+					type: ${type}
+					info: ${indent(JSON.stringify(info, forceStringifyErrors, "	"), 5)}
+				`}`
+    );
+    __publicField(this, "version", version);
+    __publicField(this, "repo", repository);
+    __publicField(this, "type");
+    __publicField(this, "info");
+    this.type = type;
+    this.info = info;
+  }
+}
+function forceStringifyErrors(_key, value) {
+  if (value instanceof Error) {
+    return Object.fromEntries(
+      Object.getOwnPropertyNames(value).map((key) => [
+        key,
+        key === "stack" ? value[key].split(/\n/) : value[key]
+      ])
+    );
+  }
+  return value;
+}
+export {
+  BooleanParserLibraryError
+};

package/dist/helpers/general/applyBoolean.d.ts

@@ -0,0 +1,3 @@
+/** @internal */
+export declare function applyBoolean(left: boolean | undefined, right: boolean): boolean;
+//# sourceMappingURL=applyBoolean.d.ts.map

package/dist/helpers/general/applyBoolean.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"applyBoolean.d.ts","sourceRoot":"","sources":["../../../src/helpers/general/applyBoolean.ts"],"names":[],"mappings":"AAAA,gBAAgB;AAChB,wBAAgB,YAAY,CAAC,IAAI,EAAE,OAAO,GAAG,SAAS,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAO/E"}

package/dist/helpers/general/applyBoolean.js

@@ -0,0 +1,17 @@
+function applyBoolean(left, right) {
+  if (left === void 0) {
+    return right;
+  }
+  if (!left) {
+    if (!right) {
+      return true;
+    } else {
+      return left;
+    }
+  } else {
+    return right;
+  }
+}
+export {
+  applyBoolean
+};

package/dist/helpers/general/applyPrefix.d.ts

@@ -0,0 +1,4 @@
+import type { PrefixApplier } from "../../types/parser.js";
+/** @internal */
+export declare function applyPrefix(left: string | undefined, right: string, prefixApplier: PrefixApplier): string;
+//# sourceMappingURL=applyPrefix.d.ts.map

package/dist/helpers/general/applyPrefix.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"applyPrefix.d.ts","sourceRoot":"","sources":["../../../src/helpers/general/applyPrefix.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAA;AAE1D,gBAAgB;AAChB,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,aAAa,GAAG,MAAM,CAGzG"}

package/dist/helpers/general/applyPrefix.js

@@ -0,0 +1,9 @@
+function applyPrefix(left, right, prefixApplier) {
+  if (left === void 0) {
+    return right;
+  }
+  return prefixApplier(left, right);
+}
+export {
+  applyPrefix
+};

package/dist/helpers/general/defaultConditionNormalizer.d.ts

@@ -0,0 +1,3 @@
+import type { ConditionNormalizer } from "../../types/parser.js";
+export declare const defaultConditionNormalizer: ConditionNormalizer;
+//# sourceMappingURL=defaultConditionNormalizer.d.ts.map

package/dist/helpers/general/defaultConditionNormalizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaultConditionNormalizer.d.ts","sourceRoot":"","sources":["../../../src/helpers/general/defaultConditionNormalizer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAc,MAAM,uBAAuB,CAAA;AAG5E,eAAO,MAAM,0BAA0B,EAAE,mBAKxC,CAAA"}

package/dist/helpers/general/defaultConditionNormalizer.js

@@ -0,0 +1,6 @@
+const defaultConditionNormalizer = function defaultConditionNormalizer2({ value, operator, isNegated }) {
+  return { value, operator, negate: isNegated };
+};
+export {
+  defaultConditionNormalizer
+};

package/dist/helpers/general/defaultKeyParser.d.ts

@@ -0,0 +1,3 @@
+import type { KeyParser } from "../../types/parser.js";
+export declare const defaultKeyParser: KeyParser;
+//# sourceMappingURL=defaultKeyParser.d.ts.map

package/dist/helpers/general/defaultKeyParser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaultKeyParser.d.ts","sourceRoot":"","sources":["../../../src/helpers/general/defaultKeyParser.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAA;AAGtD,eAAO,MAAM,gBAAgB,EAAE,SAI7B,CAAA"}

package/dist/helpers/general/defaultKeyParser.js

@@ -0,0 +1,8 @@
+const defaultKeyParser = function defaultKeyParser2(value) {
+  if (value === void 0)
+    return [];
+  return [value];
+};
+export {
+  defaultKeyParser
+};

package/dist/helpers/general/defaultPrefixApplier.d.ts

@@ -0,0 +1,3 @@
+import type { PrefixApplier } from "../../types/parser.js";
+export declare const defaultPrefixApplier: PrefixApplier;
+//# sourceMappingURL=defaultPrefixApplier.d.ts.map

package/dist/helpers/general/defaultPrefixApplier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaultPrefixApplier.d.ts","sourceRoot":"","sources":["../../../src/helpers/general/defaultPrefixApplier.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAA;AAG1D,eAAO,MAAM,oBAAoB,EAAE,aAGlC,CAAA"}

package/dist/helpers/general/defaultPrefixApplier.js

@@ -0,0 +1,6 @@
+const defaultPrefixApplier = function defaultPrefixApplier2(prefix, value) {
+  return prefix + value;
+};
+export {
+  defaultPrefixApplier
+};

package/dist/helpers/general/defaultValueComparer.d.ts

@@ -0,0 +1,3 @@
+import type { ValueComparer } from "../../types/parser.js";
+export declare const defaultValueComparer: ValueComparer;
+//# sourceMappingURL=defaultValueComparer.d.ts.map

package/dist/helpers/general/defaultValueComparer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaultValueComparer.d.ts","sourceRoot":"","sources":["../../../src/helpers/general/defaultValueComparer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAA;AAG1D,eAAO,MAAM,oBAAoB,EAAE,aAGlC,CAAA"}

package/dist/helpers/general/defaultValueComparer.js

@@ -0,0 +1,6 @@
+const defaultValueComparer = function defaultValueComparer2(condition, contextValue) {
+  return contextValue === condition.value;
+};
+export {
+  defaultValueComparer
+};

package/dist/helpers/general/index.d.ts

@@ -0,0 +1,7 @@
+export { applyBoolean } from "./applyBoolean.js";
+export { applyPrefix } from "./applyPrefix.js";
+export { defaultConditionNormalizer } from "./defaultConditionNormalizer.js";
+export { defaultKeyParser } from "./defaultKeyParser.js";
+export { defaultPrefixApplier } from "./defaultPrefixApplier.js";
+export { defaultValueComparer } from "./defaultValueComparer.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/helpers/general/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/helpers/general/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAC9C,OAAO,EAAE,0BAA0B,EAAE,MAAM,iCAAiC,CAAA;AAC5E,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AACxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAA;AAChE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAA"}

package/dist/helpers/general/index.js

@@ -0,0 +1,14 @@
+import { applyBoolean } from "./applyBoolean.js";
+import { applyPrefix } from "./applyPrefix.js";
+import { defaultConditionNormalizer } from "./defaultConditionNormalizer.js";
+import { defaultKeyParser } from "./defaultKeyParser.js";
+import { defaultPrefixApplier } from "./defaultPrefixApplier.js";
+import { defaultValueComparer } from "./defaultValueComparer.js";
+export {
+  applyBoolean,
+  applyPrefix,
+  defaultConditionNormalizer,
+  defaultKeyParser,
+  defaultPrefixApplier,
+  defaultValueComparer
+};

package/dist/helpers/index.d.ts

@@ -0,0 +1,4 @@
+export * as general from "./general/index.js";
+export * as parser from "./parser/index.js";
+export { BooleanParserLibraryError } from "./errors.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/helpers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/helpers/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,OAAO,MAAM,oBAAoB,CAAA;AAC7C,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAA;AAC3C,OAAO,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAA"}

package/dist/helpers/index.js

@@ -0,0 +1,8 @@
+import * as index from "./general/index.js";
+import * as index$1 from "./parser/index.js";
+import { BooleanParserLibraryError } from "./errors.js";
+export {
+  BooleanParserLibraryError,
+  index as general,
+  index$1 as parser
+};

package/dist/helpers/parser/assignParents.d.ts

@@ -0,0 +1,4 @@
+import type { Nodes } from "../../types/ast.js";
+/** @internal */
+export declare function assignParents(ast: Nodes): void;
+//# sourceMappingURL=assignParents.d.ts.map

package/dist/helpers/parser/assignParents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assignParents.d.ts","sourceRoot":"","sources":["../../../src/helpers/parser/assignParents.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAA;AAE/C,gBAAgB;AAChB,wBAAgB,aAAa,CAAC,GAAG,EAAE,KAAK,GAAG,IAAI,CAyC9C"}

package/dist/helpers/parser/assignParents.js

@@ -0,0 +1,71 @@
+import { ArrayNode } from "../../ast/classes/ArrayNode.js";
+import { ConditionNode } from "../../ast/classes/ConditionNode.js";
+import { ExpressionNode } from "../../ast/classes/ExpressionNode.js";
+import { GroupNode } from "../../ast/classes/GroupNode.js";
+import { Node } from "../../ast/classes/Node.js";
+import { VariableNode } from "../../ast/classes/VariableNode.js";
+function assignParents(ast) {
+  var _a, _b, _c, _d, _e, _f, _g;
+  if (ast instanceof VariableNode) {
+    if (ast.prefix)
+      ast.prefix.parent = ast;
+    if ((_a = ast.quote) == null ? void 0 : _a.left)
+      ast.quote.left.parent = ast;
+    if ((_b = ast.quote) == null ? void 0 : _b.right)
+      ast.quote.right.parent = ast;
+    if ((_c = ast.quote) == null ? void 0 : _c.flags)
+      ast.quote.flags.parent = ast;
+    ast.value.parent = ast;
+  } else if (ast instanceof ConditionNode) {
+    if (ast.operator)
+      ast.operator.parent = ast;
+    if (ast.property) {
+      ast.property.parent = ast;
+      if (ast.property instanceof Node)
+        assignParents(ast.property);
+    }
+    if (ast.propertyOperator)
+      ast.propertyOperator.parent = ast;
+    if ((_d = ast.sep) == null ? void 0 : _d.left)
+      ast.sep.left.parent = ast;
+    if ((_e = ast.sep) == null ? void 0 : _e.right)
+      ast.sep.right.parent = ast;
+    ast.value.parent = ast;
+    if (ast.value instanceof Node)
+      assignParents(ast.value);
+  } else if (ast instanceof ExpressionNode) {
+    if (ast.operator)
+      ast.operator.parent = ast;
+    ast.right.parent = ast;
+    if (ast.right instanceof Node)
+      assignParents(ast.right);
+    ast.left.parent = ast;
+    if (ast.left instanceof Node)
+      assignParents(ast.left);
+  } else if (ast instanceof GroupNode) {
+    if (ast.prefix) {
+      ast.prefix.parent = ast;
+      if (ast.prefix instanceof Node)
+        assignParents(ast.prefix);
+    }
+    if ((_f = ast.paren) == null ? void 0 : _f.left)
+      ast.paren.left.parent = ast;
+    if ((_g = ast.paren) == null ? void 0 : _g.right)
+      ast.paren.right.parent = ast;
+    ast.expression.parent = ast;
+    if (ast.expression instanceof Node)
+      assignParents(ast.expression);
+  } else if (ast instanceof ArrayNode) {
+    if (ast.bracket.left)
+      ast.bracket.left.parent = ast;
+    if (ast.bracket.right)
+      ast.bracket.right.parent = ast;
+    for (const val of ast.values) {
+      val.parent = ast;
+      assignParents(val);
+    }
+  }
+}
+export {
+  assignParents
+};

package/dist/helpers/parser/checkParserOpts.d.ts

@@ -0,0 +1,3 @@
+import type { FullParserOptions } from "../../types/parser.js";
+export declare function checkParserOpts<T extends {}>(opts: FullParserOptions<T>, evaluatorChecks?: boolean, validatorChecks?: boolean): void;
+//# sourceMappingURL=checkParserOpts.d.ts.map

package/dist/helpers/parser/checkParserOpts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkParserOpts.d.ts","sourceRoot":"","sources":["../../../src/helpers/parser/checkParserOpts.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,iBAAiB,EAAiB,MAAM,uBAAuB,CAAA;AAM7E,wBAAgB,eAAe,CAAC,CAAC,SAAS,EAAE,EAAE,IAAI,EAAE,iBAAiB,CAAC,CAAC,CAAC,EAAE,eAAe,GAAE,OAAe,EAAE,eAAe,GAAE,OAAe,GAAG,IAAI,CAoIlJ"}

package/dist/helpers/parser/checkParserOpts.js

@@ -0,0 +1,126 @@
+import { pushIfNotIn, isBlank } from "@alanscodelog/utils";
+import { ERROR_CODES } from "../../types/errors.js";
+import { BooleanParserLibraryError } from "../errors.js";
+import { defaultConditionNormalizer } from "../general/defaultConditionNormalizer.js";
+import { defaultValueComparer } from "../general/defaultValueComparer.js";
+function checkParserOpts(opts, evaluatorChecks = false, validatorChecks = false) {
+  var _a, _b, _c, _d, _e, _f, _g, _h, _i;
+  if (!evaluatorChecks) {
+    const keywordsList = [...opts.keywords.and, ...opts.keywords.or, ...opts.keywords.not].map((keyword) => keyword.value);
+    const symNots = opts.keywords.not.filter((op) => op.isSymbol).map((op) => op.value);
+    const keywords = [
+      ...[...keywordsList].filter((val) => !symNots.includes(val)),
+      ...["(", ")"],
+      ...opts.arrayValues ? ["[", "]"] : [],
+      ...opts.regexValues ? ["/"] : []
+    ];
+    const extra = [];
+    if (opts.expandedPropertySeparator)
+      extra.push(opts.expandedPropertySeparator);
+    if (opts.customPropertyOperators)
+      pushIfNotIn(extra, ...opts.customPropertyOperators);
+    if (opts.expandedPropertySeparator && isBlank(opts.expandedPropertySeparator)) {
+      throw new BooleanParserLibraryError(
+        ERROR_CODES.PARSER_CONFLICTING_OPTIONS_ERROR,
+        { prohibited: [""], invalid: opts.expandedPropertySeparator },
+        `expandedPropertySeparator cannot be blank`
+      );
+    }
+    const customInvalid = (_a = opts.customPropertyOperators) == null ? void 0 : _a.find((_) => isBlank(_));
+    if (customInvalid !== void 0) {
+      throw new BooleanParserLibraryError(
+        ERROR_CODES.PARSER_CONFLICTING_OPTIONS_ERROR,
+        { prohibited: [""], invalid: customInvalid },
+        `customPropertyOperators cannot contain blank entries`
+      );
+    }
+    const prefixInvalid = (_b = opts.prefixableStrings) == null ? void 0 : _b.find((_) => isBlank(_));
+    if (prefixInvalid !== void 0) {
+      throw new BooleanParserLibraryError(
+        ERROR_CODES.PARSER_CONFLICTING_OPTIONS_ERROR,
+        { prohibited: [""], invalid: prefixInvalid },
+        `prefixableStrings cannot contain blank entries`
+      );
+    }
+    for (const key of ["and", "or", "not"]) {
+      const invalid = (_d = (_c = opts.keywords[key]) == null ? void 0 : _c.find((_) => isBlank(_.value))) == null ? void 0 : _d.value;
+      if (invalid !== void 0) {
+        throw new BooleanParserLibraryError(
+          ERROR_CODES.PARSER_CONFLICTING_OPTIONS_ERROR,
+          { prohibited: [""], invalid },
+          `keywords.${key} cannot contain entries with blank values`
+        );
+      }
+    }
+    const all = [...keywords, ...symNots, ...extra];
+    const allKeywords = [...keywords, ...symNots];
+    const messageInvalidAny = "cannot contain operators or special symbols, but found";
+    const messageInvalidBool = "cannot contain boolean operators or special symbols, but found";
+    const invalidPrefixableString = (_e = opts.prefixableStrings) == null ? void 0 : _e.find((val) => all.includes(val));
+    if (invalidPrefixableString) {
+      throw new BooleanParserLibraryError(
+        ERROR_CODES.PARSER_CONFLICTING_OPTIONS_ERROR,
+        { prohibited: all, invalid: invalidPrefixableString },
+        `prefixableStrings ${messageInvalidAny} "${invalidPrefixableString}"`
+      );
+    }
+    const invalidExpandedPropertySeparator = allKeywords.find((_) => _ === opts.expandedPropertySeparator);
+    if (invalidExpandedPropertySeparator) {
+      throw new BooleanParserLibraryError(
+        ERROR_CODES.PARSER_CONFLICTING_OPTIONS_ERROR,
+        { prohibited: allKeywords, invalid: invalidExpandedPropertySeparator },
+        `expandedPropertySeparator ${messageInvalidBool} "${invalidExpandedPropertySeparator}"`
+      );
+    }
+    const invalidCustomPropertyOperator = ((_f = opts.customPropertyOperators) == null ? void 0 : _f.find((val) => keywords.includes(val))) ? opts.expandedPropertySeparator : void 0;
+    if (invalidCustomPropertyOperator) {
+      throw new BooleanParserLibraryError(
+        ERROR_CODES.PARSER_CONFLICTING_OPTIONS_ERROR,
+        { prohibited: keywords, invalid: invalidCustomPropertyOperator },
+        `customPropertyOperator ${messageInvalidBool} "${invalidCustomPropertyOperator}"`
+      );
+    }
+  }
+  if (evaluatorChecks) {
+    const requireCustomNormalizer = [];
+    if ((((_g = opts.prefixableStrings) == null ? void 0 : _g.length) ?? 0) > 0)
+      requireCustomNormalizer.push("prefixableStrings");
+    if ((((_h = opts.customPropertyOperators) == null ? void 0 : _h.length) ?? 0) > 0)
+      requireCustomNormalizer.push("customPropertyOperators");
+    if ((((_i = opts.expandedPropertySeparator) == null ? void 0 : _i.length) ?? 0) > 0)
+      requireCustomNormalizer.push("expandedPropertySeparator");
+    if (opts.regexValues)
+      requireCustomNormalizer.push("regexValues");
+    if (requireCustomNormalizer.length > 0 && opts.conditionNormalizer === defaultConditionNormalizer) {
+      throw new BooleanParserLibraryError(
+        ERROR_CODES.PARSER_OPTION_REQUIRED_ERROR,
+        { options: requireCustomNormalizer, requires: "conditionNormalizer" },
+        `A custom conditionNormalizer function must be specified when using the following options: ${requireCustomNormalizer.join(", ")}`
+      );
+    }
+    const requireCustomComparer = [];
+    if (opts.regexValues)
+      requireCustomComparer.push("regexValues");
+    if (opts.regexValues)
+      requireCustomComparer.push("arrayValues");
+    if (requireCustomComparer.length > 0 && opts.valueComparer === defaultValueComparer) {
+      throw new BooleanParserLibraryError(
+        ERROR_CODES.PARSER_OPTION_REQUIRED_ERROR,
+        { options: requireCustomComparer, requires: "valueComparer" },
+        `A custom valueComparer function must be specified when using the following options: ${requireCustomComparer.join(", ")}`
+      );
+    }
+  }
+  if (validatorChecks) {
+    if (opts.valueValidator === void 0) {
+      throw new BooleanParserLibraryError(
+        ERROR_CODES.PARSER_OPTION_REQUIRED_ERROR,
+        { requires: "valueValidator" },
+        `A custom valueValidator function must be specified when using the validate method.`
+      );
+    }
+  }
+}
+export {
+  checkParserOpts
+};

package/dist/helpers/parser/extractPosition.d.ts

@@ -0,0 +1,9 @@
+import type { Position } from "../../types/ast.js";
+type ChevrotainLocation = {
+    startOffset?: number;
+    endOffset?: number;
+};
+/** @internal */
+export declare function extractPosition(loc: ChevrotainLocation, shift: number): Position;
+export {};
+//# sourceMappingURL=extractPosition.d.ts.map

package/dist/helpers/parser/extractPosition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extractPosition.d.ts","sourceRoot":"","sources":["../../../src/helpers/parser/extractPosition.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAA;AAGlD,KAAK,kBAAkB,GAAG;IACzB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,SAAS,CAAC,EAAE,MAAM,CAAA;CAClB,CAAA;AAED,gBAAgB;AAChB,wBAAgB,eAAe,CAAC,GAAG,EAAE,kBAAkB,EAAE,KAAK,EAAE,MAAM,GAAG,QAAQ,CAKhF"}

package/dist/helpers/parser/extractPosition.js

@@ -0,0 +1,9 @@
+function extractPosition(loc, shift) {
+  return {
+    start: loc.startOffset - (shift ?? 0),
+    end: loc.endOffset + 1 - (shift ?? 0)
+  };
+}
+export {
+  extractPosition
+};

package/dist/helpers/parser/getUnclosedRightParenCount.d.ts

@@ -0,0 +1,5 @@
+import { type IToken } from "chevrotain";
+import type { createTokens } from "../../grammar/createTokens.js";
+/** @internal */
+export declare function getUnclosedRightParenCount(tokens: IToken[], t: ReturnType<typeof createTokens>["tokens"]): number;
+//# sourceMappingURL=getUnclosedRightParenCount.d.ts.map

package/dist/helpers/parser/getUnclosedRightParenCount.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getUnclosedRightParenCount.d.ts","sourceRoot":"","sources":["../../../src/helpers/parser/getUnclosedRightParenCount.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,MAAM,EAAgB,MAAM,YAAY,CAAA;AAEtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAA;AAGjE,gBAAgB;AAChB,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,UAAU,CAAC,OAAO,YAAY,CAAC,CAAC,QAAQ,CAAC,GAAG,MAAM,CAejH"}

package/dist/helpers/parser/getUnclosedRightParenCount.js

@@ -0,0 +1,20 @@
+import { tokenMatcher } from "chevrotain";
+function getUnclosedRightParenCount(tokens, t) {
+  let open = 0;
+  let unclosed = 0;
+  for (const token of tokens) {
+    if (tokenMatcher(token, t.PAREN_R)) {
+      if (open > 0) {
+        open--;
+      } else {
+        unclosed++;
+      }
+    } else if (tokenMatcher(token, t.PAREN_L)) {
+      open++;
+    }
+  }
+  return unclosed;
+}
+export {
+  getUnclosedRightParenCount
+};

package/dist/helpers/parser/index.d.ts

@@ -0,0 +1,9 @@
+export { assignParents } from "./assignParents.js";
+export { checkParserOpts } from "./checkParserOpts.js";
+export { extractPosition } from "./extractPosition.js";
+export { getUnclosedRightParenCount } from "./getUnclosedRightParenCount.js";
+export { parseParserOptions } from "./parseParserOptions.js";
+export { seal } from "./seal.js";
+export { setParent } from "./setParent.js";
+export { unescape } from "./unescape.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/helpers/parser/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/helpers/parser/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AACtD,OAAO,EAAE,0BAA0B,EAAE,MAAM,iCAAiC,CAAA;AAC5E,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAA;AAC5D,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC1C,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA"}

package/dist/helpers/parser/index.js

@@ -0,0 +1,18 @@
+import { assignParents } from "./assignParents.js";
+import { checkParserOpts } from "./checkParserOpts.js";
+import { extractPosition } from "./extractPosition.js";
+import { getUnclosedRightParenCount } from "./getUnclosedRightParenCount.js";
+import { parseParserOptions } from "./parseParserOptions.js";
+import { seal } from "./seal.js";
+import { setParent } from "./setParent.js";
+import { unescape } from "./unescape.js";
+export {
+  assignParents,
+  checkParserOpts,
+  extractPosition,
+  getUnclosedRightParenCount,
+  parseParserOptions,
+  seal,
+  setParent,
+  unescape
+};

package/dist/helpers/parser/parseParserOptions.d.ts

@@ -0,0 +1,4 @@
+import type { FullParserOptions, ParserOptions } from "../../types/parser.js";
+/** @internal */
+export declare function parseParserOptions<T extends {} = {}>(options: ParserOptions<T>): FullParserOptions<T>;
+//# sourceMappingURL=parseParserOptions.d.ts.map

package/dist/helpers/parser/parseParserOptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseParserOptions.d.ts","sourceRoot":"","sources":["../../../src/helpers/parser/parseParserOptions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAA;AAM7E,gBAAgB;AAChB,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,EAAE,GAAG,EAAE,EACnD,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC,GACvB,iBAAiB,CAAC,CAAC,CAAC,CA4CtB"}

package/dist/helpers/parser/parseParserOptions.js

@@ -0,0 +1,45 @@
+import { defaultConditionNormalizer } from "../general/defaultConditionNormalizer.js";
+import { defaultKeyParser } from "../general/defaultKeyParser.js";
+import { defaultPrefixApplier } from "../general/defaultPrefixApplier.js";
+import { defaultValueComparer } from "../general/defaultValueComparer.js";
+function parseParserOptions(options) {
+  var _a, _b, _c;
+  const opts = {
+    prefixApplier: defaultPrefixApplier,
+    keyParser: defaultKeyParser,
+    valueComparer: defaultValueComparer,
+    conditionNormalizer: defaultConditionNormalizer,
+    prefixableGroups: true,
+    prefixableStrings: void 0,
+    expandedPropertySeparator: void 0,
+    customPropertyOperators: void 0,
+    onMissingBooleanOperator: "error",
+    arrayValues: true,
+    regexValues: true,
+    ...options,
+    // todo fix
+    keywords: {
+      or: ((_a = options.keywords) == null ? void 0 : _a.or) ? options.keywords.or : [
+        { value: "||", isSymbol: true },
+        { value: "|", isSymbol: true },
+        { value: "or", isSymbol: false },
+        { value: "OR", isSymbol: false }
+      ],
+      and: ((_b = options.keywords) == null ? void 0 : _b.and) ? options.keywords.and : [
+        { value: "&&", isSymbol: true },
+        { value: "&", isSymbol: true },
+        { value: "and", isSymbol: false },
+        { value: "AND", isSymbol: false }
+      ],
+      not: ((_c = options.keywords) == null ? void 0 : _c.not) ? options.keywords.not : [
+        { value: "!", isSymbol: true },
+        { value: "not", isSymbol: false },
+        { value: "NOT", isSymbol: false }
+      ]
+    }
+  };
+  return opts;
+}
+export {
+  parseParserOptions
+};

package/dist/helpers/parser/seal.d.ts

@@ -0,0 +1,8 @@
+import type { AnyToken, Nodes } from "../../types/ast.js";
+/**
+ * set and "seals" all parent properties
+ *
+ * @internal
+ */
+export declare function seal(ast: Nodes | AnyToken): void;
+//# sourceMappingURL=seal.d.ts.map

package/dist/helpers/parser/seal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"seal.d.ts","sourceRoot":"","sources":["../../../src/helpers/parser/seal.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAA;AAEzD;;;;GAIG;AACH,wBAAgB,IAAI,CAAC,GAAG,EAAE,KAAK,GAAG,QAAQ,GAAG,IAAI,CAGhD"}

package/dist/helpers/parser/seal.js

@@ -0,0 +1,10 @@
+import { assignParents } from "./assignParents.js";
+import { Node } from "../../ast/classes/Node.js";
+function seal(ast) {
+  if (ast instanceof Node)
+    assignParents(ast);
+  ast.parent = void 0;
+}
+export {
+  seal
+};

package/dist/helpers/parser/setParent.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @internal
+ * @see assignParents
+ */
+export declare const setParent: unique symbol;
+//# sourceMappingURL=setParent.d.ts.map