@d-matrix/utils 1.6.1 → 1.8.0

package/dist/date.d.ts

@@ -6,3 +6,15 @@
  * @return {number[]} an array of numbers representing the range of years
  */
 export declare const rangeOfYears: (start: number, end?: number) => number[];
+export interface RecentYearOption {
+    label: string;
+    value: number;
+}
+/**
+ * 获取最近n年, 从大到小
+ * @param recentYears 最近几年
+ * @param type 控制返回值类型
+ * @param suffix 后缀，默认为'年'
+ */
+export declare function getRecentYears(recentYears: number, type: 'number[]'): number[];
+export declare function getRecentYears(recentYears: number, type: 'object[]'): RecentYearOption[];

package/dist/date.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.rangeOfYears = void 0;
+exports.getRecentYears = exports.rangeOfYears = void 0;
 /**
  * Generates an array of numbers representing a range of years between the start year and the end year.
  *
@@ -15,3 +15,26 @@ var rangeOfYears = function (start, end) {
         .map(function (year, index) { return year + index; });
 };
 exports.rangeOfYears = rangeOfYears;
+function getRecentYears(recentYears, type, suffix) {
+    if (suffix === void 0) { suffix = '年'; }
+    var thisYear = new Date().getFullYear();
+    if (type === 'number[]') {
+        var result = [];
+        for (var i = 0; i < recentYears; i++) {
+            result.push(thisYear - i);
+        }
+        return result;
+    }
+    if (type === 'object[]') {
+        var result = [];
+        for (var i = 0; i < recentYears; i++) {
+            result.push({
+                value: thisYear - i,
+                label: "" + (thisYear - i) + suffix,
+            });
+        }
+        return result;
+    }
+    throw new Error('type must be "number[]" or "object[]"');
+}
+exports.getRecentYears = getRecentYears;

package/dist/dom.d.ts

@@ -2,3 +2,10 @@
  * 元素滚动条滚动到顶部
  */
 export declare function scrollToTop(element: Element | null | undefined): void;
+/**
+ * Strips HTML tags from a given string and returns the plain text content.
+ *
+ * @param {string} html - The HTML string to strip tags from.
+ * @return {string} The plain text content of the HTML string.
+ */
+export declare function strip(html: string): string;

package/dist/dom.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.scrollToTop = void 0;
+exports.strip = exports.scrollToTop = void 0;
 /**
  * 元素滚动条滚动到顶部
  */
@@ -19,3 +19,14 @@ function scrollToTop(element) {
     }
 }
 exports.scrollToTop = scrollToTop;
+/**
+ * Strips HTML tags from a given string and returns the plain text content.
+ *
+ * @param {string} html - The HTML string to strip tags from.
+ * @return {string} The plain text content of the HTML string.
+ */
+function strip(html) {
+    var doc = new DOMParser().parseFromString(html !== null && html !== void 0 ? html : '', 'text/html');
+    return doc.body.textContent || '';
+}
+exports.strip = strip;

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.6.1",
+  "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,18 +88,79 @@ 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`
 
 元素滚动条滚动到顶部，对老旧浏览器做了兼容，见[浏览器兼容性](https://developer.mozilla.org/en-US/docs/Web/API/Element/scrollTop#browser_compatibility)。
 
+- `strip(html: string): string`
+
+从字符串中去除 HTML 标签并返回纯文本内容。
+
+```ts
+import { dom } from '@d-matrix/utils';
+
+dom.strip('测试<em>高亮</em>测试'); // '测试高亮测试'
+```
+
 ### date
 
 - `rangeOfYears(start: number, end: number = new Date().getFullYear()): number[]`
 
 创建`start`和`end`之间的年份数组。
 
+- `getRecentYears()`
+
+```ts
+export function getRecentYears(recentYears: number, type: 'number[]'): number[];
+export function getRecentYears(recentYears: number, type: 'object[]'): RecentYearOption[];
+export function getRecentYears(recentYears: number, type: 'number[]' | 'object[]', suffix = '年'): number[] | RecentYearOption[]
+```
+
+获取最近n年
+
+```ts
+import { date } from '@d-matrix/utils';
+
+getRecentYears(5, 'number[]'); // [2024, 2023, 2022, 2021, 2020]
+getRecentYears(5, 'object[]');
+// [
+//   { value: 2024, label: '2024年' },
+//   { value: 2023, label: '2023年' },
+//   { value: 2022, label: '2022年' },
+//   { value: 2021, label: '2021年' },
+//   { value: 2020, label: '2020年' },
+// ]
+```
+
 ### types
 
 - `WithOptional<T, K extends keyof T>`