@abgov/react-components 6.11.0 → 7.0.0-dev.10

package/lib/notification/notification.d.ts

@@ -1,11 +1,39 @@
-import { GoabAriaLiveType, GoabNotificationType } from '@abgov/ui-components-common';
+import { GoabAriaLiveType, GoabNotificationEmphasis, GoabNotificationType } from '@abgov/ui-components-common';
+interface WCProps {
+    ref: React.RefObject<HTMLElement | null>;
+    type: GoabNotificationType;
+    maxcontentwidth?: string;
+    arialive?: GoabAriaLiveType;
+    testid?: string;
+    emphasis?: GoabNotificationEmphasis;
+    compact?: string;
+    version?: string;
+}
+declare module "react" {
+    namespace JSX {
+        interface IntrinsicElements {
+            "goa-notification": WCProps & React.HTMLAttributes<HTMLButtonElement>;
+        }
+    }
+}
 export interface GoabNotificationProps {
+    /** Define the context and colour of the notification. */
     type?: GoabNotificationType;
+    /** Indicates how assistive technology should handle updates to the live region. @default "polite" */
     ariaLive?: GoabAriaLiveType;
+    /** Maximum width of the content area. @default "100%" */
     maxContentWidth?: string;
+    /** Sets the visual prominence. 'high' for full background, 'low' for a bordered style. @default "high" */
+    emphasis?: GoabNotificationEmphasis;
+    /** When true, reduces padding for a more compact notification. */
+    compact?: boolean;
+    /** Content rendered inside the notification. */
     children?: React.ReactNode;
+    /** Callback fired when the notification is dismissed. */
     onDismiss?: () => void;
+    /** Sets a data-testid attribute for automated testing. */
     testId?: string;
 }
-export declare const GoabNotification: ({ type, ariaLive, maxContentWidth, children, testId, onDismiss, }: GoabNotificationProps) => import("react/jsx-runtime").JSX.Element;
+/** Display important page level information or notifications. */
+export declare const GoabNotification: ({ type, emphasis, compact, ariaLive, maxContentWidth, children, testId, onDismiss, }: GoabNotificationProps) => import("react/jsx-runtime").JSX.Element;
 export default GoabNotification;

package/lib/one-column-layout/one-column-layout.d.ts

@@ -7,8 +7,10 @@ declare module "react" {
     }
 }
 export interface GoabPageProps {
+    /** Content rendered inside the one-column layout. */
     children?: ReactNode;
 }
 export type PageProps = GoabPageProps;
+/** Organizes page content in a single responsive column. */
 export declare function GoabOneColumnLayout(props: GoabPageProps): JSX.Element;
 export default GoabOneColumnLayout;

package/lib/page-block/page-block.d.ts

@@ -12,10 +12,14 @@ declare module "react" {
     }
 }
 export interface GoabPageBlockProps {
+    /** Maximum width of the content area. Use "full" for 100% width or a CSS dimension like "1200px". @default "full" */
     width?: GoabPageBlockSize;
+    /** Sets a data-testid attribute for automated testing. */
     testId?: string;
+    /** Content rendered inside the page block. */
     children?: ReactNode;
 }
 export type PageBlockProps = GoabPageBlockProps;
+/** Full-width section with optional background. */
 export declare function GoabPageBlock(props: PageBlockProps): JSX.Element;
 export {};

package/lib/pages/pages.d.ts

@@ -11,8 +11,11 @@ declare module "react" {
     }
 }
 export interface GoabPagesProps extends Margins {
+    /** The currently visible page (1-based index). @default 1 */
     current?: number;
+    /** Page content to show or hide based on the current page index. */
     children?: ReactNode;
 }
+/** Container for paginated content views. */
 export declare function GoabPages(props: GoabPagesProps): JSX.Element;
 export default GoabPages;

package/lib/pagination/pagination.d.ts

@@ -1,12 +1,35 @@
 import { GoabPaginationOnChangeDetail, Margins } from '@abgov/ui-components-common';
+interface WCProps extends Margins {
+    ref?: React.RefObject<HTMLElement | null>;
+    itemcount: number;
+    perpagecount?: number;
+    pagenumber: number;
+    variant?: "all" | "links-only";
+    testid?: string;
+    version?: string;
+}
+declare module "react" {
+    namespace JSX {
+        interface IntrinsicElements {
+            "goa-pagination": WCProps & React.HTMLAttributes<HTMLElement>;
+        }
+    }
+}
 export interface GoabPaginationProps extends Margins {
+    /** @required Total number of data items within all pages. */
     itemCount: number;
-    perPageCount?: number;
+    /** @required The current page being viewed (non-zero based). */
     pageNumber: number;
-    variant?: "all" | "links-only";
+    /** @required Callback fired when the user navigates to a different page. */
     onChange: (detail: GoabPaginationOnChangeDetail) => void;
+    /** Number of data items shown per page. @default 10 */
+    perPageCount?: number;
+    /** Controls which nav controls are visible. @default "all" */
+    variant?: "all" | "links-only";
+    /** Sets a data-testid attribute for automated testing. */
     testId?: string;
 }
 export type PaginationProps = GoabPaginationProps;
+/** Help users navigation between multiple pages or screens as part of a set. */
 export declare function GoabPagination({ onChange, ...props }: GoabPaginationProps): import("react/jsx-runtime").JSX.Element;
 export default GoabPagination;

package/lib/popover/popover.d.ts

@@ -16,17 +16,23 @@ declare module "react" {
     }
 }
 export interface GoabPopoverProps extends Margins, DataAttributes {
-    target?: ReactNode;
+    /** Content rendered inside the popover body. */
+    children: ReactNode;
+    /** @required Sets the element used as the popover trigger. */
+    target: ReactNode;
+    /** Sets a data-testid attribute for automated testing. */
     testId?: string;
+    /** Sets the maximum width of the popover container. @default "320px" */
     maxWidth?: string;
+    /** Sets the minimum width of the popover container. */
     minWidth?: string;
+    /** Sets if the popover has padding. Use false when content needs to be flush with boundaries. @default true */
     padded?: boolean;
+    /** Provides control to where the popover content is positioned. @default "auto" */
     position?: GoabPopoverPosition;
-    children: ReactNode;
-    /***
-     * @deprecated This property has no effect and will be removed in a future version
-     */
+    /** @deprecated This property has no effect and will be removed in a future version. */
     relative?: boolean;
 }
+/** A small overlay that opens on demand, used in other components. */
 export declare function GoabPopover({ target, padded, relative, children, ...rest }: GoabPopoverProps): JSX.Element;
 export default GoabPopover;

package/lib/push-drawer/push-drawer.d.ts

@@ -1,9 +1,10 @@
-import { ReactNode } from 'react';
+import { ReactNode, JSX } from 'react';
 interface WCProps {
     open?: boolean;
-    testid?: string;
     heading?: string;
     width?: string;
+    testid?: string;
+    version?: string;
     ref: React.RefObject<HTMLElement | null>;
 }
 declare module "react" {
@@ -14,13 +15,21 @@ declare module "react" {
     }
 }
 export interface GoabPushDrawerProps {
-    testid?: string;
-    open?: boolean;
-    heading?: string;
-    width?: string;
-    actions?: ReactNode | undefined;
+    /** @required Content rendered inside the push drawer body. */
     children: ReactNode;
+    /** @required Callback fired when the push drawer is closed. */
     onClose: () => void;
+    /** Controls the open/closed state of the push drawer. */
+    open?: boolean;
+    /** Sets the heading text or custom heading content. */
+    heading?: string | ReactNode;
+    /** Sets the width of the push drawer panel. @default "492px" */
+    width?: string;
+    /** Sets a data-testid attribute for automated testing. */
+    testId?: string;
+    /** Content rendered in the actions slot, typically action buttons. */
+    actions?: ReactNode;
 }
-export declare function GoabPushDrawer({ testid, open, heading, width, actions, children, onClose, }: GoabPushDrawerProps): import("react/jsx-runtime").JSX.Element;
+/** A panel that pushes the main page content aside on desktop, falling back to an overlay drawer on smaller screens. */
+export declare function GoabPushDrawer({ open, heading, width, testId, actions, children, onClose, }: GoabPushDrawerProps): JSX.Element;
 export default GoabPushDrawer;

package/lib/radio-group/radio-group.d.ts

@@ -1,17 +1,51 @@
 import { JSX } from 'react';
-import { GoabRadioGroupOnChangeDetail, GoabRadioGroupOrientation, Margins, DataAttributes } from '@abgov/ui-components-common';
+import { GoabRadioGroupOnChangeDetail, GoabRadioGroupOrientation, GoabRadioGroupSize, Margins, DataAttributes } from '@abgov/ui-components-common';
 export * from './radio';
+interface WCProps extends Margins {
+    name: string;
+    value?: string;
+    id?: string;
+    orientation?: GoabRadioGroupOrientation;
+    disabled?: string;
+    error?: string;
+    arialabel?: string;
+    testid?: string;
+    size?: GoabRadioGroupSize;
+    version?: string;
+}
+declare module "react" {
+    namespace JSX {
+        interface IntrinsicElements {
+            "goa-radio-group": WCProps & React.HTMLAttributes<HTMLElement> & {
+                ref: React.RefObject<HTMLElement | null>;
+            };
+        }
+    }
+}
 export interface GoabRadioGroupProps extends Margins, DataAttributes {
+    /** @required The name for the radio group. Used for accessibility and change events. */
     name: string;
+    /** The currently selected value in the radio group. */
     value?: string;
+    /** The identifier for the radio group element. */
     id?: string;
+    /** Disables all radio items in the group. */
     disabled?: boolean;
+    /** Sets the layout direction. 'vertical' stacks items, 'horizontal' places them in a row. @default "vertical" */
     orientation?: GoabRadioGroupOrientation;
+    /** Sets the size of all radio items. 'compact' reduces spacing for dense layouts. @default "default" */
+    size?: GoabRadioGroupSize;
+    /** Sets a data-testid attribute for automated testing. */
     testId?: string;
+    /** Shows an error state on all radio items in the group. */
     error?: boolean;
+    /** Defines how the radio group will be announced by screen readers. */
     ariaLabel?: string;
+    /** Radio items to render inside the group. */
     children?: React.ReactNode;
+    /** Callback fired when the selected radio item changes. */
     onChange?: (detail: GoabRadioGroupOnChangeDetail) => void;
 }
-export declare function GoabRadioGroup({ disabled, error, onChange, name, children, ...rest }: GoabRadioGroupProps): JSX.Element;
+/** Allow users to select one option from a set. */
+export declare function GoabRadioGroup({ disabled, error, onChange, name, children, size, ...rest }: GoabRadioGroupProps): JSX.Element;
 export default GoabRadioGroup;

package/lib/radio-group/radio.d.ts

@@ -1,18 +1,55 @@
 import { Margins } from '@abgov/ui-components-common';
 import { JSX } from 'react';
+interface WCProps extends Margins {
+    name?: string;
+    value?: string;
+    description?: string | React.ReactNode;
+    reveal?: React.ReactNode;
+    revealarialabel?: string;
+    label?: string;
+    maxwidth?: string;
+    disabled?: string;
+    checked?: string;
+    error?: string;
+    arialabel?: string;
+    compact?: string;
+    version?: string;
+}
+declare module "react" {
+    namespace JSX {
+        interface IntrinsicElements {
+            "goa-radio-item": WCProps & React.HTMLAttributes<HTMLElement>;
+        }
+    }
+}
 export interface GoabRadioItemProps extends Margins {
+    /** The value of this radio option. Will be emitted when selected. */
     value?: string;
+    /** The display label for this radio option. Falls back to value if not provided. */
     label?: string;
+    /** The name of the radio group. Inherited from the parent RadioGroup if not set. */
     name?: string;
+    /** Additional description text displayed below the label. */
     description?: string | React.ReactNode;
+    /** Content revealed below the radio option when it is selected. */
     reveal?: React.ReactNode;
+    /** Text announced by screen readers when the reveal content is displayed. */
     revealAriaLabel?: string;
+    /** Sets the maximum width of this radio item. */
     maxWidth?: string;
+    /** Disables this radio option. Also disabled if the parent RadioGroup is disabled. */
     disabled?: boolean;
+    /** Sets this radio option as checked/selected. */
     checked?: boolean;
+    /** Shows an error state on this radio option. */
     error?: boolean;
+    /** Reduces spacing for dense layouts. */
+    compact?: boolean;
+    /** Additional content rendered inside the radio item. */
     children?: React.ReactNode;
+    /** Defines how this option will be announced by screen readers. */
     ariaLabel?: string;
 }
-export declare function GoabRadioItem({ name, label, value, description, reveal, revealAriaLabel, maxWidth, disabled, checked, error, ariaLabel, children, mt, mr, mb, ml, }: GoabRadioItemProps): JSX.Element;
+/** Individual radio option within a group. */
+export declare function GoabRadioItem({ name, label, value, description, reveal, revealAriaLabel, maxWidth, disabled, checked, error, compact, ariaLabel, children, mt, mr, mb, ml, }: GoabRadioItemProps): JSX.Element;
 export default GoabRadioItem;

package/lib/side-menu/side-menu.d.ts

@@ -1,7 +1,21 @@
 import { ReactNode, JSX } from 'react';
+interface WCProps {
+    testid?: string;
+    version?: string;
+}
+declare module "react" {
+    namespace JSX {
+        interface IntrinsicElements {
+            "goa-side-menu": WCProps & React.HTMLAttributes<HTMLElement>;
+        }
+    }
+}
 export interface GoabSideMenuProps {
-    testId?: string;
+    /** @required Navigation links and groups rendered inside the side menu. */
     children: ReactNode;
+    /** Sets a data-testid attribute for automated testing. */
+    testId?: string;
 }
-export declare function GoabSideMenu(props: GoabSideMenuProps): JSX.Element;
+/** A side navigation that helps the user navigate between pages. */
+export declare function GoabSideMenu({ testId, children }: GoabSideMenuProps): JSX.Element;
 export default GoabSideMenu;

package/lib/side-menu-group/side-menu-group.d.ts

@@ -1,10 +1,28 @@
 import { ReactNode, JSX } from 'react';
 import { GoabIconType, Margins } from '@abgov/ui-components-common';
+interface WCProps extends Margins {
+    heading: string;
+    icon?: GoabIconType;
+    testid?: string;
+    version?: string;
+}
+declare module "react" {
+    namespace JSX {
+        interface IntrinsicElements {
+            "goa-side-menu-group": WCProps & React.HTMLAttributes<HTMLElement>;
+        }
+    }
+}
 export interface GoabSideMenuGroupProps extends Margins {
+    /** @required The heading text for the menu group. */
     heading: string;
+    /** Icon displayed alongside the heading. */
     icon?: GoabIconType;
+    /** Sets a data-testid attribute for automated testing. */
     testId?: string;
+    /** Navigation links rendered inside the menu group. */
     children?: ReactNode;
 }
-export declare function GoabSideMenuGroup(props: GoabSideMenuGroupProps): JSX.Element;
+/** Group of related side menu items. */
+export declare function GoabSideMenuGroup({ heading, icon, testId, children, mt, mr, mb, ml, }: GoabSideMenuGroupProps): JSX.Element;
 export default GoabSideMenuGroup;

package/lib/side-menu-heading/side-menu-heading.d.ts

@@ -1,10 +1,27 @@
 import { GoabIconType } from '@abgov/ui-components-common';
 import { ReactNode } from 'react';
+interface WCProps {
+    testid?: string;
+    icon?: GoabIconType;
+    version?: string;
+}
+declare module "react" {
+    namespace JSX {
+        interface IntrinsicElements {
+            "goa-side-menu-heading": WCProps & React.HTMLAttributes<HTMLElement>;
+        }
+    }
+}
 export interface GoabSideMenuHeadingProps {
+    /** Icon displayed before the heading text. */
+    icon?: GoabIconType;
+    /** Content rendered in the meta slot, displayed alongside the heading. */
     meta?: ReactNode;
+    /** Sets a data-testid attribute for automated testing. */
     testId?: string;
-    icon?: GoabIconType;
+    /** The heading text or content rendered inside the side menu heading. */
     children?: ReactNode;
 }
-export declare function GoabSideMenuHeading(props: GoabSideMenuHeadingProps): import("react/jsx-runtime").JSX.Element;
+/** Section heading in side menu. */
+export declare function GoabSideMenuHeading({ meta, testId, icon, children, }: GoabSideMenuHeadingProps): import("react/jsx-runtime").JSX.Element;
 export default GoabSideMenuHeading;

package/lib/skeleton/skeleton.d.ts

@@ -14,12 +14,18 @@ declare module "react" {
     }
 }
 export interface GoabSkeletonProps extends Margins {
+    /** @required Sets the skeleton shape to represent your content. */
+    type: GoabSkeletonType;
+    /** Sets the maximum width. Currently only used in card skeleton type. @default "300px" */
     maxWidth?: string;
+    /** Size can affect either the height, width or both for different skeleton types. @default "1" */
     size?: GoabSkeletonSize;
+    /** Used within components that contain multiple lines. Currently only used in card skeleton type. @default 3 */
     lineCount?: number;
-    type: GoabSkeletonType;
+    /** Sets a data-testid attribute for automated testing. */
     testId?: string;
 }
 export type SkeletonProps = GoabSkeletonProps;
+/** Provide visual feedback to users while loading a content heavy page or page element. */
 export declare const GoabSkeleton: ({ maxWidth, size, lineCount, type, testId, mt, mr, mb, ml, }: GoabSkeletonProps) => import("react/jsx-runtime").JSX.Element;
 export default GoabSkeleton;

package/lib/spacer/spacer.d.ts

@@ -12,9 +12,13 @@ declare module "react" {
     }
 }
 export interface GoabSpacerProps {
+    /** Horizontal spacing. @default "none" */
     hSpacing?: GoabSpacerHorizontalSpacing;
+    /** Vertical spacing. @default "none" */
     vSpacing?: GoabSpacerVerticalSpacing;
+    /** Sets a data-testid attribute for automated testing. */
     testId?: string;
 }
+/** Negative area between the components and the interface. */
 export declare function GoabSpacer(props: GoabSpacerProps): import("react/jsx-runtime").JSX.Element;
 export default GoabSpacer;

package/lib/spinner/spinner.d.ts

@@ -15,12 +15,18 @@ declare module "react" {
     }
 }
 export interface GoabSpinnerProps {
+    /** @required Sets the spinner animation type. */
     type: GoabSpinnerType;
+    /** @required Sets the size of the spinner. */
     size: GoabSpinnerSize;
+    /** When true, inverts colors for use on dark backgrounds. */
     invert?: boolean;
+    /** Progress value (0-100). When set to 0 or greater, shows a progress spinner instead of infinite. */
     progress?: number;
+    /** Sets a data-testid attribute for automated testing. */
     testId?: string;
 }
 export type SpinnerProps = GoabSpinnerProps;
+/** Loading indicator for async operations. */
 export declare function GoabSpinner({ type, size, progress, invert, testId, }: GoabSpinnerProps): JSX.Element;
 export default GoabSpinner;

package/lib/tab/tab.d.ts

@@ -12,10 +12,15 @@ declare module "react" {
     }
 }
 export interface GoabTabItemProps {
+    /** The text label for this tab. Can also pass React nodes for custom heading content. */
     heading?: React.ReactNode;
+    /** When true, disables the tab so it cannot be selected. */
     disabled?: boolean;
+    /** Content rendered inside the tab panel. */
     children?: React.ReactNode;
+    /** URL-friendly identifier for the tab, used for hash-based navigation. */
     slug?: string;
 }
-export declare function GoabTab({ heading, disabled, slug, children }: GoabTabItemProps): JSX.Element;
+/** Individual tab within a tabs component. */
+export declare function GoabTab({ heading, disabled, slug, children, }: GoabTabItemProps): JSX.Element;
 export {};

package/lib/table/table-sort-header.d.ts

@@ -1,9 +1,27 @@
-import { DataAttributes, GoabTableSortDirection } from '@abgov/ui-components-common';
+import { DataAttributes, GoabTableSortDirection, GoabTableSortOrder } from '@abgov/ui-components-common';
 import { JSX } from 'react';
+interface WCProps {
+    name?: string;
+    direction?: GoabTableSortDirection;
+    "sort-order"?: GoabTableSortOrder;
+}
+declare module "react" {
+    namespace JSX {
+        interface IntrinsicElements {
+            "goa-table-sort-header": WCProps & React.HTMLAttributes<HTMLElement>;
+        }
+    }
+}
 export interface GoabTableSortProps extends DataAttributes {
+    /** Column name identifier for sorting. */
     name?: string;
+    /** Sets the sort direction indicator. @default "none" */
     direction?: GoabTableSortDirection;
+    /** Sort order number for multi-column sort display. Used for displaying priority numbers when multiple columns are sorted. */
+    sortOrder?: GoabTableSortOrder;
+    /** Content rendered inside the sort header button (typically the column heading text). */
     children?: React.ReactNode;
 }
-export declare function GoabTableSortHeader({ children, ...rest }: GoabTableSortProps): JSX.Element;
+/** A set of structured data that is easy for a user to scan, examine, and compare. */
+export declare function GoabTableSortHeader({ name, direction, sortOrder, children, ...rest }: GoabTableSortProps): JSX.Element;
 export default GoabTableSortHeader;

package/lib/table/table.d.ts

@@ -1,12 +1,41 @@
-import { GoabTableOnSortDetail, GoabTableVariant, Margins } from '@abgov/ui-components-common';
+import { GoabTableOnSortDetail, GoabTableOnMultiSortDetail, GoabTableSortMode, GoabTableVariant, Margins } from '@abgov/ui-components-common';
 import { ReactNode } from 'react';
+interface WCProps extends Margins {
+    ref?: React.RefObject<HTMLElement | null>;
+    width?: string;
+    stickyheader?: string;
+    variant?: GoabTableVariant;
+    "sort-mode"?: GoabTableSortMode;
+    testid?: string;
+    striped?: string;
+    version?: string;
+}
+declare module "react" {
+    namespace JSX {
+        interface IntrinsicElements {
+            "goa-table": WCProps & React.HTMLAttributes<HTMLElement>;
+        }
+    }
+}
 export interface GoabTableProps extends Margins {
+    /** Width of the table. By default it will fit the enclosed content. */
     width?: string;
+    /** Callback fired when a single-column sort header is clicked. */
     onSort?: (detail: GoabTableOnSortDetail) => void;
+    /** Callback fired when multi-column sorting changes. */
+    onMultiSort?: (detail: GoabTableOnMultiSortDetail) => void;
+    /** Sort mode: "single" allows one column, "multi" allows up to 2 columns. @default "single" */
+    sortMode?: GoabTableSortMode;
+    /** A relaxed variant of the table with more vertical padding for the cells. @default "normal" */
     variant?: GoabTableVariant;
+    /** When true, alternates row background colors for improved readability. */
+    striped?: boolean;
+    /** Sets a data-testid attribute for automated testing. */
     testId?: string;
+    /** Content rendered inside the table (table rows, headers, etc.). */
     children?: ReactNode;
 }
 export type TableProps = GoabTableProps;
-export declare function GoabTable({ onSort, ...props }: GoabTableProps): import("react/jsx-runtime").JSX.Element;
+/** A set of structured data that is easy for a user to scan, examine, and compare. */
+export declare function GoabTable({ onSort, onMultiSort, sortMode, ...props }: GoabTableProps): import("react/jsx-runtime").JSX.Element;
 export default GoabTable;

package/lib/tabs/tabs.d.ts

@@ -1,11 +1,38 @@
 import { default as React, JSX } from 'react';
-import { GoabTabsOnChangeDetail, GoabTabsVariant } from '@abgov/ui-components-common';
+import { GoabTabsOnChangeDetail, GoabTabsOrientation, GoabTabsVariant, GoabTabsNavigation } from '@abgov/ui-components-common';
+interface WCProps {
+    initialtab?: number;
+    ref: React.RefObject<HTMLElement | null>;
+    onChange?: (tab: number) => void;
+    testid?: string;
+    variant?: GoabTabsVariant;
+    navigation?: GoabTabsNavigation;
+    version?: string;
+    orientation?: string;
+}
+declare module "react" {
+    namespace JSX {
+        interface IntrinsicElements {
+            "goa-tabs": WCProps & React.HTMLAttributes<HTMLElement>;
+        }
+    }
+}
 export interface GoabTabsProps {
+    /** The initially active tab (1-based index). If not set, the first tab is active. */
     initialTab?: number;
+    /** Content rendered inside the tabs container, typically GoabTab components. */
     children?: React.ReactNode;
+    /** Sets a data-testid attribute for automated testing. */
     testId?: string;
+    /** Visual style variant. "segmented" shows pill-style tabs with animation. @default "default" */
     variant?: GoabTabsVariant;
+    /** Tab layout orientation. "auto" stacks vertically on mobile, "horizontal" keeps horizontal on all screen sizes. @default "auto" */
+    orientation?: GoabTabsOrientation;
+    /** Controls URL navigation mode on tab change. @default "hash" */
+    navigation?: GoabTabsNavigation;
+    /** Callback fired when the active tab changes. */
     onChange?: (detail: GoabTabsOnChangeDetail) => void;
 }
-export declare function GoabTabs({ initialTab, children, testId, variant, onChange, }: GoabTabsProps): JSX.Element;
+/** Let users navigate between related sections of content, displaying one section at a time. */
+export declare function GoabTabs({ initialTab, children, testId, onChange, variant, orientation, navigation, }: GoabTabsProps): JSX.Element;
 export default GoabTabs;

package/lib/temporary-notification-ctrl/temporary-notification-ctrl.d.ts

@@ -16,9 +16,13 @@ declare module "react" {
     }
 }
 export interface GoabTemporaryNotificationCtrlProps {
+    /** Vertical position of the notification container. @default "bottom" */
     verticalPosition?: SnackbarVerticalPosition;
+    /** Horizontal position of the notification container. @default "center" */
     horizontalPosition?: SnackbarHorizontalPosition;
+    /** Sets a data-testid attribute for automated testing. */
     testId?: string;
 }
+/** A notification that appears at the bottom of the screen. */
 export declare const GoabTemporaryNotificationCtrl: ({ verticalPosition, horizontalPosition, testId, ...rest }: GoabTemporaryNotificationCtrlProps) => import("react/jsx-runtime").JSX.Element;
 export default GoabTemporaryNotificationCtrl;

package/lib/text/text.d.ts

@@ -15,14 +15,21 @@ declare module "react" {
     }
 }
 interface GoATextProps extends Margins, DataAttributes {
+    /** Content rendered inside the text element. */
+    children: ReactNode;
     /** @deprecated Please use 'tag' property instead */
     as?: GoabTextTextElement | GoabTextHeadingElement;
+    /** The HTML element to render. Use semantic elements like 'h1'-'h6' for headings. */
     tag?: GoabTextTextElement | GoabTextHeadingElement;
+    /** Overrides the text size. */
     size?: GoabTextSize;
+    /** Sets the max width. @default "65ch" */
     maxWidth?: GoabTextMaxWidth;
+    /** Sets the text colour. @default "primary" */
     color?: GoabTextColor;
+    /** Sets the id attribute on the element. */
     id?: string;
-    children: ReactNode;
 }
+/** Provides consistent sizing, spacing, and colour to written content. */
 export declare function GoabText({ as, tag, children, ...rest }: GoATextProps): JSX.Element;
 export default GoabText;