@witchcraft/expressit 0.1.2 → 0.2.0

package/src/utils/getCursorInfo.ts

@@ -3,14 +3,12 @@ import { unreachable } from "@alanscodelog/utils/unreachable.js"
 
 import { extractTokens } from "./extractTokens.js"
 
-import { ErrorToken } from "../ast/classes/ErrorToken.js"
-import { ValidToken } from "../ast/classes/ValidToken.js"
 import { type AnyToken, type ParserResults } from "../types/ast.js"
 import { type CursorInfo } from "../types/autocomplete.js"
 
 
 /**
- * Returns a @see CursorInfo object, see it for details.
+ * Returns a {@link CursorInfo} object, see it for details.
  */
 export function getCursorInfo(
 	input: string,
@@ -42,7 +40,7 @@ export function getCursorInfo(
 	for (const token of tokens) {
 		// assign valid tokens until maybe real previous token overwrites it
 		if (token.end <= index) {
-			if (token instanceof ValidToken) {
+			if (token.valid) {
 				info.prev = token
 				info.valid.prev = token
 			} else if (token.end !== index) {
@@ -51,7 +49,7 @@ export function getCursorInfo(
 			}
 		}
 		if (token.start < index && token.end > index) {
-			if (token instanceof ErrorToken) {
+			if (!token.valid) {
 				unreachable()
 			} else {
 				info.at = token
@@ -59,7 +57,7 @@ export function getCursorInfo(
 		}
 		if (token.start >= index) {
 			info.next ||= token
-			if (token instanceof ValidToken && !info.valid.next) {
+			if (token.valid && !info.valid.next) {
 				info.valid.next = token
 				break
 			}

package/src/utils/getOppositeDelimiter.ts

@@ -1,36 +1,37 @@
 import { unreachable } from "@alanscodelog/utils/unreachable.js"
 
+import type { generateParentsMap } from "./generateParentsMap.js"
 import { isBracket } from "./isBracket.js"
 import { isDelimiter } from "./isDelimiter.js"
 import { isParen } from "./isParen.js"
 import { isQuote } from "./isQuote.js"
 
-import type { ArrayNode } from "../ast/classes/ArrayNode.js"
-import type { ConditionNode } from "../ast/classes/ConditionNode.js"
-import type { GroupNode } from "../ast/classes/GroupNode.js"
-import type { VariableNode } from "../ast/classes/VariableNode.js"
-import { type AnyToken, TOKEN_TYPE, type TokenDelimiterTypes } from "../types/ast.js"
+import { type AnyToken, type ArrayNode, type ConditionNode,type GroupNode, TOKEN_TYPE, type TokenDelimiterTypes, type VariableNode } from "../types/ast.js"
 
 /**
  * Given a delimiter token, returns it's opposite pair, or undefined if the type passed was not a delimiter token (so you can pass any type without checking).
  */
-export function getOppositeDelimiter(token: AnyToken): AnyToken<TokenDelimiterTypes> | undefined {
+export function getOppositeDelimiter(
+	token: AnyToken,
+	parentsMap: ReturnType<typeof generateParentsMap>
+): AnyToken<TokenDelimiterTypes> | undefined {
+	const parent = parentsMap.get(token)
 	if (!isDelimiter(token)) throw new Error("Token is not a delimiter type.")
 	if (isParen(token)) {
-		const paren = (token.parent as GroupNode).paren
+		const paren = (parent as GroupNode).paren
 		const opposite = paren.left === token ? "right" : "left"
 		return paren[opposite]
 	} else if (isBracket(token)) {
-		const bracket = (token.parent as ArrayNode).bracket
+		const bracket = (parent as ArrayNode).bracket
 		const opposite = bracket.left === token ? "right" : "left"
 		return bracket[opposite]
 	} else if (isQuote(token)) {
-		const quotes = (token.parent as VariableNode).quote
+		const quotes = (parent as VariableNode).quote
 		if (quotes === undefined) unreachable()
 		const opposite = quotes.left === token ? "right" : "left"
 		return quotes[opposite]
 	} else if (token.type === TOKEN_TYPE.OP_EXPANDED_SEP) {
-		const sep = (token.parent as ConditionNode).sep
+		const sep = (parent as ConditionNode).sep
 		if (sep === undefined) unreachable()
 		const opposite = sep.left === token ? "right" : "left"
 		return sep[opposite]

package/src/utils/getParent.ts

@@ -0,0 +1,16 @@
+import type { generateParentsMap } from "./generateParentsMap.js"
+
+import type { AnyToken, ArrayNode, ConditionNode, ExpressionNode, GroupNode,ParentTypes, VariableNode } from "../types/ast.js"
+/** See {@link generateParentsMap} */
+export function getParent<
+	T extends
+	| ExpressionNode
+	| ConditionNode
+	| GroupNode
+	| VariableNode
+	| ArrayNode
+	| AnyToken
+	| undefined,
+>(node: T, map: ReturnType<typeof generateParentsMap>): ParentTypes<T> | undefined {
+	return map.get(node as any) as ParentTypes<T>
+}

package/src/utils/getSurroundingErrors.ts

@@ -1,9 +1,9 @@
 /**
- * Mostly for internal use by @see autosuggest.
+ * Mostly for internal use by {@link autosuggest}.
  *
  * Returns all error tokens immediately before/after cursor (since there might be multiple error tokens one after the other).
  *
- * The errors are sorted by closeness to the given cursor (inside @see CursorInfo), with quote errors having priority, then paren errors, then any other errors. They can be sorted by closeness because although two errors might follow each other, their positions might be different because of whitespace, but they can still be fixed from any cursor position between their ends.
+ * The errors are sorted by closeness to the given cursor (inside {@link CursorInfo}), with quote errors having priority, then paren errors, then any other errors. They can be sorted by closeness because although two errors might follow each other, their positions might be different because of whitespace, but they can still be fixed from any cursor position between their ends.
  *
  * For example:
  * ```
@@ -19,8 +19,7 @@
  * ```
  */
 
-import { ErrorToken } from "../ast/classes/ErrorToken.js"
-import { type AnyToken, TOKEN_TYPE } from "../types/ast.js"
+import { type AnyToken,type ErrorToken,TOKEN_TYPE } from "../types/ast.js"
 import type { CursorInfo } from "../types/autocomplete.js"
 
 
@@ -31,13 +30,15 @@ export function getSurroundingErrors(tokens: AnyToken[], token: CursorInfo): Err
 	let iNext: number = tokens[i] === token.next ? i : i + 1
 	let iPrev: number = tokens[i] === token.next ? i - 1 : i
 
-	const errors = []
-	while (tokens[iNext] instanceof ErrorToken) {
-		errors.push(tokens[iNext])
+	const errors: ErrorToken[] = []
+	// eslint-disable-next-line @typescript-eslint/no-unnecessary-boolean-literal-compare
+	while (tokens[iNext]?.valid === false) {
+		errors.push(tokens[iNext] as ErrorToken)
 		iNext++
 	}
-	while (tokens[iPrev] instanceof ErrorToken) {
-		errors.push(tokens[iPrev])
+	// eslint-disable-next-line @typescript-eslint/no-unnecessary-boolean-literal-compare
+	while (tokens[iPrev]?.valid === false) {
+		errors.push(tokens[iPrev] as ErrorToken)
 		iPrev--
 	}
 

package/src/utils/index.ts

@@ -1,11 +1,15 @@
 /* Autogenerated Index */
 
 export { extractTokens } from "./extractTokens.js"
+export { generateParentsMap } from "./generateParentsMap.js"
 export { getCursorInfo } from "./getCursorInfo.js"
 export { getOppositeDelimiter } from "./getOppositeDelimiter.js"
+export { getParent } from "./getParent.js"
 export { getSurroundingErrors } from "./getSurroundingErrors.js"
 export { isBracket } from "./isBracket.js"
 export { isDelimiter } from "./isDelimiter.js"
+export { isNode } from "./isNode.js"
 export { isParen } from "./isParen.js"
 export { isQuote } from "./isQuote.js"
+export { isToken } from "./isToken.js"
 export { prettyAst } from "./prettyAst.js"

package/src/utils/isNode.ts

@@ -0,0 +1,12 @@
+import type { Node } from "../types/ast.js"
+/**
+ * A simple wrapper around checking an object's `isNode` property that casts the object to a {@link Nodes} type for typescript.
+ *
+ * Does not actually do any checking of the object, and assumes the object was created using one of the `create*` functions.
+ *
+ * Also note that passing a NormalizedCondition or NormalizedExpression will return false even though they have their own {@link AST_TYPE} since they are not technically nodes (with positions).
+ */
+export function isNode(node: any): node is Node {
+	return node?.isNode === true
+}
+

package/src/utils/isToken.ts

@@ -0,0 +1,10 @@
+import type { ErrorToken, ValidToken } from "../types/ast.js"
+
+/**
+ * A simple wrapper around checking an object's `isToken` property that casts the object to a {@link ValidToken} or {@link ErrorToken} for typescript.
+ *
+ * Does not actually do any checking of the object, and assumes the object was created using one of the `create*` functions.
+ */
+export function isToken(token: any): token is ValidToken | ErrorToken {
+	return token?.isToken === true
+}

package/src/utils/prettyAst.ts

@@ -4,8 +4,9 @@ import { isBlank } from "@alanscodelog/utils/isBlank.js"
 import { type AddParameters } from "@alanscodelog/utils/types"
 import { unreachable } from "@alanscodelog/utils/unreachable.js"
 
-import { ArrayNode, ConditionNode, ErrorToken, ExpressionNode, GroupNode, ValidToken, VariableNode } from "../ast/classes/index.js"
-import { type AnyToken, type ParserResults, TOKEN_TYPE } from "../types/ast.js"
+import { isToken } from "./isToken.js"
+
+import { type AnyToken, type ArrayNode, AST_TYPE,type ConditionNode,type GroupNode, type ParserResults, TOKEN_TYPE, type VariableNode } from "../types/ast.js"
 
 
 type Colors = {
@@ -80,30 +81,32 @@ export function prettyAst(
 		typeof __,
 		typeof extra,
 	]>
-	if (ast instanceof ValidToken) {
-		const value = `${ast.value}`
-		return `TOKEN ${pos} ${c.values}${quote}${value}${quote}${c.reset}${extra}`
-	}
-	if (ast instanceof ErrorToken) {
-		const value = `[${ast.expected.join(", ")}]`
-		return `ERROR ${pos} ${c.error}${value}${c.reset}${extra}`
+	if (isToken(ast)) {
+		if (ast.valid) {
+			const value = `${ast.value}`
+			return `TOKEN ${pos} ${c.values}${quote}${value}${quote}${c.reset}${extra}`
+		}
+		if (!ast.valid) {
+			const value = `[${ast.expected.join(", ")}]`
+			return `ERROR ${pos} ${c.error}${value}${c.reset}${extra}`
+		}
 	}
-	if (ast instanceof ConditionNode) {
+	if (ast.type === AST_TYPE.CONDITION) {
 		const header = `${c.info}${ast.operator === undefined}${c.reset}`
 		const not = ast.operator ? prettyAst_(ast.operator, opts, c, ___, `(negation)`) : ""
 		const property = ast.property ? prettyAst_(ast.property, opts, c, ___, `(property)`) : ""
 		const sepL = ast.sep?.left ? prettyAst_(ast.sep.left, opts, c, ___, `(separator)`) : ""
 		const op = ast.propertyOperator ? prettyAst_(ast.propertyOperator, opts, c, ___, `(property operator)`) : ""
 		const sepR = ast.sep?.right ? prettyAst_(ast.sep.right, opts, c, ___, `(separator)`) : ""
-		const isRegex = ast.value instanceof VariableNode && ast.value.quote?.left.type === TOKEN_TYPE.REGEX
-		const isArray = ast.value instanceof ArrayNode
+		const isRegex = ast.value.type === AST_TYPE.VARIABLE && ast.value.quote?.left.type === TOKEN_TYPE.REGEX
+		const isArray = ast.value.type === AST_TYPE.ARRAY
 		const variable = prettyAst_(ast.value, opts, c, __L, `(${property ? "value" : "variable/alone"}${isRegex ? " - regex" : isArray ? "- array" : ""})`)
 		return [
 			`CONDITION ${pos} ${header}${extra}`,
 			...toRows([not, property, sepL, op, sepR, variable], opts),
 		].join(`\n${__}`)
 	}
-	if (ast instanceof VariableNode) {
+	if (ast.type === AST_TYPE.VARIABLE) {
 		const prefix = ast.prefix ? prettyAst_(ast.prefix, opts, c, ___, `(value prefix)`) : ""
 		const left = ast.quote?.left ? prettyAst_(ast.quote.left, opts, c, ___, "") : ""
 		const value = prettyAst_(ast.value, opts, c, !ast.quote ? __L : !ast.quote?.right ? __L : ___, "")
@@ -115,7 +118,7 @@ export function prettyAst(
 			...toRows([prefix, left, value, right, flags], opts),
 		].join(`\n${__}`)
 	}
-	if (ast instanceof GroupNode) {
+	if (ast.type === AST_TYPE.GROUP) {
 		const header = `${c.info}${ast.prefix === undefined || (ast.prefix as ConditionNode).operator === undefined}${c.reset}`
 		const prefix = ast.prefix ? prettyAst_(ast.prefix, opts, c, ___, `(group prefix)`) : ""
 		const expression = prettyAst_(ast.expression, opts, c, __L, "")
@@ -124,7 +127,7 @@ export function prettyAst(
 			...toRows([prefix, expression], opts),
 		].join(`\n${__}`)
 	}
-	if (ast instanceof ArrayNode) {
+	if (ast.type === AST_TYPE.ARRAY) {
 		const bracketL = ast.bracket.left ? prettyAst_(ast.bracket.left, opts, c, ast.values.length === 0 && !ast.bracket.right ? __L : ___, "") : ""
 		const values = ast.values.length > 0
 			? ast.values.map((node, i) =>
@@ -137,12 +140,12 @@ export function prettyAst(
 			...toRows([bracketL, ...values, bracketR], opts),
 		].join(`\n${__}`)
 	}
-	if (ast instanceof ExpressionNode) {
+	if (ast.type === AST_TYPE.EXPRESSION) {
 		const left = prettyAst_(ast.left, opts, c, ___, "")
 		const operator = prettyAst_(ast.operator, opts, c, ___, `(boolean operator)`)
 		const right = prettyAst_(ast.right, opts, c, __L, "")
 
-		const header = ast.operator instanceof ErrorToken
+		const header = !ast.operator.valid
 			? `${c.info}[${ast.operator.expected.join(",")}]${c.reset}`
 			: `${c.info}"${ast.operator.value}"${c.reset}`
 		return [

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

@@ -1,18 +0,0 @@
-import type { ConditionNode } from "./ConditionNode.js";
-import { Node } from "./Node.js";
-import type { VariableNode } from "./VariableNode.js";
-import { AST_TYPE, type NodeDelimiters, type TOKEN_TYPE } from "../../types/ast.js";
-export declare class ArrayNode<TValid extends boolean = boolean> extends Node<AST_TYPE.ARRAY> {
-    #private;
-    readonly values: VariableNode[];
-    readonly bracket: NodeDelimiters<TOKEN_TYPE.BRACKETL, TOKEN_TYPE.BRACKETR>;
-    get parent(): ConditionNode | undefined;
-    set parent(value: ConditionNode | undefined);
-    constructor({ values, bracket, start, end }: {
-        values: ArrayNode<TValid>["values"];
-        bracket: ArrayNode<TValid>["bracket"];
-        start: number;
-        end: number;
-    });
-}
-//# sourceMappingURL=ArrayNode.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"ArrayNode.d.ts","sourceRoot":"","sources":["../../../src/ast/classes/ArrayNode.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AACvD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAEhC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAErD,OAAO,EAAE,QAAQ,EAAE,KAAK,cAAc,EAAE,KAAK,UAAU,EAAE,MAAM,oBAAoB,CAAA;AAGnF,qBAAa,SAAS,CACrB,MAAM,SAAS,OAAO,GAAG,OAAO,CAC/B,SAAQ,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;;IAC7B,QAAQ,CAAC,MAAM,EAAE,YAAY,EAAE,CAAA;IAE/B,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC,UAAU,CAAC,QAAQ,EAAE,UAAU,CAAC,QAAQ,CAAC,CAAA;IAM1E,IAAI,MAAM,IAAI,aAAa,GAAG,SAAS,CAEtC;IAED,IAAI,MAAM,CAAC,KAAK,EAAE,aAAa,GAAG,SAAS,EAI1C;gBAEW,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;QAC5C,MAAM,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,CAAA;QACnC,OAAO,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,CAAA;QACrC,KAAK,EAAE,MAAM,CAAA;QACb,GAAG,EAAE,MAAM,CAAA;KACX;CAWD"}

package/dist/ast/classes/ArrayNode.js

@@ -1,55 +0,0 @@
-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 ArrayNode extends Node {
-  constructor({ values, bracket, start, end }) {
-    super(AST_TYPE.ARRAY, start, end);
-    __publicField(this, "values");
-    __publicField(this, "bracket");
-    __privateAdd(this, _parent, void 0);
-    __privateAdd(this, _setParent, false);
-    this.values = values;
-    this.bracket = bracket;
-    this.valid = this.values.every((val) => val.valid) && this.bracket.left instanceof ValidToken && this.bracket.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 {
-  ArrayNode
-};

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

@@ -1,13 +0,0 @@
-export declare class Condition<TOp extends string = string, TValue = any> {
-    readonly value: TValue;
-    readonly operator?: TOp;
-    readonly property: string[];
-    readonly negate: boolean;
-    constructor({ property, operator, value, negate }: {
-        property: Condition<TOp, TValue>["property"];
-        operator: Condition<TOp, TValue>["operator"];
-        value: Condition<TOp, TValue>["value"];
-        negate: Condition<TOp, TValue>["negate"];
-    });
-}
-//# sourceMappingURL=Condition.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"Condition.d.ts","sourceRoot":"","sources":["../../../src/ast/classes/Condition.ts"],"names":[],"mappings":"AAAA,qBAAa,SAAS,CAAC,GAAG,SAAS,MAAM,GAAG,MAAM,EAAE,MAAM,GAAG,GAAG;IAC/D,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IAEtB,QAAQ,CAAC,QAAQ,CAAC,EAAE,GAAG,CAAA;IAEvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;IAE3B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;gBAEZ,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;QAClD,QAAQ,EAAE,SAAS,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,UAAU,CAAC,CAAA;QAC5C,QAAQ,EAAE,SAAS,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,UAAU,CAAC,CAAA;QAC5C,KAAK,EAAE,SAAS,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,CAAA;QACtC,MAAM,EAAE,SAAS,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,CAAA;KACxC;CAMD"}

package/dist/ast/classes/Condition.js

@@ -1,21 +0,0 @@
-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;
-};
-class Condition {
-  constructor({ property, operator, value, negate }) {
-    __publicField(this, "value");
-    __publicField(this, "operator");
-    __publicField(this, "property");
-    __publicField(this, "negate");
-    this.value = value;
-    this.operator = operator;
-    this.property = property;
-    this.negate = negate;
-  }
-}
-export {
-  Condition
-};

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

@@ -1,73 +0,0 @@
-import type { ArrayNode } from "./ArrayNode.js";
-import type { ErrorToken } from "./ErrorToken.js";
-import type { ExpressionNode } from "./ExpressionNode.js";
-import type { GroupNode } from "./GroupNode.js";
-import { Node } from "./Node.js";
-import { ValidToken } from "./ValidToken.js";
-import { VariableNode } from "./VariableNode.js";
-import { type AnyToken, AST_TYPE, type TOKEN_TYPE } from "../../types/ast.js";
-/**
- * A condition is composed of a `variable`, @see Variable , and, if it's negated, a "not" `operator` token, @see ValidToken .
- *
- * The `value` property refers to the boolean value of the condition (not to the string value of the variable). See the `operator` property.
- */
-export declare class ConditionNode<TValid extends boolean = boolean, TOperator extends ValidToken<TOKEN_TYPE.NOT> | undefined = ValidToken<TOKEN_TYPE.NOT> | undefined> extends Node<AST_TYPE.CONDITION> {
-    #private;
-    /**
-     * Contains a value node which could be a variable, an array node (if enabled), or a group.
-     *
-     * Might be an error in cases like:
-     * - just passing a negation operator
-     * - if condition property operators are used and you have an input like just `[SEP]`, `op[SEP]`, `prop[SEP]op[SEP]`, `[CUSTOM OP]`, or `prop[CUSTOM OP]` where the variable is missing.
-     */
-    readonly value: VariableNode<TValid> | ArrayNode<TValid> | GroupNode<TValid> | (TValid extends false ? ErrorToken<TOKEN_TYPE.VALUE> : never);
-    /**
-     * If the condition was negated, contains the "not" token, @see ValidToken , the condition was negated with.
-     */
-    readonly operator?: ValidToken<TOKEN_TYPE.NOT>;
-    /**
-     * If condition property operators are used, this will contain the property (as a variable), or an error token if it was missing (but some separator or operator was passed).
-     *
-     * While the property is a variable and can be a quoted variable, it cannot be a prefixed variable string.
-     *
-     * See the corresponding @see ParserOptions for more details.
-     */
-    readonly property?: VariableNode | (TValid extends false ? ErrorToken<TOKEN_TYPE.VALUE> : never);
-    /**
-     * If condition property operators are used, this will contain the operator.
-     *
-     * If a "short" form was used, this will contain an `OP_CUSTOM` type token, and the condition's `sep` will always be undefined.
-     *
-     * If a "long/expanded" form was used, this will contain a `VALUE` type token, and at least one of condition's `sep` tokens will be defined.
-     *
-     * See the corresponding @see ParserOptions for more details.
-     */
-    readonly propertyOperator?: AnyToken<TOKEN_TYPE.OP_CUSTOM | TOKEN_TYPE.VALUE>;
-    /**
-     * If "long/expanded" form condition property operators are used, this will contain the separators, otherwise it is undefined.
-     *
-     * If it's defined, either both side will be valid tokens, or only the left, while the right might be undefined or an error token.
-     *
-     * This is because given a string like `[SEP]val` which would produce an error like `[MISSING PROPERTY ERROR][SEP]var`, the separator is always interpreted as being the left one. And even if we have a situation like `op[SEP]var`, it is always interpreted by the parser as `prop[SEP]var`.
-     *
-     * Why might the right be undefined instead of an error token? This is because we don't need a separator between the operator and a group, `prop[SEP]op(group)`, but we do between a variable in cases like `prop[SEP]op"var"` which would produce an error token on the right side (we could parse this but it just looks inconsistent).
-     *
-     * See the corresponding @see ParserOptions for more details.
-     */
-    readonly sep?: {
-        left?: AnyToken<TOKEN_TYPE.OP_EXPANDED_SEP>;
-        right?: AnyToken<TOKEN_TYPE.OP_EXPANDED_SEP>;
-    };
-    get parent(): GroupNode | ExpressionNode | undefined;
-    set parent(value: GroupNode | ExpressionNode | undefined);
-    constructor({ property, propertyOperator, sep, value, start, end, operator }: {
-        operator?: TOperator;
-        property?: ConditionNode<TValid>["property"];
-        propertyOperator?: ConditionNode<TValid>["propertyOperator"];
-        sep?: ConditionNode<TValid>["sep"];
-        value: ConditionNode<TValid>["value"];
-        start: number;
-        end: number;
-    });
-}
-//# sourceMappingURL=ConditionNode.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"ConditionNode.d.ts","sourceRoot":"","sources":["../../../src/ast/classes/ConditionNode.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC/C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AACjD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AACzD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC/C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAEhD,OAAO,EAAE,KAAK,QAAQ,EAAE,QAAQ,EAAE,KAAK,UAAU,EAAE,MAAM,oBAAoB,CAAA;AAG7E;;;;GAIG;AACH,qBAAa,aAAa,CACzB,MAAM,SAAS,OAAO,GAAG,OAAO,EAChC,SAAS,SACR,UAAU,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,SAAS,GACtC,UAAU,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,SAAS,CACtC,SAAQ,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC;;IACjC;;;;;;OAMG;IACH,QAAQ,CAAC,KAAK,EACZ,YAAY,CAAC,MAAM,CAAC,GACpB,SAAS,CAAC,MAAM,CAAC,GACjB,SAAS,CAAC,MAAM,CAAC,GACjB,CAAC,MAAM,SAAS,KAAK,GAAG,UAAU,CAAC,UAAU,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,CAAA;IAE/D;;OAEG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,UAAU,CAAC,UAAU,CAAC,GAAG,CAAC,CAAA;IAE9C;;;;;;OAMG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,YAAY,GAAG,CAAC,MAAM,SAAS,KAAK,GAAG,UAAU,CAAC,UAAU,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,CAAA;IAEhG;;;;;;;;OAQG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EAAE,QAAQ,CAAC,UAAU,CAAC,SAAS,GAAG,UAAU,CAAC,KAAK,CAAC,CAAA;IAE7E;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,GAAG,CAAC,EAAE;QACd,IAAI,CAAC,EAAE,QAAQ,CAAC,UAAU,CAAC,eAAe,CAAC,CAAA;QAC3C,KAAK,CAAC,EAAE,QAAQ,CAAC,UAAU,CAAC,eAAe,CAAC,CAAA;KAC5C,CAAA;IAMD,IAAI,MAAM,IAAI,SAAS,GACvB,cAAc,GACd,SAAS,CAER;IAED,IAAI,MAAM,CAAC,KAAK,EAAE,SAAS,GAC3B,cAAc,GACd,SAAS,EAKR;gBAEW,EAAE,QAAQ,EAAE,gBAAgB,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,QAAQ,EAAE,EAAE;QAC7E,QAAQ,CAAC,EAAE,SAAS,CAAA;QACpB,QAAQ,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC,UAAU,CAAC,CAAA;QAC5C,gBAAgB,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC,kBAAkB,CAAC,CAAA;QAC5D,GAAG,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,CAAA;QAClC,KAAK,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAA;QACrC,KAAK,EAAE,MAAM,CAAA;QACb,GAAG,EAAE,MAAM,CAAA;KACX;CAoCD"}

package/dist/ast/classes/ConditionNode.js

@@ -1,101 +0,0 @@
-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 { VariableNode } from "./VariableNode.js";
-import { AST_TYPE } from "../../types/ast.js";
-class ConditionNode extends Node {
-  constructor({ property, propertyOperator, sep, value, start, end, operator }) {
-    var _a, _b;
-    super(AST_TYPE.CONDITION, start, end);
-    /**
-     * Contains a value node which could be a variable, an array node (if enabled), or a group.
-     *
-     * Might be an error in cases like:
-     * - just passing a negation operator
-     * - if condition property operators are used and you have an input like just `[SEP]`, `op[SEP]`, `prop[SEP]op[SEP]`, `[CUSTOM OP]`, or `prop[CUSTOM OP]` where the variable is missing.
-     */
-    __publicField(this, "value");
-    /**
-     * If the condition was negated, contains the "not" token, @see ValidToken , the condition was negated with.
-     */
-    __publicField(this, "operator");
-    /**
-     * If condition property operators are used, this will contain the property (as a variable), or an error token if it was missing (but some separator or operator was passed).
-     *
-     * While the property is a variable and can be a quoted variable, it cannot be a prefixed variable string.
-     *
-     * See the corresponding @see ParserOptions for more details.
-     */
-    __publicField(this, "property");
-    /**
-     * If condition property operators are used, this will contain the operator.
-     *
-     * If a "short" form was used, this will contain an `OP_CUSTOM` type token, and the condition's `sep` will always be undefined.
-     *
-     * If a "long/expanded" form was used, this will contain a `VALUE` type token, and at least one of condition's `sep` tokens will be defined.
-     *
-     * See the corresponding @see ParserOptions for more details.
-     */
-    __publicField(this, "propertyOperator");
-    /**
-     * If "long/expanded" form condition property operators are used, this will contain the separators, otherwise it is undefined.
-     *
-     * If it's defined, either both side will be valid tokens, or only the left, while the right might be undefined or an error token.
-     *
-     * This is because given a string like `[SEP]val` which would produce an error like `[MISSING PROPERTY ERROR][SEP]var`, the separator is always interpreted as being the left one. And even if we have a situation like `op[SEP]var`, it is always interpreted by the parser as `prop[SEP]var`.
-     *
-     * Why might the right be undefined instead of an error token? This is because we don't need a separator between the operator and a group, `prop[SEP]op(group)`, but we do between a variable in cases like `prop[SEP]op"var"` which would produce an error token on the right side (we could parse this but it just looks inconsistent).
-     *
-     * See the corresponding @see ParserOptions for more details.
-     */
-    __publicField(this, "sep");
-    __privateAdd(this, _parent, void 0);
-    __privateAdd(this, _setParent, false);
-    this.value = value;
-    this.operator = operator;
-    this.property = property;
-    this.propertyOperator = propertyOperator;
-    this.sep = sep;
-    this.operator = operator;
-    this.valid = (this.operator === void 0 || this.operator instanceof ValidToken) && this.value instanceof Node && this.value.valid && (this.property === void 0 && this.propertyOperator === void 0 && this.sep === void 0 || this.property instanceof VariableNode && (this.propertyOperator instanceof ValidToken || ((_a = this.sep) == null ? void 0 : _a.left) instanceof ValidToken && (this.sep.right === void 0 || ((_b = this.sep) == null ? void 0 : _b.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 {
-  ConditionNode
-};

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

@@ -1,27 +0,0 @@
-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 invalid recovery tokens.
- *
- * Unlike valid tokens, error tokens:
- *
- * - Have no value.
- * - Contain an extra property, `expected` with an array of tokens *that would have fixed the issue* (NOT every possible token that could be there).
- * - The start end positions will always be equal. An invalid token has no length.
- */
-export declare class ErrorToken<TExpected extends TOKEN_TYPE = TOKEN_TYPE> extends Token<false, never, never, TExpected[]> {
-    #private;
-    readonly expected: TExpected[];
-    get parent(): VariableNode | GroupNode | ExpressionNode | ConditionNode;
-    set parent(value: VariableNode | GroupNode | ExpressionNode | ConditionNode);
-    constructor({ expected, start, end }: {
-        expected: TExpected[];
-        start: number;
-        end: number;
-    });
-}
-//# sourceMappingURL=ErrorToken.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"ErrorToken.d.ts","sourceRoot":"","sources":["../../../src/ast/classes/ErrorToken.ts"],"names":[],"mappings":"AAAA,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;AAEpD;;;;;;;;GAQG;AACH,qBAAa,UAAU,CACtB,SAAS,SAAS,UAAU,GAAG,UAAU,CACxC,SAAQ,KAAK,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;;IAChD,QAAQ,CAAC,QAAQ,EAAE,SAAS,EAAE,CAAA;IAI9B,IAAI,MAAM,IAAI,YAAY,GAC1B,SAAS,GACT,cAAc,GACd,aAAa,CAEZ;IAED,IAAI,MAAM,CAAC,KAAK,EAAE,YAAY,GAC9B,SAAS,GACT,cAAc,GACd,aAAa,EAIZ;gBAEW,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;QACrC,QAAQ,EAAE,SAAS,EAAE,CAAA;QACrB,KAAK,EAAE,MAAM,CAAA;QACb,GAAG,EAAE,MAAM,CAAA;KACX;CAID"}