@witchcraft/expressit 0.0.2 → 0.1.0

package/dist/grammar/index.d.ts

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

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

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

package/dist/grammar/index.js

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

package/dist/parser.d.ts

@@ -1,58 +0,0 @@
-/**
- * The parser's methods are often long and have a lot of documentation per method, so it's methods have been split into mixins. They can be found in the `./methods` folder.
- *
- * Writing from within any of these methods is like writing a method from here except:
- * - `this` calls are wrapped in `(this as any as Parser<T>)`
- * - private method/property access requires `// @ts-expect-error`.
- * - recursion with hidden parameters requires re-typing this (see evaluate/validate for examples) since otherwise if we only retyped the function it would become unbound from `this`.
- *
- * Docs work like normal (on methods). From the outside, users of the library cannot even tell the class is composed of mixins.
- */
-import type { Mixin } from "@alanscodelog/utils";
-import { createTokens } from "./grammar/createTokens.js";
-import { ParserBase } from "./grammar/ParserBase.js";
-import { AutocompleteMixin } from "./methods/autocomplete.js";
-import { AutoreplaceMixin } from "./methods/autoreplace.js";
-import { Autosuggest } from "./methods/autosuggest.js";
-import { EvaluateMixin } from "./methods/evaluate.js";
-import { GetBestIndexesMixin } from "./methods/getBestIndex.js";
-import { GetIndexMixin } from "./methods/getIndexes.js";
-import { NormalizeMixin, ValidateMixin } from "./methods/index.js";
-import type { ParserResults } from "./types/ast.js";
-import type { FullParserOptions, ParserOptions } from "./types/parser.js";
-/**
- * Creates the main parser class which handles all functionality (evaluation, validation, etc).
- */
-export declare class Parser<T extends {} = {}> {
-    options: FullParserOptions<T>;
-    private readonly rawOptions;
-    parser: ParserBase<T>;
-    private readonly lexer;
-    private readonly tokens;
-    info: ReturnType<typeof createTokens>["info"];
-    constructor(options?: ParserOptions<T>);
-    /**
-     * Parses a string.
-     */
-    parse(input: string): ParserResults;
-    private evaluationOptionsChecked;
-    _checkEvaluationOptions(): void;
-    private validationOptionsChecked;
-    _checkValidationOptions(): void;
-    /**
-     * Generates a railroad diagram for debugging. Does not 100% represent how things are actually handled internally.
-     *
-     * Not exposed because it uses the raw chevrotain tokens.
-     *
-     * **Note: It is not 100% accurate. Some special cases are parsed one way but handled internally differently.**
-     */
-    private _generateRailRoadDiagram;
-    /**
-     * For debugging.
-     * Not exposed because it returns the raw chevrotain tokens.
-     */
-    private _lex;
-}
-export interface Parser<T extends {} = {}> extends Mixin<AutocompleteMixin<T> | AutoreplaceMixin | Autosuggest<T> | EvaluateMixin<T> | ValidateMixin<T> | NormalizeMixin<T> | GetIndexMixin<T> | GetBestIndexesMixin>, AutocompleteMixin<T>, AutoreplaceMixin, Autosuggest<T>, EvaluateMixin<T>, ValidateMixin<T>, NormalizeMixin<T>, GetIndexMixin<T>, GetBestIndexesMixin {
-}
-//# sourceMappingURL=parser.d.ts.map

package/dist/parser.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../src/parser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAA;AAKhD,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAA;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAA;AAKpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAA;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAA;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAA;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAA;AACrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAA;AAC/D,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAA;AACvD,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAClE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA;AAEnD,OAAO,KAAK,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AAGzE;;GAEG;AACH,qBAAa,MAAM,CAAC,CAAC,SAAS,EAAE,GAAG,EAAE;IACpC,OAAO,EAAE,iBAAiB,CAAC,CAAC,CAAC,CAAA;IAE7B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAkB;IAE7C,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,CAAA;IAErB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAO;IAE7B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA2C;IAElE,IAAI,EAAE,UAAU,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,CAAA;gBAEjC,OAAO,CAAC,EAAE,aAAa,CAAC,CAAC,CAAC;IAYtC;;OAEG;IACH,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa;IA8CnC,OAAO,CAAC,wBAAwB,CAAiB;IAGjD,uBAAuB,IAAI,IAAI;IAO/B,OAAO,CAAC,wBAAwB,CAAiB;IAGjD,uBAAuB,IAAI,IAAI;IAO/B;;;;;;OAMG;IACH,OAAO,CAAC,wBAAwB;IAMhC;;;OAGG;IACH,OAAO,CAAC,IAAI;CAGZ;AAED,MAAM,WAAW,MAAM,CAAC,CAAC,SAAS,EAAE,GAAG,EAAE,CAAE,SAAQ,KAAK,CACrD,iBAAiB,CAAC,CAAC,CAAC,GACpB,gBAAgB,GAChB,WAAW,CAAC,CAAC,CAAC,GACd,aAAa,CAAC,CAAC,CAAC,GAChB,aAAa,CAAC,CAAC,CAAC,GAChB,cAAc,CAAC,CAAC,CAAC,GACjB,aAAa,CAAC,CAAC,CAAC,GAChB,mBAAmB,CACrB,EACA,iBAAiB,CAAC,CAAC,CAAC,EACpB,gBAAgB,EAChB,WAAW,CAAC,CAAC,CAAC,EACd,aAAa,CAAC,CAAC,CAAC,EAChB,aAAa,CAAG,CAAC,CAAE,EACnB,cAAc,CAAC,CAAC,CAAC,EACjB,aAAa,CAAC,CAAC,CAAC,EAChB,mBAAmB;CAClB"}

package/dist/parser.js

@@ -1,136 +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;
-};
-import { mixin, isWhitespace } from "@alanscodelog/utils";
-import { createSyntaxDiagramsCode } from "chevrotain";
-import { token } from "./ast/handlers.js";
-import { createTokens } from "./grammar/createTokens.js";
-import { ParserBase } from "./grammar/ParserBase.js";
-import { BooleanParserLibraryError } from "./helpers/errors.js";
-import { checkParserOpts } from "./helpers/parser/checkParserOpts.js";
-import { getUnclosedRightParenCount } from "./helpers/parser/getUnclosedRightParenCount.js";
-import { ERROR_CODES } from "./types/errors.js";
-import { parseParserOptions } from "./helpers/parser/parseParserOptions.js";
-import { seal } from "./helpers/parser/seal.js";
-import { AutocompleteMixin } from "./methods/autocomplete.js";
-import { AutoreplaceMixin } from "./methods/autoreplace.js";
-import { Autosuggest } from "./methods/autosuggest.js";
-import { EvaluateMixin } from "./methods/evaluate.js";
-import { GetBestIndexesMixin } from "./methods/getBestIndex.js";
-import { GetIndexMixin } from "./methods/getIndexes.js";
-import { NormalizeMixin } from "./methods/normalize.js";
-import { ValidateMixin } from "./methods/validate.js";
-class Parser {
-  constructor(options) {
-    __publicField(this, "options");
-    __publicField(this, "rawOptions");
-    __publicField(this, "parser");
-    __publicField(this, "lexer");
-    __publicField(this, "tokens");
-    __publicField(this, "info");
-    // needed for evaluate and validate so they are only checked on demand
-    __publicField(this, "evaluationOptionsChecked", false);
-    __publicField(this, "validationOptionsChecked", false);
-    this.rawOptions = options ?? {};
-    const opts = parseParserOptions(this.rawOptions);
-    checkParserOpts(opts);
-    this.options = opts;
-    const { lexer, tokens, info } = createTokens(opts);
-    this.lexer = lexer;
-    this.tokens = tokens;
-    this.info = info;
-    this.parser = new ParserBase(opts, this.tokens, this.info);
-  }
-  /**
-   * Parses a string.
-   */
-  parse(input) {
-    var _a;
-    if (isWhitespace(input)) {
-      return token.value(void 0, { start: 0, end: 0 });
-    }
-    let lexed = this._lex(input);
-    const shift = getUnclosedRightParenCount(lexed.tokens, this.tokens);
-    if (shift) {
-      input = "(".repeat(shift) + input;
-      lexed = this._lex(input);
-    }
-    this.parser.shift = shift;
-    this.parser.input = lexed.tokens;
-    this.parser.rawInput = input;
-    try {
-      if (lexed.errors.length > 0)
-        throw new Error("Unexpected Lexer Errors");
-      this.parser.input = lexed.tokens;
-      const res = this.parser.main();
-      if (res === void 0) {
-        throw new Error("throw");
-      }
-      if (!((_a = arguments[1]) == null ? void 0 : _a.unsealed))
-        seal(res);
-      return res;
-    } catch (error) {
-      if (error.message === "throw")
-        error = void 0;
-      const err = new BooleanParserLibraryError(ERROR_CODES.PARSER_ERROR, {
-        input,
-        options: this.rawOptions,
-        "parsed options": this.options,
-        error,
-        "lexed tokens": lexed.tokens,
-        "lexer errors": lexed.errors,
-        "parser errors": this.parser.errors
-      });
-      throw err;
-    }
-  }
-  // eslint-disable-next-line @typescript-eslint/naming-convention
-  _checkEvaluationOptions() {
-    if (!this.evaluationOptionsChecked) {
-      checkParserOpts(this.options, true);
-      this.evaluationOptionsChecked = true;
-    }
-  }
-  // eslint-disable-next-line @typescript-eslint/naming-convention
-  _checkValidationOptions() {
-    if (!this.validationOptionsChecked) {
-      checkParserOpts(this.options, false, true);
-      this.validationOptionsChecked = true;
-    }
-  }
-  /**
-   * Generates a railroad diagram for debugging. Does not 100% represent how things are actually handled internally.
-   *
-   * Not exposed because it uses the raw chevrotain tokens.
-   *
-   * **Note: It is not 100% accurate. Some special cases are parsed one way but handled internally differently.**
-   */
-  _generateRailRoadDiagram() {
-    const serialized = this.parser.getSerializedGastProductions();
-    const html = createSyntaxDiagramsCode(serialized);
-    return html;
-  }
-  /**
-   * For debugging.
-   * Not exposed because it returns the raw chevrotain tokens.
-   */
-  _lex(input) {
-    return this.lexer.tokenize(input);
-  }
-}
-mixin(Parser, [
-  AutocompleteMixin,
-  AutoreplaceMixin,
-  Autosuggest,
-  EvaluateMixin,
-  ValidateMixin,
-  NormalizeMixin,
-  GetIndexMixin,
-  GetBestIndexesMixin
-]);
-export {
-  Parser
-};

package/src/examples/advancedValueComparer.ts

@@ -1,31 +0,0 @@
-import type { ValueQuery } from "../types/parser.js"
-
-/* TODO TOUPDATE */
-type Operators = ">" | "contains"
-type Prefixes = "num"
-export function valueComparer(contextValue: string, { operator, prefix, value, isRegex, regexFlags }: ValueQuery): boolean {
-	let finalValue: any = value
-	if (prefix) {
-		const val = value as string // it's always a string if prefixed
-		switch (prefix as Prefixes) {
-			case "num": finalValue = parseInt(val, 2); break
-			// ...
-		}
-	}
-	if (isRegex) {
-		const val = value as string // it's always a string and never prefixed if it's a regex
-		const regex = new RegExp(val, regexFlags)
-		return contextValue.match(regex) !== null
-	}
-	if (operator) {
-		switch (operator as Operators) {
-			// custom operators
-			case ">": return contextValue > finalValue
-			// ...
-			// custom expanded operators
-			case "contains": return contextValue.includes(finalValue)
-			// ...
-		}
-	}
-	return contextValue === finalValue
-}