@cwellt_software/cwellt-reactjs-lib 1.4.14 → 1.5.0

package/dist/index.d.ts

@@ -282,7 +282,7 @@ type ZoomImageItem = {
  */
 declare function CwImageZoom(image: ZoomImageItem): React$1.JSX.Element;
 
-interface CwIconProps extends Omit<HTMLProps<HTMLSpanElement>, "className" | "size"> {
+interface CwIconProps extends Omit<HTMLProps<HTMLSpanElement>, "size"> {
     /** Icon identifier */
     iconId: string;
     /** Color variant **/
@@ -305,50 +305,38 @@ interface CwLoadingProps {
     size?: LoadingSize;
     /** Position of the icon */
     iconPosition?: IconPosition;
-    /** Custom icon class (default: 'cwi-plane-solid') */
+    /** Custom icon class. Falls back to the global default (configureCwLoading); with none, a neutral ring is shown. */
     iconName?: string;
     /** Custom animation (default: 'spin') */
     animation?: string;
 }
 /**
- * CwLoading
+ * CwLoading — a spinner with optional text that dims the wrapped content while loading.
  *
- * A versatile loading component that shows a spinner with optional text
- * and disables the wrapped content while in loading state.
+ * Icon resolves as `iconName` prop → `getCwLoadingDefaults().icon` → none (neutral ring).
  *
  * @example
- * // Basic usage
  * <CwLoading isLoading={isSubmitting}>
  *   <form>...</form>
  * </CwLoading>
- *
- * // With custom text and size
- * <CwLoading
- *   isLoading={isLoading}
- *   text="Please wait..."
- *   size="large"
- * >
- *   <UserProfile />
- * </CwLoading>
  */
 declare function CwLoading({ isLoading, text, size, iconPosition, iconName, animation, children }: React__default.PropsWithChildren<CwLoadingProps>): React__default.JSX.Element;
 
-interface CwLoadingSmallProps {
-    isLoading?: boolean;
+/**
+ * Global, module-level defaults for CwLoading (singleton, no provider).
+ * An app sets these once at init; every CwLoading reads them at render time.
+ */
+interface CwLoadingDefaults {
+    /** Icon class applied when a CwLoading has no explicit `iconName` (e.g. 'cwi-plane-solid'). */
+    icon?: string;
 }
 /**
- * @deprecated since may 2025. Use <CwLoading size="small"> instead.
- *
- * This component will be removed in a future release.
- *
- * @example
- * // Instead of:
- * <CwLoadingSmall />
- *
- * // Use:
- * <CwLoading size="small" />
+ * Register global CwLoading defaults. Call once at app init, before the first render.
+ * Merges into any previously configured defaults.
  */
-declare function CwLoadingSmall(CwelltLoadingAppointements: React$1.PropsWithChildren<CwLoadingSmallProps>): React$1.JSX.Element;
+declare function configureCwLoading(next: CwLoadingDefaults): void;
+/** Read the currently configured CwLoading defaults. */
+declare function getCwLoadingDefaults(): CwLoadingDefaults;
 
 type TooltipPosition = "top" | "bottom" | "left" | "right";
 interface CwGenericTooltipProps {
@@ -1373,22 +1361,6 @@ interface CwTableGroupedProps {
  */
 declare const CwTableGrouped: FC<CwTableGroupedProps>;
 
-interface ConfigDM {
-    ID: number;
-    Description: string;
-    Value: string;
-    Bindata: string;
-}
-interface CwFileUploadProps {
-    accept: string;
-    acceptString: string;
-    sizeString?: string;
-    file?: ConfigDM;
-    onChange: (file: File) => void;
-    onSaveHexContent: (hexContent: string) => void;
-}
-declare function CwFileUpload(fileUploadProps: React__default.PropsWithChildren<CwFileUploadProps>): React__default.JSX.Element;
-
 interface CwFileUploadMultipleLabels {
     uploadDisabled: string;
     clickToUpload: string;
@@ -1397,6 +1369,7 @@ interface CwFileUploadMultipleLabels {
     allTypesAccepted: string;
     changeFile: string;
     clearAll: string;
+    upload: string;
     addMoreFiles: string;
     filesSelected: (count: number) => string;
     fileTooLarge: (name: string, maxSize: number) => string;
@@ -1412,10 +1385,14 @@ interface CwFileUploadMultipleProps {
     allowedTypes?: string[];
     onSelect?: (files: FileList | null) => void;
     onError?: (error: string) => void;
+    onConfirm?: (files: FileList) => void;
+    confirmLabel?: string;
+    confirmDisabled?: boolean;
     className?: string;
     disabled?: boolean;
     hideClearAll?: boolean;
     initialFileName?: string;
+    statusText?: string;
     labels?: Partial<CwFileUploadMultipleLabels>;
 }
 declare function CwFileUploadMultiple(fileUploadProps: React__default.PropsWithChildren<CwFileUploadMultipleProps>): React__default.JSX.Element;
@@ -1440,9 +1417,12 @@ declare function CwInput(CwInputProps: React__default.PropsWithChildren<CwInputP
  * CwButton - Customizable button component with variant styles, color themes, and icon support
  *
  * @param text - Button text content (displayed in <strong> tag when no children)
- * @param variant - Button style: 'solid' (default), 'outline', or 'icon'
+ * @param variant - Button style: 'solid' (default), 'outline', 'icon', or 'ghost' (low-emphasis text button: transparent, fills with the container color on hover/press)
  * @param color - Color theme: 'primary' (default), 'danger', or 'neutral'
+ * @param size - Button size: 'small', 'medium' (default), or 'large'
  * @param icon - Icon identifier for CSS classes (cwi-{icon})
+ * @param iconPosition - Icon placement relative to the text: 'left' (default, icon-then-text) or 'right' (text-then-icon). Only affects the auto icon+text rendering, not the icon variant or custom children.
+ * @param pressed - Toggle/"on" state for a toggle button. When defined, sets `aria-pressed` and a selected fill; leave undefined for a normal (non-toggle) button. The consumer owns the state (`pressed` + `onClick`).
  * @param className - Additional CSS classes
  * @param title - Built-in tooltip
  * @param tooltipPosition - Tooltip position: 'top', 'bottom' (default), 'left', 'right'
@@ -1450,20 +1430,27 @@ declare function CwInput(CwInputProps: React__default.PropsWithChildren<CwInputP
  *
  * @example
  * <CwButton text="Save" />
+ * <CwButton text="Save" size="small" />
  * <CwButton text="Delete" variant="outline" color="danger" />
  * <CwButton variant="icon" icon="edit" title="Edit item" />
  * <CwButton icon="star" text="Favorite" color="primary" />
+ * <CwButton text="Next" icon="chevron-right" iconPosition="right" />
+ * <CwButton text="Export" icon="download" variant="ghost" />
+ * <CwButton variant="icon" icon="pin" pressed={isPinned} onClick={togglePinned} title="Pin" />
  * <CwButton className="custom-class">Custom content</CwButton>
  */
-interface CwButtonProps extends React.ButtonHTMLAttributes<HTMLButtonElement> {
+
+interface CwButtonProps extends React__default.ButtonHTMLAttributes<HTMLButtonElement> {
     text?: string;
-    variant?: 'solid' | 'outline' | 'icon';
+    variant?: 'solid' | 'outline' | 'icon' | 'ghost';
     color?: 'primary' | 'danger' | 'neutral';
+    size?: 'small' | 'medium' | 'large';
+    iconPosition?: 'left' | 'right';
+    pressed?: boolean;
     icon?: string;
     tooltipPosition?: 'top' | 'bottom' | 'left' | 'right';
-    ref?: React.LegacyRef<HTMLButtonElement>;
 }
-declare function CwButton({ text, variant, color, className, icon, title, tooltipPosition, children, ...buttonProps }: CwButtonProps): React$1.JSX.Element;
+declare const CwButton: React__default.ForwardRefExoticComponent<CwButtonProps & React__default.RefAttributes<HTMLButtonElement>>;
 
 interface CwDigitProps extends Omit<HTMLProps<HTMLInputElement>, "className" | "type"> {
     /** Props to define alignment and size; undefined == column
@@ -1776,9 +1763,22 @@ interface CwInputDateTextProps extends Omit<React__default.HTMLProps<HTMLInputEl
  */
 declare function CwInputDateText(props: CwInputDateTextProps): React__default.JSX.Element;
 
-interface CwInputImageProps extends Omit<DetailedHTMLProps<InputHTMLAttributes<HTMLInputElement>, HTMLInputElement>, "className" | "type" | "onChange"> {
+interface CwInputImageLabels {
+    dropImageHere: string;
+    paste: string;
+    browse: string;
+    acceptedFormats: (formats: string) => string;
+    clipboardError: string;
+    invalidType: (formats: string) => string;
+    readError: string;
+}
+interface CwInputImageProps extends Omit<DetailedHTMLProps<InputHTMLAttributes<HTMLInputElement>, HTMLInputElement>, "className" | "type" | "onChange" | "onError" | "size"> {
     allowedImageFormats?: string[];
-    onChange?: (image: string | null) => void;
+    onChange?: (dataUrl: string | null, file?: File) => void;
+    onError?: (error: string) => void;
+    labels?: Partial<CwInputImageLabels>;
+    /** Scales the dropzone and drives the size of the Paste/Browse buttons. Unset = default (medium) size. */
+    size?: "small" | "medium" | "large";
 }
 declare function CwInputImage(props: CwInputImageProps): React$1.JSX.Element;
 
@@ -1890,11 +1890,13 @@ declare const CwWeekdaySelector: FC<CwWeekdaySelectorProps>;
 interface CwCheckProps extends Omit<React__default.DetailedHTMLProps<React__default.InputHTMLAttributes<HTMLInputElement>, HTMLInputElement>, "type"> {
     /** Props for the label component */
     labelProps?: CwLabelProps;
-    /** Text content for the checkbox label */
+    /** Text content for the checkbox label
+     * @deprecated Use `labelProps.text` instead. */
     labelText?: string;
-    /** Props for the icon component - iconId is required */
-    iconProps?: CwIconProps;
-    /** Layout alignment: "row" (side by side) | "column" (label above) @default "row" */
+    /** Layout of the input relative to its label: "row" (side by side, default) | "column" (label below) */
+    direction?: "row" | "column";
+    /** Layout alignment: "row" (side by side) | "column" (label below) @default "row"
+     * @deprecated Use `direction` instead. */
     alignment?: "row" | "column";
 }
 declare function CwCheck(props: CwCheckProps): React__default.JSX.Element;
@@ -1927,7 +1929,17 @@ interface CheckboxOption {
     /** Disables this specific option */
     disabled?: boolean;
 }
-interface CwCheckboxGroupProps {
+/**
+ * Extends the shared {@link CwGroupLayoutProps} (`groupLayout` + `itemLayout`), the same layout
+ * interface {@link CwRadioGroup} and {@link CwKeyValueList} use:
+ * - `groupLayout` — label vs group block. `direction: "row"` (default, kept for backward
+ *   compatibility) = label beside the options; `"column"` = label above. Honors `align`/`gap`.
+ * - `itemLayout` — flow of the checkbox options. `direction: "column"` (default) = stacked;
+ *   `"row"` = inline with wrap. Honors `gap`. It also drives each checkbox's own box-to-text
+ *   layout to the OPPOSITE axis: stacked items get the box beside the text, side-by-side items
+ *   get the box above the text.
+ */
+interface CwCheckboxGroupProps extends CwGroupLayoutProps {
     /** List of options to display */
     options: CheckboxOption[];
     /** Currently selected values */
@@ -1936,29 +1948,98 @@ interface CwCheckboxGroupProps {
     onChange: (selected: string[]) => void;
     /** Props for the label component */
     labelProps?: CwLabelProps;
-    /** Props for alignment */
-    alignProps?: CwAlignProps;
     /** Marks the group as required */
     required?: boolean;
     /** Disables all options */
     disabled?: boolean;
-    /** Layout alignment of each individual checkbox: "row" (default) | "column" */
+    /** Additional CSS class for the container */
+    className?: string;
+    /** Error or info messages below the group */
+    feedback?: CwInputFeedback | CwInputFeedback[];
+    /** Props for alignment
+     * @deprecated Use `groupLayout` instead. */
+    alignProps?: CwAlignProps;
+    /** Layout alignment of each individual checkbox: "row" (default) | "column"
+     * @deprecated Use `itemLayout` instead. */
     optionsAlignment?: "row" | "column";
+    "data-testid"?: string;
+}
+/**
+ * CwCheckboxGroup - Multi-select group of native checkbox inputs.
+ *
+ * Use for selecting any number of values from a list of options. Layout follows the
+ * CwKeyValueList / CwRadioGroup convention with two nested {@link CwLayoutProps} axes applied as
+ * `data-*` attributes: `groupLayout` positions the label relative to the group block (root grid),
+ * `itemLayout` controls how the checkboxes flow among themselves (options container) and, on the
+ * opposite axis, each checkbox's own box-to-text layout.
+ */
+declare function CwCheckboxGroup({ options, value, onChange, labelProps, groupLayout, itemLayout, required, disabled, className, feedback, alignProps, optionsAlignment, "data-testid": dataTestId, }: CwCheckboxGroupProps): React$1.JSX.Element;
+
+interface RadioOption {
+    /** Value sent to onChange */
+    value: string;
+    /** Text displayed next to the radio */
+    label: string;
+    /** Disables this specific option */
+    disabled?: boolean;
+}
+/**
+ * Extends the shared {@link CwGroupLayoutProps} (`groupLayout` + `itemLayout`), the same layout
+ * interface {@link CwKeyValueList} uses:
+ * - `groupLayout` — label vs radiogroup block. `direction: "column"` (default) = label above;
+ *   `"row"` = label beside the options. Honors `align`/`gap`.
+ * - `itemLayout` — flow of the radio options. `direction: "column"` (default) = stacked;
+ *   `"row"` = inline with wrap. Honors `gap`. It also drives each radio's own circle-to-text
+ *   layout to the OPPOSITE axis: stacked items get the circle beside the text, side-by-side
+ *   items get the circle above the text.
+ */
+interface CwRadioGroupProps extends CwGroupLayoutProps {
+    /** List of options to display */
+    options: RadioOption[];
+    /** Currently selected value */
+    value?: string;
+    /** Callback when the selection changes - returns the selected value */
+    onChange: (value: string) => void;
+    /** Props for the label component */
+    labelProps?: CwLabelProps;
+    /** Marks the group as required */
+    required?: boolean;
+    /** Disables all options */
+    disabled?: boolean;
     /** Additional CSS class for the container */
     className?: string;
     /** Error or info messages below the group */
     feedback?: CwInputFeedback | CwInputFeedback[];
+    /** Accessible name for the radiogroup when no visible `labelProps` label is rendered (a11y fallback). */
+    "aria-label"?: string;
+    /** Accessible name for the radiogroup when no visible `labelProps` label is rendered (a11y fallback). */
+    "aria-labelledby"?: string;
+    "data-testid"?: string;
 }
-declare function CwCheckboxGroup({ options, value, onChange, labelProps, alignProps, required, disabled, optionsAlignment, className, feedback, }: CwCheckboxGroupProps): React$1.JSX.Element;
+/**
+ * CwRadioGroup - Single-select group of native radio inputs.
+ *
+ * Built on `<input type="radio">` sharing one `name`, so the browser provides radio-group
+ * semantics (roving tabindex, arrow-key navigation) natively. Use for a single choice from a
+ * list of options; for 2–3 options shown as a strip use CwButtonSwitch.
+ *
+ * Layout follows the CwKeyValueList convention with two nested {@link CwLayoutProps} axes
+ * applied as `data-*` attributes: `groupLayout` positions the label relative to the radiogroup
+ * block (root grid), `itemLayout` controls how the radios flow among themselves (options
+ * container) and, on the opposite axis, each radio's own circle-to-text layout.
+ */
+declare function CwRadioGroup({ options, value, onChange, labelProps, groupLayout, itemLayout, required, disabled, className, feedback, "aria-label": ariaLabel, "aria-labelledby": ariaLabelledby, "data-testid": dataTestId, }: CwRadioGroupProps): React$1.JSX.Element;
 
 interface CwToggleProps extends Omit<React__default.DetailedHTMLProps<React__default.InputHTMLAttributes<HTMLInputElement>, HTMLInputElement>, "type"> {
     /** Props for the label component */
     labelProps?: CwLabelProps;
-    /** Text content for the toggle label */
+    /** Text content for the toggle label
+     * @deprecated Use `labelProps.text` instead. */
     labelText?: string;
-    /** Props for the icon component - iconId is required */
-    iconProps?: CwIconProps;
-    /** Layout alignment: "row" (side by side) | "column" (label above) @default "row" */
+    /** Layout of the input relative to its label: "row" (side by side, default) | "column" (label above) */
+    direction?: "row" | "column";
+    /** Layout alignment: "row" (side by side) | "column" (label above) @default "row"
+     * @deprecated Use `direction` instead. */
     alignment?: "row" | "column";
 }
 declare function CwToggle(props: CwToggleProps): React__default.JSX.Element;
@@ -2414,6 +2495,99 @@ type TreeViewProps<T> = {
 };
 declare function CwTreeView<T>({ data, onSelect, allowParentSelection, selectedId: initialSelectedId }: TreeViewProps<T>): React$1.JSX.Element;
 
+interface CwNavItem {
+    /** Stable id, also the React key */
+    id: string;
+    /** Resolved display text — the consumer owns i18n / tenant naming */
+    label: string;
+    /** Link target for leaves; groups may omit it */
+    href?: string;
+    /** Resolved secondary text — not rendered by the menu, but searched alongside label and href */
+    description?: string;
+    /** CW icon name */
+    icon?: string;
+    /** Non-empty children make this item a collapsible group */
+    children?: CwNavItem[];
+}
+/** Remaining props land on the <nav> — `data-*` (CBT walkthrough targets), `aria-*`, `data-testid`. */
+interface CwNavMenuProps extends Omit<HTMLAttributes<HTMLElement>, "children"> {
+    /** Already permission-filtered and ordered by the consumer */
+    items: CwNavItem[];
+    /** Renders placeholder rows instead of the tree */
+    loading?: boolean;
+    /**
+     * Router-agnostic active detection; nothing is highlighted when omitted. Injected because the
+     * library cannot depend on a router (WinOps: react-router-dom 6.28, Improve: a different one,
+     * playground: none) — the consumer answers "is this the current page?", the component owns the
+     * highlight. Revisitable: if the apps ever converge on one router, this could move inside.
+     */
+    isActive?: (item: CwNavItem) => boolean;
+    /** Inject a router link component; defaults to a plain <a href> */
+    renderLink?: (item: CwNavItem, children: ReactNode) => ReactNode;
+    /**
+     * Show a trailing chevron on **top-level** group rows. Nested groups (level 2+) always show it
+     * and ignore this flag — don't normalise the two cases: a level-1 group is already marked by
+     * its heavier type and [open] background, while a nested group is otherwise indistinguishable
+     * from its sibling leaf links.
+     */
+    showExpandIndicator?: boolean;
+    /**
+     * Filters the tree through `filterNavItems`: a group survives when it or any descendant matches.
+     * Quoted `"phrases"` match the label; loose words match label + description + href. Blank or
+     * omitted means no filtering.
+     */
+    search?: string;
+    /** Shown only while a search is active and nothing matched — an empty `items` still renders nothing */
+    emptyMessage?: string;
+    /**
+     * Sorts the **top level** alphabetically; nested lists keep the consumer's order. Off by default.
+     * Level-1-only is deliberate: a long list of modules is hard to scan, while the pages inside one
+     * are ordered on purpose.
+     */
+    sortAlphabetically?: boolean;
+    /**
+     * Rows for the sticky favourites section above the tree. Omit it and no section renders. The
+     * library owns the disclosure and its look; the rows are yours, so their markup, secondary text
+     * and any `data-*` stay under your control.
+     */
+    favoritesSlot?: ReactNode;
+    /** Header for the favourites section. Pass your own translation. */
+    favoritesLabel?: string;
+    /** Attributes for the favourites `<details>` — `data-tour`, or `open` to override the default. */
+    favoritesProps?: HTMLAttributes<HTMLDetailsElement>;
+    /**
+     * Marks a leaf as favourited with a star. Indicator only — toggling stays with the consumer
+     * (a context menu on the link, for instance), so no row gains a control it didn't have.
+     */
+    isFavorite?: (item: CwNavItem) => boolean;
+    /**
+     * An app-provided section between the favourites and the tree — WinOps's external "Places" links,
+     * for instance. Kept out of `items` on purpose: it is a parallel list, so it is not filtered by
+     * `search` or reordered by `sortAlphabetically`.
+     *
+     * A `<details>` placed here is styled as a top-level section automatically.
+     */
+    beforeTreeSlot?: ReactNode;
+}
+/** Sizes only its own icons — content injected via `renderLink` is styled by the consumer. */
+declare function CwNavMenu({ items, loading, isActive, renderLink, showExpandIndicator, search, emptyMessage, sortAlphabetically, favoritesSlot, favoritesLabel, favoritesProps, isFavorite, beforeTreeSlot, className, ...navProps }: CwNavMenuProps): React$1.JSX.Element;
+
+/**
+ * Filters a nav tree by a search string, keeping a group whose descendants match.
+ *
+ * Supports `"quoted phrases"` (must appear in the label) alongside loose words (any field) — this is
+ * behaviour users are told about, so don't simplify it.
+ */
+declare function filterNavItems(items: CwNavItem[], search?: string): CwNavItem[];
+
+/**
+ * Sorts the top level alphabetically, leaving every nested list in the order the consumer gave.
+ *
+ * Deliberately level 1 only: this exists because a long list of modules is hard to scan, while the
+ * pages inside a module are ordered on purpose. Returns the input untouched when not sorting.
+ */
+declare function sortNavItems(items: CwNavItem[], alphabetically?: boolean): CwNavItem[];
+
 /** Props for {@link CwSearchInput}. */
 interface CwSearchInputProps extends HTMLProps<HTMLDivElement> {
     /** List of items to search through. Each item must be a `CwSelectList` instance. */
@@ -2436,6 +2610,8 @@ interface CwSearchInputProps extends HTMLProps<HTMLDivElement> {
     error?: boolean;
     /** Custom renderer for each suggestion item. Receives the matching `CwSelectList` entry. */
     renderOption?: (option: CwSelectList) => React__default.ReactNode;
+    /** Focuses the internal `<input>` on mount when `true`. */
+    autoFocus?: boolean;
 }
 /**
  * Text input with a live-filtered suggestion dropdown backed by a local `CwSelectList` array.
@@ -2639,6 +2815,122 @@ interface ContextMenuProps extends React__default.PropsWithChildren {
 }
 declare const CwContextMenu: React__default.FC<ContextMenuProps>;
 
+interface CwButtonSplitAction {
+    key: string;
+    label: string;
+    /** cwi icon name (verified against NewCwIcons.json) */
+    icon?: string;
+    disabled?: boolean;
+}
+interface CwButtonSplitProps {
+    /** Main action label */
+    text: string;
+    /** Optional main-action icon */
+    icon?: string;
+    /** Default/main action */
+    onClick: () => void;
+    /** Alternative actions shown in the dropdown menu */
+    actions: CwButtonSplitAction[];
+    /** Fired when a menu item is chosen */
+    onSelect: (key: string) => void;
+    /** Shared visual style for both parts. @default 'solid' */
+    variant?: "solid" | "outline";
+    /** Shared color theme for both parts. @default 'primary' */
+    color?: "primary" | "danger" | "neutral";
+    /** Shared size for both parts. @default 'medium' */
+    size?: "small" | "medium" | "large";
+    /** Disables both parts */
+    disabled?: boolean;
+    /** Menu alignment relative to the control. @default 'bottom-end' */
+    placement?: "bottom-start" | "bottom-end";
+    "data-testid"?: string;
+}
+/**
+ * CwButtonSplit - A primary action joined to a dropdown of alternative actions.
+ *
+ * Composes a main {@link CwButton} with a {@link CwPopoverButton} chevron whose
+ * panel holds a vertical menu of alternatives (rendered as `variant="ghost"` rows).
+ * Both parts share variant, color and size and read as one joined control.
+ *
+ * @example
+ * <CwButtonSplit
+ *     text="Save"
+ *     icon="save"
+ *     onClick={handleSave}
+ *     actions={[
+ *         { key: "saveAs", label: "Save as…", icon: "copy" },
+ *         { key: "saveAndClose", label: "Save and close" },
+ *     ]}
+ *     onSelect={handleSelect}
+ * />
+ */
+declare function CwButtonSplit({ text, icon, onClick, actions, onSelect, variant, color, size, disabled, placement, "data-testid": dataTestId, }: CwButtonSplitProps): React__default.JSX.Element;
+
+interface CwButtonSwitchOption {
+    /** Value sent to onChange */
+    value: string;
+    /** Text displayed on the segment */
+    label: string;
+    /** Optional cwi icon name */
+    icon?: string;
+    /** Disables this specific segment */
+    disabled?: boolean;
+}
+interface CwButtonSwitchProps {
+    /** Options rendered as joined segments */
+    options: CwButtonSwitchOption[];
+    /** Currently selected value */
+    value: string;
+    /** Callback when the selection changes */
+    onChange: (value: string) => void;
+    /** Segment size */
+    size?: "small" | "medium" | "large";
+    /** Shared color theme for every segment */
+    color?: "primary" | "danger" | "neutral";
+    /** Render only each option's icon (label becomes the tooltip + accessible name). Every option must have an `icon`. */
+    iconOnly?: boolean;
+    /**
+     * Orientation of the joined strip: "row" (default, horizontal) or "column" (vertical,
+     * stacked full-width segments). Only orientation is exposed because the segments are joined
+     * (no gap), so gap/align/justify are not meaningful.
+     */
+    direction?: "row" | "column";
+    /** Disables every segment */
+    disabled?: boolean;
+    /** Accessible name for the radiogroup (there is no visible label on this inline control). */
+    "aria-label"?: string;
+    /** Accessible name for the radiogroup (there is no visible label on this inline control). */
+    "aria-labelledby"?: string;
+    "data-testid"?: string;
+}
+/**
+ * CwButtonSwitch - Segmented single-select control: a strip of joined CwButtons.
+ *
+ * The selected segment renders `solid`, the others `outline`, both sharing the `color`
+ * theme (`primary` default, `danger`, or `neutral`). It is a proper ARIA radiogroup with
+ * roving tabindex (one tab stop) and arrow-key navigation, provided by
+ * {@link useRovingSingleSelect}. Use for 2–3 mutually-exclusive options that benefit from
+ * being shown side by side; for a longer list use CwRadioGroup.
+ *
+ * `direction="column"` renders the strip vertically (stacked, full-width segments) instead of
+ * the default horizontal `row`; arrow-key navigation handles both orientations.
+ *
+ * Set `iconOnly` to render just each option's icon; the option's `label` is still required
+ * and is passed as the segment title, so it becomes the tooltip and the accessible name.
+ *
+ * It is an inline control with no form label — if a caption is needed, place it next to the
+ * control at the call site, and pass `aria-label` (or `aria-labelledby`) to name the radiogroup
+ * for screen readers.
+ *
+ * @example
+ * <CwButtonSwitch
+ *     options={[{ value: "list", label: "List", icon: "list" }, { value: "grid", label: "Grid", icon: "grid" }]}
+ *     value={view}
+ *     onChange={setView}
+ * />
+ */
+declare function CwButtonSwitch({ options, value, onChange, size, color, iconOnly, direction, disabled, "aria-label": ariaLabel, "aria-labelledby": ariaLabelledby, "data-testid": dataTestId, }: CwButtonSwitchProps): React$1.JSX.Element;
+
 /**
  * Props for legacy icon button wrappers
  * @deprecated These wrappers exist for backward compatibility.
@@ -3697,5 +3989,5 @@ declare class OnClickContextMenu implements UiEvent {
     constructor(id: string, clickedMenu: string);
 }
 
-export { CblDragAndDrop$1 as CblDragAndDrop, CwAccordionContainer, CwAlign, CwAnchoredMenu, CwBtnApprove, CwBtnCancel, CwBtnDelete, CwBtnEdit, CwBtnSave, CwButton, CwCard, CwCardList, CwCheck, CwCheckbox, CwCheckboxGroup, CwChip, CwColorPicker, CwConfirmationPopup, CwContextMenu, CwDatePicker, CwDatePickerTemporal, CwDateRangePicker, CwDateRangePickerTemporal, CwDateTimePicker, CwDateTimePickerCompact, CwDateTimePickerTemporal, CwDialog, CwDigit, CwDisplayMessage, CwDropdown, CwDropdownFilter, CwExpandable, CwFileUpload, CwFileUploadMultiple, CwFindAirport, CwFindCrewmember, CwGenericTooltip, CwHeadingMain, CwHeadingSecond, CwIcon, CwImageArea, CwImageGallery, CwImageZoom, CwInput, CwInputColor, CwInputDateText, CwInputDatetime, CwInputImage, CwInputNumber, CwInputPhone, CwInputText, CwKeyValueList, CwLabel, CwLoading, CwLoadingSmall, CwMasterDetail, CwMessage, CwMessageManager, CwMessageType, CwModal, CwModalHover, CwModalReportFunctional, CwMultiFilter, CwMultiFilterTag, CwNote, CwOption, CwPopoverButton, CwReportModal, CwScheduler, CwSearchAsync, CwSearchInput, CwSelect, CwSelectList, CwSelectListItems, CwSortableList, CwSortableTable, CwSuperScheduler, CwTable, CwTableGrouped, CwTableServerSide, CwTabs, CwTagSelector, CwTextArea, CwTime, CwTimePicker, CwToggle, CwTooltipManager, CwTooltipNew, CwTreeView, CwWeekdaySelector, DefaultRowHeader, OnClearPinned, OnClickContextMenu, OnClickEvent, OnClickRowEvent, OnClickRowHeader, OnClickUtc, OnDoubleClickEvent, OnDoubleClickRowEvent, OnDragEvent, OnDropCtrlEvent, OnDropEvent, OnEndClickHeaderEvent, OnLeftDragStart, OnMultiClickEvent, OnPinRow, OnRangeClickEvent, OnRightClickEvent, OnRightClickRow, OnRightDragStart, OnStartClickHeaderEvent, OnUnpinRow, PRESET_LIBRARY_TEMPORAL, PinRowHeader, Resource, Scheduler, SchedulerEvent, SuperScheduler, TooltipConstraintContext, UiEvent, Weekdays, cblEvent, eventIsVisible, filterVisibleEvents, getDefaultDivisions, getEventSizes, getPresetsByKeysTemporal, itemsToMultiFilterTags, useCwMessage, useSortableList, useSortableTable, useTooltipConstraint };
-export type { BackgroundEventDm, CardChip, ChipColorScheme, ChipVariant, Column$1 as Column, ConfirmationPopupProps, CwAlignProps, CwCardListProps, CwCardProps, CwChipProps, CwDialogProps, CwDropdownOption, CwDropdownProps, CwExpandableProps, CwGroupLayoutProps, CwImageAreaMethods, CwImageAreaProps, CwInputDateTextProps, CwInputDatetimeProps, CwInputImageProps, CwInputNumberProps, CwInputPhoneProps, CwInputTextProps, CwInputTimeProps, CwKeyValueListProps, CwLabelProps, CwLayoutProps, CwMasterDetailItem, CwMasterDetailProps, CwMessageProps, CwModalHoverProps, CwMultiFilterProps, CwMultiFilterTagProps, CwNoteProps, CwPopoverButtonProps, CwReportModalFunctionalProps, CwSearchAsyncOption, CwSearchAsyncProps, CwSelectListProps, CwSortableListProps, CwSortableTableProps, CwTableGroupedData, CwTableGroupedData_Group, CwTableGroupedData_Row, CwTableGroupedProps, CwTagSelectorOption, CwTagSelectorProps, CwTextAreaProps, CwTreeNode, DataItem, DateRangePresetTemporal, DateRangeValue, DateRangeValueTemporal, ICwMultiFilterTag, ImageItem, IndicatorRowDm, MenuOption, OnEvent, PinRowHeaderProps, RowHeaderDm, RowHeaderProps, SchedulerEventDm, SchedulerEventState, SchedulerRowProps, SchedulerState, ServerSideTableState, SortableColumn, SortableTableDragState, SuperSchedulerProps, Tab, UseSortableTableReturn, Weekday, ZoomImageItem, cblEventCompProps, resourceCompProps2 };
+export { CblDragAndDrop$1 as CblDragAndDrop, CwAccordionContainer, CwAlign, CwAnchoredMenu, CwBtnApprove, CwBtnCancel, CwBtnDelete, CwBtnEdit, CwBtnSave, CwButton, CwButtonSplit, CwButtonSwitch, CwCard, CwCardList, CwCheck, CwCheckbox, CwCheckboxGroup, CwChip, CwColorPicker, CwConfirmationPopup, CwContextMenu, CwDatePicker, CwDatePickerTemporal, CwDateRangePicker, CwDateRangePickerTemporal, CwDateTimePicker, CwDateTimePickerCompact, CwDateTimePickerTemporal, CwDialog, CwDigit, CwDisplayMessage, CwDropdown, CwDropdownFilter, CwExpandable, CwFileUploadMultiple, CwFindAirport, CwFindCrewmember, CwGenericTooltip, CwHeadingMain, CwHeadingSecond, CwIcon, CwImageArea, CwImageGallery, CwImageZoom, CwInput, CwInputColor, CwInputDateText, CwInputDatetime, CwInputImage, CwInputNumber, CwInputPhone, CwInputText, CwKeyValueList, CwLabel, CwLoading, CwMasterDetail, CwMessage, CwMessageManager, CwMessageType, CwModal, CwModalHover, CwModalReportFunctional, CwMultiFilter, CwMultiFilterTag, CwNavMenu, CwNote, CwOption, CwPopoverButton, CwRadioGroup, CwReportModal, CwScheduler, CwSearchAsync, CwSearchInput, CwSelect, CwSelectList, CwSelectListItems, CwSortableList, CwSortableTable, CwSuperScheduler, CwTable, CwTableGrouped, CwTableServerSide, CwTabs, CwTagSelector, CwTextArea, CwTime, CwTimePicker, CwToggle, CwTooltipManager, CwTooltipNew, CwTreeView, CwWeekdaySelector, DefaultRowHeader, OnClearPinned, OnClickContextMenu, OnClickEvent, OnClickRowEvent, OnClickRowHeader, OnClickUtc, OnDoubleClickEvent, OnDoubleClickRowEvent, OnDragEvent, OnDropCtrlEvent, OnDropEvent, OnEndClickHeaderEvent, OnLeftDragStart, OnMultiClickEvent, OnPinRow, OnRangeClickEvent, OnRightClickEvent, OnRightClickRow, OnRightDragStart, OnStartClickHeaderEvent, OnUnpinRow, PRESET_LIBRARY_TEMPORAL, PinRowHeader, Resource, Scheduler, SchedulerEvent, SuperScheduler, TooltipConstraintContext, UiEvent, Weekdays, cblEvent, configureCwLoading, eventIsVisible, filterNavItems, filterVisibleEvents, getCwLoadingDefaults, getDefaultDivisions, getEventSizes, getPresetsByKeysTemporal, itemsToMultiFilterTags, sortNavItems, useCwMessage, useSortableList, useSortableTable, useTooltipConstraint };
+export type { BackgroundEventDm, CardChip, ChipColorScheme, ChipVariant, Column$1 as Column, ConfirmationPopupProps, CwAlignProps, CwButtonSplitAction, CwButtonSplitProps, CwButtonSwitchOption, CwButtonSwitchProps, CwCardListProps, CwCardProps, CwChipProps, CwDialogProps, CwDropdownOption, CwDropdownProps, CwExpandableProps, CwGroupLayoutProps, CwImageAreaMethods, CwImageAreaProps, CwInputDateTextProps, CwInputDatetimeProps, CwInputImageProps, CwInputNumberProps, CwInputPhoneProps, CwInputTextProps, CwInputTimeProps, CwKeyValueListProps, CwLabelProps, CwLayoutProps, CwLoadingDefaults, CwMasterDetailItem, CwMasterDetailProps, CwMessageProps, CwModalHoverProps, CwMultiFilterProps, CwMultiFilterTagProps, CwNavItem, CwNavMenuProps, CwNoteProps, CwPopoverButtonProps, CwRadioGroupProps, CwReportModalFunctionalProps, CwSearchAsyncOption, CwSearchAsyncProps, CwSelectListProps, CwSortableListProps, CwSortableTableProps, CwTableGroupedData, CwTableGroupedData_Group, CwTableGroupedData_Row, CwTableGroupedProps, CwTagSelectorOption, CwTagSelectorProps, CwTextAreaProps, CwTreeNode, DataItem, DateRangePresetTemporal, DateRangeValue, DateRangeValueTemporal, ICwMultiFilterTag, ImageItem, IndicatorRowDm, MenuOption, OnEvent, PinRowHeaderProps, RowHeaderDm, RowHeaderProps, SchedulerEventDm, SchedulerEventState, SchedulerRowProps, SchedulerState, ServerSideTableState, SortableColumn, SortableTableDragState, SuperSchedulerProps, Tab, UseSortableTableReturn, Weekday, ZoomImageItem, cblEventCompProps, resourceCompProps2 };