react-native-tvos 0.73.6-1 → 0.74.0-0rc0

package/ReactCommon/hermes/inspector-modern/chrome/cli/main.cpp

@@ -1,275 +0,0 @@
-/*
- * Copyright (c) Meta Platforms, Inc. and affiliates.
- *
- * This source code is licensed under the MIT license found in the
- * LICENSE file in the root directory of this source tree.
- */
-
-#include <cstdio>
-#include <cstdlib>
-#include <fstream>
-#include <iostream>
-#include <memory>
-#include <thread>
-#include <utility>
-
-#include <getopt.h>
-
-#include <folly/json.h>
-#include <hermes/hermes.h>
-#include <hermes/inspector-modern/RuntimeAdapter.h>
-#include <hermes/inspector-modern/chrome/Connection.h>
-
-using ::facebook::react::IRemoteConnection;
-
-namespace fbhermes = ::facebook::hermes;
-
-static const char *usageMessage = R"(hermes-chrome-debug-server script.js
-
-Uses Hermes to evaluate script.js within a debugging session. The process will
-wait for Chrome DevTools Protocol requests on stdin and writes responses and
-events to stdout.
-
-This can be used with a WebSocket bridge to host a Chrome DevTools Protocol
-debug server. For instance, running this:
-
-  websocketd --port=9999 hermes-chrome-debug-server script.js
-
-will run a WebSocket server on port 9999 that debugs script.js in Hermes. Chrome
-can connect to this debugging session using a URL like this:
-
-  devtools://devtools/bundled/inspector.html?experiments=false&v8only=true&ws=127.0.0.1:9999
-
-Options:
-
- -l, --log:  path to a file with pretty-printed protocol logs
- -h, --help: this message
-)";
-
-static void usage() {
-  fputs(usageMessage, stderr);
-  exit(1);
-}
-
-/// Truncate UTF8 string \p s to be at most \p len bytes long.  If a multi-byte
-/// sequence crosses the limit (len), it will be wholly omitted from the
-/// output.  If the output is truncated, it will be suffixed with "...".
-///
-/// \pre len must be strictly greater than the length of the truncation suffix
-///     (three characters), so there is something left after truncation.
-static void truncate(std::string &s, size_t len) {
-  static constexpr char suffix[] = "...";
-  static const size_t suflen = strlen(suffix);
-  assert(len > suflen);
-
-  if (s.size() <= len) {
-    return;
-  }
-
-  // Iterate back from the edge to pop off continuation bytes.
-  ssize_t last = len - suflen;
-  while (last > 0 && (s[last] & 0xC0) == 0x80)
-    --last;
-
-  // Copy in the suffix.
-  strncpy(&s[last], suffix, suflen);
-
-  // Trim the excess.
-  s.resize(last + suflen);
-}
-
-/// Traverse the structure of \p d, truncating all the strings found,
-/// (excluding object keys) to at most \p len bytes long using the definition
-/// of truncate above.
-static void truncateStringsIn(folly::dynamic &d, size_t len) {
-  switch (d.type()) {
-    case folly::dynamic::STRING:
-      truncate(d.getString(), len);
-      break;
-
-    case folly::dynamic::ARRAY:
-      for (auto &child : d) {
-        truncateStringsIn(child, len);
-      }
-      break;
-
-    case folly::dynamic::OBJECT:
-      for (auto &kvp : d.items()) {
-        truncateStringsIn(kvp.second, len);
-      }
-      break;
-
-    default:
-      /* nop */
-      break;
-  }
-}
-
-/// Pretty print the JSON blob contained within \p str, by introducing
-/// parsing it and pretty printing it.  Large string values (larger than 512
-/// characters) are truncated.
-///
-/// \pre str contains a valid JSON blob.
-static std::string prettify(const std::string &str) {
-  constexpr size_t MAX_LINE_LEN = 512;
-
-  try {
-    folly::dynamic obj = folly::parseJson(str);
-    truncateStringsIn(obj, MAX_LINE_LEN);
-    return folly::toPrettyJson(obj);
-  } catch (...) {
-    // pass
-  }
-
-  if (str.size() > MAX_LINE_LEN) {
-    std::string cpy = str;
-    truncate(cpy, MAX_LINE_LEN);
-    return cpy;
-  }
-
-  return str;
-}
-
-static FILE *logFile = stderr;
-
-static void setLogFilePath(const char *path) {
-  logFile = fopen(path, "w");
-
-  if (logFile == nullptr) {
-    perror("fopen couldn't open log file");
-    exit(1);
-  }
-}
-
-static void log(const std::string &str, bool isReq) {
-  fprintf(logFile, "%s %s\n\n", isReq ? "=>" : "<=", prettify(str).c_str());
-}
-
-static void logRequest(const std::string &str) {
-  log(str, true);
-}
-
-static void sendResponse(const std::string &str) {
-  log(str, false);
-  printf("%s\n", str.c_str());
-}
-
-static std::string readScriptSource(const char *path) {
-  std::ifstream stream(path);
-  return std::string{
-      std::istreambuf_iterator<char>(stream), std::istreambuf_iterator<char>()};
-}
-
-static std::string getUrl(const char *path) {
-  char absPath[PATH_MAX] = {};
-  realpath(path, absPath);
-  return std::string("file://") + absPath;
-}
-
-static bool handleScriptSourceRequest(
-    const std::string &reqStr,
-    const std::string &scriptSource) {
-  auto req = folly::parseJson(reqStr);
-
-  if (req.at("method") == "Debugger.getScriptSource") {
-    folly::dynamic result = folly::dynamic::object;
-    result["scriptSource"] = scriptSource;
-
-    folly::dynamic resp = folly::dynamic::object;
-    resp["id"] = req.at("id");
-    resp["result"] = std::move(result);
-
-    sendResponse(folly::toJson(resp));
-
-    return true;
-  }
-
-  return false;
-}
-
-class RemoteConnection : public IRemoteConnection {
- public:
-  void onMessage(std::string message) override {
-    sendResponse(message);
-  }
-
-  void onDisconnect() override {}
-};
-
-static void runDebuggerLoop(
-    fbhermes::inspector_modern::chrome::Connection &conn,
-    std::string scriptSource) {
-  conn.connect(std::make_unique<RemoteConnection>());
-
-  std::string line;
-  while (std::getline(std::cin, line)) {
-    logRequest(line);
-
-    if (!handleScriptSourceRequest(line, scriptSource)) {
-      conn.sendMessage(line);
-    }
-  }
-}
-
-static void runScript(const std::string &scriptSource, const std::string &url) {
-  std::shared_ptr<fbhermes::HermesRuntime> runtime(
-      fbhermes::makeHermesRuntime(::hermes::vm::RuntimeConfig::Builder()
-                                      .withEnableSampleProfiling(true)
-                                      .build()));
-  auto adapter =
-      std::make_unique<fbhermes::inspector_modern::SharedRuntimeAdapter>(
-          runtime);
-  fbhermes::inspector_modern::chrome::Connection conn(
-      std::move(adapter), "hermes-chrome-debug-server");
-  std::thread debuggerLoop(runDebuggerLoop, std::ref(conn), scriptSource);
-
-  fbhermes::HermesRuntime::DebugFlags flags{};
-  runtime->debugJavaScript(scriptSource, url, flags);
-
-  debuggerLoop.join();
-}
-
-int main(int argc, char **argv) {
-  const char *shortOpts = "l:h";
-  const option longOpts[] = {
-      {"log", 1, nullptr, 'l'},
-      {"help", 0, nullptr, 'h'},
-      {nullptr, 0, nullptr, 0}};
-
-  while (true) {
-    int opt = getopt_long(argc, argv, shortOpts, longOpts, nullptr);
-    if (opt == -1) {
-      break;
-    }
-
-    switch (opt) {
-      case 'l':
-        setLogFilePath(optarg);
-        break;
-      case 'h':
-        usage();
-        break;
-      default:
-        fprintf(stderr, "Unrecognized option: %c\n", opt);
-        usage();
-        break;
-    }
-  }
-
-  setbuf(logFile, nullptr);
-  setbuf(stdout, nullptr);
-
-  if (optind + 1 != argc) {
-    usage();
-  }
-
-  const char *path = argv[optind];
-  std::string scriptSource = readScriptSource(path);
-  std::string url = getUrl(path);
-
-  runScript(scriptSource, url);
-
-  fclose(logFile);
-
-  return 0;
-}

package/ReactCommon/hermes/inspector-modern/detail/CallbackOStream.cpp

@@ -1,77 +0,0 @@
-/*
- * Copyright (c) Meta Platforms, Inc. and affiliates.
- *
- * This source code is licensed under the MIT license found in the
- * LICENSE file in the root directory of this source tree.
- */
-
-#include "CallbackOStream.h"
-
-#include <algorithm>
-#include <cassert>
-
-namespace facebook {
-namespace hermes {
-namespace inspector_modern {
-namespace detail {
-
-CallbackOStream::CallbackOStream(size_t sz, Fn cb)
-    : std::ostream(&sbuf_), sbuf_(sz, std::move(cb)) {}
-
-CallbackOStream::StreamBuf::StreamBuf(size_t sz, Fn cb)
-    : sz_(sz), buf_(std::make_unique<char[]>(sz)), cb_(std::move(cb)) {
-  reset();
-}
-
-CallbackOStream::StreamBuf::~StreamBuf() {
-  sync();
-}
-
-std::streambuf::int_type CallbackOStream::StreamBuf::overflow(
-    std::streambuf::int_type ch) {
-  assert(pptr() <= epptr() && "overflow expects the buffer not to be overfull");
-
-  if (!pptr()) {
-    return traits_type::eof();
-  }
-
-  *pptr() = ch;
-  pbump(1);
-
-  if (sync() == 0) {
-    return traits_type::not_eof(ch);
-  }
-
-  // Set to nullptr on failure.
-  setp(nullptr, nullptr);
-  return traits_type::eof();
-}
-
-int CallbackOStream::StreamBuf::sync() {
-  try {
-    return pbase() == pptr() || cb_(take()) ? 0 : -1;
-  } catch (...) {
-    return -1;
-  }
-}
-
-void CallbackOStream::StreamBuf::reset() {
-  assert(sz_ > 0 && "Buffer cannot be empty.");
-  // std::streambuf::overflow accepts the character that caused the overflow as
-  // a parameter.  Part of handling the overflow is adding this character to the
-  // stream.  We choose to do this by stealing a byte at the end of the "put"
-  // area where the character can be written, even if the area is otherwise
-  // full, immediately prior to being flushed.
-  setp(&buf_[0], &buf_[0] + sz_ - 1);
-}
-
-std::string CallbackOStream::StreamBuf::take() {
-  const size_t strsz = pptr() - pbase();
-  reset();
-  return std::string(pbase(), strsz);
-}
-
-} // namespace detail
-} // namespace inspector_modern
-} // namespace hermes
-} // namespace facebook

package/ReactCommon/hermes/inspector-modern/detail/CallbackOStream.h

@@ -1,89 +0,0 @@
-/*
- * Copyright (c) Meta Platforms, Inc. and affiliates.
- *
- * This source code is licensed under the MIT license found in the
- * LICENSE file in the root directory of this source tree.
- */
-
-#pragma once
-
-#include <functional>
-#include <memory>
-#include <ostream>
-#include <streambuf>
-#include <string>
-
-namespace facebook {
-namespace hermes {
-namespace inspector_modern {
-namespace detail {
-
-/// Subclass of \c std::ostream where flushing is implemented through a
-/// callback.  Writes are collected in a buffer.  When filled, the buffer's
-/// contents are emptied out and sent to a callback.
-struct CallbackOStream : public std::ostream {
-  /// Signature of callback called to flush buffer contents.  Accepts the buffer
-  /// as a string.  Returns a boolean indicating whether flushing succeeded.
-  /// Callback failure will be translated to stream failure.  If the callback
-  /// throws an exception it will be swallowed and translated into stream
-  /// failure.
-  using Fn = std::function<bool(std::string)>;
-
-  /// Construct a new stream.
-  ///
-  /// \p sz The size of the buffer -- how large it can get before it must be
-  ///   flushed.  Must be non-zero.
-  /// \p cb The callback function.
-  CallbackOStream(size_t sz, Fn cb);
-
-  /// This class is neither movable nor copyable.
-  CallbackOStream(CallbackOStream &&that) = delete;
-  CallbackOStream &operator=(CallbackOStream &&that) = delete;
-  CallbackOStream(const CallbackOStream &that) = delete;
-  CallbackOStream &operator=(const CallbackOStream &that) = delete;
-
- private:
-  /// \c std::streambuf sub-class backed by a std::string buffer and
-  /// implementing overflow by calling a callback.
-  struct StreamBuf : public std::streambuf {
-    /// Construct a new streambuf.  Parameters are the same as those of
-    /// \c CallbackOStream .
-    StreamBuf(size_t sz, Fn cb);
-
-    /// Destruction will flush any remaining buffer contents.
-    ~StreamBuf();
-
-    /// StreamBufs are not copyable, to avoid the flush callback receiving
-    /// the contents of multiple streams.
-    StreamBuf(const StreamBuf &) = delete;
-    StreamBuf &operator=(const StreamBuf &) = delete;
-
-   protected:
-    /// std::streambuf overrides
-    int_type overflow(int_type ch) override;
-    int sync() override;
-
-   private:
-    /// The size of the backing buffer.  Fixed for an instance of the streambuf.
-    size_t sz_;
-
-    /// The backing buffer that writes will go to until full.
-    std::unique_ptr<char[]> buf_;
-
-    /// The function called when buf_ has been filled.
-    Fn cb_;
-
-    /// Clears the backing buffer.
-    void reset();
-
-    /// Clears the backing buffer and returns it contents in a string.
-    std::string take();
-  };
-
-  StreamBuf sbuf_;
-};
-
-} // namespace detail
-} // namespace inspector_modern
-} // namespace hermes
-} // namespace facebook

package/ReactCommon/hermes/inspector-modern/detail/SerialExecutor.cpp

@@ -1,60 +0,0 @@
-/*
- * Copyright (c) Meta Platforms, Inc. and affiliates.
- *
- * This source code is licensed under the MIT license found in the
- * LICENSE file in the root directory of this source tree.
- */
-
-#include "SerialExecutor.h"
-
-namespace facebook {
-namespace hermes {
-namespace inspector_modern {
-namespace detail {
-
-SerialExecutor::SerialExecutor(const std::string &name)
-    : finish_(false), thread_(name, [this]() { runLoop(); }) {}
-
-SerialExecutor::~SerialExecutor() {
-  {
-    std::scoped_lock lock(mutex_);
-    finish_ = true;
-    wakeup_.notify_one();
-  }
-
-  thread_.join();
-}
-
-void SerialExecutor::add(folly::Func func) {
-  std::scoped_lock lock(mutex_);
-  funcs_.push(std::move(func));
-  wakeup_.notify_one();
-}
-
-void SerialExecutor::runLoop() {
-  bool shouldExit = false;
-  while (!shouldExit) {
-    folly::Func func;
-
-    {
-      std::unique_lock<std::mutex> lock(mutex_);
-      wakeup_.wait(lock, [this] { return finish_ || !funcs_.empty(); });
-
-      if (!funcs_.empty()) {
-        func = std::move(funcs_.front());
-        funcs_.pop();
-      }
-
-      shouldExit = funcs_.empty() && finish_;
-    }
-
-    if (func) {
-      func();
-    }
-  }
-}
-
-} // namespace detail
-} // namespace inspector_modern
-} // namespace hermes
-} // namespace facebook

package/ReactCommon/hermes/inspector-modern/detail/SerialExecutor.h

@@ -1,57 +0,0 @@
-/*
- * Copyright (c) Meta Platforms, Inc. and affiliates.
- *
- * This source code is licensed under the MIT license found in the
- * LICENSE file in the root directory of this source tree.
- */
-
-#pragma once
-
-#include <condition_variable>
-#include <mutex>
-#include <queue>
-#include <string>
-
-#include <hermes/inspector-modern/detail/Thread.h>
-
-#include <folly/Executor.h>
-
-namespace facebook {
-namespace hermes {
-namespace inspector_modern {
-namespace detail {
-
-/// SerialExecutor is a simple implementation of folly::Executor that processes
-/// work items serially on a worker thread. It exists for two reasons:
-///
-///   1. Currently Hermes builds for the host as well as in fbandroid and
-///      fbobjc, so we need an implementation of a serial executor that doesn't
-///      use the SerialAsyncExecutorFactory from fbandroid or fbobjc.
-///   2. None of folly's Executor factories are included in the stripped-down
-///      version of folly in xplat.
-///
-/// TODO: create a factory that uses SerialAsyncExecutorFactory if we're
-/// building for fbandroid or fbobjc, and otherwise creates an instance of this
-/// class.
-class SerialExecutor : public folly::Executor {
- public:
-  SerialExecutor(const std::string &name);
-  ~SerialExecutor() override;
-
-  void add(folly::Func) override;
-
- private:
-  void runLoop();
-
-  std::mutex mutex_;
-  std::queue<folly::Func> funcs_;
-  std::condition_variable wakeup_;
-  bool finish_;
-
-  Thread thread_;
-};
-
-} // namespace detail
-} // namespace inspector_modern
-} // namespace hermes
-} // namespace facebook

package/ReactCommon/hermes/inspector-modern/detail/Thread.cpp

@@ -1,39 +0,0 @@
-/*
- * Copyright (c) Meta Platforms, Inc. and affiliates.
- *
- * This source code is licensed under the MIT license found in the
- * LICENSE file in the root directory of this source tree.
- */
-
-#ifdef __ANDROID__
-#include "Thread.h"
-
-#include <fbjni/JThread.h>
-
-namespace facebook {
-namespace hermes {
-namespace inspector_modern {
-namespace detail {
-
-struct Thread::Impl {
-  facebook::jni::global_ref<facebook::jni::JThread> thread_;
-};
-
-Thread::Thread(std::string, std::function<void()> runnable)
-    : impl_(std::make_unique<Impl>(Impl{facebook::jni::make_global(
-          facebook::jni::JThread::create(std::move(runnable)))})) {
-  impl_->thread_->start();
-}
-
-Thread::~Thread() {}
-
-void Thread::join() {
-  impl_->thread_->join();
-}
-
-} // namespace detail
-} // namespace inspector_modern
-} // namespace hermes
-} // namespace facebook
-
-#endif

package/ReactCommon/hermes/inspector-modern/detail/Thread.h

@@ -1,85 +0,0 @@
-/*
- * Copyright (c) Meta Platforms, Inc. and affiliates.
- *
- * This source code is licensed under the MIT license found in the
- * LICENSE file in the root directory of this source tree.
- */
-
-#pragma once
-
-#include <functional>
-#include <memory>
-
-#ifdef _WINDOWS
-#include <thread>
-#elif !defined(__ANDROID__)
-#include <pthread.h>
-#include <thread>
-#endif
-
-namespace facebook {
-namespace hermes {
-namespace inspector_modern {
-namespace detail {
-
-#ifdef __ANDROID__
-
-/// Android version of Thread that uses JThread, which is a java.lang.Thread.
-/// This is desirable because real Java threads have access to the app's
-/// classloader, which allows us to call in to Java from C++.
-///
-/// The implementation is private to the .cpp file to avoid leaking
-/// the fbjni dependencies into code which creates Threads.
-
-class Thread {
- public:
-  Thread(std::string name, std::function<void()> runnable);
-  ~Thread();
-
-  void detach() {
-    // Java threads don't need to be explicitly detached
-  }
-
-  void join();
-
- private:
-  struct Impl;
-  std::unique_ptr<Impl> impl_;
-};
-
-#else
-
-class Thread {
- public:
-  Thread(std::string name, std::function<void()> runnable)
-      : thread_(run, name, runnable) {}
-
-  void detach() {
-    thread_.detach();
-  }
-
-  void join() {
-    thread_.join();
-  }
-
- private:
-  static void run(std::string name, std::function<void()> runnable) {
-#if defined(_GNU_SOURCE)
-    pthread_setname_np(pthread_self(), name.c_str());
-#elif defined(__APPLE__)
-    pthread_setname_np(name.c_str());
-#endif
-
-    runnable();
-  }
-
-  std::thread thread_;
-};
-
-#endif
-
-}; // namespace detail
-
-} // namespace inspector_modern
-} // namespace hermes
-} // namespace facebook

package/ReactCommon/hermes/inspector-modern/docs/GenerateInspectorFSM.sh

@@ -1,7 +0,0 @@
-#!/bin/sh
-# Copyright (c) Meta Platforms, Inc. and affiliates.
-#
-# This source code is licensed under the MIT license found in the
-# LICENSE file in the root directory of this source tree.
-
-dot -Tpdf InspectorFSM.gv -o InspectorFSM.pdf