xertica-ui 2.1.2 → 2.1.4

package/dist/ui.cjs.js

@@ -3,10 +3,10 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const button = require("./button-0CXwCRTm.cjs");
 const card = require("./card-DJTsYhLL.cjs");
 const alertDialog = require("./alert-dialog-yckpaOpy.cjs");
-const AssistantChart = require("./AssistantChart-BAx9VQvb.cjs");
+const AssistantChart = require("./AssistantChart-BAudAfne.cjs");
 const breadcrumb = require("./breadcrumb-DnDlQFg2.cjs");
 const input = require("./input-CPl84zAx.cjs");
-const richTextEditor = require("./rich-text-editor-DbV-S7Fi.cjs");
+const richTextEditor = require("./rich-text-editor-GS2kpTAK.cjs");
 const slider = require("./slider-CPmwzm_3.cjs");
 const select = require("./select-DT7Zjn42.cjs");
 const tooltip = require("./tooltip-CNtsL5cB.cjs");
@@ -184,8 +184,12 @@ exports.ToggleGroupItem = AssistantChart.ToggleGroupItem;
 exports.TreeView = AssistantChart.TreeView;
 exports.navigationMenuTriggerStyle = AssistantChart.navigationMenuTriggerStyle;
 exports.toggleVariants = AssistantChart.toggleVariants;
+exports.useFileUpload = AssistantChart.useFileUpload;
 exports.useFormField = AssistantChart.useFormField;
+exports.usePagination = AssistantChart.usePagination;
 exports.useStepper = AssistantChart.useStepper;
+exports.useStepperContext = AssistantChart.useStepperContext;
+exports.useTreeView = AssistantChart.useTreeView;
 exports.Breadcrumb = breadcrumb.Breadcrumb;
 exports.BreadcrumbEllipsis = breadcrumb.BreadcrumbEllipsis;
 exports.BreadcrumbItem = breadcrumb.BreadcrumbItem;
@@ -231,10 +235,15 @@ exports.EmptyDescription = richTextEditor.EmptyDescription;
 exports.EmptyIcon = richTextEditor.EmptyIcon;
 exports.EmptyImage = richTextEditor.EmptyImage;
 exports.EmptyTitle = richTextEditor.EmptyTitle;
+exports.GaugeChart = richTextEditor.GaugeChart;
 exports.HorizontalBarChart = richTextEditor.HorizontalBarChart;
 exports.InteractiveTimeSeriesChart = richTextEditor.InteractiveTimeSeriesChart;
+exports.PieMetricChart = richTextEditor.PieMetricChart;
+exports.RadarMetricChart = richTextEditor.RadarMetricChart;
+exports.RadialBarMetricChart = richTextEditor.RadialBarMetricChart;
 exports.RichTextEditor = richTextEditor.RichTextEditor;
 exports.Skeleton = richTextEditor.Skeleton;
+exports.SparklineChart = richTextEditor.SparklineChart;
 exports.Table = richTextEditor.Table;
 exports.TableBody = richTextEditor.TableBody;
 exports.TableCaption = richTextEditor.TableCaption;
@@ -245,6 +254,7 @@ exports.TableHeader = richTextEditor.TableHeader;
 exports.TableRow = richTextEditor.TableRow;
 exports.Textarea = richTextEditor.Textarea;
 exports.useChart = richTextEditor.useChart;
+exports.useRichTextEditor = richTextEditor.useRichTextEditor;
 exports.Slider = slider.Slider;
 exports.Select = select.Select;
 exports.SelectContent = select.SelectContent;

package/dist/ui.es.js

@@ -1,10 +1,10 @@
 import { B, b, c } from "./button-qkz7Icqf.js";
 import { C, a, b as b2, c as c2, d, e, f } from "./card-fi8zAN-I.js";
 import { A, a as a2, b as b3, c as c3, d as d2, e as e2, f as f2, g, h, i, j, C as C2, I, L, M, P, k, l, R, m, S, n, T, o, p, q, u } from "./alert-dialog-iDe5VE5o.js";
-import { A as A2, a as a3, b as b4, c as c4, d as d3, e as e3, C as C3, f as f3, g as g2, h as h2, i as i2, j as j2, k as k2, l as l2, m as m2, n as n2, o as o2, p as p2, q as q2, r, s, t, u as u2, v, w, x, y, z, B as B2, D, E, F, G, H, I as I2, J, K, L as L2, M as M2, N, O, P as P2, Q, R as R2, S as S2, T as T2, U, V, W, X, Y, Z, _, $, a0, a1, a2 as a22, a3 as a32, a4, a5, a6, a7, a8, a9, aa, ab, ac, ad, ae, af, ag, ah, ai, aj, ak, al, am, an, ao, ap, aq, ar, as, at, au, av, aw, ax, ay, az, aA, aB, aC, aD, aE, aF, aG, aH, aI, aJ, aK, aL, aM, aN, aO, aP, aQ, aR, aS, aT, aU, aV, aW, aX, aY, aZ, a_, a$, b0, b1, b2 as b22, b3 as b32, b4 as b42, b5, b6, b7, b8, b9, ba, bb, bc, bd, be } from "./AssistantChart-CVko2A1W.js";
+import { A as A2, a as a3, b as b4, c as c4, d as d3, e as e3, C as C3, f as f3, g as g2, h as h2, i as i2, j as j2, k as k2, l as l2, m as m2, n as n2, o as o2, p as p2, q as q2, r, s, t, u as u2, v, w, x, y, z, B as B2, D, E, F, G, H, I as I2, J, K, L as L2, M as M2, N, O, P as P2, Q, R as R2, S as S2, T as T2, U, V, W, X, Y, Z, _, $, a0, a1, a2 as a22, a3 as a32, a4, a5, a6, a7, a8, a9, aa, ab, ac, ad, ae, af, ag, ah, ai, aj, ak, al, am, an, ao, ap, aq, ar, as, at, au, av, aw, ax, ay, az, aA, aB, aC, aD, aE, aF, aG, aH, aI, aJ, aK, aL, aM, aN, aO, aP, aQ, aR, aS, aT, aU, aV, aW, aX, aY, aZ, a_, a$, b0, b1, b2 as b22, b3 as b32, b4 as b42, b5, b6, b7, b8, b9, ba, bb, bc, bd, be, bf, bg, bh, bi } from "./AssistantChart-BP8upjMk.js";
 import { B as B3, a as a10, b as b10, c as c5, d as d4, e as e4, f as f4 } from "./breadcrumb-CVzzzqfo.js";
 import { I as I3, P as P3, a as a11, b as b11, c as c6, S as S3, d as d5 } from "./input-D-6IsAca.js";
-import { A as A3, a as a12, b as b12, C as C4, c as c7, d as d6, e as e5, f as f5, g as g3, h as h3, i as i3, D as D2, j as j3, k as k3, l as l3, m as m3, n as n3, o as o3, p as p3, q as q3, r as r2, s as s2, t as t2, u as u3, v as v2, E as E2, w as w2, x as x2, y as y2, z as z2, B as B4, H as H2, I as I4, R as R3, S as S4, T as T3, F as F2, G as G2, J as J2, K as K2, L as L3, M as M3, N as N2, O as O2, P as P4 } from "./rich-text-editor-BrdC5evx.js";
+import { A as A3, a as a12, b as b12, C as C4, c as c7, d as d6, e as e5, f as f5, g as g3, h as h3, i as i3, D as D2, j as j3, k as k3, l as l3, m as m3, n as n3, o as o3, p as p3, q as q3, r as r2, s as s2, t as t2, u as u3, v as v2, E as E2, w as w2, x as x2, y as y2, z as z2, B as B4, G as G2, H as H2, I as I4, P as P4, R as R3, F as F2, J as J2, S as S4, K as K2, T as T3, L as L3, M as M3, N as N2, O as O2, Q as Q2, U as U2, V as V2, W as W2, X as X2, Y as Y2 } from "./rich-text-editor-BmsjY03B.js";
 import { S as S5 } from "./slider-C0JKA9k3.js";
 import { S as S6, a as a13, b as b13, c as c8, d as d7, e as e6, f as f6, g as g4, h as h4, i as i4 } from "./select-En8DkoaQ.js";
 import { T as T4, a as a14, b as b14, c as c9 } from "./tooltip-CTyZCD8h.js";
@@ -153,6 +153,7 @@ export {
   a4 as FormMessage,
   G3 as GOOGLE_MAPS_ID,
   a17 as GOOGLE_MAPS_LIBRARIES,
+  G2 as GaugeChart,
   b18 as GoogleMapsLoaderProvider,
   c11 as GoogleMapsProvider,
   H2 as HorizontalBarChart,
@@ -203,18 +204,21 @@ export {
   aF as PaginationLink,
   aG as PaginationNext,
   aH as PaginationPrevious,
+  P4 as PieMetricChart,
   P3 as Popover,
   a11 as PopoverAnchor,
   b11 as PopoverContent,
   c6 as PopoverTrigger,
   P5 as Progress,
+  R3 as RadarMetricChart,
+  F2 as RadialBarMetricChart,
   R as RadioGroup,
   m as RadioGroupItem,
   aI as Rating,
   aJ as ResizableHandle,
   aK as ResizablePanel,
   aL as ResizablePanelGroup,
-  R3 as RichTextEditor,
+  J2 as RichTextEditor,
   aM as RouteMap,
   S3 as ScrollArea,
   d5 as ScrollBar,
@@ -243,23 +247,24 @@ export {
   aY as SimpleMap,
   S4 as Skeleton,
   S5 as Slider,
+  K2 as SparklineChart,
   aZ as StatsCard,
   a_ as Step,
   a$ as Stepper,
   n as Switch,
   T3 as Table,
-  F2 as TableBody,
-  G2 as TableCaption,
-  J2 as TableCell,
-  K2 as TableFooter,
-  L3 as TableHead,
-  M3 as TableHeader,
-  N2 as TableRow,
+  L3 as TableBody,
+  M3 as TableCaption,
+  N2 as TableCell,
+  O2 as TableFooter,
+  Q2 as TableHead,
+  U2 as TableHeader,
+  V2 as TableRow,
   T as Tabs,
   o as TabsContent,
   p as TabsList,
   q as TabsTrigger,
-  O2 as Textarea,
+  W2 as Textarea,
   b0 as Timeline,
   b1 as TimelineContent,
   b22 as TimelineDescription,
@@ -282,11 +287,16 @@ export {
   bb as navigationMenuTriggerStyle,
   r3 as reloadGoogleMaps,
   bc as toggleVariants,
-  P4 as useChart,
-  bd as useFormField,
+  X2 as useChart,
+  bd as useFileUpload,
+  be as useFormField,
   u4 as useGoogleMapsLoader,
   u5 as useIsMobile,
   u as useMapLayers,
   a18 as useMobile,
-  be as useStepper
+  bf as usePagination,
+  Y2 as useRichTextEditor,
+  bg as useStepper,
+  bh as useStepperContext,
+  bi as useTreeView
 };

package/dist/use-audio-player-Bkh23vQ3.js

@@ -0,0 +1,177 @@
+import { useRef, useState, useEffect, useCallback } from "react";
+import { u as useIsMobile } from "./use-mobile-CNwiBNxu.js";
+import { a as useOptionalLayout } from "./LayoutContext-dbQvdC4O.js";
+function useAudioPlayer({
+  src,
+  autoPlay = false,
+  initialTime = 0,
+  initialDuration,
+  variant = "card",
+  isOpen = true,
+  enableAutoFloat = true,
+  onCloseFloating
+} = {}) {
+  const audioRef = useRef(null);
+  const containerRef = useRef(null);
+  const layout = useOptionalLayout();
+  const sidebarExpanded = (layout == null ? void 0 : layout.sidebarExpanded) ?? false;
+  const sidebarWidth = (layout == null ? void 0 : layout.sidebarWidth) ?? 256;
+  const assistenteExpanded = (layout == null ? void 0 : layout.assistenteExpanded) ?? false;
+  const isMobile = useIsMobile();
+  const [isPlaying, setIsPlaying] = useState(false);
+  const [volume, setVolume] = useState(0.8);
+  const [isMuted, setIsMuted] = useState(false);
+  const [currentTime, setCurrentTime] = useState(initialTime);
+  const [duration, setDuration] = useState(initialDuration || 0);
+  const [playbackSpeed, setPlaybackSpeedState] = useState(1);
+  const [isFloating, setIsFloating] = useState(false);
+  const [isManualFloating, setIsManualFloating] = useState(false);
+  const [enableAutoFloatLocal, setEnableAutoFloatLocal] = useState(enableAutoFloat);
+  const [isVisible, setIsVisible] = useState(variant === "card");
+  useEffect(() => {
+    if (variant === "bar") {
+      if (isOpen) {
+        setIsVisible(true);
+      } else {
+        const timer = setTimeout(() => setIsVisible(false), 300);
+        return () => clearTimeout(timer);
+      }
+    } else {
+      setIsVisible(true);
+    }
+  }, [isOpen, variant]);
+  useEffect(() => {
+    const audio = audioRef.current;
+    if (!audio) return;
+    audio.volume = volume;
+    audio.muted = isMuted;
+    audio.playbackRate = playbackSpeed;
+  }, [volume, isMuted, playbackSpeed, src]);
+  useEffect(() => {
+    if (variant !== "card" || !enableAutoFloatLocal) return;
+    const container = containerRef.current;
+    if (!container) return;
+    if (typeof IntersectionObserver === "undefined") return;
+    const observer = new IntersectionObserver(
+      ([entry]) => {
+        if (isPlaying && !entry.isIntersecting && !isFloating) {
+          if (audioRef.current) setCurrentTime(audioRef.current.currentTime);
+          setIsFloating(true);
+        } else if (entry.isIntersecting && isFloating && !isManualFloating) {
+          if (audioRef.current) setCurrentTime(audioRef.current.currentTime);
+          setIsFloating(false);
+          setIsManualFloating(false);
+        }
+      },
+      { threshold: 0.2 }
+    );
+    observer.observe(container);
+    return () => observer.disconnect();
+  }, [isPlaying, isFloating, isManualFloating, variant, enableAutoFloatLocal]);
+  useEffect(() => {
+    const audio = audioRef.current;
+    if (audio) {
+      if (Math.abs(audio.currentTime - currentTime) > 0.5) {
+        audio.currentTime = currentTime;
+      }
+      if (isPlaying) {
+        audio.play().catch((err) => console.log("Playback interrupted:", err));
+      }
+    }
+  }, [isFloating, variant]);
+  const handleSetFloating = useCallback((floating) => {
+    if (audioRef.current) setCurrentTime(audioRef.current.currentTime);
+    setIsFloating(floating);
+    if (!floating) {
+      setIsManualFloating(false);
+      if (onCloseFloating) onCloseFloating();
+    }
+  }, [onCloseFloating]);
+  const togglePlay = useCallback(() => {
+    if (audioRef.current) {
+      if (isPlaying) {
+        audioRef.current.pause();
+      } else {
+        audioRef.current.play().catch((err) => console.log("Playback error:", err));
+      }
+    }
+  }, [isPlaying]);
+  const toggleMute = useCallback(() => {
+    setIsMuted((prev) => !prev);
+  }, []);
+  const handleSeek = useCallback((value) => {
+    if (audioRef.current) {
+      audioRef.current.currentTime = value[0];
+      setCurrentTime(value[0]);
+    }
+  }, []);
+  const handleVolumeChange = useCallback((value) => {
+    const newVolume = value[0];
+    setVolume(newVolume);
+    setIsMuted(newVolume === 0);
+  }, []);
+  const handleEnableManualFloat = useCallback(() => {
+    setEnableAutoFloatLocal(true);
+    setIsManualFloating(true);
+    if (audioRef.current) setCurrentTime(audioRef.current.currentTime);
+    setIsFloating(true);
+  }, []);
+  const setPlaybackSpeed = useCallback((speed) => {
+    setPlaybackSpeedState(speed);
+  }, []);
+  const resetAudio = useCallback(() => {
+    if (audioRef.current) {
+      audioRef.current.currentTime = 0;
+    }
+  }, []);
+  const formatTime = useCallback((time) => {
+    if (isNaN(time) || time === Infinity || !isFinite(time)) return "0:00";
+    const minutes = Math.floor(time / 60);
+    const seconds = Math.floor(time % 60);
+    return `${minutes}:${seconds < 10 ? "0" : ""}${seconds}`;
+  }, []);
+  const onPlay = useCallback(() => setIsPlaying(true), []);
+  const onPause = useCallback(() => setIsPlaying(false), []);
+  const onEnded = useCallback(() => setIsPlaying(false), []);
+  const onTimeUpdate = useCallback((e) => {
+    setCurrentTime(e.currentTarget.currentTime);
+  }, []);
+  const onLoadedMetadata = useCallback((e) => {
+    setDuration(e.currentTarget.duration);
+  }, []);
+  return {
+    audioRef,
+    containerRef,
+    isPlaying,
+    currentTime,
+    duration,
+    volume,
+    isMuted,
+    playbackSpeed,
+    isFloating,
+    isManualFloating,
+    isVisible,
+    isMobile,
+    enableAutoFloatLocal,
+    sidebarExpanded,
+    sidebarWidth,
+    assistenteExpanded,
+    togglePlay,
+    toggleMute,
+    handleSeek,
+    handleVolumeChange,
+    handleSetFloating,
+    handleEnableManualFloat,
+    setPlaybackSpeed,
+    resetAudio,
+    onPlay,
+    onPause,
+    onEnded,
+    onTimeUpdate,
+    onLoadedMetadata,
+    formatTime
+  };
+}
+export {
+  useAudioPlayer as u
+};

package/dist/use-audio-player-Dn1NR9xN.cjs

@@ -0,0 +1,176 @@
+"use strict";
+const React = require("react");
+const useMobile = require("./use-mobile-Dlf74ufz.cjs");
+const LayoutContext = require("./LayoutContext-BDmcZfMH.cjs");
+function useAudioPlayer({
+  src,
+  autoPlay = false,
+  initialTime = 0,
+  initialDuration,
+  variant = "card",
+  isOpen = true,
+  enableAutoFloat = true,
+  onCloseFloating
+} = {}) {
+  const audioRef = React.useRef(null);
+  const containerRef = React.useRef(null);
+  const layout = LayoutContext.useOptionalLayout();
+  const sidebarExpanded = (layout == null ? void 0 : layout.sidebarExpanded) ?? false;
+  const sidebarWidth = (layout == null ? void 0 : layout.sidebarWidth) ?? 256;
+  const assistenteExpanded = (layout == null ? void 0 : layout.assistenteExpanded) ?? false;
+  const isMobile = useMobile.useIsMobile();
+  const [isPlaying, setIsPlaying] = React.useState(false);
+  const [volume, setVolume] = React.useState(0.8);
+  const [isMuted, setIsMuted] = React.useState(false);
+  const [currentTime, setCurrentTime] = React.useState(initialTime);
+  const [duration, setDuration] = React.useState(initialDuration || 0);
+  const [playbackSpeed, setPlaybackSpeedState] = React.useState(1);
+  const [isFloating, setIsFloating] = React.useState(false);
+  const [isManualFloating, setIsManualFloating] = React.useState(false);
+  const [enableAutoFloatLocal, setEnableAutoFloatLocal] = React.useState(enableAutoFloat);
+  const [isVisible, setIsVisible] = React.useState(variant === "card");
+  React.useEffect(() => {
+    if (variant === "bar") {
+      if (isOpen) {
+        setIsVisible(true);
+      } else {
+        const timer = setTimeout(() => setIsVisible(false), 300);
+        return () => clearTimeout(timer);
+      }
+    } else {
+      setIsVisible(true);
+    }
+  }, [isOpen, variant]);
+  React.useEffect(() => {
+    const audio = audioRef.current;
+    if (!audio) return;
+    audio.volume = volume;
+    audio.muted = isMuted;
+    audio.playbackRate = playbackSpeed;
+  }, [volume, isMuted, playbackSpeed, src]);
+  React.useEffect(() => {
+    if (variant !== "card" || !enableAutoFloatLocal) return;
+    const container = containerRef.current;
+    if (!container) return;
+    if (typeof IntersectionObserver === "undefined") return;
+    const observer = new IntersectionObserver(
+      ([entry]) => {
+        if (isPlaying && !entry.isIntersecting && !isFloating) {
+          if (audioRef.current) setCurrentTime(audioRef.current.currentTime);
+          setIsFloating(true);
+        } else if (entry.isIntersecting && isFloating && !isManualFloating) {
+          if (audioRef.current) setCurrentTime(audioRef.current.currentTime);
+          setIsFloating(false);
+          setIsManualFloating(false);
+        }
+      },
+      { threshold: 0.2 }
+    );
+    observer.observe(container);
+    return () => observer.disconnect();
+  }, [isPlaying, isFloating, isManualFloating, variant, enableAutoFloatLocal]);
+  React.useEffect(() => {
+    const audio = audioRef.current;
+    if (audio) {
+      if (Math.abs(audio.currentTime - currentTime) > 0.5) {
+        audio.currentTime = currentTime;
+      }
+      if (isPlaying) {
+        audio.play().catch((err) => console.log("Playback interrupted:", err));
+      }
+    }
+  }, [isFloating, variant]);
+  const handleSetFloating = React.useCallback((floating) => {
+    if (audioRef.current) setCurrentTime(audioRef.current.currentTime);
+    setIsFloating(floating);
+    if (!floating) {
+      setIsManualFloating(false);
+      if (onCloseFloating) onCloseFloating();
+    }
+  }, [onCloseFloating]);
+  const togglePlay = React.useCallback(() => {
+    if (audioRef.current) {
+      if (isPlaying) {
+        audioRef.current.pause();
+      } else {
+        audioRef.current.play().catch((err) => console.log("Playback error:", err));
+      }
+    }
+  }, [isPlaying]);
+  const toggleMute = React.useCallback(() => {
+    setIsMuted((prev) => !prev);
+  }, []);
+  const handleSeek = React.useCallback((value) => {
+    if (audioRef.current) {
+      audioRef.current.currentTime = value[0];
+      setCurrentTime(value[0]);
+    }
+  }, []);
+  const handleVolumeChange = React.useCallback((value) => {
+    const newVolume = value[0];
+    setVolume(newVolume);
+    setIsMuted(newVolume === 0);
+  }, []);
+  const handleEnableManualFloat = React.useCallback(() => {
+    setEnableAutoFloatLocal(true);
+    setIsManualFloating(true);
+    if (audioRef.current) setCurrentTime(audioRef.current.currentTime);
+    setIsFloating(true);
+  }, []);
+  const setPlaybackSpeed = React.useCallback((speed) => {
+    setPlaybackSpeedState(speed);
+  }, []);
+  const resetAudio = React.useCallback(() => {
+    if (audioRef.current) {
+      audioRef.current.currentTime = 0;
+    }
+  }, []);
+  const formatTime = React.useCallback((time) => {
+    if (isNaN(time) || time === Infinity || !isFinite(time)) return "0:00";
+    const minutes = Math.floor(time / 60);
+    const seconds = Math.floor(time % 60);
+    return `${minutes}:${seconds < 10 ? "0" : ""}${seconds}`;
+  }, []);
+  const onPlay = React.useCallback(() => setIsPlaying(true), []);
+  const onPause = React.useCallback(() => setIsPlaying(false), []);
+  const onEnded = React.useCallback(() => setIsPlaying(false), []);
+  const onTimeUpdate = React.useCallback((e) => {
+    setCurrentTime(e.currentTarget.currentTime);
+  }, []);
+  const onLoadedMetadata = React.useCallback((e) => {
+    setDuration(e.currentTarget.duration);
+  }, []);
+  return {
+    audioRef,
+    containerRef,
+    isPlaying,
+    currentTime,
+    duration,
+    volume,
+    isMuted,
+    playbackSpeed,
+    isFloating,
+    isManualFloating,
+    isVisible,
+    isMobile,
+    enableAutoFloatLocal,
+    sidebarExpanded,
+    sidebarWidth,
+    assistenteExpanded,
+    togglePlay,
+    toggleMute,
+    handleSeek,
+    handleVolumeChange,
+    handleSetFloating,
+    handleEnableManualFloat,
+    setPlaybackSpeed,
+    resetAudio,
+    onPlay,
+    onPause,
+    onEnded,
+    onTimeUpdate,
+    onLoadedMetadata,
+    formatTime
+  };
+}
+exports.useAudioPlayer = useAudioPlayer;

package/dist/utils/color-utils.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Color utility functions shared across the project.
+ * Extracted from BrandColorsContext to allow reuse and isolated testing.
+ */
+/**
+ * Converts a hex color string to its RGB components.
+ * @param hex - Hex color string (with or without leading `#`)
+ * @returns Object with `r`, `g`, `b` values (0–255), or `null` if invalid
+ *
+ * @example
+ * hexToRgb('#3b82f6') // { r: 59, g: 130, b: 246 }
+ * hexToRgb('3b82f6')  // { r: 59, g: 130, b: 246 }
+ * hexToRgb('invalid') // null
+ */
+export declare function hexToRgb(hex: string): {
+    r: number;
+    g: number;
+    b: number;
+} | null;
+/**
+ * Converts RGB components to an `rgba()` CSS string.
+ * @param r - Red (0–255)
+ * @param g - Green (0–255)
+ * @param b - Blue (0–255)
+ * @param alpha - Alpha (0–1), defaults to 1
+ *
+ * @example
+ * rgbToRgba(59, 130, 246, 0.5) // 'rgba(59, 130, 246, 0.5)'
+ */
+export declare function rgbToRgba(r: number, g: number, b: number, alpha?: number): string;
+/**
+ * Converts a hex color to an `rgba()` CSS string.
+ * Returns `null` if the hex is invalid.
+ *
+ * @example
+ * hexToRgba('#3b82f6', 0.15) // 'rgba(59, 130, 246, 0.15)'
+ */
+export declare function hexToRgba(hex: string, alpha?: number): string | null;
+/**
+ * Determines whether a hex color is considered "light" based on its luminance.
+ * Uses the W3C relative luminance formula.
+ *
+ * @param hex - Hex color string
+ * @returns `true` if the color is light, `false` if dark
+ *
+ * @example
+ * isLightColor('#ffffff') // true
+ * isLightColor('#000000') // false
+ * isLightColor('#3b82f6') // false
+ */
+export declare function isLightColor(hex: string): boolean;