@rc-component/util 1.3.0 → 1.4.0

package/es/Dom/focus.d.ts

@@ -6,3 +6,10 @@ export declare function clearLastFocusNode(): void;
 /** @deprecated Do not use since this may failed when used in async */
 export declare function backLastFocusNode(): void;
 export declare function limitTabRange(node: HTMLElement, e: KeyboardEvent): void;
+export interface InputFocusOptions extends FocusOptions {
+    cursor?: 'start' | 'end' | 'all';
+}
+/**
+ * Focus element and set cursor position for input/textarea elements.
+ */
+export declare function triggerFocus(element?: HTMLElement, option?: InputFocusOptions): void;

package/es/Dom/focus.js

@@ -76,4 +76,30 @@ export function limitTabRange(node, e) {
       e.preventDefault();
     }
   }
+}
+// Used for `rc-input` `rc-textarea` `rc-input-number`
+/**
+ * Focus element and set cursor position for input/textarea elements.
+ */
+export function triggerFocus(element, option) {
+  if (!element) return;
+  element.focus(option);
+
+  // Selection content
+  const {
+    cursor
+  } = option || {};
+  if (cursor && (element instanceof HTMLInputElement || element instanceof HTMLTextAreaElement)) {
+    const len = element.value.length;
+    switch (cursor) {
+      case 'start':
+        element.setSelectionRange(0, 0);
+        break;
+      case 'end':
+        element.setSelectionRange(len, len);
+        break;
+      default:
+        element.setSelectionRange(0, len);
+    }
+  }
 }

package/es/hooks/useEvent.d.ts

@@ -1,2 +1,2 @@
-declare function useEvent<T extends Function>(callback: T): T;
+declare function useEvent<T extends ((...args: any[]) => any) | undefined>(callback: T): undefined extends T ? (...args: Parameters<NonNullable<T>>) => ReturnType<NonNullable<T>> | undefined : T;
 export default useEvent;

package/es/hooks/useEvent.js

@@ -2,7 +2,7 @@
 /* eslint-disable react-hooks/exhaustive-deps */
 import * as React from 'react';
 function useEvent(callback) {
-  const fnRef = React.useRef();
+  const fnRef = React.useRef(callback);
   fnRef.current = callback;
   const memoFn = React.useCallback((...args) => fnRef.current?.(...args), []);
   return memoFn;

package/lib/Dom/focus.d.ts

@@ -6,3 +6,10 @@ export declare function clearLastFocusNode(): void;
 /** @deprecated Do not use since this may failed when used in async */
 export declare function backLastFocusNode(): void;
 export declare function limitTabRange(node: HTMLElement, e: KeyboardEvent): void;
+export interface InputFocusOptions extends FocusOptions {
+    cursor?: 'start' | 'end' | 'all';
+}
+/**
+ * Focus element and set cursor position for input/textarea elements.
+ */
+export declare function triggerFocus(element?: HTMLElement, option?: InputFocusOptions): void;

package/lib/Dom/focus.js

@@ -8,6 +8,7 @@ exports.clearLastFocusNode = clearLastFocusNode;
 exports.getFocusNodeList = getFocusNodeList;
 exports.limitTabRange = limitTabRange;
 exports.saveLastFocusNode = saveLastFocusNode;
+exports.triggerFocus = triggerFocus;
 var _isVisible = _interopRequireDefault(require("./isVisible"));
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
 function focusable(node, includePositive = false) {
@@ -87,4 +88,30 @@ function limitTabRange(node, e) {
       e.preventDefault();
     }
   }
+}
+// Used for `rc-input` `rc-textarea` `rc-input-number`
+/**
+ * Focus element and set cursor position for input/textarea elements.
+ */
+function triggerFocus(element, option) {
+  if (!element) return;
+  element.focus(option);
+
+  // Selection content
+  const {
+    cursor
+  } = option || {};
+  if (cursor && (element instanceof HTMLInputElement || element instanceof HTMLTextAreaElement)) {
+    const len = element.value.length;
+    switch (cursor) {
+      case 'start':
+        element.setSelectionRange(0, 0);
+        break;
+      case 'end':
+        element.setSelectionRange(len, len);
+        break;
+      default:
+        element.setSelectionRange(0, len);
+    }
+  }
 }

package/lib/hooks/useEvent.d.ts

@@ -1,2 +1,2 @@
-declare function useEvent<T extends Function>(callback: T): T;
+declare function useEvent<T extends ((...args: any[]) => any) | undefined>(callback: T): undefined extends T ? (...args: Parameters<NonNullable<T>>) => ReturnType<NonNullable<T>> | undefined : T;
 export default useEvent;

package/lib/hooks/useEvent.js

@@ -11,7 +11,7 @@ function _interopRequireWildcard(e, r) { if (!r && e && e.__esModule) return e;
 /* eslint-disable react-hooks/exhaustive-deps */
 
 function useEvent(callback) {
-  const fnRef = React.useRef();
+  const fnRef = React.useRef(callback);
   fnRef.current = callback;
   const memoFn = React.useCallback((...args) => fnRef.current?.(...args), []);
   return memoFn;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rc-component/util",
-  "version": "1.3.0",
+  "version": "1.4.0",
   "description": "Common Utils For React Component",
   "keywords": [
     "react",
@@ -45,8 +45,8 @@
     "@rc-component/father-plugin": "^2.0.1",
     "@rc-component/np": "^1.0.3",
     "@testing-library/react": "^16.0.0",
-    "@types/jest": "^29.4.0",
-    "@types/node": "^22.5.5",
+    "@types/jest": "^30.0.0",
+    "@types/node": "^24.6.1",
     "@types/react": "^18.0.0",
     "@types/react-dom": "^18.0.0",
     "@types/react-is": "^19.0.0",
@@ -56,10 +56,10 @@
     "cross-env": "^7.0.2",
     "dumi": "^2.1.3",
     "eslint": "^8.54.0",
-    "eslint-plugin-jest": "^28.2.0",
+    "eslint-plugin-jest": "^29.0.1",
     "eslint-plugin-unicorn": "^56.0.1",
     "father": "^4.1.3",
-    "glob": "^9.2.1",
+    "glob": "^11.0.3",
     "husky": "^9.1.6",
     "lint-staged": "^15.1.0",
     "prettier": "^3.3.2",