@ssa-ui-kit/core 3.19.0 → 3.20.0

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

@@ -1,19 +1,26 @@
 /**
  * Props for the ModalDialog presentational component.
  *
- * Used by ModalContent when rendering the dialog. isOpen controls visibility;
+ * Used by ModalContent when rendering the dialog. open controls visibility;
  * noBackground removes the overlay; aria-label is required for accessibility.
  *
  * @example
  * ```tsx
- * <ModalDialog isOpen={true} aria-label="Confirm action">
+ * <ModalDialog open aria-label="Confirm action">
  *   <p>Are you sure?</p>
  * </ModalDialog>
  * ```
  */
 export interface ModalDialogProps {
     /** Whether the dialog is visible. When false, content is hidden (display: none). */
-    isOpen: boolean;
+    open?: boolean;
+    /**
+     * Whether the dialog is visible.
+     *
+     * @deprecated Use `open` instead — `isOpen` is removed in the next major
+     * release.
+     */
+    isOpen?: boolean;
     /** When true, the overlay is transparent (no dimmed background). */
     noBackground?: boolean;
     /** Accessible name for the dialog (required for screen readers). */

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

@@ -36,6 +36,13 @@ export type DropdownProps<P extends DropdownOptionProps> = {
      * Disables the dropdown, preventing any user interaction
      * @default false
      */
+    disabled?: boolean;
+    /**
+     * Disables the dropdown, preventing any user interaction
+     *
+     * @deprecated Use `disabled` instead. Removed in the next major release.
+     * @default false
+     */
     isDisabled?: boolean;
     /**
      * Placeholder shown in the toggle button when no item is selected

package/dist/components/MultipleDropdownOptions/MultipleDropdownOptions.d.ts

@@ -1,3 +1,3 @@
 import { DropdownItemsListProps } from './types';
-declare const MultipleDropdownOptions: ({ ariaLabelledby, id, children, }: DropdownItemsListProps) => import("@emotion/react/jsx-runtime").JSX.Element;
+declare const MultipleDropdownOptions: ({ "aria-labelledby": ariaLabelledbyNative, ariaLabelledby, id, children, }: DropdownItemsListProps) => import("@emotion/react/jsx-runtime").JSX.Element;
 export default MultipleDropdownOptions;

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

@@ -1,5 +1,17 @@
 export type DropdownOptionType = Record<string, string | number>;
 export interface DropdownItemsListProps {
+    /**
+     * ARIA label reference
+     * Associates the listbox with its label
+     */
+    'aria-labelledby'?: string;
+    /**
+     * ARIA label reference
+     * Associates the listbox with its label
+     *
+     * @deprecated Use `aria-labelledby` instead — `ariaLabelledby` is removed in
+     * the next major release.
+     */
     ariaLabelledby?: string;
     id?: string;
     children?: React.ReactNode;

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

@@ -15,7 +15,7 @@ import { ArrowButtonProps } from './types';
  * <ArrowButton
  *   direction="left"
  *   onClick={() => goToPreviousPage()}
- *   isDisabled={isFirstPage}
+ *   disabled={isFirstPage}
  * />
  * ```
  *
@@ -31,4 +31,4 @@ import { ArrowButtonProps } from './types';
  * - Keyboard navigation support via Button component
  * - Screen reader friendly
  */
-export declare const ArrowButton: ({ direction, onClick, isDisabled, className, }: ArrowButtonProps) => import("@emotion/react/jsx-runtime").JSX.Element;
+export declare const ArrowButton: ({ direction, onClick, disabled, isDisabled, className, }: ArrowButtonProps) => import("@emotion/react/jsx-runtime").JSX.Element;

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

@@ -64,7 +64,7 @@ import { PaginationProps } from './types';
  * ```tsx
  * // Disabled pagination
  * <PaginationContextProvider selectedPage={5}>
- *   <Pagination pagesCount={10} isDisabled />
+ *   <Pagination pagesCount={10} disabled />
  * </PaginationContextProvider>
  * ```
  *
@@ -80,5 +80,5 @@ import { PaginationProps } from './types';
  * - Screen reader friendly
  * - Proper focus management
  */
-declare const Pagination: ({ pagesCount, className, as, ariaLabel, isDisabled, pageNumberPlaceholder, errorTooltip, isPageSettingVisible, isPageFromCountVisible, isRowPerPageVisible, rowPerPageProps, manualPageNumberProps, renderPageCount, }: PaginationProps) => import("@emotion/react/jsx-runtime").JSX.Element;
+declare const Pagination: ({ pagesCount, className, as, "aria-label": ariaLabelNative, ariaLabel, disabled, isDisabled, pageNumberPlaceholder, errorTooltip, isPageSettingVisible, isPageFromCountVisible, isRowPerPageVisible, rowPerPageProps, manualPageNumberProps, renderPageCount, }: PaginationProps) => import("@emotion/react/jsx-runtime").JSX.Element;
 export default Pagination;

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

@@ -16,7 +16,7 @@ import { PaginationButtonsProps } from './types';
  *   range={[1, 2, 3, -1, 10]}  // -1 represents ellipsis break
  *   selectedPage={2}
  *   onClick={(page) => setPage(page)}
- *   isDisabled={false}
+ *   disabled={false}
  * />
  * ```
  *
@@ -34,4 +34,4 @@ import { PaginationButtonsProps } from './types';
  * - Screen reader friendly
  * - Proper focus management
  */
-export declare const PaginationButtons: ({ range, selectedPage, onClick, isDisabled, }: PaginationButtonsProps) => import("@emotion/react/jsx-runtime").JSX.Element;
+export declare const PaginationButtons: ({ range, selectedPage, onClick, disabled, isDisabled, }: PaginationButtonsProps) => import("@emotion/react/jsx-runtime").JSX.Element;

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

@@ -55,12 +55,27 @@ export interface PaginationProps extends CommonProps {
      * ARIA label for the pagination navigation
      * @default 'Pagination'
      */
+    'aria-label'?: string;
+    /**
+     * ARIA label for the pagination navigation
+     *
+     * @deprecated Use `aria-label` instead — `ariaLabel` is removed in the next
+     * major release.
+     * @default 'Pagination'
+     */
     ariaLabel?: string;
     /**
      * Whether the pagination is disabled
      * Disabled pagination prevents all navigation actions
      * @default false
      */
+    disabled?: boolean;
+    /**
+     * Whether the pagination is disabled
+     *
+     * @deprecated Use `disabled` instead. Removed in the next major release.
+     * @default false
+     */
     isDisabled?: boolean;
     /**
      * Placeholder text for manual page input
@@ -134,6 +149,13 @@ export interface PaginationButtonsProps {
      * Whether the buttons are disabled
      * @default false
      */
+    disabled?: boolean;
+    /**
+     * Whether the buttons are disabled
+     *
+     * @deprecated Use `disabled` instead. Removed in the next major release.
+     * @default false
+     */
     isDisabled?: boolean;
 }
 /**
@@ -153,6 +175,13 @@ export interface ArrowButtonProps {
      * Whether the button is disabled
      * @default false
      */
+    disabled?: boolean;
+    /**
+     * Whether the button is disabled
+     *
+     * @deprecated Use `disabled` instead. Removed in the next major release.
+     * @default false
+     */
     isDisabled?: boolean;
     /**
      * Custom CSS class name
@@ -180,6 +209,13 @@ export interface PageButtonProps {
      * Whether the button is disabled
      * @default false
      */
+    disabled?: boolean;
+    /**
+     * Whether the button is disabled
+     *
+     * @deprecated Use `disabled` instead. Removed in the next major release.
+     * @default false
+     */
     isDisabled?: boolean;
 }
 /**

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

@@ -39,6 +39,13 @@ export interface PopoverOptions {
      * Initial open state for uncontrolled popover
      * @default false
      */
+    defaultOpen?: boolean;
+    /**
+     * Initial open state for uncontrolled popover
+     *
+     * @deprecated Use `defaultOpen` instead — `initialOpen` is removed in the
+     * next major release.
+     */
     initialOpen?: boolean;
     /**
      * Preferred placement of the popover relative to trigger

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

@@ -4,4 +4,22 @@ export interface ProgressBarProps {
     vertical?: boolean;
     bgColor?: string;
     size?: number;
+    /**
+     * Accessible name for the progress bar.
+     *
+     * A `role="progressbar"` node must have an accessible name, otherwise screen
+     * readers announce only "progress bar" with no indication of what is
+     * progressing. Provide either this or `aria-labelledby`.
+     */
+    'aria-label'?: string;
+    /**
+     * Id of the element that labels this progress bar — use instead of
+     * `aria-label` when a visible label already exists.
+     */
+    'aria-labelledby'?: string;
+    /**
+     * Human-readable form of the current value, for when a bare percentage would
+     * be unhelpful (e.g. "3 of 8 steps"). Maps to `aria-valuetext`.
+     */
+    valueText?: string;
 }

package/dist/components/ProgressCircle/ProgressCircle.d.ts

@@ -1,3 +1,3 @@
 import { ProgressCircleProps } from './types';
-declare const ProgressCircle: ({ max, currentValue, color, size, infoContent, mode, classnames, }: ProgressCircleProps) => import("@emotion/react/jsx-runtime").JSX.Element;
+declare const ProgressCircle: ({ max, currentValue, color, size, infoContent, mode, classnames, "aria-label": ariaLabel, "aria-labelledby": ariaLabelledBy, }: ProgressCircleProps) => import("@emotion/react/jsx-runtime").JSX.Element;
 export default ProgressCircle;

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

@@ -1,6 +1,16 @@
 export interface ProgressCircleProps {
     max: number;
     currentValue: number;
+    /**
+     * Accessible name for the progress circle.
+     *
+     * A `role="progressbar"` node must have an accessible name, otherwise screen
+     * readers announce only "progress bar". Provide this or `aria-labelledby`.
+     * `infoContent` is not used as the name — it is often purely decorative.
+     */
+    'aria-label'?: string;
+    /** Id of an existing visible label, as an alternative to `aria-label`. */
+    'aria-labelledby'?: string;
     size?: number;
     color?: keyof MainColors;
     infoContent?: React.ReactNode | string;

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

@@ -66,5 +66,5 @@ import { RadioProps } from './types';
  * - Screen reader friendly
  * - Focus management with visible focus indicators
  */
-declare const Radio: ({ id, name, value, isChecked, isDisabled, isRequired, text, color, colors, className, onChange, }: RadioProps) => import("@emotion/react/jsx-runtime").JSX.Element;
+declare const Radio: ({ id, name, value, checked, isChecked, disabled, isDisabled, isRequired, text, color, colors, className, onChange, }: RadioProps) => import("@emotion/react/jsx-runtime").JSX.Element;
 export default Radio;

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

@@ -75,12 +75,25 @@ export interface RadioProps {
      * Whether the radio button is checked
      * Use for controlled component pattern
      */
+    checked?: boolean;
+    /**
+     * Whether the radio button is checked
+     *
+     * @deprecated Use `checked` instead. Removed in the next major release.
+     */
     isChecked?: boolean;
     /**
      * Whether the radio button is disabled
      * Disabled radios cannot be selected
      * @default false
      */
+    disabled?: boolean;
+    /**
+     * Whether the radio button is disabled
+     *
+     * @deprecated Use `disabled` instead. Removed in the next major release.
+     * @default false
+     */
     isDisabled?: boolean;
     /**
      * Whether the radio button is required for form validation

package/dist/components/RadioGroup/RadioGroup.d.ts

@@ -1,3 +1,3 @@
 import { RadioGroupProps } from './types';
-declare const RadioGroup: ({ name, isRequired, externalState, onChange, children, className, color, }: RadioGroupProps) => import("@emotion/react/jsx-runtime").JSX.Element;
+declare const RadioGroup: (props: RadioGroupProps) => import("@emotion/react/jsx-runtime").JSX.Element;
 export default RadioGroup;

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

@@ -14,7 +14,7 @@ import { RadioProps } from '../Radio/types';
  * <RadioGroup name="fruit" onChange={(value) => console.log(value)}>
  *   <Radio id="r1" value="apple" text="Apple" />
  *   <Radio id="r2" value="orange" text="Orange" />
- *   <Radio id="r3" value="banana" text="Banana" isDisabled />
+ *   <Radio id="r3" value="banana" text="Banana" disabled />
  * </RadioGroup>
  * ```
  *
@@ -35,6 +35,23 @@ import { RadioProps } from '../Radio/types';
 export interface RadioGroupProps {
     name: string;
     isRequired?: boolean;
+    /**
+     * Selected value, for the controlled pattern. When provided, the parent owns
+     * the selection and the group only reports intent through `onChange`.
+     */
+    value?: string | number;
+    /**
+     * Initially selected value. Only used when neither `value` nor the
+     * deprecated `externalState` is provided — both of those track the parent
+     * for the group's whole lifetime and so outrank an initial value.
+     */
+    defaultValue?: string | number;
+    /**
+     * @deprecated Use `value` instead. Removed in the next major release.
+     * Note the semantics differ slightly: `externalState` is synced *into*
+     * internal state, so the group still moves on click even when the parent
+     * ignores `onChange`. `value` is fully controlled.
+     */
     externalState?: string | number;
     className?: string;
     onChange: (value: string | number) => void;

package/dist/components/Switch/Switch.d.ts

@@ -39,7 +39,7 @@ import { SwitchProps } from './types';
  * ```tsx
  * // Disabled (muted grey, cannot toggle)
  * <SwitchContextProvider initialState={true}>
- *   <Switch label="Locked feature" isDisabled />
+ *   <Switch label="Locked feature" disabled />
  * </SwitchContextProvider>
  * ```
  *
@@ -66,5 +66,5 @@ import { SwitchProps } from './types';
  *
  * @requires SwitchContextProvider - Must be wrapped in SwitchContextProvider
  */
-declare const Switch: ({ label, isDisabled, color, colors, }: SwitchProps) => import("@emotion/react/jsx-runtime").JSX.Element;
+declare const Switch: ({ label, disabled, isDisabled, color, colors, }: SwitchProps) => import("@emotion/react/jsx-runtime").JSX.Element;
 export default Switch;

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

@@ -60,6 +60,13 @@ export interface SwitchProps {
      * Disabled switches cannot be toggled; background becomes `greySelectedMenuItem`
      * @default false
      */
+    disabled?: boolean;
+    /**
+     * Whether the switch is disabled
+     *
+     * @deprecated Use `disabled` instead. Removed in the next major release.
+     * @default false
+     */
     isDisabled?: boolean;
     /**
      * Palette-based color variant.

package/dist/components/Tab/Tab.d.ts

@@ -1,3 +1,3 @@
 import { SmallTabProps } from '../TabBar/types';
-declare const Tab: ({ onClick, isActive, text, ariaControls, tabId, className, }: SmallTabProps) => import("@emotion/react/jsx-runtime").JSX.Element;
+declare const Tab: ({ onClick, isActive, text, "aria-controls": ariaControlsNative, ariaControls, tabId, className, }: SmallTabProps) => import("@emotion/react/jsx-runtime").JSX.Element;
 export default Tab;

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

@@ -8,6 +8,14 @@ export interface TabProps extends CommonProps {
     }, arg?: unknown) => React.ReactNode;
     isActive?: boolean;
     onClick?: (event?: React.MouseEvent<HTMLDivElement>) => void;
+    /** Id of the panel this tab controls. */
+    'aria-controls'?: string;
+    /**
+     * Id of the panel this tab controls.
+     *
+     * @deprecated Use `aria-controls` instead — `ariaControls` is removed in the
+     * next major release.
+     */
     ariaControls?: string;
     [prop: string | number | symbol]: unknown;
 }

package/dist/components/TableBody/TableBody.d.ts

@@ -36,7 +36,7 @@ import { CommonProps } from '../../types/emotion';
  *   {items.map(item => (
  *     <TableRow
  *       key={item.id}
- *       isDisabled={item.disabled}>
+ *       disabled={item.disabled}>
  *       <TableCell>{item.name}</TableCell>
  *     </TableRow>
  *   ))}

package/dist/components/TableFilters/TableFiltersAccordionContent.d.ts

@@ -1,4 +1,4 @@
 import { RenderContentProps } from '../AccordionGroup';
-export declare const TableFiltersAccordionContent: ({ isOpened, children, ...rest }: RenderContentProps & {
+export declare const TableFiltersAccordionContent: ({ open, children, ...rest }: RenderContentProps & {
     children: React.ReactNode;
 }) => import("@emotion/react/jsx-runtime").JSX.Element;

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

@@ -25,6 +25,13 @@ export interface SingleItem {
      * Whether the item is disabled
      * @default false
      */
+    disabled?: boolean;
+    /**
+     * Whether the item is disabled
+     *
+     * @deprecated Use `disabled` instead. Removed in the next major release.
+     * @default false
+     */
     isDisabled?: boolean;
     /**
      * Item content configuration
@@ -65,6 +72,13 @@ export interface AccordionInfo {
      * Whether the entire group is disabled
      * @default false
      */
+    disabled?: boolean;
+    /**
+     * Whether the entire group is disabled
+     *
+     * @deprecated Use `disabled` instead. Removed in the next major release.
+     * @default false
+     */
     isDisabled?: boolean;
     /**
      * Filter items within this group

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

@@ -18,7 +18,7 @@ import { CommonProps } from '../../types/emotion';
  * @example
  * ```tsx
  * // Disabled table row (aria-disabled is automatically set)
- * <TableRow isDisabled>
+ * <TableRow disabled>
  *   <TableCell>Disabled Row</TableCell>
  * </TableRow>
  * ```
@@ -30,5 +30,12 @@ export interface TableRowProps extends CommonProps, HTMLAttributes<HTMLTableRowE
      * Automatically sets aria-disabled attribute when true.
      * @default false
      */
+    disabled?: boolean;
+    /**
+     * Whether the row is disabled
+     *
+     * @deprecated Use `disabled` instead. Removed in the next major release.
+     * @default false
+     */
     isDisabled?: boolean;
 }

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

@@ -94,7 +94,27 @@ export interface TooltipProps extends CommonProps {
     arrowProps?: TooltipArrowProps;
     /**
      * Controlled open state
-     * When provided, controls tooltip visibility externally
+     * When provided, the tooltip is fully controlled and the parent must update
+     * this value from `onOpenChange`
+     */
+    open?: boolean;
+    /**
+     * Initial open state for an uncontrolled tooltip
+     * @default false
+     */
+    defaultOpen?: boolean;
+    /**
+     * Called whenever the tooltip wants to open or close — hover, click, dismiss
+     * or Escape
+     */
+    onOpenChange?: (open: boolean) => void;
+    /**
+     * Initial open state.
+     *
+     * @deprecated Use `defaultOpen` instead. Despite the name, `isOpen` never
+     * controlled the tooltip — it only seeded the initial state, so a changing
+     * value had no effect. Pass `open` together with `onOpenChange` for real
+     * controlled behaviour. Removed in the next major release.
      */
     isOpen?: boolean;
 }

package/dist/components/Typeahead/Typeahead.d.ts

@@ -44,7 +44,7 @@ import { TypeaheadProps } from './types';
  *   name="tags"
  *   isMultiple
  *   label="Tags"
- *   selectedItems={selected}
+ *   value={selected}
  *   onChange={(item, isSelected) => handleToggle(item, isSelected)}>
  *   {options.map(opt => (
  *     <TypeaheadOption key={opt.id} value={opt.id}>
@@ -172,4 +172,4 @@ import { TypeaheadProps } from './types';
  *
  * @see https://www.w3.org/WAI/ARIA/apg/patterns/combobox/examples/combobox-select-only/
  */
-export declare const Typeahead: ({ name, label, selectedItems, defaultSelectedItems, isOpen, isDisabled, isMultiple, children, className, startIcon, endIcon, error, success, helperText, validationSchema, placeholder, startIconClassName, endIconClassName, popoverClassName, optionsClassName, wrapperClassName, filterOptions, autoSelect, allowCustomValues, width, onChange, onEmptyChange, onClearAll, onRemoveSelectedClick, renderOption, }: TypeaheadProps) => import("@emotion/react/jsx-runtime").JSX.Element;
+export declare const Typeahead: ({ name, label, value, defaultValue, selectedItems, defaultSelectedItems, isOpen, disabled, isDisabled, isMultiple, children, className, startIcon, endIcon, error, success, helperText, validationSchema, placeholder, startIconClassName, endIconClassName, popoverClassName, optionsClassName, wrapperClassName, filterOptions, autoSelect, allowCustomValues, width, onChange, onEmptyChange, onClearAll, onRemoveSelectedClick, renderOption, }: TypeaheadProps) => import("@emotion/react/jsx-runtime").JSX.Element;

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

@@ -33,13 +33,25 @@ export type TypeaheadOptionProps = Record<string, TypeaheadValue>;
  * ```
  */
 export interface TypeaheadProps {
+    /**
+     * Controlled selected values (array, even in single-select mode).
+     * When provided, controls the selection externally.
+     */
+    value?: Array<TypeaheadValue>;
+    /**
+     * Initially selected values, for uncontrolled mode.
+     */
+    defaultValue?: Array<TypeaheadValue>;
     /**
      * Controlled selected items (array of values)
-     * When provided, controls the selected items externally
+     *
+     * @deprecated Use `value` instead. Removed in the next major release.
      */
     selectedItems?: Array<TypeaheadValue>;
     /**
      * Default selected items for uncontrolled mode
+     *
+     * @deprecated Use `defaultValue` instead. Removed in the next major release.
      */
     defaultSelectedItems?: Array<TypeaheadValue>;
     /**
@@ -53,6 +65,13 @@ export interface TypeaheadProps {
      * Disabled typeahead cannot be interacted with
      * @default false
      */
+    disabled?: boolean;
+    /**
+     * Whether the component is disabled
+     *
+     * @deprecated Use `disabled` instead. Removed in the next major release.
+     * @default false
+     */
     isDisabled?: boolean;
     /**
      * TypeaheadOption components as children
@@ -205,6 +224,12 @@ export interface TypeaheadItemProps extends CommonProps {
     /**
      * Whether this option is disabled
      */
+    disabled?: boolean;
+    /**
+     * Whether this option is disabled
+     *
+     * @deprecated Use `disabled` instead. Removed in the next major release.
+     */
     isDisabled?: boolean;
     /**
      * Value of the option (must be unique)

package/dist/components/index.d.ts

@@ -122,6 +122,7 @@ export * from './History';
 export type * from './History/types';
 export * from './Pagination';
 export { default as Link } from './Link';
+export type { LinkProps } from './Link/Link.types';
 export * from './WithLink';
 export { default as Wrapper } from './Wrapper';
 export * from './Wrapper';

package/dist/index.d.ts

@@ -9,3 +9,4 @@ export * as styleUtils from './styles/safari-focus-outline';
 export * from './components';
 export * from './contexts';
 export * from './utils/react19HocCompat';
+export * from './utils/deprecation';