feat: add primitives module compose-refs subpkg

Author: Ohh-889

primitives/compose-refs/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "soybean-react-ui/compose-refs",
+  "version": "1.1.2",
+  "license": "MIT",
+  "homepage": "https://radix-ui.com/primitives",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/radix-ui/primitives.git"
+  },
+  "bugs": {
+    "url": "https://github.com/radix-ui/primitives/issues"
+  },
+  "publishConfig": {
+    "main": "./dist/index.js",
+    "module": "./dist/index.mjs",
+    "types": "./dist/index.d.ts",
+    "exports": {
+      ".": {
+        "import": {
+          "types": "./dist/index.d.mts",
+          "default": "./dist/index.mjs"
+        },
+        "require": {
+          "types": "./dist/index.d.ts",
+          "default": "./dist/index.js"
+        }
+      }
+    }
+  },
+  "sideEffects": false,
+  "main": "./src/index.ts",
+  "module": "./src/index.ts",
+  "files": ["dist", "README.md"],
+  "scripts": {
+    "build": "radix-build",
+    "clean": "rm -rf dist",
+    "lint": "eslint --max-warnings 0 src",
+    "typecheck": "tsc --noEmit"
+  },
+  "peerDependencies": {
+    "@types/react": "*",
+    "react": "^16.8 || ^17.0 || ^18.0 || ^19.0 || ^19.0.0-rc"
+  },
+  "peerDependenciesMeta": {
+    "@types/react": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/react": "19.0.7",
+    "@types/react-dom": "19.0.3",
+    "eslint": "9.18.0",
+    "react": "19.1.0",
+    "react-dom": "19.1.0",
+    "typescript": "5.7.3"
+  },
+  "source": "./src/index.ts"
+}

primitives/compose-refs/src/compose-refs.ts

@@ -0,0 +1,51 @@
+import type { Ref, RefCallback } from 'react';
+
+export type PossibleRef<T> = Ref<T> | undefined;
+
+/**
+ * Set a given ref to a given value
+ * This utility takes care of different types of refs: callback refs and RefObject(s)
+ */
+export function setRef<T>(ref: PossibleRef<T>, value: T) {
+  if (typeof ref === 'function') {
+    return ref(value);
+  } else if (ref !== null && ref !== undefined) {
+    ref.current = value;
+  }
+  return null;
+}
+
+/**
+ * A utility to compose multiple refs together
+ * Accepts callback refs and RefObject(s)
+ */
+export function composeRefs<T>(...refs: PossibleRef<T>[]): RefCallback<T> {
+  return node => {
+    let hasCleanup = false;
+    const cleanups = refs.map(ref => {
+      const cleanup = setRef(ref, node);
+      if (!hasCleanup && typeof cleanup === 'function') {
+        hasCleanup = true;
+      }
+      return cleanup;
+    });
+
+    // React <19 will log an error to the console if a callback ref returns a
+    // value. We don't use ref cleanups internally so this will only happen if a
+    // user's ref callback returns a value, which we only expect if they are
+    // using the cleanup functionality added in React 19.
+    if (hasCleanup) {
+      return () => {
+        for (let i = 0; i < cleanups.length; i += 1) {
+          const cleanup = cleanups[i];
+          if (typeof cleanup === 'function') {
+            cleanup();
+          } else {
+            setRef(refs[i], null);
+          }
+        }
+      };
+    }
+    return undefined;
+  };
+}

primitives/compose-refs/src/index.ts

@@ -0,0 +1,3 @@
+export { composeRefs, type PossibleRef, setRef } from './compose-refs';
+
+export { useComposedRefs } from './use-composed-refs';

primitives/compose-refs/src/use-composed-refs.ts

@@ -0,0 +1,14 @@
+import type { PossibleRef } from "./compose-refs";
+import { composeRefs } from "./compose-refs";
+import type {  RefCallback } from "react";
+import { useCallback } from 'react'
+
+
+
+/**
+ * A custom hook that composes multiple refs
+ * Accepts callback refs and RefObject(s)
+ */
+export function useComposedRefs<T>(...refs: PossibleRef<T>[]): RefCallback<T> {
+    return useCallback(composeRefs(...refs), refs);
+}

primitives/compose-refs/tsconfig.json

@@ -0,0 +1,8 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": {
+    "outDir": "dist"
+  },
+  "include": ["src"],
+  "exclude": ["node_modules", "dist"]
+}