@coopdigital/react 0.35.0 → 0.37.0

package/dist/components/Card/Card.d.ts

@@ -31,8 +31,8 @@ export interface CardProps extends HTMLAttributes<HTMLDivElement> {
     label?: string;
     /** **(Optional)** Specify the background color of the Card label. */
     labelBackground?: Lights;
-    /** **(Optional)** Specify the layout of the Card. */
-    layout?: "vertical" | "horizontal";
+    /** **(Optional)** Specify the orientation of the Card. */
+    orientation?: "vertical" | "horizontal";
 }
-export declare const Card: ({ as, background, badge, badgePosition, chevron, children, className, heading, headingLevel, href, image, imagePosition, label, labelBackground, layout, ...props }: CardProps) => JSX.Element;
+export declare const Card: ({ as, background, badge, badgePosition, chevron, children, className, heading, headingLevel, href, image, imagePosition, label, labelBackground, orientation, ...props }: CardProps) => JSX.Element;
 export default Card;

package/dist/components/Card/Card.js

@@ -18,7 +18,7 @@ function getCardLinkElement(as, href) {
         },
     };
 }
-const Card = ({ as, background = "white", badge, badgePosition = "inset", chevron = false, children, className, heading, headingLevel = "h3", href, image, imagePosition = "left", label = "", labelBackground, layout = "vertical", ...props }) => {
+const Card = ({ as, background = "white", badge, badgePosition = "inset", chevron = false, children, className, heading, headingLevel = "h3", href, image, imagePosition = "left", label = "", labelBackground, orientation = "vertical", ...props }) => {
     const linkElement = getCardLinkElement(as, href);
     const imageProps = {
         crop: "wide",
@@ -28,7 +28,7 @@ const Card = ({ as, background = "white", badge, badgePosition = "inset", chevro
         className: clsx("coop-card", background && bgPropToClass(background, className), className),
         "data-badge-pos": badgePosition,
         "data-image-pos": imagePosition,
-        "data-layout": layout !== "vertical" ? layout : undefined,
+        "data-orientation": orientation !== "vertical" ? orientation : undefined,
         ...props,
     };
     return (jsxs("article", { ...componentProps, children: [image && jsx(Image, { ...imageProps }), badge && jsx("div", { className: "coop-card--badge", children: badge }), jsxs("div", { className: "coop-card--inner", children: [jsxs("div", { className: "coop-card--content", children: [label && (jsx("span", { className: clsx("coop-card--label", labelBackground && bgPropToClass(labelBackground, className)), children: label })), React.createElement(linkElement.element, linkElement.props, React.createElement(headingLevel, { className: "coop-card--heading" }, heading)), children] }), chevron && (jsx("span", { "aria-hidden": "true", className: "coop-card--icon", role: "presentation", children: jsx(ChevronRightIcon, {}) }))] })] }));

package/dist/components/Checkbox/Checkbox.d.ts

@@ -23,10 +23,8 @@ export interface CheckboxProps extends Omit<InputHTMLAttributes<HTMLInputElement
     labelVisible?: boolean;
     /** Specify the Checkbox name. */
     name: string;
-    /** **(Optional)** Specify the Checkbox placeholder text. Do not use in place of a form label. */
-    placeholder?: string;
     /** **(Optional)** Specify the Checkbox size. */
     size?: StandardSizes;
 }
-export declare const Checkbox: ({ "aria-placeholder": ariaPlaceholder, className, error, hint, id, label, labelVisible, name, placeholder, size, ...props }: CheckboxProps) => JSX.Element;
+export declare const Checkbox: ({ className, error, hint, id, label, labelVisible, name, size, ...props }: CheckboxProps) => JSX.Element;
 export default Checkbox;

package/dist/components/Checkbox/Checkbox.js

@@ -5,18 +5,15 @@ import { FieldError } from '../FieldError/FieldError.js';
 import { FieldHint } from '../FieldHint/FieldHint.js';
 import { FieldLabel } from '../FieldLabel/FieldLabel.js';
 
-const Checkbox = ({ "aria-placeholder": ariaPlaceholder, className, error = false, hint, id, label, labelVisible = true, name, placeholder, size = "md", ...props }) => {
-    var _a;
+const Checkbox = ({ className, error = false, hint, id, label, labelVisible = true, name, size = "md", ...props }) => {
     const internalId = useId();
     id = id !== null && id !== void 0 ? id : internalId;
     const componentProps = {
-        "aria-placeholder": (_a = placeholder !== null && placeholder !== void 0 ? placeholder : ariaPlaceholder) !== null && _a !== void 0 ? _a : undefined,
         className: clsx("coop-checkbox", className),
         "data-error": error ? "" : undefined,
         "data-size": size.length && size !== "md" ? size : undefined,
         id,
         name,
-        placeholder,
         type: "checkbox",
         ...props,
     };

package/dist/components/Checkbox/CheckboxGroup.d.ts

@@ -19,8 +19,10 @@ export interface CheckboxGroupProps extends FieldsetHTMLAttributes<HTMLFieldSetE
     label?: string;
     /** **(Optional)** Specify whether the label should be visible to humans or screen readers. */
     labelVisible?: boolean;
+    /** **(Optional)** Specify the CheckboxGroup orientation. */
+    orientation?: "horizontal" | "vertical";
     /** **(Optional)** Specify the CheckboxGroup size. */
     size?: StandardSizes;
 }
-export declare const CheckboxGroup: ({ children, className, error, hint, label, labelVisible, size, ...props }: CheckboxGroupProps) => JSX.Element;
+export declare const CheckboxGroup: ({ children, className, error, hint, label, labelVisible, orientation, size, ...props }: CheckboxGroupProps) => JSX.Element;
 export default CheckboxGroup;

package/dist/components/Checkbox/CheckboxGroup.js

@@ -3,17 +3,18 @@ import { clsx } from '../../node_modules/clsx/dist/clsx.js';
 import { FieldError } from '../FieldError/FieldError.js';
 import { FieldHint } from '../FieldHint/FieldHint.js';
 
-const CheckboxGroup = ({ children, className, error = false, hint, label, labelVisible = true, size = "md", ...props }) => {
+const CheckboxGroup = ({ children, className, error = false, hint, label, labelVisible = true, orientation = "vertical", size = "md", ...props }) => {
     const componentProps = {
         className: clsx("coop-fieldset", "coop-checkbox-group", className),
         "data-error": error ? "" : undefined,
+        "data-orientation": orientation !== "vertical" ? orientation : undefined,
         "data-size": size.length && size !== "md" ? size : undefined,
         ...props,
     };
     const legendProps = {
         className: clsx("coop-field-label", !labelVisible && "sr-only"),
     };
-    return (jsxs("fieldset", { ...componentProps, children: [label && jsx("legend", { ...legendProps, children: label }), hint && jsx(FieldHint, { children: hint }), typeof error === "object" && (error === null || error === void 0 ? void 0 : error.message) && jsx(FieldError, { children: error.message }), children] }));
+    return (jsxs("fieldset", { ...componentProps, children: [label && jsx("legend", { ...legendProps, children: label }), hint && jsx(FieldHint, { children: hint }), typeof error === "object" && (error === null || error === void 0 ? void 0 : error.message) && jsx(FieldError, { children: error.message }), jsx("div", { className: "coop-checkbox-group-options", children: children })] }));
 };
 
 export { CheckboxGroup, CheckboxGroup as default };

package/dist/components/Checkbox/index.d.ts

@@ -1,4 +1,5 @@
 import Checkbox from "./Checkbox";
+import CheckboxGroup from "./CheckboxGroup";
 export default Checkbox;
-export { Checkbox };
+export { Checkbox, CheckboxGroup };
 export * from "./Checkbox";

package/dist/components/RadioButton/RadioButton.d.ts

@@ -0,0 +1,37 @@
+import { type InputHTMLAttributes, type JSX } from "react";
+import { FormFieldError, StandardSizes } from "src/types";
+import { TagProps } from "../Tag";
+export interface RadioButtonProps extends Omit<InputHTMLAttributes<HTMLInputElement>, "size" | "type"> {
+    /** **(Optional)** Specify additional CSS classes to be applied to the component. */
+    className?: string;
+    /** **(Optional)** Specify the RadioButton error state.
+     *
+     * This is an instance of `FormFieldError`. You can provide either an object with a `message` key, or a boolean value if you need to render the message independently.
+     */
+    error?: FormFieldError;
+    /** **(Optional)** Specify the RadioButton hint.
+     *
+     * This text is rendered under the label to provide further guidance for users.
+     */
+    hint?: string;
+    /** **(Optional)** Specify the RadioButton id. Will be auto-generated if not set. */
+    id?: string;
+    /** **(Optional)** Specify the RadioButton label.
+     *
+     * This property is optional in case you need to render your own label, but all form elements *must* provide a label. */
+    label: string;
+    /** **(Optional)** Specify whether the label should be visible to humans or screen readers. */
+    labelVisible?: boolean;
+    /** Specify the RadioButton name. */
+    name: string;
+    /** **(Optional)** Specify the RadioButton size. */
+    size?: StandardSizes;
+    /** **(Optional)** Specify the RadioButton tag text. */
+    tag?: string;
+    /** **(Optional)** Specify the RadioButton tag background color. */
+    tagBackground?: TagProps["background"];
+    /** **(Optional)** Specify the RadioButton variant. */
+    variant?: "default" | "boxed";
+}
+export declare const RadioButton: ({ className, error, hint, id, label, labelVisible, name, size, tag, tagBackground, variant, ...props }: RadioButtonProps) => JSX.Element;
+export default RadioButton;

package/dist/components/RadioButton/RadioButton.js

@@ -0,0 +1,25 @@
+import { jsxs, jsx } from 'react/jsx-runtime';
+import { clsx } from '../../node_modules/clsx/dist/clsx.js';
+import { useId } from 'react';
+import { FieldError } from '../FieldError/FieldError.js';
+import { FieldHint } from '../FieldHint/FieldHint.js';
+import { FieldLabel } from '../FieldLabel/FieldLabel.js';
+import { Tag } from '../Tag/Tag.js';
+
+const RadioButton = ({ className, error = false, hint, id, label, labelVisible = true, name, size = "md", tag, tagBackground, variant = "default", ...props }) => {
+    const internalId = useId();
+    id = id !== null && id !== void 0 ? id : internalId;
+    const componentProps = {
+        className: clsx("coop-radio-button", className),
+        "data-error": error ? "" : undefined,
+        "data-size": size.length && size !== "md" ? size : undefined,
+        "data-variant": variant !== "default" ? variant : undefined,
+        id,
+        name,
+        type: "radio",
+        ...props,
+    };
+    return (jsxs("div", { className: "coop-form-item", children: [jsxs("div", { className: "coop-radio-button-wrapper", children: [jsx("input", { ...componentProps }), label && (jsxs(FieldLabel, { htmlFor: id, isVisible: labelVisible, children: [jsx("span", { children: label }), " ", tag && (jsx(Tag, { background: tagBackground, size: "sm", children: tag }))] })), hint && jsx(FieldHint, { children: hint })] }), typeof error === "object" && (error === null || error === void 0 ? void 0 : error.message) && jsx(FieldError, { children: error.message })] }));
+};
+
+export { RadioButton, RadioButton as default };

package/dist/components/RadioButton/RadioButtonGroup.d.ts

@@ -0,0 +1,30 @@
+import type { FieldsetHTMLAttributes, JSX } from "react";
+import { FormFieldError, StandardSizes } from "../../types";
+export interface RadioButtonGroupProps extends FieldsetHTMLAttributes<HTMLFieldSetElement> {
+    /** **(Optional)** Main content inside the component. It can be any valid JSX or string. */
+    children?: React.ReactNode;
+    /** **(Optional)** Specify additional CSS classes to be applied to the component. */
+    className?: string;
+    /** **(Optional)** Specify the RadioButtonGroup error state.
+     *
+     * This is an instance of `FormFieldError`. You can provide either an object with a `message` key, or a boolean value if you need to render the message independently.
+     */
+    error?: FormFieldError;
+    /** **(Optional)** Specify the RadioButtonGroup hint.
+     *
+     * This text is rendered under the label to provide further guidance for users.
+     */
+    hint?: string;
+    /** **(Optional)** Specify the label for the RadioButtonGroup. This will be rendered as a fieldset legend. */
+    label?: string;
+    /** **(Optional)** Specify whether the label should be visible to humans or screen readers. */
+    labelVisible?: boolean;
+    /** **(Optional)** Specify the RadioButtonGroup orientation. */
+    orientation?: "horizontal" | "vertical";
+    /** **(Optional)** Specify the RadioButtonGroup size. */
+    size?: StandardSizes;
+    /** **(Optional)** Specify the RadioButtonGroup variant. */
+    variant?: "default" | "boxed";
+}
+export declare const RadioButtonGroup: ({ children, className, error, hint, label, labelVisible, orientation, size, variant, ...props }: RadioButtonGroupProps) => JSX.Element;
+export default RadioButtonGroup;

package/dist/components/RadioButton/RadioButtonGroup.js

@@ -0,0 +1,21 @@
+import { jsxs, jsx } from 'react/jsx-runtime';
+import { clsx } from '../../node_modules/clsx/dist/clsx.js';
+import { FieldError } from '../FieldError/FieldError.js';
+import { FieldHint } from '../FieldHint/FieldHint.js';
+
+const RadioButtonGroup = ({ children, className, error = false, hint, label, labelVisible = true, orientation = "vertical", size = "md", variant = "default", ...props }) => {
+    const componentProps = {
+        className: clsx("coop-fieldset", "coop-radio-button-group", className),
+        "data-error": error ? "" : undefined,
+        "data-orientation": orientation !== "vertical" ? orientation : undefined,
+        "data-size": size.length && size !== "md" ? size : undefined,
+        "data-variant": variant !== "default" ? variant : undefined,
+        ...props,
+    };
+    const legendProps = {
+        className: clsx("coop-field-label", !labelVisible && "sr-only"),
+    };
+    return (jsxs("fieldset", { ...componentProps, children: [label && jsx("legend", { ...legendProps, children: label }), hint && jsx(FieldHint, { children: hint }), typeof error === "object" && (error === null || error === void 0 ? void 0 : error.message) && jsx(FieldError, { children: error.message }), jsx("div", { className: "coop-radio-button-group-options", children: children })] }));
+};
+
+export { RadioButtonGroup, RadioButtonGroup as default };

package/dist/components/RadioButton/index.d.ts

@@ -0,0 +1,5 @@
+import RadioButton from "./RadioButton";
+import RadioButtonGroup from "./RadioButtonGroup";
+export default RadioButton;
+export { RadioButton, RadioButtonGroup };
+export * from "./RadioButton";

package/dist/components/Tag/Tag.d.ts

@@ -12,6 +12,8 @@ export interface TagProps extends HTMLAttributes<HTMLAnchorElement> {
     className?: string;
     /** **(Optional)** Specify the URL that the Tag component will link to when clicked. */
     href?: string;
+    /** **(Optional)** Specify the Tag size. */
+    size?: "sm" | "md";
 }
-export declare const Tag: ({ as, background, children, className, href, ...props }: TagProps) => JSX.Element;
+export declare const Tag: ({ as, background, children, className, href, size, ...props }: TagProps) => JSX.Element;
 export default Tag;

package/dist/components/Tag/Tag.js

@@ -2,10 +2,11 @@ import { clsx } from '../../node_modules/clsx/dist/clsx.js';
 import React from 'react';
 import { bgPropToClass } from '../../utils/index.js';
 
-const Tag = ({ as, background = "tint-grey", children, className, href, ...props }) => {
+const Tag = ({ as, background = "tint-grey", children, className, href, size = "md", ...props }) => {
     let element = href ? "a" : "span";
     const componentProps = {
         className: clsx("coop-tag", bgPropToClass(background, className), className),
+        "data-size": size.length && size !== "md" ? size : undefined,
         href,
         ...props,
     };

package/dist/components/Tag/index.js

@@ -0,0 +1,5 @@
+import { Tag } from './Tag.js';
+
+
+
+export { Tag, Tag as default };

package/dist/index.d.ts

@@ -3,7 +3,6 @@ export * from "./components/Author";
 export * from "./components/Button";
 export * from "./components/Card";
 export * from "./components/Checkbox";
-export * from "./components/Checkbox/CheckboxGroup";
 export * from "./components/Expandable";
 export * from "./components/Field";
 export * from "./components/FieldError";
@@ -12,6 +11,7 @@ export * from "./components/FieldLabel";
 export * from "./components/Flourish";
 export * from "./components/Image";
 export * from "./components/Pill";
+export * from "./components/RadioButton";
 export * from "./components/RootSVG";
 export * from "./components/SearchBox";
 export * from "./components/Signpost";

package/dist/index.js

@@ -12,6 +12,8 @@ export { FieldLabel } from './components/FieldLabel/FieldLabel.js';
 export { Flourish } from './components/Flourish/Flourish.js';
 export { Image } from './components/Image/Image.js';
 export { Pill } from './components/Pill/Pill.js';
+export { RadioButton } from './components/RadioButton/RadioButton.js';
+export { RadioButtonGroup } from './components/RadioButton/RadioButtonGroup.js';
 export { RootSVG } from './components/RootSVG/RootSVG.js';
 export { SearchBox } from './components/SearchBox/SearchBox.js';
 export { Signpost } from './components/Signpost/Signpost.js';

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@coopdigital/react",
   "type": "module",
-  "version": "0.35.0",
+  "version": "0.37.0",
   "private": false,
   "publishConfig": {
     "access": "public"
@@ -56,11 +56,11 @@
   "description": "",
   "devDependencies": {
     "@axe-core/playwright": "^4.10.2",
-    "@playwright/test": "^1.55.0",
-    "@storybook/addon-a11y": "^9.1.5",
-    "@storybook/addon-docs": "^9.1.5",
-    "@storybook/addon-onboarding": "^9.1.5",
-    "@storybook/react-vite": "^9.1.5",
+    "@playwright/test": "^1.55.1",
+    "@storybook/addon-a11y": "^9.1.8",
+    "@storybook/addon-docs": "^9.1.8",
+    "@storybook/addon-onboarding": "^9.1.8",
+    "@storybook/react-vite": "^9.1.8",
     "@testing-library/jest-dom": "^6.8.0",
     "@testing-library/react": "^16.3.0",
     "@types/react": "^19.1.13",
@@ -69,7 +69,7 @@
     "react": "^19.1.1",
     "react-dom": "^19.1.1",
     "serve": "^14.2.5",
-    "storybook": "^9.1.5"
+    "storybook": "^9.1.8"
   },
   "peerDependencies": {
     "clsx": "^2.1.1",
@@ -80,7 +80,7 @@
     "storybook": "$storybook"
   },
   "dependencies": {
-    "@coopdigital/styles": "^0.31.0"
+    "@coopdigital/styles": "^0.32.0"
   },
-  "gitHead": "eedf8c0062e77a007636c54ec5776aa6cc670cee"
+  "gitHead": "07c3e26f63d0b276cd48f392ec61241f7db7fe84"
 }

package/src/components/Card/Card.tsx

@@ -39,8 +39,8 @@ export interface CardProps extends HTMLAttributes<HTMLDivElement> {
   label?: string
   /** **(Optional)** Specify the background color of the Card label. */
   labelBackground?: Lights
-  /** **(Optional)** Specify the layout of the Card. */
-  layout?: "vertical" | "horizontal"
+  /** **(Optional)** Specify the orientation of the Card. */
+  orientation?: "vertical" | "horizontal"
 }
 
 function getCardLinkElement(as: CardProps["as"], href?: string) {
@@ -74,7 +74,7 @@ export const Card = ({
   imagePosition = "left",
   label = "",
   labelBackground,
-  layout = "vertical",
+  orientation = "vertical",
   ...props
 }: CardProps): JSX.Element => {
   const linkElement = getCardLinkElement(as, href)
@@ -88,7 +88,7 @@ export const Card = ({
     className: clsx("coop-card", background && bgPropToClass(background, className), className),
     "data-badge-pos": badgePosition,
     "data-image-pos": imagePosition,
-    "data-layout": layout !== "vertical" ? layout : undefined,
+    "data-orientation": orientation !== "vertical" ? orientation : undefined,
     ...props,
   }
 

package/src/components/Checkbox/Checkbox.tsx

@@ -32,14 +32,11 @@ export interface CheckboxProps
   labelVisible?: boolean
   /** Specify the Checkbox name. */
   name: string
-  /** **(Optional)** Specify the Checkbox placeholder text. Do not use in place of a form label. */
-  placeholder?: string
   /** **(Optional)** Specify the Checkbox size. */
   size?: StandardSizes
 }
 
 export const Checkbox = ({
-  "aria-placeholder": ariaPlaceholder,
   className,
   error = false,
   hint,
@@ -47,7 +44,6 @@ export const Checkbox = ({
   label,
   labelVisible = true,
   name,
-  placeholder,
   size = "md",
   ...props
 }: CheckboxProps): JSX.Element => {
@@ -56,13 +52,11 @@ export const Checkbox = ({
   id = id ?? internalId
 
   const componentProps = {
-    "aria-placeholder": placeholder ?? ariaPlaceholder ?? undefined,
     className: clsx("coop-checkbox", className),
     "data-error": error ? "" : undefined,
     "data-size": size.length && size !== "md" ? size : undefined,
     id,
     name,
-    placeholder,
     type: "checkbox",
     ...props,
   }

package/src/components/Checkbox/CheckboxGroup.tsx

@@ -25,6 +25,8 @@ export interface CheckboxGroupProps extends FieldsetHTMLAttributes<HTMLFieldSetE
   label?: string
   /** **(Optional)** Specify whether the label should be visible to humans or screen readers. */
   labelVisible?: boolean
+  /** **(Optional)** Specify the CheckboxGroup orientation. */
+  orientation?: "horizontal" | "vertical"
   /** **(Optional)** Specify the CheckboxGroup size. */
   size?: StandardSizes
 }
@@ -36,12 +38,14 @@ export const CheckboxGroup = ({
   hint,
   label,
   labelVisible = true,
+  orientation = "vertical",
   size = "md",
   ...props
 }: CheckboxGroupProps): JSX.Element => {
   const componentProps = {
     className: clsx("coop-fieldset", "coop-checkbox-group", className),
     "data-error": error ? "" : undefined,
+    "data-orientation": orientation !== "vertical" ? orientation : undefined,
     "data-size": size.length && size !== "md" ? size : undefined,
     ...props,
   }
@@ -55,7 +59,7 @@ export const CheckboxGroup = ({
       {label && <legend {...legendProps}>{label}</legend>}
       {hint && <FieldHint>{hint}</FieldHint>}
       {typeof error === "object" && error?.message && <FieldError>{error.message}</FieldError>}
-      {children}
+      <div className="coop-checkbox-group-options">{children}</div>
     </fieldset>
   )
 }

package/src/components/Checkbox/index.ts

@@ -1,5 +1,6 @@
 import Checkbox from "./Checkbox"
+import CheckboxGroup from "./CheckboxGroup"
 
 export default Checkbox
-export { Checkbox }
+export { Checkbox, CheckboxGroup }
 export * from "./Checkbox"

package/src/components/RadioButton/RadioButton.tsx

@@ -0,0 +1,95 @@
+import clsx from "clsx"
+import { type InputHTMLAttributes, type JSX, useId } from "react"
+import { FormFieldError, StandardSizes } from "src/types"
+
+import { FieldError } from "../FieldError"
+import { FieldHint } from "../FieldHint"
+import { FieldLabel } from "../FieldLabel"
+import Tag, { TagProps } from "../Tag"
+
+export interface RadioButtonProps
+  extends Omit<InputHTMLAttributes<HTMLInputElement>, "size" | "type"> {
+  /** **(Optional)** Specify additional CSS classes to be applied to the component. */
+  className?: string
+  /** **(Optional)** Specify the RadioButton error state.
+   *
+   * This is an instance of `FormFieldError`. You can provide either an object with a `message` key, or a boolean value if you need to render the message independently.
+   */
+  error?: FormFieldError
+  /** **(Optional)** Specify the RadioButton hint.
+   *
+   * This text is rendered under the label to provide further guidance for users.
+   */
+  hint?: string
+  /** **(Optional)** Specify the RadioButton id. Will be auto-generated if not set. */
+  id?: string
+  /** **(Optional)** Specify the RadioButton label.
+   *
+   * This property is optional in case you need to render your own label, but all form elements *must* provide a label. */
+  label: string
+  /** **(Optional)** Specify whether the label should be visible to humans or screen readers. */
+  labelVisible?: boolean
+  /** Specify the RadioButton name. */
+  name: string
+  /** **(Optional)** Specify the RadioButton size. */
+  size?: StandardSizes
+  /** **(Optional)** Specify the RadioButton tag text. */
+  tag?: string
+  /** **(Optional)** Specify the RadioButton tag background color. */
+  tagBackground?: TagProps["background"]
+  /** **(Optional)** Specify the RadioButton variant. */
+  variant?: "default" | "boxed"
+}
+
+export const RadioButton = ({
+  className,
+  error = false,
+  hint,
+  id,
+  label,
+  labelVisible = true,
+  name,
+  size = "md",
+  tag,
+  tagBackground,
+  variant = "default",
+  ...props
+}: RadioButtonProps): JSX.Element => {
+  const internalId = useId()
+
+  id = id ?? internalId
+
+  const componentProps = {
+    className: clsx("coop-radio-button", className),
+    "data-error": error ? "" : undefined,
+    "data-size": size.length && size !== "md" ? size : undefined,
+    "data-variant": variant !== "default" ? variant : undefined,
+    id,
+    name,
+    type: "radio",
+    ...props,
+  }
+
+  return (
+    <div className="coop-form-item">
+      <div className="coop-radio-button-wrapper">
+        <input {...componentProps} />
+
+        {label && (
+          <FieldLabel htmlFor={id} isVisible={labelVisible}>
+            <span>{label}</span>{" "}
+            {tag && (
+              <Tag background={tagBackground} size="sm">
+                {tag}
+              </Tag>
+            )}
+          </FieldLabel>
+        )}
+        {hint && <FieldHint>{hint}</FieldHint>}
+      </div>
+      {typeof error === "object" && error?.message && <FieldError>{error.message}</FieldError>}
+    </div>
+  )
+}
+
+export default RadioButton

package/src/components/RadioButton/RadioButtonGroup.tsx

@@ -0,0 +1,71 @@
+import type { FieldsetHTMLAttributes, JSX } from "react"
+
+import clsx from "clsx"
+
+import { FormFieldError, StandardSizes } from "../../types"
+import { FieldError } from "../FieldError"
+import { FieldHint } from "../FieldHint"
+
+export interface RadioButtonGroupProps extends FieldsetHTMLAttributes<HTMLFieldSetElement> {
+  /** **(Optional)** Main content inside the component. It can be any valid JSX or string. */
+  children?: React.ReactNode
+  /** **(Optional)** Specify additional CSS classes to be applied to the component. */
+  className?: string
+  /** **(Optional)** Specify the RadioButtonGroup error state.
+   *
+   * This is an instance of `FormFieldError`. You can provide either an object with a `message` key, or a boolean value if you need to render the message independently.
+   */
+  error?: FormFieldError
+  /** **(Optional)** Specify the RadioButtonGroup hint.
+   *
+   * This text is rendered under the label to provide further guidance for users.
+   */
+  hint?: string
+  /** **(Optional)** Specify the label for the RadioButtonGroup. This will be rendered as a fieldset legend. */
+  label?: string
+  /** **(Optional)** Specify whether the label should be visible to humans or screen readers. */
+  labelVisible?: boolean
+  /** **(Optional)** Specify the RadioButtonGroup orientation. */
+  orientation?: "horizontal" | "vertical"
+  /** **(Optional)** Specify the RadioButtonGroup size. */
+  size?: StandardSizes
+  /** **(Optional)** Specify the RadioButtonGroup variant. */
+  variant?: "default" | "boxed"
+}
+
+export const RadioButtonGroup = ({
+  children,
+  className,
+  error = false,
+  hint,
+  label,
+  labelVisible = true,
+  orientation = "vertical",
+  size = "md",
+  variant = "default",
+  ...props
+}: RadioButtonGroupProps): JSX.Element => {
+  const componentProps = {
+    className: clsx("coop-fieldset", "coop-radio-button-group", className),
+    "data-error": error ? "" : undefined,
+    "data-orientation": orientation !== "vertical" ? orientation : undefined,
+    "data-size": size.length && size !== "md" ? size : undefined,
+    "data-variant": variant !== "default" ? variant : undefined,
+    ...props,
+  }
+
+  const legendProps = {
+    className: clsx("coop-field-label", !labelVisible && "sr-only"),
+  }
+
+  return (
+    <fieldset {...componentProps}>
+      {label && <legend {...legendProps}>{label}</legend>}
+      {hint && <FieldHint>{hint}</FieldHint>}
+      {typeof error === "object" && error?.message && <FieldError>{error.message}</FieldError>}
+      <div className="coop-radio-button-group-options">{children}</div>
+    </fieldset>
+  )
+}
+
+export default RadioButtonGroup

package/src/components/RadioButton/index.ts

@@ -0,0 +1,6 @@
+import RadioButton from "./RadioButton"
+import RadioButtonGroup from "./RadioButtonGroup"
+
+export default RadioButton
+export { RadioButton, RadioButtonGroup }
+export * from "./RadioButton"

package/src/components/Tag/Tag.tsx

@@ -19,6 +19,8 @@ export interface TagProps extends HTMLAttributes<HTMLAnchorElement> {
   className?: string
   /** **(Optional)** Specify the URL that the Tag component will link to when clicked. */
   href?: string
+  /** **(Optional)** Specify the Tag size. */
+  size?: "sm" | "md"
 }
 
 export const Tag = ({
@@ -27,12 +29,15 @@ export const Tag = ({
   children,
   className,
   href,
+  size = "md",
   ...props
 }: TagProps): JSX.Element => {
   let element: TagProps["as"] = href ? "a" : "span"
   const componentProps = {
     className: clsx("coop-tag", bgPropToClass(background, className), className),
+    "data-size": size.length && size !== "md" ? size : undefined,
     href,
+
     ...props,
   }
   if (as) {

package/src/index.ts

@@ -3,7 +3,6 @@ export * from "./components/Author"
 export * from "./components/Button"
 export * from "./components/Card"
 export * from "./components/Checkbox"
-export * from "./components/Checkbox/CheckboxGroup"
 export * from "./components/Expandable"
 export * from "./components/Field"
 export * from "./components/FieldError"
@@ -12,6 +11,7 @@ export * from "./components/FieldLabel"
 export * from "./components/Flourish"
 export * from "./components/Image"
 export * from "./components/Pill"
+export * from "./components/RadioButton"
 export * from "./components/RootSVG"
 export * from "./components/SearchBox"
 export * from "./components/Signpost"