@dr.pogodin/react-utils 1.15.7 → 1.16.2

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

@@ -11,28 +11,20 @@ Object.defineProperty(exports, "act", {
     return _testUtils.act;
   }
 });
-exports.findInDomByClass = findInDomByClass;
-exports.findInDomManyByClass = findInDomManyByClass;
 exports.getMockUuid = getMockUuid;
 exports.mockClientSide = mockClientSide;
 exports.mockTimer = mockTimer;
 exports.mount = mount;
 exports.render = render;
-exports.renderDom = renderDom;
 exports.shallowRender = shallowRender;
 exports.shallowSnapshot = shallowSnapshot;
 exports.simulate = void 0;
 exports.snapshot = snapshot;
 exports.unmockClientSide = unmockClientSide;
-exports.unmount = unmount;
-
-var _react = require("react");
 
 var _mockdate = _interopRequireDefault(require("mockdate"));
 
-var _propTypes = _interopRequireDefault(require("prop-types"));
-
-var _reactDom = require("react-dom");
+var _client = require("react-dom/client");
 
 var _testUtils = _interopRequireWildcard(require("react-dom/test-utils"));
 
@@ -40,8 +32,6 @@ var _reactTestRenderer = _interopRequireDefault(require("react-test-renderer"));
 
 var _shallow = _interopRequireDefault(require("react-test-renderer/shallow"));
 
-var _jsxRuntime = require("react/jsx-runtime");
-
 function _getRequireWildcardCache(nodeInterop) { if (typeof WeakMap !== "function") return null; var cacheBabelInterop = new WeakMap(); var cacheNodeInterop = new WeakMap(); return (_getRequireWildcardCache = function (nodeInterop) { return nodeInterop ? cacheNodeInterop : cacheBabelInterop; })(nodeInterop); }
 
 function _interopRequireWildcard(obj, nodeInterop) { if (!nodeInterop && obj && obj.__esModule) { return obj; } if (obj === null || typeof obj !== "object" && typeof obj !== "function") { return { default: obj }; } var cache = _getRequireWildcardCache(nodeInterop); if (cache && cache.has(obj)) { return cache.get(obj); } var newObj = {}; var hasPropertyDescriptor = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var key in obj) { if (key !== "default" && Object.prototype.hasOwnProperty.call(obj, key)) { var desc = hasPropertyDescriptor ? Object.getOwnPropertyDescriptor(obj, key) : null; if (desc && (desc.get || desc.set)) { Object.defineProperty(newObj, key, desc); } else { newObj[key] = obj[key]; } } } newObj.default = obj; if (cache) { cache.set(obj, newObj); } return newObj; }
@@ -59,6 +49,7 @@ function _interopRequireWildcard(obj, nodeInterop) { if (!nodeInterop && obj &&
  * from `react-dom/test-utils`.
  * @param {function} action
  */
+global.IS_REACT_ACT_ENVIRONMENT = true;
 const originalProcessVersions = process.versions;
 /**
  * Tricks **react-utils** into thinking the test is running within client-side
@@ -109,52 +100,29 @@ async function mockTimer(time) {
 /**
  * Mounts `scene` to the DOM, and returns the root scene element.
  * @param {React.ReactNode} scene
- * @return {HTMLElement}
+ * @return {HTMLElement} Created container DOM element with destroy() function
+ *  attached.
  */
 
 
 function mount(scene) {
+  let root;
   const res = document.createElement('div');
   document.body.appendChild(res);
-  (0, _reactDom.render)(scene, res);
-  return res;
-}
-/**
- * Unmounts `scene` from the DOM.
- * @param {HTMLElement} scene
- */
 
+  res.destroy = () => {
+    (0, _testUtils.act)(() => root.unmount());
+    res.remove();
+  };
 
-function unmount(scene) {
-  (0, _reactDom.unmountComponentAtNode)(scene);
-  scene.remove();
+  (0, _testUtils.act)(() => {
+    root = (0, _client.createRoot)(res);
+    root.render(scene);
+  });
+  return res;
 }
 /* OLD STUFF BELOW THIS MARK */
 
-/**
- * Just an alias for
- * [findRenderedDOMComponentWithClass(..)](https://reactjs.org/docs/test-utils.html#findrendereddomcomponentwithclass).
- * @param {object} dom
- * @param {string} className
- * @return {object}
- */
-
-
-function findInDomByClass(dom, className) {
-  return _testUtils.default.findRenderedDOMComponentWithClass(dom, className);
-}
-/**
- * Just an alias for
- * [scryRenderedDOMComponentsWithClass(..)](https://reactjs.org/docs/test-utils.html#scryrendereddomcomponentswithclass).
- * @param {object} dom
- * @param {stirng} className
- * @return {array}
- */
-
-
-function findInDomManyByClass(dom, className) {
-  return _testUtils.default.scryRenderedDOMComponentsWithClass(dom, className);
-}
 /**
  * Renders provided ReactJS component into JSON representation of the component
  * tree, using [`react-test-renderer`](https://www.npmjs.com/package/react-test-renderer).
@@ -168,37 +136,6 @@ function findInDomManyByClass(dom, className) {
 
 function render(component) {
   return _reactTestRenderer.default.create(component).toJSON();
-} // The Wrapper is necessary for the "renderDom(..)" function, because
-// the "renderIntoDocument(..)" function from "react-dom/test-utils" works
-// only with state components, so we have to wrap our ReactJS components into
-// such Wrapper.
-
-
-class Wrapper extends _react.Component {
-  componentDidMount() {}
-
-  render() {
-    const {
-      children
-    } = this.props;
-    return children;
-  }
-
-}
-
-Wrapper.propTypes = {
-  children: _propTypes.default.node.isRequired
-};
-/**
- * Renders given ReactJS component into DOM, using `react-dom/test-utils`.
- * @param {object} component ReactJS component to render.
- * @return {object} Rendered DOM.
- */
-
-function renderDom(component) {
-  return _testUtils.default.renderIntoDocument( /*#__PURE__*/(0, _jsxRuntime.jsx)(Wrapper, {
-    children: component
-  }));
 }
 /**
  * Generates a shallow render of given ReactJS component, using

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

@@ -1 +1 @@
-{"version":3,"sources":["../../../../src/shared/utils/jest.jsx"],"names":["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","res","document","createElement","body","appendChild","unmount","remove","findInDomByClass","dom","className","TU","findRenderedDOMComponentWithClass","findInDomManyByClass","scryRenderedDOMComponentsWithClass","render","component","Renderer","create","toJSON","Wrapper","Component","componentDidMount","children","props","propTypes","PT","node","isRequired","renderDom","renderIntoDocument","shallowRender","renderer","ShallowRenderer","getRenderOutput","shallowSnapshot","expect","toMatchSnapshot","snapshot","simulate","Simulate"],"mappings":"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","sourcesContent":["/* global expect, jest, document */\n/* eslint-disable import/no-extraneous-dependencies */\n\nimport { Component } from 'react';\n\nimport mockdate from 'mockdate';\nimport PT from 'prop-types';\nimport { render as newRender, unmountComponentAtNode } from 'react-dom';\nimport TU 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 } from 'react-dom/test-utils';\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}\n */\nexport function mount(scene) {\n  const res = document.createElement('div');\n  document.body.appendChild(res);\n  newRender(scene, res);\n  return res;\n}\n\n/**\n * Unmounts `scene` from the DOM.\n * @param {HTMLElement} scene\n */\nexport function unmount(scene) {\n  unmountComponentAtNode(scene);\n  scene.remove();\n}\n\n/* OLD STUFF BELOW THIS MARK */\n\n/**\n * Just an alias for\n * [findRenderedDOMComponentWithClass(..)](https://reactjs.org/docs/test-utils.html#findrendereddomcomponentwithclass).\n * @param {object} dom\n * @param {string} className\n * @return {object}\n */\nexport function findInDomByClass(dom, className) {\n  return TU.findRenderedDOMComponentWithClass(dom, className);\n}\n\n/**\n * Just an alias for\n * [scryRenderedDOMComponentsWithClass(..)](https://reactjs.org/docs/test-utils.html#scryrendereddomcomponentswithclass).\n * @param {object} dom\n * @param {stirng} className\n * @return {array}\n */\nexport function findInDomManyByClass(dom, className) {\n  return TU.scryRenderedDOMComponentsWithClass(dom, className);\n}\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// The Wrapper is necessary for the \"renderDom(..)\" function, because\n// the \"renderIntoDocument(..)\" function from \"react-dom/test-utils\" works\n// only with state components, so we have to wrap our ReactJS components into\n// such Wrapper.\nclass Wrapper extends Component {\n  componentDidMount() {}\n\n  render() {\n    const { children } = this.props;\n    return children;\n  }\n}\n\nWrapper.propTypes = {\n  children: PT.node.isRequired,\n};\n\n/**\n * Renders given ReactJS component into DOM, using `react-dom/test-utils`.\n * @param {object} component ReactJS component to render.\n * @return {object} Rendered DOM.\n */\nexport function renderDom(component) {\n  return TU.renderIntoDocument((\n    <Wrapper>\n      {component}\n    </Wrapper>\n  ));\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"}
+{"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/development/shared/utils/splitComponent.js

@@ -11,6 +11,8 @@ var _react = require("react");
 
 var _CodeSplit = _interopRequireDefault(require("../components/CodeSplit"));
 
+/* eslint-disable react/jsx-props-no-spreading */
+
 /**
  * Wraps a regular React component into a "code splitting" component,
  * i.e. all code used exclusively by that component and its sub-tree
@@ -18,26 +20,23 @@ var _CodeSplit = _interopRequireDefault(require("../components/CodeSplit"));
  * the client-side.
  * @param {object} options
  * @param {string} options.chunkName
- * @param {function} options.getClientSide
- * @param {React.ElementType} [options.placeholder]
- * @param {React.ElementType} [options.serverSide]
- * @returns {React.ElementType}
+ * @param {function} options.getComponent
+ * @param {React.Element} [options.placeholder]
+ * @return {React.ElementType}
  */
 function splitComponent({
   chunkName,
-  getClientSide,
-  placeholder,
-  serverSide
+  getComponent,
+  placeholder
 }) {
   // eslint-disable-next-line react/prop-types
   return ({
-    children = [],
+    children,
     ...props
-  } = {}) => /*#__PURE__*/(0, _react.createElement)(_CodeSplit.default, { ...props,
+  }) => /*#__PURE__*/(0, _react.createElement)(_CodeSplit.default, { ...props,
     chunkName,
-    getClientSide,
-    placeholder,
-    serverSide
-  }, ...children);
+    getComponent,
+    placeholder
+  }, children);
 }
 //# sourceMappingURL=splitComponent.js.map

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

@@ -1 +1 @@
-{"version":3,"sources":["../../../../src/shared/utils/splitComponent.js"],"names":["splitComponent","chunkName","getClientSide","placeholder","serverSide","children","props","CodeSplit"],"mappings":";;;;;;;;;AAAA;;AACA;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACe,SAASA,cAAT,CAAwB;AACrCC,EAAAA,SADqC;AAErCC,EAAAA,aAFqC;AAGrCC,EAAAA,WAHqC;AAIrCC,EAAAA;AAJqC,CAAxB,EAKZ;AACD;AACA,SAAO,CAAC;AAAEC,IAAAA,QAAQ,GAAG,EAAb;AAAiB,OAAGC;AAApB,MAA8B,EAA/B,kBAAsC,0BAC3CC,kBAD2C,EAE3C,EACE,GAAGD,KADL;AAEEL,IAAAA,SAFF;AAGEC,IAAAA,aAHF;AAIEC,IAAAA,WAJF;AAKEC,IAAAA;AALF,GAF2C,EAS3C,GAAGC,QATwC,CAA7C;AAWD","sourcesContent":["import { createElement } from 'react';\nimport CodeSplit from 'components/CodeSplit';\n\n/**\n * Wraps a regular React component into a \"code splitting\" component,\n * i.e. all code used exclusively by that component and its sub-tree\n * will go into a separate, asynchronously loaded, code chunk for\n * the client-side.\n * @param {object} options\n * @param {string} options.chunkName\n * @param {function} options.getClientSide\n * @param {React.ElementType} [options.placeholder]\n * @param {React.ElementType} [options.serverSide]\n * @returns {React.ElementType}\n */\nexport default function splitComponent({\n  chunkName,\n  getClientSide,\n  placeholder,\n  serverSide,\n}) {\n  // eslint-disable-next-line react/prop-types\n  return ({ children = [], ...props } = {}) => createElement(\n    CodeSplit,\n    {\n      ...props,\n      chunkName,\n      getClientSide,\n      placeholder,\n      serverSide,\n    },\n    ...children,\n  );\n}\n"],"file":"splitComponent.js"}
+{"version":3,"sources":["../../../../src/shared/utils/splitComponent.js"],"names":["splitComponent","chunkName","getComponent","placeholder","children","props","CodeSplit"],"mappings":";;;;;;;;;AAEA;;AAEA;;AAJA;;AAMA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACe,SAASA,cAAT,CAAwB;AACrCC,EAAAA,SADqC;AAErCC,EAAAA,YAFqC;AAGrCC,EAAAA;AAHqC,CAAxB,EAIZ;AACD;AACA,SAAO,CAAC;AAAEC,IAAAA,QAAF;AAAY,OAAGC;AAAf,GAAD,kBAA4B,0BACjCC,kBADiC,EAEjC,EACE,GAAGD,KADL;AAEEJ,IAAAA,SAFF;AAGEC,IAAAA,YAHF;AAIEC,IAAAA;AAJF,GAFiC,EAQjCC,QARiC,CAAnC;AAUD","sourcesContent":["/* eslint-disable react/jsx-props-no-spreading */\n\nimport { createElement } from 'react';\n\nimport CodeSplit from 'components/CodeSplit';\n\n/**\n * Wraps a regular React component into a \"code splitting\" component,\n * i.e. all code used exclusively by that component and its sub-tree\n * will go into a separate, asynchronously loaded, code chunk for\n * the client-side.\n * @param {object} options\n * @param {string} options.chunkName\n * @param {function} options.getComponent\n * @param {React.Element} [options.placeholder]\n * @return {React.ElementType}\n */\nexport default function splitComponent({\n  chunkName,\n  getComponent,\n  placeholder,\n}) {\n  // eslint-disable-next-line react/prop-types\n  return ({ children, ...props }) => createElement(\n    CodeSplit,\n    {\n      ...props,\n      chunkName,\n      getComponent,\n      placeholder,\n    },\n    children,\n  );\n}\n"],"file":"splitComponent.js"}

package/build/development/shared/utils/time.js

@@ -9,18 +9,7 @@ exports.default = void 0;
 
 var _dayjs = _interopRequireDefault(require("dayjs"));
 
-/**
- * @category Utilities
- * @module time
- * @desc
- * ```js
- * import { time } from '@dr.pogodin/react-utils';
- * ```
- * Date & time utilities. The `time` export is a convenient alias for
- * [dayjs](https://day.js.org/en/) library, _i.e._ you can use `time`
- * in all ways you would use `dayjs`. It is further extended with
- * the following additional members.
- */
+var _Barrier = require("./Barrier");
 
 /**
  * @static
@@ -84,20 +73,20 @@ _dayjs.default.YEAR_MS = 365 * _dayjs.default.DAY_MS;
 
 _dayjs.default.now = Date.now;
 /**
- * @static
- * @func timer
- * @desc Creates a Promise, which resolves after the given timeout.
+ * Creates a Promise, which resolves after the given timeout.
  * @param {number} timeout Timeout [ms].
- * @return {Promise} Resolves after the timeout.
- * @example
- * import { time } from '@dr.pogodin/react-utils';
- * time.timer(5000).then(() => console.log('5 seconds have passed'))
+ * @return {Barrier} Resolves after the timeout. It has additional
+ *  .abort() method attached, which cancels the pending timer resolution
+ *  (without resolving or rejecting the barrier).
  */
 
 _dayjs.default.timer = async function timer(timeout) {
-  return new Promise(resolve => {
-    setTimeout(resolve, timeout);
-  });
+  const res = new _Barrier.Barrier();
+  const id = setTimeout(res.resolve.bind(res), timeout);
+
+  res.abort = () => clearTimeout(id);
+
+  return res;
 };
 
 var _default = _dayjs.default;

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

@@ -1 +1 @@
-{"version":3,"sources":["../../../../src/shared/utils/time.js"],"names":["dayjs","SEC_MS","MIN_MS","HOUR_MS","DAY_MS","YEAR_MS","now","Date","timer","timeout","Promise","resolve","setTimeout"],"mappings":";;;;;;;;;AAaA;;AAbA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAIA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACAA,eAAMC,MAAN,GAAe,IAAf;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AACAD,eAAME,MAAN,GAAe,KAAKF,eAAMC,MAA1B;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AACAD,eAAMG,OAAN,GAAgB,KAAKH,eAAME,MAA3B;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AACAF,eAAMI,MAAN,GAAe,KAAKJ,eAAMG,OAA1B;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AACAH,eAAMK,OAAN,GAAgB,MAAML,eAAMI,MAA5B;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AACAJ,eAAMM,GAAN,GAAYC,IAAI,CAACD,GAAjB;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AACAN,eAAMQ,KAAN,GAAc,eAAeA,KAAf,CAAqBC,OAArB,EAA8B;AAC1C,SAAO,IAAIC,OAAJ,CAAaC,OAAD,IAAa;AAC9BC,IAAAA,UAAU,CAACD,OAAD,EAAUF,OAAV,CAAV;AACD,GAFM,CAAP;AAGD,CAJD;;eAMeT,c","sourcesContent":["/**\n * @category Utilities\n * @module time\n * @desc\n * ```js\n * import { time } from '@dr.pogodin/react-utils';\n * ```\n * Date & time utilities. The `time` export is a convenient alias for\n * [dayjs](https://day.js.org/en/) library, _i.e._ you can use `time`\n * in all ways you would use `dayjs`. It is further extended with\n * the following additional members.\n */\n\nimport dayjs from 'dayjs';\n\n/**\n * @static\n * @const SEC_MS\n * @desc One second, expressed in milliseconds (equals 1000 ms).\n * @example\n * import { time } from '@dr.pogodin/react-utils';\n * console.log(time.SEC_MS); // Prints: 1000\n */\ndayjs.SEC_MS = 1000;\n\n/**\n * @static\n * @const MIN_MS\n * @desc One minute, expressed in milliseconds (equals 60 × `SEC_MS`).\n * @example\n * import { time } from '@dr.pogodin/react-utils';\n * console.log(time.MIN_MS); // Prints: 60000\n */\ndayjs.MIN_MS = 60 * dayjs.SEC_MS;\n\n/**\n * @static\n * @const HOUR_MS\n * @desc One hour, expressed in milliseconds (equals 60 × `MIN_MS`).\n * @example\n * import { time } from '@dr.pogodin/react-utils';\n * console.log(time.HOUR_MS); // Prints: 3600000\n */\ndayjs.HOUR_MS = 60 * dayjs.MIN_MS;\n\n/**\n * @static\n * @const DAY_MS\n * @desc One day, expressed in milliseconds (equals 24 × `HOUR_MS`).\n * @example\n * import { time } from '@dr.pogodin/react-utils';\n * console.log(time.DAY_MS); // Prints: 86400000\n */\ndayjs.DAY_MS = 24 * dayjs.HOUR_MS;\n\n/**\n * @static\n * @const YEAR_MS\n * @desc One year, expressed in milliseconds (equals 365 × `DAY_MS`,\n *  thus a normal, non-leap year).\n * @example\n * import { time } from '@dr.pogodin/react-utils';\n * console.log(time.YEAR_MS); // Prints: 31536000000\n */\ndayjs.YEAR_MS = 365 * dayjs.DAY_MS;\n\n/**\n * @static\n * @func now\n * @desc Returns Unix timestamp [ms] (thus, it is just an alias for `Date.now`).\n * @return {number}\n * @example\n * import { time } from '@dr.pogodin/react-utils';\n * console.log(time.now()); // Prints the current timestamp, e.g. 1618608761000.\n */\ndayjs.now = Date.now;\n\n/**\n * @static\n * @func timer\n * @desc Creates a Promise, which resolves after the given timeout.\n * @param {number} timeout Timeout [ms].\n * @return {Promise} Resolves after the timeout.\n * @example\n * import { time } from '@dr.pogodin/react-utils';\n * time.timer(5000).then(() => console.log('5 seconds have passed'))\n */\ndayjs.timer = async function timer(timeout) {\n  return new Promise((resolve) => {\n    setTimeout(resolve, timeout);\n  });\n};\n\nexport default dayjs;\n"],"file":"time.js"}
+{"version":3,"sources":["../../../../src/shared/utils/time.js"],"names":["dayjs","SEC_MS","MIN_MS","HOUR_MS","DAY_MS","YEAR_MS","now","Date","timer","timeout","res","Barrier","id","setTimeout","resolve","bind","abort","clearTimeout"],"mappings":";;;;;;;;;AAAA;;AACA;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACAA,eAAMC,MAAN,GAAe,IAAf;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AACAD,eAAME,MAAN,GAAe,KAAKF,eAAMC,MAA1B;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AACAD,eAAMG,OAAN,GAAgB,KAAKH,eAAME,MAA3B;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AACAF,eAAMI,MAAN,GAAe,KAAKJ,eAAMG,OAA1B;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AACAH,eAAMK,OAAN,GAAgB,MAAML,eAAMI,MAA5B;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AACAJ,eAAMM,GAAN,GAAYC,IAAI,CAACD,GAAjB;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;;AACAN,eAAMQ,KAAN,GAAc,eAAeA,KAAf,CAAqBC,OAArB,EAA8B;AAC1C,QAAMC,GAAG,GAAG,IAAIC,gBAAJ,EAAZ;AACA,QAAMC,EAAE,GAAGC,UAAU,CAACH,GAAG,CAACI,OAAJ,CAAYC,IAAZ,CAAiBL,GAAjB,CAAD,EAAwBD,OAAxB,CAArB;;AACAC,EAAAA,GAAG,CAACM,KAAJ,GAAY,MAAMC,YAAY,CAACL,EAAD,CAA9B;;AACA,SAAOF,GAAP;AACD,CALD;;eAOeV,c","sourcesContent":["import dayjs from 'dayjs';\nimport { Barrier } from './Barrier';\n\n/**\n * @static\n * @const SEC_MS\n * @desc One second, expressed in milliseconds (equals 1000 ms).\n * @example\n * import { time } from '@dr.pogodin/react-utils';\n * console.log(time.SEC_MS); // Prints: 1000\n */\ndayjs.SEC_MS = 1000;\n\n/**\n * @static\n * @const MIN_MS\n * @desc One minute, expressed in milliseconds (equals 60 × `SEC_MS`).\n * @example\n * import { time } from '@dr.pogodin/react-utils';\n * console.log(time.MIN_MS); // Prints: 60000\n */\ndayjs.MIN_MS = 60 * dayjs.SEC_MS;\n\n/**\n * @static\n * @const HOUR_MS\n * @desc One hour, expressed in milliseconds (equals 60 × `MIN_MS`).\n * @example\n * import { time } from '@dr.pogodin/react-utils';\n * console.log(time.HOUR_MS); // Prints: 3600000\n */\ndayjs.HOUR_MS = 60 * dayjs.MIN_MS;\n\n/**\n * @static\n * @const DAY_MS\n * @desc One day, expressed in milliseconds (equals 24 × `HOUR_MS`).\n * @example\n * import { time } from '@dr.pogodin/react-utils';\n * console.log(time.DAY_MS); // Prints: 86400000\n */\ndayjs.DAY_MS = 24 * dayjs.HOUR_MS;\n\n/**\n * @static\n * @const YEAR_MS\n * @desc One year, expressed in milliseconds (equals 365 × `DAY_MS`,\n *  thus a normal, non-leap year).\n * @example\n * import { time } from '@dr.pogodin/react-utils';\n * console.log(time.YEAR_MS); // Prints: 31536000000\n */\ndayjs.YEAR_MS = 365 * dayjs.DAY_MS;\n\n/**\n * @static\n * @func now\n * @desc Returns Unix timestamp [ms] (thus, it is just an alias for `Date.now`).\n * @return {number}\n * @example\n * import { time } from '@dr.pogodin/react-utils';\n * console.log(time.now()); // Prints the current timestamp, e.g. 1618608761000.\n */\ndayjs.now = Date.now;\n\n/**\n * Creates a Promise, which resolves after the given timeout.\n * @param {number} timeout Timeout [ms].\n * @return {Barrier} Resolves after the timeout. It has additional\n *  .abort() method attached, which cancels the pending timer resolution\n *  (without resolving or rejecting the barrier).\n */\ndayjs.timer = async function timer(timeout) {\n  const res = new Barrier();\n  const id = setTimeout(res.resolve.bind(res), timeout);\n  res.abort = () => clearTimeout(id);\n  return res;\n};\n\nexport default dayjs;\n"],"file":"time.js"}