add utils mergeRefs

Author: minimal-ui-kit

packages/minimal-shared/package.json

@@ -1,7 +1,7 @@
 {
   "name": "minimal-shared",
   "author": "Minimals",
-  "version": "1.0.2",
+  "version": "1.0.3",
   "description": "Shared hooks and utils used by Minimal UI and Zone UI.",
   "keywords": [
     "typescript",
@@ -62,7 +62,7 @@
     "lint:fix": "eslint --fix \"**/*.{js,jsx,ts,tsx}\"",
     "lint:print": "npx eslint --print-config eslint.config.mjs > eslint-current-config.json",
     "clean": "rm -rf node_modules .turbo .next out dist build",
-    "re:build": "pnpm clean && pnpm install && pnpm build",
+    "re:build": "pnpm clean && pnpm install && pnpm test && pnpm build",
     "tsc:print": "npx tsc --showConfig"
   },
   "dependencies": {

packages/minimal-shared/src/utils/index.ts

@@ -1,4 +1,5 @@
 export * from './url';
+export * from './refs';
 export * from './font';
 export * from './color';
 export * from './object';

packages/minimal-shared/src/utils/refs/index.ts

@@ -0,0 +1 @@
+export * from './refs';

packages/minimal-shared/src/utils/refs/refs.test.ts

@@ -0,0 +1,59 @@
+import { mergeRefs } from './refs';
+
+// ----------------------------------------------------------------------
+
+describe('mergeRefs()', () => {
+  it('1. Should call all function refs with the value', () => {
+    const ref1 = vi.fn();
+    const ref2 = vi.fn();
+    const mergedRef = mergeRefs([ref1, ref2]);
+
+    const value = 'test';
+    mergedRef(value);
+
+    expect(ref1).toHaveBeenCalledWith(value);
+    expect(ref2).toHaveBeenCalledWith(value);
+  });
+
+  it('2. Should handle null and undefined refs gracefully', () => {
+    const ref1 = vi.fn();
+    const ref2 = { current: null };
+    const mergedRef = mergeRefs([ref1, null, ref2, undefined]);
+
+    const value = 'test';
+    mergedRef(value);
+
+    expect(ref1).toHaveBeenCalledWith(value);
+    expect(ref2.current).toBe(value);
+  });
+
+  it('3. Should handle an empty array of refs', () => {
+    const mergedRef = mergeRefs([]);
+
+    const value = 'test';
+    mergedRef(value);
+
+    // No refs to call, so no expectations
+  });
+
+  it('4. Should handle an array with only null or undefined refs', () => {
+    const mergedRef = mergeRefs([null, undefined]);
+
+    const value = 'test';
+    mergedRef(value);
+
+    // No refs to call, so no expectations
+  });
+
+  it('5. Should handle an array with mixed function and object refs', () => {
+    const ref1 = vi.fn();
+    const ref2 = { current: null };
+    const mergedRef = mergeRefs([ref1, ref2]);
+
+    const value = 'test';
+    mergedRef(value);
+
+    expect(ref1).toHaveBeenCalledWith(value);
+    expect(ref2.current).toBe(value);
+  });
+});

packages/minimal-shared/src/utils/refs/refs.ts

@@ -0,0 +1,22 @@
+// ----------------------------------------------------------------------
+
+export function mergeRefs<T>(refs: (React.Ref<T> | undefined | null)[]): React.RefCallback<T> {
+  return (value: T | null) => {
+    // Early return if there are no refs
+    if (refs.length === 0) return;
+
+    for (const ref of refs) {
+      // Skip invalid refs
+      if (!ref) continue;
+
+      // Handle function refs
+      if (typeof ref === 'function') {
+        ref(value);
+      }
+      // Handle object refs with 'current' property
+      else if ('current' in ref) {
+        (ref as React.MutableRefObject<T | null>).current = value;
+      }
+    }
+  };
+}