Method beginDatasetPass

app/src/DataModel/FrameBuilder.cpp:1386–1412

* @brief Shared per-frame scaffolding (capture flag, engine cache, watchdog arm, storage pin); * returns true when the JS watchdog was armed (forwarded to endDatasetPass). */

 *        returns true when the JS watchdog was armed (forwarded to endDatasetPass).
 */
bool DataModel::FrameBuilder::beginDatasetPass(const TransformFrameInfo& info)
{
  static auto& parser = DataModel::FrameParser::instance();
  const int epoch     = parser.engineEpoch();
  if (m_captureFlagsDirty || epoch != m_seenEngineEpoch) [[unlikely]] {
    m_seenEngineEpoch = epoch;
    refreshDatasetCaptureFlag();
  }

  if (info.sourceId != m_engineCacheSourceId) [[unlikely]] {
    m_engineCacheSourceId = info.sourceId;
    auto luaIt            = m_transformEngines.find({info.sourceId, SerialStudio::Lua});
    auto jsIt             = m_transformEngines.find({info.sourceId, SerialStudio::JavaScript});
    m_luaEngineForSource  = (luaIt != m_transformEngines.end()) ? &luaIt->second : nullptr;
    m_jsEngineForSource   = (jsIt != m_transformEngines.end()) ? &jsIt->second : nullptr;
  }

  const bool armJsWatchdog = (m_jsEngineForSource != nullptr);
  if (armJsWatchdog) [[unlikely]] {
    Q_ASSERT(m_jsEngineForSource->jsWatchdog);
    m_jsTransformTimedOut = false;
    m_jsEngineForSource->jsWatchdog->arm();
  }

  ++m_compileGuard;
  return armJsWatchdog;
}

/**
 * @brief Releases the dataset-pass scaffolding: unpins engine storage, disarms the watchdog and