deps/v8/src/builtins/builtins.h - main - githubmirror/node

deps/v8/src/builtins/builtins.h
718 строк27 KB
Michaël Zasso
deps: update V8 to 14.6.202.33
24 апр 2026, 19:01
24 апр 2026, 19:01f1e0b83
// Copyright 2011 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_BUILTINS_BUILTINS_H_
#define V8_BUILTINS_BUILTINS_H_

#include "src/base/flags.h"
#include "src/base/vector.h"
#include "src/builtins/builtins-definitions.h"
#include "src/codegen/cpu-features.h"
#include "src/common/globals.h"
#include "src/objects/type-hints.h"
#include "src/sandbox/code-entrypoint-tag.h"
#include "src/sandbox/code-sandboxing-mode.h"

#ifdef V8_ENABLE_WEBASSEMBLY
#include "src/wasm/wasm-code-pointer-table.h"
#endif

namespace v8 {
namespace internal {

class ByteArray;
class CallInterfaceDescriptor;
class Callable;

// Forward declarations.
class BytecodeOffset;
class RootVisitor;
enum class InterpreterPushArgsMode : unsigned;
class Zone;
namespace compiler {
class CodeAssemblerState;
namespace turboshaft {
class Graph;
class PipelineData;
}  // namespace turboshaft
}  // namespace compiler

template <typename T>
static constexpr T FirstFromVarArgs(T x, ...) noexcept {
  return x;
}

// Convenience macro to avoid generating named accessors for all builtins.
#define BUILTIN_CODE(isolate, name) \
  (isolate)->builtins()->code_handle(i::Builtin::k##name)

#define ADD_ONE(Name, ...) +1
static constexpr int kBuiltinLoadICHandlerCount =
    0 BUILTIN_LOAD_IC_HANDLER_LIST(ADD_ONE);
#undef ADD_ONE

enum class Builtin : int32_t {
  kNoBuiltinId = -1,
#define DEF_ENUM(Name, ...) k##Name,
  BUILTIN_LIST(DEF_ENUM, DEF_ENUM, DEF_ENUM, DEF_ENUM, DEF_ENUM, DEF_ENUM,
               DEF_ENUM, DEF_ENUM, DEF_ENUM, DEF_ENUM)
#undef DEF_ENUM
#define EXTRACT_NAME(Name, ...) k##Name,
  // Define kFirstBytecodeHandler,
  kFirstBytecodeHandler = FirstFromVarArgs(
      BUILTIN_LIST_BYTECODE_HANDLERS(EXTRACT_NAME, EXTRACT_NAME) 0),
  kFirstLoadICHandler =
      FirstFromVarArgs(BUILTIN_LOAD_IC_HANDLER_LIST(EXTRACT_NAME) 0),
#undef EXTRACT_NAME
  kLastLoadICHandler = kFirstLoadICHandler + kBuiltinLoadICHandlerCount - 1
};
enum class TieringBuiltin : int32_t {
#define DEF_ENUM(Name, ...) k##Name = static_cast<int32_t>(Builtin::k##Name),
  BUILTIN_LIST_BASE_TIERING(DEF_ENUM)
#undef DEF_ENUM
};
V8_INLINE bool IsValidTieringBuiltin(TieringBuiltin builtin) {
#define CASE(Name, ...)                     \
  if (builtin == TieringBuiltin::k##Name) { \
    return true;                            \
  }
  BUILTIN_LIST_BASE_TIERING(CASE)
#undef CASE
  return false;
}

V8_INLINE constexpr bool operator<(Builtin a, Builtin b) {
  using type = std::underlying_type_t<Builtin>;
  return static_cast<type>(a) < static_cast<type>(b);
}

V8_INLINE constexpr Builtin operator++(Builtin& builtin) {
  using type = std::underlying_type_t<Builtin>;
  return builtin = static_cast<Builtin>(static_cast<type>(builtin) + 1);
}

V8_INLINE constexpr Builtin operator--(Builtin& builtin) {
  using type = std::underlying_type_t<Builtin>;
  return builtin = static_cast<Builtin>(static_cast<type>(builtin) - 1);
}

V8_INLINE constexpr Builtin operator+(const Builtin& builtin,
                                      const int offset) {
  using type = std::underlying_type_t<Builtin>;
  type b = static_cast<type>(builtin) + offset;
  return static_cast<Builtin>(b);
}

V8_INLINE constexpr Builtin operator-(const Builtin& builtin,
                                      const int offset) {
  using type = std::underlying_type_t<Builtin>;
  type b = static_cast<type>(builtin) - offset;
  return static_cast<Builtin>(b);
}

V8_INLINE constexpr Builtin& operator+=(Builtin& builtin, const int offset) {
  using type = std::underlying_type_t<Builtin>;
  builtin = static_cast<Builtin>(static_cast<type>(builtin) + offset);
  return builtin;
}

V8_INLINE constexpr Builtin& operator-=(Builtin& builtin, const int offset) {
  using type = std::underlying_type_t<Builtin>;
  builtin = static_cast<Builtin>(static_cast<type>(builtin) - offset);
  return builtin;
}

class Builtins {
 public:
  explicit Builtins(Isolate* isolate) : isolate_(isolate) {}

  Builtins(const Builtins&) = delete;
  Builtins& operator=(const Builtins&) = delete;

  void TearDown();

  // Disassembler support.
  const char* Lookup(Address pc);

#if !defined(V8_SHORT_BUILTIN_CALLS) || defined(V8_COMPRESS_POINTERS)
  static constexpr bool kCodeObjectsAreInROSpace = true;
#else
  static constexpr bool kCodeObjectsAreInROSpace = false;
#endif  // !defined(V8_SHORT_BUILTIN_CALLS) || \
        // defined(V8_COMPRESS_POINTERS)

#define ADD_ONE(Name, ...) +1
  static constexpr int kBuiltinCount =
      0 BUILTIN_LIST(ADD_ONE, ADD_ONE, ADD_ONE, ADD_ONE, ADD_ONE, ADD_ONE,
                     ADD_ONE, ADD_ONE, ADD_ONE, ADD_ONE);
  static constexpr int kBuiltinTier0Count = 0 BUILTIN_LIST_TIER0(
      ADD_ONE, ADD_ONE, ADD_ONE, ADD_ONE, ADD_ONE, ADD_ONE, ADD_ONE);
#undef ADD_ONE

  static constexpr Builtin kFirst = static_cast<Builtin>(0);
  static constexpr Builtin kLast = static_cast<Builtin>(kBuiltinCount - 1);
  static constexpr Builtin kLastTier0 =
      static_cast<Builtin>(kBuiltinTier0Count - 1);

  static constexpr int kFirstWideBytecodeHandler =
      static_cast<int>(Builtin::kFirstBytecodeHandler) +
      kNumberOfBytecodeHandlers;
  static constexpr int kFirstExtraWideBytecodeHandler =
      kFirstWideBytecodeHandler + kNumberOfWideBytecodeHandlers;
  static constexpr int kLastBytecodeHandlerPlusOne =
      kFirstExtraWideBytecodeHandler + kNumberOfWideBytecodeHandlers;
  static constexpr bool kBytecodeHandlersAreSortedLast =
      kLastBytecodeHandlerPlusOne == kBuiltinCount;
  static_assert(kBytecodeHandlersAreSortedLast);

#if V8_ENABLE_GEARBOX
  static inline constexpr bool HasGenericSuffix(std::string_view s) {
    return s.ends_with("_Generic");
  }

  static inline constexpr bool HasISXSuffix(std::string_view s) {
    return s.ends_with("_ISX");
  }

  static inline constexpr bool IsISXVariant(Builtin builtin) {
    switch (builtin) {
#define CASE(Name, ...)  \
  case Builtin::k##Name: \
    return HasISXSuffix(#Name);

      BUILTIN_LIST(CASE, CASE, CASE, CASE, CASE, CASE, CASE, CASE, CASE, CASE)
#undef CASE
      default:
        return false;
    }
  }

  static inline constexpr bool IsGenericVariant(Builtin builtin) {
    switch (builtin) {
#define CASE(Name, ...)  \
  case Builtin::k##Name: \
    return HasGenericSuffix(#Name);

      BUILTIN_LIST(CASE, CASE, CASE, CASE, CASE, CASE, CASE, CASE, CASE, CASE)
#undef CASE
      default:
        return false;
    }
  }

  static inline constexpr bool IsGearboxPlaceholder(Builtin builtin) {
    return IsISXVariant(builtin + kGearboxISXBuiltinIdOffset);
  }

  static inline constexpr Builtin GetGearboxPlaceholderFromVariant(
      Builtin builtin) {
    DCHECK(IsGenericVariant(builtin) || IsISXVariant(builtin) ||
           IsGearboxPlaceholder(builtin));
    if (IsISXVariant(builtin)) {
      builtin -= kGearboxISXBuiltinIdOffset;
      DCHECK_LE(builtin, Builtins::kLast);
      return builtin;
    } else if (IsGenericVariant(builtin)) {
      builtin -= kGearboxGenericBuiltinIdOffset;
      DCHECK_LE(builtin, Builtins::kLast);
      return builtin;
    } else {
      return builtin;
    }
  }

  static inline constexpr Builtin GetISXVariantFromGearboxPlaceholder(
      Builtin builtin) {
    DCHECK(IsGearboxPlaceholder(builtin));
    return builtin + kGearboxISXBuiltinIdOffset;
  }

  static inline constexpr Builtin GetGenericVariantFromGearboxPlaceholder(
      Builtin builtin) {
    DCHECK(IsGearboxPlaceholder(builtin));
    return builtin + kGearboxGenericBuiltinIdOffset;
  }

  // Now we just use only SSE4_1 as the condition for enabling ISX.
  static inline bool CpuHasISXSupport() {
    return CpuFeatures::IsSupported(SSE4_1);
  }
#endif  // V8_ENABLE_GEARBOX

  static constexpr bool IsBuiltinId(Builtin builtin) {
    return builtin != Builtin::kNoBuiltinId;
  }
  static constexpr bool IsBuiltinId(int maybe_id) {
    static_assert(static_cast<int>(Builtin::kNoBuiltinId) == -1);
    return static_cast<uint32_t>(maybe_id) <
           static_cast<uint32_t>(kBuiltinCount);
  }
  static constexpr bool IsTier0(Builtin builtin) {
    return builtin <= kLastTier0 && IsBuiltinId(builtin);
  }

  static constexpr Builtin FromInt(int id) {
    DCHECK(IsBuiltinId(id));
    return static_cast<Builtin>(id);
  }
  static constexpr int ToInt(Builtin id) {
    DCHECK(IsBuiltinId(id));
    return static_cast<int>(id);
  }

  // The different builtin kinds are documented in builtins-definitions.h.
  enum Kind { CPP, TFJ_TSA, TFJ, TFC_TSA, TFC, TFS, TFH, BCH_TSA, BCH, ASM };

  static BytecodeOffset GetContinuationBytecodeOffset(Builtin builtin);
  static Builtin GetBuiltinFromBytecodeOffset(BytecodeOffset);

  //
  // Convenience wrappers.
  //
  static inline constexpr Builtin RecordWrite(SaveFPRegsMode fp_mode);
  static inline constexpr Builtin IndirectPointerBarrier(
      SaveFPRegsMode fp_mode);
  static inline constexpr Builtin EphemeronKeyBarrier(SaveFPRegsMode fp_mode);

  static inline constexpr Builtin AdaptorWithBuiltinExitFrame(
      int formal_parameter_count);

  static inline constexpr Builtin CallFunction(
      ConvertReceiverMode = ConvertReceiverMode::kAny);
  static inline constexpr Builtin Call(
      ConvertReceiverMode = ConvertReceiverMode::kAny);
  // Whether the given builtin is one of the JS function call builtins.
  static inline constexpr bool IsAnyCall(Builtin builtin);

  static inline constexpr Builtin NonPrimitiveToPrimitive(
      ToPrimitiveHint hint = ToPrimitiveHint::kDefault);
  static inline constexpr Builtin OrdinaryToPrimitive(
      OrdinaryToPrimitiveHint hint);

  static inline constexpr Builtin StringAdd(
      StringAddFlags flags = STRING_ADD_CHECK_NONE);

  static inline constexpr Builtin LoadGlobalIC(TypeofMode typeof_mode);
  static inline constexpr Builtin LoadGlobalICInOptimizedCode(
      TypeofMode typeof_mode);

  static inline constexpr Builtin CEntry(int result_size, ArgvMode argv_mode,
                                         bool builtin_exit_frame = false,
                                         bool switch_to_central_stack = false);

  static inline constexpr Builtin RuntimeCEntry(
      int result_size, bool switch_to_central_stack = false);

  static inline constexpr Builtin InterpreterCEntry(int result_size);
  static inline constexpr Builtin InterpreterPushArgsThenCall(
      ConvertReceiverMode receiver_mode, InterpreterPushArgsMode mode);
  static inline constexpr Builtin InterpreterPushArgsThenConstruct(
      InterpreterPushArgsMode mode);

  // Used by CreateOffHeapTrampolines in isolate.cc.
  void set_code(Builtin builtin, Tagged<Code> code);

  V8_EXPORT_PRIVATE Tagged<Code> code(Builtin builtin);
  V8_EXPORT_PRIVATE Handle<Code> code_handle(Builtin builtin);

  V8_EXPORT_PRIVATE static CallInterfaceDescriptor CallInterfaceDescriptorFor(
      Builtin builtin);
  V8_EXPORT_PRIVATE static Callable CallableFor(Isolate* isolate,
                                                Builtin builtin);
  V8_EXPORT_PRIVATE static bool HasJSLinkage(Builtin builtin);

  // Returns the number builtin's parameters passed on the stack.
  V8_EXPORT_PRIVATE static int GetStackParameterCount(Builtin builtin);

  // Formal parameter count is the minimum number of JS arguments that's
  // expected to be present on the stack when a builtin is called. When
  // a JavaScript function is called with less arguments than expected by
  // a builtin the stack is "adapted" - i.e. the required number of undefined
  // values is pushed to the stack to match the target builtin expectations.
  // In case the builtin does not require arguments adaptation it returns
  // kDontAdaptArgumentsSentinel.
  static inline int GetFormalParameterCount(Builtin builtin);

  // Checks that the formal parameter count specified in CPP macro matches
  // the value set in SharedFunctionInfo.
  static bool CheckFormalParameterCount(
      Builtin builtin, int function_length,
      int formal_parameter_count_with_receiver);

  // Checks that a call to this JS builtin is allowed to be generated in user
  // code. Ensures that the formal parameter count matches the builtin's
  // parameter count and that the builtin is not a JS trampoline. The latter
  // is a sanity check against generating direct calls to JS trampolines - this
  // just doesn't make sense.
  // This is a similar to JSDispatchTable::IsCompatibleCode(..) but for
  // builtins.
  static inline bool IsCompatibleJSBuiltin(Builtin builtin,
                                           uint16_t parameter_count);

  V8_EXPORT_PRIVATE static const char* name(Builtin builtin);
  V8_EXPORT_PRIVATE static const char* NameForStackTrace(Isolate* isolate,
                                                         Builtin builtin);

  // Support for --print-builtin-size and --print-builtin-code.
  void PrintBuiltinCode();
  void PrintBuiltinSize();

  // Returns the C++ entry point for builtins implemented in C++, and the null
  // Address otherwise.
  static Address CppEntryOf(Builtin builtin);

  // Loads the builtin's entry (start of instruction stream) from the isolate's
  // builtin_entry_table, initialized earlier via {InitializeIsolateDataTables}.
  static inline Address EntryOf(Builtin builtin, Isolate* isolate);

  // Return the builtin entry inside the embedded data. Only used for Wasm where
  // we want to use them in isolate-independent context.
  V8_EXPORT_PRIVATE static Address EmbeddedEntryOf(Builtin builtin);

  V8_EXPORT_PRIVATE static Kind KindOf(Builtin builtin);
  static const char* KindNameOf(Builtin builtin);

  // The tag for the builtins entrypoint.
  V8_EXPORT_PRIVATE static CodeEntrypointTag EntrypointTagFor(Builtin builtin);

  // Returns the sandboxing mode of the given builtin.
  //
  // Note that this indicates the sandboxing mode that the builtin expects at
  // the start of its execution (in a sense part of its calling convention).
  // Some builtins change the sandboxing mode (for example, JSEntry expects to
  // be invoked in unsandboxed execution mode, then transitions into sandboxed
  // execution mode), which is not represented here.
  static CodeSandboxingMode SandboxingModeOf(Builtin builtin);

  V8_EXPORT_PRIVATE static bool IsCpp(Builtin builtin);

  // True, iff the given code object is a builtin. Note that this does not
  // necessarily mean that its kind is InstructionStream::BUILTIN.
  static bool IsBuiltin(const Tagged<Code> code);

  // As above, but safe to access off the main thread since the check is done
  // by handle location. Similar to Heap::IsRootHandle.
  bool IsBuiltinHandle(IndirectHandle<HeapObject> maybe_code,
                       Builtin* index) const;

  // True, iff the given builtin contains no isolate-specific code and can be
  // embedded into the binary.
  static constexpr bool kAllBuiltinsAreIsolateIndependent = true;
  static constexpr bool AllBuiltinsAreIsolateIndependent() {
    return kAllBuiltinsAreIsolateIndependent;
  }
  static constexpr bool IsIsolateIndependent(Builtin builtin) {
    static_assert(kAllBuiltinsAreIsolateIndependent);
    return kAllBuiltinsAreIsolateIndependent;
  }

  // True, iff the given code object is a builtin with off-heap embedded code.
  static bool IsIsolateIndependentBuiltin(Tagged<Code> code);

  static void InitializeIsolateDataTables(Isolate* isolate);

  // Emits a CodeCreateEvent for every builtin.
  static void EmitCodeCreateEvents(Isolate* isolate);

  bool is_initialized() const { return initialized_; }

  // Used by SetupIsolateDelegate and Deserializer.
  void MarkInitialized() {
    DCHECK(!initialized_);
    initialized_ = true;
  }

  V8_WARN_UNUSED_RESULT static MaybeHandle<Object> InvokeApiFunction(
      Isolate* isolate, bool is_construct,
      DirectHandle<FunctionTemplateInfo> function,
      DirectHandle<Object> receiver,
      base::Vector<const DirectHandle<Object>> args,
      DirectHandle<HeapObject> new_target);

  static void Generate_Adaptor(MacroAssembler* masm, int formal_parameter_count,
                               Address builtin_address);

  static void Generate_CEntry(MacroAssembler* masm, int result_size,
                              ArgvMode argv_mode, bool builtin_exit_frame,
                              bool switch_to_central_stack);

  static bool AllowDynamicFunction(Isolate* isolate,
                                   DirectHandle<JSFunction> target,
                                   DirectHandle<JSObject> target_global_proxy);

  // Creates a copy of InterpreterEntryTrampolineForProfiling in the code space.
  static DirectHandle<Code> CreateInterpreterEntryTrampolineForProfiling(
      Isolate* isolate);

  static inline constexpr bool IsJSEntryVariant(Builtin builtin);

  int js_entry_handler_offset() const {
    DCHECK_NE(js_entry_handler_offset_, 0);
    return js_entry_handler_offset_;
  }

  int jspi_prompt_handler_offset() const {
    DCHECK_NE(jspi_prompt_handler_offset_, 0);
    return jspi_prompt_handler_offset_;
  }

  void SetJSEntryHandlerOffset(int offset) {
    // Check the stored offset is either uninitialized or unchanged (we
    // generate multiple variants of this builtin but they should all have the
    // same handler offset).
    CHECK(js_entry_handler_offset_ == 0 || js_entry_handler_offset_ == offset);
    js_entry_handler_offset_ = offset;
  }

  void SetJSPIPromptHandlerOffset(int offset) {
    CHECK_EQ(jspi_prompt_handler_offset_, 0);
    jspi_prompt_handler_offset_ = offset;
  }

#if V8_ENABLE_DRUMBRAKE
  int cwasm_interpreter_entry_handler_offset() const {
    DCHECK_NE(cwasm_interpreter_entry_handler_offset_, 0);
    return cwasm_interpreter_entry_handler_offset_;
  }

  void SetCWasmInterpreterEntryHandlerOffset(int offset) {
    // Check the stored offset is either uninitialized or unchanged (we
    // generate multiple variants of this builtin but they should all have the
    // same handler offset).
    CHECK(cwasm_interpreter_entry_handler_offset_ == 0 ||
          cwasm_interpreter_entry_handler_offset_ == offset);
    cwasm_interpreter_entry_handler_offset_ = offset;
  }
#endif  // V8_ENABLE_DRUMBRAKE

  // Returns given builtin's slot in the main builtin table.
  FullObjectSlot builtin_slot(Builtin builtin);
  // Returns given builtin's slot in the tier0 builtin table.
  FullObjectSlot builtin_tier0_slot(Builtin builtin);

  // Public for ia32-specific helper.
  enum class ForwardWhichFrame { kCurrentFrame, kParentFrame };

  // Flags describing properties of a builtin with JS calling convention.
  // Builtins with non-JS linkage have kDisabledNonJSBuiltin flags.
  //
  // This machinery is used by V8 Sandbox to ensure that builtins that belong
  // to disabled features can't be made callable (i.e. can't be installed
  // into a JSFunction).
  enum class JSBuiltinStateFlag {
    kNone = 0,

    // Builtin is allowed to be installed as Code object into a JSFunction:
    //  - it has a JS calling convention,
    //  - it's an entry point builtin and not an arbitrary helper builtin that
    //    has JS calling convention for convenience.
    kEnabled = 1 << 0,

    // Builtin represents some JS trampoline builtin that can be set as a
    // JSFunction's code (for example, CompileLazy). It might or might not
    // be currently used.
    kCoreV8JSTrampoline = 1 << 1,

    // The builtin belongs to a JS language feature that's always available,
    // i.e. the builtin must be installed in some JSFunction by default.
    // For example, ArrayPrototypePush or StringPrototypeConcat.
    kCoreJS = 1 << 2,

    // The builtin belongs to a feature that's enabled by a runtime flag,
    // unlike core JS language builtins which are always available.
    kFlagDependent = 1 << 3,

    // The builtin might belong either to core JS language feature or to
    // to a feature behind runtime flag but in either case it's is installed
    // to JSFunctions lazily. This means that there might be no JSFunction
    // instances with this builtin in the heap even though the corresponding
    // JS feature is enabled.
    // For example, V8 lazily creates JSFunctions with
    // AsyncGeneratorAwaitResolveClosure and AsyncGeneratorAwaitRejectClosure
    // builtins as a part of AsyncGeneratorAwait logic, see
    // AsyncGeneratorBuiltinsAssembler::AsyncGeneratorAwait().
    kLazy = 1 << 4,

    // Builtin has non-JS linkage. State of this flag must be equivalent to
    // (!HasJSLinkage(..)) predicate.
    kNonJSLinkage = 1 << 5,

    // Common combinations.
    kJSTrampoline = kEnabled | kCoreV8JSTrampoline,
    kCoreJSMandatory = kEnabled | kCoreJS,
    kCoreJSLazy = kEnabled | kCoreJS | kLazy,

    kDisabledJSBuiltin = kNone,
    kDisabledNonJSBuiltin = kNonJSLinkage,
    kEnabledFlagDependent = kEnabled | kFlagDependent,
    kDisabledFlagDependent = kFlagDependent,
    kEnabledFlagDependentLazy = kEnabled | kFlagDependent | kLazy,
    kDisabledFlagDependentLazy = kFlagDependent | kLazy,
  };
  using JSBuiltinStateFlags = base::Flags<JSBuiltinStateFlag>;
  V8_EXPORT_PRIVATE static JSBuiltinStateFlags GetJSBuiltinState(
      Builtin builtin);

  // Returns true for disabled builtins with JS linkage (all non-JS builtins
  // are considered enabled).
  static inline bool IsDisabled(Builtin builtin);

  // Returns true if given builtin is a JS trampoline builtin - the builtin
  // that can be installed into JSFunction as a code object. Note, that
  // for example tiering trampoines are not allowed to be installed into
  // JSFunctions. This predicate is used as an allow-list of cases where
  // a signature mismatch is allowed. See JSDispatchTable::IsCompatibleCode().
  static inline bool IsJSTrampoline(Builtin builtin);

  // Returns true if given builtin is enabled and it's not a JS trampoline
  // builtin.
  static inline bool IsEnabledAndNotJSTrampoline(Builtin builtin);

#ifdef DEBUG
  // Verify correctness of GetJSBuiltinState() which has to be maintained
  // manually. The idea is to iterate the heap to figure out which builtins
  // with JS calling convention are never installed into any JSFunction and
  // make sure that GetJSBuiltinState() works properly for such builtins.
  //
  // |allow_non_initial_state| defines whether the strict verification is
  // not applicable because user code might have changed the heap state.
  // For example, user code could have
  //   - deleted mandatory builtin: delete String.prototype.concat;
  //   - triggered instantiation of some lazy builtins.
  //
  // In any case, even in this mode there must be no usages of disabled
  // builtins.
  void VerifyGetJSBuiltinState(bool allow_non_initial_state);
#endif

 private:
  static void Generate_CallFunction(MacroAssembler* masm,
                                    ConvertReceiverMode mode);

  static void Generate_CallBoundFunctionImpl(MacroAssembler* masm);

  static void Generate_Call(MacroAssembler* masm, ConvertReceiverMode mode);

  static void Generate_CallOrConstructVarargs(MacroAssembler* masm,
                                              Builtin target_builtin);
  enum class CallOrConstructMode { kCall, kConstruct };
  static void Generate_CallOrConstructForwardVarargs(MacroAssembler* masm,
                                                     CallOrConstructMode mode,
                                                     Builtin target_builtin);

  static void Generate_MaglevFunctionEntryStackCheck(MacroAssembler* masm,
                                                     bool save_new_target);

  enum class InterpreterEntryTrampolineMode {
    // The version of InterpreterEntryTrampoline used by default.
    kDefault,
    // The position independent version of InterpreterEntryTrampoline used as
    // a template to create copies of the builtin at runtime. The copies are
    // used to create better profiling information for ticks in bytecode
    // execution. See v8_flags.interpreted_frames_native_stack for details.
    kForProfiling
  };
  static void Generate_InterpreterEntryTrampoline(
      MacroAssembler* masm, InterpreterEntryTrampolineMode mode);

  static void Generate_InterpreterPushArgsThenCallImpl(
      MacroAssembler* masm, ConvertReceiverMode receiver_mode,
      InterpreterPushArgsMode mode);

  static void Generate_InterpreterPushArgsThenConstructImpl(
      MacroAssembler* masm, InterpreterPushArgsMode mode);

  static void Generate_ConstructForwardAllArgsImpl(
      MacroAssembler* masm, ForwardWhichFrame which_frame);

  static void Generate_CallApiCallbackImpl(MacroAssembler* masm,
                                           CallApiCallbackMode mode);

  static void Generate_CallApiAccessorImpl(MacroAssembler* masm,
                                           bool for_interceptor,
                                           bool for_setter);

#define DECLARE_ASM(Name, ...) \
  static void Generate_##Name(MacroAssembler* masm);
#define DECLARE_TF(Name, ...) \
  static void Generate_##Name(compiler::CodeAssemblerState* state);
#define DECLARE_TS(Name, ...)                                           \
  static void Generate_##Name(compiler::turboshaft::PipelineData* data, \
                              Isolate* isolate,                         \
                              compiler::turboshaft::Graph& graph, Zone* zone);

  BUILTIN_LIST(IGNORE_BUILTIN, DECLARE_TS, DECLARE_TF, DECLARE_TS, DECLARE_TF,
               DECLARE_TF, DECLARE_TF, IGNORE_BUILTIN, IGNORE_BUILTIN,
               DECLARE_ASM)

#undef DECLARE_ASM
#undef DECLARE_TF

  Isolate* isolate_;
  bool initialized_ = false;

  // Stores the offset of exception handler entry point (the handler_entry
  // label) in JSEntry and its variants. It's used to generate the handler table
  // during codegen (mksnapshot-only).
  int js_entry_handler_offset_ = 0;

#if V8_ENABLE_DRUMBRAKE
  // Stores the offset of exception handler entry point (the handler_entry
  // label) in CWasmInterpreterEntry. It's used to generate the handler table
  // during codegen (mksnapshot-only).
  int cwasm_interpreter_entry_handler_offset_ = 0;
#endif  // V8_ENABLE_DRUMBRAKE

  // Do the same for the JSPI prompt, which catches uncaught exceptions and
  // rejects the corresponding promise.
  int jspi_prompt_handler_offset_ = 0;

  friend class SetupIsolateDelegate;
};

DEFINE_OPERATORS_FOR_FLAGS(Builtins::JSBuiltinStateFlags)

V8_INLINE constexpr bool IsInterpreterTrampolineBuiltin(Builtin builtin_id) {
  // Check for kNoBuiltinId first to abort early when the current
  // InstructionStream object is not a builtin.
  return builtin_id != Builtin::kNoBuiltinId &&
         (builtin_id == Builtin::kInterpreterEntryTrampoline ||
          builtin_id == Builtin::kInterpreterEnterAtBytecode ||
          builtin_id == Builtin::kInterpreterEnterAtNextBytecode);
}

V8_INLINE constexpr bool IsBaselineTrampolineBuiltin(Builtin builtin_id) {
  // Check for kNoBuiltinId first to abort early when the current
  // InstructionStream object is not a builtin.
  return builtin_id != Builtin::kNoBuiltinId &&
         (builtin_id == Builtin::kBaselineOutOfLinePrologue ||
          builtin_id == Builtin::kBaselineOutOfLinePrologueDeopt);
}

Builtin ExampleBuiltinForTorqueFunctionPointerType(
    size_t function_pointer_type_id);

#ifdef DEBUG
// BuiltinCanAllocate is generated by mksnapshot in
// gen/src/builtins/builtins-effects.cc.
bool BuiltinCanAllocate(Builtin builtin);
#endif

}  // namespace internal
}  // namespace v8

// Helper while transitioning some functions to libm.
#if defined(V8_USE_LIBM_TRIG_FUNCTIONS)
#define SIN_IMPL(X)                                             \
  v8_flags.use_libm_trig_functions ? base::ieee754::libm_sin(X) \
                                   : base::ieee754::fdlibm_sin(X)
#define COS_IMPL(X)                                             \
  v8_flags.use_libm_trig_functions ? base::ieee754::libm_cos(X) \
                                   : base::ieee754::fdlibm_cos(X)
#else
#define SIN_IMPL(X) base::ieee754::sin(X)
#define COS_IMPL(X) base::ieee754::cos(X)
#endif

#endif  // V8_BUILTINS_BUILTINS_H_