@d-matrix/utils 1.21.1 → 1.22.0

package/dist/index.d.ts

@@ -12,3 +12,4 @@ export * as decimal from './decimal';
 export * as object from './object';
 export * as echarts from './echarts';
 export * as array from './array';
+export * as number from './number';

package/dist/index.js

@@ -12,3 +12,4 @@ export * as decimal from './decimal';
 export * as object from './object';
 export * as echarts from './echarts';
 export * as array from './array';
+export * as number from './number';

package/dist/number.d.ts

@@ -0,0 +1,2 @@
+/** 返回[min, max]之间的随机整数 */
+export declare function randomInt(min: number, max: number): number;

package/dist/number.js

@@ -0,0 +1,4 @@
+/** 返回[min, max]之间的随机整数 */
+export function randomInt(min, max) {
+    return Math.floor(Math.random() * (max - min + 1) + min);
+}

package/dist/object.d.ts

@@ -4,3 +4,10 @@ export declare const ZeroValues: ({} | null | undefined)[];
  * 默认的零值是：undefined、null、空字符串, NaN, [], {}
  */
 export declare const removeZeroValueKeys: <T extends Record<string, any>>(obj: T, zeroValues?: ({} | null | undefined)[]) => T;
+/**
+ * 返回tuple，而不是string[]
+ * const obj = { a: 1, b: '2' };
+ * Object.keys(obj) => string[]
+ * typedKeys({ a: 1, b: '2' }) => ('a' | 'b')[]
+ */
+export declare const typedKeys: <T extends object>(obj: T) => (keyof T)[];

package/dist/object.js

@@ -19,3 +19,10 @@ export const removeZeroValueKeys = (obj, zeroValues = ZeroValues) => {
     }
     return r;
 };
+/**
+ * 返回tuple，而不是string[]
+ * const obj = { a: 1, b: '2' };
+ * Object.keys(obj) => string[]
+ * typedKeys({ a: 1, b: '2' }) => ('a' | 'b')[]
+ */
+export const typedKeys = Object.keys;

package/dist/react/types.d.ts

@@ -1,3 +1,9 @@
 import type { ForwardRefExoticComponent, NamedExoticComponent, ComponentPropsWithoutRef, ComponentPropsWithRef, RefAttributes, ElementType } from 'react';
 export declare type ComponentRef<T extends ElementType> = T extends NamedExoticComponent<ComponentPropsWithoutRef<T> & RefAttributes<infer Method>> ? Method : ComponentPropsWithRef<T> extends RefAttributes<infer Method> ? Method : never;
 export declare type InferRef<T> = T extends ForwardRefExoticComponent<infer Ref> ? Ref extends React.RefAttributes<infer RefElement> ? RefElement : never : never;
+declare type ReactRefComponent<Props extends {
+    ref?: React.Ref<any> | string;
+}> = (props: Props) => React.ReactNode;
+declare type ExtractRefAttributesRef<T> = T extends React.RefAttributes<infer P> ? P : never;
+export declare type GetRef<T extends ReactRefComponent<any> | React.Component<any>> = T extends React.Component<any> ? T : T extends React.ComponentType<infer P> ? ExtractRefAttributesRef<P> : never;
+export {};

package/dist/types.d.ts

@@ -15,3 +15,7 @@ export declare type NonFunctionPropertyNames<T> = {
 }[keyof T];
 /** 获取对象中key的值，返回由这些值组成的union type */
 export declare type ValueOf<T> = T[keyof T];
+/** 指定属性变为必选 */
+export declare type WithRequired<T, K extends keyof T> = T & {
+    [P in K]-?: T[P];
+};

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@d-matrix/utils",
   "sideEffects": false,
-  "version": "1.21.1",
+  "version": "1.22.0",
   "description": "A dozen of utils for Front-End Development",
   "main": "dist/index.js",
   "scripts": {

package/readme.md

@@ -20,6 +20,7 @@ A dozen of utils for Front-End Development
 - [decimal](#decimal)
 - [object](#object)
 - [array](#array)
+- [number](#number)
 - [echarts](#echarts)
 
 ### clipboard
@@ -339,6 +340,18 @@ const map = {
 type T0 = ValueOf<typeof map>; // '0m' | '1m' | '2m' | '3m' | '4m' | '5m' | '6m'
 ```
 
+- `WithRequired<T, K extends keyof T>`
+
+指定属性变为必选
+
+```ts
+type Input = {
+  a: number;
+  b?: string;
+};
+type Output = WithRequired<Input, 'b'> // { a: number; b: string }
+```
+
 ### algorithm
 
 - `moveMulti<T extends unknown>(arr: T[], indexes: number[], start: number): T[]`
@@ -485,6 +498,16 @@ removeZeroValueKeys({ a: '', b: 'abc', c: undefined, d: null, e: NaN, f: -1, g:
 // { b: 'abc', f: -1 }
 ```
 
+- `typedKeys(obj: T): Array<keyof T>`
+
+返回`tuple`，而不是`string[]`
+
+```ts
+const obj = { a: 1, b: '2' };
+Object.keys(obj) //  string[]
+object.typedKeys({ a: 1, b: '2' }) // ('a' | 'b')[]
+```
+
 ## array
 
 - `moveImmutable<T>(array: T[], fromIndex: number, toIndex: number): T[]`
@@ -522,6 +545,12 @@ const newList = array.moveToStart(list, (item) => item.id === 4);
 // [{ id: 4 }, { id: 1 }, { id: 2 }, { id: 3 }, { id: 5 }]
 ```
 
+## number
+
+- `randomInt(min: number, max: number): number`
+
+返回`min`, `max`之间的随机整数
+
 ## echarts
 
 - `mergeOption(defaults: EChartsOption, overrides: EChartsOption, option?: deepmerge.Options): EChartsOption`