@amsintegra/design-system 1.0.0

package/dist/index.d.ts

@@ -0,0 +1,522 @@
+import * as react from 'react';
+import { PropsWithChildren, ReactNode, ForwardRefExoticComponent } from 'react';
+import { Locale } from 'antd/es/locale';
+import { ThemeConfig, ButtonProps as ButtonProps$1, TagProps as TagProps$1, PaginationProps as PaginationProps$1, SwitchProps, TableProps, ModalProps, SelectProps, UploadProps } from 'antd';
+export { Affix, AffixProps, Alert, AlertProps, Anchor, AnchorProps, AutoComplete, AutoCompleteProps, Avatar, AvatarProps, BackTop, BackTopProps, Badge, BadgeProps, Breadcrumb, BreadcrumbProps, Calendar, Card, CardProps, Carousel, CarouselProps, Cascader, CascaderProps, Checkbox, CheckboxProps, Col, ColProps, Collapse, CollapseProps, ColorPicker, ColorPickerProps, DatePicker, DatePickerProps, Descriptions, DescriptionsProps, Divider, DividerProps, Drawer, DrawerProps, Dropdown, DropdownProps, Empty, EmptyProps, Flex, FlexProps, FloatButton, FloatButtonProps, Form, FormInstance, FormItemProps, FormListFieldData, FormListOperation, FormProps, FormRule, Image, ImageProps, Input, InputNumber, InputNumberProps, Layout, LayoutProps, List, ListProps, MentionProps, Mentions, Menu, MenuProps, MessageArgsProps, Modal, ModalFuncProps, ModalProps, NotificationArgsProps, Popconfirm, PopconfirmProps, Popover, PopoverProps, Progress, ProgressProps, QRCode, QRCodeProps, Radio, RadioProps, Rate, RateProps, Result, ResultProps, Row, RowProps, Segmented, SegmentedProps, Select, SelectProps, Skeleton, SkeletonProps, Slider, SliderSingleProps, Space, SpaceProps, Spin, SpinProps, Splitter, SplitterProps, Statistic, StatisticProps, Steps, StepsProps, Switch, SwitchProps, Table, TableColumnType, TableColumnsType, TableProps, Tabs, TabsProps, TimePicker, TimePickerProps, Timeline, TimelineProps, Tooltip, TooltipProps, Tour, TourProps, Transfer, Tree, TreeSelect, TreeSelectProps, Typography, Upload, Watermark, WatermarkProps } from 'antd';
+export { TitleProps } from 'antd/es/typography/Title';
+export { TextProps } from 'antd/es/typography/Text';
+export { ParagraphProps } from 'antd/es/typography/Paragraph';
+export { LinkProps } from 'antd/es/typography/Link';
+import { AntdIconProps } from '@ant-design/icons/lib/components/AntdIcon';
+export { GroupProps as InputGroupProps, InputProps, InputRef, PasswordProps, SearchProps, TextAreaProps } from 'antd/es/input';
+export { DraggerProps, RcFile, UploadChangeParam, UploadFile, UploadListProps, UploadProps } from 'antd/es/upload';
+import { MessageInstance } from 'antd/es/message/interface';
+export { MessageInstance } from 'antd/es/message/interface';
+import { NotificationInstance } from 'antd/es/notification/interface';
+export { NotificationInstance } from 'antd/es/notification/interface';
+export { CheckCircleOutlined, CheckOutlined, CloseCircleOutlined, CloseOutlined, DeleteOutlined, DownOutlined, DownloadOutlined, EditOutlined, ExclamationCircleOutlined, EyeInvisibleOutlined, EyeOutlined, FileExcelOutlined, FileOutlined, FilePdfOutlined, FilterOutlined, FolderOutlined, InfoCircleOutlined, LeftOutlined, LoadingOutlined, LogoutOutlined, MenuOutlined, PlusOutlined, ReloadOutlined, RightOutlined, SearchOutlined, SettingOutlined, UpOutlined, UploadOutlined, UserOutlined, WarningOutlined } from '@ant-design/icons';
+
+/**
+ * Design tokens — the single source of truth for the AMS Design System.
+ *
+ * Values are taken from the B2BMX Metronic theme:
+ *   b2bmx-web-metronic/src/_metronic/assets/sass/components/_variables.custom.scss
+ *   b2bmx-web-metronic/tailwind.config.js
+ *
+ * Two tiers:
+ *   - `primitives`: raw values, no semantic meaning.
+ *   - `semantic`:  role aliases consumed by the antd theme (and Tailwind).
+ */
+/** Raw Metronic brand values. */
+declare const primitives: {
+    readonly brandRed: "#A72432";
+    readonly brandRedActive: "#8B1D28";
+    readonly brandRedLight: "#f1faff";
+    readonly green: "#50cd89";
+    readonly greenActive: "#47be7d";
+    readonly greenLight: "#e8fff3";
+    readonly purple: "#7239ea";
+    readonly purpleActive: "#5014d0";
+    readonly purpleLight: "#f8f5ff";
+    readonly pink: "#f1416c";
+    readonly pinkActive: "#d9214e";
+    readonly pinkLight: "#fff5f8";
+    readonly yellow: "#ffc700";
+    readonly yellowActive: "#f1bc00";
+    readonly yellowLight: "#fff8dd";
+    readonly white: "#ffffff";
+    readonly gray: {
+        readonly 100: "#f9f9f9";
+        readonly 200: "#f4f4f4";
+        readonly 300: "#e1e3ea";
+        readonly 400: "#b5b5c3";
+        readonly 500: "#a1a5b7";
+        readonly 600: "#7e8299";
+        readonly 700: "#5e6278";
+        readonly 800: "#3f4254";
+        readonly 900: "#181c32";
+    };
+    readonly background: {
+        readonly app: "#f5f8fa";
+        readonly body: "#ffffff";
+        readonly appDark: "#151521";
+        readonly bodyDark: "#1e1e2d";
+    };
+    readonly dark: {
+        readonly base: "#181c32";
+        readonly bg: "#151521";
+        readonly header: "#1e1e2d";
+        readonly active: "#2a2a3c";
+        readonly separator: "#393945";
+        readonly inputBg: "#1b1b29";
+        readonly cardBg: "#1e1e2d";
+        readonly gray: {
+            readonly 100: "#2b2b40";
+            readonly 200: "#323248";
+            readonly 300: "#3b3b64";
+            readonly 400: "#474761";
+            readonly 500: "#565674";
+            readonly 600: "#6d6d80";
+            readonly 700: "#92929f";
+            readonly 800: "#cdcdde";
+        };
+    };
+};
+/** Radius scale (Metronic). Base radius is 4px. */
+declare const radius: {
+    readonly sm: 2;
+    readonly base: 4;
+    readonly md: 6;
+    readonly lg: 8;
+    readonly xl: 12;
+};
+/** Typography (Metronic uses Inter with a compact 13px base). */
+declare const typography: {
+    readonly fontFamily: "Inter, Helvetica, Arial, sans-serif";
+    readonly fontSizeBase: 13;
+    readonly weight: {
+        readonly light: 300;
+        readonly normal: 400;
+        readonly medium: 500;
+        readonly semibold: 600;
+        readonly bold: 700;
+    };
+};
+/** Control sizing (Metronic). */
+declare const sizing: {
+    readonly controlHeight: 32;
+    readonly buttonMinWidth: 110;
+};
+/**
+ * Semantic tokens — role aliases. These feed the antd `ThemeConfig`.
+ * Components must consume semantic tokens, never primitives directly.
+ */
+declare const semantic: {
+    readonly colorPrimary: "#A72432";
+    readonly colorPrimaryActive: "#8B1D28";
+    readonly colorSuccess: "#50cd89";
+    readonly colorInfo: "#7239ea";
+    readonly colorError: "#f1416c";
+    readonly colorWarning: "#ffc700";
+    readonly colorLink: "#3f4254";
+    readonly colorLinkHover: "#A72432";
+    readonly colorLinkActive: "#8B1D28";
+    readonly colorBgLayout: "#f5f8fa";
+    readonly colorBgContainer: "#ffffff";
+    readonly borderRadius: 4;
+    readonly fontFamily: "Inter, Helvetica, Arial, sans-serif";
+    readonly fontSize: 13;
+    readonly controlHeight: 32;
+};
+type ThemeMode = 'light' | 'dark';
+
+interface AmsConfigProviderProps {
+    /**
+     * Controlled color mode. When provided, the provider does not manage or
+     * persist the mode. Omit it to let the provider manage the mode itself
+     * (persisted to localStorage, respects OS preference) — read/toggle it with
+     * the `useThemeMode` hook.
+     */
+    mode?: ThemeMode;
+    /** Initial mode when self-managed (uncontrolled). Defaults to `light`. */
+    defaultMode?: ThemeMode;
+    /** Persist the self-managed mode to localStorage. Defaults to `true`. */
+    persistMode?: boolean;
+    /**
+     * antd locale (e.g. `esES`, `enUS`). The consuming app passes it;
+     * the design system stays i18n-agnostic and ships no message catalog.
+     */
+    locale?: Locale;
+    /**
+     * Theme overrides merged on top of the AMS theme. Use it to customize tokens
+     * per project without forking the DS, e.g. `{ token: { colorLink: '#1677ff' } }`.
+     */
+    theme?: ThemeConfig;
+    children?: ReactNode;
+}
+/**
+ * Root provider for the AMS Design System.
+ *
+ * - Applies the AMS theme (light/dark) via antd's `ConfigProvider`.
+ * - Renders antd's `App` for context-safe `message`/`notification`/`Modal`.
+ * - Manages the color mode (controlled via `mode`, or self-managed with
+ *   localStorage persistence and OS-preference detection) and exposes it
+ *   through the `useThemeMode` hook.
+ * - Accepts a `theme` override merged on top of the AMS theme.
+ *
+ * Render it once at the app root.
+ */
+declare function AmsConfigProvider({ mode, defaultMode, persistMode, locale, theme, children, }: PropsWithChildren<AmsConfigProviderProps>): react.JSX.Element;
+
+/**
+ * Builds the antd theme for a given mode. Dark mode uses antd's
+ * `darkAlgorithm`; brand tokens stay identical so the brand is consistent.
+ */
+declare function buildTheme(mode?: ThemeMode): ThemeConfig;
+/** Default (light) AMS theme. */
+declare const amsTheme: ThemeConfig;
+/** Dark AMS theme. */
+declare const amsThemeDark: ThemeConfig;
+
+/** Reads the initial mode: saved preference → OS preference → light. */
+declare function getInitialThemeMode(defaultMode?: ThemeMode): ThemeMode;
+/** Reflects the mode on the DOM so CSS can react (mirrors mf-container). */
+declare function applyThemeModeToDOM(mode: ThemeMode): void;
+interface ThemeModeContextValue {
+    mode: ThemeMode;
+    setMode: (mode: ThemeMode) => void;
+    toggle: () => void;
+    isDark: boolean;
+}
+/**
+ * Access the current color mode and switch it. Requires an ancestor
+ * `AmsConfigProvider`. Use it to build a light/dark toggle:
+ *
+ *   const { isDark, toggle } = useThemeMode();
+ *   <Switch checked={isDark} onChange={toggle} />
+ */
+declare function useThemeMode(): ThemeModeContextValue;
+
+interface ButtonProps extends ButtonProps$1 {
+}
+/**
+ * AMS Button — thin wrapper over antd `Button` that inherits the AMS theme.
+ * Exposes the full antd Button API (type, danger, loading, icon, size, etc.)
+ * and forwards the ref so it integrates with Form and tooltips.
+ */
+declare const Button: react.ForwardRefExoticComponent<ButtonProps & react.RefAttributes<HTMLButtonElement | HTMLAnchorElement>>;
+
+/** AMS semantic tag intents mapped to brand tokens. */
+type TagIntent = 'success' | 'error' | 'warning' | 'info' | 'primary';
+interface TagProps extends TagProps$1 {
+    /**
+     * Semantic intent that resolves to an AMS brand color. Takes precedence over
+     * antd's `color` when set. Formalizes the inline `#50cd89` / `#f1416c` colors
+     * previously hardcoded in mf-boveda's DataTable.
+     */
+    intent?: TagIntent;
+}
+/**
+ * AMS Tag — thin wrapper over antd `Tag` with an optional semantic `intent`
+ * that maps to the brand palette. Falls back to the full antd Tag API.
+ */
+declare const Tag: react.ForwardRefExoticComponent<TagProps & react.RefAttributes<HTMLSpanElement>>;
+
+/**
+ * Icons — curated re-export from `@ant-design/icons`.
+ *
+ * Usage:
+ *   import { DownloadOutlined, SearchOutlined } from '@amsintegra/design-system';
+ *   <Button icon={<DownloadOutlined />} />
+ *
+ * This module re-exports a curated set of the most-used icons across the b2bmx
+ * microfrontends so consumers get autocomplete from the design system barrel.
+ * For any icon not listed here, import it directly from `@ant-design/icons`
+ * (it stays a peer dependency and is not bundled).
+ *
+ * `IconComponent` is the shared type for an antd icon component, useful for
+ * typing icon props on other components.
+ */
+
+type IconComponent = ForwardRefExoticComponent<Omit<AntdIconProps, 'ref'>>;
+
+/**
+ * Context-safe access to antd's `message` API.
+ *
+ * In antd v5 the static `message.success(...)` calls do **not** read the
+ * `ConfigProvider` theme and log a warning. The supported approach is to
+ * consume the instance provided by antd's `App` context — which
+ * `AmsConfigProvider` already renders at the root.
+ *
+ * Usage:
+ *   const message = useAmsMessage();
+ *   message.success('Saved');
+ *
+ * Requires an ancestor `AmsConfigProvider` (or antd `App`).
+ */
+declare function useAmsMessage(): MessageInstance;
+
+/**
+ * Context-safe access to antd's `notification` API.
+ *
+ * Like `useAmsMessage`, this returns the instance from antd's `App` context so
+ * notifications inherit the AMS theme and avoid the v5 static-method warning.
+ * Requires an ancestor `AmsConfigProvider` (or antd `App`).
+ *
+ * Usage:
+ *   const notification = useAmsNotification();
+ *   notification.success({ message: 'Done', description: 'Saved.' });
+ */
+declare function useAmsNotification(): NotificationInstance;
+
+/**
+ * Translatable text labels for the pagination control. The design system is
+ * i18n-agnostic: the consuming app passes already-translated strings. Anything
+ * omitted falls back to antd's `locale` (or English defaults).
+ */
+interface PaginationLabels {
+    /** Suffix in the page-size selector, e.g. "/ página". */
+    itemsPerPage?: string;
+    /** "Ir a" label of the quick jumper. */
+    jumpTo?: string;
+    /** Confirm button text of the quick jumper. */
+    jumpToConfirm?: string;
+    /** Accessible label for a page, e.g. "Página". */
+    page?: string;
+    /** Accessible label for the previous-page button. */
+    prevPage?: string;
+    /** Accessible label for the next-page button. */
+    nextPage?: string;
+    /** Label for the page-size selector, e.g. "Tamaño de página". */
+    pageSize?: string;
+    /**
+     * Builds the total-records text (rendered before the pages).
+     * Receives the total and the current [from, to] range.
+     * e.g. (total) => `Total ${total} registros`. Takes precedence over `totalText`.
+     */
+    total?: (total: number, range: [number, number]) => ReactNode;
+    /**
+     * Declarative total text as separate translated words, matching how the
+     * mf-boveda table builds it: `{prefix} {total} {suffix}` → "Total 250 registros".
+     * Set `showRange` to render "{prefix} {from}-{to} {suffix}" instead.
+     * Ignored when `total` (the function form) is provided.
+     */
+    totalText?: {
+        /** Word(s) before the number, e.g. "Total". */
+        prefix?: string;
+        /** Word(s) after the number, e.g. "registros". */
+        suffix?: string;
+        /** Use the "from-to" range instead of just the total. Default false. */
+        showRange?: boolean;
+    };
+    /** Visible text for the "previous" button (overrides the arrow). */
+    previousText?: ReactNode;
+    /** Visible text for the "next" button (overrides the arrow). */
+    nextText?: ReactNode;
+}
+interface PaginationProps extends PaginationProps$1 {
+    /** Translatable text labels. */
+    labels?: PaginationLabels;
+}
+/**
+ * AMS Pagination — antd `Pagination` with translatable text via a single
+ * `labels` prop (page, records/total, previous/next, items-per-page, jumper).
+ * The rest of the antd Pagination API passes through. `showTotal` and
+ * `itemRender` still work if you prefer to set them directly; explicit
+ * `showTotal`/`itemRender`/`locale` props win over `labels`.
+ */
+declare function Pagination({ labels, showTotal, itemRender, locale, ...rest }: PaginationProps): react.JSX.Element;
+
+interface ThemeToggleProps extends Omit<SwitchProps, 'checked' | 'onChange'> {
+}
+/**
+ * AMS ThemeToggle — a ready-made light/dark switch wired to `useThemeMode`.
+ * Requires an ancestor `AmsConfigProvider` that manages the mode
+ * (i.e. rendered without a controlled `mode` prop).
+ */
+declare function ThemeToggle(props: ThemeToggleProps): react.JSX.Element;
+
+/**
+ * Labels for the DataTable. The design system is i18n-agnostic: the consuming
+ * microfrontend passes translated strings from its own catalog. Sensible
+ * English defaults are provided so the table renders without wiring.
+ */
+interface DataTableLabels {
+    emptyText?: string;
+    sortAsc?: string;
+    sortDesc?: string;
+    cancelSort?: string;
+}
+interface DataTableProps<T extends object = Record<string, unknown>> extends Omit<TableProps<T>, 'title' | 'loading'> {
+    /** Optional plain-text heading rendered above the table. */
+    heading?: string;
+    /** Extra content (buttons, filters) rendered above the table. */
+    extra?: React.ReactNode;
+    /** External loading state. Renders a skeleton placeholder while true. */
+    loading?: boolean;
+    /** Translated labels; falls back to English defaults. */
+    labels?: DataTableLabels;
+    /**
+     * Translatable pagination text (total/records, previous/next, page-size,
+     * jumper). Applied to the table's pagination — matches the mf-boveda pattern
+     * of a "{prefix} {total} {suffix}" total and translated prev/next buttons.
+     * Merged into `pagination`; anything set directly on `pagination`
+     * (`showTotal`/`itemRender`/`locale`) wins.
+     */
+    paginationLabels?: PaginationLabels;
+    /**
+     * Opt-in: render numeric values in the first column as colored tags
+     * (green when >= 0, red when < 0). Off by default — this replaces the
+     * implicit column-0 behavior of the original mf-boveda DataTable, which
+     * was surprising. Explicitly enable it per table when desired.
+     */
+    firstColumnNumericTag?: boolean;
+}
+declare function DataTable<T extends object = Record<string, unknown>>({ heading, extra, loading, labels, paginationLabels, firstColumnNumericTag, columns, dataSource, scroll, bordered, pagination, className, ...rest }: DataTableProps<T>): react.JSX.Element;
+
+type TriggerRenderer = (open: () => void) => ReactNode;
+interface ModalDialogProps extends Omit<ModalProps, 'open' | 'children'> {
+    /** Controlled open state. */
+    open?: boolean;
+    /** Initial open state in uncontrolled mode. */
+    defaultOpen?: boolean;
+    /** Node or render-prop that opens the modal when clicked. */
+    trigger?: ReactNode | TriggerRenderer;
+    /** Close automatically after `onOk` resolves. Default true. */
+    closeOnOk?: boolean;
+    /** Close automatically after `onCancel`. Default true. */
+    closeOnCancel?: boolean;
+    /** Notified whenever the open state changes (controlled or not). */
+    onOpenChange?: (next: boolean) => void;
+    children?: ReactNode;
+}
+/**
+ * AMS ModalDialog — a controllable modal composite.
+ *
+ * Ports mf-boveda's ReusableModal API:
+ *  - controlled (`open`) or uncontrolled (`defaultOpen`) state,
+ *  - a `trigger` node or render-prop that opens it,
+ *  - `closeOnOk` / `closeOnCancel` with async `onOk` support (waits for the
+ *    returned promise before closing).
+ *
+ * All other antd Modal props pass through.
+ */
+declare function ModalDialog({ trigger, children, open, defaultOpen, closeOnOk, closeOnCancel, onOk, onCancel, onOpenChange, ...modalProps }: ModalDialogProps): react.JSX.Element;
+
+interface FilterOption {
+    value: string;
+    label: ReactNode;
+    disabled?: boolean;
+}
+interface FilterSelectProps extends Omit<SelectProps<string>, 'options' | 'filterOption'> {
+    options: FilterOption[];
+    /** Enable client-side search with accent-insensitive matching. */
+    showSearch?: boolean;
+    /** Override the default accent-insensitive filter. */
+    filterOption?: SelectProps<string>['filterOption'];
+}
+/**
+ * AMS FilterSelect — a Select preset for dashboard filters.
+ *
+ * Ports mf-boveda's FilterSelect: accent-insensitive search over both the
+ * option label and value, full-width by default. i18n is the consumer's
+ * responsibility (pass already-translated labels).
+ */
+declare function FilterSelect({ options, showSearch, filterOption, className, style, ...rest }: FilterSelectProps): react.JSX.Element;
+
+type UploadMessage = string | ((fileName: string) => string);
+type UploadChangeInfo = Parameters<NonNullable<UploadProps['onChange']>>[0];
+interface FileUploadDraggerProps extends Omit<UploadProps, 'onChange'> {
+    /** Success toast text or a builder receiving the file name. */
+    successMessage?: UploadMessage;
+    /** Error toast text or a builder receiving the file name. */
+    errorMessage?: UploadMessage;
+    /** Show success/error toasts on upload status changes. Default true. */
+    showStatusMessages?: boolean;
+    /** Prompt text shown inside the drop area (when no children given). */
+    hintText?: ReactNode;
+    onUploadSuccess?: (info: UploadChangeInfo) => void;
+    onUploadError?: (info: UploadChangeInfo) => void;
+    onChange?: UploadProps['onChange'];
+    children?: ReactNode;
+}
+/**
+ * AMS FileUploadDragger — drag-and-drop uploader.
+ *
+ * Ports mf-boveda's FileUploadDragger with two DS improvements:
+ *  - toasts use the context-safe `useAmsMessage()` (no antd v5 static warning),
+ *  - all copy is passed via props (i18n stays in the consumer); no default
+ *    upload endpoint is baked in.
+ */
+declare function FileUploadDragger({ successMessage, errorMessage, showStatusMessages, hintText, onUploadSuccess, onUploadError, onChange: externalOnChange, children, ...uploadProps }: FileUploadDraggerProps): react.JSX.Element;
+
+interface BreadcrumbItem {
+    title: ReactNode;
+    href?: string;
+}
+interface PageHeaderProps {
+    /** Page title. Rendered as an h1. */
+    title: ReactNode;
+    /** Breadcrumb trail. When omitted, no breadcrumb is shown. */
+    breadcrumbs?: BreadcrumbItem[];
+    /** Breadcrumb separator. Defaults to ">". */
+    separator?: ReactNode;
+    /** Uppercase the title (matches the b2bmx convention). Default true. */
+    uppercaseTitle?: boolean;
+    /** Content aligned to the right of the title (actions). */
+    extra?: ReactNode;
+    className?: string;
+}
+/**
+ * AMS PageHeader — page title with an optional breadcrumb.
+ *
+ * Consolidates mf-boveda's Header + Breadcrums. Decoupled from react-router
+ * and the boveda domain: the consumer builds the breadcrumb items (already
+ * translated) and passes them in.
+ */
+declare function PageHeader({ title, breadcrumbs, separator, uppercaseTitle, extra, className, }: PageHeaderProps): react.JSX.Element;
+
+interface DownloadButtonProps extends ButtonProps {
+    /** Button label. Defaults to "CSV". */
+    label?: React.ReactNode;
+}
+/**
+ * AMS DownloadButton — a Button preset for download actions.
+ *
+ * Ports mf-boveda's DownloadButton: primary type + download icon + label,
+ * with the full Button API available. i18n via the `label`/`children` props.
+ */
+declare const DownloadButton: react.ForwardRefExoticComponent<DownloadButtonProps & react.RefAttributes<HTMLButtonElement | HTMLAnchorElement>>;
+
+interface ConfirmModalProps extends Omit<ModalDialogProps, 'children'> {
+    /** Body message shown to the user. */
+    message?: ReactNode;
+    /** Mark the confirm action as destructive (red primary button). */
+    danger?: boolean;
+    children?: ReactNode;
+}
+/**
+ * AMS ConfirmModal — a confirm/cancel dialog preset built on `ModalDialog`.
+ *
+ * Generalizes the mf-boveda cancel/confirm modals (CancelCfdiModal, etc.):
+ * inherits controlled/uncontrolled state, trigger, and async `onOk` from
+ * ModalDialog. Set `danger` for destructive actions. Copy via props (i18n).
+ */
+declare function ConfirmModal({ message, danger, okButtonProps, children, ...rest }: ConfirmModalProps): react.JSX.Element;
+
+interface UseControllableStateOptions<T> {
+    /** Controlled value. When defined, the hook is in controlled mode. */
+    value?: T;
+    /** Initial value for uncontrolled mode. */
+    defaultValue: T;
+    /** Called on every change (both modes). */
+    onChange?: (next: T) => void;
+}
+/**
+ * Supports the controlled/uncontrolled pattern used across the design system
+ * (mirrors mf-boveda's ReusableModal state handling). When `value` is provided
+ * the component is controlled; otherwise internal state is used.
+ */
+declare function useControllableState<T>({ value, defaultValue, onChange, }: UseControllableStateOptions<T>): [T, (next: T) => void];
+
+export { AmsConfigProvider, type AmsConfigProviderProps, type BreadcrumbItem, Button, type ButtonProps, ConfirmModal, type ConfirmModalProps, DataTable, type DataTableLabels, type DataTableProps, DownloadButton, type DownloadButtonProps, FileUploadDragger, type FileUploadDraggerProps, type FilterOption, FilterSelect, type FilterSelectProps, type IconComponent, ModalDialog, type ModalDialogProps, PageHeader, type PageHeaderProps, Pagination, type PaginationLabels, type PaginationProps, Tag, type TagIntent, type TagProps, type ThemeMode, type ThemeModeContextValue, ThemeToggle, type ThemeToggleProps, type UseControllableStateOptions, amsTheme, amsThemeDark, applyThemeModeToDOM, buildTheme, getInitialThemeMode, primitives, radius, semantic, sizing, typography, useAmsMessage, useAmsNotification, useControllableState, useThemeMode };