@onekeyfe/react-native-perf-stats 3.0.25

package/nitrogen/generated/shared/c++/HybridReactNativePerfStatsSpec.hpp

@@ -0,0 +1,68 @@
+///
+/// HybridReactNativePerfStatsSpec.hpp
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © 2026 Marc Rousavy @ Margelo
+///
+
+#pragma once
+
+#if __has_include(<NitroModules/HybridObject.hpp>)
+#include <NitroModules/HybridObject.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+
+// Forward declaration of `PerfSample` to properly resolve imports.
+namespace margelo::nitro::reactnativeperfstats { struct PerfSample; }
+
+#include "PerfSample.hpp"
+#include <NitroModules/Promise.hpp>
+
+namespace margelo::nitro::reactnativeperfstats {
+
+  using namespace margelo::nitro;
+
+  /**
+   * An abstract base class for `ReactNativePerfStats`
+   * Inherit this class to create instances of `HybridReactNativePerfStatsSpec` in C++.
+   * You must explicitly call `HybridObject`'s constructor yourself, because it is virtual.
+   * @example
+   * ```cpp
+   * class HybridReactNativePerfStats: public HybridReactNativePerfStatsSpec {
+   * public:
+   *   HybridReactNativePerfStats(...): HybridObject(TAG) { ... }
+   *   // ...
+   * };
+   * ```
+   */
+  class HybridReactNativePerfStatsSpec: public virtual HybridObject {
+    public:
+      // Constructor
+      explicit HybridReactNativePerfStatsSpec(): HybridObject(TAG) { }
+
+      // Destructor
+      ~HybridReactNativePerfStatsSpec() override = default;
+
+    public:
+      // Properties
+      
+
+    public:
+      // Methods
+      virtual void start(double intervalMs) = 0;
+      virtual void stop() = 0;
+      virtual void showOverlay() = 0;
+      virtual void hideOverlay() = 0;
+      virtual std::shared_ptr<Promise<PerfSample>> sample() = 0;
+
+    protected:
+      // Hybrid Setup
+      void loadHybridMethods() override;
+
+    protected:
+      // Tag for logging
+      static constexpr auto TAG = "ReactNativePerfStats";
+  };
+
+} // namespace margelo::nitro::reactnativeperfstats

package/nitrogen/generated/shared/c++/PerfSample.hpp

@@ -0,0 +1,83 @@
+///
+/// PerfSample.hpp
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © 2026 Marc Rousavy @ Margelo
+///
+
+#pragma once
+
+#if __has_include(<NitroModules/JSIConverter.hpp>)
+#include <NitroModules/JSIConverter.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+#if __has_include(<NitroModules/NitroDefines.hpp>)
+#include <NitroModules/NitroDefines.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+#if __has_include(<NitroModules/JSIHelpers.hpp>)
+#include <NitroModules/JSIHelpers.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+
+
+
+
+
+namespace margelo::nitro::reactnativeperfstats {
+
+  /**
+   * A struct which can be represented as a JavaScript object (PerfSample).
+   */
+  struct PerfSample {
+  public:
+    double cpu     SWIFT_PRIVATE;
+    double rss     SWIFT_PRIVATE;
+    double timestamp     SWIFT_PRIVATE;
+
+  public:
+    PerfSample() = default;
+    explicit PerfSample(double cpu, double rss, double timestamp): cpu(cpu), rss(rss), timestamp(timestamp) {}
+  };
+
+} // namespace margelo::nitro::reactnativeperfstats
+
+namespace margelo::nitro {
+
+  // C++ PerfSample <> JS PerfSample (object)
+  template <>
+  struct JSIConverter<margelo::nitro::reactnativeperfstats::PerfSample> final {
+    static inline margelo::nitro::reactnativeperfstats::PerfSample fromJSI(jsi::Runtime& runtime, const jsi::Value& arg) {
+      jsi::Object obj = arg.asObject(runtime);
+      return margelo::nitro::reactnativeperfstats::PerfSample(
+        JSIConverter<double>::fromJSI(runtime, obj.getProperty(runtime, "cpu")),
+        JSIConverter<double>::fromJSI(runtime, obj.getProperty(runtime, "rss")),
+        JSIConverter<double>::fromJSI(runtime, obj.getProperty(runtime, "timestamp"))
+      );
+    }
+    static inline jsi::Value toJSI(jsi::Runtime& runtime, const margelo::nitro::reactnativeperfstats::PerfSample& arg) {
+      jsi::Object obj(runtime);
+      obj.setProperty(runtime, "cpu", JSIConverter<double>::toJSI(runtime, arg.cpu));
+      obj.setProperty(runtime, "rss", JSIConverter<double>::toJSI(runtime, arg.rss));
+      obj.setProperty(runtime, "timestamp", JSIConverter<double>::toJSI(runtime, arg.timestamp));
+      return obj;
+    }
+    static inline bool canConvert(jsi::Runtime& runtime, const jsi::Value& value) {
+      if (!value.isObject()) {
+        return false;
+      }
+      jsi::Object obj = value.getObject(runtime);
+      if (!nitro::isPlainObject(runtime, obj)) {
+        return false;
+      }
+      if (!JSIConverter<double>::canConvert(runtime, obj.getProperty(runtime, "cpu"))) return false;
+      if (!JSIConverter<double>::canConvert(runtime, obj.getProperty(runtime, "rss"))) return false;
+      if (!JSIConverter<double>::canConvert(runtime, obj.getProperty(runtime, "timestamp"))) return false;
+      return true;
+    }
+  };
+
+} // namespace margelo::nitro

package/package.json

@@ -0,0 +1,169 @@
+{
+  "name": "@onekeyfe/react-native-perf-stats",
+  "version": "3.0.25",
+  "description": "react-native-perf-stats",
+  "main": "./lib/module/index.js",
+  "types": "./lib/typescript/src/index.d.ts",
+  "exports": {
+    ".": {
+      "source": "./src/index.tsx",
+      "types": "./lib/typescript/src/index.d.ts",
+      "default": "./lib/module/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "src",
+    "lib",
+    "android",
+    "ios",
+    "cpp",
+    "nitrogen",
+    "nitro.json",
+    "*.podspec",
+    "react-native.config.js",
+    "!ios/build",
+    "!android/build",
+    "!android/gradle",
+    "!android/gradlew",
+    "!android/gradlew.bat",
+    "!android/local.properties",
+    "!**/__tests__",
+    "!**/__fixtures__",
+    "!**/__mocks__",
+    "!**/.*"
+  ],
+  "scripts": {
+    "clean": "del-cli android/build example/android/build example/android/app/build example/ios/build lib",
+    "prepare": "bob build",
+    "nitrogen": "nitrogen",
+    "typecheck": "tsc",
+    "lint": "eslint \"**/*.{js,ts,tsx}\"",
+    "test": "jest",
+    "release": "yarn prepare && npm whoami && npm publish --access public"
+  },
+  "keywords": [
+    "react-native",
+    "ios",
+    "android"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/OneKeyHQ/app-modules/react-native-perf-stats.git"
+  },
+  "author": "onekeyfe <huanming@onekey.so> (https://github.com/OneKeyHQ/app-modules)",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/OneKeyHQ/app-modules/react-native-perf-stats/issues"
+  },
+  "homepage": "https://github.com/OneKeyHQ/app-modules/react-native-perf-stats#readme",
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/"
+  },
+  "devDependencies": {
+    "@commitlint/config-conventional": "^19.8.1",
+    "@eslint/compat": "^1.3.2",
+    "@eslint/eslintrc": "^3.3.1",
+    "@eslint/js": "^9.35.0",
+    "@react-native/babel-preset": "0.83.0",
+    "@react-native/eslint-config": "0.83.0",
+    "@release-it/conventional-changelog": "^10.0.1",
+    "@types/jest": "^29.5.14",
+    "@types/react": "^19.2.0",
+    "commitlint": "^19.8.1",
+    "del-cli": "^6.0.0",
+    "eslint": "^9.35.0",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-prettier": "^5.5.4",
+    "jest": "^29.7.0",
+    "lefthook": "^2.0.3",
+    "nitrogen": "0.31.10",
+    "prettier": "^2.8.8",
+    "react": "19.2.0",
+    "react-native": "0.83.0",
+    "react-native-builder-bob": "^0.40.13",
+    "react-native-nitro-modules": "0.33.2",
+    "release-it": "^19.0.4",
+    "turbo": "^2.5.6",
+    "typescript": "^5.9.2"
+  },
+  "peerDependencies": {
+    "react": "*",
+    "react-native": "*",
+    "react-native-nitro-modules": "0.33.2"
+  },
+  "react-native-builder-bob": {
+    "source": "src",
+    "output": "lib",
+    "targets": [
+      [
+        "custom",
+        {
+          "script": "nitrogen",
+          "clean": "nitrogen/"
+        }
+      ],
+      [
+        "module",
+        {
+          "esm": true
+        }
+      ],
+      [
+        "typescript",
+        {
+          "project": "tsconfig.build.json"
+        }
+      ]
+    ]
+  },
+  "prettier": {
+    "quoteProps": "consistent",
+    "singleQuote": true,
+    "tabWidth": 2,
+    "trailingComma": "es5",
+    "useTabs": false
+  },
+  "jest": {
+    "preset": "react-native",
+    "modulePathIgnorePatterns": [
+      "<rootDir>/example/node_modules",
+      "<rootDir>/lib/"
+    ]
+  },
+  "commitlint": {
+    "extends": [
+      "@commitlint/config-conventional"
+    ]
+  },
+  "release-it": {
+    "git": {
+      "commitMessage": "chore: release ${version}",
+      "tagName": "v${version}"
+    },
+    "npm": {
+      "publish": true
+    },
+    "github": {
+      "release": true
+    },
+    "plugins": {
+      "@release-it/conventional-changelog": {
+        "preset": {
+          "name": "angular"
+        }
+      }
+    }
+  },
+  "create-react-native-library": {
+    "type": "nitro-module",
+    "languages": "kotlin-swift",
+    "tools": [
+      "eslint",
+      "jest",
+      "lefthook",
+      "release-it"
+    ],
+    "version": "0.56.0"
+  }
+}

package/src/ReactNativePerfStats.nitro.ts

@@ -0,0 +1,54 @@
+import type { HybridObject } from 'react-native-nitro-modules';
+
+export interface PerfSample {
+  /**
+   * Process CPU usage as a percentage of one core, computed as
+   * `(deltaCpuTime / deltaWallTime) * 100` against the previous sample.
+   * Multi-core saturation can exceed 100. The first sample after process
+   * launch returns `0` because no baseline exists yet.
+   */
+  cpu: number;
+  /** Resident set size in bytes. iOS: phys_footprint; Android: VmRSS. */
+  rss: number;
+  /** Wall-clock timestamp (ms since unix epoch) when the sample was taken. */
+  timestamp: number;
+}
+
+export interface ReactNativePerfStats
+  extends HybridObject<{ ios: 'swift'; android: 'kotlin' }> {
+  /**
+   * Start the singleton native sampler.
+   *
+   * - Runs on a dedicated background thread (Android: HandlerThread;
+   *   iOS: dispatch source on a global queue), so it survives JS-thread
+   *   blockages — the overlay keeps updating even when JS is frozen.
+   * - Idempotent: calling `start` again only updates the interval; it does
+   *   not spawn additional timers.
+   */
+  start(intervalMs: number): void;
+
+  /** Stop the sampler. Also hides the overlay if shown. No-op if not running. */
+  stop(): void;
+
+  /**
+   * Show the floating overlay (CPU + RAM) drawn natively.
+   *
+   * - Android: TextView attached to the current Activity via
+   *   `addContentView` — no floating-window permission required.
+   * - iOS: UILabel added to the key UIWindow.
+   * - Draggable on both platforms.
+   * - Idempotent. If the sampler is not running, the overlay shows "--"
+   *   until `start` is called.
+   */
+  showOverlay(): void;
+
+  /** Hide the floating overlay. The sampler keeps running. No-op if not shown. */
+  hideOverlay(): void;
+
+  /**
+   * Take one CPU+RAM sample without affecting the overlay timer.
+   * Cheap (~1ms) and runs off the JS thread via Promise.async.
+   * Shares the same delta baseline as the overlay sampler.
+   */
+  sample(): Promise<PerfSample>;
+}

package/src/index.tsx

@@ -0,0 +1,8 @@
+import { NitroModules } from 'react-native-nitro-modules';
+import type { ReactNativePerfStats as ReactNativePerfStatsType } from './ReactNativePerfStats.nitro';
+
+const ReactNativePerfStatsHybridObject =
+  NitroModules.createHybridObject<ReactNativePerfStatsType>('ReactNativePerfStats');
+
+export const ReactNativePerfStats = ReactNativePerfStatsHybridObject;
+export type * from './ReactNativePerfStats.nitro';