@zentryhq/ui-utils 1.0.0

package/dist/cn.d.ts

@@ -0,0 +1,2 @@
+import { type ClassValue } from "clsx";
+export declare function cn(...inputs: ClassValue[]): string;

package/dist/cn.js

@@ -0,0 +1,5 @@
+import { clsx } from "clsx";
+import { twMerge } from "tailwind-merge";
+export function cn(...inputs) {
+    return twMerge(clsx(inputs));
+}

package/dist/debounced-fetcher.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Debounces a fetchable function into a single call.
+ */
+export declare class DebounceFetcher<ARGS, RES> {
+    private _batchableFetch;
+    private _aggregated;
+    private _rafId;
+    constructor(_batchableFetch: (batchedArgs: ARGS[]) => Promise<RES[]>);
+    fetch(args: ARGS): Promise<RES | null>;
+}

package/dist/debounced-fetcher.js

@@ -0,0 +1,33 @@
+import { Resolvable } from "@zentryhq/utils/resolvable";
+/**
+ * Debounces a fetchable function into a single call.
+ */
+export class DebounceFetcher {
+    _batchableFetch;
+    _aggregated = [];
+    _rafId = null;
+    constructor(_batchableFetch) {
+        this._batchableFetch = _batchableFetch;
+    }
+    fetch(args) {
+        const resolvable = new Resolvable();
+        this._aggregated.push({ resolvable, args });
+        if (!this._rafId) {
+            this._rafId = requestAnimationFrame(() => {
+                const aggregated = [...this._aggregated];
+                this._aggregated = [];
+                this._rafId = null;
+                const doThing = async () => {
+                    // fetch here with all arguments and return
+                    const allPayloads = aggregated.map((a) => a.args);
+                    const result = await this._batchableFetch(allPayloads);
+                    for (let i = 0; i < aggregated.length; i++) {
+                        aggregated[i].resolvable.resolve(result[i]);
+                    }
+                };
+                void doThing();
+            });
+        }
+        return resolvable.wait();
+    }
+}

package/dist/merge-refs.d.ts

@@ -0,0 +1 @@
+export declare function mergeRefs<T = any>(refs: Array<React.MutableRefObject<T> | React.LegacyRef<T>>): React.RefCallback<T>;

package/dist/merge-refs.jsx

@@ -0,0 +1,12 @@
+export function mergeRefs(refs) {
+    return (value) => {
+        refs.forEach((ref) => {
+            if (typeof ref === 'function') {
+                ref(value);
+            }
+            else if (ref != null) {
+                ref.current = value;
+            }
+        });
+    };
+}

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@zentryhq/ui-utils",
+  "version": "1.0.0",
+  "description": "UI Utility module used by the team at Zentry",
+  "homepage": "https://github.com/zentryHQ/common",
+  "bugs": {
+    "url": "https://github.com/zentryHQ/common"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/zentryHQ/common"
+  },
+  "license": "MIT",
+  "author": "Zentry",
+  "files": [
+    "dist",
+    "LICENSE",
+    "README.md"
+  ],
+  "exports": {
+    "./cn": {
+      "types": "./dist/cn.d.ts",
+      "default": "./dist/cn.js"
+    },
+    "./merge-refs": {
+      "types": "./dist/merge-refs.d.ts",
+      "default": "./dist/merge-refs.js"
+    },
+    "./debounced-fetcher": {
+      "types": "./dist/debounced-fetcher.d.ts",
+      "default": "./dist/debounced-fetcher.js"
+    }
+  },
+  "scripts": {
+    "dev": "tsc --watch",
+    "build": "tsc",
+    "test": "vitest --passWithNoTests"
+  },
+  "devDependencies": {
+    "@types/node": "^22.5.5",
+    "typescript": "latest",
+    "vitest": "^1.0.0",
+    "@types/react": "19.2.14",
+    "@types/react-dom": "19.2.3"
+  },
+  "dependencies": {
+    "@zentryhq/utils": "workspace:*",
+    "clsx": "^2.1.1",
+    "tailwind-merge": "^3.4.1"
+  }
+}