// Copyright 2016 the V8 project authors. All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.

#ifndef V8_PARSING_PARSING_H_
#define V8_PARSING_PARSING_H_

#include "src/common/globals.h"

namespace v8 {
namespace internal {

class ParseInfo;
class SharedFunctionInfo;

namespace parsing {

enum class ReportErrorsAndStatisticsMode { kYes, kNo };

// Parses the top-level source code represented by the parse info and sets its
// function literal. Returns false (and deallocates any allocated AST nodes) if
// parsing failed.
V8_EXPORT_PRIVATE bool ParseProgram(
    ParseInfo* info, Handle<Script> script, Isolate* isolate,
    ReportErrorsAndStatisticsMode mode = ReportErrorsAndStatisticsMode::kYes);

// Parses the top-level source code represented by the parse info and sets its
// function literal. Allows passing an |outer_scope| for programs that exist in
// another scope (e.g. eval). Returns false (and deallocates any allocated AST
// nodes) if parsing failed.
V8_EXPORT_PRIVATE bool ParseProgram(
    ParseInfo* info, Handle<Script> script, MaybeHandle<ScopeInfo> outer_scope,
    Isolate* isolate,
    ReportErrorsAndStatisticsMode mode = ReportErrorsAndStatisticsMode::kYes);

// Like ParseProgram but for an individual function which already has a
// allocated shared function info.
V8_EXPORT_PRIVATE bool ParseFunction(
    ParseInfo* info, Handle<SharedFunctionInfo> shared_info, Isolate* isolate,
    ReportErrorsAndStatisticsMode mode = ReportErrorsAndStatisticsMode::kYes);

// If you don't know whether info->is_toplevel() is true or not, use this method
// to dispatch to either of the above functions. Prefer to use the above methods
// whenever possible.
V8_EXPORT_PRIVATE bool ParseAny(
    ParseInfo* info, Handle<SharedFunctionInfo> shared_info, Isolate* isolate,
    ReportErrorsAndStatisticsMode mode = ReportErrorsAndStatisticsMode::kYes);

}  // namespace parsing
}  // namespace internal
}  // namespace v8

#endif  // V8_PARSING_PARSING_H_
