@ssa-ui-kit/core 3.19.1 → 3.20.0

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

@@ -3,11 +3,25 @@ import { SmallTabProps, TabProps } from '../TabBar/types';
 import { COLOR_FORMAT } from './constants';
 export type ColorFormat = keyof typeof COLOR_FORMAT;
 export interface ColorPickerProps {
+    /**
+     * Controlled colour value. When provided, the parent owns the value.
+     */
+    value?: string;
+    /**
+     * Initial colour value, for uncontrolled mode.
+     */
+    defaultValue?: string;
+    /**
+     * @deprecated Use `defaultValue` instead. Removed in the next major release.
+     */
     defaultColor?: string;
+    /**
+     * @deprecated Use `value` instead. Removed in the next major release.
+     */
+    color?: string;
     defaultFormat?: ColorFormat;
     disabledAlpha?: boolean;
     disabled?: boolean;
-    color?: string;
     format?: ColorFormat;
     label?: string;
     colorsPalette?: string[];
@@ -21,17 +35,17 @@ export interface ColorPickerProps {
     };
     onChange?: (color: string) => void;
 }
-export type ColorPickerProviderInputProps = Omit<ColorPickerProps, 'color' | 'format'> & {
-    providedColor: ColorPickerProps['color'];
+export type ColorPickerProviderInputProps = Omit<ColorPickerProps, 'color' | 'value' | 'defaultValue' | 'format'> & {
+    providedColor: ColorPickerProps['value'];
     providedFormat: ColorPickerProps['format'];
 };
-export type ColorPickerProviderOutputProps = Omit<ColorPickerProps, 'color'> & {
+export type ColorPickerProviderOutputProps = Omit<ColorPickerProps, 'color' | 'value' | 'defaultValue'> & {
     rawColor?: string | Color;
     format: ColorFormat;
     copy: (valueToCopy: string) => void;
     setRawColor: (color: string | Color) => void;
     setFormat: (format: ColorFormat) => void;
 };
-export type ColorPickerTabProps = Pick<TabProps, 'tabId' | 'isActive' | 'ariaControls' | 'onClick'> & Pick<SmallTabProps, 'text'> & {
+export type ColorPickerTabProps = Pick<TabProps, 'tabId' | 'isActive' | 'aria-controls' | 'onClick'> & Pick<SmallTabProps, 'text'> & {
     isActive?: boolean;
 };

package/dist/components/Counter/Counter.d.ts

@@ -56,5 +56,5 @@ import { CounterProps } from './types';
  * <Counter count={3} css={{ marginLeft: 8, borderRadius: 4 }} />
  * ```
  */
-export declare const Counter: ({ count, variant, size, color, className, css, ref, }: CounterProps) => import("@emotion/react/jsx-runtime").JSX.Element;
+export declare const Counter: import("react").ForwardRefExoticComponent<CounterProps & import("react").RefAttributes<HTMLDivElement>>;
 export default Counter;

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

@@ -1,4 +1,3 @@
-import React from 'react';
 import { MainSizes } from '../../types/global';
 import { ColorsKeys } from '../../types/emotion';
 import { Interpolation, SerializedStyles, Theme } from '@emotion/react';
@@ -50,8 +49,4 @@ export type CounterProps = {
      * Use for one-off layout adjustments (e.g. margins, positioning).
      */
     css?: Interpolation<Theme>;
-    /**
-     * Ref forwarded to the root `<div>` element.
-     */
-    ref?: React.Ref<HTMLDivElement>;
 };

package/dist/components/Drawer/useDrawer.d.ts

@@ -1,16 +1,40 @@
 import { OpenChangeReason } from '@floating-ui/react';
 export type Position = 'left' | 'right' | 'top' | 'bottom';
 export type UseDrawerOptions = {
+    /**
+     * Controlled open state. When provided, the drawer is fully controlled and
+     * the parent must update it from `onOpenChange`.
+     */
+    open?: boolean;
+    /** Initial open state for an uncontrolled drawer. */
+    defaultOpen?: boolean;
+    /**
+     * Controlled open state.
+     *
+     * @deprecated Use `open` instead — `opened` is removed in the next major
+     * release.
+     */
     opened?: boolean;
-    duration?: number;
+    /**
+     * Initial open state for an uncontrolled drawer.
+     *
+     * @deprecated Use `defaultOpen` instead — `defaultOpened` is removed in the
+     * next major release.
+     */
     defaultOpened?: boolean;
+    duration?: number;
     dismissable?: boolean;
     position?: Position;
     title?: string;
     withCloseButton?: boolean;
     onOpenChange?: (open: boolean, event?: Event, reason?: OpenChangeReason) => void;
 };
-export declare const useDrawer: ({ opened, duration, defaultOpened, dismissable, position, title, withCloseButton, onOpenChange, }?: UseDrawerOptions) => {
+export declare const useDrawer: (options?: UseDrawerOptions) => {
+    open: boolean;
+    /**
+     * @deprecated Read `open` instead — the `opened` key is removed from the
+     * store in the next major release.
+     */
     opened: boolean;
     dismissable: boolean;
     position: Position;
@@ -43,6 +67,6 @@ export declare const useDrawer: ({ opened, duration, defaultOpened, dismissable,
     portalNode: HTMLElement | null;
     setFloating: ((node: HTMLElement | null) => void) & ((node: HTMLElement | null) => void);
     setPortalNode: import("react").Dispatch<import("react").SetStateAction<HTMLElement | null>>;
-    toggle: (open?: boolean) => void;
+    toggle: (nextOpen?: boolean) => void;
 };
 export type UseDrawerStore = ReturnType<typeof useDrawer>;

package/dist/components/Dropdown/Dropdown.d.ts

@@ -94,5 +94,5 @@ import { DropdownProps } from './types';
  *
  * @see https://www.w3.org/WAI/ARIA/apg/example-index/combobox/combobox-select-only.html
  */
-declare const Dropdown: <T extends DropdownOptionProps>({ selectedItem, isDisabled, isOpen: isInitOpen, children, onChange: handleChange, className, placeholder, maxHeight, avatarBorder, label, helperText, errors, success, icon, dropdownProps: componentProps, }: DropdownProps<T>) => import("@emotion/react/jsx-runtime").JSX.Element;
+declare const Dropdown: <T extends DropdownOptionProps>({ selectedItem, disabled, isDisabled, isOpen: isInitOpen, children, onChange: handleChange, className, placeholder, maxHeight, avatarBorder, label, helperText, errors, success, icon, dropdownProps: componentProps, }: DropdownProps<T>) => import("@emotion/react/jsx-runtime").JSX.Element;
 export default Dropdown;

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

@@ -70,6 +70,10 @@ export interface DropdownProps<P extends DropdownOptionProps> extends CommonProp
      * Disabled dropdowns cannot be opened or interacted with
      * @default false
      */
+    disabled?: boolean;
+    /**
+     * @deprecated Use `disabled` instead. Removed in the next major release.
+     */
     isDisabled?: boolean;
     /**
      * Placeholder text displayed when no item is selected

package/dist/components/DropdownOption/DropdownOption.d.ts

@@ -1,10 +1,16 @@
 import React from 'react';
-import { Theme } from '@emotion/react';
 import { CommonProps } from '../../types/emotion';
-interface DropdownItemProps extends CommonProps {
+export interface DropdownItemProps extends CommonProps, Omit<React.LiHTMLAttributes<HTMLLIElement>, 'value' | 'onClick'> {
     onClick?: (e: React.MouseEvent<HTMLElement>) => void;
     isActive?: boolean;
     isMultiple?: boolean;
+    /** Whether this option is disabled. Only styled in `isMultiple` mode. */
+    disabled?: boolean;
+    /**
+     * Whether this option is disabled.
+     *
+     * @deprecated Use `disabled` instead. Removed in the next major release.
+     */
     isDisabled?: boolean;
     noHover?: boolean;
     value?: string | number | boolean;
@@ -13,8 +19,13 @@ interface DropdownItemProps extends CommonProps {
     /** Avatar or icon to display before the option content (e.g. <Avatar size={20} image={url} />) */
     avatar?: React.ReactNode;
 }
-declare const DropdownOption: import("@emotion/styled").StyledComponent<{
-    theme?: Theme;
-    as?: React.ElementType;
-} & DropdownItemProps, React.DetailedHTMLProps<React.LiHTMLAttributes<HTMLLIElement>, HTMLLIElement>, {}>;
+/**
+ * DropdownOption - A single selectable row inside `Dropdown` or
+ * `MultipleDropdown`.
+ *
+ * Thin wrapper over a styled `<li>`. It exists so that `disabled` can be
+ * accepted as the supported prop name without emotion forwarding it to the
+ * DOM, where `disabled` is not valid on an `<li>`.
+ */
+declare const DropdownOption: React.ForwardRefExoticComponent<DropdownItemProps & React.RefAttributes<HTMLLIElement>>;
 export default DropdownOption;

package/dist/components/DropdownOptions/DropdownOptions.d.ts

@@ -35,5 +35,5 @@ import { DropdownItemsListProps } from './types';
  * - Supports keyboard navigation (Arrow keys, Enter, Escape)
  * - Screen reader friendly
  */
-declare const DropdownOptions: ({ ariaLabelledby, id, children, }: DropdownItemsListProps) => import("@emotion/react/jsx-runtime").JSX.Element;
+declare const DropdownOptions: ({ "aria-labelledby": ariaLabelledbyNative, ariaLabelledby, id, children, }: DropdownItemsListProps) => import("@emotion/react/jsx-runtime").JSX.Element;
 export default DropdownOptions;

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

@@ -17,6 +17,14 @@ export interface DropdownItemsListProps extends CommonProps {
      * 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;
     /**
      * Unique identifier for the options container

package/dist/components/DropdownToggle/DropdownToggle.d.ts

@@ -3,6 +3,6 @@ import { DropdownToggleProps } from './types';
 export declare const DropdownToggleBase: import("@emotion/styled").StyledComponent<{
     theme?: Theme;
     as?: React.ElementType;
-} & Pick<DropdownToggleProps, "colors" | "disabled" | "status" | "isOpen" | "isMultiple" | "selectedCount">, import("react").DetailedHTMLProps<import("react").ButtonHTMLAttributes<HTMLButtonElement>, HTMLButtonElement>, {}>;
-declare const DropdownToggle: ({ onClick, onFocus, isOpen, isMultiple, selectedCount, disabled, children, ariaLabelledby, ariaControls, colors, status, className, ...restProps }: DropdownToggleProps) => import("@emotion/react/jsx-runtime").JSX.Element;
+} & Pick<DropdownToggleProps, "colors" | "isOpen" | "disabled" | "status" | "isMultiple" | "selectedCount">, import("react").DetailedHTMLProps<import("react").ButtonHTMLAttributes<HTMLButtonElement>, HTMLButtonElement>, {}>;
+declare const DropdownToggle: ({ onClick, onFocus, isOpen, isMultiple, selectedCount, disabled, children, "aria-labelledby": ariaLabelledbyNative, "aria-controls": ariaControlsNative, ariaLabelledby, ariaControls, colors, status, className, ...restProps }: DropdownToggleProps) => import("@emotion/react/jsx-runtime").JSX.Element;
 export default DropdownToggle;

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

@@ -11,8 +11,30 @@ export interface DropdownToggleProps extends CommonProps, Omit<React.ButtonHTMLA
     isMultiple?: boolean;
     disabled?: boolean;
     children?: React.ReactNode;
-    ariaLabelledby: string;
-    ariaControls: string;
+    /**
+     * Id of the element labelling the toggle.
+     *
+     * Re-declared because `ControlledButtonProps` omits it from the inherited
+     * button attributes — that omission is about `dropdownProps.toggleButton`,
+     * where Dropdown owns the wiring, not about this component's own surface.
+     */
+    'aria-labelledby'?: string;
+    /** Id of the listbox the toggle controls. */
+    'aria-controls'?: string;
+    /**
+     * Id of the element labelling the toggle.
+     *
+     * @deprecated Use `aria-labelledby` instead — `ariaLabelledby` is removed in
+     * the next major release.
+     */
+    ariaLabelledby?: string;
+    /**
+     * Id of the listbox the toggle controls.
+     *
+     * @deprecated Use `aria-controls` instead — `ariaControls` is removed in the
+     * next major release.
+     */
+    ariaControls?: string;
     colors?: Array<string | undefined>;
     className?: string;
     selectedCount?: number;

package/dist/components/FileAttachment/FileAttachment.d.ts

@@ -32,5 +32,5 @@ import { FileAttachmentProps } from './types';
  * />
  * ```
  */
-declare const FileAttachment: ({ file, size, progress, progressDisplay, uploadingText, uploadedText, showDescription, icon, isDisabled, onRemove, className, css: cssProp, }: FileAttachmentProps) => import("@emotion/react/jsx-runtime").JSX.Element;
+declare const FileAttachment: ({ file, size, progress, progressDisplay, uploadingText, uploadedText, showDescription, icon, disabled, isDisabled, onRemove, className, css: cssProp, }: FileAttachmentProps) => import("@emotion/react/jsx-runtime").JSX.Element;
 export default FileAttachment;

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

@@ -17,6 +17,11 @@ export interface FileAttachmentProps {
     uploadedText?: string;
     showDescription?: boolean;
     icon?: IconProps['name'];
+    /** Mutes the attachment and disables the remove button. */
+    disabled?: boolean;
+    /**
+     * @deprecated Use `disabled` instead. Removed in the next major release.
+     */
     isDisabled?: boolean;
     onRemove?: () => void;
     className?: string;

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

@@ -2,4 +2,4 @@ export { FiltersMultiSelect, type FiltersMultiSelectProps, } from './FiltersMult
 export { FiltersMultiSelectOption, type FiltersMultiSelectOptionProps, } from './components/FiltersMultiSelectOption';
 export { FiltersMultiSelectOptions } from './components/FiltersMultiSelectOptions';
 export { FiltersMultiSelectEmpty, type FiltersMultiSelectEmptyProps, } from './components/FiltersMultiSelectEmpty';
-export { useFilterMultiSelect, type Filter, type SelectedFilter, } from './useFiltersMultiSelect';
+export { useFilterMultiSelect, type Filter, type SelectedFilter, type UseFiltersMultiSelectOptions, type UseFiltersMultiSelectStore, } from './useFiltersMultiSelect';

package/dist/components/FiltersMultiSelect/useFiltersMultiSelect.d.ts

@@ -7,23 +7,55 @@ export type SelectedFilter = Omit<Filter, 'group'> & {
     type: 'include' | 'exclude' | 'group';
 };
 export interface UseFiltersMultiSelectOptions {
+    /**
+     * Controlled open state of the dropdown. When provided, the parent must
+     * update it from `onOpenChange`.
+     */
+    open?: boolean;
+    /** Initial open state of the dropdown. */
+    defaultOpen?: boolean;
+    /** Called with the state the dropdown is moving to. */
+    onOpenChange?: (open: boolean) => void;
+    /**
+     * Controlled open state of the dropdown.
+     *
+     * @deprecated Use `open` instead — `opened` is removed in the next major
+     * release.
+     */
     opened?: boolean;
+    /**
+     * Initial open state of the dropdown.
+     *
+     * @deprecated Use `defaultOpen` instead — `defaultOpened` is removed in the
+     * next major release.
+     */
     defaultOpened?: boolean;
+    /**
+     * Called with the state the dropdown is moving to.
+     *
+     * @deprecated Use `onOpenChange` instead — `onOpenedChange` is removed in the
+     * next major release.
+     */
+    onOpenedChange?: (open: boolean) => void;
     selectedFilters?: SelectedFilter[];
     defaultSelectedFilters?: SelectedFilter[];
     search?: string;
     defaultSearch?: string;
     onChange?: (value: SelectedFilter[]) => void;
-    onOpenedChange?: (opened: boolean) => void;
     onDropdownClose?: () => void;
     onDropdownOpen?: () => void;
     onSearchChange?: (search: string) => void;
 }
-export declare function useFilterMultiSelect({ opened, defaultOpened, selectedFilters, defaultSelectedFilters, search, defaultSearch, onChange, onOpenedChange, onDropdownClose, onDropdownOpen, onSearchChange, }?: UseFiltersMultiSelectOptions): {
+export declare function useFilterMultiSelect(options?: UseFiltersMultiSelectOptions): {
+    open: boolean;
+    /**
+     * @deprecated Read `open` instead — the `opened` key is removed from the
+     * store in the next major release.
+     */
     opened: boolean;
     selectedFilters: SelectedFilter[];
     search: string;
-    toggleDropdown: (open?: boolean) => void;
+    toggleDropdown: (nextOpen?: boolean) => void;
     selectFilters: (...filters: SelectedFilter[]) => void;
     unselectFilters: (...filters: SelectedFilter[]) => void;
     isSelected: (id: string) => SelectedFilter | undefined;

package/dist/components/IconButton/IconButton.d.ts

@@ -13,6 +13,7 @@ import type { IconButtonProps } from './types';
  * - Optional aria-label; defaults to raw icon name for screen readers
  * - Single styles prop: button, iconColor, icon (all overridable)
  * - Transparent or grey background variant; disabled state
+ * - `size` matching Button's scale, so the two align in a toolbar
  *
  * @category Form Controls
  * @subcategory Action
@@ -29,6 +30,12 @@ import type { IconButtonProps } from './types';
  *
  * @example
  * ```tsx
+ * // Sized to match a medium Button beside it, submitting the surrounding form
+ * <IconButton icon="check" size="medium" type="submit" aria-label="Save" />
+ * ```
+ *
+ * @example
+ * ```tsx
  * <IconButton
  *   icon="search"
  *   onClick={onSearch}
@@ -36,4 +43,4 @@ import type { IconButtonProps } from './types';
  * />
  * ```
  */
-export declare const IconButton: ({ icon, onClick, "aria-label": ariaLabel, title, disabled, transparent, styles, }: IconButtonProps) => import("@emotion/react/jsx-runtime").JSX.Element;
+export declare const IconButton: ({ icon, onClick, type, size, "aria-label": ariaLabel, title, disabled, transparent, styles, }: IconButtonProps) => import("@emotion/react/jsx-runtime").JSX.Element;

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

@@ -1,2 +1,6 @@
 import { Theme } from '@emotion/react';
-export declare const iconButton: (theme: Theme, transparent: boolean) => import("@emotion/react").SerializedStyles;
+/** Box size per `size` value; kept in step with `Button`'s height scale. */
+export declare const buttonSizes: Record<keyof MainSizes, number>;
+/** Icon size per `size` value. */
+export declare const iconSizes: Record<keyof MainSizes, number>;
+export declare const iconButton: (theme: Theme, transparent: boolean, size?: keyof MainSizes) => import("@emotion/react").SerializedStyles;

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

@@ -6,9 +6,27 @@ export type IconButtonProps = {
      */
     icon: keyof MapIconsType;
     /**
-     * Click handler
+     * Click handler. Optional — a `type="submit"` icon button inside a form
+     * needs no handler of its own.
      */
-    onClick: () => void;
+    onClick?: () => void;
+    /**
+     * HTML button type attribute
+     * - `button`: Standard button (default)
+     * - `submit`: Form submission button
+     * - `reset`: Form reset button
+     * @default 'button'
+     */
+    type?: 'button' | 'reset' | 'submit';
+    /**
+     * Size of the button and its icon. Matches `Button`'s size scale so the two
+     * line up in a toolbar.
+     * - `small`: 36px box, 20px icon (default)
+     * - `medium`: 46px box, 24px icon
+     * - `large`: 54px box, 28px icon
+     * @default 'small'
+     */
+    size?: keyof MainSizes;
     /**
      * Accessible label for screen readers. When omitted, the raw icon name is used.
      */

package/dist/components/JsonSchemaForm/utils/selectWidget.d.ts

@@ -2,8 +2,14 @@ import type { TypeaheadProps } from '../../Typeahead/types';
 /**
  * Props that need special handling (computed from RJSF state) or are RJSF-controlled
  * These are extracted explicitly and NOT spread
+ *
+ * The deprecated spellings (`selectedItems`, `isDisabled`) stay on the list
+ * alongside their replacements: a `uiSchema` written before the rename would
+ * otherwise pass its filter and land on `Typeahead` through the spread, where
+ * it would take over whenever the RJSF-computed `value` / `disabled` happened
+ * to be undefined.
  */
-export type SelectWidgetNonSpreadableProps = 'name' | 'onChange' | 'onClearAll' | 'onRemoveSelectedClick' | 'onEmptyChange' | 'selectedItems' | 'isMultiple' | 'isDisabled' | 'placeholder' | 'renderOption' | 'children';
+export type SelectWidgetNonSpreadableProps = 'name' | 'onChange' | 'onClearAll' | 'onRemoveSelectedClick' | 'onEmptyChange' | 'value' | 'selectedItems' | 'isMultiple' | 'disabled' | 'isDisabled' | 'placeholder' | 'renderOption' | 'children';
 /**
  * Props that can be automatically spread from uiOptions
  * New props added to TypeaheadProps will automatically be included here

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

@@ -1,3 +1,3 @@
 import { LabelProps } from './types';
-declare const Label: ({ children, htmlFor, className, isDisabled, onMouseEnter, onMouseLeave, }: LabelProps) => import("@emotion/react/jsx-runtime").JSX.Element;
+declare const Label: ({ children, htmlFor, className, disabled, isDisabled, onMouseEnter, onMouseLeave, }: LabelProps) => import("@emotion/react/jsx-runtime").JSX.Element;
 export default Label;

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

@@ -3,6 +3,11 @@ import { CommonProps } from '../../types/emotion';
 export interface LabelProps extends CommonProps {
     htmlFor?: string;
     children: React.ReactNode;
+    /** Renders the label in its muted, disabled state. */
+    disabled?: boolean;
+    /**
+     * @deprecated Use `disabled` instead. Removed in the next major release.
+     */
     isDisabled?: boolean;
     onMouseEnter?: MouseEventHandler<HTMLLabelElement>;
     onMouseLeave?: MouseEventHandler<HTMLLabelElement>;

package/dist/components/LargeTab/LargeTab.d.ts

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

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

@@ -1,2 +1,25 @@
 import { LinkProps } from './Link.types';
-export declare const Link: ({ children, href, ...props }: LinkProps) => import("@emotion/react/jsx-runtime").JSX.Element;
+/**
+ * Link - Styled anchor.
+ *
+ * Renders a plain `<a>` with the kit's `subtitle` typography. Accepts the
+ * standard anchor attributes (`target`, `rel`, `download`, `onClick`, …) plus
+ * `className` and the Emotion `css` prop.
+ *
+ * When `target="_blank"` is used, `rel` defaults to `noopener noreferrer` so a
+ * new tab can't reach back into the opener; pass an explicit `rel` to override.
+ *
+ * @category Navigation
+ *
+ * @example
+ * ```tsx
+ * <Link href="/settings">Settings</Link>
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // rel is filled in automatically
+ * <Link href="https://example.com" target="_blank">Docs</Link>
+ * ```
+ */
+export declare const Link: ({ children, href, target, rel, ...props }: LinkProps) => import("@emotion/react/jsx-runtime").JSX.Element;

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

@@ -1,4 +1,17 @@
-export interface LinkProps {
+import type { AnchorHTMLAttributes } from 'react';
+import type { Interpolation, Theme } from '@emotion/react';
+export interface LinkProps extends Omit<AnchorHTMLAttributes<HTMLAnchorElement>, 'href' | 'children'> {
+    /** Destination of the anchor. */
     href: string;
+    /** Link content, rendered inside a `subtitle` Typography. */
     children: React.ReactNode;
+    /**
+     * Where to open the link. When set to `_blank`, `rel` defaults to
+     * `noopener noreferrer` unless you pass your own.
+     */
+    target?: AnchorHTMLAttributes<HTMLAnchorElement>['target'];
+    /** Custom CSS class name for the anchor. */
+    className?: string;
+    /** Emotion styles applied to the anchor. */
+    css?: Interpolation<Theme>;
 }

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

@@ -1 +1,2 @@
 export { Link as default } from './Link';
+export type { LinkProps } from './Link.types';

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

@@ -1,4 +1,4 @@
-import { ModalProps } from './types';
+import { ModalRootProps } from './types';
 /**
  * Modal - Dialog overlay for focused user interaction
  *
@@ -33,16 +33,24 @@ import { ModalProps } from './types';
  * @example
  * ```tsx
  * // Controlled from parent
- * const [isOpen, setIsOpen] = useState(false);
- * <Modal isOpen={isOpen}>
+ * const [open, setOpen] = useState(false);
+ * <Modal open={open} onOpenChange={setOpen}>
  *   <ModalContent aria-label="Controlled modal">
- *     <ModalDismissButton><Button onClick={() => setIsOpen(false)}>Close</Button></ModalDismissButton>
+ *     <ModalDismissButton><Button>Close</Button></ModalDismissButton>
  *   </ModalContent>
  * </Modal>
  * ```
  *
  * @example
  * ```tsx
+ * // Uncontrolled, but observing every open/close
+ * <Modal defaultOpen onOpenChange={(open) => track('modal', open)}>
+ *   <ModalContent aria-label="Observed modal">...</ModalContent>
+ * </Modal>
+ * ```
+ *
+ * @example
+ * ```tsx
  * // Modal with portal (e.g. inside Drawer) - centers on full screen
  * <ModalContent aria-label="Modal in drawer" usePortal>
  *   ...
@@ -59,5 +67,5 @@ import { ModalProps } from './types';
  * - ESC to close (when implemented in ModalDialog)
  * - Focus management on open/close
  */
-declare const Modal: ({ isOpen, ...rest }: ModalProps) => import("@emotion/react/jsx-runtime").JSX.Element;
+declare const Modal: (props: ModalRootProps) => import("@emotion/react/jsx-runtime").JSX.Element;
 export default Modal;

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

@@ -5,14 +5,14 @@ import type { ModalDialogProps } from '../ModalDialog';
  */
 export type ModalContextProps = [boolean, (isOpen: boolean) => void];
 /**
- * Props for the Modal root and ModalContent components.
+ * Props shared by the Modal root and ModalContent.
  *
- * Modal root accepts isOpen for controlled usage; ModalContent accepts
- * ModalDialog props (aria-label, noBackground, className, children) plus usePortal.
+ * ModalContent accepts ModalDialog props (aria-label, noBackground, className,
+ * children) plus usePortal.
  *
  * @example
  * ```tsx
- * <Modal isOpen={isOpen}>
+ * <Modal open={open} onOpenChange={setOpen}>
  *   <ModalContent aria-label="Dialog" usePortal>...</ModalContent>
  * </Modal>
  * ```
@@ -21,3 +21,31 @@ export type ModalProps = Partial<ModalDialogProps> & {
     /** When true, render modal in a portal to document.body. When false (default), render in place (e.g. inside a Drawer). */
     usePortal?: boolean;
 };
+/**
+ * Props for the Modal root component.
+ *
+ * Adds the state props the root owns on top of {@link ModalProps}. Open state
+ * has three modes:
+ *
+ * - **uncontrolled** — pass nothing, or `defaultOpen` for the initial state.
+ *   ModalOpenButton / ModalDismissButton drive it.
+ * - **controlled** — pass `open` and update it from `onOpenChange`. The modal
+ *   never moves on its own.
+ * - **legacy** — pass `isOpen`. It seeds the state and re-syncs whenever it
+ *   changes, but the buttons can still move the modal out from under it. Kept
+ *   working for the deprecation window; prefer `open` + `onOpenChange`.
+ *
+ * @example
+ * ```tsx
+ * const [open, setOpen] = useState(false);
+ * <Modal open={open} onOpenChange={setOpen}>
+ *   <ModalContent aria-label="Controlled modal">...</ModalContent>
+ * </Modal>
+ * ```
+ */
+export type ModalRootProps = ModalProps & {
+    /** Initial open state for an uncontrolled modal. */
+    defaultOpen?: boolean;
+    /** Called with the state the modal is moving to, from any source. */
+    onOpenChange?: (open: boolean) => void;
+};

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

@@ -4,7 +4,7 @@ import { ModalDialogProps } from './types';
  *
  * Renders the fixed full-screen overlay and centered dialog box. Used internally
  * by ModalContent; typically not used directly. Handles visibility (display
- * based on isOpen), optional background overlay (noBackground), and dialog
+ * based on open), optional background overlay (noBackground), and dialog
  * ARIA attributes (role="dialog", aria-modal).
  *
  * @category Components
@@ -26,5 +26,5 @@ import { ModalDialogProps } from './types';
  * - aria-label for screen reader label
  * - Fixed overlay for focus containment
  */
-declare const ModalDialog: ({ isOpen, noBackground, children, "aria-label": ariaLabel, ...props }: ModalDialogProps) => import("@emotion/react/jsx-runtime").JSX.Element;
+declare const ModalDialog: ({ open, isOpen, noBackground, children, "aria-label": ariaLabel, ...props }: ModalDialogProps) => import("@emotion/react/jsx-runtime").JSX.Element;
 export default ModalDialog;

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). */