@witchcraft/expressit 0.0.2

package/dist/ast/classes/GroupNode.js

@@ -0,0 +1,69 @@
+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;
+};
+var __accessCheck = (obj, member, msg) => {
+  if (!member.has(obj))
+    throw TypeError("Cannot " + msg);
+};
+var __privateGet = (obj, member, getter) => {
+  __accessCheck(obj, member, "read from private field");
+  return getter ? getter.call(obj) : member.get(obj);
+};
+var __privateAdd = (obj, member, value) => {
+  if (member.has(obj))
+    throw TypeError("Cannot add the same private member more than once");
+  member instanceof WeakSet ? member.add(obj) : member.set(obj, value);
+};
+var __privateSet = (obj, member, value, setter) => {
+  __accessCheck(obj, member, "write to private field");
+  setter ? setter.call(obj, value) : member.set(obj, value);
+  return value;
+};
+var _parent, _setParent;
+import { Node } from "./Node.js";
+import { ValidToken } from "./ValidToken.js";
+import { AST_TYPE } from "../../types/ast.js";
+class GroupNode extends Node {
+  constructor({ prefix, expression, paren, start, end }) {
+    super(AST_TYPE.GROUP, start, end);
+    /**
+     * If the condition is negated this will contain a "not" **token**, @see ValidToken .
+     *
+     * If `prefixableGroups` is enabled and the group is prefixed by a **condition**, this will be an @see ConditionNode.
+     *
+     * **Careful:** `!(a)` here this would not be a **condition** since it's just a regular negation.
+     *
+     * See examples at @see GroupNode .
+     */
+    __publicField(this, "prefix");
+    __publicField(this, "expression");
+    /**
+     * The parenthesis tokens, @see ValidToken . These will always be defined (although not necessarily with valid tokens).
+     */
+    __publicField(this, "paren");
+    __privateAdd(this, _parent, void 0);
+    __privateAdd(this, _setParent, false);
+    this.prefix = prefix;
+    this.expression = expression;
+    this.paren = paren;
+    this.valid = (this.prefix === void 0 || this.prefix instanceof ValidToken || this.prefix instanceof Node && this.prefix.valid) && this.expression instanceof Node && this.expression.valid && (this.paren === void 0 || this.paren.left instanceof ValidToken && this.paren.right instanceof ValidToken);
+  }
+  get parent() {
+    return __privateGet(this, _parent);
+  }
+  set parent(value) {
+    if (__privateGet(this, _setParent)) {
+      throw new Error("parent property is readonly");
+    }
+    __privateSet(this, _parent, value);
+    __privateSet(this, _setParent, true);
+  }
+}
+_parent = new WeakMap();
+_setParent = new WeakMap();
+export {
+  GroupNode
+};

package/dist/ast/classes/Node.d.ts

@@ -0,0 +1,22 @@
+import type { ArrayNode } from "./ArrayNode.js";
+import type { ConditionNode } from "./ConditionNode.js";
+import type { ExpressionNode } from "./ExpressionNode.js";
+import type { GroupNode } from "./GroupNode.js";
+import type { AST_TYPE } from "../../types/ast.js";
+/**
+ * The base AST node class all node types extend from. Can be used to check if an object is an ast node.
+ * ```ts
+ * if (group.prefix instanceof Node) {
+ * 	//...
+ * }
+ * ```
+ */
+export declare class Node<TType extends AST_TYPE = AST_TYPE, TValid extends boolean = boolean> {
+    readonly type: TType;
+    readonly start: number;
+    readonly end: number;
+    readonly valid: TValid;
+    get parent(): ConditionNode | GroupNode | ExpressionNode | ArrayNode | undefined;
+    constructor(type: TType, start: number, end: number);
+}
+//# sourceMappingURL=Node.d.ts.map

package/dist/ast/classes/Node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Node.d.ts","sourceRoot":"","sources":["../../../src/ast/classes/Node.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC/C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AACzD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAG/C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAA;AAGlD;;;;;;;GAOG;AACH,qBAAa,IAAI,CAChB,KAAK,SAAS,QAAQ,GAAG,QAAQ,EACjC,MAAM,SAAS,OAAO,GAAG,OAAO;IAEhC,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAA;IAEpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IAEtB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IAEpB,QAAQ,CAAC,KAAK,EAAG,MAAM,CAAA;IAEvB,IAAI,MAAM,IACV,aAAa,GACb,SAAS,GACT,cAAc,GACd,SAAS,GACT,SAAS,CAER;gBAEW,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM;CAQnD"}

package/dist/ast/classes/Node.js

@@ -0,0 +1,28 @@
+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 { BooleanParserLibraryError } from "../../helpers/errors.js";
+import { ERROR_CODES } from "../../types/errors.js";
+class Node {
+  constructor(type, start, end) {
+    __publicField(this, "type");
+    __publicField(this, "start");
+    __publicField(this, "end");
+    __publicField(this, "valid");
+    this.type = type;
+    if (start === void 0 || end === void 0) {
+      throw new BooleanParserLibraryError(ERROR_CODES.PARSER_POSITION_ERROR, { start, end });
+    }
+    this.start = start;
+    this.end = end;
+  }
+  get parent() {
+    return void 0;
+  }
+}
+export {
+  Node
+};

package/dist/ast/classes/Token.d.ts

@@ -0,0 +1,27 @@
+import type { ArrayNode } from "./ArrayNode.js";
+import type { ConditionNode } from "./ConditionNode.js";
+import type { ExpressionNode } from "./ExpressionNode.js";
+import type { GroupNode } from "./GroupNode.js";
+import type { VariableNode } from "./VariableNode.js";
+import type { TOKEN_TYPE } from "../../types/ast.js";
+/**
+ * The base class from which @see ValidToken and @see ErrorToken extend.
+ *
+ * Mostly for internal use, and I would suggest using @see AnyToken instead of this for typing things, but can be used to check whether an object is a token:
+ * ```ts
+ * if (group.prefix instanceof Token) {
+ * 	//...
+ * }
+ * ```
+ * Only really takes care of setting the start/end position.
+ */
+export declare class Token<TValid extends boolean = boolean, TType extends TValid extends true ? TOKEN_TYPE : never = TValid extends true ? TOKEN_TYPE : never, TValue extends TValid extends true ? string : never = TValid extends true ? string : never, TExpected extends TValid extends false ? TOKEN_TYPE[] : never = TValid extends false ? TOKEN_TYPE[] : never> {
+    readonly type: TType;
+    readonly value: TValue;
+    readonly expected: TExpected;
+    readonly start: number;
+    readonly end: number;
+    get parent(): VariableNode | GroupNode | ExpressionNode | ArrayNode | ConditionNode;
+    constructor(start: number, end: number);
+}
+//# sourceMappingURL=Token.d.ts.map

package/dist/ast/classes/Token.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Token.d.ts","sourceRoot":"","sources":["../../../src/ast/classes/Token.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC/C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AACzD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC/C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAGrD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AAGpD;;;;;;;;;;GAUG;AACH,qBAAa,KAAK,CACjB,MAAM,SAAS,OAAO,GAAG,OAAO,EAChC,KAAK,SACJ,MAAM,SAAS,IAAI,GAAG,UAAU,GAAG,KAAK,GACxC,MAAM,SAAS,IAAI,GAAG,UAAU,GAAG,KAAK,EACzC,MAAM,SACL,MAAM,SAAS,IAAI,GAAG,MAAM,GAAG,KAAK,GACpC,MAAM,SAAS,IAAI,GAAG,MAAM,GAAG,KAAK,EACrC,SAAS,SACR,MAAM,SAAS,KAAK,GAAG,UAAU,EAAE,GAAG,KAAK,GAC3C,MAAM,SAAS,KAAK,GAAG,UAAU,EAAE,GAAG,KAAK;IAE5C,QAAQ,CAAC,IAAI,EAAG,KAAK,CAAA;IAErB,QAAQ,CAAC,KAAK,EAAG,MAAM,CAAA;IAEvB,QAAQ,CAAC,QAAQ,EAAG,SAAS,CAAA;IAE7B,QAAQ,CAAC,KAAK,EAAG,MAAM,CAAA;IAEvB,QAAQ,CAAC,GAAG,EAAG,MAAM,CAAA;IAErB,IAAI,MAAM,IAAI,YAAY,GAC1B,SAAS,GACT,cAAc,GACd,SAAS,GACT,aAAa,CAEZ;gBAEW,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM;CAOtC"}

package/dist/ast/classes/Token.js

@@ -0,0 +1,28 @@
+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 { BooleanParserLibraryError } from "../../helpers/errors.js";
+import { ERROR_CODES } from "../../types/errors.js";
+class Token {
+  constructor(start, end) {
+    __publicField(this, "type");
+    __publicField(this, "value");
+    __publicField(this, "expected");
+    __publicField(this, "start");
+    __publicField(this, "end");
+    if (start === void 0 || end === void 0) {
+      throw new BooleanParserLibraryError(ERROR_CODES.PARSER_POSITION_ERROR, { start, end });
+    }
+    this.start = start;
+    this.end = end;
+  }
+  get parent() {
+    return void 0;
+  }
+}
+export {
+  Token
+};

package/dist/ast/classes/ValidToken.d.ts

@@ -0,0 +1,26 @@
+import type { ArrayNode } from "./ArrayNode.js";
+import type { ConditionNode } from "./ConditionNode.js";
+import type { ExpressionNode } from "./ExpressionNode.js";
+import type { GroupNode } from "./GroupNode.js";
+import { Token } from "./Token.js";
+import type { VariableNode } from "./VariableNode.js";
+import type { TOKEN_TYPE } from "../../types/ast.js";
+/**
+ * The class for all *valid* tokens.
+ *
+ * Valid tokens always have a value, even if it might be an empty string.
+ */
+export declare class ValidToken<TType extends TOKEN_TYPE = TOKEN_TYPE> extends Token<true, TType, string, never> {
+    #private;
+    readonly type: TType;
+    readonly value: string;
+    get parent(): VariableNode | GroupNode | ExpressionNode | ConditionNode | ArrayNode;
+    set parent(value: VariableNode | GroupNode | ExpressionNode | ConditionNode | ArrayNode);
+    constructor({ type, value, start, end }: {
+        type: TType;
+        value: string;
+        start: number;
+        end: number;
+    });
+}
+//# sourceMappingURL=ValidToken.d.ts.map

package/dist/ast/classes/ValidToken.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ValidToken.d.ts","sourceRoot":"","sources":["../../../src/ast/classes/ValidToken.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC/C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AACzD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC/C,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAClC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAErD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AAGpD;;;;GAIG;AACH,qBAAa,UAAU,CACtB,KAAK,SAAS,UAAU,GAAG,UAAU,CACpC,SAAQ,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC;;IAC1C,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAA;IAEpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IAItB,IAAI,MAAM,IACR,YAAY,GACZ,SAAS,GACT,cAAc,GACd,aAAa,GACb,SAAS,CAEV;IAED,IAAI,MAAM,CAAC,KAAK,EACd,YAAY,GACZ,SAAS,GACT,cAAc,GACd,aAAa,GACb,SAAS,EAIV;gBAEW,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;QACxC,IAAI,EAAE,KAAK,CAAA;QACX,KAAK,EAAE,MAAM,CAAA;QACb,KAAK,EAAE,MAAM,CAAA;QACb,GAAG,EAAE,MAAM,CAAA;KACX;CAMD"}

package/dist/ast/classes/ValidToken.js

@@ -0,0 +1,49 @@
+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;
+};
+var __accessCheck = (obj, member, msg) => {
+  if (!member.has(obj))
+    throw TypeError("Cannot " + msg);
+};
+var __privateGet = (obj, member, getter) => {
+  __accessCheck(obj, member, "read from private field");
+  return getter ? getter.call(obj) : member.get(obj);
+};
+var __privateAdd = (obj, member, value) => {
+  if (member.has(obj))
+    throw TypeError("Cannot add the same private member more than once");
+  member instanceof WeakSet ? member.add(obj) : member.set(obj, value);
+};
+var __privateSet = (obj, member, value, setter) => {
+  __accessCheck(obj, member, "write to private field");
+  setter ? setter.call(obj, value) : member.set(obj, value);
+  return value;
+};
+var _parent;
+import { Token } from "./Token.js";
+class ValidToken extends Token {
+  constructor({ type, value, start, end }) {
+    super(start, end);
+    __publicField(this, "type");
+    __publicField(this, "value");
+    __privateAdd(this, _parent, void 0);
+    this.type = type;
+    this.value = value;
+  }
+  get parent() {
+    return __privateGet(this, _parent);
+  }
+  set parent(value) {
+    if (__privateGet(this, _parent)) {
+      throw new Error("parent property is readonly");
+    }
+    __privateSet(this, _parent, value);
+  }
+}
+_parent = new WeakMap();
+export {
+  ValidToken
+};

package/dist/ast/classes/VariableNode.d.ts

@@ -0,0 +1,33 @@
+import type { ArrayNode } from "./ArrayNode.js";
+import type { ConditionNode } from "./ConditionNode.js";
+import type { ErrorToken } from "./ErrorToken.js";
+import { Node } from "./Node.js";
+import { ValidToken } from "./ValidToken.js";
+import { type AnyToken, AST_TYPE, type NodeDelimiters, type TOKEN_TYPE, type TokenQuoteTypes } from "../../types/ast.js";
+/**
+ * A variable represents **just** a string value (NOT it's boolean value).
+ *
+ * The parser will never return just a variable, they are always wrapped in an @see ConditionNode to give them a boolean value.
+ *
+ * A variable might or might not be quoted. If it is, the `quote` property will contain the quote tokens, @see ValidToken . While they will always be of the same quote type, one might be valid while the other might not (@see ErrorToken).
+ *
+ * `value` will contain the string value of the variable. The text is not processed and might still contain escaped characters (even if unquoted!) that need to be removed to get the intended value. This is so that the position of the node is accurate. @see evaluate will take care of unescaping when needed.
+ *
+ * If `prefixableStrings` is true, the `prefix` property might contain a value token.
+ */
+export declare class VariableNode<TValid extends boolean = boolean> extends Node<AST_TYPE.VARIABLE, TValid> {
+    #private;
+    readonly value: TValid extends boolean ? AnyToken<TOKEN_TYPE.VALUE> : TValid extends true ? ValidToken<TOKEN_TYPE.VALUE> : ErrorToken<TOKEN_TYPE.VALUE>;
+    readonly prefix?: ValidToken<TOKEN_TYPE.VALUE>;
+    readonly quote?: NodeDelimiters<TokenQuoteTypes, TokenQuoteTypes>;
+    get parent(): ConditionNode | ArrayNode | undefined;
+    set parent(value: ConditionNode | ArrayNode | undefined);
+    constructor({ prefix, value, quote, start, end }: {
+        prefix?: VariableNode<TValid>["prefix"];
+        value: VariableNode<TValid>["value"];
+        quote?: VariableNode<TValid>["quote"];
+        start: number;
+        end: number;
+    });
+}
+//# sourceMappingURL=VariableNode.d.ts.map

package/dist/ast/classes/VariableNode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VariableNode.d.ts","sourceRoot":"","sources":["../../../src/ast/classes/VariableNode.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC/C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AACvD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AACjD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAE5C,OAAO,EAAE,KAAK,QAAQ,EAAE,QAAQ,EAAE,KAAK,cAAc,EAAE,KAAK,UAAU,EAAE,KAAK,eAAe,EAAE,MAAM,oBAAoB,CAAA;AAExH;;;;;;;;;;GAUG;AACH,qBAAa,YAAY,CACxB,MAAM,SAAS,OAAO,GAAG,OAAO,CAC/B,SAAQ,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;;IACxC,QAAQ,CAAC,KAAK,EAAE,MAAM,SAAS,OAAO,GACnC,QAAQ,CAAC,UAAU,CAAC,KAAK,CAAC,GAC1B,MAAM,SAAS,IAAI,GACnB,UAAU,CAAC,UAAU,CAAC,KAAK,CAAC,GAC7B,UAAU,CAAC,UAAU,CAAC,KAAK,CAAC,CAAA;IAE9B,QAAQ,CAAC,MAAM,CAAC,EAAE,UAAU,CAAC,UAAU,CAAC,KAAK,CAAC,CAAA;IAE9C,QAAQ,CAAC,KAAK,CAAC,EAAE,cAAc,CAAC,eAAe,EAAE,eAAe,CAAC,CAAA;IAMjE,IAAI,MAAM,IAAI,aAAa,GAAG,SAAS,GAAG,SAAS,CAElD;IAED,IAAI,MAAM,CAAC,KAAK,EAAE,aAAa,GAAG,SAAS,GAAG,SAAS,EAItD;gBAEW,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;QACjD,MAAM,CAAC,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,CAAA;QACvC,KAAK,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAA;QACpC,KAAK,CAAC,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAA;QACrC,KAAK,EAAE,MAAM,CAAA;QACb,GAAG,EAAE,MAAM,CAAA;KACX;CAcD"}

package/dist/ast/classes/VariableNode.js

@@ -0,0 +1,58 @@
+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;
+};
+var __accessCheck = (obj, member, msg) => {
+  if (!member.has(obj))
+    throw TypeError("Cannot " + msg);
+};
+var __privateGet = (obj, member, getter) => {
+  __accessCheck(obj, member, "read from private field");
+  return getter ? getter.call(obj) : member.get(obj);
+};
+var __privateAdd = (obj, member, value) => {
+  if (member.has(obj))
+    throw TypeError("Cannot add the same private member more than once");
+  member instanceof WeakSet ? member.add(obj) : member.set(obj, value);
+};
+var __privateSet = (obj, member, value, setter) => {
+  __accessCheck(obj, member, "write to private field");
+  setter ? setter.call(obj, value) : member.set(obj, value);
+  return value;
+};
+var _parent, _setParent;
+import { Node } from "./Node.js";
+import { ValidToken } from "./ValidToken.js";
+import { AST_TYPE } from "../../types/ast.js";
+class VariableNode extends Node {
+  constructor({ prefix, value, quote, start, end }) {
+    super(AST_TYPE.VARIABLE, start, end);
+    __publicField(this, "value");
+    __publicField(this, "prefix");
+    // todo
+    __publicField(this, "quote");
+    __privateAdd(this, _parent, void 0);
+    __privateAdd(this, _setParent, false);
+    this.prefix = prefix;
+    this.value = value;
+    this.quote = quote;
+    this.valid = this.value instanceof ValidToken && (this.quote === void 0 || this.quote.left instanceof ValidToken && this.quote.right instanceof ValidToken);
+  }
+  get parent() {
+    return __privateGet(this, _parent);
+  }
+  set parent(value) {
+    if (__privateGet(this, _setParent)) {
+      throw new Error("parent property is readonly");
+    }
+    __privateSet(this, _parent, value);
+    __privateSet(this, _setParent, true);
+  }
+}
+_parent = new WeakMap();
+_setParent = new WeakMap();
+export {
+  VariableNode
+};

package/dist/ast/classes/index.d.ts

@@ -0,0 +1,12 @@
+export { ArrayNode } from "./ArrayNode.js";
+export { Condition } from "./Condition.js";
+export { ConditionNode } from "./ConditionNode.js";
+export { ErrorToken } from "./ErrorToken.js";
+export { Expression } from "./Expression.js";
+export { ExpressionNode } from "./ExpressionNode.js";
+export { GroupNode } from "./GroupNode.js";
+export { Node } from "./Node.js";
+export { Token } from "./Token.js";
+export { ValidToken } from "./ValidToken.js";
+export { VariableNode } from "./VariableNode.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/ast/classes/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/ast/classes/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC1C,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AACpD,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC1C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAClC,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA"}

package/dist/ast/classes/index.js

@@ -0,0 +1,24 @@
+import { ArrayNode } from "./ArrayNode.js";
+import { Condition } from "./Condition.js";
+import { ConditionNode } from "./ConditionNode.js";
+import { ErrorToken } from "./ErrorToken.js";
+import { Expression } from "./Expression.js";
+import { ExpressionNode } from "./ExpressionNode.js";
+import { GroupNode } from "./GroupNode.js";
+import { Node } from "./Node.js";
+import { Token } from "./Token.js";
+import { ValidToken } from "./ValidToken.js";
+import { VariableNode } from "./VariableNode.js";
+export {
+  ArrayNode,
+  Condition,
+  ConditionNode,
+  ErrorToken,
+  Expression,
+  ExpressionNode,
+  GroupNode,
+  Node,
+  Token,
+  ValidToken,
+  VariableNode
+};

package/dist/ast/handlers.d.ts

@@ -0,0 +1,42 @@
+import { ArrayNode } from "./classes/ArrayNode.js";
+import { ConditionNode } from "./classes/ConditionNode.js";
+import { ErrorToken } from "./classes/ErrorToken.js";
+import { ExpressionNode } from "./classes/ExpressionNode.js";
+import { GroupNode } from "./classes/GroupNode.js";
+import { ValidToken } from "./classes/ValidToken.js";
+import { VariableNode } from "./classes/VariableNode.js";
+import { type AnyToken, type Position, TOKEN_TYPE, type TokenBooleanTypes, type TokenQuoteTypes } from "../types/ast.js";
+declare function error<T extends TOKEN_TYPE>(pos: number, expected: T[]): ErrorToken<T>;
+export declare const token: {
+    value: (value: string | undefined, pos: Position) => AnyToken<TOKEN_TYPE.VALUE>;
+    custom: (value: string | undefined, pos: Position) => AnyToken<TOKEN_TYPE.OP_CUSTOM>;
+    sep: (value: string | undefined, pos: Position) => AnyToken<TOKEN_TYPE.OP_EXPANDED_SEP>;
+};
+/** We want to handle all the types outside the grammar file. This makes it easier without trying to check the value. */
+export declare const delimiter: {
+    parenL: (value: string | undefined, pos: Position) => ValidToken<TOKEN_TYPE.PARENL> | undefined;
+    parenR: (value: string | undefined, pos: Position) => ValidToken<TOKEN_TYPE.PARENR> | undefined;
+    bracketL: (value: string | undefined, pos: Position) => ValidToken<TOKEN_TYPE.BRACKETL> | undefined;
+    bracketR: (value: string | undefined, pos: Position) => ValidToken<TOKEN_TYPE.BRACKETR> | undefined;
+    double: (value: string | undefined, pos: Position) => ValidToken<TOKEN_TYPE.DOUBLEQUOTE> | undefined;
+    single: (value: string | undefined, pos: Position) => ValidToken<TOKEN_TYPE.SINGLEQUOTE> | undefined;
+    regex: (value: string | undefined, pos: Position) => ValidToken<TOKEN_TYPE.REGEX> | undefined;
+    tick: (value: string | undefined, pos: Position) => ValidToken<TOKEN_TYPE.BACKTICK> | undefined;
+    tokenError: typeof error;
+};
+export declare const operator: {
+    and: (value: string, pos: Position) => ValidToken<TOKEN_TYPE.AND>;
+    or: (value: string, pos: Position) => ValidToken<TOKEN_TYPE.OR>;
+    not: (value: string, pos: Position) => ValidToken<TOKEN_TYPE.NOT>;
+};
+export declare function variable(prefix: ValidToken<TOKEN_TYPE.VALUE> | null | undefined, quoteL: AnyToken<TokenQuoteTypes> | null | undefined, value: AnyToken<TOKEN_TYPE.VALUE> | null | undefined, quoteR: AnyToken<TokenQuoteTypes> | null | undefined, flags?: ValidToken<TOKEN_TYPE.VALUE>): VariableNode;
+export declare function condition(not: ValidToken<TOKEN_TYPE.NOT> | null | undefined, property: VariableNode | null | undefined, { propertyOperator, sepL, sepR }?: {
+    propertyOperator?: ConditionNode["propertyOperator"] | null;
+    sepL?: ValidToken<TOKEN_TYPE.OP_EXPANDED_SEP> | null;
+    sepR?: ValidToken<TOKEN_TYPE.OP_EXPANDED_SEP> | null;
+}, value?: VariableNode | GroupNode | ArrayNode | null): ConditionNode;
+export declare function expression(left: ConditionNode | GroupNode | null | undefined, operator: ValidToken<TokenBooleanTypes> | null | undefined, right: ConditionNode | GroupNode | null | undefined): ExpressionNode;
+export declare function group(operator: ValidToken<TOKEN_TYPE.NOT> | null | undefined, prefix: ConditionNode | null | undefined, parenL: ValidToken<TOKEN_TYPE.PARENL> | null | undefined, condition: GroupNode["expression"], parenR: ValidToken<TOKEN_TYPE.PARENR> | null | undefined): GroupNode;
+export declare function array(bracketL: ValidToken<TOKEN_TYPE.BRACKETL>, values: VariableNode[], bracketR: ValidToken<TOKEN_TYPE.BRACKETR> | null | undefined): ArrayNode;
+export {};
+//# sourceMappingURL=handlers.d.ts.map

package/dist/ast/handlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handlers.d.ts","sourceRoot":"","sources":["../../src/ast/handlers.ts"],"names":[],"mappings":"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"}

package/dist/ast/handlers.js

@@ -0,0 +1,150 @@
+import { ArrayNode } from "./classes/ArrayNode.js";
+import { ConditionNode } from "./classes/ConditionNode.js";
+import { ErrorToken } from "./classes/ErrorToken.js";
+import { ExpressionNode } from "./classes/ExpressionNode.js";
+import { GroupNode } from "./classes/GroupNode.js";
+import { ValidToken } from "./classes/ValidToken.js";
+import { VariableNode } from "./classes/VariableNode.js";
+import { TOKEN_TYPE } from "../types/ast.js";
+function error(pos, expected) {
+  if (pos === void 0)
+    throw new Error("should never happen, passed undefined position for error token");
+  return new ErrorToken({ expected, start: pos, end: pos });
+}
+const operators = (type) => (value, pos) => new ValidToken({ value, type, ...pos });
+const delimiters = (type) => (value, pos) => (
+  // check must be falsy, we want to return undefined when given ""
+  value ? new ValidToken({ value, type, ...pos }) : void 0
+);
+const maybeToken = (type) => (value, pos) => {
+  if (value === void 0) {
+    return error(pos.end, [type]);
+  } else {
+    return new ValidToken({ value, type, ...pos });
+  }
+};
+const token = {
+  value: maybeToken(TOKEN_TYPE.VALUE),
+  custom: maybeToken(TOKEN_TYPE.OP_CUSTOM),
+  sep: maybeToken(TOKEN_TYPE.OP_EXPANDED_SEP)
+};
+const delimiter = {
+  parenL: delimiters(TOKEN_TYPE.PARENL),
+  parenR: delimiters(TOKEN_TYPE.PARENR),
+  bracketL: delimiters(TOKEN_TYPE.BRACKETL),
+  bracketR: delimiters(TOKEN_TYPE.BRACKETR),
+  double: delimiters(TOKEN_TYPE.DOUBLEQUOTE),
+  single: delimiters(TOKEN_TYPE.SINGLEQUOTE),
+  regex: delimiters(TOKEN_TYPE.REGEX),
+  tick: delimiters(TOKEN_TYPE.BACKTICK),
+  tokenError: error
+};
+const operator = {
+  and: operators(TOKEN_TYPE.AND),
+  or: operators(TOKEN_TYPE.OR),
+  not: operators(TOKEN_TYPE.NOT)
+};
+function variable(prefix, quoteL, value, quoteR, flags) {
+  var _a;
+  const node = {
+    prefix: prefix ?? void 0,
+    value: value ?? error((prefix == null ? void 0 : prefix.end) ?? (quoteL == null ? void 0 : quoteL.end) ?? (quoteR == null ? void 0 : quoteR.start), [TOKEN_TYPE.VALUE]),
+    start: (prefix == null ? void 0 : prefix.start) ?? (quoteL == null ? void 0 : quoteL.start) ?? (value == null ? void 0 : value.start) ?? (quoteR == null ? void 0 : quoteR.start),
+    end: (quoteR == null ? void 0 : quoteR.end) ?? (value == null ? void 0 : value.end) ?? (quoteL == null ? void 0 : quoteL.end) ?? (prefix == null ? void 0 : prefix.end)
+  };
+  if (quoteL || quoteR) {
+    node.quote = {
+      left: quoteL ?? error(node.value.start, [quoteR.type]),
+      right: quoteR ?? error(node.value.end, [quoteL.type])
+    };
+    if (flags) {
+      node.quote.flags = flags;
+      node.end = (_a = node.quote) == null ? void 0 : _a.flags.end;
+    }
+  }
+  const instance = new VariableNode(node);
+  return instance;
+}
+function condition(not, property, { propertyOperator, sepL, sepR } = {}, value) {
+  var _a;
+  const start = (not == null ? void 0 : not.start) ?? (property == null ? void 0 : property.start) ?? (sepL == null ? void 0 : sepL.start) ?? (propertyOperator == null ? void 0 : propertyOperator.start) ?? (sepR == null ? void 0 : sepR.start) ?? (value == null ? void 0 : value.start);
+  const end = (value == null ? void 0 : value.end) ?? (sepR == null ? void 0 : sepR.end) ?? (propertyOperator == null ? void 0 : propertyOperator.end) ?? (sepL == null ? void 0 : sepL.end) ?? (property == null ? void 0 : property.end) ?? (not == null ? void 0 : not.end);
+  const node = {
+    value: value ? value : error(end, [TOKEN_TYPE.VALUE]),
+    start,
+    end
+  };
+  if (not) {
+    node.operator = not;
+  }
+  if (property)
+    node.property = property;
+  if (propertyOperator)
+    node.propertyOperator = propertyOperator;
+  if (sepL || sepR) {
+    node.sep = {};
+    if (sepL) {
+      node.sep.left = sepL;
+      node.property || (node.property = error(sepL.start, [TOKEN_TYPE.VALUE]));
+      node.propertyOperator || (node.propertyOperator = error((sepL == null ? void 0 : sepL.end) ?? (sepR == null ? void 0 : sepR.start), [TOKEN_TYPE.VALUE]));
+    }
+    if (sepR)
+      node.sep.right = sepR;
+    else if (!node.value || node.value instanceof VariableNode) {
+      node.sep.right = error(((_a = node.value) == null ? void 0 : _a.start) ?? end, [TOKEN_TYPE.OP_EXPANDED_SEP]);
+    }
+  } else if (propertyOperator) {
+    node.property || (node.property = error(propertyOperator.start, [TOKEN_TYPE.VALUE]));
+  }
+  const instance = new ConditionNode(node);
+  return instance;
+}
+function expression(left, operator2, right) {
+  const instance = new ExpressionNode({
+    left: left ?? error((operator2 == null ? void 0 : operator2.start) ?? (right == null ? void 0 : right.start), [TOKEN_TYPE.VALUE]),
+    operator: operator2 ?? error((left == null ? void 0 : left.end) ?? (right == null ? void 0 : right.start), [TOKEN_TYPE.AND, TOKEN_TYPE.OR]),
+    right: right ?? error((operator2 == null ? void 0 : operator2.end) ?? (left == null ? void 0 : left.end), [TOKEN_TYPE.VALUE]),
+    start: (left == null ? void 0 : left.start) ?? (operator2 == null ? void 0 : operator2.start) ?? (right == null ? void 0 : right.start),
+    end: (right == null ? void 0 : right.end) ?? (operator2 == null ? void 0 : operator2.end) ?? (left == null ? void 0 : left.end)
+  });
+  return instance;
+}
+function group(operator2, prefix, parenL, condition2, parenR) {
+  const node = {
+    prefix: prefix ?? operator2 ?? void 0,
+    expression: condition2 ?? error((parenL == null ? void 0 : parenL.end) ?? (parenR == null ? void 0 : parenR.start), [TOKEN_TYPE.VALUE]),
+    paren: {
+      left: parenL ?? error((prefix == null ? void 0 : prefix.end) ?? (operator2 == null ? void 0 : operator2.end) ?? (condition2 == null ? void 0 : condition2.start) ?? (parenR == null ? void 0 : parenR.start), [TOKEN_TYPE.PARENL]),
+      right: parenR ?? error((condition2 == null ? void 0 : condition2.end) ?? (parenL == null ? void 0 : parenL.end), [TOKEN_TYPE.PARENR])
+    },
+    start: (prefix == null ? void 0 : prefix.start) ?? (operator2 == null ? void 0 : operator2.start) ?? (parenL == null ? void 0 : parenL.start) ?? (condition2 == null ? void 0 : condition2.start) ?? (parenR == null ? void 0 : parenR.start),
+    end: (parenR == null ? void 0 : parenR.end) ?? (condition2 == null ? void 0 : condition2.end) ?? (parenL == null ? void 0 : parenL.end) ?? (operator2 == null ? void 0 : operator2.end) ?? (prefix == null ? void 0 : prefix.end)
+  };
+  const instance = new GroupNode(node);
+  return instance;
+}
+function array(bracketL, values, bracketR) {
+  var _a, _b;
+  const node = {
+    values,
+    bracket: {
+      left: bracketL,
+      // always valid for now
+      right: bracketR ?? error(((_a = values[values.length - 1]) == null ? void 0 : _a.end) ?? (bracketL == null ? void 0 : bracketL.end), [TOKEN_TYPE.BRACKETR])
+    },
+    start: bracketL.start,
+    end: (bracketR == null ? void 0 : bracketR.end) ?? ((_b = values[values.length - 1]) == null ? void 0 : _b.end) ?? bracketL.end
+  };
+  const instance = new ArrayNode(node);
+  return instance;
+}
+export {
+  array,
+  condition,
+  delimiter,
+  expression,
+  group,
+  operator,
+  token,
+  variable
+};

package/dist/ast/index.d.ts

@@ -0,0 +1,4 @@
+export * as builders from "./builders/index.js";
+export * as classes from "./classes/index.js";
+export { token } from "./handlers.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ast/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,QAAQ,MAAM,qBAAqB,CAAA;AAC/C,OAAO,KAAK,OAAO,MAAM,oBAAoB,CAAA;AAC7C,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAA"}

package/dist/ast/index.js

@@ -0,0 +1,8 @@
+import * as index from "./builders/index.js";
+import * as index$1 from "./classes/index.js";
+import { token } from "./handlers.js";
+export {
+  index as builders,
+  index$1 as classes,
+  token
+};

package/dist/examples/advancedValueComparer.d.ts

@@ -0,0 +1,3 @@
+import type { ValueQuery } from "../types/parser.js";
+export declare function valueComparer(contextValue: string, { operator, prefix, value, isRegex, regexFlags }: ValueQuery): boolean;
+//# sourceMappingURL=advancedValueComparer.d.ts.map

package/dist/examples/advancedValueComparer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"advancedValueComparer.d.ts","sourceRoot":"","sources":["../../src/examples/advancedValueComparer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AAKpD,wBAAgB,aAAa,CAAC,YAAY,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,EAAE,UAAU,GAAG,OAAO,CAyBzH"}