@dr.pogodin/react-utils 1.16.2 → 1.17.2

package/config/webpack/app-base.js

@@ -42,6 +42,8 @@ const {
  * setting in the Babel config.
  * @param {boolean} [ops.dontEmitBuildInfo] If set the `.build-info` file won't
  * be created at the disk during the compilation.
+ * @param {boolean} [ops.dontUseProgressPlugin] Set to not include progress
+ *  plugin.
  * @param {string|string[]} ops.entry Entry points for "main" chunk. The config
  * will prepend them by some necessary polyfills, e.g.:
  * ([babel-polyfill](https://babeljs.io/docs/usage/polyfill/),
@@ -63,12 +65,14 @@ const {
  * [client-side initialization script](docs/client.md)
  * provided by **@dr.pogodin/react-utils**. Note that `swDest`'s value cannot be
  * overriden by config options provided via `workbox` object.
- * @param {boolean} [ops.keepBuildInfo] If `true` and a `.build-info` file from
- * a previous build exists in the context directory, it will be loaded and
- * used, rather than re-generated by the config factory. It allows to re-create
- * the Webpack config during a server launch without re-generation of the build
- * info file created during a previous build (and thus bundled into the
- * frontend bundle).
+ * @param {boolean|object} [ops.keepBuildInfo] If `true` and a `.build-info`
+ *  file from a previous build exists in the context directory, it will be
+ *  loaded and used, rather than re-generated by the config factory. It allows
+ *  to re-create the Webpack config during a server launch without re-generation
+ *  of the build info file created during a previous build (and thus bundled
+ *  into the frontend bundle). If an object is provided, it will be used as
+ *  the build info, instead of trying to load it from the filesystem. This
+ *  feature is intended for testing context.
  * @param {string} ops.mode
  * [Webpack mode](https://webpack.js.org/concepts/mode/).
  * @param {string} [ops.outputPath=build] Optional. Output path for the build.
@@ -158,29 +162,47 @@ module.exports = function configFactory(ops) {
 
   // TODO: Once all assets are named by hashes, we probably don't need build
   // info anymore beside the key, which can be merged into stats object?
+  // On the other hand, it is still handy to have to pass around the build
+  // timestamp, and any other similar information to the actual app, so it
+  // can be used in some scenarious.
   let buildInfo;
   const buildInfoUrl = path.resolve(o.context, '.build-info');
-  /* If build-info file is found, we reuse those data. */
-  if (!o.dontEmitBuildInfo) {
-    if (fs.existsSync(buildInfoUrl) && o.keepBuildInfo) {
-      buildInfo = JSON.parse(fs.readFileSync(buildInfoUrl));
-    } else {
-      /* Stores misc build info into the local ".build-info" file in the context
-      * directory. */
-      buildInfo = {
-        /* A random 32-bit key, that can be used for encryption. */
-        key: forge.random.getBytesSync(32),
 
-        /* Public path used during build. */
-        publicPath: o.publicPath,
+  if (o.keepBuildInfo) {
+    // If "true" - attempt to load from the filesystem.
+    if (o.keepBuildInfo === true) {
+      if (fs.existsSync(buildInfoUrl)) {
+        buildInfo = JSON.parse(fs.readFileSync(buildInfoUrl));
+      }
+
+    // Otherwise we assume .keepBuildInfo value itself is the build info object
+    // to use in the build.
+    } else buildInfo = o.keepBuildInfo;
+  }
+
+  // Even if "keepBuildInfo" option was provided, we still generate a new
+  // build info object in case nothing could be loaded.
+  if (!buildInfo) {
+    buildInfo = Object.freeze({
+      /* A random 32-bit key, that can be used for encryption. */
+      key: forge.random.getBytesSync(32),
+
+      /* Public path used during build. */
+      publicPath: o.publicPath,
 
-        /* `true` if client-side code should setup a service worker. */
-        useServiceWorker: Boolean(o.workbox),
-      };
-      fs.writeFileSync(buildInfoUrl, JSON.stringify(buildInfo));
-    }
+      /* `true` if client-side code should setup a service worker. */
+      useServiceWorker: Boolean(o.workbox),
+    });
   }
 
+  // If not opted-out, we write the build info to the filesystem. We also attach
+  // it to the factory function itself, so it can be easily accessed right after
+  // the factory call in testing scenarios.
+  if (!o.dontEmitBuildInfo) {
+    fs.writeFileSync(buildInfoUrl, JSON.stringify(buildInfo));
+  }
+  configFactory.buildInfo = buildInfo;
+
   /* Entry points normalization. */
   const entry = [
     'core-js/stable',
@@ -190,12 +212,11 @@ module.exports = function configFactory(ops) {
   ];
 
   const plugins = [
-    new DefinePlugin({
-      BUILD_INFO: JSON.stringify(buildInfo),
-    }),
-    new ProgressPlugin(),
+    new DefinePlugin({ BUILD_INFO: JSON.stringify(buildInfo) }),
   ];
 
+  if (!ops.dontUseProgressPlugin) plugins.push(new ProgressPlugin());
+
   /* Adds InjectManifest plugin from WorkBox, if opted to. */
   if (o.workbox) {
     if (!isObject(o.workbox)) o.workbox = {};

package/config/webpack/app-development.js

@@ -13,17 +13,50 @@ const { merge } = require('webpack-merge');
 
 const baseFactory = require('./app-base');
 
+/**
+ * @param {object} ops
+ * @param {boolean} [ops.dontUseReactGlobalStateDebugging]
+ * @param {boolean} [ops.dontUseHmr]
+ */
 module.exports = function configFactory(ops) {
   const o = defaults(clone(ops), {
     cssLocalIdent: '[package]___[path][name]___[local]___[hash:base64:6]',
   });
 
-  const entry = [
-    '@dr.pogodin/react-utils/build/development/client/init',
-    'webpack-hot-middleware/client?reload=true',
-    ...Array.isArray(o.entry) ? o.entry : [o.entry],
+  const entry = ['@dr.pogodin/react-utils/build/development/client/init'];
+  if (!o.dontUseHmr) entry.push('webpack-hot-middleware/client?reload=true');
+  entry.push(...Array.isArray(o.entry) ? o.entry : [o.entry]);
+
+  const plugins = [
+    new MiniCssExtractPlugin({
+      chunkFilename: '[id].css',
+      filename: '[id].css',
+    }),
+    new webpack.DefinePlugin({
+      'process.env.BABEL_ENV': JSON.stringify('development'),
+      'process.env.DEV_TOOLS': JSON.stringify(true),
+      'process.env.NODE_ENV': JSON.stringify('development'),
+      'process.env.REACT_GLOBAL_STATE_DEBUG':
+        JSON.stringify(!o.dontUseReactGlobalStateDebugging),
+    }),
   ];
 
+  // TODO: There should be no reason to include these plugins when HMR is opted
+  // out, however if I remove them, the compilation fails with obscure
+  // "ReferenceError: $RefreshReg$ is not defined" error. For now it seems
+  // fine to keep these plugins anyway, thus the shortcut of "if" condition
+  // below.
+  if (true || !o.dontUseHmr) {
+    plugins.push(
+      new webpack.HotModuleReplacementPlugin(),
+      new ReactRefreshPlugin({
+        overlay: {
+          sockIntegration: 'whm',
+        },
+      }),
+    );
+  }
+
   const res = merge(baseFactory({
     ...o,
     babelEnv: 'development',
@@ -34,24 +67,7 @@ module.exports = function configFactory(ops) {
       chunkFilename: '[id].js',
       filename: '[id].js',
     },
-    plugins: [
-      new MiniCssExtractPlugin({
-        chunkFilename: '[id].css',
-        filename: '[id].css',
-      }),
-      new webpack.DefinePlugin({
-        'process.env.BABEL_ENV': JSON.stringify('development'),
-        'process.env.DEV_TOOLS': JSON.stringify(true),
-        'process.env.NODE_ENV': JSON.stringify('development'),
-        'process.env.REACT_GLOBAL_STATE_DEBUG': JSON.stringify(true),
-      }),
-      new webpack.HotModuleReplacementPlugin(),
-      new ReactRefreshPlugin({
-        overlay: {
-          sockIntegration: 'whm',
-        },
-      }),
-    ],
+    plugins,
     snapshot: {
       // This enforces Webpack to watch for possible changes in node_modules
       // dependencies, which is a great convenience in library-centric dev
@@ -59,5 +75,7 @@ module.exports = function configFactory(ops) {
       managedPaths: [],
     },
   });
+
+  configFactory.buildInfo = baseFactory.buildInfo;
   return res;
 };

package/config/webpack/app-production.js

@@ -10,6 +10,12 @@ const webpack = require('webpack');
 const { merge } = require('webpack-merge');
 const baseFactory = require('./app-base');
 
+/**
+ * @param {object} ops
+ * @param {string} ops.context Base URL for resolution of relative config paths.
+ * @param {boolean} [ops.dontEmitBuildInfo] If set the `.build-info` file won't
+ * be created at the disk during the compilation.
+ */
 module.exports = function configFactory(ops) {
   const entry = [
     '@dr.pogodin/react-utils/build/production/client/init',
@@ -49,5 +55,7 @@ module.exports = function configFactory(ops) {
       }),
     ],
   });
+
+  configFactory.buildInfo = baseFactory.buildInfo;
   return res;
 };

package/config/webpack/lib-base.js

@@ -13,7 +13,19 @@ const {
   getLocalIdent,
 } = require('@dr.pogodin/babel-plugin-react-css-modules/utils');
 
+/**
+ * @param {object} ops
+ * @param {boolean} [ops.dontUseProgressPlugin] Set to not include progress
+ *  plugin.
+ * @return {object}
+ */
 module.exports = function configFactory(ops) {
+  const plugins = [
+    new MiniCssExtractPlugin({ filename: 'style.css' }),
+  ];
+
+  if (!ops.dontUseProgressPlugin) plugins.push(new ProgressPlugin());
+
   return {
     context: ops.context,
     entry: ops.entry,
@@ -47,12 +59,7 @@ module.exports = function configFactory(ops) {
       path: ops.outputPath,
       libraryTarget: 'umd',
     },
-    plugins: [
-      new MiniCssExtractPlugin({
-        filename: 'style.css',
-      }),
-      new ProgressPlugin(),
-    ],
+    plugins,
     module: {
       rules: [{
         /* Handles font imports in url(..) instructions in CSS. Effectively,

package/package.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.16.2",
+  "version": "1.17.2",
   "bin": {
     "react-utils-build": "bin/build.js",
     "react-utils-setup": "bin/setup.js"
@@ -10,16 +10,16 @@
   "dependencies": {
     "@babel/runtime": "^7.17.9",
     "@dr.pogodin/babel-plugin-react-css-modules": "^6.8.0",
-    "@dr.pogodin/react-global-state": "^0.8.1",
-    "@dr.pogodin/react-themes": "^1.4.2",
-    "axios": "^0.26.1",
+    "@dr.pogodin/react-global-state": "^0.8.3",
+    "@dr.pogodin/react-themes": "^1.4.3",
+    "axios": "^0.27.2",
     "commander": "^9.0.0",
     "compression": "^1.7.4",
     "config": "^3.3.7",
     "cookie-parser": "^1.4.6",
     "cross-env": "^7.0.3",
     "dayjs": "^1.11.1",
-    "express": "^4.17.3",
+    "express": "^4.18.1",
     "helmet": "^5.0.2",
     "http-status-codes": "^2.2.0",
     "joi": "^17.6.0",
@@ -29,8 +29,8 @@
     "prop-types": "^15.8.1",
     "qs": "^6.10.1",
     "raf": "^3.4.1",
-    "react": "^18.0.0",
-    "react-dom": "^18.0.0",
+    "react": "^18.1.0",
+    "react-dom": "^18.1.0",
     "react-helmet": "^6.1.0",
     "react-router-dom": "^6.3.0",
     "request-ip": "^2.1.3",
@@ -43,51 +43,54 @@
   },
   "description": "Collection of generic ReactJS components and utils",
   "devDependencies": {
-    "@babel/cli": "^7.17.6",
-    "@babel/core": "^7.17.9",
+    "@babel/cli": "^7.17.10",
+    "@babel/core": "^7.17.10",
     "@babel/eslint-parser": "^7.17.0",
     "@babel/eslint-plugin": "^7.17.7",
-    "@babel/node": "^7.16.8",
-    "@babel/plugin-transform-runtime": "^7.17.0",
-    "@babel/preset-env": "^7.16.11",
+    "@babel/node": "^7.17.10",
+    "@babel/plugin-transform-runtime": "^7.17.10",
+    "@babel/preset-env": "^7.17.10",
     "@babel/preset-react": "^7.16.7",
+    "@babel/register": "^7.17.7",
     "@dr.pogodin/babel-plugin-transform-assets": "^1.1.1",
     "@dr.pogodin/babel-preset-svgr": "^1.4.0",
     "@pmmmwh/react-refresh-webpack-plugin": "^0.5.5",
-    "autoprefixer": "^10.4.4",
-    "babel-jest": "^27.5.1",
-    "babel-loader": "^8.2.4",
+    "autoprefixer": "^10.4.5",
+    "babel-jest": "^28.0.3",
+    "babel-loader": "^8.2.5",
     "babel-plugin-module-resolver": "^4.1.0",
-    "core-js": "^3.22.0",
+    "core-js": "^3.22.3",
     "css-loader": "^6.7.1",
     "css-minimizer-webpack-plugin": "^3.4.1",
-    "eslint": "^8.13.0",
+    "eslint": "^8.14.0",
     "eslint-config-airbnb": "^19.0.4",
     "eslint-import-resolver-babel-module": "^5.3.1",
     "eslint-plugin-import": "^2.26.0",
-    "eslint-plugin-jest": "^26.1.4",
+    "eslint-plugin-jest": "^26.1.5",
     "eslint-plugin-jsx-a11y": "^6.5.1",
     "eslint-plugin-react": "^7.29.4",
-    "eslint-plugin-react-hooks": "^4.4.0",
+    "eslint-plugin-react-hooks": "^4.5.0",
     "identity-obj-proxy": "^3.0.0",
-    "jest": "^27.5.1",
+    "jest": "^28.0.3",
+    "jest-environment-jsdom": "^28.0.2",
+    "memfs": "^3.4.1",
     "mini-css-extract-plugin": "^2.6.0",
     "mockdate": "^3.0.5",
     "nodelist-foreach-polyfill": "^1.2.0",
-    "postcss": "^8.4.12",
+    "postcss": "^8.4.13",
     "postcss-loader": "^6.2.1",
-    "postcss-scss": "^4.0.3",
+    "postcss-scss": "^4.0.4",
     "pretty": "^2.0.0",
-    "react-refresh": "^0.12.0",
-    "react-test-renderer": "^18.0.0",
+    "react-refresh": "^0.13.0",
+    "react-test-renderer": "^18.1.0",
     "regenerator-runtime": "^0.13.9",
     "resolve-url-loader": "^5.0.0",
-    "sass": "^1.50.0",
+    "sass": "^1.51.0",
     "sass-loader": "^12.6.0",
     "sitemap": "^7.1.1",
-    "stylelint": "^14.7.1",
+    "stylelint": "^14.8.1",
     "stylelint-config-standard-scss": "^3.0.0",
-    "supertest": "^6.2.2",
+    "supertest": "^6.2.3",
     "webpack": "^5.72.0",
     "webpack-dev-middleware": "^5.3.1",
     "webpack-hot-middleware": "^2.25.1",
@@ -124,7 +127,8 @@
       "browser": "./build/production/style.css"
     },
     "./build/development/client/init": "./build/development/client/init.js",
-    "./build/production/client/init": "./build/production/client/init.js"
+    "./build/production/client/init": "./build/production/client/init.js",
+    "./jest-e2e-ssr-env": "./build/production/shared/utils/jest/E2eSsrEnv.js"
   },
   "homepage": "https://dr.pogodin.studio",
   "keywords": [

package/build/development/shared/utils/jest.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../../../src/shared/utils/jest.jsx"],"names":["global","IS_REACT_ACT_ENVIRONMENT","originalProcessVersions","process","versions","mockClientSide","Object","defineProperty","value","unmockClientSide","writable","getMockUuid","seed","x","toString","padStart","slice","mockTimer","time","mockdate","set","Date","now","jest","advanceTimersByTime","mount","scene","root","res","document","createElement","body","appendChild","destroy","unmount","remove","render","component","Renderer","create","toJSON","shallowRender","renderer","ShallowRenderer","getRenderOutput","shallowSnapshot","expect","toMatchSnapshot","snapshot","simulate","TU","Simulate"],"mappings":"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","sourcesContent":["/* global expect, jest, document */\n/* eslint-disable import/no-extraneous-dependencies */\n\nimport mockdate from 'mockdate';\nimport { createRoot } from 'react-dom/client';\nimport TU, { act } from 'react-dom/test-utils';\n\n/* eslint-disable import/no-extraneous-dependencies */\nimport Renderer from 'react-test-renderer';\nimport ShallowRenderer from 'react-test-renderer/shallow';\n/* eslint-enable import/no-extraneous-dependencies */\n\n/**\n * An alias for [act(..)](https://reactjs.org/docs/test-utils.html#act)\n * from `react-dom/test-utils`.\n * @param {function} action\n */\nexport { act };\n\nglobal.IS_REACT_ACT_ENVIRONMENT = true;\n\nconst originalProcessVersions = process.versions;\n\n/**\n * Tricks **react-utils** into thinking the test is running within client-side\n * (browser) environment.\n */\nexport function mockClientSide() {\n  Object.defineProperty(process, 'versions', { value: null });\n}\n\n/**\n * Reverts the effect of {@link module:JU.mockClientSide mockClientSide(..)}.\n */\nexport function unmockClientSide() {\n  Object.defineProperty(process, 'versions', {\n    value: originalProcessVersions,\n    writable: false,\n  });\n}\n\n/**\n * Generates a mock UUID, or better said it determenistically transforms given\n * `seed` number into a UUID-formatted string.\n * @param {number} seed\n * @return {string}\n */\nexport function getMockUuid(seed = 0) {\n  const x = seed.toString(16).padStart(32, '0');\n  return `${x.slice(0, 8)}-${x.slice(8, 12)}-${x.slice(12, 16)}-${x.slice(16, 20)}-${x.slice(20)}`;\n}\n\n/**\n * Advances mock timers, and mock date by the specified time.\n * @param {number} time Time step [ms].\n * @returns {Promise} Wait for this to \"jump after\" any async code which should\n * be executed because of the mock time movement.\n */\nexport async function mockTimer(time) {\n  mockdate.set(time + Date.now());\n  jest.advanceTimersByTime(time);\n}\n\n/**\n * Mounts `scene` to the DOM, and returns the root scene element.\n * @param {React.ReactNode} scene\n * @return {HTMLElement} Created container DOM element with destroy() function\n *  attached.\n */\nexport function mount(scene) {\n  let root;\n  const res = document.createElement('div');\n  document.body.appendChild(res);\n  res.destroy = () => {\n    act(() => root.unmount());\n    res.remove();\n  };\n  act(() => {\n    root = createRoot(res);\n    root.render(scene);\n  });\n  return res;\n}\n\n/* OLD STUFF BELOW THIS MARK */\n\n/**\n * Renders provided ReactJS component into JSON representation of the component\n * tree, using [`react-test-renderer`](https://www.npmjs.com/package/react-test-renderer).\n * @param {object} component ReactJS component to render.\n * @return {object} JSON representation of the rendered tree.\n * @example\n * import { JU } from '@dr.pogodin/react-utils';\n * console.log(JU.render(<div>Example</div>));\n */\nexport function render(component) {\n  return Renderer.create(component).toJSON();\n}\n\n/**\n * Generates a shallow render of given ReactJS component, using\n * [react-test-renderer/shallow](https://reactjs.org/docs/shallow-renderer.html)\n * and returns the result.\n * @param {object} component ReactJS component to render.\n * @return {object} JSON representation of the shallow component's render tree.\n */\nexport function shallowRender(component) {\n  const renderer = new ShallowRenderer();\n  renderer.render(component);\n  return renderer.getRenderOutput();\n}\n\n/**\n * Makes a shallow snapshot test of the given ReactJS component, and also\n * returns JSON representation of the rendered component tree. Under the hood\n * it uses {@link module:JU.shallowRender shallowRender(..)} to generate\n * the render, then executes `expect(RENDER_RESULT).toMatchSnapshot()`,\n * and finally returns the `RENDER_RESULT` to the caller.\n * @param {object} component ReactJS component to render.\n * @return {object} JSON representation of shallow render.\n */\nexport function shallowSnapshot(component) {\n  const res = shallowRender(component);\n  expect(res).toMatchSnapshot();\n  return res;\n}\n\n/**\n * Makes snapshot test of the given ReactJS component, and also returns JSON\n * representation of the rendered component tree. Under the hood, it uses\n * {@link module:JU.render render(..)} to render it, then executes\n * `expect(RENDER_RESULT).toMatchSnapshot()`, and then returns `RENDER_RESULT`.\n * @param {object} component ReactJS component to render.\n * @return {object} JSON render of the component.\n */\nexport function snapshot(component) {\n  const res = render(component);\n  expect(res).toMatchSnapshot();\n  return res;\n}\n\nexport const simulate = TU.Simulate;\n"],"file":"jest.js"}

package/build/production/shared/utils/jest.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../../../src/shared/utils/jest.jsx"],"names":["global","IS_REACT_ACT_ENVIRONMENT","originalProcessVersions","process","versions","mockClientSide","Object","defineProperty","value","unmockClientSide","writable","getMockUuid","seed","x","toString","padStart","slice","mockTimer","time","mockdate","set","Date","now","jest","advanceTimersByTime","mount","scene","root","res","document","createElement","body","appendChild","destroy","unmount","remove","render","component","Renderer","create","toJSON","shallowRender","renderer","ShallowRenderer","getRenderOutput","shallowSnapshot","expect","toMatchSnapshot","snapshot","simulate","TU","Simulate"],"mappings":"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","sourcesContent":["/* global expect, jest, document */\n/* eslint-disable import/no-extraneous-dependencies */\n\nimport mockdate from 'mockdate';\nimport { createRoot } from 'react-dom/client';\nimport TU, { act } from 'react-dom/test-utils';\n\n/* eslint-disable import/no-extraneous-dependencies */\nimport Renderer from 'react-test-renderer';\nimport ShallowRenderer from 'react-test-renderer/shallow';\n/* eslint-enable import/no-extraneous-dependencies */\n\n/**\n * An alias for [act(..)](https://reactjs.org/docs/test-utils.html#act)\n * from `react-dom/test-utils`.\n * @param {function} action\n */\nexport { act };\n\nglobal.IS_REACT_ACT_ENVIRONMENT = true;\n\nconst originalProcessVersions = process.versions;\n\n/**\n * Tricks **react-utils** into thinking the test is running within client-side\n * (browser) environment.\n */\nexport function mockClientSide() {\n  Object.defineProperty(process, 'versions', { value: null });\n}\n\n/**\n * Reverts the effect of {@link module:JU.mockClientSide mockClientSide(..)}.\n */\nexport function unmockClientSide() {\n  Object.defineProperty(process, 'versions', {\n    value: originalProcessVersions,\n    writable: false,\n  });\n}\n\n/**\n * Generates a mock UUID, or better said it determenistically transforms given\n * `seed` number into a UUID-formatted string.\n * @param {number} seed\n * @return {string}\n */\nexport function getMockUuid(seed = 0) {\n  const x = seed.toString(16).padStart(32, '0');\n  return `${x.slice(0, 8)}-${x.slice(8, 12)}-${x.slice(12, 16)}-${x.slice(16, 20)}-${x.slice(20)}`;\n}\n\n/**\n * Advances mock timers, and mock date by the specified time.\n * @param {number} time Time step [ms].\n * @returns {Promise} Wait for this to \"jump after\" any async code which should\n * be executed because of the mock time movement.\n */\nexport async function mockTimer(time) {\n  mockdate.set(time + Date.now());\n  jest.advanceTimersByTime(time);\n}\n\n/**\n * Mounts `scene` to the DOM, and returns the root scene element.\n * @param {React.ReactNode} scene\n * @return {HTMLElement} Created container DOM element with destroy() function\n *  attached.\n */\nexport function mount(scene) {\n  let root;\n  const res = document.createElement('div');\n  document.body.appendChild(res);\n  res.destroy = () => {\n    act(() => root.unmount());\n    res.remove();\n  };\n  act(() => {\n    root = createRoot(res);\n    root.render(scene);\n  });\n  return res;\n}\n\n/* OLD STUFF BELOW THIS MARK */\n\n/**\n * Renders provided ReactJS component into JSON representation of the component\n * tree, using [`react-test-renderer`](https://www.npmjs.com/package/react-test-renderer).\n * @param {object} component ReactJS component to render.\n * @return {object} JSON representation of the rendered tree.\n * @example\n * import { JU } from '@dr.pogodin/react-utils';\n * console.log(JU.render(<div>Example</div>));\n */\nexport function render(component) {\n  return Renderer.create(component).toJSON();\n}\n\n/**\n * Generates a shallow render of given ReactJS component, using\n * [react-test-renderer/shallow](https://reactjs.org/docs/shallow-renderer.html)\n * and returns the result.\n * @param {object} component ReactJS component to render.\n * @return {object} JSON representation of the shallow component's render tree.\n */\nexport function shallowRender(component) {\n  const renderer = new ShallowRenderer();\n  renderer.render(component);\n  return renderer.getRenderOutput();\n}\n\n/**\n * Makes a shallow snapshot test of the given ReactJS component, and also\n * returns JSON representation of the rendered component tree. Under the hood\n * it uses {@link module:JU.shallowRender shallowRender(..)} to generate\n * the render, then executes `expect(RENDER_RESULT).toMatchSnapshot()`,\n * and finally returns the `RENDER_RESULT` to the caller.\n * @param {object} component ReactJS component to render.\n * @return {object} JSON representation of shallow render.\n */\nexport function shallowSnapshot(component) {\n  const res = shallowRender(component);\n  expect(res).toMatchSnapshot();\n  return res;\n}\n\n/**\n * Makes snapshot test of the given ReactJS component, and also returns JSON\n * representation of the rendered component tree. Under the hood, it uses\n * {@link module:JU.render render(..)} to render it, then executes\n * `expect(RENDER_RESULT).toMatchSnapshot()`, and then returns `RENDER_RESULT`.\n * @param {object} component ReactJS component to render.\n * @return {object} JSON render of the component.\n */\nexport function snapshot(component) {\n  const res = render(component);\n  expect(res).toMatchSnapshot();\n  return res;\n}\n\nexport const simulate = TU.Simulate;\n"],"file":"jest.js"}