@facto-to/design-system 0.1.0-beta.4 → 0.1.0-beta.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/AI.md CHANGED
@@ -13,7 +13,7 @@ All paths below are relative to this installed package directory:
13
13
  5. For fonts/themes, read [integration.md](dist/ai/references/integration.md), [design.md](dist/ai/references/design.md) and only the relevant properties in [tokens.css](dist/tokens.css).
14
14
  6. For composed workflows, read [composition.md](dist/ai/references/composition.md) for state ownership, async guards, layered overlays, focus and Undo behavior. Adapt the [mock recipe](dist/ai/assets/AdoptionDemo.tsx) and [scoped CSS](dist/ai/assets/adoption.css) where useful. Never replace live business data/handlers with mock example state.
15
15
 
16
- Visual baseline: Facto UI Standard rules v1.2, document revision v1.2.5. Read the bundled design.md for the updated button, focus, modal, switch and responsive recipes; old Dashboard snapshots do not override them.
16
+ Visual baseline: Facto UI Standard rules v1.2, document revision v1.2.21. Read the bundled design.md for the updated button, focus, modal, switch and responsive recipes; old Dashboard snapshots do not override them.
17
17
 
18
18
  Quick constraints: React/React DOM 19; styles.css includes tokens; fonts.css registers Inter and must be imported to load it. Legacy HTML is not automatically restyled. SearchField uses native onChange; EnhancedSearchField and Select use onValueChange; Button defaults to type="button"; Toast is composed of provider/root/viewport, not toast.success(). There is no exported data table, chart, date picker or router.
19
19
 
package/README.md CHANGED
@@ -10,11 +10,11 @@ Repository access is controlled separately from the public npm package; installi
10
10
 
11
11
  Coding assistants: start with [AI.md](./AI.md). This package includes the version-matched [Facto UI Skill](./dist/ai/SKILL.md), component catalog, declarations, tokens and tested mock recipe. Use it to create UI or migrate components/styles across existing frontend repositories while preserving business behavior. No MCP, GitHub access or separately downloaded documentation is required after npm installation. The skill can also be installed into Codex or Claude Code; see AI.md.
12
12
 
13
- ## Visual revision: 0.1.0-beta.4
13
+ ## Visual revision: 0.1.0-beta.6
14
14
 
15
- Adopts Facto UI Standard rules v1.2 / document revision v1.2.5. This is a visual migration: existing callbacks, controlled/uncontrolled state, validation and Radix overlay behavior are retained. The payment/connection SDK is unaffected.
15
+ Adopts Facto UI Standard rules v1.2 / document revision v1.2.21. This is a visual migration: existing callbacks, controlled/uncontrolled state, validation and Radix overlay behavior are retained. The payment/connection SDK is unaffected.
16
16
 
17
- Defaults now use pill buttons, dark single-layer field focus, 44px targets, quieter 16px cards, semantic feedback colors and 20px modal padding. DialogContent now defaults to `size="sm"` (maximum 400px); explicit `size="md"` is the 580px wide legacy variant. Review consumers that override dimensions or depend on the old visual defaults. Use shared `Icon`, `ModalHeader` and `ModalFooter` for consistent overlay composition. See the bundled [visual contract](./dist/ai/references/design.md) for exact recipes and acceptance guidance.
17
+ beta.5 updates top-right responsive Toast placement, 32px modal headers, overflowing-title keyboard access, mobile overlay entrance/reduced motion, and Select popper spacing. Earlier defaults continue to use pill buttons, dark single-layer field focus, 44px targets, quieter 16px cards, semantic feedback colors and 20px modal padding. DialogContent now defaults to `size="sm"` (maximum 400px); explicit `size="md"` is the 580px wide legacy variant. Review consumers that override dimensions or depend on the old visual defaults. Use shared `Icon`, `ModalHeader` and `ModalFooter` for consistent overlay composition. See the bundled [visual contract](./dist/ai/references/design.md) for exact recipes and acceptance guidance.
18
18
 
19
19
  ## Requirements
20
20
 
@@ -27,13 +27,13 @@ Defaults now use pill buttons, dark single-layer field focus, 44px targets, quie
27
27
  Install the beta (requires React 19):
28
28
 
29
29
  ```sh
30
- npm install @facto-to/design-system@0.1.0-beta.4 react@^19 react-dom@^19
30
+ npm install @facto-to/design-system@0.1.0-beta.6 react@^19 react-dom@^19
31
31
  ```
32
32
 
33
33
  For local development, you can also install a generated archive:
34
34
 
35
35
  ```sh
36
- npm install /path/to/facto-to-design-system-0.1.0-beta.4.tgz
36
+ npm install /path/to/facto-to-design-system-0.1.0-beta.6.tgz
37
37
  ```
38
38
 
39
39
  ## Usage
@@ -146,7 +146,7 @@ Both examples assume the named components are imported from `@facto-to/design-sy
146
146
 
147
147
  ## Source fidelity and library extensions
148
148
 
149
- - Toast uses the v1.2 feedback recipe: semantic status colors, 12px radius, 12px × 16px padding and 14/20 copy. Existing 2600ms duration and bottom-center placement remain unchanged; desktop offset is 24px, mobile 16px.
149
+ - Toast uses the v1.2 feedback recipe: semantic status colors, 12px radius, 12px × 16px padding and 14/20 copy. Duration remains 2600ms. Placement is now top-right: desktop top/right 24px, maximum width 420px; mobile top 16px and full available width with 16px side gutters and safe-area insets.
150
150
  - The source notification API displays one entry at a time. This library retains composable Radix roots instead of exporting the source's global `toast.success()` store. Optional close/action buttons, multiple notifications, swipe, and pause behavior are extensions. Use `ToastAction` for a dedicated accessible action; the default toast surface is not a click target.
151
151
  - Tooltip defaults follow the shared compact dark tooltip, without an arrow. `variant="content"` follows the white merchant-detail tooltip override. Provider delay defaults to 300ms. The source's utility-based entrance/exit animations are not reproduced.
152
152
  - SearchField uses the shared 44px minimum-height neutral input recipe and native events. EnhancedSearchField is an optional richer control, not a source-exact Dashboard widget.
@@ -156,3 +156,41 @@ Both examples assume the named components are imported from `@facto-to/design-sy
156
156
  ## License
157
157
 
158
158
  Copyright 2026 Facto. Component code is licensed under Apache-2.0; see [LICENSE](./LICENSE). Bundled Inter fonts remain under SIL OFL 1.1 in `dist/fonts/OFL.txt`.
159
+
160
+ ### Overlay motion (beta.6)
161
+
162
+ `DialogContent` 与 `SheetContent` 支持 `motionVariant="auto" | "bottom" | "none"`。默认 `auto` 保持现有行为:移动端 ≤700px 上滑入场,桌面静态。`bottom` 在所有宽度开启 Dashboard 风格的 28px 上移淡入和反向退场(240ms),`none` 关闭表面与遮罩动画。系统减少动态效果偏好始终优先。
163
+
164
+ ```tsx
165
+ <Dialog open={open} onOpenChange={setOpen}>
166
+ <DialogContent motionVariant="bottom">
167
+ <DialogTitle>Disconnect account?</DialogTitle>
168
+ <DialogDescription>You can reconnect later.</DialogDescription>
169
+ <DialogClose asChild><Button>Cancel</Button></DialogClose>
170
+ </DialogContent>
171
+ </Dialog>
172
+ ```
173
+
174
+ 保持 Root/Content 挂载,通过 `open` 控制开关以保留退场动画;直接卸载整个组件会跳过退场。`SheetContent side` 决定位置,`motionVariant` 独立决定动效。可通过 `--facto-motion-overlay-bottom-duration`、`--facto-motion-overlay-bottom-distance` 调整节奏和距离。
175
+
176
+ ### Public UI additions (beta.6)
177
+
178
+ - `Button` supports `leadingIcon`, `trailingIcon` and width-preserving `loading`. Use `IconButton` for back/close/add controls; its hit area and visual glyph are separate.
179
+ - `Field` provides inset-label input chrome with leading/trailing slots. `TextField`, `Textarea` and `EnhancedSearchField` remain available for standard labelled fields.
180
+ - `OtpInput` is a controlled native input displayed as code cells. It supports paste/autofill, delayed completion, error and pending presentation. `ResendCodeButton` accepts an application-owned deadline; it never sends a request or imposes a backend rate limit.
181
+ - `NotificationsProvider` / `useToast` provide scoped success/error/warning/info/loading notifications, same-id updates, dismissal and promise transitions. Loading stays visible until resolved or dismissed. Errors from `toast.promise` are rethrown to the caller. No process-global notification store is required.
182
+ - `Popover` and `DropdownMenu` provide portal positioning, keyboard dismissal and focus restoration. Use Tooltip only for supplementary non-interactive text.
183
+ - `FilterChip` is a controlled filter toggle; `ListSkeleton` presents loading rows without owning fetching.
184
+ - `ListGroup` / `ListRow` provide aligned leading, title, description, value, status and trailing slots. Rows are static by default, links with `href`, buttons with `onClick`. Do not nest interactive controls inside an interactive row.
185
+ - `Avatar` / `LogoStack` provide generic image fallbacks; `ErrorState`, `LoadingMore` and `StepChecklist` provide presentation without request, routing or business rules.
186
+
187
+ ```tsx
188
+ function SaveAction() {
189
+ const toast = useToast()
190
+ return <Button onClick={() => toast.success('Saved', { id: 'save' })}>Save</Button>
191
+ }
192
+ // Keep the provider mounted around consumers and within FactoTheme when themed.
193
+ <NotificationsProvider><SaveAction /></NotificationsProvider>
194
+ ```
195
+
196
+ Desktop notifications appear at the top right; mobile notifications use the available width with at least 16px side gutters and safe-area handling. Select options use full-row selected/hover backgrounds. Public behavior is demonstrated in Storybook and exercised at 375px and 1280px.
@@ -1,109 +1,292 @@
1
+ import * as react from 'react';
2
+ import { ImgHTMLAttributes, ReactNode, HTMLAttributes, MouseEventHandler, AnchorHTMLAttributes, ButtonHTMLAttributes, InputHTMLAttributes, ComponentPropsWithoutRef, ComponentPropsWithRef, CSSProperties, SVGProps, TextareaHTMLAttributes } from 'react';
3
+ import * as PopoverPrimitive from '@radix-ui/react-popover';
4
+ import * as MenuPrimitive from '@radix-ui/react-dropdown-menu';
1
5
  import * as TooltipPrimitive from '@radix-ui/react-tooltip';
2
6
  import * as ToastPrimitive from '@radix-ui/react-toast';
3
7
  import * as CheckboxPrimitive from '@radix-ui/react-checkbox';
4
8
  import * as DialogPrimitive from '@radix-ui/react-dialog';
5
9
  import * as SwitchPrimitive from '@radix-ui/react-switch';
6
10
  import * as TabsPrimitive from '@radix-ui/react-tabs';
7
- import type { AnchorHTMLAttributes, ButtonHTMLAttributes, ComponentPropsWithoutRef, ComponentPropsWithRef, CSSProperties, HTMLAttributes, InputHTMLAttributes, ReactNode, TextareaHTMLAttributes, SVGProps } from 'react';
8
- import './styles.css';
9
- export type FactoThemeTokens = Partial<Record<`--facto-${string}`, string | number>>;
11
+
12
+ interface ListRowSlots {
13
+ leading?: ReactNode;
14
+ title: ReactNode;
15
+ description?: ReactNode;
16
+ value?: ReactNode;
17
+ status?: ReactNode;
18
+ trailing?: ReactNode;
19
+ }
20
+ type ListRowSharedProps = ListRowSlots & {
21
+ className?: string;
22
+ };
23
+ type ListRowStaticProps = ListRowSharedProps & Omit<HTMLAttributes<HTMLDivElement>, 'title'>;
24
+ type ListRowLinkProps = ListRowSharedProps & Omit<AnchorHTMLAttributes<HTMLAnchorElement>, 'title'> & {
25
+ href: string;
26
+ };
27
+ type ListRowButtonProps = ListRowSharedProps & Omit<ButtonHTMLAttributes<HTMLButtonElement>, 'title'> & {
28
+ onClick: MouseEventHandler<HTMLButtonElement>;
29
+ };
30
+ type ListRowProps = ListRowStaticProps | ListRowLinkProps | ListRowButtonProps;
31
+ /** A compact, responsive data row. Passing `href` renders a link; passing `onClick` renders a button. */
32
+ declare const ListRow: react.ForwardRefExoticComponent<ListRowProps & react.RefAttributes<HTMLElement>>;
33
+ interface ListGroupProps extends HTMLAttributes<HTMLElement> {
34
+ heading?: ReactNode;
35
+ children: ReactNode;
36
+ }
37
+ /** Groups related list rows under an optional visible heading. */
38
+ declare function ListGroup({ heading, children, className, ...props }: ListGroupProps): react.JSX.Element;
39
+ interface AvatarProps extends Omit<ImgHTMLAttributes<HTMLImageElement>, 'size'> {
40
+ fallback?: ReactNode;
41
+ size?: 'sm' | 'md' | 'lg';
42
+ }
43
+ /** Image avatar with an accessible text or node fallback when the image is unavailable. */
44
+ declare function Avatar({ src, alt, fallback, size, className, onError, ...props }: AvatarProps): react.JSX.Element;
45
+ interface LogoStackItem {
46
+ src?: string;
47
+ alt?: string;
48
+ fallback?: ReactNode;
49
+ }
50
+ interface LogoStackProps extends Omit<HTMLAttributes<HTMLDivElement>, 'children'> {
51
+ logos: readonly LogoStackItem[];
52
+ size?: 'sm' | 'md' | 'lg';
53
+ max?: number;
54
+ }
55
+ /** Overlapping generic image marks, including the same graceful fallback as Avatar. */
56
+ declare function LogoStack({ logos, size, max, className, ...props }: LogoStackProps): react.JSX.Element;
57
+ interface ErrorStateProps extends Omit<HTMLAttributes<HTMLDivElement>, 'title'> {
58
+ title: ReactNode;
59
+ description?: ReactNode;
60
+ retryLabel?: string;
61
+ onRetry?: MouseEventHandler<HTMLButtonElement>;
62
+ }
63
+ /** Compact recoverable-error presentation. Request retry work remains with the consumer. */
64
+ declare function ErrorState({ title, description, retryLabel, onRetry, className, ...props }: ErrorStateProps): react.JSX.Element;
65
+ interface LoadingMoreProps extends HTMLAttributes<HTMLDivElement> {
66
+ label?: ReactNode;
67
+ }
68
+ /** Presentational loading indicator for the end of a growing list. */
69
+ declare function LoadingMore({ label, className, ...props }: LoadingMoreProps): react.JSX.Element;
70
+ type StepChecklistState = 'complete' | 'current' | 'upcoming';
71
+ interface StepChecklistItem {
72
+ label: ReactNode;
73
+ description?: ReactNode;
74
+ state?: StepChecklistState;
75
+ }
76
+ interface StepChecklistProps extends Omit<HTMLAttributes<HTMLOListElement>, 'children'> {
77
+ steps: readonly StepChecklistItem[];
78
+ }
79
+ /** Static progress checklist; consumers own navigation and completion state changes. */
80
+ declare function StepChecklist({ steps, className, ...props }: StepChecklistProps): react.JSX.Element;
81
+
82
+ /**
83
+ * A bordered field frame with an inset label and optional leading or trailing
84
+ * content. Set the contained input id to the required inputId for label association.
85
+ */
86
+ interface FieldProps extends Omit<HTMLAttributes<HTMLDivElement>, 'children'> {
87
+ /** ID of the contained native input; associates it with the inset label. */
88
+ inputId: string;
89
+ label?: ReactNode;
90
+ leading?: ReactNode;
91
+ trailing?: ReactNode;
92
+ children: ReactNode;
93
+ invalid?: boolean;
94
+ }
95
+ /** Generic field chrome for native inputs and input-like controls. */
96
+ declare function Field({ label, leading, trailing, children, invalid, inputId, className, ...props }: FieldProps): react.JSX.Element;
97
+ interface OtpInputProps extends Omit<InputHTMLAttributes<HTMLInputElement>, 'defaultValue' | 'maxLength' | 'onChange' | 'size' | 'type' | 'value'> {
98
+ /** Controlled verification code. Non-digit characters are ignored. */
99
+ value: string;
100
+ /** Receives the normalized code after typing, pasting, or browser autofill. */
101
+ onValueChange: (value: string) => void;
102
+ /** Number of visual code cells and the maximum accepted code length. */
103
+ length?: number;
104
+ /** Called once for each distinct complete value, after the controlled value updates. */
105
+ onComplete?: (value: string) => void;
106
+ /** Delay before `onComplete`, allowing the final digit to render before navigation. */
107
+ completionDelay?: number;
108
+ /** Blocks editing while the application verifies the current code. */
109
+ pending?: boolean;
110
+ /** Announced and displayed while `pending` is true. */
111
+ pendingLabel?: ReactNode;
112
+ label?: ReactNode;
113
+ helperText?: ReactNode;
114
+ error?: ReactNode;
115
+ containerClassName?: string;
116
+ }
117
+ /**
118
+ * Accessible segmented one-time-code input backed by one native input so paste
119
+ * and platform autofill work as expected. Authentication and verification stay
120
+ * in the consuming application.
121
+ */
122
+ declare function OtpInput({ value, onValueChange, length, onComplete, completionDelay, pending, pendingLabel, label, helperText, error, id, className, containerClassName, disabled, readOnly, onPaste, onFocus, onBlur, ...props }: OtpInputProps): react.JSX.Element;
123
+ interface ResendCodeButtonProps extends Omit<ButtonHTMLAttributes<HTMLButtonElement>, 'children' | 'type'> {
124
+ /** UTC timestamp (milliseconds) or Date until another request may be sent. */
125
+ deadline?: number | Date | null;
126
+ /** Shows progress while the consuming application handles its request. */
127
+ pending?: boolean;
128
+ children?: ReactNode;
129
+ /** Optional rendering override for the remaining whole seconds. */
130
+ formatCountdown?: (remainingSeconds: number) => ReactNode;
131
+ }
132
+ /**
133
+ * A presentational resend action. Pass an externally owned `deadline`; this
134
+ * component does not issue requests or set cooldown policy.
135
+ */
136
+ declare function ResendCodeButton({ deadline, pending, disabled, children, formatCountdown, className, onClick, ...props }: ResendCodeButtonProps): react.JSX.Element;
137
+
138
+ type ToastId = string;
139
+ type ToastTone = 'success' | 'error' | 'warning' | 'info' | 'loading';
140
+ interface ToastActionOptions {
141
+ label: ReactNode;
142
+ /** Accessible description of the effect, required by Radix ToastAction. */
143
+ altText: string;
144
+ onClick: () => void;
145
+ }
146
+ interface ToastOptions {
147
+ /** Reusing an id updates the existing notification instead of adding another one. */
148
+ id?: ToastId;
149
+ description?: ReactNode;
150
+ action?: ToastActionOptions;
151
+ /** Lets Radix own this notification's dismissal timer. */
152
+ duration?: number;
153
+ }
154
+ interface ToastUpdate extends Omit<ToastOptions, 'id'> {
155
+ title?: ReactNode;
156
+ tone?: ToastTone;
157
+ }
158
+ interface ToastPromiseMessages<Value> {
159
+ loading: ReactNode;
160
+ success: ReactNode | ((value: Value) => ReactNode);
161
+ error: ReactNode | ((error: unknown) => ReactNode);
162
+ }
163
+ interface ToastApi {
164
+ success: (title: ReactNode, options?: ToastOptions) => ToastId;
165
+ error: (title: ReactNode, options?: ToastOptions) => ToastId;
166
+ warning: (title: ReactNode, options?: ToastOptions) => ToastId;
167
+ info: (title: ReactNode, options?: ToastOptions) => ToastId;
168
+ loading: (title: ReactNode, options?: ToastOptions) => ToastId;
169
+ update: (id: ToastId, update: ToastUpdate) => ToastId;
170
+ dismiss: (id?: ToastId) => void;
171
+ promise: <Value>(promise: PromiseLike<Value>, messages: ToastPromiseMessages<Value>, options?: ToastOptions) => Promise<Value>;
172
+ }
173
+ interface NotificationsProviderProps {
174
+ children: ReactNode;
175
+ /** Default Radix dismissal duration for non-loading notifications. */
176
+ duration?: number;
177
+ /** Maximum number of notifications kept visible by this provider. */
178
+ maxVisible?: number;
179
+ /** Accessible label announced by the Radix toast viewport. */
180
+ label?: string;
181
+ }
182
+ /**
183
+ * Provider-scoped notification state backed by the SDK Toast primitives.
184
+ * Each provider has its own queue, ids and Radix-managed dismissal timers.
185
+ */
186
+ declare function NotificationsProvider({ children, duration, maxVisible, label, }: NotificationsProviderProps): react.JSX.Element;
187
+ /** Returns the notification API for the nearest NotificationsProvider. */
188
+ declare function useToast(): ToastApi;
189
+
190
+ type FactoThemeTokens = Partial<Record<`--facto-${string}`, string | number>>;
10
191
  type ThemeTokens = FactoThemeTokens;
11
- export interface FactoThemeProps extends Omit<HTMLAttributes<HTMLDivElement>, 'style'> {
192
+ interface FactoThemeProps extends Omit<HTMLAttributes<HTMLDivElement>, 'style'> {
12
193
  /** Scoped overrides; unspecified tokens inherit the dashboard defaults or parent theme. */
13
194
  tokens?: FactoThemeTokens;
14
195
  /** Inline styles take precedence over the tokens prop. */
15
196
  style?: CSSProperties & Partial<ThemeTokens>;
16
197
  }
17
198
  /** Scoped token container. Inline `--facto-*` values are forwarded to portalled overlays. */
18
- export declare function FactoTheme({ className, tokens, style, ...props }: FactoThemeProps): import("react").JSX.Element;
199
+ declare function FactoTheme({ className, tokens, style, ...props }: FactoThemeProps): react.JSX.Element;
19
200
  /** Shared decorative symbols; name the containing control, not the glyph. */
20
- export type IconName = 'close' | 'arrowLeft' | 'check' | 'chevronDown' | 'info' | 'warning';
21
- export interface IconProps extends SVGProps<SVGSVGElement> {
201
+ type IconName = 'close' | 'arrowLeft' | 'check' | 'chevronDown' | 'chevronRight' | 'info' | 'warning' | 'plus' | 'chevronLeft' | 'copy' | 'search';
202
+ interface IconProps extends SVGProps<SVGSVGElement> {
22
203
  name: IconName;
23
204
  size?: number;
24
205
  }
25
- export declare function Icon({ name, size, ...props }: IconProps): import("react").JSX.Element;
206
+ declare function Icon({ name, size, ...props }: IconProps): react.JSX.Element;
26
207
  /** Layout only: use existing Dialog/Sheet title and close primitives inside. */
27
- export declare function ModalHeader({ className, ...props }: HTMLAttributes<HTMLDivElement>): import("react").JSX.Element;
28
- export declare function ModalFooter({ className, ...props }: HTMLAttributes<HTMLDivElement>): import("react").JSX.Element;
208
+ declare function ModalHeader({ className, ...props }: HTMLAttributes<HTMLDivElement>): react.JSX.Element;
209
+ declare function ModalFooter({ className, ...props }: HTMLAttributes<HTMLDivElement>): react.JSX.Element;
29
210
  /** Button hierarchy based on the final Facto user application controls. */
30
- export type ButtonVariant = 'primary' | 'secondary' | 'danger' | 'text';
31
- export type ButtonSize = 'sm' | 'md' | 'lg';
32
- export interface ButtonProps extends ButtonHTMLAttributes<HTMLButtonElement> {
211
+ type ButtonVariant = 'primary' | 'secondary' | 'danger' | 'text';
212
+ type ButtonSize = 'sm' | 'md' | 'lg';
213
+ interface ButtonProps extends ButtonHTMLAttributes<HTMLButtonElement> {
33
214
  variant?: ButtonVariant;
34
215
  size?: ButtonSize;
35
216
  fullWidth?: boolean;
36
217
  /** Shows a non-interactive progress indicator and disables the control. */
37
218
  loading?: boolean;
219
+ leadingIcon?: ReactNode;
220
+ trailingIcon?: ReactNode;
38
221
  }
39
- export declare const Button: import("react").ForwardRefExoticComponent<ButtonProps & import("react").RefAttributes<HTMLButtonElement>>;
222
+ declare const Button: react.ForwardRefExoticComponent<ButtonProps & react.RefAttributes<HTMLButtonElement>>;
40
223
  /** Accessible icon-only action. `ariaLabel` is required because there is no visible text. */
41
- export interface IconButtonProps extends Omit<ButtonHTMLAttributes<HTMLButtonElement>, 'aria-label'> {
224
+ interface IconButtonProps extends Omit<ButtonHTMLAttributes<HTMLButtonElement>, 'aria-label'> {
42
225
  ariaLabel: string;
43
226
  size?: ButtonSize;
44
227
  }
45
- export declare const IconButton: import("react").ForwardRefExoticComponent<IconButtonProps & import("react").RefAttributes<HTMLButtonElement>>;
228
+ declare const IconButton: react.ForwardRefExoticComponent<IconButtonProps & react.RefAttributes<HTMLButtonElement>>;
46
229
  /** Neutral content container with a quiet border and no elevation. */
47
- export interface SurfaceProps extends HTMLAttributes<HTMLDivElement> {
230
+ interface SurfaceProps extends HTMLAttributes<HTMLDivElement> {
48
231
  padding?: 'none' | 'sm' | 'md' | 'lg';
49
232
  }
50
- export declare function Surface({ padding, className, ...props }: SurfaceProps): import("react").JSX.Element;
233
+ declare function Surface({ padding, className, ...props }: SurfaceProps): react.JSX.Element;
51
234
  /** Semantic alias for a card-shaped `Surface`. */
52
- export declare function Card(props: SurfaceProps): import("react").JSX.Element;
235
+ declare function Card(props: SurfaceProps): react.JSX.Element;
53
236
  /** Compact overview widget preset (20px padding) from the Facto dashboard. */
54
- export interface WidgetProps extends Omit<SurfaceProps, 'padding'> {
237
+ interface WidgetProps extends Omit<SurfaceProps, 'padding'> {
55
238
  span?: 1 | 2;
56
239
  }
57
- export declare function Widget({ span, className, ...props }: WidgetProps): import("react").JSX.Element;
240
+ declare function Widget({ span, className, ...props }: WidgetProps): react.JSX.Element;
58
241
  /** Responsive 194px dashboard widget grid with its own query container. */
59
- export declare function DashboardGrid({ className, children, ...props }: HTMLAttributes<HTMLDivElement>): import("react").JSX.Element;
60
- export interface WidgetHeaderProps extends HTMLAttributes<HTMLDivElement> {
242
+ declare function DashboardGrid({ className, children, ...props }: HTMLAttributes<HTMLDivElement>): react.JSX.Element;
243
+ interface WidgetHeaderProps extends HTMLAttributes<HTMLDivElement> {
61
244
  withAction?: boolean;
62
245
  }
63
- export declare function WidgetHeader({ withAction, className, ...props }: WidgetHeaderProps): import("react").JSX.Element;
64
- export declare function WidgetList({ className, ...props }: HTMLAttributes<HTMLDivElement>): import("react").JSX.Element;
65
- export declare function WidgetKeyValue({ className, ...props }: HTMLAttributes<HTMLDivElement>): import("react").JSX.Element;
66
- export declare function WidgetAmount({ className, ...props }: HTMLAttributes<HTMLDivElement>): import("react").JSX.Element;
67
- export interface WidgetActionButtonProps extends ButtonHTMLAttributes<HTMLButtonElement> {
246
+ declare function WidgetHeader({ withAction, className, ...props }: WidgetHeaderProps): react.JSX.Element;
247
+ declare function WidgetList({ className, ...props }: HTMLAttributes<HTMLDivElement>): react.JSX.Element;
248
+ declare function WidgetKeyValue({ className, ...props }: HTMLAttributes<HTMLDivElement>): react.JSX.Element;
249
+ declare function WidgetAmount({ className, ...props }: HTMLAttributes<HTMLDivElement>): react.JSX.Element;
250
+ interface WidgetActionButtonProps extends ButtonHTMLAttributes<HTMLButtonElement> {
68
251
  dark?: boolean;
69
252
  href?: never;
70
253
  }
71
- export interface WidgetActionLinkProps extends AnchorHTMLAttributes<HTMLAnchorElement> {
254
+ interface WidgetActionLinkProps extends AnchorHTMLAttributes<HTMLAnchorElement> {
72
255
  dark?: boolean;
73
256
  href: string;
74
257
  }
75
- export type WidgetActionProps = WidgetActionButtonProps | WidgetActionLinkProps;
258
+ type WidgetActionProps = WidgetActionButtonProps | WidgetActionLinkProps;
76
259
  /** Use href for navigation; omit it for a button action. */
77
- export declare function WidgetAction(props: WidgetActionProps): import("react").JSX.Element;
78
- export declare function WidgetRow({ className, type, ...props }: ButtonHTMLAttributes<HTMLButtonElement>): import("react").JSX.Element;
79
- export interface TextFieldProps extends Omit<InputHTMLAttributes<HTMLInputElement>, 'size'> {
260
+ declare function WidgetAction(props: WidgetActionProps): react.JSX.Element;
261
+ declare function WidgetRow({ className, type, ...props }: ButtonHTMLAttributes<HTMLButtonElement>): react.JSX.Element;
262
+ interface TextFieldProps extends Omit<InputHTMLAttributes<HTMLInputElement>, 'size'> {
80
263
  label?: ReactNode;
81
264
  helperText?: ReactNode;
82
265
  error?: ReactNode;
83
266
  containerClassName?: string;
84
267
  }
85
268
  /** Labelled text input with linked helper or error description. */
86
- export declare function TextField({ label, helperText, error, id, containerClassName, className, ...props }: TextFieldProps): import("react").JSX.Element;
87
- export interface TextareaProps extends TextareaHTMLAttributes<HTMLTextAreaElement> {
269
+ declare function TextField({ label, helperText, error, id, containerClassName, className, ...props }: TextFieldProps): react.JSX.Element;
270
+ interface TextareaProps extends TextareaHTMLAttributes<HTMLTextAreaElement> {
88
271
  label?: ReactNode;
89
272
  helperText?: ReactNode;
90
273
  error?: ReactNode;
91
274
  containerClassName?: string;
92
275
  }
93
276
  /** Labelled multiline input with linked helper or error description. */
94
- export declare function Textarea({ label, helperText, error, id, containerClassName, className, ...props }: TextareaProps): import("react").JSX.Element;
95
- export type BadgeTone = 'success' | 'warning' | 'danger' | 'neutral';
96
- export interface BadgeProps extends HTMLAttributes<HTMLSpanElement> {
277
+ declare function Textarea({ label, helperText, error, id, containerClassName, className, ...props }: TextareaProps): react.JSX.Element;
278
+ type BadgeTone = 'success' | 'warning' | 'danger' | 'neutral';
279
+ interface BadgeProps extends HTMLAttributes<HTMLSpanElement> {
97
280
  tone?: BadgeTone;
98
281
  }
99
282
  /** Compact explicit status label. */
100
- export declare function Badge({ tone, className, ...props }: BadgeProps): import("react").JSX.Element;
101
- export interface SelectItem {
283
+ declare function Badge({ tone, className, ...props }: BadgeProps): react.JSX.Element;
284
+ interface SelectItem {
102
285
  value: string;
103
286
  label: ReactNode;
104
287
  disabled?: boolean;
105
288
  }
106
- export interface SelectProps {
289
+ interface SelectProps {
107
290
  options: readonly SelectItem[];
108
291
  value?: string;
109
292
  defaultValue?: string;
@@ -119,105 +302,135 @@ export interface SelectProps {
119
302
  className?: string;
120
303
  }
121
304
  /** Controlled or uncontrolled Radix select. Use `options` for stable value/label pairs. */
122
- export declare function Select({ options, value, defaultValue, onValueChange, placeholder, label, error, disabled, name, id, ariaLabel, 'aria-describedby': ariaDescribedBy, className, }: SelectProps): import("react").JSX.Element;
123
- export interface SwitchProps extends Omit<ComponentPropsWithoutRef<typeof SwitchPrimitive.Root>, 'children'> {
305
+ declare function Select({ options, value, defaultValue, onValueChange, placeholder, label, error, disabled, name, id, ariaLabel, 'aria-describedby': ariaDescribedBy, className, }: SelectProps): react.JSX.Element;
306
+ interface SwitchProps extends Omit<ComponentPropsWithoutRef<typeof SwitchPrimitive.Root>, 'children'> {
124
307
  label?: ReactNode;
125
308
  description?: ReactNode;
126
309
  }
127
310
  /** Radix switch with optional visible label and description. */
128
- export declare function Switch({ label, description, className, id, ...props }: SwitchProps): import("react").JSX.Element;
129
- export interface CheckboxProps extends Omit<ComponentPropsWithoutRef<typeof CheckboxPrimitive.Root>, 'children'> {
311
+ declare function Switch({ label, description, className, id, ...props }: SwitchProps): react.JSX.Element;
312
+ interface CheckboxProps extends Omit<ComponentPropsWithoutRef<typeof CheckboxPrimitive.Root>, 'children'> {
130
313
  label?: ReactNode;
131
314
  description?: ReactNode;
132
315
  }
133
316
  /** Radix checkbox with optional visible label and description. */
134
- export declare function Checkbox({ label, description, className, id, ...props }: CheckboxProps): import("react").JSX.Element;
135
- export declare const Tabs: import("react").ForwardRefExoticComponent<TabsPrimitive.TabsProps & import("react").RefAttributes<HTMLDivElement>>;
136
- export declare function TabsList({ className, ...props }: ComponentPropsWithoutRef<typeof TabsPrimitive.List>): import("react").JSX.Element;
137
- export declare function TabsTrigger({ className, ...props }: ComponentPropsWithoutRef<typeof TabsPrimitive.Trigger>): import("react").JSX.Element;
138
- export declare function TabsContent({ className, ...props }: ComponentPropsWithoutRef<typeof TabsPrimitive.Content>): import("react").JSX.Element;
139
- export declare const Dialog: import("react").FC<DialogPrimitive.DialogProps>;
140
- export declare const DialogTrigger: import("react").ForwardRefExoticComponent<DialogPrimitive.DialogTriggerProps & import("react").RefAttributes<HTMLButtonElement>>;
141
- export declare const DialogClose: import("react").ForwardRefExoticComponent<DialogPrimitive.DialogCloseProps & import("react").RefAttributes<HTMLButtonElement>>;
142
- export declare const DialogTitle: typeof DialogPrimitive.Title;
143
- export declare const DialogDescription: typeof DialogPrimitive.Description;
144
- export interface DialogContentProps extends ComponentPropsWithoutRef<typeof DialogPrimitive.Content> {
317
+ declare function Checkbox({ label, description, className, id, ...props }: CheckboxProps): react.JSX.Element;
318
+ declare const Tabs: react.ForwardRefExoticComponent<TabsPrimitive.TabsProps & react.RefAttributes<HTMLDivElement>>;
319
+ declare function TabsList({ className, ...props }: ComponentPropsWithoutRef<typeof TabsPrimitive.List>): react.JSX.Element;
320
+ declare function TabsTrigger({ className, ...props }: ComponentPropsWithoutRef<typeof TabsPrimitive.Trigger>): react.JSX.Element;
321
+ declare function TabsContent({ className, ...props }: ComponentPropsWithoutRef<typeof TabsPrimitive.Content>): react.JSX.Element;
322
+ declare const Dialog: react.FC<DialogPrimitive.DialogProps>;
323
+ declare const DialogTrigger: react.ForwardRefExoticComponent<DialogPrimitive.DialogTriggerProps & react.RefAttributes<HTMLButtonElement>>;
324
+ declare const DialogClose: react.ForwardRefExoticComponent<DialogPrimitive.DialogCloseProps & react.RefAttributes<HTMLButtonElement>>;
325
+ declare const DialogTitle: react.ForwardRefExoticComponent<Omit<DialogPrimitive.DialogTitleProps & react.RefAttributes<HTMLHeadingElement>, "ref"> & react.RefAttributes<HTMLHeadingElement>>;
326
+ declare const DialogDescription: typeof DialogPrimitive.Description;
327
+ /** auto: existing mobile entrance; bottom: enter/exit on all screens; none: static. */
328
+ type OverlayMotionVariant = 'auto' | 'bottom' | 'none';
329
+ interface DialogContentProps extends ComponentPropsWithoutRef<typeof DialogPrimitive.Content> {
145
330
  size?: 'sm' | 'md';
331
+ motionVariant?: OverlayMotionVariant;
146
332
  }
147
333
  /** Focus-managed modal content. Place title and description inside for accessible announcements. */
148
- export declare function DialogContent({ size, className, style, children, ...props }: DialogContentProps): import("react").JSX.Element;
149
- export declare const Sheet: import("react").FC<DialogPrimitive.DialogProps>;
150
- export declare const SheetTrigger: import("react").ForwardRefExoticComponent<DialogPrimitive.DialogTriggerProps & import("react").RefAttributes<HTMLButtonElement>>;
151
- export declare const SheetClose: import("react").ForwardRefExoticComponent<DialogPrimitive.DialogCloseProps & import("react").RefAttributes<HTMLButtonElement>>;
152
- export declare const SheetTitle: import("react").ForwardRefExoticComponent<DialogPrimitive.DialogTitleProps & import("react").RefAttributes<HTMLHeadingElement>>;
153
- export declare const SheetDescription: import("react").ForwardRefExoticComponent<DialogPrimitive.DialogDescriptionProps & import("react").RefAttributes<HTMLParagraphElement>>;
154
- export interface SheetContentProps extends ComponentPropsWithoutRef<typeof DialogPrimitive.Content> {
334
+ declare function DialogContent({ size, motionVariant, className, style, children, ...props }: DialogContentProps): react.JSX.Element;
335
+ declare const Sheet: react.FC<DialogPrimitive.DialogProps>;
336
+ declare const SheetTrigger: react.ForwardRefExoticComponent<DialogPrimitive.DialogTriggerProps & react.RefAttributes<HTMLButtonElement>>;
337
+ declare const SheetClose: react.ForwardRefExoticComponent<DialogPrimitive.DialogCloseProps & react.RefAttributes<HTMLButtonElement>>;
338
+ declare const SheetTitle: react.ForwardRefExoticComponent<Omit<DialogPrimitive.DialogTitleProps & react.RefAttributes<HTMLHeadingElement>, "ref"> & react.RefAttributes<HTMLHeadingElement>>;
339
+ declare const SheetDescription: react.ForwardRefExoticComponent<DialogPrimitive.DialogDescriptionProps & react.RefAttributes<HTMLParagraphElement>>;
340
+ interface SheetContentProps extends ComponentPropsWithoutRef<typeof DialogPrimitive.Content> {
155
341
  side?: 'center' | 'right' | 'bottom';
342
+ motionVariant?: OverlayMotionVariant;
156
343
  }
157
344
  /** Focus-managed side or mobile-bottom sheet. */
158
- export declare function SheetContent({ side, className, style, children, ...props }: SheetContentProps): import("react").JSX.Element;
159
- export interface SkeletonProps extends HTMLAttributes<HTMLSpanElement> {
345
+ declare function SheetContent({ side, motionVariant, className, style, children, ...props }: SheetContentProps): react.JSX.Element;
346
+ interface SkeletonProps extends HTMLAttributes<HTMLSpanElement> {
160
347
  width?: string | number;
161
348
  height?: string | number;
162
349
  circle?: boolean;
163
350
  }
164
351
  /** Decorative neutral loading placeholder. */
165
- export declare function Skeleton({ width, height, circle, className, style, ...props }: SkeletonProps): import("react").JSX.Element;
166
- export interface EmptyStateProps extends Omit<HTMLAttributes<HTMLDivElement>, 'title'> {
352
+ declare function Skeleton({ width, height, circle, className, style, ...props }: SkeletonProps): react.JSX.Element;
353
+ interface EmptyStateProps extends Omit<HTMLAttributes<HTMLDivElement>, 'title'> {
167
354
  title: ReactNode;
168
355
  description?: ReactNode;
169
356
  action?: ReactNode;
170
357
  icon?: ReactNode;
171
358
  }
172
359
  /** Centred zero-data state. */
173
- export declare function EmptyState({ title, description, action, icon, className, ...props }: EmptyStateProps): import("react").JSX.Element;
174
- export type NoticeTone = 'info' | 'success' | 'warning' | 'danger';
175
- export interface NoticeProps extends Omit<HTMLAttributes<HTMLDivElement>, 'title'> {
360
+ declare function EmptyState({ title, description, action, icon, className, ...props }: EmptyStateProps): react.JSX.Element;
361
+ type NoticeTone = 'info' | 'success' | 'warning' | 'danger';
362
+ interface NoticeProps extends Omit<HTMLAttributes<HTMLDivElement>, 'title'> {
176
363
  tone?: NoticeTone;
177
364
  title: ReactNode;
178
365
  description?: ReactNode;
179
366
  action?: ReactNode;
180
367
  }
181
368
  /** Inline contextual notice; use `danger` for blocking errors. */
182
- export declare function Notice({ tone, title, description, action, className, ...props }: NoticeProps): import("react").JSX.Element;
183
- export interface StackProps extends HTMLAttributes<HTMLDivElement> {
369
+ declare function Notice({ tone, title, description, action, className, ...props }: NoticeProps): react.JSX.Element;
370
+ interface StackProps extends HTMLAttributes<HTMLDivElement> {
184
371
  gap?: 1 | 2 | 3 | 4 | 5 | 6;
185
372
  direction?: 'vertical' | 'horizontal';
186
373
  align?: 'start' | 'center' | 'end' | 'stretch';
187
374
  justify?: 'start' | 'center' | 'end' | 'between';
188
375
  }
189
376
  /** Small flex layout primitive using Facto spacing tokens. */
190
- export declare function Stack({ gap, direction, align, justify, className, ...props }: StackProps): import("react").JSX.Element;
191
- export declare function TooltipProvider({ delayDuration, ...props }: ComponentPropsWithRef<typeof TooltipPrimitive.Provider>): import("react").JSX.Element;
192
- export declare const Tooltip: import("react").FC<TooltipPrimitive.TooltipProps>;
193
- export declare const TooltipTrigger: import("react").ForwardRefExoticComponent<TooltipPrimitive.TooltipTriggerProps & import("react").RefAttributes<HTMLButtonElement>>;
194
- export interface TooltipContentProps extends ComponentPropsWithRef<typeof TooltipPrimitive.Content> {
377
+ declare function Stack({ gap, direction, align, justify, className, ...props }: StackProps): react.JSX.Element;
378
+ declare function TooltipProvider({ delayDuration, ...props }: ComponentPropsWithRef<typeof TooltipPrimitive.Provider>): react.JSX.Element;
379
+ declare const Tooltip: react.FC<TooltipPrimitive.TooltipProps>;
380
+ declare const TooltipTrigger: react.ForwardRefExoticComponent<TooltipPrimitive.TooltipTriggerProps & react.RefAttributes<HTMLButtonElement>>;
381
+ interface TooltipContentProps extends ComponentPropsWithRef<typeof TooltipPrimitive.Content> {
195
382
  variant?: 'default' | 'content';
196
383
  }
197
384
  /** Supplemental plain text; interactive content belongs in a dialog or popover. */
198
- export declare function TooltipContent({ variant, className, style, sideOffset, children, ...props }: TooltipContentProps): import("react").JSX.Element;
385
+ declare function TooltipContent({ variant, className, style, sideOffset, collisionPadding, children, ...props }: TooltipContentProps): react.JSX.Element;
199
386
  /** Dashboard notifications default to 2.6 seconds. */
200
- export declare function ToastProvider({ duration, ...props }: ComponentPropsWithRef<typeof ToastPrimitive.Provider>): import("react").JSX.Element;
201
- export interface ToastProps extends ComponentPropsWithRef<typeof ToastPrimitive.Root> {
387
+ declare function ToastProvider({ duration, ...props }: ComponentPropsWithRef<typeof ToastPrimitive.Provider>): react.JSX.Element;
388
+ interface ToastProps extends ComponentPropsWithRef<typeof ToastPrimitive.Root> {
389
+ icon?: ReactNode;
202
390
  tone?: NoticeTone;
203
391
  }
204
392
  /** Controlled or uncontrolled notification. Render a ToastViewport inside the provider. */
205
- export declare function Toast({ tone, className, style, children, ...props }: ToastProps): import("react").JSX.Element;
206
- export declare function ToastTitle({ className, ...props }: ComponentPropsWithRef<typeof ToastPrimitive.Title>): import("react").JSX.Element;
207
- export declare function ToastDescription({ className, ...props }: ComponentPropsWithRef<typeof ToastPrimitive.Description>): import("react").JSX.Element;
208
- export declare function ToastAction({ className, ...props }: ComponentPropsWithRef<typeof ToastPrimitive.Action>): import("react").JSX.Element;
209
- export declare function ToastClose({ className, children, 'aria-label': label, ...props }: ComponentPropsWithRef<typeof ToastPrimitive.Close>): import("react").JSX.Element;
210
- export declare function ToastViewport({ className, style, ...props }: ComponentPropsWithRef<typeof ToastPrimitive.Viewport>): import("react").ReactPortal | null;
211
- export interface EnhancedSearchFieldProps extends Omit<TextFieldProps, 'value' | 'defaultValue' | 'type' | 'onChange'> {
393
+ declare function Toast({ tone, icon, className, style, children, ...props }: ToastProps): react.JSX.Element;
394
+ declare function ToastTitle({ className, ...props }: ComponentPropsWithRef<typeof ToastPrimitive.Title>): react.JSX.Element;
395
+ declare function ToastDescription({ className, ...props }: ComponentPropsWithRef<typeof ToastPrimitive.Description>): react.JSX.Element;
396
+ declare function ToastAction({ className, ...props }: ComponentPropsWithRef<typeof ToastPrimitive.Action>): react.JSX.Element;
397
+ declare function ToastClose({ className, children, 'aria-label': label, ...props }: ComponentPropsWithRef<typeof ToastPrimitive.Close>): react.JSX.Element;
398
+ declare function ToastViewport({ className, style, ...props }: ComponentPropsWithRef<typeof ToastPrimitive.Viewport>): react.ReactPortal | null;
399
+ interface EnhancedSearchFieldProps extends Omit<TextFieldProps, 'value' | 'defaultValue' | 'type' | 'onChange'> {
212
400
  value?: string;
213
401
  defaultValue?: string;
214
402
  onValueChange?: (value: string) => void;
215
403
  clearLabel?: string;
216
404
  }
217
405
  /** Local input only; filtering and requests are owned by the consuming application. */
218
- export declare function EnhancedSearchField({ value, defaultValue, onValueChange, clearLabel, label, helperText, error, id, containerClassName, className, disabled, readOnly, ...props }: EnhancedSearchFieldProps): import("react").JSX.Element;
406
+ declare function EnhancedSearchField({ value, defaultValue, onValueChange, clearLabel, label, helperText, error, id, containerClassName, className, disabled, readOnly, ...props }: EnhancedSearchFieldProps): react.JSX.Element;
219
407
  /** Dashboard list search: native input changes, no added icon or clear action. */
220
- export interface SearchFieldProps extends Omit<TextFieldProps, 'type'> {
408
+ interface SearchFieldProps extends Omit<TextFieldProps, 'type'> {
409
+ }
410
+ declare function SearchField({ className, ...props }: SearchFieldProps): react.JSX.Element;
411
+ /** Non-modal contextual content with focus return and collision avoidance. */
412
+ declare const Popover: react.FC<PopoverPrimitive.PopoverProps>;
413
+ declare const PopoverTrigger: react.ForwardRefExoticComponent<PopoverPrimitive.PopoverTriggerProps & react.RefAttributes<HTMLButtonElement>>;
414
+ declare const PopoverClose: react.ForwardRefExoticComponent<PopoverPrimitive.PopoverCloseProps & react.RefAttributes<HTMLButtonElement>>;
415
+ declare function PopoverContent({ className, style, sideOffset, collisionPadding, ...props }: ComponentPropsWithRef<typeof PopoverPrimitive.Content>): react.JSX.Element;
416
+ /** Context menus are non-modal by default; keyboard focus still returns to the trigger. */
417
+ declare function DropdownMenu({ modal, ...props }: ComponentPropsWithRef<typeof MenuPrimitive.Root>): react.JSX.Element;
418
+ declare const DropdownMenuTrigger: react.ForwardRefExoticComponent<MenuPrimitive.DropdownMenuTriggerProps & react.RefAttributes<HTMLButtonElement>>;
419
+ declare function DropdownMenuContent({ className, style, sideOffset, collisionPadding, ...props }: ComponentPropsWithRef<typeof MenuPrimitive.Content>): react.JSX.Element;
420
+ declare function DropdownMenuItem({ className, ...props }: ComponentPropsWithRef<typeof MenuPrimitive.Item>): react.JSX.Element;
421
+ declare function DropdownMenuSeparator({ className, ...props }: ComponentPropsWithRef<typeof MenuPrimitive.Separator>): react.JSX.Element;
422
+
423
+ interface FilterChipProps extends ButtonHTMLAttributes<HTMLButtonElement> {
424
+ selected?: boolean;
425
+ }
426
+ /** Compact toggle for a caller-owned filter. */
427
+ declare function FilterChip({ selected, className, type, ...props }: FilterChipProps): react.JSX.Element;
428
+ interface ListSkeletonProps extends HTMLAttributes<HTMLDivElement> {
429
+ rows?: number;
430
+ label?: string;
221
431
  }
222
- export declare function SearchField({ className, ...props }: SearchFieldProps): import("react").JSX.Element;
223
- export {};
432
+ /** Loading placeholder only: consumers own the query and loading state. */
433
+ declare function ListSkeleton({ rows, label, className, ...props }: ListSkeletonProps): react.JSX.Element;
434
+
435
+ export { Avatar, Badge, Button, Card, Checkbox, DashboardGrid, Dialog, DialogClose, DialogContent, DialogDescription, DialogTitle, DialogTrigger, DropdownMenu, DropdownMenuContent, DropdownMenuItem, DropdownMenuSeparator, DropdownMenuTrigger, EmptyState, EnhancedSearchField, ErrorState, FactoTheme, Field, FilterChip, Icon, IconButton, ListGroup, ListRow, ListSkeleton, LoadingMore, LogoStack, ModalFooter, ModalHeader, Notice, NotificationsProvider, OtpInput, Popover, PopoverClose, PopoverContent, PopoverTrigger, ResendCodeButton, SearchField, Select, Sheet, SheetClose, SheetContent, SheetDescription, SheetTitle, SheetTrigger, Skeleton, Stack, StepChecklist, Surface, Switch, Tabs, TabsContent, TabsList, TabsTrigger, TextField, Textarea, Toast, ToastAction, ToastClose, ToastDescription, ToastProvider, ToastTitle, ToastViewport, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, Widget, WidgetAction, WidgetAmount, WidgetHeader, WidgetKeyValue, WidgetList, WidgetRow, useToast };
436
+ export type { AvatarProps, BadgeProps, BadgeTone, ButtonProps, ButtonSize, ButtonVariant, CheckboxProps, DialogContentProps, EmptyStateProps, EnhancedSearchFieldProps, ErrorStateProps, FactoThemeProps, FactoThemeTokens, FieldProps, FilterChipProps, IconButtonProps, IconName, IconProps, ListGroupProps, ListRowButtonProps, ListRowLinkProps, ListRowProps, ListRowSlots, ListRowStaticProps, ListSkeletonProps, LoadingMoreProps, LogoStackItem, LogoStackProps, NoticeProps, NoticeTone, NotificationsProviderProps, OtpInputProps, OverlayMotionVariant, ResendCodeButtonProps, SearchFieldProps, SelectItem, SelectProps, SheetContentProps, SkeletonProps, StackProps, StepChecklistItem, StepChecklistProps, StepChecklistState, SurfaceProps, SwitchProps, TextFieldProps, TextareaProps, ToastActionOptions, ToastApi, ToastId, ToastOptions, ToastPromiseMessages, ToastProps, ToastTone, ToastUpdate, TooltipContentProps, WidgetActionButtonProps, WidgetActionLinkProps, WidgetActionProps, WidgetHeaderProps, WidgetProps };