Latest repo

node_modules/merge-refs/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2017–2024 Wojciech Maj
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

node_modules/merge-refs/README.md

@@ -0,0 +1,47 @@
+[![npm](https://img.shields.io/npm/v/merge-refs.svg)](https://www.npmjs.com/package/merge-refs) ![downloads](https://img.shields.io/npm/dt/merge-refs.svg) [![CI](https://github.com/wojtekmaj/merge-refs/actions/workflows/ci.yml/badge.svg)](https://github.com/wojtekmaj/merge-refs/actions)
+
+# Merge-Refs
+
+A function that merges React refs into one. Filters out invalid (eg. falsy) refs as well and returns original ref if only one valid ref was given.
+
+## tl;dr
+
+- Install by executing `npm install merge-refs` or `yarn add merge-refs`.
+- Import by adding `import mergeRefs from 'merge-refs'`.
+- Use it in `ref` like so: `<div ref={mergeRefs(ref, someOtherRef)} />`
+
+## Accepted refs
+
+- Refs created using `createRef()`
+- Refs created using `useRef()`
+- Functional refs
+
+## Example
+
+```tsx
+function Hello() {
+  const ref1 = useRef<HTMLDivElement>(); // I'm going to be updated!
+  const ref2 = (element: HTMLDivElement) => {
+    // I'm going to be called!
+  };
+
+  return <div ref={mergeRefs(ref1, ref2)} />;
+}
+```
+
+## License
+
+The MIT License.
+
+## Author
+
+<table>
+  <tr>
+    <td >
+      <img src="https://avatars.githubusercontent.com/u/5426427?v=4&s=128" width="64" height="64" alt="Wojciech Maj">
+    </td>
+    <td>
+      <a href="https://github.com/wojtekmaj">Wojciech Maj</a>
+    </td>
+  </tr>
+</table>

node_modules/merge-refs/dist/cjs/index.d.ts

@@ -0,0 +1,14 @@
+import type * as React from 'react';
+/**
+ * A function that merges React refs into one.
+ * Supports both functions and ref objects created using createRef() and useRef().
+ *
+ * Usage:
+ * ```tsx
+ * <div ref={mergeRefs(ref1, ref2, ref3)} />
+ * ```
+ *
+ * @param {(React.Ref<T> | undefined)[]} inputRefs Array of refs
+ * @returns {React.Ref<T> | React.RefCallback<T>} Merged refs
+ */
+export default function mergeRefs<T>(...inputRefs: (React.Ref<T> | undefined)[]): React.Ref<T> | React.RefCallback<T>;

node_modules/merge-refs/dist/cjs/index.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * A function that merges React refs into one.
+ * Supports both functions and ref objects created using createRef() and useRef().
+ *
+ * Usage:
+ * ```tsx
+ * <div ref={mergeRefs(ref1, ref2, ref3)} />
+ * ```
+ *
+ * @param {(React.Ref<T> | undefined)[]} inputRefs Array of refs
+ * @returns {React.Ref<T> | React.RefCallback<T>} Merged refs
+ */
+function mergeRefs() {
+    var inputRefs = [];
+    for (var _i = 0; _i < arguments.length; _i++) {
+        inputRefs[_i] = arguments[_i];
+    }
+    var filteredInputRefs = inputRefs.filter(Boolean);
+    if (filteredInputRefs.length <= 1) {
+        var firstRef = filteredInputRefs[0];
+        return firstRef || null;
+    }
+    return function mergedRefs(ref) {
+        filteredInputRefs.forEach(function (inputRef) {
+            if (typeof inputRef === 'function') {
+                inputRef(ref);
+            }
+            else if (inputRef) {
+                inputRef.current = ref;
+            }
+        });
+    };
+}
+exports.default = mergeRefs;

node_modules/merge-refs/dist/cjs/package.json

@@ -0,0 +1,3 @@
+{
+  "type": "commonjs"
+}

node_modules/merge-refs/dist/esm/index.d.ts

@@ -0,0 +1,14 @@
+import type * as React from 'react';
+/**
+ * A function that merges React refs into one.
+ * Supports both functions and ref objects created using createRef() and useRef().
+ *
+ * Usage:
+ * ```tsx
+ * <div ref={mergeRefs(ref1, ref2, ref3)} />
+ * ```
+ *
+ * @param {(React.Ref<T> | undefined)[]} inputRefs Array of refs
+ * @returns {React.Ref<T> | React.RefCallback<T>} Merged refs
+ */
+export default function mergeRefs<T>(...inputRefs: (React.Ref<T> | undefined)[]): React.Ref<T> | React.RefCallback<T>;

node_modules/merge-refs/dist/esm/index.js

@@ -0,0 +1,33 @@
+/**
+ * A function that merges React refs into one.
+ * Supports both functions and ref objects created using createRef() and useRef().
+ *
+ * Usage:
+ * ```tsx
+ * <div ref={mergeRefs(ref1, ref2, ref3)} />
+ * ```
+ *
+ * @param {(React.Ref<T> | undefined)[]} inputRefs Array of refs
+ * @returns {React.Ref<T> | React.RefCallback<T>} Merged refs
+ */
+export default function mergeRefs() {
+    var inputRefs = [];
+    for (var _i = 0; _i < arguments.length; _i++) {
+        inputRefs[_i] = arguments[_i];
+    }
+    var filteredInputRefs = inputRefs.filter(Boolean);
+    if (filteredInputRefs.length <= 1) {
+        var firstRef = filteredInputRefs[0];
+        return firstRef || null;
+    }
+    return function mergedRefs(ref) {
+        filteredInputRefs.forEach(function (inputRef) {
+            if (typeof inputRef === 'function') {
+                inputRef(ref);
+            }
+            else if (inputRef) {
+                inputRef.current = ref;
+            }
+        });
+    };
+}

node_modules/merge-refs/package.json

@@ -0,0 +1,79 @@
+{
+  "name": "merge-refs",
+  "version": "1.3.0",
+  "description": "A function that merges React refs into one.",
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/cjs/index.js",
+  "module": "./dist/esm/index.js",
+  "source": "./src/index.ts",
+  "types": "./dist/cjs/index.d.ts",
+  "exports": {
+    "import": "./dist/esm/index.js",
+    "require": "./dist/cjs/index.js"
+  },
+  "scripts": {
+    "build": "yarn build-esm && yarn build-cjs && yarn build-cjs-package",
+    "build-esm": "tsc --project tsconfig.build.json --outDir dist/esm",
+    "build-cjs": "tsc --project tsconfig.build.json --outDir dist/cjs --module commonjs --moduleResolution node --verbatimModuleSyntax false",
+    "build-cjs-package": "echo '{\n  \"type\": \"commonjs\"\n}' > dist/cjs/package.json",
+    "clean": "rimraf dist",
+    "format": "prettier --check . --cache",
+    "lint": "eslint . --ext .js,.jsx,.ts,.tsx",
+    "prepack": "yarn clean && yarn build",
+    "test": "yarn lint && yarn tsc && yarn format && yarn unit",
+    "tsc": "tsc",
+    "unit": "vitest"
+  },
+  "keywords": [
+    "react",
+    "react ref",
+    "react refs",
+    "merge"
+  ],
+  "author": {
+    "name": "Wojciech Maj",
+    "email": "kontakt@wojtekmaj.pl"
+  },
+  "license": "MIT",
+  "devDependencies": {
+    "@testing-library/react": "^15.0.0",
+    "@types/react": "*",
+    "eslint": "^8.56.0",
+    "eslint-config-wojtekmaj": "^1.0.0",
+    "happy-dom": "^12.6.0",
+    "husky": "^9.0.0",
+    "lint-staged": "^15.0.0",
+    "prettier": "^3.2.0",
+    "react": "^18.2.0",
+    "react-dom": "^18.2.0",
+    "rimraf": "^3.0.0",
+    "typescript": "^5.4.2",
+    "vitest": "^1.0.2"
+  },
+  "peerDependencies": {
+    "@types/react": "^16.8.0 || ^17.0.0 || ^18.0.0 || ^19.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@types/react": {
+      "optional": true
+    }
+  },
+  "resolutions": {
+    "eslint-plugin-import": "npm:eslint-plugin-i@^2.28.0"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/wojtekmaj/merge-refs.git"
+  },
+  "funding": "https://github.com/wojtekmaj/merge-refs?sponsor=1",
+  "packageManager": "yarn@4.1.1"
+}

node_modules/merge-refs/src/index.spec.tsx

@@ -0,0 +1,68 @@
+import { describe, expect, it, vi } from 'vitest';
+import { createRef } from 'react';
+import { render } from '@testing-library/react';
+
+import mergeRefs from './index.js';
+
+describe('mergeRefs()', () => {
+  it('returns falsy result given no arguments', () => {
+    const result = mergeRefs();
+
+    expect(result).toBeFalsy();
+  });
+
+  it('returns falsy result given falsy arguments', () => {
+    const result = mergeRefs(null, null);
+
+    expect(result).toBeFalsy();
+  });
+
+  it('returns original ref given only one ref', () => {
+    const ref = vi.fn();
+
+    const result = mergeRefs(ref);
+
+    expect(result).toBe(ref);
+  });
+
+  it('returns original ref given one ref and one falsy argument', () => {
+    const ref = vi.fn();
+
+    const result = mergeRefs(ref, null);
+
+    expect(result).toBe(ref);
+  });
+
+  it('returns merged refs properly', () => {
+    const ref1 = vi.fn();
+    const ref2 = createRef<HTMLDivElement>();
+
+    const result = mergeRefs(ref1, ref2);
+
+    expect(result).not.toBe(ref1);
+    expect(result).toEqual(expect.any(Function));
+  });
+
+  it('handles merged functional refs properly', () => {
+    const ref1 = vi.fn();
+    const ref2 = createRef<HTMLDivElement>();
+
+    const mergedRef = mergeRefs(ref1, ref2);
+
+    const { container } = render(<div ref={mergedRef} />);
+
+    expect(ref1).toHaveBeenCalledTimes(1);
+    expect(ref1).toHaveBeenCalledWith(container.firstElementChild);
+  });
+
+  it('handles merged object refs properly', () => {
+    const ref1 = createRef<HTMLDivElement>();
+    const ref2 = vi.fn();
+
+    const mergedRef = mergeRefs(ref1, ref2);
+
+    const { container } = render(<div ref={mergedRef} />);
+
+    expect(ref1.current).toBe(container.firstElementChild);
+  });
+});

node_modules/merge-refs/src/index.ts

@@ -0,0 +1,35 @@
+import type * as React from 'react';
+
+/**
+ * A function that merges React refs into one.
+ * Supports both functions and ref objects created using createRef() and useRef().
+ *
+ * Usage:
+ * ```tsx
+ * <div ref={mergeRefs(ref1, ref2, ref3)} />
+ * ```
+ *
+ * @param {(React.Ref<T> | undefined)[]} inputRefs Array of refs
+ * @returns {React.Ref<T> | React.RefCallback<T>} Merged refs
+ */
+export default function mergeRefs<T>(
+  ...inputRefs: (React.Ref<T> | undefined)[]
+): React.Ref<T> | React.RefCallback<T> {
+  const filteredInputRefs = inputRefs.filter(Boolean);
+
+  if (filteredInputRefs.length <= 1) {
+    const firstRef = filteredInputRefs[0];
+
+    return firstRef || null;
+  }
+
+  return function mergedRefs(ref) {
+    filteredInputRefs.forEach((inputRef) => {
+      if (typeof inputRef === 'function') {
+        inputRef(ref);
+      } else if (inputRef) {
+        (inputRef as React.MutableRefObject<T | null>).current = ref;
+      }
+    });
+  };
+}