@coopdigital/react 0.46.0 → 0.47.0

package/dist/components/Textarea/Textarea.d.ts

@@ -1,4 +1,4 @@
-import type { JSX, TextareaHTMLAttributes } from "react";
+import type { JSX, Ref, TextareaHTMLAttributes } from "react";
 import { StandardSizes } from "../../types";
 export interface TextareaProps extends TextareaHTMLAttributes<HTMLTextAreaElement> {
     /** **(Optional)** Specify additional CSS classes to be applied to the component. */
@@ -26,10 +26,12 @@ export interface TextareaProps extends TextareaHTMLAttributes<HTMLTextAreaElemen
     name: string;
     /** **(Optional)** Specify the Textarea placeholder text. Do not use in place of a form label. */
     placeholder?: string;
+    /** **(Optional)** Specify a custom React ref for this component. */
+    ref?: Ref<HTMLTextAreaElement>;
     /** Specify the number of rows (lines of text) in the Textarea. Defaults to `4`. */
     rows?: number;
     /** **(Optional)** Specify the Textarea size. */
     size?: StandardSizes;
 }
-export declare const Textarea: ({ "aria-placeholder": ariaPlaceholder, className, cols, counter, cutoff, disabled, error, id, maxLength, name, onChange: userOnChange, placeholder, rows, size, ...props }: TextareaProps) => JSX.Element;
+export declare const Textarea: ({ "aria-placeholder": ariaPlaceholder, className, cols, counter, cutoff, disabled, error, id, maxLength, name, onChange: userOnChange, placeholder, ref, rows, size, ...props }: TextareaProps) => JSX.Element;
 export default Textarea;

package/dist/components/Textarea/Textarea.js

@@ -8,10 +8,9 @@ const DEBOUNCE_DELAY = 750;
 const charCountMessage = (remaining) => {
     return `You have ${Math.abs(remaining).toLocaleString()} ${Math.abs(remaining) === 1 ? "character" : "characters"} ${remaining < 0 ? "too many" : "remaining"}`;
 };
-const Textarea = ({ "aria-placeholder": ariaPlaceholder, className, cols = 30, counter = false, cutoff = false, disabled = false, error = false, id, maxLength, name, onChange: userOnChange = undefined, placeholder, rows = 4, size = "md", ...props }) => {
+const Textarea = ({ "aria-placeholder": ariaPlaceholder, className, cols = 30, counter = false, cutoff = false, disabled = false, error = false, id, maxLength, name, onChange: userOnChange = undefined, placeholder, ref, rows = 4, size = "md", ...props }) => {
     var _a;
-    const internalId = useId();
-    id = id !== null && id !== void 0 ? id : internalId;
+    const uid = useId(id);
     const componentProps = {
         "aria-placeholder": (_a = placeholder !== null && placeholder !== void 0 ? placeholder : ariaPlaceholder) !== null && _a !== void 0 ? _a : undefined,
         className: clsx("coop-textarea", className),
@@ -19,7 +18,7 @@ const Textarea = ({ "aria-placeholder": ariaPlaceholder, className, cols = 30, c
         "data-error": error !== null && error !== void 0 ? error : undefined,
         "data-size": size.length && size !== "md" ? size : undefined,
         disabled,
-        id,
+        id: uid,
         maxLength: cutoff ? maxLength : undefined,
         name,
         placeholder,
@@ -36,7 +35,7 @@ const Textarea = ({ "aria-placeholder": ariaPlaceholder, className, cols = 30, c
     return (jsxs("div", { className: "coop-textarea-wrapper", children: [jsx("textarea", { ...componentProps, onChange: (e) => {
                     userOnChange === null || userOnChange === void 0 ? void 0 : userOnChange(e);
                     handleChange(e);
-                } }), showCounter && (jsxs(Fragment, { children: [jsx("small", { "aria-hidden": "true", className: "coop-textarea-counter", ...(remaining < 0 && { "data-error": true }), children: charCountMessage(remaining) }), jsx("span", { "aria-live": "polite", className: "sr-only", children: charCountMessage(debouncedRemaining) })] }))] }));
+                }, ref: ref }), showCounter && (jsxs(Fragment, { children: [jsx("small", { "aria-hidden": "true", className: "coop-textarea-counter", ...(remaining < 0 && { "data-error": true }), children: charCountMessage(remaining) }), jsx("span", { "aria-live": "polite", className: "sr-only", children: charCountMessage(debouncedRemaining) })] }))] }));
 };
 
 export { Textarea, Textarea as default };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@coopdigital/react",
   "type": "module",
-  "version": "0.46.0",
+  "version": "0.47.0",
   "private": false,
   "publishConfig": {
     "access": "public"
@@ -81,5 +81,5 @@
     "@coopdigital/styles": "^0.40.0",
     "clsx": "^2.1.1"
   },
-  "gitHead": "9020e79195ead8270e9a2c39209142a02160bae5"
+  "gitHead": "f28e578e8a74f005d372677975f19a707ea643ca"
 }

package/src/components/AlertBanner/AlertBanner.tsx

@@ -1,4 +1,4 @@
-import type { HTMLAttributes, JSX, ReactNode } from "react"
+import type { HTMLAttributes, JSX, ReactNode, Ref } from "react"
 
 import clsx from "clsx"
 
@@ -9,6 +9,8 @@ export interface AlertBannerProps extends HTMLAttributes<HTMLDivElement> {
   className?: string
   /** Specify the main title of the banner, rendered as a `h2`. */
   heading: string
+  /** **(Optional)** Specify a custom React ref for this component. */
+  ref?: Ref<HTMLDivElement>
   /** **(Optional)** Specify the AlertBanner variant. */
   variant?: "black" | "default"
 }
@@ -17,6 +19,7 @@ export const AlertBanner = ({
   children,
   className,
   heading,
+  ref,
   variant = "default",
   ...props
 }: AlertBannerProps): JSX.Element => {
@@ -25,8 +28,9 @@ export const AlertBanner = ({
     "data-variant": variant,
     ...props,
   }
+
   return (
-    <aside {...componentProps}>
+    <aside {...componentProps} ref={ref}>
       <div className="coop-alert-banner--inner">
         <h2 id="coop-alert-banner--headline">{heading}</h2>
         {children}

package/src/components/Author/Author.tsx

@@ -1,4 +1,4 @@
-import type { HTMLAttributes, JSX } from "react"
+import type { HTMLAttributes, JSX, Ref } from "react"
 
 import clsx from "clsx"
 
@@ -15,6 +15,8 @@ export interface AuthorProps extends HTMLAttributes<HTMLDivElement> {
   datePrefix?: string
   /** **(Optional)** Specify properties of the Author Image. */
   image?: ImageProps
+  /** **(Optional)** Specify a custom React ref for this component. */
+  ref?: Ref<HTMLDivElement>
 }
 
 export const Author = ({
@@ -26,6 +28,7 @@ export const Author = ({
     alt: "",
     src: "https://s3.eu-west-1.amazonaws.com/assets.digital.coop.co.uk/oneweb/coop-logo-inverted.svg",
   },
+  ref,
   ...props
 }: AuthorProps): JSX.Element => {
   const imageProps: ImageProps = {
@@ -38,7 +41,7 @@ export const Author = ({
     ...props,
   }
   return (
-    <div {...componentProps}>
+    <div {...componentProps} ref={ref}>
       {image && <Image {...imageProps} />}
       <div className="coop-author--content">
         <span>

package/src/components/Button/Button.tsx

@@ -28,7 +28,7 @@ export interface ButtonProps extends ButtonHTMLAttributes<HTMLButtonElement> {
   /** **(Optional)** Callback to run when the button is pressed. If this is an async function, it will be awaited and the button will be in a pending state until the promise is resolved. */
   onClick?: React.MouseEventHandler<HTMLButtonElement | HTMLAnchorElement>
   /** **(Optional)** Specify a custom React ref for this component. */
-  ref?: Ref<HTMLButtonElement | HTMLAnchorElement>
+  ref?: Ref<HTMLElement>
   /** **(Optional)** Specify the Button size. */
   size?: "sm" | "md" | "lg"
   /** **(Optional)** Specify the Button variant. */
@@ -92,7 +92,6 @@ export const Button = ({
     "data-width": isFullWidth ? "full" : undefined,
     href,
     onClick: onClick ? handleClick : undefined,
-    ref,
     ...props,
   }
 
@@ -106,6 +105,6 @@ export const Button = ({
       children
     )
 
-  return React.createElement(element, { ...componentProps }, finalChildren)
+  return React.createElement(element, { ...componentProps, ref }, finalChildren)
 }
 export default Button

package/src/components/Card/Card.tsx

@@ -1,4 +1,4 @@
-import type { ForwardRefExoticComponent, HTMLAttributes, JSX } from "react"
+import type { ForwardRefExoticComponent, HTMLAttributes, JSX, Ref } from "react"
 
 import clsx from "clsx"
 import React from "react"
@@ -24,6 +24,8 @@ export interface CardProps extends HTMLAttributes<HTMLDivElement> {
   imagePosition?: "left" | "right"
   /** **(Optional)** Specify the orientation of the Card. */
   orientation?: "vertical" | "horizontal"
+  /** **(Optional)** Specify a custom React ref for this component. */
+  ref?: Ref<HTMLDivElement>
 }
 
 interface CardLabelProps extends HTMLAttributes<HTMLSpanElement> {
@@ -87,6 +89,7 @@ export const Card = ({
   hrefAs,
   imagePosition = "left",
   orientation = "vertical",
+  ref,
   ...props
 }: CardProps): JSX.Element => {
   const { element: linkElement, props: linkProps } = getCardLinkElement(hrefAs, href)
@@ -107,7 +110,7 @@ export const Card = ({
   }
 
   return (
-    <article {...componentProps}>
+    <article {...componentProps} ref={ref}>
       {slots.CardImage}
       {slots.CardBadge}
       {React.createElement(

package/src/components/Checkbox/Checkbox.tsx

@@ -1,4 +1,4 @@
-import type { InputHTMLAttributes, JSX } from "react"
+import type { InputHTMLAttributes, JSX, Ref } from "react"
 
 import clsx from "clsx"
 
@@ -17,6 +17,8 @@ export interface CheckboxProps
   id?: string
   /** Specify the Checkbox name. */
   name: string
+  /** **(Optional)** Specify a custom React ref for this component. */
+  ref?: Ref<HTMLInputElement>
   /** **(Optional)** Specify the Checkbox size. */
   size?: StandardSizes
 }
@@ -27,6 +29,7 @@ export const Checkbox = ({
   error = false,
   id,
   name,
+  ref,
   size = "md",
   ...props
 }: CheckboxProps): JSX.Element => {
@@ -41,7 +44,8 @@ export const Checkbox = ({
     type: "checkbox",
     ...props,
   }
-  return <input {...componentProps} />
+
+  return <input {...componentProps} ref={ref} />
 }
 
 export default Checkbox

package/src/components/Expandable/Expandable.tsx

@@ -1,4 +1,4 @@
-import type { DetailsHTMLAttributes, HTMLAttributes, JSX } from "react"
+import type { DetailsHTMLAttributes, HTMLAttributes, JSX, Ref } from "react"
 
 import { clsx } from "clsx"
 
@@ -11,6 +11,8 @@ export interface ExpandableProps extends DetailsHTMLAttributes<HTMLDetailsElemen
   children: React.ReactNode
   /** **(Optional)** Specify additional CSS classes to be applied to the component. */
   className?: string
+  /** **(Optional)** Specify a custom React ref for this component. */
+  ref?: Ref<HTMLDetailsElement>
 }
 
 interface ExpandableSummaryProps extends HTMLAttributes<HTMLElement> {
@@ -25,7 +27,12 @@ const componentSlots = {
   ExpandableSummary: null,
 }
 
-export const Expandable = ({ children, className, ...props }: ExpandableProps): JSX.Element => {
+export const Expandable = ({
+  children,
+  className,
+  ref,
+  ...props
+}: ExpandableProps): JSX.Element => {
   const slots = useSlots(componentSlots, children)
 
   const componentProps = {
@@ -38,7 +45,7 @@ export const Expandable = ({ children, className, ...props }: ExpandableProps):
   }
 
   return (
-    <details {...componentProps}>
+    <details {...componentProps} ref={ref}>
       {slots.ExpandableSummary}
       <div className="coop-expandable--content">{slots.Children}</div>
     </details>

package/src/components/Field/Field.tsx

@@ -1,4 +1,4 @@
-import type { HTMLAttributes, HTMLProps, JSX } from "react"
+import type { HTMLAttributes, HTMLProps, JSX, Ref } from "react"
 
 import clsx from "clsx"
 import React from "react"
@@ -37,6 +37,8 @@ interface FieldProps extends HTMLAttributes<HTMLDivElement> {
   error?: boolean
   /** **(Optional)** Specify whether the Field should show the left-hand error bar if it is in an error state. */
   hideErrorBar?: boolean
+  /** **(Optional)** Specify a custom React ref for this component. */
+  ref?: Ref<HTMLDivElement>
 }
 
 const Root = ({
@@ -45,19 +47,18 @@ const Root = ({
   className,
   error = false,
   hideErrorBar = false,
+  ref,
   ...props
 }: FieldProps) => {
   const slots = { ...useSlots(componentSlots, children) }
   const slotsArray = Object.entries(slots)
 
-  const uid = useId()
-
   const isInlineControl = slotsArray.some((s) => s[1] !== null && inlineFields.includes(s[0]))
   const hasFieldMarkers = !!(slots.FieldLabel ?? slots.FieldError ?? slots.FieldHint)
   const [, control] =
     slotsArray.find((s) => (!standardFields.includes(s[0]) && s[1] !== null ? s : null)) ?? []
 
-  let controlId = uid
+  let controlId = useId()
   let controlDisabled = false
 
   if (control) {
@@ -88,7 +89,7 @@ const Root = ({
   }
 
   return (
-    <div {...componentProps}>
+    <div {...componentProps} ref={ref}>
       {!isInlineControl && hasFieldMarkers && (
         <div className="coop-field-markers">
           {slots.FieldLabel}

package/src/components/FieldMarkers/Error.tsx

@@ -1,4 +1,4 @@
-import type { HTMLAttributes, JSX, ReactNode } from "react"
+import type { HTMLAttributes, JSX, ReactNode, Ref } from "react"
 
 import clsx from "clsx"
 
@@ -7,14 +7,20 @@ export interface ErrorProps extends HTMLAttributes<HTMLSpanElement> {
   children?: string | ReactNode
   /** **(Optional)** Specify additional CSS classes to be applied to the component. */
   className?: string
+  /** **(Optional)** Specify a custom React ref for this component. */
+  ref?: Ref<HTMLSpanElement>
 }
 
-export const Error = ({ children, className, ...props }: ErrorProps): JSX.Element => {
+export const Error = ({ children, className, ref, ...props }: ErrorProps): JSX.Element => {
   const componentProps = {
     className: clsx("coop-field-error ", className),
     ...props,
   }
-  return <span {...componentProps}>{children}</span>
+  return (
+    <span {...componentProps} ref={ref}>
+      {children}
+    </span>
+  )
 }
 
 export default Error

package/src/components/FieldMarkers/Hint.tsx

@@ -1,21 +1,27 @@
-import type { HTMLAttributes, JSX, ReactNode } from "react"
+import type { HTMLAttributes, JSX, ReactNode, Ref } from "react"
 
 import clsx from "clsx"
 
-export interface HintProps extends HTMLAttributes<HTMLParagraphElement> {
+export interface HintProps extends HTMLAttributes<HTMLDivElement> {
   /** **(Optional)** Hint text for the form element. Accepts any valid JSX or string. */
   children?: string | ReactNode
   /** **(Optional)** Specify additional CSS classes to be applied to the component. */
   className?: string
+  /** **(Optional)** Specify a custom React ref for this component. */
+  ref?: Ref<HTMLDivElement>
 }
 
-export const Hint = ({ children, className, ...props }: HintProps): JSX.Element | null => {
+export const Hint = ({ children, className, ref, ...props }: HintProps): JSX.Element | null => {
   const componentProps = {
     className: clsx("coop-field-hint ", className),
     ...props,
   }
 
-  return children ? <div {...componentProps}>{children}</div> : null
+  return (
+    <div {...componentProps} ref={ref}>
+      {children}
+    </div>
+  )
 }
 
 export default Hint

package/src/components/FieldMarkers/Label.tsx

@@ -1,5 +1,5 @@
 import clsx from "clsx"
-import { LabelHTMLAttributes } from "react"
+import { LabelHTMLAttributes, Ref } from "react"
 
 export interface LabelProps extends LabelHTMLAttributes<HTMLLabelElement> {
   /** **(Optional)** Main label for the form element. Accepts any valid JSX or string. */
@@ -8,11 +8,17 @@ export interface LabelProps extends LabelHTMLAttributes<HTMLLabelElement> {
   className?: string
   /** **(Optional)** Specify whether the label is visible for humans or only for screen readers. */
   isVisible?: boolean
+  /** **(Optional)** Specify a custom React ref for this component. */
+  ref?: Ref<HTMLLabelElement>
 }
 
-export const Label = ({ children, className, isVisible = true, ...props }: LabelProps) => {
+export const Label = ({ children, className, isVisible = true, ref, ...props }: LabelProps) => {
+  const componentProps = {
+    className: clsx("coop-field-label", !isVisible && "sr-only", className),
+    ...props,
+  }
   return (
-    <label {...props} className={clsx("coop-field-label", !isVisible && "sr-only", className)}>
+    <label {...componentProps} ref={ref}>
       <span>{children}</span>
     </label>
   )

package/src/components/FieldMarkers/Legend.tsx

@@ -1,5 +1,5 @@
 import clsx from "clsx"
-import { HTMLAttributes } from "react"
+import { HTMLAttributes, Ref } from "react"
 
 export interface LegendProps extends HTMLAttributes<HTMLLegendElement> {
   /** **(Optional)** Main legend for the fieldset. Accepts any valid JSX or string. */
@@ -8,9 +8,11 @@ export interface LegendProps extends HTMLAttributes<HTMLLegendElement> {
   className?: string
   /** **(Optional)** Specify whether the legend should be visible to humans or screen readers. */
   isVisible?: boolean
+  /** **(Optional)** Specify a custom React ref for this component. */
+  ref?: Ref<HTMLLegendElement>
 }
 
-export const Legend = ({ children, className, isVisible = true, ...props }: LegendProps) => {
+export const Legend = ({ children, className, isVisible = true, ref, ...props }: LegendProps) => {
   const componentProps = {
     "aria-hidden": true,
     className: clsx("coop-field-label", !isVisible && "sr-only", className),
@@ -20,7 +22,11 @@ export const Legend = ({ children, className, isVisible = true, ...props }: Lege
   return (
     <>
       <legend className="sr-only">{children}</legend>
-      {isVisible && <div {...componentProps}>{children}</div>}
+      {isVisible && (
+        <div {...componentProps} ref={ref}>
+          {children}
+        </div>
+      )}
     </>
   )
 }

package/src/components/Fieldset/Fieldset.tsx

@@ -1,5 +1,5 @@
 import clsx from "clsx"
-import { type FieldsetHTMLAttributes, type JSX } from "react"
+import { type FieldsetHTMLAttributes, type JSX, Ref } from "react"
 
 import { StandardSizes } from "../../../src/types"
 import { Error as BaseError, type ErrorProps } from "../FieldMarkers/Error"
@@ -19,6 +19,8 @@ export interface FieldsetProps extends FieldsetHTMLAttributes<HTMLFieldSetElemen
   error?: boolean
   /** **(Optional)** Specify whether the Fieldset should show the left-hand error bar if it is in an error state. */
   hideErrorBar?: boolean
+  /** **(Optional)** Specify a custom React ref for this component. */
+  ref?: Ref<HTMLFieldSetElement>
   /** **(Optional)** Specify the size of the Fieldset and all its descendents. */
   size?: StandardSizes
 }
@@ -28,6 +30,7 @@ const Root = ({
   disabled,
   error = false,
   hideErrorBar = false,
+  ref,
   size = "md",
   ...props
 }: FieldsetProps): JSX.Element => {
@@ -35,15 +38,17 @@ const Root = ({
     "aria-disabled": disabled,
     className: clsx("coop-fieldset", className),
     "data-error": error || undefined,
-    //"data-variant": variant !== "default" ? variant : undefined,
     "data-hide-error": hideErrorBar || undefined,
-    // "data-orientation": orientation !== "vertical" ? orientation : undefined,
     "data-size": size.length && size !== "md" ? size : undefined,
     disabled,
     ...props,
   }
 
-  return <fieldset {...componentProps}>{children}</fieldset>
+  return (
+    <fieldset {...componentProps} ref={ref}>
+      {children}
+    </fieldset>
+  )
 }
 
 interface FieldsetFieldsProps {

package/src/components/Flourish/Flourish.tsx

@@ -1,4 +1,4 @@
-import type { JSX, ReactNode, SVGProps } from "react"
+import type { JSX, ReactNode, Ref, SVGProps } from "react"
 
 import clsx from "clsx"
 
@@ -11,12 +11,15 @@ export interface FlourishProps extends SVGProps<SVGSVGElement> {
   className?: string
   /** **(Optional)** Specify the Flourish color. */
   fill?: Darks | Lights | Tints | OfferRed | BrandBlue | White | Black
+  /** **(Optional)** Specify a custom React ref for this component. */
+  ref?: Ref<SVGSVGElement>
 }
 
 export const Flourish = ({
   children,
   className,
   fill = "brand-blue",
+  ref,
   ...props
 }: FlourishProps): JSX.Element => {
   const componentProps = {
@@ -28,7 +31,7 @@ export const Flourish = ({
   return (
     <span style={{ position: "relative" }}>
       {children}
-      <svg {...componentProps} viewBox="0 0 276 10">
+      <svg {...componentProps} ref={ref} viewBox="0 0 276 10">
         <path d="M275.9 8.6c.1-1.6.2-1.8-.4-2.9.3-1-.3-1.2-1.8-1.1v-.3c.6-.4.2-.2 1.4-.1-.9-2.3-5.6-1.8-8.5-2.3C259 .5 246.3.7 237.4.5L185 .4l-33-.2-26.1-.2-67.4 1.2-44.3.5C10.7 2.1 1.5.4 0 3.3l1 .2L0 4v.5C8.2 7.9 26.6 7.2 35.6 7c5 0 13.5 1.6 16.5-.6C53.4 8 59.5 8 62 7.7l45 .1 42.8.3 30.7.3 44.2.6 27.8-.5 23 .8c.1-.8-.3-.5.5-.7ZM219 2.8v-.2l.8-.2h.4l.3.4H219Zm30-.1h1.2c-.8.4-.5.3-1.2 0Zm6.2.6.2-.4h.3l-.5.4Z" />
       </svg>
     </span>

package/src/components/Icon/AddIcon.tsx

@@ -1,24 +1,27 @@
 import clsx from "clsx"
-import { type SVGProps, useId } from "react"
+import { type SVGProps } from "react"
+
+import { useId } from "../../hooks/useId"
 
 interface IconProps extends SVGProps<SVGSVGElement> {
   alt?: string
 }
 
-export const AddIcon = ({ alt, className, fill, ...props }: IconProps) => {
-  const id = useId()
+export const AddIcon = ({ alt, className, fill, id, ref, ...props }: IconProps) => {
+  const uid = useId(id)
   const componentProps = {
-    "aria-labelledby": alt ? id : undefined,
+    "aria-labelledby": alt ? uid + "-title" : undefined,
     className: clsx("coop-icon", className),
     "data-icon": "add",
     fill: fill ?? "none",
+    id: uid,
     role: alt ? "img" : undefined,
     viewBox: "0 0 32 32",
     ...props,
   }
   return (
-    <svg {...componentProps}>
-      {alt ? <title id={id}>{alt}</title> : null}
+    <svg {...componentProps} ref={ref}>
+      {alt ? <title id={uid + "-title"}>{alt}</title> : null}
       <path
         d="M24.7 16.72a1 1 0 0 1-.7.28H8a1 1 0 1 1 0-2h16a1 1 0 0 1 1 1 1 1 0 0 1-.3.72"
         fill={fill ?? "currentColor"}

package/src/components/Icon/ArrowDownIcon.tsx

@@ -1,24 +1,27 @@
 import clsx from "clsx"
-import { type SVGProps, useId } from "react"
+import { type SVGProps } from "react"
+
+import { useId } from "../../hooks/useId"
 
 interface IconProps extends SVGProps<SVGSVGElement> {
   alt?: string
 }
 
-export const ArrowDownIcon = ({ alt, className, fill, ...props }: IconProps) => {
-  const id = useId()
+export const ArrowDownIcon = ({ alt, className, fill, id, ref, ...props }: IconProps) => {
+  const uid = useId(id)
   const componentProps = {
-    "aria-labelledby": alt ? id : undefined,
+    "aria-labelledby": alt ? uid + "-title" : undefined,
     className: clsx("coop-icon", className),
     "data-icon": "arrow-down",
     fill: fill ?? "none",
+    id: uid,
     role: alt ? "img" : undefined,
     viewBox: "0 0 32 32",
     ...props,
   }
   return (
-    <svg {...componentProps}>
-      {alt ? <title id={id}>{alt}</title> : null}
+    <svg {...componentProps} ref={ref}>
+      {alt ? <title id={uid + "-title"}>{alt}</title> : null}
       <path d="M15 28.66V3a1 1 0 0 1 2 0v25.66a1 1 0 0 1-2 0" fill={fill ?? "currentColor"} />
       <path
         d="M3 17a1 1 0 0 1 .29-.71 1 1 0 0 1 1.42 0L16 27.58l11.29-11.29a1 1 0 0 1 1.42 0 1 1 0 0 1 0 1.41l-12 12a1 1 0 0 1-1.41 0l-12-12A1 1 0 0 1 3 17"

package/src/components/Icon/ArrowLeftIcon.tsx

@@ -1,24 +1,27 @@
 import clsx from "clsx"
-import { type SVGProps, useId } from "react"
+import { type SVGProps } from "react"
+
+import { useId } from "../../hooks/useId"
 
 interface IconProps extends SVGProps<SVGSVGElement> {
   alt?: string
 }
 
-export const ArrowLeftIcon = ({ alt, className, fill, ...props }: IconProps) => {
-  const id = useId()
+export const ArrowLeftIcon = ({ alt, className, fill, id, ref, ...props }: IconProps) => {
+  const uid = useId(id)
   const componentProps = {
-    "aria-labelledby": alt ? id : undefined,
+    "aria-labelledby": alt ? uid + "-title" : undefined,
     className: clsx("coop-icon", className),
     "data-icon": "arrow-left",
     fill: fill ?? "none",
+    id: uid,
     role: alt ? "img" : undefined,
     viewBox: "0 0 32 32",
     ...props,
   }
   return (
-    <svg {...componentProps}>
-      {alt ? <title id={id}>{alt}</title> : null}
+    <svg {...componentProps} ref={ref}>
+      {alt ? <title id={uid + "-title"}>{alt}</title> : null}
       <path d="M3.34 17H29a1 1 0 0 0 0-2H3.34a1 1 0 0 0 0 2" fill={fill ?? "currentColor"} />
       <path
         d="M15 29a1 1 0 0 0 .71-.29 1 1 0 0 0 0-1.42L5.12 16.71a1 1 0 0 1 0-1.42L15.71 4.71a1 1 0 0 0 0-1.42 1 1 0 0 0-1.41 0l-12 12a1 1 0 0 0 0 1.42l12 12a1 1 0 0 0 .7.29"

package/src/components/Icon/ArrowRightIcon.tsx

@@ -1,24 +1,27 @@
 import clsx from "clsx"
-import { type SVGProps, useId } from "react"
+import { type SVGProps } from "react"
+
+import { useId } from "../../hooks/useId"
 
 interface IconProps extends SVGProps<SVGSVGElement> {
   alt?: string
 }
 
-export const ArrowRightIcon = ({ alt, className, fill, ...props }: IconProps) => {
-  const id = useId()
+export const ArrowRightIcon = ({ alt, className, fill, id, ref, ...props }: IconProps) => {
+  const uid = useId(id)
   const componentProps = {
-    "aria-labelledby": alt ? id : undefined,
+    "aria-labelledby": alt ? uid + "-title" : undefined,
     className: clsx("coop-icon", className),
     "data-icon": "arrow-right",
     fill: fill ?? "none",
+    id: uid,
     role: alt ? "img" : undefined,
     viewBox: "0 0 32 32",
     ...props,
   }
   return (
-    <svg {...componentProps}>
-      {alt ? <title id={id}>{alt}</title> : null}
+    <svg {...componentProps} ref={ref}>
+      {alt ? <title id={uid + "-title"}>{alt}</title> : null}
       <path d="M28.7 15H3a1 1 0 0 0 0 2h25.7a1 1 0 0 0 0-2" fill={fill ?? "currentColor"} />
       <path
         d="M17 3a1 1 0 0 0-.7.3 1 1 0 0 0 0 1.4l10.6 10.6a1 1 0 0 1 0 1.4L16.3 27.3a1 1 0 0 0 0 1.4 1 1 0 0 0 1.4 0l12-12a1 1 0 0 0 0-1.4l-12-12A1 1 0 0 0 17 3"