@coopdigital/react 1.22.2 → 1.22.4

package/dist/components/Fieldset/Fieldset.d.ts

@@ -5,21 +5,21 @@ import { LegendProps } from "../FieldMarkers/Legend.js";
 import { FieldsetHTMLAttributes, HTMLAttributes, JSX, Ref } from "react";
 //#region src/components/Fieldset/Fieldset.d.ts
 export interface FieldsetProps extends FieldsetHTMLAttributes<HTMLFieldSetElement> {
-  /** Form elements inside the Fieldset.
+  /** Content inside the component.
    *
-   * Usually this will be a combination of `Fieldset.Legend` and `Fieldset.Fields`. */
-  children: React.ReactNode;
-  /** **(Optional)** Specify additional CSS classes to be applied to the component. */
+   * This should be a set of `<Fieldset.Legend>`, `<Fieldset.Hint>`, `<Fieldset.Error>` and `<Fieldset.Fields>`. */
+  children?: React.ReactNode;
+  /** Specify additional CSS classes. */
   className?: string;
-  /** **(Optional)** Specify whether the Fieldset, and all of its descendents, should be disabled. Refer to Experience Library guidance on disabled form controls and accessibility. */
+  /** Specify the disabled state. Applies to all descendants. */
   disabled?: boolean;
-  /** **(Optional)** Specify the Fieldset error state. Use this to apply visual styling to the field control. */
+  /** Specify the component error state. */
   error?: boolean;
-  /** **(Optional)** Specify whether the Fieldset should show the left-hand error bar if it is in an error state. */
+  /** 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. */
+  /** Specify a custom React ref for this component. */
   ref?: Ref<HTMLFieldSetElement>;
-  /** **(Optional)** Specify the size of the Fieldset and all its descendents. */
+  /** Specify the size of the component. Applies to all descendants. */
   size?: StandardSizes;
 }
 declare const Fieldset: {
@@ -53,13 +53,13 @@ declare const Fieldset: {
   };
 };
 interface FieldsetFieldsProps extends HTMLAttributes<HTMLDivElement> {
-  /** **(Optional)** Specify whether all descendent Fields should render inside a box. */
+  /** Specify whether all descendant Fields should render inside a box. */
   boxed?: boolean;
-  /** **(Optional)** Form elements inside the Fieldset.Fields container. */
-  children?: string | React.ReactNode;
-  /** **(Optional)** Specify additional CSS classes to be applied to the component. */
+  /** Content inside the component. */
+  children?: React.ReactNode;
+  /** Specify additional CSS classes. */
   className?: string;
-  /** **(Optional)** Specify the CheckboxGroup orientation. */
+  /** Specify the component orientation. */
   orientation?: "horizontal" | "vertical";
 }
 declare const FieldsetFields: {

package/dist/components/Flourish/Flourish.d.ts

@@ -2,13 +2,13 @@ import { Black, BrandBlue, Darks, Lights, OfferRed, Tints, White } from "../../t
 import { JSX, ReactNode, Ref, SVGProps } from "react";
 //#region src/components/Flourish/Flourish.d.ts
 export interface FlourishProps extends SVGProps<SVGSVGElement> {
-  /** Specify the text to be highlighted by the Flourish. */
-  children: string | ReactNode;
-  /** **(Optional)** Specify additional CSS classes to be applied to the component. */
+  /** Content inside the component. */
+  children?: ReactNode;
+  /** Specify additional CSS classes. */
   className?: string;
-  /** **(Optional)** Specify the Flourish color. */
+  /** Specify the Flourish color. */
   fill?: Darks | Lights | Tints | OfferRed | BrandBlue | White | Black;
-  /** **(Optional)** Specify a custom React ref for this component. */
+  /** Specify a custom React ref for this component. */
   ref?: Ref<SVGSVGElement>;
 }
 declare const Flourish: {

package/dist/components/Form/Form.d.ts

@@ -1,11 +1,11 @@
 import { FormHTMLAttributes, JSX, ReactNode, Ref } from "react";
 //#region src/components/Form/Form.d.ts
 export interface FormProps extends FormHTMLAttributes<HTMLFormElement> {
-  /** **(Optional)** Main content inside the form. This will usually be a collection of Field, Fieldset and Button components. */
-  children?: string | ReactNode;
-  /** **(Optional)** Specify additional CSS classes to be applied to the component. */
+  /** Content inside the component. */
+  children?: ReactNode;
+  /** Specify additional CSS classes. */
   className?: string;
-  /** **(Optional)** Specify a custom React ref for this component. */
+  /** Specify a custom React ref for this component. */
   ref?: Ref<HTMLFormElement>;
 }
 declare const Form: {

package/dist/components/Image/Image.d.ts

@@ -1,16 +1,12 @@
 import { ImgHTMLAttributes, JSX, Ref } from "react";
 //#region src/components/Image/Image.d.ts
 export interface ImageProps extends ImgHTMLAttributes<HTMLImageElement> {
-  /** Specify text to describe the image. Refer to Experience Library guidelines on writing good alt text. */
+  /** Specify text to describe the Image. */
   alt: string;
-  /** **(Optional)** Specify the height of the image. */
-  height?: string;
-  /** **(Optional)** Specify a custom React ref for this component. */
+  /** Specify a custom React ref for this component. */
   ref?: Ref<HTMLImageElement>;
-  /** Specify the Image source URL. */
+  /** Specify the source URL. */
   src: string;
-  /** **(Optional)** Specify the width of the image. */
-  width?: string;
 }
 declare const Image: {
   ({ alt, height, ref, src, width, ...props }: ImageProps): JSX.Element;

package/dist/components/Image/Image.js

@@ -1,6 +1,8 @@
 import { jsx } from "react/jsx-runtime";
 //#region src/components/Image/Image.tsx
 const getContentfulParams = ({ height, src, width }) => {
+	width = width.toString();
+	height = height ? height?.toString() : void 0;
 	const url = !src.startsWith("http") ? new URL("https://" + src) : new URL(src);
 	[
 		["fm", "webp"],

package/dist/components/LoadingSpinner/LoadingSpinner.d.ts

@@ -1,14 +1,10 @@
 import { JSX, Ref, SVGProps } from "react";
 //#region src/components/LoadingSpinner/LoadingSpinner.d.ts
 export interface LoadingSpinnerProps extends SVGProps<SVGSVGElement> {
-  /** **(Optional)** Specify additional CSS classes to be applied to the component. */
+  /** Specify additional CSS classes. */
   className?: string;
-  /** **(Optional)** Specify a custom React ref for this component. */
+  /** Specify a custom React ref for this component. */
   ref?: Ref<SVGSVGElement>;
-  /** **(Optional)** Specify LoadingSpinner stroke. */
-  stroke?: string;
-  /** **(Optional)** Specify LoadingSpinner stroke width. */
-  strokeWidth?: string;
 }
 export declare const LoadingSpinner: ({ className, ref, stroke, strokeWidth, ...props }: LoadingSpinnerProps) => JSX.Element;
 //#endregion

package/dist/components/Logo/Logo.d.ts

@@ -1,18 +1,17 @@
 import { JSX, SVGProps } from "react";
 //#region src/components/Logo/Logo.d.ts
 export interface LogoProps extends SVGProps<SVGSVGElement> {
-  /** **(Optional)** Specify the Logo alternative text. */
+  /** Specify alternative text for the Logo.
+   *
+   * Default: `Co-op`.
+   */
   alt?: string;
-  /** **(Optional)** Specify additional CSS classes to be applied to the component. */
+  /** Specify additional CSS classes. */
   className?: string;
-  /** **(Optional)** Specify the Logo fill color.
+  /** Specify the fill color.
    *
    * Default: brand-blue. */
   fill?: "white" | "black" | "brand-blue";
-  /** **(Optional)** Specify the Logo height. */
-  height?: number;
-  /** **(Optional)** Specify the Logo width. */
-  width?: number;
 }
 export declare const Logo: ({ alt, className, fill, height, id, ref, width, ...props }: LogoProps) => JSX.Element;
 //#endregion

package/dist/components/PasswordInput/PasswordInput.d.ts

@@ -4,14 +4,14 @@ import { JSX } from "react";
 //#region src/components/PasswordInput/PasswordInput.d.ts
 export interface PasswordInputProps extends Omit<TextInputProps, "prefix" | "prefixInline" | "suffix" | "suffixInline" | "type"> {
   /**
-   * **(Optional)** Specify if the show/hide toggle button should be shown.
+   * Specify if the show/hide toggle button should be shown.
    *
-   * Default: false
+   * Default: `false`.
    */
   showToggle?: boolean;
 }
 declare const PasswordInput: {
-  ({ disabled, id, showToggle, size, ...props }: PasswordInputProps): JSX.Element;
+  ({ disabled, id, ref, showToggle, size, ...props }: PasswordInputProps): JSX.Element;
   slot: {
     field: boolean;
     name: string;

package/dist/components/PasswordInput/PasswordInput.js

@@ -5,7 +5,7 @@ import { TextInput } from "../TextInput/TextInput.js";
 import { jsx, jsxs } from "react/jsx-runtime";
 import { useCallback, useState } from "react";
 //#region src/components/PasswordInput/PasswordInput.tsx
-const PasswordInput = ({ disabled, id, showToggle = false, size, ...props }) => {
+const PasswordInput = ({ disabled, id, ref, showToggle = false, size, ...props }) => {
 	const [isVisible, setIsVisible] = useState(false);
 	const field = useField();
 	const inputId = id ?? field?.id;
@@ -18,7 +18,7 @@ const PasswordInput = ({ disabled, id, showToggle = false, size, ...props }) =>
 		autoCapitalize: "none",
 		disabled,
 		id: inputId,
-		ref: props.ref,
+		ref,
 		size,
 		spellCheck: "false",
 		type: isVisible ? "text" : "password"

package/dist/components/Picture/Picture.d.ts

@@ -1,13 +1,15 @@
 import { HTMLAttributes, JSX, ReactNode, Ref } from "react";
 //#region src/components/Picture/Picture.d.ts
 export interface PictureProps extends HTMLAttributes<HTMLPictureElement> {
-  /** **(Optional)** Content inside the component. */
-  children?: string | ReactNode;
-  /** **(Optional)** Specify additional CSS classes. */
+  /** Content inside the component.
+   *
+   * Usually this should be an `<Image>`. */
+  children?: ReactNode;
+  /** Specify additional CSS classes. */
   className?: string;
-  /** **(Optional)** Specify the image crop mode. */
+  /** Specify the crop mode. */
   crop?: "square" | "wide" | "thin" | "squircle" | "none";
-  /** **(Optional)** Specify a custom React ref for this component. */
+  /** Specify a custom React ref for this component. */
   ref?: Ref<HTMLPictureElement>;
 }
 export declare const Picture: ({ children, className, crop, ref, ...props }: PictureProps) => JSX.Element;

package/dist/components/Pill/Pill.d.ts

@@ -2,23 +2,28 @@ import { StandardSizes } from "../../types/index.js";
 import React, { ForwardRefExoticComponent, HTMLAttributes, JSX, Ref } from "react";
 //#region src/components/Pill/Pill.d.ts
 export interface PillProps extends HTMLAttributes<HTMLAnchorElement> {
-  /** **(Optional)** Specify a custom element to override default `a` or `span`. */
+  /** Specify a custom element for the component.
+   *
+   * Default: `<span>` or `<a>`.
+   */
   as?: React.FC<any> | ForwardRefExoticComponent<any> | string;
-  /** **(Optional)** Main content inside the component. It can be any valid JSX or string. */
+  /** Content inside the component.
+   *
+   * This can be any valid JSX including an optional `<Pill.Badge>`. */
   children?: React.ReactNode;
-  /** **(Optional)** Specify additional CSS classes to be applied to the component. */
+  /** Specify additional CSS classes. */
   className?: string;
-  /** **(Optional)** Specify the URL that the Pill component will link to when clicked. */
+  /** Specify the target URL. */
   href?: string;
-  /** **(Optional)** Specify a custom React ref for this component. */
+  /** Specify a custom React ref for this component. */
   ref?: Ref<HTMLElement>;
-  /** **(Optional)** Specify the Pill size. */
+  /** Specify the component size. */
   size?: StandardSizes;
 }
 interface PillBadgeProps extends HTMLAttributes<HTMLSpanElement> {
-  /** **(Optional)** Content inside the Badge. */
+  /** Content inside the component. */
   children?: React.ReactNode;
-  /** **(Optional)** Specify additional CSS classes to be applied to the Badge. */
+  /** Specify additional CSS classes. */
   className?: string;
 }
 declare const Pill: {

package/dist/components/Popover/Popover.d.ts

@@ -2,55 +2,58 @@ import { JSX, ReactNode, Ref } from "react";
 import { PopoverAnchorProps, PopoverCloseProps, PopoverContentProps, PopoverProps, PopoverTriggerProps } from "@radix-ui/react-popover";
 //#region src/components/Popover/Popover.d.ts
 interface PopoverProps$1 extends PopoverProps {
-  /** Content inside the Popover.
+  /** Content inside the component.
    *
-   * This should be a `Popover.Trigger` and `Popover.Content`, with an optional `Popover.Close`. Other children will be ignored. */
-  children: string | ReactNode;
-  /** **(Optional)** Callback to run when the Popover is opened or closed. */
+   * This should be a set of `<Popover.Trigger>` and `<Popover.Content>`. */
+  children?: ReactNode;
+  /** Callback to run when the Popover is opened or closed. */
   onOpenChange?: PopoverProps["onOpenChange"];
-  /** **(Optional)** Force the Popover state. Must be used together with `onOpenChange`. */
+  /** Force the Popover state. Must be used together with `onOpenChange`. */
   open?: PopoverProps["open"];
 }
 interface PopoverTriggerProps$1 extends PopoverTriggerProps {
-  /** **(Optional)** When true, the element passed as a child becomes the trigger root element. */
+  /** When true, the element passed as a child becomes the root element. */
   asChild?: PopoverTriggerProps["asChild"];
-  /** **(Optional)** Content inside the Popover Trigger. */
+  /** Content inside the component. */
   children?: React.ReactNode;
-  /** **(Optional)** Specify additional CSS classes to be applied to the component. */
+  /** Specify additional CSS classes. */
   className?: string;
 }
 interface PopoverContentProps$1 extends PopoverContentProps {
-  /** **(Optional)** Specify horizontal alignment of the Popover against the trigger. May change when collisions occur. */
+  /** Specify horizontal alignment of the Popover against the trigger. May change when collisions occur. */
   align?: PopoverContentProps["align"];
-  /** **(Optional)** Specify pixel offset from the "start" or "end" alignment. */
+  /** Specify pixel offset from the "start" or "end" alignment. */
   alignOffset?: PopoverContentProps["alignOffset"];
-  /** **(Optional)** Specify whether the Popover should reposition itself if it falls out of the viewport. */
+  /** Specify whether the Popover should reposition itself if it falls out of the viewport. */
   avoidCollisions?: PopoverContentProps["avoidCollisions"];
-  /** **(Optional)** Content inside the Popover window. */
+  /** Content inside the component.
+   *
+   * This can be any valid JSX including an optional `<Popover.Close>`.
+   */
   children?: React.ReactNode;
-  /** **(Optional)** Specify additional CSS classes to be applied to the component. */
+  /** Specify additional CSS classes. */
   className?: string;
-  /** **(Optional)** Specify pixel boundary for collision safe area. */
+  /** Specify pixel boundary for collision safe area. */
   collisionPadding?: PopoverContentProps["collisionPadding"];
-  /** **(Optional)** Specify a custom React ref for this component. */
+  /** Specify a custom React ref for this component. */
   ref?: Ref<HTMLDivElement>;
-  /** **(Optional)** Specify placement of the Popover against the trigger. Will change when collisions occur. */
+  /** Specify placement of the Popover against the trigger. Will change when collisions occur. */
   side?: PopoverContentProps["side"];
-  /** **(Optional)** Specify pixel offset from the trigger element. */
+  /** Specify pixel offset from the trigger element. */
   sideOffset?: PopoverContentProps["sideOffset"];
 }
 interface PopoverCloseProps$1 extends PopoverCloseProps {
-  /** **(Optional)** When true, the element passed as a child becomes the close button root element. */
+  /** When true, the element passed as a child becomes the root element. */
   asChild?: PopoverCloseProps["asChild"];
-  /** **(Optional)** Content inside the Popover Close element. */
+  /** Content inside the component. */
   children?: React.ReactNode;
-  /** **(Optional)** Specify additional CSS classes to be applied to the component. */
+  /** Specify additional CSS classes. */
   className?: string;
 }
 interface PopoverAnchorProps$1 extends PopoverAnchorProps {
-  /** **(Optional)** When true, the element passed as a child becomes the anchor root element. */
+  /** When true, the element passed as a child becomes the root element. */
   asChild?: PopoverAnchorProps["asChild"];
-  /** **(Optional)** Content inside the Popover Anchor element. */
+  /** Content inside the component. */
   children?: React.ReactNode;
 }
 declare const Popover: {

package/dist/components/Prose/Prose.d.ts

@@ -2,22 +2,22 @@ import { StandardSizes } from "../../types/index.js";
 import { HTMLAttributes, JSX, ReactNode, Ref } from "react";
 //#region src/components/Prose/Prose.d.ts
 export interface ProseProps extends HTMLAttributes<HTMLDivElement> {
-  /** **(Optional)** Main content inside the component. It can be any valid JSX or string. */
-  children?: string | ReactNode;
-  /** **(Optional)** Specify additional CSS classes to be applied to the component. */
+  /** Content inside the component. */
+  children?: ReactNode;
+  /** Specify additional CSS classes. */
   className?: string;
-  /** **(Optional)** Specify if the Prose container should stretch to 100% width.
+  /** Specify if the container should stretch to 100% width.
    *
    * If this not set, the container will be 100% width up to a maximum of 864px / 54rem */
   full?: boolean;
-  /** **(Optional)** Specify a custom React ref for this component. */
+  /** Specify a custom React ref for this component. */
   ref?: Ref<HTMLDivElement>;
-  /** **(Optional)** Specify font size behaviour. When set to `lg`, body copy will increase to 20px on larger screens.
+  /** Specify font size behaviour. When set to `lg`, body copy will increase to 20px on larger screens.
    *
    * Default: `md`
    */
   size?: "md" | "lg";
-  /** **(Optional)** Specify the Prose spacing.
+  /** Specify the spacing.
    *
    * Default: `md`
    */

package/dist/components/Radio/Radio.d.ts

@@ -2,19 +2,19 @@ import { StandardSizes } from "../../types/index.js";
 import { InputHTMLAttributes, JSX, Ref } from "react";
 //#region src/components/Radio/Radio.d.ts
 export interface RadioProps extends Omit<InputHTMLAttributes<HTMLInputElement>, "size" | "type"> {
-  /** **(Optional)** Specify additional CSS classes to be applied to the component. */
+  /** Specify additional CSS classes. */
   className?: string;
-  /** **(Optional)** Specify whether the Radio should be disabled. Refer to Experience Library guidance on disabled form controls and accessibility.  */
+  /** Specify the disabled state. */
   disabled?: boolean;
-  /** **(Optional)** Specify the Radio error state. */
+  /** Specify the component error state. */
   error?: boolean;
-  /** **(Optional)** Specify the Radio id. Will be auto-generated if not set. */
+  /** Specify the component id. Will be auto-generated if not set. */
   id?: string;
-  /** Specify the Radio name. */
+  /** Specify the component name. */
   name: string;
-  /** **(Optional)** Specify a custom React ref for this component. */
+  /** Specify a custom React ref for this component. */
   ref?: Ref<HTMLInputElement>;
-  /** **(Optional)** Specify the Radio size. */
+  /** Specify the component size. */
   size?: StandardSizes;
 }
 declare const Radio: {

package/dist/components/Searchbox/Searchbox.d.ts

@@ -6,31 +6,23 @@ import "../TextInput/index.js";
 import React, { FormHTMLAttributes, JSX, RefObject } from "react";
 //#region src/components/Searchbox/Searchbox.d.ts
 export interface SearchboxProps extends FormHTMLAttributes<HTMLFormElement> {
-  /** **(Optional)** Specify a server endpoint to submit the form. Will be ignored if onSubmit is also set. */
+  /** Specify a server endpoint to submit the form. Will be ignored if onSubmit is also set. */
   action?: string;
-  /** **(Optional)** Specify props to forward to the Button element. Use `label` to set Button text. */
-  button?: Pick<ButtonProps, "className" | "loadingText"> & {
-    label?: React.ReactNode;
-  };
-  /** **(Optional)** Specify additional CSS classes to be applied to the component. */
+  /** Specify additional CSS classes. */
   className?: string;
-  /** **(Optional)** Specify the TextInput id. Will be auto-generated if not set. */
+  /** Specify the component id. Will be auto-generated if not set. */
   id?: string;
   /** Specify the label displayed above the search field. Hidden by default, but visible to screen readers. */
   label: string;
-  /** **(Optional)** Specify whether the label should be visible to humans or screenreaders. */
+  /** Specify whether the label should be visible to humans or screenreaders. */
   labelVisible?: boolean;
-  /** **(Optional)** Specify the TextInput name, also used as the URL search parameter. Defaults to `query`. */
-  name?: string;
-  /** **(Optional)** Callback to run when the form is submitted. If this is an async function, it will be awaited and the Searchbox will be in a pending state until the promise is resolved. */
+  /** Callback to run when the form is submitted. If this is an async function, it will be awaited and the Searchbox will be in a pending state until the promise is resolved. */
   onSubmit?: React.SubmitEventHandler<HTMLElement> | undefined;
-  /** **(Optional)** Specify the TextInput placeholder text Do not use in place of a form label. */
-  placeholder?: string;
-  /** **(Optional)** Specify a custom React ref for this component. */
+  /** Specify a custom React ref for this component. */
   ref?: RefObject<HTMLFormElement | null>;
-  /** **(Optional)** Specify the Searchbox size. */
+  /** Specify the component size. */
   size?: StandardSizes;
-  /** **(Optional)** Specify the Searchbox variant. */
+  /** Specify the component variant. */
   variant?: "solid" | "ghost";
 }
 declare const Searchbox: {

package/dist/components/Select/Select.d.ts

@@ -2,41 +2,41 @@ import { StandardSizes } from "../../types/index.js";
 import { JSX, OptgroupHTMLAttributes, OptionHTMLAttributes, ReactNode, Ref, SelectHTMLAttributes } from "react";
 //#region src/components/Select/Select.d.ts
 export interface SelectProps extends Omit<SelectHTMLAttributes<HTMLSelectElement>, "size"> {
-  /** **(Optional)** Options inside the Select. This should be a set of `Select.Option` or `Select.OptionGroup` components.  */
+  /** Content inside the component.
+   *
+   *  This should be a set of `<Select.Option>` or `<Select.OptionGroup>`. */
   children?: ReactNode;
-  /** **(Optional)** Specify additional CSS classes to be applied to the component. */
+  /** Specify additional CSS classes. */
   className?: string;
-  /** **(Optional)** Specify whether the Select should be disabled. Refer to Experience Library guidance on disabled form controls and accessibility. */
+  /** Specify whether the Select should be disabled. */
   disabled?: boolean;
-  /** **(Optional)** Specify the Select error state. */
+  /** Specify the Select error state. */
   error?: boolean;
-  /** **(Optional)** Specify the wrapper behaviour. When true, width is fit-content, otherwise it expands to 100%.
+  /** Specify the wrapper behaviour. When true, width is fit-content, otherwise it expands to 100%.
    *
    * Default: false
    */
   fit?: boolean;
-  /** **(Optional)** Specify the Select id. Will be auto-generated if not set. */
+  /** Specify the component id. Will be auto-generated if not set. */
   id?: string;
   /** Specify the Select name. */
   name: string;
-  /** **(Optional)** Specify a custom React ref for this component. */
+  /** Specify a custom React ref for this component. */
   ref?: Ref<HTMLSelectElement>;
-  /** **(Optional)** Specify the Select size. */
+  /** Specify the component size. */
   size?: StandardSizes;
 }
 interface SelectOptionGroupProps extends OptgroupHTMLAttributes<HTMLOptGroupElement> {
-  /** **(Optional)** Main content inside the Select option. It can be any valid JSX or string. */
+  /** Content inside the component.  */
   children?: ReactNode;
   /** Specify the Select option group label. */
   label: string;
 }
 interface SelectOptionProps extends OptionHTMLAttributes<HTMLOptionElement> {
-  /** **(Optional)** Main content inside the Select option. It can be any valid JSX or string. */
+  /** Content inside the component.  */
   children?: ReactNode;
-  /** **(Optional)** Specify additional CSS classes to be applied to the Select option. */
+  /** Specify additional CSS classes. */
   className?: string;
-  /** Value of Select option. */
-  value: string;
 }
 declare const Select: {
   ({ children, className, disabled, error, fit, id, name, ref, size, ...props }: SelectProps): JSX.Element;

package/dist/components/Signpost/Signpost.d.ts

@@ -3,19 +3,22 @@ import "../Image/index.js";
 import React, { ForwardRefExoticComponent, HTMLAttributes, JSX, Ref } from "react";
 //#region src/components/Signpost/Signpost.d.ts
 export interface SignpostProps extends HTMLAttributes<HTMLDivElement> {
-  /** **(Optional)** Specify a custom element to override default `a`. */
+  /** Specify a custom element for the component.
+   *
+   * Default: `<a>`.
+   */
   as?: React.FC<any> | ForwardRefExoticComponent<any> | string;
-  /** 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. */
+  /** Content inside the component. */
+  children?: React.ReactNode;
+  /** Specify additional CSS classes. */
   className?: string;
-  /** **(Optional)** Specify the level of the Signpost heading. */
+  /** Specify the level of the Signpost heading. */
   headingLevel?: "h2" | "h3" | "h4" | "h5" | "h6";
   /** Specify the URL that the Signpost component will link to when clicked. */
   href?: string;
-  /** **(Optional)** Specify properties of the Signpost Image. */
+  /** Specify properties of the Signpost Image. */
   image?: ImageProps;
-  /** **(Optional)** Specify a custom React ref for this component. */
+  /** Specify a custom React ref for this component. */
   ref?: Ref<HTMLDivElement>;
 }
 /**

package/dist/components/SkipNav/SkipNav.d.ts

@@ -5,14 +5,15 @@ interface SkipNavLink {
   label: string;
 }
 export interface SkipNavProps extends HTMLAttributes<HTMLDivElement> {
-  /** **(Optional)** Specify additional CSS classes to be applied to the component. */
+  /** Specify additional CSS classes. */
   className?: string;
-  /** **(Optional)** Specify whether the SkipNav is visible immediately or only when tabbing. Useful for testing purposes only. */
+  /** Specify whether the component is visible immediately or only when tabbing. Useful for testing purposes only. */
   isVisible?: boolean;
-  /** **(Optional)** Specify links to show in the SkipNav.
-   * Each item needs a `href` and `label`. Defaults to a single link anchored to `#main`. */
+  /** Specify links to show in the component. Each item needs a `href` and `label`.
+   *
+   * Default: A single link anchored to `#main`. */
   links?: SkipNavLink[];
-  /** **(Optional)** Specify a custom React ref for this component. */
+  /** Specify a custom React ref for this component. */
   ref?: Ref<HTMLDivElement>;
 }
 declare const SkipNav: {

package/dist/components/Squircle/Squircle.d.ts

@@ -1,15 +1,17 @@
 import { HTMLAttributes, JSX, Ref, SVGAttributes } from "react";
 //#region src/components/Squircle/Squircle.d.ts
 export interface SquircleProps extends HTMLAttributes<HTMLDivElement> {
-  /** **(Optional)** Main content inside the component. It can be any valid JSX or string. */
+  /** Content inside the component.
+   *
+   * This should be a set of `<Squircle.Svg>` and `<Squircle.Text>`. */
   children?: React.ReactNode;
-  /** **(Optional)** Specify additional CSS classes to be applied to the component. */
+  /** Specify additional CSS classes. */
   className?: string;
-  /** **(Optional)** Specify a custom React ref for this component. */
+  /** Specify a custom React ref for this component. */
   ref?: Ref<HTMLDivElement>;
 }
 export interface SquircleSvgProps extends SVGAttributes<SVGElement> {
-  /** **(Optional)** Specify the Squircle size. */
+  /** Specify the component size. */
   size?: string | number;
 }
 declare const Squircle: {

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

@@ -1,17 +1,20 @@
 import React, { ForwardRefExoticComponent, HTMLAttributes, JSX, Ref } from "react";
 //#region src/components/Tag/Tag.d.ts
 export interface TagProps extends HTMLAttributes<HTMLAnchorElement> {
-  /** **(Optional)** Specify a custom element to override default `a` or `span`. */
+  /** Specify a custom element for the component.
+   *
+   * Default: `<span>` or `<a>`.
+   */
   as?: React.FC<any> | ForwardRefExoticComponent<any> | string;
-  /** **(Optional)** Main content inside the component. It can be any valid JSX or string. */
+  /** Content inside the component. */
   children?: React.ReactNode;
-  /** **(Optional)** Specify additional CSS classes to be applied to the component. */
+  /** Specify additional CSS classes. */
   className?: string;
-  /** **(Optional)** Specify the URL that the Tag component will link to when clicked. */
+  /** Specify the target URL. */
   href?: string;
-  /** **(Optional)** Specify a custom React ref for this component. */
+  /** Specify a custom React ref for this component. */
   ref?: Ref<HTMLElement>;
-  /** **(Optional)** Specify the Tag size. */
+  /** Specify the component size. */
   size?: "sm" | "md";
 }
 declare const Tag: {