@d-matrix/utils 1.7.0 → 1.8.0

package/dist/react/enhancedComponent.d.ts

@@ -0,0 +1,12 @@
+import React from 'react';
+/**
+ * react component 的增强类
+ */
+export declare class EnhancedComponent<P, S> extends React.Component<P, S> {
+    /**
+     * setState 方法的同步版本
+     * @param state
+     * @returns Promise
+     */
+    protected setStateAsync<K extends keyof S>(state: ((prevState: Readonly<S>, props: Readonly<P>) => Pick<S, K> | S | null) | (Pick<S, K> | S | null)): Promise<void>;
+}

package/dist/react/enhancedComponent.js

@@ -0,0 +1,44 @@
+"use strict";
+var __extends = (this && this.__extends) || (function () {
+    var extendStatics = function (d, b) {
+        extendStatics = Object.setPrototypeOf ||
+            ({ __proto__: [] } instanceof Array && function (d, b) { d.__proto__ = b; }) ||
+            function (d, b) { for (var p in b) if (Object.prototype.hasOwnProperty.call(b, p)) d[p] = b[p]; };
+        return extendStatics(d, b);
+    };
+    return function (d, b) {
+        if (typeof b !== "function" && b !== null)
+            throw new TypeError("Class extends value " + String(b) + " is not a constructor or null");
+        extendStatics(d, b);
+        function __() { this.constructor = d; }
+        d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EnhancedComponent = void 0;
+var react_1 = __importDefault(require("react"));
+/**
+ * react component 的增强类
+ */
+var EnhancedComponent = /** @class */ (function (_super) {
+    __extends(EnhancedComponent, _super);
+    function EnhancedComponent() {
+        return _super !== null && _super.apply(this, arguments) || this;
+    }
+    /**
+     * setState 方法的同步版本
+     * @param state
+     * @returns Promise
+     */
+    EnhancedComponent.prototype.setStateAsync = function (state) {
+        var _this = this;
+        return new Promise(function (resolve) {
+            _this.setState(state, resolve);
+        });
+    };
+    return EnhancedComponent;
+}(react_1.default.Component));
+exports.EnhancedComponent = EnhancedComponent;

package/dist/react/index.d.ts

@@ -3,3 +3,4 @@ export * from './useStateCallback';
 export * from './renderToString';
 export * from './useIsMounted';
 export * from './useCopyToClipboard';
+export * from './enhancedComponent';

package/dist/react/index.js

@@ -15,3 +15,4 @@ __exportStar(require("./useStateCallback"), exports);
 __exportStar(require("./renderToString"), exports);
 __exportStar(require("./useIsMounted"), exports);
 __exportStar(require("./useCopyToClipboard"), exports);
+__exportStar(require("./enhancedComponent"), exports);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@d-matrix/utils",
-  "version": "1.7.0",
+  "version": "1.8.0",
   "description": "A dozen of utils for Front-End Development",
   "main": "dist/index.js",
   "scripts": {
@@ -11,7 +11,8 @@
     "cy:component": "cypress run --component --spec",
     "cy:component:all": "cypress run --component",
     "test:tsd": "tsd",
-    "postversion": "git push && git push --tags"
+    "postversion": "git push && git push --tags",
+    "cnpm:sync": "cnpm sync %npm_package_name%"
   },
   "engines": {
     "node": ">=16.20.0"
@@ -42,6 +43,7 @@
   },
   "devDependencies": {
     "@vitejs/plugin-react": "^4.2.1",
+    "cnpm": "^9.4.0",
     "cypress": "^13.6.6",
     "expect-type": "^0.19.0",
     "rimraf": "^5.0.5",

package/readme.md

@@ -88,6 +88,33 @@ const Test = () => {
 
 复制文本到剪切板, 用法见[测试](./tests/react.cy.tsx)
 
+- `EnhancedComponent.prototype.setStateAsync(state)`
+
+setState 方法的同步版本
+
+```ts
+import { react } from '@d-matrix/utils';
+
+ class TestComponent extends EnhancedComponent<unknown, { pageIndex: number }> {
+  state = {
+    pageIndex: 1,
+  };
+
+  async onClick() {
+    await this.setStateAsync({ pageIndex: 2 });
+    console.log(this.state.pageIndex); // 2
+  }
+
+  render() {
+    return (
+      <button data-cy="test-button" onClick={() => this.onClick()}>
+        click
+      </button>
+    );
+  }
+}
+```
+
 ### dom
 
 - `scrollToTop(element: Element | null | undefined): void`