@heymantle/litho 0.0.14 → 0.0.16

package/dist/types/components/Label.d.ts

@@ -1,28 +1,3 @@
 export default Label;
-/**
- * Label component
- *
- * This component renders a customizable label element with optional required indicator styling.
- * It uses `tailwind-variants` to apply base styles and accepts various props for customization.
- *
- * @param {Object} props - The properties passed to the component.
- * @param {React.ReactNode} props.children - The content to be displayed within the label.
- * @param {string} [props.id] - The identifier for the label and its associated form element.
- * @param {boolean} [props.hidden] - If true, the label is visually hidden.
- * @param {boolean} [props.requiredIndicator] - If true, displays an asterisk (*) to indicate a required field.
- * @param {string} [props.className] - Additional CSS class names.
- * @param {React.ReactNode|import("./Tooltip").TooltipContentObject} [props.tooltip] - Tooltip content for the label.
- * @param {Object} [props.rest] - Additional props to be spread onto the label element.
- *
- * @returns {JSX.Element} The rendered label component with optional required indicator.
- */
-declare function Label(props?: {
-    children: React.ReactNode;
-    id?: string;
-    hidden?: boolean;
-    requiredIndicator?: boolean;
-    className?: string;
-    tooltip?: React.ReactNode | import("./Tooltip").TooltipContentObject;
-    rest?: any;
-}): JSX.Element;
+declare function Label(props?: {}): import("react/jsx-runtime").JSX.Element;
 //# sourceMappingURL=Label.d.ts.map

package/dist/types/components/Label.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Label.d.ts","sourceRoot":"","sources":["../../../components/Label.js"],"names":[],"mappings":";AAaA;;;;;;;;;;;;;;;;GAgBG;AAEH,+BAXG;IAA+B,QAAQ,EAA/B,KAAK,CAAC,SAAS;IACA,EAAE,GAAjB,MAAM;IACU,MAAM,GAAtB,OAAO;IACS,iBAAiB,GAAjC,OAAO;IACQ,SAAS,GAAxB,MAAM;IAC2D,OAAO,GAAxE,KAAK,CAAC,SAAS,GAAC,OAAO,WAAW,EAAE,oBAAoB;IACzC,IAAI;CAE3B,GAAU,GAAG,CAAC,OAAO,CAiDvB"}
+{"version":3,"file":"Label.d.ts","sourceRoot":"","sources":["../../../components/Label.js"],"names":[],"mappings":";AAwCA,4EA8CC"}

package/dist/types/components/Layout.d.ts

@@ -1,32 +1,41 @@
-export const LayoutContext: React.Context<any>;
-export default Layout;
-import React from "react";
 /**
- * Layout component for structuring content.
+ * @component Layout
+ *
+ * @description A two-column page layout component with a primary content area and optional sidebar, used for settings and detail pages.
+ *
+ * @usage
+ * - DO: Use for two-column page layouts with a primary content area and sidebar.
+ * - DON'T: Use for single-column content (use `Stack` or `Card` instead).
+ *
+ * @accessibility
+ * - Content areas maintain logical reading order regardless of visual layout.
  *
- * The `Layout` component organizes its children into a flexible and responsive layout.
- * If no `Layout.Section` or `Layout.AnnotatedSection` children are found, it wraps the
- * children inside a default `Layout.Section`.
+ * @alternative
+ * - If you need a CSS grid with custom columns, use `Grid`.
+ * - If you need a single-column layout, use `Stack`.
  *
  * @param {Object} props - Component props.
  * @param {React.ReactNode} props.children - The content to render inside the layout.
  * @param {boolean} [props.reverseOnMobile] - If true, reverses the flex direction on mobile devices.
+ * @param {boolean} [props.scrollSectionsIndependently=false] - When true, caps the layout
+ *   height to the viewport and makes each section scroll its content independently.
+ *   Only applies at the @lg container breakpoint when sections are side-by-side.
+ *   When inside a Page, automatically removes Page content padding for full-bleed.
  * @returns {JSX.Element} The rendered layout component.
  */
-declare function Layout(props?: {
-    children: React.ReactNode;
-    reverseOnMobile?: boolean;
-}): JSX.Element;
+export const LayoutContext: React.Context<any>;
+export default Layout;
+import React from "react";
+declare function Layout(props?: {}): import("react/jsx-runtime").JSX.Element;
 declare namespace Layout {
     export { AnnotatedSection };
     export { Section };
 }
 /**
- * AnnotatedSection component for displaying a titled section with optional description.
+ * @component Layout.AnnotatedSection
  *
- * The `AnnotatedSection` organizes content into two main areas:
- * - Annotation: Displays a title and description.
- * - Content: Displays the main content provided as children.
+ * @usage
+ * - DO: Use for settings pages where each section has a title and description alongside form content.
  *
  * @param {Object} props - Component props.
  * @param {React.ReactNode} props.children - The main content of the section.

package/dist/types/components/Layout.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Layout.d.ts","sourceRoot":"","sources":["../../../components/Layout.js"],"names":[],"mappings":"AAQA,+CAA6C;;kBANC,OAAO;AA2CrD;;;;;;;;;;;GAWG;AACH,gCAJG;IAA+B,QAAQ,EAA/B,KAAK,CAAC,SAAS;IACC,eAAe,GAA/B,OAAO;CACf,GAAU,GAAG,CAAC,OAAO,CAoDvB;;;;;AAeD;;;;;;;;;;;;GAYG;AACH,0CALG;IAA+B,QAAQ,EAA/B,KAAK,CAAC,SAAS;IACgB,KAAK,GAApC,MAAM,GAAC,KAAK,CAAC,SAAS;IACS,WAAW,GAA1C,MAAM,GAAC,KAAK,CAAC,SAAS;CAC9B,GAAU,GAAG,CAAC,OAAO,CAevB;;;;oBAhJmB,iBAAiB"}
+{"version":3,"file":"Layout.d.ts","sourceRoot":"","sources":["../../../components/Layout.js"],"names":[],"mappings":"AAQA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,+CAA6C;;kBAhCC,OAAO;AAwFrD,6EAqDC;;;;;AAeD;;;;;;;;;;;GAWG;AACH,0CALG;IAA+B,QAAQ,EAA/B,KAAK,CAAC,SAAS;IACgB,KAAK,GAApC,MAAM,GAAC,KAAK,CAAC,SAAS;IACS,WAAW,GAA1C,MAAM,GAAC,KAAK,CAAC,SAAS;CAC9B,GAAU,GAAG,CAAC,OAAO,CAmBvB;;;;oBAvLmB,iBAAiB"}

package/dist/types/components/LayoutSection.d.ts

@@ -1,24 +1,6 @@
 export default Section;
-/**
- * Section component for flexible content grouping.
- *
- * The `Section` allows for configuring its layout, supporting sidebar and slim variants.
- *
- * @param {Object} props - Component props.
- * @param {React.ReactNode} props.children - The content to render inside the section.
- * @param {boolean|"slim"} [props.sidebar=false] - Configures the section layout:
- *  - `true`: Makes it a sidebar with a 1/3 basis.
- *  - `"slim"`: Makes it a slim sidebar with a max width of 320px.
- *  - `false`: Allows it to grow.
- * @params {boolean|integer} props.sticky - Specify whether the section becomes sticky or not
- * @returns {JSX.Element} The rendered section component.
- */
-declare function Section(props?: {
-    children: React.ReactNode;
-    sidebar?: boolean | "slim";
-}): JSX.Element;
+declare function Section(props?: {}): import("react/jsx-runtime").JSX.Element;
 declare namespace Section {
     let displayName: string;
 }
-import React from "react";
 //# sourceMappingURL=LayoutSection.d.ts.map

package/dist/types/components/LayoutSection.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"LayoutSection.d.ts","sourceRoot":"","sources":["../../../components/LayoutSection.js"],"names":[],"mappings":";AAgDA;;;;;;;;;;;;;GAaG;AACH,iCARG;IAA+B,QAAQ,EAA/B,KAAK,CAAC,SAAS;IACQ,OAAO,GAA9B,OAAO,GAAC,MAAM;CAItB,GACU,GAAG,CAAC,OAAO,CA8BvB;;;;kBAxFiC,OAAO"}
+{"version":3,"file":"LayoutSection.d.ts","sourceRoot":"","sources":["../../../components/LayoutSection.js"],"names":[],"mappings":";AA0HA,8EA6BC"}

package/dist/types/components/Link.d.ts

@@ -1,41 +1,5 @@
 export default Link;
-/**
- * Renders an accessible link with customizable styling based on variants.
- *
- * @param {Object} props - Props for the Link component.
- * @param {string} props.url - The URL the link points to.
- * @param {React.ReactNode} props.children - Content to display within the link.
- * @param {Function} [props.onClick] - Optional click event handler for the link.
- * @param {boolean} [props.external=false] - If true, opens the link in a new tab.
- * @param {boolean} [props.insight=false] - If true, set the color and iconColor to insight
- * @param {string} [props.target] - Optional target attribute for specifying where to open the link.
- * @param {string} [props.id] - Optional id attribute for the link.
- * @param {boolean} [props.monochrome=false] - If true, applies monochrome color scheme.
- * @param {boolean} [props.removeUnderline=false] - If true, removes underline from the link.
- * @param {string} [props.accessibilityLabel] - Optional aria-label for accessibility.
- * @param {string} [props.dataPrimaryLink] - Optional data attribute for custom tracking.
- * @param {Function} [props.onMouseEnter] - Optional mouse enter event handler for the link.
- * @param {Function} [props.onMouseLeave] - Optional mouse leave event handler for the link.
- * @param {React.ReactNode} [props.icon] - Optional icon to display within the link.
- *
- * @returns {JSX.Element} Rendered link element.
- */
-declare function Link(props?: {
-    url: string;
-    children: React.ReactNode;
-    onClick?: Function;
-    external?: boolean;
-    insight?: boolean;
-    target?: string;
-    id?: string;
-    monochrome?: boolean;
-    removeUnderline?: boolean;
-    accessibilityLabel?: string;
-    dataPrimaryLink?: string;
-    onMouseEnter?: Function;
-    onMouseLeave?: Function;
-    icon?: React.ReactNode;
-}): JSX.Element;
+declare function Link(props?: {}): import("react/jsx-runtime").JSX.Element;
 declare namespace Link {
     let displayName: string;
 }

package/dist/types/components/Link.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Link.d.ts","sourceRoot":"","sources":["../../../components/Link.js"],"names":[],"mappings":";AA8CA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,8BAlBG;IAAsB,GAAG,EAAjB,MAAM;IACiB,QAAQ,EAA/B,KAAK,CAAC,SAAS;IACE,OAAO;IACR,QAAQ,GAAxB,OAAO;IACS,OAAO,GAAvB,OAAO;IACQ,MAAM,GAArB,MAAM;IACS,EAAE,GAAjB,MAAM;IACU,UAAU,GAA1B,OAAO;IACS,eAAe,GAA/B,OAAO;IACQ,kBAAkB,GAAjC,MAAM;IACS,eAAe,GAA9B,MAAM;IACW,YAAY;IACZ,YAAY;IACL,IAAI,GAA5B,KAAK,CAAC,SAAS;CAEvB,GAAU,GAAG,CAAC,OAAO,CAwDvB"}
+{"version":3,"file":"Link.d.ts","sourceRoot":"","sources":["../../../components/Link.js"],"names":[],"mappings":";AAiFA,2EAqDC"}

package/dist/types/components/List.d.ts

@@ -1,25 +1,13 @@
 export default List;
-/**
- * List component for rendering unordered or ordered lists.
- *
- * @param {Object} props - Component props.
- * @param {React.ReactNode} props.children - The list items to render inside the list.
- * @param {'normal' | 'loose' | 'tight'} [props.spacing='normal'] - Controls vertical spacing between list items.
- * @param {'bullet' | 'number'} [props.type='bullet'] - Determines list type: bullet (unordered) or number (ordered).
- * @param {string} [props.className] - Additional class names to apply to the list container.
- * @returns {JSX.Element} The rendered List component.
- */
-declare function List(props?: {
-    children: React.ReactNode;
-    spacing?: "normal" | "loose" | "tight";
-    type?: "bullet" | "number";
-    className?: string;
-}): JSX.Element;
+declare function List(props?: {}): import("react/jsx-runtime").JSX.Element;
 declare namespace List {
     export { Item };
 }
 /**
- * Item component for individual list items in the List component.
+ * @component List.Item
+ *
+ * @usage
+ * - DO: Use as direct children of List for each list entry.
  *
  * @param {Object} props - Component props.
  * @param {React.ReactNode} props.children - The content of the list item.

package/dist/types/components/List.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"List.d.ts","sourceRoot":"","sources":["../../../components/List.js"],"names":[],"mappings":";AAkBA;;;;;;;;;GASG;AAEH,8BAPG;IAA+B,QAAQ,EAA/B,KAAK,CAAC,SAAS;IACsB,OAAO,GAA5C,QAAQ,GAAG,OAAO,GAAG,OAAO;IACA,IAAI,GAAhC,QAAQ,GAAG,QAAQ;IACJ,SAAS,GAAxB,MAAM;CACd,GAAU,GAAG,CAAC,OAAO,CAqBvB;;;;AAMD;;;;;;;GAOG;AAEH,8BALG;IAA+B,QAAQ,EAA/B,KAAK,CAAC,SAAS;IACA,SAAS,GAAxB,MAAM;CACd,GAAU,GAAG,CAAC,OAAO,CAgBvB"}
+{"version":3,"file":"List.d.ts","sourceRoot":"","sources":["../../../components/List.js"],"names":[],"mappings":";AA0CA,2EAkBC;;;;AAMD;;;;;;;;;;GAUG;AAEH,8BALG;IAA+B,QAAQ,EAA/B,KAAK,CAAC,SAAS;IACA,SAAS,GAAxB,MAAM;CACd,GAAU,GAAG,CAAC,OAAO,CAgBvB"}

package/dist/types/components/Listbox.d.ts

@@ -1,34 +1,3 @@
 export default Listbox;
-/**
- * A customizable Listbox component for displaying a list of options with selectable states.
- * The component supports keyboard navigation and optional icons for selected items.
- *
- * @component
- * @param {Object} props - The properties object.
- * @param {Array<Object>} props.options - Array of options to render in the listbox.
- * Each option should be an object with the following properties:
- *   - `label` {string}: The display label of the option.
- *   - `value` {string | number}: The unique value of the option.
- *   - `selected` {boolean}: Whether the option is currently selected.
- *   - `onAction` {function}: A callback function invoked when the option is clicked or "Enter" is pressed.
- * @param {boolean} [props.showIcon=false] - Determines whether to display an icon next to selected options.
- * @param {React.ReactNode} [props.icon=MobileAcceptMajor] - The icon to display for selected options (default is `MobileAcceptMajor`).
- * @param {boolean} [props.displayHorizontallyOnMobile=false] - Determines whether to display the listbox horizontally on mobile.
- *
- * @example
- * const options = [
- *   { label: "Option 1", value: "opt1", selected: false, onAction: () => console.log("Option 1 clicked") },
- *   { label: "Option 2", value: "opt2", selected: true, onAction: () => console.log("Option 2 clicked") },
- * ];
- *
- * <Listbox options={options} showIcon={true} icon={CustomIcon} />
- *
- * @returns {JSX.Element} The rendered Listbox component.
- */
-declare function Listbox(props?: {
-    options: Array<any>;
-    showIcon?: boolean;
-    icon?: React.ReactNode;
-    displayHorizontallyOnMobile?: boolean;
-}): JSX.Element;
+declare function Listbox(props?: {}): import("react/jsx-runtime").JSX.Element;
 //# sourceMappingURL=Listbox.d.ts.map

package/dist/types/components/Listbox.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Listbox.d.ts","sourceRoot":"","sources":["../../../components/Listbox.js"],"names":[],"mappings":";AAuCA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,iCApBG;IAA6B,OAAO,EAA5B,KAAK,KAAQ;IAMG,QAAQ,GAAxB,OAAO;IACiB,IAAI,GAA5B,KAAK,CAAC,SAAS;IACC,2BAA2B,GAA3C,OAAO;CAEf,GAQU,GAAG,CAAC,OAAO,CA8FvB"}
+{"version":3,"file":"Listbox.d.ts","sourceRoot":"","sources":["../../../components/Listbox.js"],"names":[],"mappings":";AA8EA,8EAmGC"}

package/dist/types/components/Loading.d.ts

@@ -1,8 +1,20 @@
 export default Loading;
 /**
- * A loading progress bar component that animates over a specified duration.
+ * @component Loading
+ *
+ * @description A page-level progress bar that animates across the top of the viewport during navigation or data fetching.
+ *
+ * @usage
+ * - DO: Use as a page-level loading indicator at the top of the viewport during navigation or data fetching.
+ * - DON'T: Use for inline or localized loading states; use `Spinner` for those cases.
+ *
+ * @accessibility
+ * - The progress bar is purely visual; pair with `aria-busy` on the loading container if screen reader announcements are needed.
+ *
+ * @alternative
+ * - If you need an inline loading indicator, use `Spinner` instead.
+ * - If you need placeholder content while data loads, use `SkeletonText` instead.
  *
- * @component
  * @param {Object} props - The props object.
  * @param {number} [props.maxDuration=10000] - The maximum duration (in milliseconds) for the loading progress bar to reach 100%.
  * @returns {JSX.Element} A fixed progress bar displayed at the top of the page.

package/dist/types/components/Loading.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Loading.d.ts","sourceRoot":"","sources":["../../../components/Loading.js"],"names":[],"mappings":";AAIA;;;;;;;GAOG;AACH,iCAHG;IAAuB,WAAW,GAA1B,MAAM;CACd,GAAU,GAAG,CAAC,OAAO,CAqCvB"}
+{"version":3,"file":"Loading.d.ts","sourceRoot":"","sources":["../../../components/Loading.js"],"names":[],"mappings":";AAIA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,iCAHG;IAAuB,WAAW,GAA1B,MAAM;CACd,GAAU,GAAG,CAAC,OAAO,CAqCvB"}

package/dist/types/components/Modal.d.ts

@@ -1,8 +1,19 @@
-export const ModalContext: React.Context<boolean>;
-export default Modal;
-import React from "react";
 /**
- * Modal component for displaying a customizable dialog.
+ * @component Modal
+ *
+ * @description A dialog overlay that focuses the user on a specific task or confirmation, with header, body sections, and footer actions.
+ *
+ * @usage
+ * - DO: Use for focused tasks that require user attention or input, like confirmations or forms.
+ * - DON'T: Use for content that should remain accessible while reading the page (use Pane).
+ *
+ * @accessibility
+ * - Traps focus within the modal when open; supports Escape key dismissal.
+ * - Ensure `title` provides context for screen readers.
+ *
+ * @alternative
+ * - If you need a side panel that doesn't block the page, use `Pane`.
+ * - If you need inline messaging, use `Banner`.
  *
  * @param {Object} props - The component props.
  * @param {React.ReactNode} [props.children] - The content of the modal.
@@ -30,52 +41,32 @@ import React from "react";
  * @param {Function} [props.backAction] - Callback function for the back button. When provided, displays a back button next to the title.
  * @param {number} [props.zIndexOverride=1000] - The z-index of the modal.
  * @param {boolean} [props.autoFocusFirstInput=true] - Whether to focus the first input when the modal opens.
+ * @param {boolean} [props.pinToTop=false] - Whether to pin the modal to the top of the viewport instead of centering it vertically. Useful when modal content changes height dynamically.
  * @param {string} [props.bodyClassName] - Additional CSS classes to apply to the modal body.
  * @returns {React.ReactPortal|null} The rendered modal component or null if not open.
  */
-declare function Modal(props?: {
-    children?: React.ReactNode;
-    title?: string;
-    subtitle?: string;
-    open?: boolean;
-    onClose?: Function;
-    sectioned?: boolean;
-    primaryAction?: {
-        content?: string;
-        onAction?: Function;
-        loading?: boolean;
-        disabled?: boolean;
-        destructive?: boolean;
-    };
-    secondaryAction?: {
-        content?: string;
-        onAction?: Function;
-        disabled?: boolean;
-    };
-    secondaryActions?: any[];
-    destructiveAction?: any;
-    loading?: boolean;
-    size?: string;
-    leftAccessory?: React.ReactNode;
-    hideCloseButton?: boolean;
-    backAction?: Function;
-    zIndexOverride?: number;
-    autoFocusFirstInput?: boolean;
-    bodyClassName?: string;
-}): React.ReactPortal | null;
+export const ModalContext: React.Context<boolean>;
+export default Modal;
+import React from "react";
+declare function Modal(props?: {}): React.ReactPortal;
 declare namespace Modal {
     export { Section };
 }
 /**
- * Section component for use within the Modal.
+ * @component Modal.Section
+ *
+ * @usage
+ * - DO: Divide modal content into bordered sections for visual separation.
  *
  * @param {Object} props - The component props.
  * @param {React.ReactNode} [props.children] - The content of the section.
  * @param {boolean} [props.flush=false] - Whether the section should be flush with no padding.
+ * @param {string} [props.className] - Additional CSS classes to apply to the section.
  * @returns {JSX.Element} The rendered section.
  */
 declare function Section(props?: {
     children?: React.ReactNode;
     flush?: boolean;
+    className?: string;
 }): JSX.Element;
 //# sourceMappingURL=Modal.d.ts.map

package/dist/types/components/Modal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Modal.d.ts","sourceRoot":"","sources":["../../../components/Modal.js"],"names":[],"mappings":"AAcA,kDAAiD;;kBAXkC,OAAO;AAiE1F;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,+BA7BG;IAAgC,QAAQ,GAAhC,KAAK,CAAC,SAAS;IACA,KAAK,GAApB,MAAM;IACS,QAAQ,GAAvB,MAAM;IACU,IAAI,GAApB,OAAO;IACU,OAAO;IACR,SAAS,GAAzB,OAAO;IACQ,aAAa,GACpC;QAAqC,OAAO,GAApC,MAAM;QACyB,QAAQ;QACT,OAAO,GAArC,OAAO;QACuB,QAAQ,GAAtC,OAAO;QACuB,WAAW,GAAzC,OAAO;KACf;IAAuB,eAAe,GACtC;QAAuC,OAAO,GAAtC,MAAM;QAC2B,QAAQ;QACT,QAAQ,GAAxC,OAAO;KACf;IAAyB,gBAAgB,GAAjC,KAAQ;IACO,iBAAiB;IAChB,OAAO,GAAvB,OAAO;IACQ,IAAI,GAAnB,MAAM;IACkB,aAAa,GAArC,KAAK,CAAC,SAAS;IACC,eAAe,GAA/B,OAAO;IACU,UAAU;IACZ,cAAc,GAA7B,MAAM;IACU,mBAAmB,GAAnC,OAAO;IACQ,aAAa,GAA5B,MAAM;CACd,GAAU,KAAK,CAAC,WAAW,GAAC,IAAI,CA0MlC;;;;AAED;;;;;;;GAOG;AAEH,iCALG;IAAgC,QAAQ,GAAhC,KAAK,CAAC,SAAS;IACC,KAAK,GAArB,OAAO;CACf,GAAU,GAAG,CAAC,OAAO,CA0EvB"}
+{"version":3,"file":"Modal.d.ts","sourceRoot":"","sources":["../../../components/Modal.js"],"names":[],"mappings":"AAcA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AAEH,kDAAiD;;kBA3DkC,OAAO;AA+H1F,sDA0MC;;;;AAED;;;;;;;;;;;GAWG;AAEH,iCANG;IAAgC,QAAQ,GAAhC,KAAK,CAAC,SAAS;IACC,KAAK,GAArB,OAAO;IACQ,SAAS,GAAxB,MAAM;CACd,GAAU,GAAG,CAAC,OAAO,CA4EvB"}

package/dist/types/components/Navigation.d.ts

@@ -1,29 +1,5 @@
 export default Navigation;
-/**
- * Navigation component.
- * A sidebar navigation component for displaying links, sections, and footer links.
- *
- * @component
- * @param {Object} props - Component properties.
- * @param {Object} [props.breadcrumb] - Breadcrumb navigation item.
- * @param {string} [props.breadcrumb.content] - Label for the breadcrumb.
- * @param {Function} [props.breadcrumb.onAction] - Callback for breadcrumb action.
- * @param {Array<Object>} [props.sections] - Array of navigation sections.
- * @param {Object} [props.sections[].title] - Section title configuration.
- * @param {string} [props.sections[].title.label] - Title label.
- * @param {boolean} [props.sections[].title.selected] - Whether the title is selected.
- * @param {Function} [props.sections[].title.onAction] - Callback for title action.
- * @param {Array<Object>} [props.sections[].links] - Array of link configurations for the section.
- * @param {Array<Object>} [props.footerLinks] - Array of footer link configurations.
- * @returns {JSX.Element} The rendered Navigation component.
- */
-declare function Navigation(props?: {
-    breadcrumb?: {
-        content?: string;
-        onAction?: Function;
-    };
-    sections?: Array<any>;
-}): JSX.Element;
+declare function Navigation(props?: {}): import("react/jsx-runtime").JSX.Element;
 declare namespace Navigation {
     export { Link };
     export { SubLink };

package/dist/types/components/Navigation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Navigation.d.ts","sourceRoot":"","sources":["../../../components/Navigation.js"],"names":[],"mappings":";AA4BA;;;;;;;;;;;;;;;;;GAiBG;AAEH,oCAbG;IAAuB,UAAU,GACjC;QAAkC,OAAO,GAAjC,MAAM;QACsB,QAAQ;KAC5C;IAA8B,QAAQ,GAA9B,KAAK,KAAQ;CACrB,GAMU,GAAG,CAAC,OAAO,CAmEvB;;;;;AAoBD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,8BApBG;IAAwB,QAAQ,GAAxB,OAAO;IACS,SAAS,GAAzB,OAAO;IACe,QAAQ,GAA9B,KAAK,KAAQ;IACG,0BAA0B,GAA1C,OAAO;IACS,gBAAgB,GAAhC,OAAO;IACS,gBAAgB,GAAhC,OAAO;IACU,QAAQ;IACD,MAAM,GAA9B,KAAK,CAAC,SAAS;IACS,IAAI,GAA5B,KAAK,CAAC,SAAS;IACA,KAAK,GAApB,MAAM;IACS,KAAK,GAC5B;QAA6B,MAAM,GAA3B,MAAM;QACe,KAAK,GAA1B,MAAM;KACd;IAAwB,QAAQ,GAAxB,OAAO;IACS,UAAU,GAA1B,OAAO;IACQ,WAAW,GAA1B,MAAM;IACU,kBAAkB,GAAlC,OAAO;IACiB,SAAS,GAAjC,KAAK,CAAC,SAAS;CACvB,GAAU,GAAG,CAAC,OAAO,CAoGvB;AAgBD;;;;;;;;;;;;;;;GAeG;AACH,iCAVG;IAAwB,QAAQ,GAAxB,OAAO;IACU,QAAQ;IACV,KAAK,GAApB,MAAM;IACS,KAAK,GAC5B;QAA6B,MAAM,GAA3B,MAAM;QACe,KAAK,GAA1B,MAAM;KACd;IAAwB,kBAAkB,GAAlC,OAAO;IACiB,SAAS,GAAjC,KAAK,CAAC,SAAS;CACvB,GAAU,GAAG,CAAC,OAAO,CAuCvB;kBApUiB,OAAO"}
+{"version":3,"file":"Navigation.d.ts","sourceRoot":"","sources":["../../../components/Navigation.js"],"names":[],"mappings":";AAyDA,iFAgFC;;;;;AAoBD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,8BApBG;IAAwB,QAAQ,GAAxB,OAAO;IACS,SAAS,GAAzB,OAAO;IACe,QAAQ,GAA9B,KAAK,KAAQ;IACG,0BAA0B,GAA1C,OAAO;IACS,gBAAgB,GAAhC,OAAO;IACS,gBAAgB,GAAhC,OAAO;IACU,QAAQ;IACD,MAAM,GAA9B,KAAK,CAAC,SAAS;IACS,IAAI,GAA5B,KAAK,CAAC,SAAS;IACA,KAAK,GAApB,MAAM;IACS,KAAK,GAC5B;QAA6B,MAAM,GAA3B,MAAM;QACe,KAAK,GAA1B,MAAM;KACd;IAAwB,QAAQ,GAAxB,OAAO;IACS,UAAU,GAA1B,OAAO;IACQ,WAAW,GAA1B,MAAM;IACU,kBAAkB,GAAlC,OAAO;IACiB,SAAS,GAAjC,KAAK,CAAC,SAAS;CACvB,GAAU,GAAG,CAAC,OAAO,CAiHvB;AAgBD;;;;;;;;;;;;;;;GAeG;AACH,iCAVG;IAAwB,QAAQ,GAAxB,OAAO;IACU,QAAQ;IACV,KAAK,GAApB,MAAM;IACS,KAAK,GAC5B;QAA6B,MAAM,GAA3B,MAAM;QACe,KAAK,GAA1B,MAAM;KACd;IAAwB,kBAAkB,GAAlC,OAAO;IACiB,SAAS,GAAjC,KAAK,CAAC,SAAS;CACvB,GAAU,GAAG,CAAC,OAAO,CAoDvB;kBAxXiB,OAAO"}

package/dist/types/components/Page.d.ts

@@ -1,59 +1,3 @@
 export default Page;
-/**
- * Page component that provides a structured layout with a header, primary and secondary actions, and content.
- *
- * @component
- *
- * @param {Object} props - Props for the component.
- * @param {string|React.ReactNode} props.title - The title of the page. Can be a string or React element.
- * @param {string|React.ReactNode} props.subtitle - The subtitle of the page. Can be a string or React element.
- * @param {Object} [props.backAction] - Configuration for the back action button.
- * @param {Function} [props.backAction.onAction] - Callback when the back action is triggered.
- * @param {string} [props.backAction.accessibilityLabel] - Accessibility label for the back action button.
- * @param {boolean} [props.narrowWidth=false] - Whether to use a narrow width layout.
- * @param {boolean} [props.fullWidth=false] - Whether to use a full-width layout.
- * @param {boolean} [props.showTitleInTopBar=true] - Whether to show the title in the top bar area.
- * @param {boolean} [props.wrapInContentContainer=true] - Whether to wrap the content in a container with padding.
- * @param {Object} [props.primaryAction] - Configuration for the primary action button.
- * @param {Function} [props.primaryAction.onAction] - Callback when the primary action is triggered.
- * @param {boolean} [props.primaryAction.loading] - Whether the primary action button is in a loading state.
- * @param {boolean} [props.primaryAction.disabled] - Whether the primary action button is disabled.
- * @param {boolean} [props.primaryAction.destructive] - Whether the primary action button is styled as destructive.
- * @param {string} [props.primaryAction.tooltip] - Tooltip to show when hovering over the primary action button.
- * @param {React.ReactNode} [props.primaryAction.content="Save"] - Content for the primary action button.
- * @param {Object[]} [props.secondaryActions=[]] - List of secondary actions.
- * @param {string} [props.moreActionsLabel="Actions"] - Label for the "More Actions" button in mobile view.
- * @param {React.ReactNode} [props.titleMetadata] - Metadata displayed alongside the title.
- * @param {React.ReactNode} [props.children] - Content for the main section of the page.
- * @param {Object} [props.footerActions] - Configuration for the footer actions.
- * @param {string} [props.className] - Additional CSS classes for the Page.
- * @returns {React.ReactElement} Rendered Page component.
- */
-declare function Page(props?: {
-    title: string | React.ReactNode;
-    subtitle: string | React.ReactNode;
-    backAction?: {
-        onAction?: Function;
-        accessibilityLabel?: string;
-    };
-    narrowWidth?: boolean;
-    fullWidth?: boolean;
-    showTitleInTopBar?: boolean;
-    wrapInContentContainer?: boolean;
-    primaryAction?: {
-        onAction?: Function;
-        loading?: boolean;
-        disabled?: boolean;
-        destructive?: boolean;
-        tooltip?: string;
-        content?: React.ReactNode;
-    };
-    secondaryActions?: any[];
-    moreActionsLabel?: string;
-    titleMetadata?: React.ReactNode;
-    children?: React.ReactNode;
-    footerActions?: any;
-    className?: string;
-}): React.ReactElement;
-import React from "react";
+declare function Page(props?: {}): import("react/jsx-runtime").JSX.Element;
 //# sourceMappingURL=Page.d.ts.map

package/dist/types/components/Page.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Page.d.ts","sourceRoot":"","sources":["../../../components/Page.js"],"names":[],"mappings":";AA0FA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,8BAzBG;IAAsC,KAAK,EAAnC,MAAM,GAAC,KAAK,CAAC,SAAS;IACQ,QAAQ,EAAtC,MAAM,GAAC,KAAK,CAAC,SAAS;IACP,UAAU,GACjC;QAAoC,QAAQ;QACV,kBAAkB,GAA5C,MAAM;KACd;IAAwB,WAAW,GAA3B,OAAO;IACS,SAAS,GAAzB,OAAO;IACS,iBAAiB,GAAjC,OAAO;IACS,sBAAsB,GAAtC,OAAO;IACQ,aAAa,GACpC;QAAuC,QAAQ;QACT,OAAO,GAArC,OAAO;QACuB,QAAQ,GAAtC,OAAO;QACuB,WAAW,GAAzC,OAAO;QACsB,OAAO,GAApC,MAAM;QACgC,OAAO,GAA7C,KAAK,CAAC,SAAS;KACvB;IAAyB,gBAAgB,GAAjC,KAAQ;IACO,gBAAgB,GAA/B,MAAM;IACkB,aAAa,GAArC,KAAK,CAAC,SAAS;IACS,QAAQ,GAAhC,KAAK,CAAC,SAAS;IACA,aAAa;IACb,SAAS,GAAxB,MAAM;CACd,GAAU,KAAK,CAAC,YAAY,CAwR9B;kBA5YuC,OAAO"}
+{"version":3,"file":"Page.d.ts","sourceRoot":"","sources":["../../../components/Page.js"],"names":[],"mappings":";AAmIA,2EAwRC"}

package/dist/types/components/Pagination.d.ts

@@ -1,9 +1,19 @@
 export default Pagination;
 /**
- * Pagination component for navigating between pages or steps.
- * Provides support for next and previous navigation with optional tooltips.
+ * @component Pagination
+ *
+ * @description A page navigation component with previous/next controls and optional page number display for paginated content.
+ *
+ * @usage
+ * - DO: Use for navigating between pages of paginated content.
+ * - DON'T: Use for in-page section navigation (use Tabs).
+ *
+ * @accessibility
+ * - Pagination buttons should have descriptive labels ("Previous page", "Next page"); disabled states are communicated to screen readers.
+ *
+ * @alternative
+ * - If you need tab-based content switching, use `Tabs`. If you need infinite scroll, implement custom scroll handling.
  *
- * @component
  * @param {Object} props - The properties for the Pagination component.
  * @param {boolean} [props.hasNext] - Indicates whether there is a next page/step.
  * @param {boolean} [props.hasPrevious] - Indicates whether there is a previous page/step.

package/dist/types/components/Pagination.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Pagination.d.ts","sourceRoot":"","sources":["../../../components/Pagination.js"],"names":[],"mappings":";AAKA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,oCAtBG;IAAwB,OAAO,GAAvB,OAAO;IACS,WAAW,GAA3B,OAAO;IACQ,OAAO,GAAtB,MAAM;IACS,WAAW,GAA1B,MAAM;IACW,MAAM;IACN,UAAU;IACZ,WAAW,GAA1B,MAAM;IACS,eAAe,GAA9B,MAAM;CAEd,2CA8DF"}
+{"version":3,"file":"Pagination.d.ts","sourceRoot":"","sources":["../../../components/Pagination.js"],"names":[],"mappings":";AAKA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAEH,oCAtBG;IAAwB,OAAO,GAAvB,OAAO;IACS,WAAW,GAA3B,OAAO;IACQ,OAAO,GAAtB,MAAM;IACS,WAAW,GAA1B,MAAM;IACW,MAAM;IACN,UAAU;IACZ,WAAW,GAA1B,MAAM;IACS,eAAe,GAA9B,MAAM;CAEd,2CAqEF"}

package/dist/types/components/Pane.d.ts

@@ -7,7 +7,59 @@ declare namespace Pane {
     export { Content };
     export { Footer };
 }
-declare function Header(props?: {}): import("react/jsx-runtime").JSX.Element;
-declare function Content(props?: {}): import("react/jsx-runtime").JSX.Element;
-declare function Footer(props?: {}): import("react/jsx-runtime").JSX.Element;
+/**
+ * @component Pane.Header
+ *
+ * @usage
+ * - DO: Provide title and close action for the pane.
+ *
+ * @param {Object} props - Component properties.
+ * @param {string|React.ReactNode} [props.title] - Title text or custom element for the header.
+ * @param {string|React.ReactNode} [props.subtitle] - Subtitle text or custom element.
+ * @param {Array<Object>} [props.actions=[]] - Array of action button configurations.
+ * @param {boolean} [props.bottomBorder=true] - Whether to show a bottom border.
+ * @param {React.ReactNode} [props.subHeader] - Additional content rendered below the header row.
+ * @param {Object} [props.backAction] - Back navigation action with onAction callback and accessibilityLabel.
+ * @returns {JSX.Element} The rendered Pane.Header component.
+ */
+declare function Header(props?: {
+    title?: string | React.ReactNode;
+    subtitle?: string | React.ReactNode;
+    actions?: Array<any>;
+    bottomBorder?: boolean;
+    subHeader?: React.ReactNode;
+    backAction?: any;
+}): JSX.Element;
+/**
+ * @component Pane.Content
+ *
+ * @usage
+ * - DO: Wrap scrollable content within the pane.
+ *
+ * @param {Object} props - Component properties.
+ * @param {React.ReactNode} props.children - Content to render inside the pane body.
+ * @param {boolean} [props.padded=true] - Whether to apply padding to the content area.
+ * @param {string} [props.className] - Additional CSS class names.
+ * @returns {JSX.Element} The rendered Pane.Content component.
+ */
+declare function Content(props?: {
+    children: React.ReactNode;
+    padded?: boolean;
+    className?: string;
+}): JSX.Element;
+/**
+ * @component Pane.Footer
+ *
+ * @usage
+ * - DO: Place action buttons at the bottom of the pane.
+ *
+ * @param {Object} props - Component properties.
+ * @param {React.ReactNode} props.children - Content to render inside the footer.
+ * @param {boolean} [props.topBorder=true] - Whether to show a top border.
+ * @returns {JSX.Element} The rendered Pane.Footer component.
+ */
+declare function Footer(props?: {
+    children: React.ReactNode;
+    topBorder?: boolean;
+}): JSX.Element;
 //# sourceMappingURL=Pane.d.ts.map

package/dist/types/components/Pane.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Pane.d.ts","sourceRoot":"","sources":["../../../components/Pane.js"],"names":[],"mappings":"AAgGA,4CAA6C;;kBA5F4D,OAAO;AAqHhH,2EAwcC;;;;;;AAED,6EA6EC;AAGD,8EAKC;AAGD,6EAOC"}
+{"version":3,"file":"Pane.d.ts","sourceRoot":"","sources":["../../../components/Pane.js"],"names":[],"mappings":"AA8HA,4CAA6C;;kBA1H4D,OAAO;AAmJhH,2EAwcC;;;;;;AAED;;;;;;;;;;;;;;GAcG;AACH,gCARG;IAAuC,KAAK,GAApC,MAAM,GAAC,KAAK,CAAC,SAAS;IACS,QAAQ,GAAvC,MAAM,GAAC,KAAK,CAAC,SAAS;IACA,OAAO,GAA7B,KAAK,KAAQ;IACG,YAAY,GAA5B,OAAO;IACiB,SAAS,GAAjC,KAAK,CAAC,SAAS;IACA,UAAU;CACjC,GAAU,GAAG,CAAC,OAAO,CA+EvB;AAGD;;;;;;;;;;;GAWG;AACH,iCALG;IAA+B,QAAQ,EAA/B,KAAK,CAAC,SAAS;IACC,MAAM,GAAtB,OAAO;IACQ,SAAS,GAAxB,MAAM;CACd,GAAU,GAAG,CAAC,OAAO,CAOvB;AAGD;;;;;;;;;;GAUG;AACH,gCAJG;IAA+B,QAAQ,EAA/B,KAAK,CAAC,SAAS;IACC,SAAS,GAAzB,OAAO;CACf,GAAU,GAAG,CAAC,OAAO,CASvB"}

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

@@ -1,42 +1,12 @@
 export default Popover;
-/**
- * Popover component for displaying an overlay near an activator.
- *
- * @param {Object} props - The component props.
- * @param {string|React.ComponentType} [props.activatorWrapper="div"] - The wrapper element for the activator.
- * @param {React.ReactNode} props.activator - The activator element that triggers the popover.
- * @param {string} [props.activatorDisplayType="inline-block"] - The display type for the activator.
- * @param {React.ReactNode} props.children - The content of the popover.
- * @param {Function} [props.onClose] - Callback function triggered when the popover is closed.
- * @param {boolean} [props.active=false] - Whether the popover is currently active.
- * @param {boolean} [props.fixed=false] - Whether the popover is fixed or absolute positioned.
- * @param {number} [props.zIndexOverride] - Custom z-index for the popover.
- * @param {boolean} [props.sectioned=false] - Whether the popover content is sectioned with padding.
- * @param {string} [props.preferredAlignment="center"] - Preferred alignment for the popover (left, center, right).
- * @param {string} [props.preferredPosition="below"] - Preferred position for the popover (above, below, cover, left, right).
- * @param {string} [props.className] - Additional class name for the popover.
- * @param {string} [props.containerClassName] - Additional class name for the popover container.
- * @returns {JSX.Element} The rendered popover component.
- */
-declare function Popover(props?: {
-    activatorWrapper?: string | React.ComponentType;
-    activator: React.ReactNode;
-    activatorDisplayType?: string;
-    children: React.ReactNode;
-    onClose?: Function;
-    active?: boolean;
-    fixed?: boolean;
-    zIndexOverride?: number;
-    sectioned?: boolean;
-    preferredAlignment?: string;
-    preferredPosition?: string;
-    className?: string;
-    containerClassName?: string;
-}): JSX.Element;
+declare function Popover(props?: {}): import("react/jsx-runtime").JSX.Element;
 declare namespace Popover {
     let displayName: string;
     /**
-     * Section component for use within the Popover.
+     * @component Popover.Section
+     *
+     * @usage
+     * - DO: Use to divide Popover content into logical segments with borders.
      *
      * @param {Object} props - The component props.
      * @param {React.ReactNode} [props.children] - The content of the section.

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

@@ -1 +1 @@
-{"version":3,"file":"Popover.d.ts","sourceRoot":"","sources":["../../../components/Popover.js"],"names":[],"mappings":";AAyBA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,iCAhBG;IAA2C,gBAAgB,GAAnD,MAAM,GAAC,KAAK,CAAC,aAAa;IACH,SAAS,EAAhC,KAAK,CAAC,SAAS;IACA,oBAAoB,GAAnC,MAAM;IACiB,QAAQ,EAA/B,KAAK,CAAC,SAAS;IACE,OAAO;IACR,MAAM,GAAtB,OAAO;IACS,KAAK,GAArB,OAAO;IACQ,cAAc,GAA7B,MAAM;IACU,SAAS,GAAzB,OAAO;IACQ,kBAAkB,GAAjC,MAAM;IACS,iBAAiB,GAAhC,MAAM;IACS,SAAS,GAAxB,MAAM;IACS,kBAAkB,GAAjC,MAAM;CACd,GAAU,GAAG,CAAC,OAAO,CA2YvB;;;IAgBD;;;;;;;OAOG;IAEH,yBALG;QAAgC,QAAQ,GAAhC,KAAK,CAAC,SAAS;QACC,MAAM,GAAtB,OAAO;KACf,GAAU,GAAG,CAAC,OAAO,CAYvB;;;;;;kBArdmF,OAAO"}
+{"version":3,"file":"Popover.d.ts","sourceRoot":"","sources":["../../../components/Popover.js"],"names":[],"mappings":";AA2DA,8EAiaC;;;IAgBD;;;;;;;;;;OAUG;IAEH,yBALG;QAAgC,QAAQ,GAAhC,KAAK,CAAC,SAAS;QACC,MAAM,GAAtB,OAAO;KACf,GAAU,GAAG,CAAC,OAAO,CAYvB;;;;;;kBA/fmF,OAAO"}