@ssa-ui-kit/core 3.19.0 → 3.20.0

package/dist/components/AccordionGroup/Accordion.d.ts

@@ -16,8 +16,8 @@ import { AccordionViewProps } from './types';
  * <Accordion
  *   id="accordion-1"
  *   title="Click to expand"
- *   ariaControls="panel-1"
- *   isOpened={false}
+ *   aria-controls="panel-1"
+ *   defaultOpen={false}
  *   renderTitle={AccordionTitle}
  *   renderContent={(props) => (
  *     <AccordionContent {...props}>
@@ -36,4 +36,4 @@ import { AccordionViewProps } from './types';
  * - ARIA controls and labelledby attributes for accessibility
  * - Keyboard accessible
  */
-export declare const Accordion: ({ title, isOpened, ariaControls, id, size, contentProps, renderTitle, renderContent, onClick, ...rest }: AccordionViewProps) => import("@emotion/react/jsx-runtime").JSX.Element;
+export declare const Accordion: (props: AccordionViewProps) => import("@emotion/react/jsx-runtime").JSX.Element;

package/dist/components/AccordionGroup/AccordionContent.d.ts

@@ -37,8 +37,8 @@ import { RenderContentProps } from './types';
  * ```tsx
  * // Custom content using AccordionContent props
  * <Accordion
- *   renderContent={({ isOpened, ...props }) => (
- *     <div {...props} style={{ display: isOpened ? 'block' : 'none' }}>
+ *   renderContent={({ open, ...props }) => (
+ *     <div {...props} style={{ display: open ? 'block' : 'none' }}>
  *       Custom content with conditional rendering
  *     </div>
  *   )}
@@ -47,6 +47,6 @@ import { RenderContentProps } from './types';
  *
  * @see {@link Accordion} - Parent component that uses this component
  */
-export declare const AccordionContent: ({ isOpened, children, size, ...rest }: RenderContentProps & {
+export declare const AccordionContent: ({ open, isOpened, children, size, ...rest }: RenderContentProps & {
     children: React.ReactNode;
 }) => import("@emotion/react/jsx-runtime").JSX.Element;

package/dist/components/AccordionGroup/AccordionGroup.d.ts

@@ -23,7 +23,7 @@ import { AccordionGroupProps } from './types';
  *     <Accordion
  *       id="first"
  *       title="First Section"
- *       ariaControls="first-panel"
+ *       aria-controls="first-panel"
  *       renderContent={(props) => (
  *         <AccordionContent {...props}>
  *           <p>Content for first section</p>

package/dist/components/AccordionGroup/AccordionTitle.d.ts

@@ -29,10 +29,10 @@ import { AccordionProps } from './types';
  * ```tsx
  * // Custom title using AccordionTitle as reference
  * <Accordion
- *   renderTitle={({ title, isOpened, onClick }) => (
- *     <button onClick={onClick} aria-expanded={isOpened}>
+ *   renderTitle={({ title, open, onClick }) => (
+ *     <button onClick={onClick} aria-expanded={open}>
  *       <span>{title}</span>
- *       <Icon name={isOpened ? "chevron-down" : "chevron-right"} />
+ *       <Icon name={open ? "chevron-down" : "chevron-right"} />
  *     </button>
  *   )}
  * />

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

@@ -26,7 +26,7 @@ type AccordionGroupChildren = React.ReactElement<React.PropsWithChildren<Accordi
  *     <Accordion
  *       id="first"
  *       title="First Accordion"
- *       ariaControls="first-panel"
+ *       aria-controls="first-panel"
  *       renderContent={(props) => (
  *         <AccordionContent {...props}>
  *           <p>Content for first accordion</p>
@@ -37,8 +37,8 @@ type AccordionGroupChildren = React.ReactElement<React.PropsWithChildren<Accordi
  *     <Accordion
  *       id="second"
  *       title="Second Accordion"
- *       ariaControls="second-panel"
- *       isOpened
+ *       aria-controls="second-panel"
+ *       defaultOpen
  *       renderContent={(props) => (
  *         <AccordionContent {...props}>
  *           <p>Content for second accordion</p>
@@ -89,8 +89,8 @@ export interface AccordionGroupProps {
  * <Accordion
  *   id="accordion-1"
  *   title="Click to expand"
- *   ariaControls="panel-1"
- *   isOpened={false}
+ *   aria-controls="panel-1"
+ *   defaultOpen={false}
  *   renderTitle={AccordionTitle}
  *   renderContent={(props) => (
  *     <AccordionContent {...props}>
@@ -117,6 +117,15 @@ export interface AccordionProps {
      */
     renderTitle: (data: RenderContentProps & {
         title: string;
+        /** Id of the content panel this title controls. */
+        'aria-controls'?: string;
+        /**
+         * Id of the content panel this title controls.
+         *
+         * @deprecated Read `aria-controls` instead — the `ariaControls` key is
+         * still passed for compatibility and is removed in the next major
+         * release.
+         */
         ariaControls?: string;
         onClick?: () => void;
     }) => React.ReactNode;
@@ -146,6 +155,13 @@ export type RenderContentProps = Pick<AccordionProps, 'id' | 'size'> & Pick<Aria
      * Whether the accordion is currently open
      * @default false
      */
+    open?: boolean;
+    /**
+     * Whether the accordion is currently open
+     *
+     * @deprecated Read `open` instead — `Accordion` passes both keys for the
+     * deprecation window and drops `isOpened` in the next major release.
+     */
     isOpened?: boolean;
     /**
      * Custom element type to render as
@@ -163,16 +179,50 @@ export type RenderContentProps = Pick<AccordionProps, 'id' | 'size'> & Pick<Aria
  * like title, open state, and event handlers.
  */
 export interface AccordionViewProps extends AccordionProps {
+    /**
+     * ARIA controls attribute
+     * Links the accordion header to its content panel, and is used as that
+     * panel's `id` — so it lands on the title button rather than on the
+     * accordion's own region element.
+     */
+    'aria-controls'?: string;
     /**
      * ARIA controls attribute
      * Links the accordion header to its content panel
      * Should match the id of the content panel
+     *
+     * @deprecated Use `aria-controls` instead — `ariaControls` is removed in the
+     * next major release.
      */
     ariaControls?: string;
     /**
      * Whether the accordion is currently open
+     *
+     * Normally injected by the parent `AccordionGroup`, which owns the open
+     * state. Setting it directly on an `Accordion` inside a group seeds that
+     * accordion's initial state on mount.
+     * @default false
+     */
+    open?: boolean;
+    /**
+     * Whether the accordion starts open
+     *
+     * Read once by `AccordionGroup` on mount; the group owns the state from then
+     * on. Prefer this over `open` when all you want is an initially expanded
+     * accordion.
      * @default false
      */
+    defaultOpen?: boolean;
+    /**
+     * Called when the accordion is toggled, with the state it is moving to
+     */
+    onOpenChange?: (open: boolean) => void;
+    /**
+     * Whether the accordion is currently open
+     *
+     * @deprecated Use `open` (or `defaultOpen` for initial state) instead —
+     * `isOpened` is removed in the next major release.
+     */
     isOpened?: boolean;
     /**
      * Whether the accordion is hidden

package/dist/components/Breadcrumbs/Breadcrumbs.d.ts

@@ -20,4 +20,4 @@ import { BreadcrumbsProps } from './types';
  * />
  * ```
  */
-export declare const Breadcrumbs: ({ items, maxItems, separator, ariaLabel, className, css, }: BreadcrumbsProps) => import("@emotion/react/jsx-runtime").JSX.Element | null;
+export declare const Breadcrumbs: ({ items, maxItems, separator, "aria-label": ariaLabelNative, ariaLabel, className, css, }: BreadcrumbsProps) => import("@emotion/react/jsx-runtime").JSX.Element | null;

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

@@ -50,7 +50,17 @@ export interface BreadcrumbsProps extends CommonProps {
     maxItems?: number;
     /** Custom separator between crumbs. Defaults to a right chevron. */
     separator?: React.ReactNode;
-    /** Accessible label for the wrapping `nav`. */
+    /**
+     * Accessible label for the wrapping `nav`.
+     * @default 'Breadcrumb'
+     */
+    'aria-label'?: string;
+    /**
+     * Accessible label for the wrapping `nav`.
+     *
+     * @deprecated Use `aria-label` instead — `ariaLabel` is removed in the next
+     * major release.
+     */
     ariaLabel?: string;
     /** Custom Emotion styles applied to the wrapping `nav`. */
     css?: Interpolation<Theme>;

package/dist/components/Button/Button.d.ts

@@ -42,6 +42,12 @@ import { ButtonProps } from './types';
  *
  * @example
  * ```tsx
+ * // Loading: spinner replaces the label, button is disabled, width is unchanged
+ * <Button variant="primary" text="Save" loading={isSaving} onClick={handleSave} />
+ * ```
+ *
+ * @example
+ * ```tsx
  * // Button with custom children
  * <Button variant="secondary" onClick={handleAction}>
  *   <span>Custom Content</span>

package/dist/components/Button/fixtures.d.ts

@@ -1,6 +1,6 @@
 import Icon from '../Icon';
 import { ButtonProps } from './types';
-export type TestPropsType = Omit<ButtonProps, 'isDisabled' | 'startIcon' | 'endIcon'> & {
+export type TestPropsType = Omit<ButtonProps, 'isDisabled' | 'disabled' | 'startIcon' | 'endIcon'> & {
     disabled?: boolean;
     startIcon?: React.ComponentProps<typeof Icon>['name'];
     endIcon?: React.ComponentProps<typeof Icon>['name'];
@@ -12,7 +12,7 @@ export declare const secondaryBtnSpecs: {
     "aria-labelledby"?: string | undefined | undefined;
     "aria-label"?: string | undefined | undefined;
     "aria-describedby"?: string | undefined | undefined;
-    "aria-disabled"?: (boolean | "false" | "true") | undefined;
+    "aria-disabled"?: (boolean | "true" | "false") | undefined;
     "aria-pressed"?: boolean | "false" | "mixed" | "true" | undefined | undefined;
     "aria-current"?: boolean | "false" | "true" | "page" | "step" | "location" | "date" | "time" | undefined | undefined;
     block?: boolean | undefined;
@@ -20,6 +20,7 @@ export declare const secondaryBtnSpecs: {
     startIconClassName?: string | undefined;
     endIconClassName?: string | undefined;
     type?: "button" | "reset" | "submit" | undefined;
+    loading?: boolean | undefined;
     className?: string | undefined;
     onClick?: import("react").MouseEventHandler<HTMLButtonElement> | undefined;
     children?: import("react").ReactNode;
@@ -33,7 +34,7 @@ export declare const tertiaryBtnSpecs: {
     "aria-labelledby"?: string | undefined | undefined;
     "aria-label"?: string | undefined | undefined;
     "aria-describedby"?: string | undefined | undefined;
-    "aria-disabled"?: (boolean | "false" | "true") | undefined;
+    "aria-disabled"?: (boolean | "true" | "false") | undefined;
     "aria-pressed"?: boolean | "false" | "mixed" | "true" | undefined | undefined;
     "aria-current"?: boolean | "false" | "true" | "page" | "step" | "location" | "date" | "time" | undefined | undefined;
     block?: boolean | undefined;
@@ -41,6 +42,7 @@ export declare const tertiaryBtnSpecs: {
     startIconClassName?: string | undefined;
     endIconClassName?: string | undefined;
     type?: "button" | "reset" | "submit" | undefined;
+    loading?: boolean | undefined;
     className?: string | undefined;
     onClick?: import("react").MouseEventHandler<HTMLButtonElement> | undefined;
     children?: import("react").ReactNode;
@@ -54,7 +56,7 @@ export declare const errorBtnSpecs: {
     "aria-labelledby"?: string | undefined | undefined;
     "aria-label"?: string | undefined | undefined;
     "aria-describedby"?: string | undefined | undefined;
-    "aria-disabled"?: (boolean | "false" | "true") | undefined;
+    "aria-disabled"?: (boolean | "true" | "false") | undefined;
     "aria-pressed"?: boolean | "false" | "mixed" | "true" | undefined | undefined;
     "aria-current"?: boolean | "false" | "true" | "page" | "step" | "location" | "date" | "time" | undefined | undefined;
     block?: boolean | undefined;
@@ -62,6 +64,7 @@ export declare const errorBtnSpecs: {
     startIconClassName?: string | undefined;
     endIconClassName?: string | undefined;
     type?: "button" | "reset" | "submit" | undefined;
+    loading?: boolean | undefined;
     className?: string | undefined;
     onClick?: import("react").MouseEventHandler<HTMLButtonElement> | undefined;
     children?: import("react").ReactNode;
@@ -75,7 +78,7 @@ export declare const warningBtnSpecs: {
     "aria-labelledby"?: string | undefined | undefined;
     "aria-label"?: string | undefined | undefined;
     "aria-describedby"?: string | undefined | undefined;
-    "aria-disabled"?: (boolean | "false" | "true") | undefined;
+    "aria-disabled"?: (boolean | "true" | "false") | undefined;
     "aria-pressed"?: boolean | "false" | "mixed" | "true" | undefined | undefined;
     "aria-current"?: boolean | "false" | "true" | "page" | "step" | "location" | "date" | "time" | undefined | undefined;
     block?: boolean | undefined;
@@ -83,6 +86,7 @@ export declare const warningBtnSpecs: {
     startIconClassName?: string | undefined;
     endIconClassName?: string | undefined;
     type?: "button" | "reset" | "submit" | undefined;
+    loading?: boolean | undefined;
     className?: string | undefined;
     onClick?: import("react").MouseEventHandler<HTMLButtonElement> | undefined;
     children?: import("react").ReactNode;
@@ -96,7 +100,7 @@ export declare const successBtnSpecs: {
     "aria-labelledby"?: string | undefined | undefined;
     "aria-label"?: string | undefined | undefined;
     "aria-describedby"?: string | undefined | undefined;
-    "aria-disabled"?: (boolean | "false" | "true") | undefined;
+    "aria-disabled"?: (boolean | "true" | "false") | undefined;
     "aria-pressed"?: boolean | "false" | "mixed" | "true" | undefined | undefined;
     "aria-current"?: boolean | "false" | "true" | "page" | "step" | "location" | "date" | "time" | undefined | undefined;
     block?: boolean | undefined;
@@ -104,6 +108,7 @@ export declare const successBtnSpecs: {
     startIconClassName?: string | undefined;
     endIconClassName?: string | undefined;
     type?: "button" | "reset" | "submit" | undefined;
+    loading?: boolean | undefined;
     className?: string | undefined;
     onClick?: import("react").MouseEventHandler<HTMLButtonElement> | undefined;
     children?: import("react").ReactNode;

package/dist/components/Button/styles.d.ts

@@ -1,5 +1,15 @@
 import { SerializedStyles } from '@emotion/react';
 import { ButtonVariants } from './types';
+/**
+ * Keeps the button at its resting width while loading: the real content stays
+ * in the layout but is hidden, and the spinner is centred over it.
+ *
+ * `display: contents` leaves the children as direct flex items of the button,
+ * so the loading state measures exactly the same as the resting state.
+ * `&&` outweighs `buttonBlock`'s `span { … }` rule in block mode.
+ */
+export declare const loadingContent: SerializedStyles;
+export declare const loadingSpinner: SerializedStyles;
 export declare const buttonBlock: SerializedStyles;
 export declare const iconWrapperRight: SerializedStyles;
 export declare const iconWrapperLeft: SerializedStyles;

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

@@ -91,6 +91,20 @@ export interface ButtonProps extends ButtonAriaProps {
      * Disables the button, preventing user interaction
      * @default false
      */
+    disabled?: boolean;
+    /**
+     * Shows a spinner in place of the button's content and disables interaction.
+     * The button keeps its resting width, so a row of buttons does not reflow.
+     * Also sets `aria-busy`.
+     * @default false
+     */
+    loading?: boolean;
+    /**
+     * Disables the button, preventing user interaction
+     *
+     * @deprecated Use `disabled` instead. Removed in the next major release.
+     * @default false
+     */
     isDisabled?: boolean;
     /**
      * Custom CSS class name for the button

package/dist/components/ButtonGroup/ButtonGroup.d.ts

@@ -1,2 +1,29 @@
 import { ButtonGroupProps } from './types';
-export declare const ButtonGroup: ({ items, buttonStyles, selectedItem, externalState, onClick, }: ButtonGroupProps) => import("@emotion/react/jsx-runtime").JSX.Element;
+/**
+ * ButtonGroup - A row of mutually exclusive buttons.
+ *
+ * Two ways to declare the buttons:
+ * - **Composed** — `ButtonGroupButton` children. Use when a button needs an
+ *   icon or custom markup.
+ * - **Data-driven** — the `items` prop. Compact, but limited to plain labels.
+ *
+ * Selection can be controlled (`value`) or left to the group (`defaultValue`).
+ * Either accepts a bare `id` or a whole item.
+ *
+ * @category Form Controls
+ * @subcategory Action
+ *
+ * @example
+ * ```tsx
+ * <ButtonGroup items={items} value={period} onClick={({ id }) => setPeriod(id)} />
+ * ```
+ *
+ * @example
+ * ```tsx
+ * <ButtonGroup value={period} onClick={({ id }) => setPeriod(id)}>
+ *   <ButtonGroupButton id="24h">24h</ButtonGroupButton>
+ *   <ButtonGroupButton id="7d">7 days</ButtonGroupButton>
+ * </ButtonGroup>
+ * ```
+ */
+export declare const ButtonGroup: (props: ButtonGroupProps) => import("@emotion/react/jsx-runtime").JSX.Element;

package/dist/components/ButtonGroup/ButtonGroupButton.d.ts

@@ -0,0 +1,22 @@
+import { ButtonGroupButtonProps } from './types';
+/**
+ * ButtonGroupButton - One button inside a composed `ButtonGroup`.
+ *
+ * Reads selection state from the enclosing group, so it only needs an `id`.
+ * Use this instead of the group's `items` prop when a button needs an icon,
+ * custom markup, or anything else `ButtonGroupItem` cannot express.
+ *
+ * @category Form Controls
+ * @subcategory Action
+ *
+ * @example
+ * ```tsx
+ * <ButtonGroup value={period} onClick={({ id }) => setPeriod(id)}>
+ *   <ButtonGroupButton id="24h">24h</ButtonGroupButton>
+ *   <ButtonGroupButton id="7d">
+ *     <Icon name="calendar" size={14} /> 7 days
+ *   </ButtonGroupButton>
+ * </ButtonGroup>
+ * ```
+ */
+export declare const ButtonGroupButton: ({ id, children, text, disabled, onClick, className, }: ButtonGroupButtonProps) => import("@emotion/react/jsx-runtime").JSX.Element;

package/dist/components/ButtonGroup/ButtonGroupButtonBase.d.ts

@@ -0,0 +1,23 @@
+import { ReactNode } from 'react';
+import { SerializedStyles } from '@emotion/react';
+interface ButtonGroupButtonBaseProps {
+    isActive: boolean;
+    disabled?: boolean;
+    onClick: () => void;
+    buttonStyles?: SerializedStyles;
+    className?: string;
+    children?: ReactNode;
+}
+/**
+ * The button markup shared by both of `ButtonGroup`'s APIs.
+ *
+ * `ButtonGroupButton` wires this to the group context; the `items` path renders
+ * it directly, so it can keep reporting the caller's own item object rather
+ * than one reassembled from props. Everything visual — the secondary/small
+ * variant, the `active` class the styles key off, `aria-pressed` — lives here
+ * once.
+ *
+ * Internal: not exported from the package.
+ */
+export declare const ButtonGroupButtonBase: ({ isActive, disabled, onClick, buttonStyles, className, children, }: ButtonGroupButtonBaseProps) => import("@emotion/react/jsx-runtime").JSX.Element;
+export {};

package/dist/components/ButtonGroup/ButtonGroupContext.d.ts

@@ -0,0 +1,9 @@
+import { ButtonGroupContextValue } from './types';
+export declare const ButtonGroupContext: import("react").Context<ButtonGroupContextValue | null>;
+/**
+ * Access the enclosing `ButtonGroup`'s selection state.
+ *
+ * @throws if used outside a `ButtonGroup` — a `ButtonGroupButton` on its own has
+ * no group to report to, which is a wiring mistake rather than a fallback case.
+ */
+export declare const useButtonGroupContext: () => ButtonGroupContextValue;

package/dist/components/ButtonGroup/index.d.ts

@@ -1,2 +1,4 @@
 export { ButtonGroup } from './ButtonGroup';
+export { ButtonGroupButton } from './ButtonGroupButton';
+export { useButtonGroupContext } from './ButtonGroupContext';
 export * from './types';

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

@@ -1,13 +1,101 @@
+import { ReactNode } from 'react';
 import { SerializedStyles } from '@emotion/react';
 export type ButtonGroupItem = {
     id: string | number;
     text: string;
+    /** Renders this item's button as disabled. */
+    disabled?: boolean;
+    /**
+     * @deprecated Use `disabled` instead. Removed in the next major release.
+     */
     isDisabled?: boolean;
 };
+/**
+ * A selection, expressed either as the item itself or — usually more
+ * convenient — as just its `id`. The group only ever compares ids, so the two
+ * forms are equivalent.
+ */
+export type ButtonGroupValue = ButtonGroupItem | ButtonGroupItem['id'];
 export interface ButtonGroupProps {
-    items: Array<ButtonGroupItem>;
-    selectedItem?: ButtonGroupItem;
-    externalState?: ButtonGroupItem;
-    onClick: (item: ButtonGroupItem) => void;
+    /**
+     * Buttons to render, as `ButtonGroupButton` children. When provided, `items`
+     * is ignored — use this when a button needs an icon, custom markup, or
+     * anything else `ButtonGroupItem` cannot express.
+     *
+     * Note that an uncontrolled group in children mode starts with **nothing**
+     * selected; pass `defaultValue` to preselect. (The `items` API preselects the
+     * first item, which it can only do because it can see the list.)
+     */
+    children?: ReactNode;
+    /**
+     * Buttons to render, as data. Ignored when `children` are provided.
+     */
+    items?: Array<ButtonGroupItem>;
+    /**
+     * Active selection, for the controlled pattern. When provided, the parent
+     * owns the selection and the group only reports intent through `onClick`.
+     *
+     * Pass the item's `id` (recommended) or the whole item:
+     * `value="unread"` or `value={{ id: 'unread', text: 'Unread' }}`.
+     */
+    value?: ButtonGroupValue;
+    /**
+     * Initial selection, as an `id` or the whole item. Only used when neither
+     * `value` nor the deprecated `selectedItem` / `externalState` are provided;
+     * otherwise the group falls back to the first item.
+     */
+    defaultValue?: ButtonGroupValue;
+    /**
+     * Also accepts a bare `id`, like `value`.
+     *
+     * @deprecated Use `value` for the controlled pattern, or `defaultValue` for
+     * the initial selection. Removed in the next major release.
+     */
+    selectedItem?: ButtonGroupValue;
+    /**
+     * Also accepts a bare `id`, like `value`.
+     *
+     * @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 `onClick`. `value` is fully controlled.
+     */
+    externalState?: ButtonGroupValue;
+    /**
+     * Called with the clicked item. Optional — an uncontrolled group that only
+     * needs to track its own selection needs no handler.
+     *
+     * In children mode the group cannot see an item list, so it reports
+     * `{ id, text, disabled }` assembled from the clicked `ButtonGroupButton`'s
+     * props — `id` is always accurate, `text` is only populated when the button's
+     * content is a plain string or its `text` prop is set. Prefer reading `id`,
+     * or give each button its own `onClick`.
+     */
+    onClick?: (item: ButtonGroupItem) => void;
+    buttonStyles?: SerializedStyles;
+}
+export interface ButtonGroupButtonProps {
+    /** Identifies this button within the group; matched against `value`. */
+    id: ButtonGroupItem['id'];
+    /** Button content — text, an icon, or any markup. */
+    children?: ReactNode;
+    /**
+     * Plain-text label for this button, used when the group reports the clicked
+     * item through its `onClick`. Only needed when `children` is not a string.
+     */
+    text?: string;
+    /** Renders this button as disabled. */
+    disabled?: boolean;
+    /**
+     * Fired when this button is clicked, in addition to the group's `onClick`.
+     * The idiomatic handler in children mode.
+     */
+    onClick?: () => void;
+    /** Custom CSS class name, merged with the group's active-state class. */
+    className?: string;
+}
+export interface ButtonGroupContextValue {
+    activeId?: ButtonGroupItem['id'];
+    onSelect: (item: ButtonGroupItem) => void;
     buttonStyles?: SerializedStyles;
 }

package/dist/components/CardContent/CardContent.d.ts

@@ -4,8 +4,16 @@ export interface CardProps extends CommonProps {
     style?: React.CSSProperties;
     direction?: 'row' | 'row-reverse' | 'column' | 'column-reverse';
     className?: string;
+    /** Id of the element labelling this content region. */
+    'aria-labelledby'?: string;
+    /**
+     * Id of the element labelling this content region.
+     *
+     * @deprecated Use `aria-labelledby` instead — `ariaLabelledby` is removed in
+     * the next major release.
+     */
     ariaLabelledby?: string;
     role?: string;
 }
-declare const CardContent: ({ children, ...props }: CardProps) => import("@emotion/react/jsx-runtime").JSX.Element;
+declare const CardContent: ({ children, "aria-labelledby": ariaLabelledbyNative, ariaLabelledby, ...props }: CardProps) => import("@emotion/react/jsx-runtime").JSX.Element;
 export default CardContent;

package/dist/components/Checkbox/Checkbox.d.ts

@@ -83,5 +83,5 @@ import { CheckboxProps } from './types';
  *
  * @requires React Hook Form when using `register` prop
  */
-declare const Checkbox: ({ text, id, onChange, isDisabled, externalState, initialState, isIndeterminate, name, isRequired, ref, register, ...rest }: CheckboxProps) => import("@emotion/react/jsx-runtime").JSX.Element;
+declare const Checkbox: import("react").ForwardRefExoticComponent<CheckboxProps & import("react").RefAttributes<HTMLInputElement>>;
 export default Checkbox;

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

@@ -1,4 +1,4 @@
-import { RefObject, ReactNode } from 'react';
+import { ReactNode } from 'react';
 import { Control, FieldPath, FieldValues, UseFormReturn } from 'react-hook-form';
 /**
  * Props for the Checkbox component
@@ -55,9 +55,23 @@ export interface CheckboxProps extends Partial<Pick<UseFormReturn, 'register'>>
      * Receives the new checked state (boolean) as parameter
      */
     onChange?: (newState: boolean) => void;
+    /**
+     * Checked state, for the controlled pattern. When provided, the parent owns
+     * the value: the checkbox renders exactly what it is given and only reports
+     * intent through `onChange`.
+     *
+     * Note this is stricter than the deprecated `externalState`, which let the
+     * checkbox also toggle itself.
+     */
+    checked?: boolean;
     /**
      * External state control - allows parent component to control checkbox state
      * When provided, the checkbox becomes controlled
+     *
+     * @deprecated Use `checked` instead. Removed in the next major release.
+     * Note the semantics differ slightly: `externalState` is synced *into*
+     * internal state, so the checkbox still toggles on click even when the
+     * parent ignores `onChange`. `checked` is fully controlled.
      */
     externalState?: boolean;
     /**
@@ -65,12 +79,26 @@ export interface CheckboxProps extends Partial<Pick<UseFormReturn, 'register'>>
      * Disabled checkboxes cannot be interacted with and appear visually muted
      * @default false
      */
+    disabled?: boolean;
+    /**
+     * Whether the checkbox is disabled
+     *
+     * @deprecated Use `disabled` instead. Removed in the next major release.
+     * @default false
+     */
     isDisabled?: boolean;
     /**
      * Initial checked state when component mounts
      * Only used for uncontrolled checkboxes
      * @default false
      */
+    defaultChecked?: boolean;
+    /**
+     * Initial checked state when component mounts
+     *
+     * @deprecated Use `defaultChecked` instead. Removed in the next major release.
+     * @default false
+     */
     initialState?: boolean;
     /**
      * Indeterminate state - represents a partially selected state
@@ -90,10 +118,6 @@ export interface CheckboxProps extends Partial<Pick<UseFormReturn, 'register'>>
      * @default false
      */
     isRequired?: boolean;
-    /**
-     * Ref object to access the underlying input element
-     */
-    ref?: RefObject<HTMLInputElement>;
     /**
      * Color variant of the checkbox — controls the checked and focus-state colors.
      * Sourced from `theme.palette`:

package/dist/components/ColorPicker/ColorPicker.d.ts

@@ -1,3 +1,3 @@
 import { ColorPickerProps } from './types';
 import '@rc-component/color-picker/assets/index.css';
-export declare const ColorPicker: ({ color: providedColor, format: providedFormat, colorsPalette, ...rest }: ColorPickerProps) => import("@emotion/react/jsx-runtime").JSX.Element;
+export declare const ColorPicker: ({ value, color, defaultValue, defaultColor, format: providedFormat, colorsPalette, ...rest }: ColorPickerProps) => import("@emotion/react/jsx-runtime").JSX.Element;