@witchcraft/expressit 0.0.2

package/README.md

@@ -0,0 +1,86 @@
+
+### 🚧 WORK IN PROGRESS 🚧
+
+![Docs](https://github.com/witchcraftjs/expressit/workflows/Docs/badge.svg)
+![Build](https://github.com/witchcraftjs/expressit/workflows/Build/badge.svg)
+[![Release](https://github.com/witchcraftjs/expressit/workflows/Release/badge.svg)](https://www.npmjs.com/@witchcraft/expressit)
+
+Expressit is a blazing fast, customizable, error-tolerant expression parser that creates safe to eval expressions + a few other goodies.
+
+# [Docs](https://witchcraftjs.github.io/expressit)
+# [Demo](https://witchcraftjs.github.io/expressit/demo)
+# Install
+
+```
+pnpm install @witchcraft/expressit
+```
+
+# Features
+- **Error Recovery**
+	- The parser is designed to recover from ALL errors, even **multiple** errors, making it easy to provide things like syntax highlighting.
+- **Custom Operator Keywords**
+	- You can use whatever keywords you want for the operators and their strictness (whether something like `oregano` will parse to `or egano` or `oregano` can be adjusted to allow the use of keywords (usually symbols) without whitespace).
+- **Prefixed Group Parsing (optional)**
+	- Adds the ability do `prefix(variable)` which gets expanded into `prefixvariable`. You can also customize how they get prefixed (e.g. you can make `prefix(variable)` expand to `prefix.variable` instead).
+- **Custom Property Operator**
+	- Extended with custom separator (e.g. `:`): `property:OP:value`.
+	- Custom set (e.g. `=`, `>`, `<`, etc): `property=value`.
+	- **Array(optional), Regex(optional), and Group Values**
+		- Can be parsed alone, but intended for use with custom property operators: `prop=[val1, val2]`, `prop=/regex/flags`, `prop=(a || b)`.
+- **Batteries Included**
+	- Can `validate` (for syntax highlighting) and `evaluate` ASTs according to custom rules.
+- **Autosuggest/complete/replace Helpers**
+	- Never think about autocompletion ever again!
+- **Other Useful Utility Functions:**
+	- `extractTokens`, `getCursorInfo`, `getOppositeDelimiter`, `getSurroundingErrors` - useful for adding custom syntax highlighting.
+	- `prettyAst` - pretty prints a compact version of the ast for debugging
+	- other minor helpers - `isDelimiter`, `isQuote`, etc.
+- **Pre-Configured Parsers** - Includes a pre-configured boolean parser (intended for parsing shortcut contexts in a similar way to VS Code).
+- **Lots of Docs and Tests**
+
+# Usage
+
+```ts
+import { Parser, ErrorToken } from "@witchcraft/expressit"
+
+const parser = new Parser({/* opts */})
+	const context = {
+		a: false,
+		b: true
+	}
+
+	// USER INPUT
+	const input = "a || b"
+	const cursor = 1 // a| || b
+
+	const ast = parser.parse(input)
+
+	if (ast instanceof ErrorToken || !ast.valid) {
+		// ...show regular errors (no input, missing tokens, etc)
+	} else {
+		// validation can be controlled by parser options
+		const errors = parser.validate(ast)
+		// ...show more complex errors, e.g. unknown variables, etc
+	}
+
+	// ON AUTOCOMPLETE
+	const suggestions = parser.autosuggest(input, ast, cursor)
+	const completions = parser.autocomplete(suggestions, {
+		// known possible suggestions
+		variables: ["c", "d", "e"],
+		// can also be values, prefixes, keywords, properties, etc
+	})
+	// ...show completions
+
+	// ON ENTER/SUBMIT
+	const res = parser.evaluate(ast, context)
+```
+Many more examples can be found in the [tests](https://github.com/witchcraftjs/expressit/blob/master/tests), and there's also some WIP pre-configured parsers in [src/examples](https://github.com/witchcraftjs/expressit/blob/master/src/examples/) whose usage can be seen in [./test/examples.spec.ts](https://github.com/witchcraftjs/expressit/blob/master/test/examples.spec.ts).
+
+## [Development](./docs-src/DEVELOPMENT.md)
+
+## Related
+
+[Shortcuts Manager](https://github.com/alanscodelog/shortcuts-manager)
+
+[Parsekey (shortcuts parser)](https://github.com/alanscodelog/parsekey)

package/dist/ast/builders/array.d.ts

@@ -0,0 +1,8 @@
+import { type Position } from "../../types/ast.js";
+import { ArrayNode } from "../classes/ArrayNode.js";
+import type { VariableNode } from "../classes/VariableNode.js";
+export declare function array(values: VariableNode[], bracket?: {
+    left?: boolean;
+    right?: boolean;
+}, parenLeftPos?: Position, parenRightPos?: Position): ArrayNode;
+//# sourceMappingURL=array.d.ts.map

package/dist/ast/builders/array.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"array.d.ts","sourceRoot":"","sources":["../../../src/ast/builders/array.ts"],"names":[],"mappings":"AAIA,OAAO,EAAY,KAAK,QAAQ,EAAc,MAAM,oBAAoB,CAAA;AACxE,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAA;AACnD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAA;AAG9D,wBAAgB,KAAK,CACpB,MAAM,EAAE,YAAY,EAAE,EACtB,OAAO,GAAE;IAAE,IAAI,CAAC,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAgC,EAC1E,YAAY,CAAC,EAAE,QAAQ,EACvB,aAAa,CAAC,EAAE,QAAQ,GACtB,SAAS,CA8BX"}

package/dist/ast/builders/array.js

@@ -0,0 +1,31 @@
+import { token } from "./token.js";
+import { AST_TYPE, TOKEN_TYPE } from "../../types/ast.js";
+import { ArrayNode } from "../classes/ArrayNode.js";
+function array(values, bracket = { right: true, left: true }, parenLeftPos, parenRightPos) {
+  var _a, _b, _c, _d, _e, _f;
+  const node = {
+    type: AST_TYPE.ARRAY,
+    values
+  };
+  node.bracket = {};
+  const start = ((_a = values[0]) == null ? void 0 : _a.start) ?? (parenLeftPos == null ? void 0 : parenLeftPos.end);
+  const end = ((_b = values[values.length - 1]) == null ? void 0 : _b.end) ?? (parenRightPos == null ? void 0 : parenRightPos.start) ?? (parenLeftPos == null ? void 0 : parenLeftPos.end);
+  parenLeftPos ?? (parenLeftPos = start !== void 0 ? { start: start - 1, end: start } : void 0);
+  parenRightPos ?? (parenRightPos = end !== void 0 ? { start: end, end: end + 1 } : void 0);
+  node.bracket.left = token(TOKEN_TYPE.BRACKETL, "[", parenLeftPos);
+  if (bracket == null ? void 0 : bracket.right) {
+    node.bracket.right = token(TOKEN_TYPE.BRACKETR, "]", parenRightPos);
+  } else {
+    if (parenRightPos) {
+      parenRightPos.end = parenRightPos.start;
+    }
+    node.bracket.right = token(TOKEN_TYPE.BRACKETR, void 0, parenRightPos);
+  }
+  node.start = ((_c = node.bracket.left) == null ? void 0 : _c.start) ?? start ?? ((_d = node.bracket) == null ? void 0 : _d.right.start);
+  node.end = ((_f = (_e = node.bracket) == null ? void 0 : _e.right) == null ? void 0 : _f.end) ?? end ?? node.bracket.left.end;
+  const instance = new ArrayNode(node);
+  return instance;
+}
+export {
+  array
+};

package/dist/ast/builders/condition.d.ts

@@ -0,0 +1,20 @@
+import { type AnyToken, type TOKEN_TYPE } from "../../types/ast.js";
+import type { ArrayNode } from "../classes/ArrayNode.js";
+import { ConditionNode } from "../classes/ConditionNode.js";
+import type { ErrorToken } from "../classes/ErrorToken.js";
+import type { GroupNode } from "../classes/GroupNode.js";
+import type { ValidToken } from "../classes/ValidToken.js";
+import type { VariableNode } from "../classes/VariableNode.js";
+/**
+ * Creates a @see ConditionNode
+ *
+ * @param variable An existing @see VariableNode
+ *
+ * @param not Defaults to plain true condition. To negate it you must pass an existing "not" operator @see ValidToken which will be set as the node's operator and set the node's value to false.
+ *
+ * @param property Set the property for a property operator. A property operator must be passed if this is passed.
+ * @param propertyOperator Set the operator for a property condition. A property must have been passed. The property operator must be a valid token. There is no case where it would not be. If using an operator that is the same as a separator, if used as an operator, should be set as an operator.
+ * @param sep Pass separator tokens for expanded property conditions.
+ */
+export declare function condition(value: VariableNode | GroupNode | ArrayNode | ErrorToken<TOKEN_TYPE.VALUE>, not?: true | ValidToken<TOKEN_TYPE.NOT>, property?: VariableNode | ErrorToken<TOKEN_TYPE.VALUE>, propertyOperator?: AnyToken<TOKEN_TYPE.OP_CUSTOM | TOKEN_TYPE.VALUE>, { right, left }?: Partial<Record<"right" | "left", ValidToken<TOKEN_TYPE.OP_EXPANDED_SEP>>>): ConditionNode;
+//# sourceMappingURL=condition.d.ts.map

package/dist/ast/builders/condition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"condition.d.ts","sourceRoot":"","sources":["../../../src/ast/builders/condition.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,QAAQ,EAAiB,KAAK,UAAU,EAAE,MAAM,oBAAoB,CAAA;AAClF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAA;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAA;AAC3D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAA;AAC1D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAA;AACxD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAA;AAC1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAA;AAE9D;;;;;;;;;;GAUG;AAEH,wBAAgB,SAAS,CACxB,KAAK,EACH,YAAY,GACZ,SAAS,GACT,SAAS,GACT,UAAU,CAAC,UAAU,CAAC,KAAK,CAAC,EAC9B,GAAG,GAAE,IAAI,GAAG,UAAU,CAAC,UAAU,CAAC,GAAG,CAAQ,EAC7C,QAAQ,CAAC,EAAE,YAAY,GAAG,UAAU,CAAC,UAAU,CAAC,KAAK,CAAC,EACtD,gBAAgB,CAAC,EAAE,QAAQ,CAAC,UAAU,CAAC,SAAS,GAAG,UAAU,CAAC,KAAK,CAAC,EACpE,EAAE,KAAK,EAAE,IAAI,EAAE,GAAE,OAAO,CAAC,MAAM,CAAC,OAAO,GAAG,MAAM,EAAE,UAAU,CAAC,UAAU,CAAC,eAAe,CAAC,CAAC,CAAO,GAC9F,aAAa,CAsBf"}

package/dist/ast/builders/condition.js

@@ -0,0 +1,28 @@
+import { pos } from "./pos.js";
+import { ConditionNode } from "../classes/ConditionNode.js";
+function condition(value, not = true, property, propertyOperator, { right, left } = {}) {
+  const position = pos(value);
+  const notStart = not === true ? void 0 : not.start;
+  position.start = notStart ?? (property == null ? void 0 : property.start) ?? (propertyOperator == null ? void 0 : propertyOperator.start) ?? position.start;
+  const node = {
+    property,
+    value,
+    propertyOperator,
+    ...position
+  };
+  if (not !== true) {
+    node.operator = not;
+  }
+  if (right || left) {
+    node.sep = {};
+    if (right)
+      node.sep.right = right;
+    if (left)
+      node.sep.left = left;
+  }
+  const instance = new ConditionNode(node);
+  return instance;
+}
+export {
+  condition
+};

package/dist/ast/builders/delim.d.ts

@@ -0,0 +1,11 @@
+import { type ExtractTokenType } from "../../types/ast.js";
+/**
+ * Faster way, more intuitive way to generate the options for matching delimiters (e.g. quotes and parens) for functions like @see variable and @see group .
+ */
+export declare function delim<TLeft extends boolean | string, TRight extends boolean | string, TType extends TLeft extends string ? ExtractTokenType<TLeft> : TRight extends string ? ExtractTokenType<TRight> : undefined>(left?: TLeft, right?: TRight): {
+    left: TLeft extends string ? true : TLeft;
+    right: TRight extends string ? true : TRight;
+} & TType extends undefined ? {} : {
+    type: TType;
+};
+//# sourceMappingURL=delim.d.ts.map

package/dist/ast/builders/delim.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delim.d.ts","sourceRoot":"","sources":["../../../src/ast/builders/delim.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,gBAAgB,EAAc,MAAM,oBAAoB,CAAA;AAEtE;;GAEG;AAEH,wBAAgB,KAAK,CACpB,KAAK,SAAS,OAAO,GAAG,MAAM,EAC9B,MAAM,SAAS,OAAO,GAAG,MAAM,EAC/B,KAAK,SAAS,KAAK,SAAS,MAAM,GAC/B,gBAAgB,CAAC,KAAK,CAAC,GACvB,MAAM,SAAS,MAAM,GACrB,gBAAgB,CAAC,MAAM,CAAC,GACxB,SAAS,EAEZ,IAAI,GAAE,KAAsB,EAC5B,KAAK,GAAE,MAAwB,GAE/B;IACC,IAAI,EAAE,KAAK,SAAS,MAAM,GAAG,IAAI,GAAG,KAAK,CAAA;IACzC,KAAK,EAAE,MAAM,SAAS,MAAM,GAAG,IAAI,GAAG,MAAM,CAAA;CAC5C,GAAG,KAAK,SAAS,SAAS,GAAG,EAAE,GAAG;IAAE,IAAI,EAAE,KAAK,CAAA;CAAE,CAelD"}

package/dist/ast/builders/delim.js

@@ -0,0 +1,20 @@
+import { type } from "./type.js";
+import { TOKEN_TYPE } from "../../types/ast.js";
+function delim(left = false, right = false) {
+  let quoteType;
+  if (typeof left === "string")
+    quoteType = type(left);
+  else if (typeof right === "string")
+    quoteType = type(right);
+  const opts = {
+    left: left === true || typeof left === "string" && left !== void 0,
+    right: right === true || typeof right === "string" && right !== void 0
+  };
+  if (quoteType !== void 0 && ![TOKEN_TYPE.PARENL, TOKEN_TYPE.PARENR].includes(quoteType)) {
+    opts.type = quoteType;
+  }
+  return opts;
+}
+export {
+  delim
+};

package/dist/ast/builders/error.d.ts

@@ -0,0 +1,9 @@
+import { TOKEN_TYPE } from "../../types/ast.js";
+import { ErrorToken } from "../classes/ErrorToken.js";
+/**
+ * Creates an error token.
+ *
+ * @param expected Can be passed an array of @see ValidToken_TYPE or strings, in which case it will use @see type internally. So instead of `[TOKEN_TYPE.VALUE]` we can do `[""]` and instead of `[TOKEN_TYPE.PARENR]` we can do `[")"]`.
+ */
+export declare function error<T extends TOKEN_TYPE>(pos: number, expected: T[]): ErrorToken<T>;
+//# sourceMappingURL=error.d.ts.map

package/dist/ast/builders/error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.d.ts","sourceRoot":"","sources":["../../../src/ast/builders/error.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAA;AAGrD;;;;GAIG;AACH,wBAAgB,KAAK,CAAC,CAAC,SAAS,UAAU,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,EAAE,GAAG,UAAU,CAAC,CAAC,CAAC,CAAA"}

package/dist/ast/builders/error.js

@@ -0,0 +1,16 @@
+import { type } from "./type.js";
+import { TOKEN_TYPE } from "../../types/ast.js";
+import { ErrorToken } from "../classes/ErrorToken.js";
+function error(pos, expected_) {
+  const expected = expected_.map((item) => {
+    if (TOKEN_TYPE[item] === void 0) {
+      return type(item);
+    } else {
+      return item;
+    }
+  });
+  return new ErrorToken({ expected, start: pos, end: pos });
+}
+export {
+  error
+};

package/dist/ast/builders/expression.d.ts

@@ -0,0 +1,12 @@
+import { type AnyToken, TOKEN_TYPE, type TokenBooleanTypes } from "../../types/ast.js";
+import type { ConditionNode } from "../classes/ConditionNode.js";
+import type { ErrorToken } from "../classes/ErrorToken.js";
+import { ExpressionNode } from "../classes/ExpressionNode.js";
+import type { GroupNode } from "../classes/GroupNode.js";
+/**
+ * Creates an @see ExpressionNode, can be passed nothing for any of the tokens to automatically create error tokens.
+ *
+ * Also automatically sets the correct start/end positions from valid tokens (e.g. for start, searching left to right for a valid token and vice versa) assuming at least one is defined.
+ */
+export declare function expression(left: ConditionNode | ExpressionNode | GroupNode | ErrorToken<TOKEN_TYPE.VALUE> | undefined, operator: AnyToken<TokenBooleanTypes> | undefined, right: ConditionNode | ExpressionNode | GroupNode | ErrorToken<TOKEN_TYPE.VALUE> | undefined): ExpressionNode;
+//# sourceMappingURL=expression.d.ts.map

package/dist/ast/builders/expression.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"expression.d.ts","sourceRoot":"","sources":["../../../src/ast/builders/expression.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,QAAQ,EAAiB,UAAU,EAAE,KAAK,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AACrG,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAA;AAChE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAA;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAA;AAC7D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAA;AAGxD;;;;GAIG;AACH,wBAAgB,UAAU,CACzB,IAAI,EACJ,aAAa,GACb,cAAc,GACd,SAAS,GACT,UAAU,CAAC,UAAU,CAAC,KAAK,CAAC,GAC5B,SAAS,EACT,QAAQ,EACR,QAAQ,CAAC,iBAAiB,CAAC,GAC3B,SAAS,EACT,KAAK,EACL,aAAa,GACb,cAAc,GACd,SAAS,GACT,UAAU,CAAC,UAAU,CAAC,KAAK,CAAC,GAC5B,SAAS,GACP,cAAc,CAkChB"}

package/dist/ast/builders/expression.js

@@ -0,0 +1,31 @@
+import { pos } from "./pos.js";
+import { token } from "./token.js";
+import { TOKEN_TYPE } from "../../types/ast.js";
+import { ExpressionNode } from "../classes/ExpressionNode.js";
+function expression(left, operator, right) {
+  const start = (left == null ? void 0 : left.start) ?? (operator == null ? void 0 : operator.start) ?? (right == null ? void 0 : right.start);
+  const end = (right == null ? void 0 : right.end) ?? (operator == null ? void 0 : operator.end) ?? (left == null ? void 0 : left.end);
+  const position = pos({ start, end });
+  if (left === void 0) {
+    left = token(TOKEN_TYPE.VALUE, void 0, { start: position.start });
+  }
+  let op;
+  if (operator === void 0) {
+    operator = token([TOKEN_TYPE.AND, TOKEN_TYPE.OR], void 0, { start: left.end });
+  } else
+    op = operator;
+  if (right === void 0) {
+    right = token(TOKEN_TYPE.VALUE, void 0, { start: op.end });
+  }
+  const node = {
+    left,
+    operator: op,
+    right,
+    ...position
+  };
+  const instance = new ExpressionNode(node);
+  return instance;
+}
+export {
+  expression
+};

package/dist/ast/builders/group.d.ts

@@ -0,0 +1,20 @@
+import { type Position, TOKEN_TYPE } from "../../types/ast.js";
+import type { ConditionNode } from "../classes/ConditionNode.js";
+import type { ErrorToken } from "../classes/ErrorToken.js";
+import type { ExpressionNode } from "../classes/ExpressionNode.js";
+import { GroupNode } from "../classes/GroupNode.js";
+import type { ValidToken } from "../classes/ValidToken.js";
+/**
+ * Creates a group.
+ *
+ * Automatically creates error tokens if missing condition or parens (not prefix because it is optional). Will look at the position of prefix if available.
+ *
+ * @param paren Use to add parens to group, usually by using @see delim . If either `right` or `left` are false or undefined, error tokens will be created. Unlike @see variable, if undefined is passed for parens, parens are created by default.
+ *
+ * The positions of the parens can be adjusted with the last two parameters by passing positions.
+ */
+export declare function group(prefix: ConditionNode | ValidToken<TOKEN_TYPE.NOT> | undefined, expression: ConditionNode | ExpressionNode | GroupNode | ErrorToken<TOKEN_TYPE.VALUE> | undefined, paren?: {
+    left?: boolean;
+    right?: boolean;
+}, parenLeftPos?: Position, parenRightPos?: Position): GroupNode;
+//# sourceMappingURL=group.d.ts.map

package/dist/ast/builders/group.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"group.d.ts","sourceRoot":"","sources":["../../../src/ast/builders/group.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,QAAQ,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AAC9D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAA;AAChE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAA;AAC1D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAA;AAClE,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAA;AACnD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAA;AAE1D;;;;;;;;GAQG;AAEH,wBAAgB,KAAK,CACpB,MAAM,EACJ,aAAa,GACb,UAAU,CAAC,UAAU,CAAC,GAAG,CAAC,GAC1B,SAAS,EAEX,UAAU,EACR,aAAa,GACb,cAAc,GACd,SAAS,GACT,UAAU,CAAC,UAAU,CAAC,KAAK,CAAC,GAC5B,SAAS,EAEX,KAAK,GAAE;IAAE,IAAI,CAAC,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAgC,EACxE,YAAY,CAAC,EAAE,QAAQ,EACvB,aAAa,CAAC,EAAE,QAAQ,GACtB,SAAS,CA2CX"}

package/dist/ast/builders/group.js

@@ -0,0 +1,47 @@
+import { token } from "./token.js";
+import { TOKEN_TYPE } from "../../types/ast.js";
+import { GroupNode } from "../classes/GroupNode.js";
+function group(prefix, expression, paren = { right: true, left: true }, parenLeftPos, parenRightPos) {
+  var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j, _k, _l, _m, _n;
+  if (expression === void 0) {
+    expression = token(TOKEN_TYPE.VALUE, void 0, (prefix == null ? void 0 : prefix.end) !== void 0 ? { start: prefix.end } : void 0);
+  }
+  const node = {
+    expression
+  };
+  if (prefix) {
+    node.prefix = prefix;
+    const locToRight = ((_b = (_a = node.paren) == null ? void 0 : _a.left) == null ? void 0 : _b.start) ?? ((_c = node.expression) == null ? void 0 : _c.start) ?? ((_d = node.paren) == null ? void 0 : _d.right.start);
+    if (prefix.start === void 0 && locToRight !== void 0) {
+      throw new Error("group builder: missing prefix location when passed expression with location");
+    }
+  }
+  node.paren = {};
+  const start = expression.start;
+  const end = expression.end;
+  parenLeftPos ?? (parenLeftPos = start !== void 0 ? { start: start - 1, end: start } : void 0);
+  parenRightPos ?? (parenRightPos = end !== void 0 ? { start: end, end: end + 1 } : void 0);
+  if (paren == null ? void 0 : paren.left) {
+    node.paren.left = token(TOKEN_TYPE.PARENL, "(", parenLeftPos);
+  } else {
+    if (parenLeftPos) {
+      parenLeftPos.start = parenLeftPos.end;
+    }
+    node.paren.left = token(TOKEN_TYPE.PARENL, void 0, parenLeftPos);
+  }
+  if (paren == null ? void 0 : paren.right) {
+    node.paren.right = token(TOKEN_TYPE.PARENR, ")", parenRightPos);
+  } else {
+    if (parenRightPos) {
+      parenRightPos.end = parenRightPos.start;
+    }
+    node.paren.right = token(TOKEN_TYPE.PARENR, void 0, parenRightPos);
+  }
+  node.start = ((_e = node.prefix) == null ? void 0 : _e.start) ?? ((_g = (_f = node.paren) == null ? void 0 : _f.left) == null ? void 0 : _g.start) ?? ((_h = node.expression) == null ? void 0 : _h.start) ?? ((_i = node.paren) == null ? void 0 : _i.right.start);
+  node.end = ((_k = (_j = node.paren) == null ? void 0 : _j.right) == null ? void 0 : _k.end) ?? ((_l = node.expression) == null ? void 0 : _l.end) ?? ((_m = node.paren) == null ? void 0 : _m.left.end) ?? ((_n = node.prefix) == null ? void 0 : _n.end);
+  const instance = new GroupNode(node);
+  return instance;
+}
+export {
+  group
+};

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

@@ -0,0 +1,12 @@
+export { array } from "./array.js";
+export { condition } from "./condition.js";
+export { delim } from "./delim.js";
+export { error } from "./error.js";
+export { expression } from "./expression.js";
+export { group } from "./group.js";
+export { isFullPos } from "./isFullPos.js";
+export { pos } from "./pos.js";
+export { token } from "./token.js";
+export { type } from "./type.js";
+export { variable } from "./variable.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/ast/builders/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAClC,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC1C,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAClC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAClC,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAC5C,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAClC,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC1C,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAA;AAC9B,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA"}

package/dist/ast/builders/index.js

@@ -0,0 +1,24 @@
+import { array } from "./array.js";
+import { condition } from "./condition.js";
+import { delim } from "./delim.js";
+import { error } from "./error.js";
+import { expression } from "./expression.js";
+import { group } from "./group.js";
+import { isFullPos } from "./isFullPos.js";
+import { pos } from "./pos.js";
+import { token } from "./token.js";
+import { type } from "./type.js";
+import { variable } from "./variable.js";
+export {
+  array,
+  condition,
+  delim,
+  error,
+  expression,
+  group,
+  isFullPos,
+  pos,
+  token,
+  type,
+  variable
+};

package/dist/ast/builders/isFullPos.d.ts

@@ -0,0 +1,6 @@
+import type { Position } from "../../types/ast.js";
+/**
+ * @internal
+ */
+export declare function isFullPos(position?: Partial<Position> | any): position is Position;
+//# sourceMappingURL=isFullPos.d.ts.map

package/dist/ast/builders/isFullPos.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"isFullPos.d.ts","sourceRoot":"","sources":["../../../src/ast/builders/isFullPos.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAA;AAElD;;GAEG;AACH,wBAAgB,SAAS,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,GAAG,GAAG,GAAG,QAAQ,IAAI,QAAQ,CAIlF"}

package/dist/ast/builders/isFullPos.js

@@ -0,0 +1,6 @@
+function isFullPos(position) {
+  return typeof position === "object" && position.start !== void 0 && position.end !== void 0;
+}
+export {
+  isFullPos
+};

package/dist/ast/builders/pos.d.ts

@@ -0,0 +1,21 @@
+import type { AnyToken, AST_TYPE, EmptyObj, Position, TOKEN_TYPE } from "../../types/ast.js";
+import type { Node } from "../classes/Node.js";
+/**
+ * Can either:
+ *
+ * - Create a position from two numbers.
+ * - Extract just a position from anything with a (full) position.
+ * 	- From a partial position if `{fill:true}`.
+ */
+export declare function pos<TItem extends Position | Partial<Position> | EmptyObj>(item: TItem, opts: {
+    fill: true;
+}): TItem extends {
+    start: number;
+} | {
+    end: number;
+} ? Position : EmptyObj;
+export declare function pos<TItem extends Position | Partial<Position> | EmptyObj>(item: TItem, opts?: undefined | {
+    fill: false;
+}): TItem extends Position ? Position : TItem extends AnyToken<TOKEN_TYPE> | Position | EmptyObj ? Position | EmptyObj : TItem extends Node<AST_TYPE> | Position | EmptyObj ? Position | EmptyObj : EmptyObj;
+export declare function pos(start: number, end: number): Position;
+//# sourceMappingURL=pos.d.ts.map

package/dist/ast/builders/pos.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pos.d.ts","sourceRoot":"","sources":["../../../src/ast/builders/pos.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AAC5F,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAA;AAE9C;;;;;;GAMG;AACH,wBAAgB,GAAG,CAAC,KAAK,SAAS,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,GAAG,QAAQ,EACxE,IAAI,EAAE,KAAK,EACX,IAAI,EAAE;IAAE,IAAI,EAAE,IAAI,CAAA;CAAE,GAClB,KAAK,SAAS;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,GACjD,QAAQ,GACR,QAAQ,CAAA;AACX,wBAAgB,GAAG,CAAC,KAAK,SAAS,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,GAAG,QAAQ,EACxE,IAAI,EAAE,KAAK,EACX,IAAI,CAAC,EAAE,SAAS,GAAG;IAAE,IAAI,EAAE,KAAK,CAAA;CAAE,GAGlC,KAAK,SAAS,QAAQ,GACpB,QAAQ,GACR,KAAK,SAAS,QAAQ,CAAC,UAAU,CAAC,GAAG,QAAQ,GAAG,QAAQ,GACxD,QAAQ,GAAG,QAAQ,GACnB,KAAK,SAAS,IAAI,CAAC,QAAQ,CAAC,GAAG,QAAQ,GAAG,QAAQ,GAClD,QAAQ,GAAG,QAAQ,GACnB,QAAQ,CAAA;AACX,wBAAgB,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,QAAQ,CAAA"}

package/dist/ast/builders/pos.js

@@ -0,0 +1,28 @@
+import { isFullPos } from "./isFullPos.js";
+function pos(start, end) {
+  if (typeof start === "number") {
+    return { start, end };
+  } else {
+    const item = start;
+    if (item === void 0)
+      return {};
+    const fill = typeof end === "object" ? end.fill : false;
+    if (isFullPos(item)) {
+      return { start: item.start, end: item.end };
+    } else {
+      if (fill) {
+        let start2 = item.start;
+        let end2 = item.end;
+        if (start2 !== void 0 && end2 === void 0)
+          end2 = start2;
+        if (end2 !== void 0 && start2 === void 0)
+          start2 = end2;
+        return { start: start2, end: end2 };
+      }
+      return {};
+    }
+  }
+}
+export {
+  pos
+};

package/dist/ast/builders/token.d.ts

@@ -0,0 +1,12 @@
+import type { EmptyObj, Position, TOKEN_TYPE } from "../../types/ast.js";
+import { ErrorToken } from "../classes/ErrorToken.js";
+import { ValidToken } from "../classes/ValidToken.js";
+/**
+ * Creates a @see ValidToken or of the given type with the given value. If no value is given, creates an @see ErrorToken instead.
+ *
+ * Can be passed multiple types when creating an error token to set the expected field.
+ *
+ * If the token is an error token, just `start` or `end` can be passed, and the other position will be filled to the same value.
+ */
+export declare function token<TValue extends string | undefined, TType extends TOKEN_TYPE = TOKEN_TYPE>(type: TValue extends undefined ? TType | TType[] : TType, value: TValue, position?: Position | Partial<Position> | EmptyObj): TValue extends undefined ? ErrorToken<TType> : ValidToken<TType>;
+//# sourceMappingURL=token.d.ts.map

package/dist/ast/builders/token.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token.d.ts","sourceRoot":"","sources":["../../../src/ast/builders/token.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAY,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AAClF,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAA;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAA;AAGrD;;;;;;GAMG;AAEH,wBAAgB,KAAK,CACpB,MAAM,SAAS,MAAM,GAAG,SAAS,EACjC,KAAK,SAAS,UAAU,GAAG,UAAU,EAErC,IAAI,EAAE,MAAM,SAAS,SAAS,GAAG,KAAK,GAAG,KAAK,EAAE,GAAG,KAAK,EACxD,KAAK,EAAE,MAAM,EACb,QAAQ,GAAE,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,GAAG,QAAa,GACpD,MAAM,SAAS,SAAS,GACxB,UAAU,CAAC,KAAK,CAAC,GACjB,UAAU,CAAC,KAAK,CAAC,CAmBnB"}

package/dist/ast/builders/token.js

@@ -0,0 +1,26 @@
+import { isArray } from "@alanscodelog/utils";
+import { pos } from "./pos.js";
+import { ErrorToken } from "../classes/ErrorToken.js";
+import { ValidToken } from "../classes/ValidToken.js";
+function token(type, value, position = {}) {
+  position = pos(position, { fill: true });
+  let token2;
+  if (value !== void 0) {
+    token2 = new ValidToken({
+      type,
+      value,
+      start: position.start,
+      end: position.end
+    });
+  } else {
+    token2 = new ErrorToken({
+      expected: isArray(type) ? type : [type],
+      start: position.start,
+      end: position.end
+    });
+  }
+  return token2;
+}
+export {
+  token
+};

package/dist/ast/builders/type.d.ts

@@ -0,0 +1,6 @@
+import { type ExtractTokenType } from "../../types/ast.js";
+/**
+ * Given a the string value of an operator or single delimiter token, returns the corresponding @see ValidToken_TYPE .
+ */
+export declare function type<T extends string>(operatorSymbol: T): ExtractTokenType<T>;
+//# sourceMappingURL=type.d.ts.map

package/dist/ast/builders/type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"type.d.ts","sourceRoot":"","sources":["../../../src/ast/builders/type.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,gBAAgB,EAAc,MAAM,oBAAoB,CAAA;AACtE;;GAEG;AACH,wBAAgB,IAAI,CAAC,CAAC,SAAS,MAAM,EACpC,cAAc,EAAE,CAAC,GACf,gBAAgB,CAAC,CAAC,CAAC,CAwBrB"}

package/dist/ast/builders/type.js

@@ -0,0 +1,37 @@
+import { TOKEN_TYPE } from "../../types/ast.js";
+function type(operatorSymbol) {
+  switch (operatorSymbol) {
+    case "`":
+      return TOKEN_TYPE.BACKTICK;
+    case `'`:
+      return TOKEN_TYPE.SINGLEQUOTE;
+    case `"`:
+      return TOKEN_TYPE.DOUBLEQUOTE;
+    case `(`:
+      return TOKEN_TYPE.PARENL;
+    case `)`:
+      return TOKEN_TYPE.PARENR;
+    case `[`:
+      return TOKEN_TYPE.BRACKETL;
+    case `]`:
+      return TOKEN_TYPE.BRACKETR;
+    case `/`:
+      return TOKEN_TYPE.REGEX;
+    case `and`:
+    case `&&`:
+    case `&`:
+      return TOKEN_TYPE.AND;
+    case `or`:
+    case `||`:
+    case `|`:
+      return TOKEN_TYPE.OR;
+    case `not`:
+    case `!`:
+      return TOKEN_TYPE.NOT;
+    default:
+      return TOKEN_TYPE.VALUE;
+  }
+}
+export {
+  type
+};

package/dist/ast/builders/variable.d.ts

@@ -0,0 +1,17 @@
+import { type AnyToken, type EmptyObj, type Position, TOKEN_TYPE, type TokenQuoteTypes } from "../../types/ast.js";
+import type { ValidToken } from "../classes/ValidToken.js";
+import { VariableNode } from "../classes/VariableNode.js";
+/**
+ * Creates an @see VariableNode .
+ *
+ * @param quote Use to add quotes to the variable, usually by using @see delim . If false or undefined, no quotes are added. Otherwise at least `type` must be passed.  If one side is defined but not the other, error tokens will be created with the given type.
+ *
+ * @param position Refers to position of the value (in case it needs to be created) not the node. Quote positions are automatically calculated from this if used. If value is already a token, there's no need to pass a position, it can be extracted from the token.
+ */
+export declare function variable(prefix: ValidToken<TOKEN_TYPE.VALUE> | undefined, value: string | AnyToken<TOKEN_TYPE.VALUE>, quote?: {
+    type: TokenQuoteTypes;
+    left?: boolean;
+    right?: boolean;
+    flags?: string;
+}, position?: Position | EmptyObj): VariableNode;
+//# sourceMappingURL=variable.d.ts.map

package/dist/ast/builders/variable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"variable.d.ts","sourceRoot":"","sources":["../../../src/ast/builders/variable.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,QAAQ,EAAE,KAAK,QAAQ,EAAE,KAAK,QAAQ,EAAE,UAAU,EAAE,KAAK,eAAe,EAAE,MAAM,oBAAoB,CAAA;AAClH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAA;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAA;AAGzD;;;;;;GAMG;AAEH,wBAAgB,QAAQ,CACvB,MAAM,EAAE,UAAU,CAAC,UAAU,CAAC,KAAK,CAAC,GAAG,SAAS,EAChD,KAAK,EAAE,MAAM,GAAG,QAAQ,CAAC,UAAU,CAAC,KAAK,CAAC,EAC1C,KAAK,CAAC,EAAE;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,EAClF,QAAQ,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAC5B,YAAY,CAyDd"}