Method parse

packages/expr/src/runtime.ts:168–207

* Parses a binary expression and returns an @ExpressionParserResult.

(
        expr: string,
        options: { loose?: boolean } = {
            loose: false,
        }
    )

     * Parses a binary expression and returns an @ExpressionParserResult.
     */
    public parse(
        expr: string,
        options: { loose?: boolean } = {
            loose: false,
        }
    ): ExpressionParserResult {
        try {
            const ast = options.loose
                ? parseLoose(expr, { ...this.#parserOptions })
                : parse(expr, { ...this.#parserOptions });

            if (!ast.body || ast.body.length === 0) {
                throw new ExpressionError('Empty or invalid expression');
            }

            // Extract the first expression statement that we find
            const firstExprIndex = ast.body.findIndex((node) => isParsedExpressionStatement(node));
            const [statement] = ast.body.splice(firstExprIndex, 1);

            if (!statement || !isParsedExpressionStatement(statement)) {
                throw new ExpressionError('Empty or invalid expression');
            }

            // Return information on the other nodes as invalid nodes
            const invalidNodes = ast.body.filter(filterOutModuleDeclarationStatement);

            return {
                result: statement.expression,
                invalidNodes,
            };
        } catch (error) {
            if (error instanceof SyntaxError) {
                throw createExpressionErrorFromSyntaxError(expr, error);
            }
            if (error instanceof ExpressionError) {
                throw error;
            }
            throw new ExpressionError('Unexpected error');
        }
    }

    /**
     * Provides autocomplete suggestions for the given expression at the provided cursor offset.