@arolariu/components 0.5.0 → 1.0.0

package/src/components/ui/background-beams.tsx

@@ -1,145 +1,184 @@
 "use client";
 
-import {cn} from "@/lib/utilities";
 import {motion} from "motion/react";
 import * as React from "react";
 
-export const BackgroundBeams = React.memo(({className}: {className?: string}) => {
-  const paths = [
-    "M-380 -189C-380 -189 -312 216 152 343C616 470 684 875 684 875",
-    "M-373 -197C-373 -197 -305 208 159 335C623 462 691 867 691 867",
-    "M-366 -205C-366 -205 -298 200 166 327C630 454 698 859 698 859",
-    "M-359 -213C-359 -213 -291 192 173 319C637 446 705 851 705 851",
-    "M-352 -221C-352 -221 -284 184 180 311C644 438 712 843 712 843",
-    "M-345 -229C-345 -229 -277 176 187 303C651 430 719 835 719 835",
-    "M-338 -237C-338 -237 -270 168 194 295C658 422 726 827 726 827",
-    "M-331 -245C-331 -245 -263 160 201 287C665 414 733 819 733 819",
-    "M-324 -253C-324 -253 -256 152 208 279C672 406 740 811 740 811",
-    "M-317 -261C-317 -261 -249 144 215 271C679 398 747 803 747 803",
-    "M-310 -269C-310 -269 -242 136 222 263C686 390 754 795 754 795",
-    "M-303 -277C-303 -277 -235 128 229 255C693 382 761 787 761 787",
-    "M-296 -285C-296 -285 -228 120 236 247C700 374 768 779 768 779",
-    "M-289 -293C-289 -293 -221 112 243 239C707 366 775 771 775 771",
-    "M-282 -301C-282 -301 -214 104 250 231C714 358 782 763 782 763",
-    "M-275 -309C-275 -309 -207 96 257 223C721 350 789 755 789 755",
-    "M-268 -317C-268 -317 -200 88 264 215C728 342 796 747 796 747",
-    "M-261 -325C-261 -325 -193 80 271 207C735 334 803 739 803 739",
-    "M-254 -333C-254 -333 -186 72 278 199C742 326 810 731 810 731",
-    "M-247 -341C-247 -341 -179 64 285 191C749 318 817 723 817 723",
-    "M-240 -349C-240 -349 -172 56 292 183C756 310 824 715 824 715",
-    "M-233 -357C-233 -357 -165 48 299 175C763 302 831 707 831 707",
-    "M-226 -365C-226 -365 -158 40 306 167C770 294 838 699 838 699",
-    "M-219 -373C-219 -373 -151 32 313 159C777 286 845 691 845 691",
-    "M-212 -381C-212 -381 -144 24 320 151C784 278 852 683 852 683",
-    "M-205 -389C-205 -389 -137 16 327 143C791 270 859 675 859 675",
-    "M-198 -397C-198 -397 -130 8 334 135C798 262 866 667 866 667",
-    "M-191 -405C-191 -405 -123 0 341 127C805 254 873 659 873 659",
-    "M-184 -413C-184 -413 -116 -8 348 119C812 246 880 651 880 651",
-    "M-177 -421C-177 -421 -109 -16 355 111C819 238 887 643 887 643",
-    "M-170 -429C-170 -429 -102 -24 362 103C826 230 894 635 894 635",
-    "M-163 -437C-163 -437 -95 -32 369 95C833 222 901 627 901 627",
-    "M-156 -445C-156 -445 -88 -40 376 87C840 214 908 619 908 619",
-    "M-149 -453C-149 -453 -81 -48 383 79C847 206 915 611 915 611",
-    "M-142 -461C-142 -461 -74 -56 390 71C854 198 922 603 922 603",
-    "M-135 -469C-135 -469 -67 -64 397 63C861 190 929 595 929 595",
-    "M-128 -477C-128 -477 -60 -72 404 55C868 182 936 587 936 587",
-    "M-121 -485C-121 -485 -53 -80 411 47C875 174 943 579 943 579",
-    "M-114 -493C-114 -493 -46 -88 418 39C882 166 950 571 950 571",
-    "M-107 -501C-107 -501 -39 -96 425 31C889 158 957 563 957 563",
-    "M-100 -509C-100 -509 -32 -104 432 23C896 150 964 555 964 555",
-    "M-93 -517C-93 -517 -25 -112 439 15C903 142 971 547 971 547",
-    "M-86 -525C-86 -525 -18 -120 446 7C910 134 978 539 978 539",
-    "M-79 -533C-79 -533 -11 -128 453 -1C917 126 985 531 985 531",
-    "M-72 -541C-72 -541 -4 -136 460 -9C924 118 992 523 992 523",
-    "M-65 -549C-65 -549 3 -144 467 -17C931 110 999 515 999 515",
-    "M-58 -557C-58 -557 10 -152 474 -25C938 102 1006 507 1006 507",
-    "M-51 -565C-51 -565 17 -160 481 -33C945 94 1013 499 1013 499",
-    "M-44 -573C-44 -573 24 -168 488 -41C952 86 1020 491 1020 491",
-    "M-37 -581C-37 -581 31 -176 495 -49C959 78 1027 483 1027 483",
-  ];
-  return (
-    <div
-      className={cn("absolute inset-0 flex h-full w-full items-center justify-center [mask-size:40px] [mask-repeat:no-repeat]", className)}>
-      <svg
-        className='pointer-events-none absolute z-0 h-full w-full'
-        width='100%'
-        height='100%'
-        viewBox='0 0 696 316'
-        fill='none'
-        xmlns='http://www.w3.org/2000/svg'>
-        <path
-          d='M-380 -189C-380 -189 -312 216 152 343C616 470 684 875 684 875M-373 -197C-373 -197 -305 208 159 335C623 462 691 867 691 867M-366 -205C-366 -205 -298 200 166 327C630 454 698 859 698 859M-359 -213C-359 -213 -291 192 173 319C637 446 705 851 705 851M-352 -221C-352 -221 -284 184 180 311C644 438 712 843 712 843M-345 -229C-345 -229 -277 176 187 303C651 430 719 835 719 835M-338 -237C-338 -237 -270 168 194 295C658 422 726 827 726 827M-331 -245C-331 -245 -263 160 201 287C665 414 733 819 733 819M-324 -253C-324 -253 -256 152 208 279C672 406 740 811 740 811M-317 -261C-317 -261 -249 144 215 271C679 398 747 803 747 803M-310 -269C-310 -269 -242 136 222 263C686 390 754 795 754 795M-303 -277C-303 -277 -235 128 229 255C693 382 761 787 761 787M-296 -285C-296 -285 -228 120 236 247C700 374 768 779 768 779M-289 -293C-289 -293 -221 112 243 239C707 366 775 771 775 771M-282 -301C-282 -301 -214 104 250 231C714 358 782 763 782 763M-275 -309C-275 -309 -207 96 257 223C721 350 789 755 789 755M-268 -317C-268 -317 -200 88 264 215C728 342 796 747 796 747M-261 -325C-261 -325 -193 80 271 207C735 334 803 739 803 739M-254 -333C-254 -333 -186 72 278 199C742 326 810 731 810 731M-247 -341C-247 -341 -179 64 285 191C749 318 817 723 817 723M-240 -349C-240 -349 -172 56 292 183C756 310 824 715 824 715M-233 -357C-233 -357 -165 48 299 175C763 302 831 707 831 707M-226 -365C-226 -365 -158 40 306 167C770 294 838 699 838 699M-219 -373C-219 -373 -151 32 313 159C777 286 845 691 845 691M-212 -381C-212 -381 -144 24 320 151C784 278 852 683 852 683M-205 -389C-205 -389 -137 16 327 143C791 270 859 675 859 675M-198 -397C-198 -397 -130 8 334 135C798 262 866 667 866 667M-191 -405C-191 -405 -123 0 341 127C805 254 873 659 873 659M-184 -413C-184 -413 -116 -8 348 119C812 246 880 651 880 651M-177 -421C-177 -421 -109 -16 355 111C819 238 887 643 887 643M-170 -429C-170 -429 -102 -24 362 103C826 230 894 635 894 635M-163 -437C-163 -437 -95 -32 369 95C833 222 901 627 901 627M-156 -445C-156 -445 -88 -40 376 87C840 214 908 619 908 619M-149 -453C-149 -453 -81 -48 383 79C847 206 915 611 915 611M-142 -461C-142 -461 -74 -56 390 71C854 198 922 603 922 603M-135 -469C-135 -469 -67 -64 397 63C861 190 929 595 929 595M-128 -477C-128 -477 -60 -72 404 55C868 182 936 587 936 587M-121 -485C-121 -485 -53 -80 411 47C875 174 943 579 943 579M-114 -493C-114 -493 -46 -88 418 39C882 166 950 571 950 571M-107 -501C-107 -501 -39 -96 425 31C889 158 957 563 957 563M-100 -509C-100 -509 -32 -104 432 23C896 150 964 555 964 555M-93 -517C-93 -517 -25 -112 439 15C903 142 971 547 971 547M-86 -525C-86 -525 -18 -120 446 7C910 134 978 539 978 539M-79 -533C-79 -533 -11 -128 453 -1C917 126 985 531 985 531M-72 -541C-72 -541 -4 -136 460 -9C924 118 992 523 992 523M-65 -549C-65 -549 3 -144 467 -17C931 110 999 515 999 515M-58 -557C-58 -557 10 -152 474 -25C938 102 1006 507 1006 507M-51 -565C-51 -565 17 -160 481 -33C945 94 1013 499 1013 499M-44 -573C-44 -573 24 -168 488 -41C952 86 1020 491 1020 491M-37 -581C-37 -581 31 -176 495 -49C959 78 1027 483 1027 483M-30 -589C-30 -589 38 -184 502 -57C966 70 1034 475 1034 475M-23 -597C-23 -597 45 -192 509 -65C973 62 1041 467 1041 467M-16 -605C-16 -605 52 -200 516 -73C980 54 1048 459 1048 459M-9 -613C-9 -613 59 -208 523 -81C987 46 1055 451 1055 451M-2 -621C-2 -621 66 -216 530 -89C994 38 1062 443 1062 443M5 -629C5 -629 73 -224 537 -97C1001 30 1069 435 1069 435M12 -637C12 -637 80 -232 544 -105C1008 22 1076 427 1076 427M19 -645C19 -645 87 -240 551 -113C1015 14 1083 419 1083 419'
-          stroke='url(#paint0_radial_242_278)'
-          strokeOpacity='0.05'
-          strokeWidth='0.5'></path>
+import {cn} from "@/lib/utilities";
+import styles from "./background-beams.module.css";
+
+/** Props accepted by {@link BackgroundBeams}. */
+export interface BackgroundBeamsProps extends React.ComponentPropsWithoutRef<"div"> {}
+
+/**
+ * Renders animated aurora-style beams that sweep across the background.
+ *
+ * @remarks
+ * - Animated component using the `motion` library
+ * - Renders a `<div>` element containing animated SVG paths
+ * - Styling via CSS Modules with `--ac-*` custom properties
+ * - Client-side only (`"use client"` directive)
+ *
+ * @example
+ * ```tsx
+ * <BackgroundBeams />
+ * ```
+ *
+ * @see {@link BackgroundBeamsProps} for available props
+ */
+const BackgroundBeams = React.forwardRef<HTMLDivElement, BackgroundBeamsProps>(
+  (props: Readonly<BackgroundBeamsProps>, ref): React.JSX.Element => {
+    const {className, ...restProps} = props;
+    const id = React.useId();
+    const paths = [
+      "M-380 -189C-380 -189 -312 216 152 343C616 470 684 875 684 875",
+      "M-373 -197C-373 -197 -305 208 159 335C623 462 691 867 691 867",
+      "M-366 -205C-366 -205 -298 200 166 327C630 454 698 859 698 859",
+      "M-359 -213C-359 -213 -291 192 173 319C637 446 705 851 705 851",
+      "M-352 -221C-352 -221 -284 184 180 311C644 438 712 843 712 843",
+      "M-345 -229C-345 -229 -277 176 187 303C651 430 719 835 719 835",
+      "M-338 -237C-338 -237 -270 168 194 295C658 422 726 827 726 827",
+      "M-331 -245C-331 -245 -263 160 201 287C665 414 733 819 733 819",
+      "M-324 -253C-324 -253 -256 152 208 279C672 406 740 811 740 811",
+      "M-317 -261C-317 -261 -249 144 215 271C679 398 747 803 747 803",
+      "M-310 -269C-310 -269 -242 136 222 263C686 390 754 795 754 795",
+      "M-303 -277C-303 -277 -235 128 229 255C693 382 761 787 761 787",
+      "M-296 -285C-296 -285 -228 120 236 247C700 374 768 779 768 779",
+      "M-289 -293C-289 -293 -221 112 243 239C707 366 775 771 775 771",
+      "M-282 -301C-282 -301 -214 104 250 231C714 358 782 763 782 763",
+      "M-275 -309C-275 -309 -207 96 257 223C721 350 789 755 789 755",
+      "M-268 -317C-268 -317 -200 88 264 215C728 342 796 747 796 747",
+      "M-261 -325C-261 -325 -193 80 271 207C735 334 803 739 803 739",
+      "M-254 -333C-254 -333 -186 72 278 199C742 326 810 731 810 731",
+      "M-247 -341C-247 -341 -179 64 285 191C749 318 817 723 817 723",
+      "M-240 -349C-240 -349 -172 56 292 183C756 310 824 715 824 715",
+      "M-233 -357C-233 -357 -165 48 299 175C763 302 831 707 831 707",
+      "M-226 -365C-226 -365 -158 40 306 167C770 294 838 699 838 699",
+      "M-219 -373C-219 -373 -151 32 313 159C777 286 845 691 845 691",
+      "M-212 -381C-212 -381 -144 24 320 151C784 278 852 683 852 683",
+      "M-205 -389C-205 -389 -137 16 327 143C791 270 859 675 859 675",
+      "M-198 -397C-198 -397 -130 8 334 135C798 262 866 667 866 667",
+      "M-191 -405C-191 -405 -123 0 341 127C805 254 873 659 873 659",
+      "M-184 -413C-184 -413 -116 -8 348 119C812 246 880 651 880 651",
+      "M-177 -421C-177 -421 -109 -16 355 111C819 238 887 643 887 643",
+      "M-170 -429C-170 -429 -102 -24 362 103C826 230 894 635 894 635",
+      "M-163 -437C-163 -437 -95 -32 369 95C833 222 901 627 901 627",
+      "M-156 -445C-156 -445 -88 -40 376 87C840 214 908 619 908 619",
+      "M-149 -453C-149 -453 -81 -48 383 79C847 206 915 611 915 611",
+      "M-142 -461C-142 -461 -74 -56 390 71C854 198 922 603 922 603",
+      "M-135 -469C-135 -469 -67 -64 397 63C861 190 929 595 929 595",
+      "M-128 -477C-128 -477 -60 -72 404 55C868 182 936 587 936 587",
+      "M-121 -485C-121 -485 -53 -80 411 47C875 174 943 579 943 579",
+      "M-114 -493C-114 -493 -46 -88 418 39C882 166 950 571 950 571",
+      "M-107 -501C-107 -501 -39 -96 425 31C889 158 957 563 957 563",
+      "M-100 -509C-100 -509 -32 -104 432 23C896 150 964 555 964 555",
+      "M-93 -517C-93 -517 -25 -112 439 15C903 142 971 547 971 547",
+      "M-86 -525C-86 -525 -18 -120 446 7C910 134 978 539 978 539",
+      "M-79 -533C-79 -533 -11 -128 453 -1C917 126 985 531 985 531",
+      "M-72 -541C-72 -541 -4 -136 460 -9C924 118 992 523 992 523",
+      "M-65 -549C-65 -549 3 -144 467 -17C931 110 999 515 999 515",
+      "M-58 -557C-58 -557 10 -152 474 -25C938 102 1006 507 1006 507",
+      "M-51 -565C-51 -565 17 -160 481 -33C945 94 1013 499 1013 499",
+      "M-44 -573C-44 -573 24 -168 488 -41C952 86 1020 491 1020 491",
+      "M-37 -581C-37 -581 31 -176 495 -49C959 78 1027 483 1027 483",
+    ];
 
-        {paths.map((path, index) => (
-          <motion.path
-            key={`path-${index}`}
-            d={path}
-            stroke={`url(#linearGradient-${index})`}
-            strokeOpacity='0.4'
-            strokeWidth='0.5'></motion.path>
-        ))}
-        <defs>
-          {paths.map((path, index) => (
-            <motion.linearGradient
-              id={`linearGradient-${path}-${index}`}
-              key={`gradient-${path}-${index}`}
-              initial={{
-                x1: "0%",
-                x2: "0%",
-                y1: "0%",
-                y2: "0%",
-              }}
-              animate={{
-                x1: ["0%", "100%"],
-                x2: ["0%", "95%"],
-                y1: ["0%", "100%"],
-                y2: ["0%", `${93 + Math.random() * 8}%`],
-              }}
-              transition={{
-                duration: Math.random() * 10 + 10,
-                ease: "easeInOut",
-                repeat: Infinity,
-                delay: Math.random() * 10,
-              }}>
+    return (
+      <div
+        ref={ref}
+        className={cn(styles.root, className)}
+        {...restProps}>
+        <svg
+          className={styles.svg}
+          width='100%'
+          height='100%'
+          viewBox='0 0 696 316'
+          fill='none'
+          xmlns='http://www.w3.org/2000/svg'>
+          <path
+            d='M-380 -189C-380 -189 -312 216 152 343C616 470 684 875 684 875M-373 -197C-373 -197 -305 208 159 335C623 462 691 867 691 867M-366 -205C-366 -205 -298 200 166 327C630 454 698 859 698 859M-359 -213C-359 -213 -291 192 173 319C637 446 705 851 705 851M-352 -221C-352 -221 -284 184 180 311C644 438 712 843 712 843M-345 -229C-345 -229 -277 176 187 303C651 430 719 835 719 835M-338 -237C-338 -237 -270 168 194 295C658 422 726 827 726 827M-331 -245C-331 -245 -263 160 201 287C665 414 733 819 733 819M-324 -253C-324 -253 -256 152 208 279C672 406 740 811 740 811M-317 -261C-317 -261 -249 144 215 271C679 398 747 803 747 803M-310 -269C-310 -269 -242 136 222 263C686 390 754 795 754 795M-303 -277C-303 -277 -235 128 229 255C693 382 761 787 761 787M-296 -285C-296 -285 -228 120 236 247C700 374 768 779 768 779M-289 -293C-289 -293 -221 112 243 239C707 366 775 771 775 771M-282 -301C-282 -301 -214 104 250 231C714 358 782 763 782 763M-275 -309C-275 -309 -207 96 257 223C721 350 789 755 789 755M-268 -317C-268 -317 -200 88 264 215C728 342 796 747 796 747M-261 -325C-261 -325 -193 80 271 207C735 334 803 739 803 739M-254 -333C-254 -333 -186 72 278 199C742 326 810 731 810 731M-247 -341C-247 -341 -179 64 285 191C749 318 817 723 817 723M-240 -349C-240 -349 -172 56 292 183C756 310 824 715 824 715M-233 -357C-233 -357 -165 48 299 175C763 302 831 707 831 707M-226 -365C-226 -365 -158 40 306 167C770 294 838 699 838 699M-219 -373C-219 -373 -151 32 313 159C777 286 845 691 845 691M-212 -381C-212 -381 -144 24 320 151C784 278 852 683 852 683M-205 -389C-205 -389 -137 16 327 143C791 270 859 675 859 675M-198 -397C-198 -397 -130 8 334 135C798 262 866 667 866 667M-191 -405C-191 -405 -123 0 341 127C805 254 873 659 873 659M-184 -413C-184 -413 -116 -8 348 119C812 246 880 651 880 651M-177 -421C-177 -421 -109 -16 355 111C819 238 887 643 887 643M-170 -429C-170 -429 -102 -24 362 103C826 230 894 635 894 635M-163 -437C-163 -437 -95 -32 369 95C833 222 901 627 901 627M-156 -445C-156 -445 -88 -40 376 87C840 214 908 619 908 619M-149 -453C-149 -453 -81 -48 383 79C847 206 915 611 915 611M-142 -461C-142 -461 -74 -56 390 71C854 198 922 603 922 603M-135 -469C-135 -469 -67 -64 397 63C861 190 929 595 929 595M-128 -477C-128 -477 -60 -72 404 55C868 182 936 587 936 587M-121 -485C-121 -485 -53 -80 411 47C875 174 943 579 943 579M-114 -493C-114 -493 -46 -88 418 39C882 166 950 571 950 571M-107 -501C-107 -501 -39 -96 425 31C889 158 957 563 957 563M-100 -509C-100 -509 -32 -104 432 23C896 150 964 555 964 555M-93 -517C-93 -517 -25 -112 439 15C903 142 971 547 971 547M-86 -525C-86 -525 -18 -120 446 7C910 134 978 539 978 539M-79 -533C-79 -533 -11 -128 453 -1C917 126 985 531 985 531M-72 -541C-72 -541 -4 -136 460 -9C924 118 992 523 992 523M-65 -549C-65 -549 3 -144 467 -17C931 110 999 515 999 515M-58 -557C-58 -557 10 -152 474 -25C938 102 1006 507 1006 507M-51 -565C-51 -565 17 -160 481 -33C945 94 1013 499 1013 499M-44 -573C-44 -573 24 -168 488 -41C952 86 1020 491 1020 491M-37 -581C-37 -581 31 -176 495 -49C959 78 1027 483 1027 483M-30 -589C-30 -589 38 -184 502 -57C966 70 1034 475 1034 475M-23 -597C-23 -597 45 -192 509 -65C973 62 1041 467 1041 467M-16 -605C-16 -605 52 -200 516 -73C980 54 1048 459 1048 459M-9 -613C-9 -613 59 -208 523 -81C987 46 1055 451 1055 451M-2 -621C-2 -621 66 -216 530 -89C994 38 1062 443 1062 443M5 -629C5 -629 73 -224 537 -97C1001 30 1069 435 1069 435M12 -637C12 -637 80 -232 544 -105C1008 22 1076 427 1076 427M19 -645C19 -645 87 -240 551 -113C1015 14 1083 419 1083 419'
+            stroke='url(#paint0_radial_242_278)'
+            strokeOpacity='0.05'
+            strokeWidth='0.5'
+          />
+
+          {paths.map((path, index) => {
+            const gradientId = `${id}-linear-gradient-${index}`;
+            return (
+              <motion.path
+                key={`path-${index}`}
+                d={path}
+                stroke={`url(#${gradientId})`}
+                strokeOpacity='0.4'
+                strokeWidth='0.5'
+              />
+            );
+          })}
+          <defs>
+            {paths.map((path, index) => {
+              const gradientId = `${id}-linear-gradient-${index}`;
+              return (
+                <motion.linearGradient
+                  id={gradientId}
+                  key={`gradient-${path}-${index}`}
+                  initial={{x1: "0%", x2: "0%", y1: "0%", y2: "0%"}}
+                  animate={{
+                    x1: ["0%", "100%"],
+                    x2: ["0%", "95%"],
+                    y1: ["0%", "100%"],
+                    y2: ["0%", `${93 + Math.random() * 8}%`],
+                  }}
+                  transition={{
+                    duration: Math.random() * 10 + 10,
+                    ease: "easeInOut",
+                    repeat: Infinity,
+                    delay: Math.random() * 10,
+                  }}>
+                  <stop
+                    stopColor='#18CCFC'
+                    stopOpacity='0'
+                  />
+                  <stop stopColor='#18CCFC' />
+                  <stop
+                    offset='32.5%'
+                    stopColor='#6344F5'
+                  />
+                  <stop
+                    offset='100%'
+                    stopColor='#AE48FF'
+                    stopOpacity='0'
+                  />
+                </motion.linearGradient>
+              );
+            })}
+
+            <radialGradient
+              id='paint0_radial_242_278'
+              cx='0'
+              cy='0'
+              r='1'
+              gradientUnits='userSpaceOnUse'
+              gradientTransform='translate(352 34) rotate(90) scale(555 1560.62)'>
               <stop
-                stopColor='#18CCFC'
-                stopOpacity='0'></stop>
-              <stop stopColor='#18CCFC'></stop>
+                offset='0.0666667'
+                stopColor='#d4d4d4'
+              />
               <stop
-                offset='32.5%'
-                stopColor='#6344F5'></stop>
+                offset='0.243243'
+                stopColor='#d4d4d4'
+              />
               <stop
-                offset='100%'
-                stopColor='#AE48FF'
-                stopOpacity='0'></stop>
-            </motion.linearGradient>
-          ))}
-
-          <radialGradient
-            id='paint0_radial_242_278'
-            cx='0'
-            cy='0'
-            r='1'
-            gradientUnits='userSpaceOnUse'
-            gradientTransform='translate(352 34) rotate(90) scale(555 1560.62)'>
-            <stop
-              offset='0.0666667'
-              stopColor='#d4d4d4'></stop>
-            <stop
-              offset='0.243243'
-              stopColor='#d4d4d4'></stop>
-            <stop
-              offset='0.43594'
-              stopColor='white'
-              stopOpacity='0'></stop>
-          </radialGradient>
-        </defs>
-      </svg>
-    </div>
-  );
-});
+                offset='0.43594'
+                stopColor='white'
+                stopOpacity='0'
+              />
+            </radialGradient>
+          </defs>
+        </svg>
+      </div>
+    );
+  },
+);
 
 BackgroundBeams.displayName = "BackgroundBeams";
+
+export {BackgroundBeams};

package/src/components/ui/badge.module.css

@@ -0,0 +1,60 @@
+.badge {
+  display: inline-flex;
+  align-items: center;
+  border-radius: var(--ac-radius-md);
+  padding: 0.125rem var(--ac-space-2);
+  font-size: var(--ac-text-xs);
+  font-weight: 600;
+  line-height: 1.6;
+  white-space: nowrap;
+  transition: background-color var(--ac-transition-fast), color var(--ac-transition-fast);
+
+  & svg {
+    pointer-events: none;
+    width: 0.75rem;
+    height: 0.75rem;
+    flex-shrink: 0;
+  }
+}
+
+.default {
+  background-color: var(--ac-primary);
+  color: var(--ac-primary-foreground);
+  border: 1px solid transparent;
+
+  @media (hover: hover) {
+    &:hover {
+      background-color: color-mix(in oklch, var(--ac-primary), transparent 20%);
+    }
+  }
+}
+
+.secondary {
+  background-color: var(--ac-secondary);
+  color: var(--ac-secondary-foreground);
+  border: 1px solid transparent;
+
+  @media (hover: hover) {
+    &:hover {
+      background-color: color-mix(in oklch, var(--ac-secondary), transparent 20%);
+    }
+  }
+}
+
+.destructive {
+  background-color: var(--ac-destructive);
+  color: var(--ac-background);
+  border: 1px solid transparent;
+
+  @media (hover: hover) {
+    &:hover {
+      background-color: color-mix(in oklch, var(--ac-destructive), transparent 20%);
+    }
+  }
+}
+
+.outline {
+  background-color: transparent;
+  color: var(--ac-foreground);
+  border: 1px solid var(--ac-border);
+}

package/src/components/ui/badge.tsx

@@ -1,39 +1,107 @@
-"use client";
-
-import {cva, type VariantProps} from "class-variance-authority";
 import * as React from "react";
 
 import {cn} from "@/lib/utilities";
+import styles from "./badge.module.css";
+
+/**
+ * Defines the supported visual treatments for the Badge component.
+ */
+export type BadgeVariant = "default" | "secondary" | "destructive" | "outline";
+
+/**
+ * Represents the options accepted by the internal badge class generator.
+ *
+ * @remarks
+ * This helper mirrors the public Badge styling API and exists so callers can derive
+ * consistent class names without rendering the component itself.
+ *
+ * @default variant `"default"`
+ */
+interface BadgeVariantOptions {
+  /**
+   * The visual emphasis applied to the badge surface.
+   *
+   * @default "default"
+   */
+  variant?: BadgeVariant;
+  /**
+   * Additional CSS classes merged with the generated badge classes.
+   */
+  className?: string;
+}
 
-const badgeVariants = cva(
-  "inline-flex items-center rounded-md border border-neutral-200 px-2.5 py-0.5 text-xs font-semibold transition-colors focus:outline-none focus:ring-2 focus:ring-neutral-950 focus:ring-offset-2 dark:border-neutral-800 dark:focus:ring-neutral-300",
-  {
-    variants: {
-      variant: {
-        default:
-          "border-transparent bg-neutral-900 text-neutral-50 shadow hover:bg-neutral-900/80 dark:bg-neutral-50 dark:text-neutral-900 dark:hover:bg-neutral-50/80",
-        secondary:
-          "border-transparent bg-neutral-100 text-neutral-900 hover:bg-neutral-100/80 dark:bg-neutral-800 dark:text-neutral-50 dark:hover:bg-neutral-800/80",
-        destructive:
-          "border-transparent bg-red-500 text-neutral-50 shadow hover:bg-red-500/80 dark:bg-red-900 dark:text-neutral-50 dark:hover:bg-red-900/80",
-        outline: "text-neutral-950 dark:text-neutral-50",
-      },
-    },
-    defaultVariants: {
-      variant: "default",
-    },
-  },
-);
-
-export interface BadgeProps extends React.HTMLAttributes<HTMLDivElement>, VariantProps<typeof badgeVariants> {}
-
-function Badge({className, variant, ...props}: BadgeProps) {
-  return (
-    <div
-      className={cn(badgeVariants({variant}), className)}
-      {...props}
-    />
-  );
+const variantStyles: Record<BadgeVariant, string> = {
+  default: styles.default!,
+  secondary: styles.secondary!,
+  destructive: styles.destructive!,
+  outline: styles.outline!,
+};
+
+/**
+ * Represents the configurable props for the Badge component.
+ *
+ * @remarks
+ * Extends standard `<div>` attributes so badges can expose data attributes, ARIA
+ * state, and event handlers while preserving the library's visual variants.
+ *
+ * @default variant `"default"`
+ */
+export interface BadgeProps extends React.HTMLAttributes<HTMLDivElement> {
+  /**
+   * Additional CSS classes merged with the computed badge classes.
+   */
+  className?: string;
+  /**
+   * The visual variant used to communicate importance or status.
+   *
+   * @default "default"
+   */
+  variant?: BadgeVariant;
+}
+
+/**
+ * Generates the CSS class list for a badge variant.
+ *
+ * @remarks
+ * This utility is useful when another component needs badge styling but cannot render
+ * the Badge component directly. It always includes the base badge classes.
+ *
+ * @example
+ * ```tsx
+ * <span className={badgeVariants({variant: "outline"})}>Beta</span>
+ * ```
+ *
+ * @see {@link Badge}
+ * @see {@link https://base-ui.com/react/overview Base UI documentation}
+ */
+function badgeVariants({variant = "default", className}: Readonly<BadgeVariantOptions> = {}): string {
+  return cn(styles.badge, variantStyles[variant], className);
 }
 
+/**
+ * A compact status label for surfacing metadata, categories, or state.
+ *
+ * @remarks
+ * **Rendering Context**: Server- and client-compatible presentational component.
+ *
+ * Renders a styled `<div>` with pill-like spacing and variant-driven colors.
+ * Use it for small, high-signal labels such as statuses, tags, or counters.
+ *
+ * @example
+ * ```tsx
+ * <Badge variant="secondary">New</Badge>
+ * ```
+ *
+ * @see {@link badgeVariants} — Generates matching badge classes without rendering.
+ * @see {@link https://base-ui.com/react/overview Base UI documentation}
+ */
+const Badge = React.forwardRef<HTMLDivElement, BadgeProps>(({className, variant = "default", ...props}, ref) => (
+  <div
+    ref={ref}
+    className={badgeVariants({variant, className})}
+    {...props}
+  />
+));
+Badge.displayName = "Badge";
+
 export {Badge, badgeVariants};

package/src/components/ui/breadcrumb.module.css

@@ -0,0 +1,87 @@
+.root {
+  display: block;
+}
+
+.list {
+  display: flex;
+  flex-wrap: wrap;
+  align-items: center;
+  gap: var(--ac-space-2);
+  margin: 0;
+  padding: 0;
+  list-style: none;
+  color: var(--ac-muted-foreground);
+  font-size: var(--ac-text-sm);
+  word-break: break-word;
+}
+
+@media (min-width: 640px) {
+  .list {
+    gap: calc(var(--ac-space-2) + var(--ac-space-1));
+  }
+}
+
+.item {
+  display: inline-flex;
+  align-items: center;
+  gap: var(--ac-space-2);
+  min-width: 0;
+}
+
+.link {
+  color: inherit;
+  text-decoration: none;
+  transition: color var(--ac-transition-fast);
+}
+
+@media (hover: hover) {
+  .link:hover {
+    color: var(--ac-foreground);
+  }
+}
+
+.page {
+  color: var(--ac-foreground);
+  font-weight: 500;
+}
+
+.separator {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  color: var(--ac-muted-foreground);
+  flex-shrink: 0;
+}
+
+.separator > svg {
+  width: 0.875rem;
+  height: 0.875rem;
+}
+
+.ellipsis {
+  position: relative;
+  display: inline-flex;
+  width: var(--ac-size-lg);
+  height: var(--ac-size-lg);
+  align-items: center;
+  justify-content: center;
+  color: var(--ac-muted-foreground);
+  flex-shrink: 0;
+}
+
+.ellipsis > svg {
+  width: 1rem;
+  height: 1rem;
+}
+
+.srOnly {
+  position: absolute;
+  width: 1px;
+  height: 1px;
+  padding: 0;
+  margin: -1px;
+  overflow: hidden;
+  clip: rect(0, 0, 0, 0);
+  white-space: nowrap;
+  border: 0;
+}