@coopdigital/react 0.43.0 → 0.45.0

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

@@ -1,5 +1,5 @@
 import type { JSX, TextareaHTMLAttributes } from "react";
-import { FormFieldError, StandardSizes } from "../../types";
+import { StandardSizes } from "../../types";
 export interface TextareaProps extends TextareaHTMLAttributes<HTMLTextAreaElement> {
     /** **(Optional)** Specify additional CSS classes to be applied to the component. */
     className?: string;
@@ -16,24 +16,10 @@ export interface TextareaProps extends TextareaHTMLAttributes<HTMLTextAreaElemen
     cutoff?: boolean;
     /** **(Optional)** Specify whether the Textarea should be disabled. Refer to Experience Library guidance on disabled form controls and accessibility.  */
     disabled?: boolean;
-    /** **(Optional)** Specify the Textarea 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 Textarea hint.
-     *
-     * This text is rendered under the label to provide further guidance for users.
-     */
-    hint?: string;
+    /** **(Optional)** Specify the Textarea error state */
+    error?: boolean;
     /** **(Optional)** Specify the Textarea id. Will be auto-generated if not set. */
     id?: string;
-    /** **(Optional)** Specify the Textarea 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;
     /** **(Optional)** Specify the Textarea maxLength. This is the maximum number of characters users can enter. */
     maxLength?: number;
     /** Specify the Textarea name. */
@@ -45,5 +31,5 @@ export interface TextareaProps extends TextareaHTMLAttributes<HTMLTextAreaElemen
     /** **(Optional)** Specify the Textarea size. */
     size?: StandardSizes;
 }
-export declare const Textarea: ({ "aria-placeholder": ariaPlaceholder, className, cols, counter, cutoff, disabled, error, hint, id, label, labelVisible, 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, rows, size, ...props }: TextareaProps) => JSX.Element;
 export default Textarea;

package/dist/components/Textarea/Textarea.js

@@ -1,16 +1,14 @@
 import { jsxs, jsx, Fragment } from 'react/jsx-runtime';
 import clsx from 'clsx';
-import { useId, useState } from 'react';
+import { useState } from 'react';
 import { useDebounce } from '../../hooks/useDebounce.js';
-import { FieldError } from '../FieldError/FieldError.js';
-import { FieldHint } from '../FieldHint/FieldHint.js';
-import { FieldLabel } from '../FieldLabel/FieldLabel.js';
+import { useId } from '../../hooks/useId.js';
 
 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, hint, id, label, labelVisible = true, 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, rows = 4, size = "md", ...props }) => {
     var _a;
     const internalId = useId();
     id = id !== null && id !== void 0 ? id : internalId;
@@ -18,7 +16,7 @@ const Textarea = ({ "aria-placeholder": ariaPlaceholder, className, cols = 30, c
         "aria-placeholder": (_a = placeholder !== null && placeholder !== void 0 ? placeholder : ariaPlaceholder) !== null && _a !== void 0 ? _a : undefined,
         className: clsx("coop-textarea", className),
         cols,
-        "data-error": error ? "" : undefined,
+        "data-error": error !== null && error !== void 0 ? error : undefined,
         "data-size": size.length && size !== "md" ? size : undefined,
         disabled,
         id,
@@ -30,14 +28,15 @@ const Textarea = ({ "aria-placeholder": ariaPlaceholder, className, cols = 30, c
     };
     const [remaining, setRemaining] = useState(maxLength);
     const debouncedRemaining = useDebounce(remaining, DEBOUNCE_DELAY);
+    const showCounter = !disabled && counter && maxLength && remaining != null && debouncedRemaining != null;
     const handleChange = (e) => {
         maxLength && e.target && setRemaining(maxLength - e.target.value.length);
     };
-    const formItemProps = { "aria-disabled": disabled ? true : undefined };
-    return (jsxs("div", { className: "coop-form-item", ...formItemProps, children: [label && (jsx(FieldLabel, { htmlFor: id, isVisible: labelVisible, 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("textarea", { ...componentProps, onChange: (e) => {
+    // const formItemProps = { "aria-disabled": disabled ? true : undefined }
+    return (jsxs("div", { className: "coop-textarea-wrapper", children: [jsx("textarea", { ...componentProps, onChange: (e) => {
                     userOnChange === null || userOnChange === void 0 ? void 0 : userOnChange(e);
                     handleChange(e);
-                } }), !disabled && counter && maxLength && remaining != null && debouncedRemaining != null && (jsxs(Fragment, { children: [jsx("small", { "aria-hidden": "true", className: "coop-textarea-counter", ...(remaining < 0 && { "data-error": "" }), children: charCountMessage(remaining) }), jsx("span", { "aria-live": "polite", className: "sr-only", children: charCountMessage(debouncedRemaining) })] }))] }));
+                } }), 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/dist/hooks/useId.d.ts

@@ -0,0 +1,2 @@
+export type UseId = (id?: string) => string;
+export declare const useId: UseId;

package/dist/hooks/useId.js

@@ -0,0 +1,8 @@
+import { useId as useId$1 } from 'react';
+
+const useId = (id) => {
+    const uniqueId = useId$1();
+    return id !== null && id !== void 0 ? id : uniqueId;
+};
+
+export { useId };

package/dist/index.d.ts

@@ -5,9 +5,7 @@ export * from "./components/Card";
 export * from "./components/Checkbox";
 export * from "./components/Expandable";
 export * from "./components/Field";
-export * from "./components/FieldError";
-export * from "./components/FieldHint";
-export * from "./components/FieldLabel";
+export * from "./components/Fieldset";
 export * from "./components/Flourish";
 export * from "./components/Image";
 export * from "./components/Pill";

package/dist/index.js

@@ -3,17 +3,13 @@ export { Author } from './components/Author/Author.js';
 export { Button } from './components/Button/Button.js';
 export { Card } from './components/Card/Card.js';
 export { Checkbox } from './components/Checkbox/Checkbox.js';
-export { CheckboxGroup } from './components/Checkbox/CheckboxGroup.js';
 export { Expandable } from './components/Expandable/Expandable.js';
-export { Field } from './components/Field/Field.js';
-export { FieldError } from './components/FieldError/FieldError.js';
-export { FieldHint } from './components/FieldHint/FieldHint.js';
-export { FieldLabel } from './components/FieldLabel/FieldLabel.js';
+export { Field, FieldControl } from './components/Field/Field.js';
+export { Fieldset, FieldsetFields } from './components/Fieldset/Fieldset.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/dist/utils/slots.d.ts

@@ -2,5 +2,7 @@ import React from "react";
 type Slots<T> = Record<keyof T, React.ReactNode>;
 export declare function isKey<T extends object>(x: T, k: PropertyKey): k is keyof T;
 export declare function getSlotName(node: React.ReactNode): string | false;
-export declare function getSlots<T>(componentSlots: Slots<T>, children: React.ReactNode): Slots<T>;
+export declare function getSlots<T>(componentSlots: Slots<T>, children: React.ReactNode, options?: {
+    collect?: string[];
+}): Slots<T>;
 export {};

package/dist/utils/slots.js

@@ -8,11 +8,17 @@ function getSlotName(node) {
         ? node.type.name
         : false;
 }
-function getSlots(componentSlots, children) {
+function getSlots(componentSlots, children, options) {
     return React.Children.toArray(children).reduce((slots, child) => {
+        var _a;
         const slotName = getSlotName(child);
         if (child && slotName && isKey(componentSlots, slotName)) {
-            slots[slotName] = child;
+            if ((_a = void 0 ) === null || _a === void 0 ? void 0 : _a.includes(slotName)) {
+                slots[slotName] = slots[slotName] ? [...[slots[slotName]].flat(), child] : [child];
+            }
+            else {
+                slots[slotName] = child;
+            }
         }
         else if ("Children" in slots) {
             slots.Children = slots.Children ? [...[slots.Children].flat(), child] : [child];

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@coopdigital/react",
   "type": "module",
-  "version": "0.43.0",
+  "version": "0.45.0",
   "private": false,
   "publishConfig": {
     "access": "public"
@@ -57,18 +57,18 @@
   "devDependencies": {
     "@axe-core/playwright": "^4.11.0",
     "@playwright/test": "^1.56.1",
-    "@storybook/addon-a11y": "^10.0.3",
-    "@storybook/addon-docs": "^10.0.3",
-    "@storybook/addon-onboarding": "^10.0.3",
-    "@storybook/react-vite": "^10.0.3",
+    "@storybook/addon-a11y": "^10.0.7",
+    "@storybook/addon-docs": "^10.0.7",
+    "@storybook/addon-onboarding": "^10.0.7",
+    "@storybook/react-vite": "^10.0.7",
     "@testing-library/jest-dom": "^6.9.1",
     "@testing-library/react": "^16.3.0",
-    "@types/react": "^19.2.2",
-    "@types/react-dom": "^19.2.2",
+    "@types/react": "^19.2.4",
+    "@types/react-dom": "^19.2.3",
     "react": "^19.2.0",
     "react-dom": "^19.2.0",
     "serve": "^14.2.5",
-    "storybook": "^10.0.3"
+    "storybook": "^10.0.7"
   },
   "peerDependencies": {
     "react": "^19.1.0",
@@ -78,8 +78,8 @@
     "storybook": "$storybook"
   },
   "dependencies": {
-    "@coopdigital/styles": "^0.38.0",
+    "@coopdigital/styles": "^0.39.0",
     "clsx": "^2.1.1"
   },
-  "gitHead": "c3dc3d710bed7e0bc415887e1d484ce5f048f98c"
+  "gitHead": "113b5fc44feee8b4e899c75c303f1ed26f9f2629"
 }

package/src/components/Checkbox/Checkbox.tsx

@@ -1,13 +1,9 @@
 import type { InputHTMLAttributes, JSX } from "react"
 
 import clsx from "clsx"
-import { useId } from "react"
 
-import { FormFieldError, StandardSizes } from "../../../src/types"
-import { FieldError } from "../FieldError"
-import { FieldHint } from "../FieldHint"
-import { FieldLabel } from "../FieldLabel"
-import Tag from "../Tag"
+import { StandardSizes } from "../../../src/types"
+import { useId } from "../../hooks/useId"
 
 export interface CheckboxProps
   extends Omit<InputHTMLAttributes<HTMLInputElement>, "size" | "type"> {
@@ -15,89 +11,37 @@ export interface CheckboxProps
   className?: string
   /** **(Optional)** Specify whether the Checkbox should be disabled. Refer to Experience Library guidance on disabled form controls and accessibility. */
   disabled?: boolean
-  /** **(Optional)** Specify the Checkbox 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 Checkbox hint.
-   *
-   * This text is rendered under the label to provide further guidance for users.
-   */
-  hint?: string
+  /** **(Optional)** Specify the Checkbox error state. */
+  error?: boolean
   /** **(Optional)** Specify the Checkbox id. Will be auto-generated if not set. */
   id?: string
-  /** **(Optional)** Specify the Checkbox 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 Checkbox name. */
   name: string
   /** **(Optional)** Specify the Checkbox size. */
   size?: StandardSizes
-  /** **(Optional)** Specify the Checkbox tag text. */
-  tag?: string
-  /** **(Optional)** Specify the Checkbox tag className. */
-  tagClassName?: string
-  /** **(Optional)** Specify the Checkbox variant. */
-  variant?: "default" | "boxed"
 }
 
 export const Checkbox = ({
   className,
   disabled,
   error = false,
-  hint,
   id,
-  label,
-  labelVisible = true,
   name,
   size = "md",
-  tag,
-  tagClassName,
-  variant = "default",
   ...props
 }: CheckboxProps): JSX.Element => {
-  const internalId = useId()
-
-  id = id ?? internalId
-
+  const uid = useId(id)
   const componentProps = {
     className: clsx("coop-checkbox", className),
-    "data-error": error ? "" : undefined,
+    "data-error": error || undefined,
     "data-size": size.length && size !== "md" ? size : undefined,
-    "data-variant": variant !== "default" ? variant : undefined,
     disabled,
-    id,
+    id: uid,
     name,
     type: "checkbox",
     ...props,
   }
-  const formItemProps = { "aria-disabled": disabled ? true : undefined }
-  return (
-    <div className="coop-form-item" {...formItemProps}>
-      <div className="coop-checkbox-wrapper">
-        <div className="coop-checkbox-input-wrapper">
-          <input {...componentProps} />
-
-          {label && (
-            <FieldLabel htmlFor={id} isVisible={labelVisible}>
-              <span>{label}</span>{" "}
-              {tag && (
-                <Tag className={tagClassName} size="sm">
-                  {tag}
-                </Tag>
-              )}
-            </FieldLabel>
-          )}
-        </div>
-        {hint && <FieldHint>{hint}</FieldHint>}
-      </div>
-      {typeof error === "object" && error?.message && <FieldError>{error.message}</FieldError>}
-    </div>
-  )
+  return <input {...componentProps} />
 }
 
 export default Checkbox

package/src/components/Checkbox/index.ts

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

package/src/components/Field/Field.tsx

@@ -1,20 +1,156 @@
-import type { HTMLAttributes, JSX, ReactNode } from "react"
+import type { HTMLAttributes, HTMLProps, JSX } from "react"
 
 import clsx from "clsx"
+import React from "react"
 
-export interface FieldProps extends HTMLAttributes<HTMLDivElement> {
-  /** **(Optional)** Main content inside the component. It can be any valid JSX or string. */
-  children?: string | ReactNode
+import { useId } from "../../hooks/useId"
+import { getSlots } from "../../utils/slots"
+import { Error as BaseError, type ErrorProps } from "../FieldMarkers/Error"
+import { Hint as BaseHint, type HintProps } from "../FieldMarkers/Hint"
+import { Label as BaseLabel, type LabelProps } from "../FieldMarkers/Label"
+
+const componentSlots = {
+  Checkbox: null,
+  Children: null,
+  Control: null,
+  FieldError: null,
+  FieldHint: null,
+  FieldLabel: null,
+  RadioButton: null,
+  Textarea: null,
+  TextInput: null,
+}
+
+const standardFields = ["Children", "FieldError", "FieldHint", "FieldLabel"]
+const inlineFields = ["Checkbox", "RadioButton"]
+
+interface FieldProps extends HTMLAttributes<HTMLDivElement> {
+  /** **(Optional)** Specify whether the Field should render inside a box. */
+  boxed?: boolean
+  /** Form elements inside the Field.
+   *
+   * Usually this will be a combination of `Field.Label`, `Field.Hint`, `Field.Error` and an associated control such as `TextInput` or `Checkbox`. */
+  children: React.ReactNode
   /** **(Optional)** Specify additional CSS classes to be applied to the component. */
-  className?: string
+  classname?: string
+  /** **(Optional)** Specify the Field error state. Use this to apply visual styling to the field control. */
+  error?: boolean
+  /** **(Optional)** Specify whether the Field should show the left-hand error bar if it is in an error state. */
+  hideErrorBar?: boolean
 }
 
-export const Field = ({ children, className, ...props }: FieldProps): JSX.Element => {
+const Root = ({
+  boxed = false,
+  children,
+  className,
+  error = false,
+  hideErrorBar = false,
+  ...props
+}: FieldProps) => {
+  const slots = getSlots(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 controlDisabled = false
+
+  if (control) {
+    if (typeof control === "object" && "props" in control) {
+      const controlProps = control.props as HTMLProps<HTMLElement>
+      controlId = controlProps.id ?? controlId
+      controlDisabled = controlProps.disabled ?? false
+    }
+
+    slots.Control = React.cloneElement(control as React.ReactElement<HTMLInputElement>, {
+      id: controlId,
+    })
+  }
+
+  if (slots.FieldLabel && React.isValidElement(slots.FieldLabel)) {
+    slots.FieldLabel = React.cloneElement(slots.FieldLabel as React.ReactElement<LabelProps>, {
+      htmlFor: (slots.FieldLabel.props as LabelProps).htmlFor ?? controlId,
+    })
+  }
+
   const componentProps = {
-    className: clsx("coop-form-item ", className),
     ...props,
+    "aria-disabled": controlDisabled || undefined,
+    className: clsx("coop-field", isInlineControl && "coop-field-inline", className),
+    "data-boxed": boxed || undefined,
+    "data-error": error || undefined,
+    "data-hide-error": hideErrorBar || undefined,
   }
-  return <div {...componentProps}>{children}</div>
+
+  return (
+    <div {...componentProps}>
+      {!isInlineControl && hasFieldMarkers && (
+        <div className="coop-field-markers">
+          {slots.FieldLabel}
+          {slots.FieldHint}
+          {slots.FieldError}
+        </div>
+      )}
+      {slots.Control && (
+        <div className="coop-field-control">
+          {slots.Control}
+          {isInlineControl && hasFieldMarkers && (
+            <div className="coop-field-markers">
+              {slots.FieldLabel}
+              {slots.FieldHint}
+              {slots.FieldError}
+            </div>
+          )}
+        </div>
+      )}
+      {slots.Children}
+    </div>
+  )
 }
 
+interface ControlProps extends HTMLAttributes<HTMLDivElement> {
+  /** **(Optional)** Elements inside the form control. */
+  children?: string | React.ReactNode
+  /** **(Optional)** Specify additional CSS classes to be applied to the component. */
+  className?: string
+}
+
+export const FieldControl = ({ children, className, ...props }: ControlProps): JSX.Element => {
+  return (
+    <div className={clsx("coop-field-control ", className)} {...props}>
+      {children}
+    </div>
+  )
+}
+
+FieldControl.displayName = "Field.Control"
+
+const FieldLabel = (props: LabelProps) => <BaseLabel {...props} />
+
+FieldLabel.displayName = "Field.Label"
+
+const FieldHint = (props: HintProps) => <BaseHint {...props} />
+
+FieldHint.displayName = "Field.Hint"
+
+const FieldError = (props: ErrorProps) => <BaseError {...props} />
+
+FieldError.displayName = "Field.Error"
+
+export const Field = Object.assign(Root, {
+  Control: FieldControl,
+  Error: FieldError,
+  Hint: FieldHint,
+  Label: FieldLabel,
+})
+
+// Field.Label = FieldLabel
+// Field.Hint = FieldHint
+// Field.Error = FieldError
+
 export default Field

package/src/components/{FieldError/FieldError.tsx → FieldMarkers/Error.tsx}

@@ -2,14 +2,14 @@ import type { HTMLAttributes, JSX, ReactNode } from "react"
 
 import clsx from "clsx"
 
-export interface FieldErrorProps extends HTMLAttributes<HTMLSpanElement> {
-  /** **(Optional)** Main content inside the component. It can be any valid JSX or string. */
+export interface ErrorProps extends HTMLAttributes<HTMLSpanElement> {
+  /** **(Optional)** Error 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
 }
 
-export const FieldError = ({ children, className, ...props }: FieldErrorProps): JSX.Element => {
+export const Error = ({ children, className, ...props }: ErrorProps): JSX.Element => {
   const componentProps = {
     className: clsx("coop-field-error ", className),
     ...props,
@@ -17,4 +17,4 @@ export const FieldError = ({ children, className, ...props }: FieldErrorProps):
   return <span {...componentProps}>{children}</span>
 }
 
-export default FieldError
+export default Error

package/src/components/{FieldHint/FieldHint.tsx → FieldMarkers/Hint.tsx}

@@ -2,18 +2,14 @@ import type { HTMLAttributes, JSX, ReactNode } from "react"
 
 import clsx from "clsx"
 
-export interface FieldHintProps extends HTMLAttributes<HTMLParagraphElement> {
-  /** Main content inside the component. It can be any valid JSX or string. */
-  children: string | ReactNode
+export interface HintProps extends HTMLAttributes<HTMLParagraphElement> {
+  /** **(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
 }
 
-export const FieldHint = ({
-  children,
-  className,
-  ...props
-}: FieldHintProps): JSX.Element | null => {
+export const Hint = ({ children, className, ...props }: HintProps): JSX.Element | null => {
   const componentProps = {
     className: clsx("coop-field-hint ", className),
     ...props,
@@ -22,4 +18,4 @@ export const FieldHint = ({
   return children ? <div {...componentProps}>{children}</div> : null
 }
 
-export default FieldHint
+export default Hint

package/src/components/FieldMarkers/Label.tsx

@@ -0,0 +1,21 @@
+import clsx from "clsx"
+import { LabelHTMLAttributes } from "react"
+
+export interface LabelProps extends LabelHTMLAttributes<HTMLLabelElement> {
+  /** **(Optional)** Main label for the form element. Accepts any valid JSX or string. */
+  children?: string | React.ReactNode
+  /** **(Optional)** Specify additional CSS classes to be applied to the component. */
+  className?: string
+  /** **(Optional)** Specify whether the label is visible for humans or only for screen readers. */
+  isVisible?: boolean
+}
+
+export const Label = ({ children, className, isVisible = true, ...props }: LabelProps) => {
+  return (
+    <label {...props} className={clsx("coop-field-label", !isVisible && "sr-only", className)}>
+      <span>{children}</span>
+    </label>
+  )
+}
+
+export default Label

package/src/components/FieldMarkers/Legend.tsx

@@ -0,0 +1,28 @@
+import clsx from "clsx"
+import { HTMLAttributes } from "react"
+
+export interface LegendProps extends HTMLAttributes<HTMLLegendElement> {
+  /** **(Optional)** Main legend for the fieldset. Accepts any valid JSX or string. */
+  children?: string | React.ReactNode
+  /** **(Optional)** Specify additional CSS classes to be applied to the component. */
+  className?: string
+  /** **(Optional)** Specify whether the legend should be visible to humans or screen readers. */
+  isVisible?: boolean
+}
+
+export const Legend = ({ children, className, isVisible = true, ...props }: LegendProps) => {
+  const componentProps = {
+    "aria-hidden": true,
+    className: clsx("coop-field-label", !isVisible && "sr-only", className),
+    ...props,
+  }
+
+  return (
+    <>
+      <legend className="sr-only">{children}</legend>
+      {isVisible && <div {...componentProps}>{children}</div>}
+    </>
+  )
+}
+
+export default Legend