aplance-ui 1.0.1

package/registry/hooks/useFocusOutside.tsx

@@ -0,0 +1,33 @@
+import { type RefObject, useEffect } from "react";
+
+type UseFocusOutsideOptions = {
+  enabled?: boolean;
+  event?: "mousedown" | "mouseup" | "click";
+};
+
+export function useFocusOutside(
+  refs: RefObject<HTMLElement | null>[],
+  handler: (event: MouseEvent) => void,
+  options: UseFocusOutsideOptions = {}
+) {
+  const { enabled = true, event = "mousedown" } = options;
+
+  useEffect(() => {
+    if (!enabled) return;
+
+    const listener = (e: MouseEvent) => {
+      const target = e.target as Node;
+
+      const clickedInside = refs.some(
+        (ref) => ref.current && ref.current.contains(target)
+      );
+
+      if (!clickedInside) {
+        handler(e);
+      }
+    };
+
+    document.addEventListener(event, listener);
+    return () => document.removeEventListener(event, listener);
+  }, [refs, handler, enabled, event]);
+}

package/registry/hooks/useResizeObserver.tsx

@@ -0,0 +1,32 @@
+import { type RefObject, useEffect, useRef } from "react";
+
+type UseResizeObserverOptions = {
+  enabled?: boolean;
+};
+
+/**
+ * Observe size changes on an element ref.
+ * Pass `enabled: false` to skip the subscription without unmounting.
+ */
+export function useResizeObserver(
+  ref: RefObject<Element | null>,
+  callback: () => void,
+  options: UseResizeObserverOptions = {},
+) {
+  const { enabled = true } = options;
+  const callbackRef = useRef(callback);
+
+  useEffect(() => {
+    callbackRef.current = callback;
+  }, [callback]);
+
+  useEffect(() => {
+    if (!enabled) return;
+    const element = ref.current;
+    if (!element) return;
+
+    const observer = new ResizeObserver(() => callbackRef.current());
+    observer.observe(element);
+    return () => observer.disconnect();
+  }, [enabled, ref]);
+}

package/registry/lib/dom.ts

@@ -0,0 +1,25 @@
+/**
+ * DOM-related utility functions.
+ */
+
+let globalScrollbarWidth: number | undefined;
+
+/**
+ * Calculates and caches the width of the browser's scrollbar.
+ * Returns 0 during SSR.
+ */
+export function getScrollbarWidth(): number {
+  if (globalScrollbarWidth !== undefined) return globalScrollbarWidth;
+  if (typeof document === "undefined") return 0;
+
+  const probe = document.createElement("div");
+  probe.style.cssText =
+    "visibility:hidden;overflow:scroll;position:absolute;top:-9999px";
+  document.body.appendChild(probe);
+  const inner = document.createElement("div");
+  probe.appendChild(inner);
+  globalScrollbarWidth = probe.offsetWidth - inner.offsetWidth;
+  document.body.removeChild(probe);
+
+  return globalScrollbarWidth;
+}

package/registry/lib/string.ts

@@ -0,0 +1,23 @@
+/**
+ * String manipulation utilities.
+ */
+
+/**
+ * Generate a deterministic numeric hash from a string
+ */
+export function hashName(name: string): number {
+  let hash = 0;
+  for (let i = 0; i < name.length; i++) {
+    hash = ((hash << 5) - hash + name.charCodeAt(i)) | 0;
+  }
+  return Math.abs(hash);
+}
+
+/**
+ * Extract 1-2 letter initials from a name (e.g. "John Doe" -> "JD")
+ */
+export function getInitials(name: string): string {
+  const parts = name.trim().split(/\s+/);
+  if (parts.length >= 2) return parts[0][0] + parts[1][0];
+  return parts[0]?.substring(0, 2) || "?";
+}