feat: pre-v1 updates backport

.changeset/chatty-paws-turn.md

@@ -0,0 +1,7 @@
+---
+'@callstack/reassure-measure': minor
+'reassure': minor
+'test-app-native': minor
+---
+
+- Add `writeFile` option to `measureRenders`/`measureFunction`.

.changeset/many-cups-protect.md

@@ -0,0 +1,8 @@
+---
+'@callstack/reassure-logger': minor
+'@callstack/reassure-compare': patch
+'@callstack/reassure-measure': patch
+'@callstack/reassure-cli': patch
+---
+
+refactor: simplify `reassure-logger` package exports

.eslintignore

@@ -1,3 +1,3 @@
 docusaurus/build/**
-**/*.js
 packages/**/lib/**
+dangerfile.ts

.eslintrc.js

@@ -1,7 +1,15 @@
 module.exports = {
-  extends: '@callstack/eslint-config',
+  extends: '@callstack/eslint-config/node',
   rules: {
     'require-await': 'error',
   },
   ignorePatterns: ['docusaurus/**'],
+  overrides: [
+    {
+      files: ['*.ts', '*.tsx'],
+      parserOptions: {
+        project: './packages/**/tsconfig.json',
+      },
+    },
+  ],
 };

README.md

@@ -373,13 +373,15 @@ interface MeasureOptions {
   warmupRuns?: number;
   wrapper?: React.ComponentType<{ children: ReactElement }>;
   scenario?: (view?: RenderResult) => Promise<any>;
+  writeFile?: boolean;
 }
 ```
 
 - **`runs`**: number of runs per series for the particular test
 - **`warmupRuns`**: number of additional warmup runs that will be done and discarded before the actual runs (default 1).
 - **`wrapper`**: React component, such as a `Provider`, which the `ui` will be wrapped with. Note: the render duration of the `wrapper` itself is excluded from the results; only the wrapped component is measured.
 - **`scenario`**: a custom async function, which defines user interaction within the UI by utilising RNTL or RTL functions
+- **`writeFile`**: (default `true`) should write output to file.
 
 #### `measureFunction` function
 
@@ -435,10 +437,11 @@ const defaultConfig: Config = {
 ```
 
 **`runs`**: the number of repeated runs in a series per test (allows for higher accuracy by aggregating more data). Should be handled with care.
+
 - **`warmupRuns`**: the number of additional warmup runs that will be done and discarded before the actual runs.
-**`outputFile`**: the name of the file the records will be saved to
-**`verbose`**: make Reassure log more, e.g. for debugging purposes
-**`testingLibrary`**: where to look for `render` and `cleanup` functions, supported values `'react-native'`, `'react'` or object providing custom `render` and `cleanup` functions
+  **`outputFile`**: the name of the file the records will be saved to
+  **`verbose`**: make Reassure log more, e.g. for debugging purposes
+  **`testingLibrary`**: where to look for `render` and `cleanup` functions, supported values `'react-native'`, `'react'` or object providing custom `render` and `cleanup` functions
 
 #### `configure` function
 

docusaurus/docs/api.md

@@ -7,11 +7,17 @@ sidebar_position: 4
 
 ## Measurements
 
-### `measurePerformance` function
+### `measurePerformance()` function {#measure-renders}
 
-Custom wrapper for the RNTL `render` function responsible for rendering the passed screen inside a `React.Profiler` component,
+:::info
+
+Prior to version 1.0, this function has been named `measurePerformance`.
+
+:::
+
+Custom wrapper for the RNTL/RTL's `render` function responsible for rendering the passed screen inside a `React.Profiler` component,
 measuring its performance and writing results to the output file. You can use optional `options` object allows customizing aspects
-of the testing
+of the testing.
 
 ```ts
 async function measurePerformance(
@@ -20,7 +26,7 @@ async function measurePerformance(
 ): Promise<MeasureResults> {
 ```
 
-#### Example
+#### Example {#measure-renders-example}
 
 ```ts
 // sample.perf-test.tsx
@@ -38,23 +44,25 @@ test('Test with scenario', async () => {
 });
 ```
 
-### `MeasureOptions` type
+### `MeasureOptions` type {#measure-renders-options}
 
 ```ts
 interface MeasureOptions {
   runs?: number;
   warmupRuns?: number;
   wrapper?: React.ComponentType<{ children: ReactElement }>;
   scenario?: (view?: RenderResult) => Promise<any>;
+  writeFile?: boolean;
 }
 ```
 
 - **`runs`**: number of runs per series for the particular test
 - **`warmupRuns`**: number of additional warmup runs that will be done and discarded before the actual runs.
 - **`wrapper`**: React component, such as a `Provider`, which the `ui` will be wrapped with. Note: the render duration of the `wrapper` itself is excluded from the results, only the wrapped component is measured.
 - **`scenario`**: a custom async function, which defines user interaction within the ui by utilized RNTL functions
+- **`writeFile`**: (default `true`) should write output to file.
 
-### `measureFunction` function
+### `measureFunction` function {#measure-function}
 
 Allows you to wrap any synchronous function, measure its performance and write results to the output file. You can use optional `options` to customize aspects of the testing.
 
@@ -65,7 +73,7 @@ async function measureFunction(
 ): Promise<MeasureResults> {
 ```
 
-#### Example
+#### Example {#measure-function-example}
 
 ```ts
 // sample.perf-test.tsx
@@ -77,17 +85,19 @@ test('fib 30', async () => {
 });
 ```
 
-### `MeasureFunctionOptions` type
+### `MeasureFunctionOptions` type {#measure-function-options}
 
 ```ts
 interface MeasureFunctionOptions {
   runs?: number;
   warmupRuns?: number;
+  writeFile?: boolean;
 }
 ```
 
 - **`runs`**: number of runs per series for the particular test
 - **`warmupRuns`**: number of additional warmup runs that will be done and discarded before the actual runs.
+- **`writeFile`**: (default `true`) should write output to file.
 
 ## Configuration
 
@@ -133,7 +143,7 @@ function configure(customConfig: Partial<Config>): void;
 
 You can use the `configure` function to override the default config parameters.
 
-#### Example
+#### Example {#configure-example}
 
 ```ts
 import { configure } from 'reassure';
@@ -144,7 +154,7 @@ configure({
 });
 ```
 
-### `resetToDefault` function
+### `resetToDefault` function {#reset-to-defaults}
 
 ```ts
 resetToDefault(): void

docusaurus/docs/installation.md

@@ -95,6 +95,7 @@ If your test contains any async changes, you will need to make sure that the sce
 `findBy` queries, `waitFor` or `waitForElementToBeRemoved` functions from RNTL.
 
 For more examples look into our example apps:
+
 - [React Native (CLI)](https://github.com/callstack/reassure-examples/tree/main/examples/native)
 - [React Native (Expo)](https://github.com/callstack/reassure-examples/tree/main/examples/native-expo)
 - [React (Next.js)](https://github.com/callstack/reassure-examples/tree/main/examples/web-nextjs)

package.json

@@ -34,31 +34,31 @@
   },
   "homepage": "https://github.com/callstack/reassure#readme",
   "devDependencies": {
-    "@babel/core": "^7.20.12",
-    "@babel/plugin-transform-flow-strip-types": "^7.19.0",
-    "@babel/preset-typescript": "^7.20.7",
-    "@babel/runtime": "^7.20.7",
-    "@callstack/eslint-config": "^13.0.2",
+    "@babel/core": "^7.23.7",
+    "@babel/plugin-transform-flow-strip-types": "^7.23.3",
+    "@babel/preset-env": "^7.23.7",
+    "@babel/preset-typescript": "^7.23.3",
+    "@babel/runtime": "^7.23.7",
+    "@callstack/eslint-config": "^14.1.0",
     "@changesets/cli": "^2.26.0",
-    "@testing-library/react": "^14.0.0",
-    "@testing-library/react-native": "^12.0.0",
-    "@types/jest": "^29.2.5",
-    "@types/react": "^18.0.26",
-    "@types/react-native": "0.71.3",
-    "babel-jest": "^29.3.1",
-    "danger": "^11.2.3",
-    "eslint": "^8.32.0",
-    "eslint-config-prettier": "^8.6.0",
+    "@relmify/jest-serializer-strip-ansi": "^1.0.2",
+    "@testing-library/react": "^14.1.2",
+    "@testing-library/react-native": "^12.4.3",
+    "@types/jest": "^29.5.11",
+    "@types/react": "^18.2.46",
+    "babel-jest": "^29.7.0",
+    "danger": "^11.3.1",
+    "eslint": "^8.56.0",
+    "eslint-config-prettier": "^8.10.0",
     "eslint-plugin-prettier": "^4.2.1",
-    "jest": "^29.3.1",
-    "pod-install": "^0.1.38",
-    "prettier": "^2.8.3",
+    "jest": "^29.7.0",
+    "prettier": "^2.8.8",
     "react": "18.2.0",
     "react-dom": "18.2.0",
-    "react-native": "0.72.5",
+    "react-native": "0.73.1",
     "react-native-builder-bob": "^0.20.3",
     "react-test-renderer": "18.2.0",
-    "turbo": "^1.6.3",
+    "turbo": "^1.11.3",
     "typescript": "^5.2.2"
   },
   "peerDependencies": {

packages/reassure-cli/package.json → packages/cli/package.json

@@ -52,7 +52,13 @@
     "output": "lib",
     "targets": [
       "commonjs",
-      "module"
+      "module",
+      [
+        "typescript",
+        {
+          "project": "tsconfig.build.json"
+        }
+      ]
     ]
   },
   "publishConfig": {

packages/reassure-cli/src/bin.ts → packages/cli/src/bin.ts

@@ -5,7 +5,7 @@ import { command as init } from './commands/init';
 import { command as checkStability } from './commands/check-stability';
 import { command as measure } from './commands/measure';
 
-yargs(hideBin(process.argv))
+void yargs(hideBin(process.argv))
   .command(measure)
   .command(init)
   .command(checkStability)

packages/reassure-cli/src/commands/init.ts → packages/cli/src/commands/init.ts

@@ -1,6 +1,6 @@
 import { copyFileSync, existsSync, readFileSync, appendFileSync } from 'node:fs';
 import * as path from 'node:path';
-import { logger } from '@callstack/reassure-logger';
+import * as logger from '@callstack/reassure-logger';
 import type { CommandModule } from 'yargs';
 import {
   CI_SCRIPT,

packages/reassure-cli/src/commands/measure.ts → packages/cli/src/commands/measure.ts

@@ -4,7 +4,7 @@ import { spawnSync } from 'node:child_process';
 import type { CommandModule } from 'yargs';
 import { compare, formatMetadata } from '@callstack/reassure-compare';
 import type { PerformanceMetadata } from '@callstack/reassure-compare';
-import { logger } from '@callstack/reassure-logger';
+import * as logger from '@callstack/reassure-logger';
 import { RESULTS_DIRECTORY, RESULTS_FILE, BASELINE_FILE } from '../constants';
 import { applyCommonOptions, CommonOptions } from '../options';
 import { getGitBranch, getGitCommitHash } from '../utils/git';
@@ -87,7 +87,7 @@ export async function run(options: MeasureOptions) {
     },
   });
 
-  logger.log();
+  logger.newLine();
 
   if (spawnInfo.status !== 0) {
     logger.error(`❌  Test runner (${testRunnerPath}) exited with error code ${spawnInfo.status}`);
@@ -110,7 +110,7 @@ export async function run(options: MeasureOptions) {
 
   if (options.compare) {
     if (existsSync(BASELINE_FILE)) {
-      compare();
+      await compare();
     } else {
       logger.log(
         `Baseline performance file does not exist, run 'reassure --baseline' on your baseline code branch to create it.\n`

packages/reassure-cli/src/utils/git.ts → packages/cli/src/utils/git.ts

@@ -1,5 +1,5 @@
 import simpleGit from 'simple-git';
-import { logger } from '@callstack/reassure-logger';
+import * as logger from '@callstack/reassure-logger';
 
 export async function getGitBranch() {
   try {

packages/reassure-cli/src/utils/logger.ts → packages/cli/src/utils/logger.ts

@@ -1,8 +1,8 @@
-import { logger } from '@callstack/reassure-logger';
+import { configure } from '@callstack/reassure-logger';
 import type { CommonOptions } from '../options';
 
 export function configureLoggerOptions(options: CommonOptions) {
-  logger.configure({
+  configure({
     silent: options.silent,
     verbose: options.verbose,
   });

packages/cli/tsconfig.build.json

@@ -0,0 +1,5 @@
+{
+  "extends": "./tsconfig",
+  "include": ["src/**/*"],
+  "exclude": ["**/__tests__/**"]
+}

packages/reassure-compare/tsconfig.json → packages/cli/tsconfig.json

@@ -21,7 +21,5 @@
     "skipLibCheck": true,
     "strict": true,
     "target": "esnext"
-  },
-  "include": ["src/**/*"],
-  "exclude": ["**/__tests__/**"]
+  }
 }

packages/reassure-compare/jest.config.js → packages/compare/jest.config.js

@@ -1,5 +1,7 @@
 module.exports = {
   preset: '@testing-library/react-native',
   transformIgnorePatterns: ['node_modules/(?!(jest-)?@?react-native|@react-native-community|@react-navigation)'],
+  modulePathIgnorePatterns: ['<rootDir>/lib/'],
+  snapshotSerializers: ['@relmify/jest-serializer-strip-ansi/always'],
   clearMocks: true,
 };

packages/reassure-compare/package.json → packages/compare/package.json

@@ -47,7 +47,12 @@
     "targets": [
       "commonjs",
       "module",
-      "typescript"
+      [
+        "typescript",
+        {
+          "project": "tsconfig.build.json"
+        }
+      ]
     ]
   },
   "publishConfig": {

packages/reassure-compare/src/compare.ts → packages/compare/src/compare.ts

@@ -46,7 +46,7 @@ type CompareOptions = {
  *
  * Responsible for loading baseline and current performance results and outputting data in various formats.
  */
-export function compare({
+export async function compare({
   baselineFile = '.reassure/baseline.perf',
   currentFile = '.reassure/current.perf',
   outputFile = '.reassure/output.json',
@@ -88,10 +88,10 @@ export function compare({
     printToConsole(output);
   }
   if (outputFormat === 'json' || outputFormat === 'all') {
-    writeToJson(outputFile, output);
+    await writeToJson(outputFile, output);
   }
   if (outputFormat === 'markdown' || outputFormat === 'all') {
-    writeToMarkdown('.reassure/output.md', output);
+    await writeToMarkdown('.reassure/output.md', output);
   }
 }
 

packages/reassure-compare/src/output/console.ts → packages/compare/src/output/console.ts

@@ -1,4 +1,4 @@
-import { logger } from '@callstack/reassure-logger';
+import * as logger from '@callstack/reassure-logger';
 import type { AddedEntry, CompareResult, CompareEntry, RemovedEntry } from '../types';
 import { formatCount, formatDuration, formatMetadata, formatCountChange, formatDurationChange } from '../utils/format';
 import type { PerformanceMetadata } from '../types';
@@ -25,7 +25,7 @@ export function printToConsole(data: CompareResult) {
   logger.log('\n➡️  Removed scenarios');
   data.removed.forEach(printRemovedLine);
 
-  logger.log();
+  logger.newLine();
 }
 
 function printMetadata(name: string, metadata?: PerformanceMetadata) {