@getufy/flint-ui-react 0.2.1 → 0.3.0

package/dist/components/FlintCommandShortcut.d.ts

@@ -1,4 +1,11 @@
 import React from 'react';
 import { FlintCommandShortcut as FlintCommandShortcutElement } from '@getufy/flint-ui/command/flint-command';
-export declare const FlintCommandShortcut: import("@lit/react").ReactWebComponent<FlintCommandShortcutElement, {}>;
-export type FlintCommandShortcutProps = React.ComponentProps<typeof FlintCommandShortcut>;
+/**
+ * Displays a keyboard shortcut hint inside a command item.
+Slot the shortcut string (e.g. `⌘P`) as default slot content.
+ *
+ * @slot - Shortcut text, e.g. `⌘P` or `Ctrl+K`.
+ */
+export interface FlintCommandShortcutProps extends React.HTMLAttributes<FlintCommandShortcutElement> {
+}
+export declare const FlintCommandShortcut: React.ForwardRefExoticComponent<FlintCommandShortcutProps & React.RefAttributes<FlintCommandShortcutElement>>;

package/dist/components/FlintContainer.d.ts

@@ -1,4 +1,11 @@
 import React from 'react';
 import { FlintContainer as FlintContainerElement } from '@getufy/flint-ui/container/flint-container';
-export declare const FlintContainer: import("@lit/react").ReactWebComponent<FlintContainerElement, {}>;
-export type FlintContainerProps = React.ComponentProps<typeof FlintContainer>;
+export interface FlintContainerProps extends React.HTMLAttributes<FlintContainerElement> {
+    /** Determine the max-width of the container. */
+    maxWidth?: FlintContainerElement['maxWidth'];
+    /** If `true`, the left and right padding is removed. */
+    disableGutters?: boolean;
+    /** Set the max-width to match the min-width of the current breakpoint. */
+    fixed?: boolean;
+}
+export declare const FlintContainer: React.ForwardRefExoticComponent<FlintContainerProps & React.RefAttributes<FlintContainerElement>>;

package/dist/components/FlintCopyButton.d.ts

@@ -1,8 +1,34 @@
 import React from 'react';
-import { type EventName } from '@lit/react';
 import { FlintCopyButton as FlintCopyButtonElement } from '@getufy/flint-ui/copy-button/flint-copy-button';
-export declare const FlintCopyButton: import("@lit/react").ReactWebComponent<FlintCopyButtonElement, {
-    onFlintCopyError: EventName<CustomEvent>;
-    onFlintCopy: EventName<CustomEvent>;
-}>;
-export type FlintCopyButtonProps = React.ComponentProps<typeof FlintCopyButton>;
+export interface FlintCopyErrorDetail {
+    reason: string;
+}
+export interface FlintCopyDetail {
+    value: string;
+}
+/**
+ * Copy Button: copies text to the clipboard with visual feedback.
+ */
+export interface FlintCopyButtonProps extends React.HTMLAttributes<FlintCopyButtonElement> {
+    /** The text value to copy. */
+    value?: string;
+    /** An id referencing another element to copy from. */
+    from?: string;
+    /** Disables the copy button. */
+    disabled?: boolean;
+    /** Label shown in the tooltip (idle state). */
+    copyLabel?: string;
+    /** Label shown in the tooltip after successful copy. */
+    successLabel?: string;
+    /** Label shown in the tooltip on copy error. */
+    errorLabel?: string;
+    /** Duration (ms) to show feedback before returning to idle. */
+    feedbackDuration?: number;
+    /** Tooltip placement. */
+    tooltipPlacement?: 'top' | 'right' | 'bottom' | 'left';
+    /** Fired when the copy operation fails. */
+    onFlintCopyError?: (event: CustomEvent<FlintCopyErrorDetail>) => void;
+    /** Fired after a successful copy operation. */
+    onFlintCopy?: (event: CustomEvent<FlintCopyDetail>) => void;
+}
+export declare const FlintCopyButton: React.ForwardRefExoticComponent<FlintCopyButtonProps & React.RefAttributes<FlintCopyButtonElement>>;

package/dist/components/FlintDateField.d.ts

@@ -1,8 +1,36 @@
 import React from 'react';
-import { type EventName } from '@lit/react';
 import { FlintDateField as FlintDateFieldElement } from '@getufy/flint-ui/date-field/flint-date-field';
-export declare const FlintDateField: import("@lit/react").ReactWebComponent<FlintDateFieldElement, {
-    onFlintDateFieldClear: EventName<CustomEvent>;
-    onFlintDateFieldChange: EventName<CustomEvent>;
-}>;
-export type FlintDateFieldProps = React.ComponentProps<typeof FlintDateField>;
+export interface FlintDateFieldChangeDetail {
+    value: string;
+}
+/**
+ * A segmented keyboard-driven date input.
+Each section (month, day, year) is independently editable via keyboard.
+ */
+export interface FlintDateFieldProps extends React.HTMLAttributes<FlintDateFieldElement> {
+    /** Controlled date value (ISO YYYY-MM-DD). Set to '' for uncontrolled. */
+    value?: string;
+    /** Field label. */
+    label?: string;
+    /** Form field name. Reflected so the browser picks it up for form data collection. */
+    name?: string;
+    /** Minimum allowed date (ISO). */
+    min?: string;
+    /** Maximum allowed date (ISO). */
+    max?: string;
+    /** Disables the field and prevents interaction. */
+    disabled?: boolean;
+    /** Makes the field read-only (visible but not editable). */
+    readonly?: boolean;
+    /** Displays the field in an error state. */
+    error?: boolean;
+    /** Helper text shown below the field. */
+    helperText?: string;
+    /** Error message displayed below the field when in error state. */
+    errorMessage?: string;
+    /** Fired when all segments are cleared */
+    onFlintDateFieldClear?: (event: CustomEvent) => void;
+    /** { detail: { value: string } } ISO date when all three segments are filled */
+    onFlintDateFieldChange?: (event: CustomEvent<FlintDateFieldChangeDetail>) => void;
+}
+export declare const FlintDateField: React.ForwardRefExoticComponent<FlintDateFieldProps & React.RefAttributes<FlintDateFieldElement>>;

package/dist/components/FlintDatePicker.d.ts

@@ -1,7 +1,37 @@
 import React from 'react';
-import { type EventName } from '@lit/react';
 import { FlintDatePicker as FlintDatePickerElement } from '@getufy/flint-ui/date-picker/flint-date-picker';
-export declare const FlintDatePicker: import("@lit/react").ReactWebComponent<FlintDatePickerElement, {
-    onChange: EventName<CustomEvent>;
-}>;
-export type FlintDatePickerProps = React.ComponentProps<typeof FlintDatePicker>;
+export interface ChangeDetail {
+    value: string;
+}
+/**
+ * A date picker with a text field and a calendar popover/modal.
+ */
+export interface FlintDatePickerProps extends Omit<React.HTMLAttributes<FlintDatePickerElement>, 'onChange'> {
+    /** Selected date as ISO string (YYYY-MM-DD). */
+    value?: string;
+    /** Label shown above the field. */
+    label?: string;
+    /** Placeholder shown in the empty field. */
+    placeholder?: string;
+    /** Form field name attribute. */
+    name?: string;
+    /** Variant: 'desktop' | 'mobile' | 'static' | 'auto'. */
+    variant?: 'desktop' | 'mobile' | 'static' | 'auto';
+    /** Minimum selectable date (ISO). */
+    min?: string;
+    /** Maximum selectable date (ISO). */
+    max?: string;
+    /** Disables the picker. */
+    disabled?: boolean;
+    /** Makes the field read-only (auto-opens a picker when clicked). */
+    readonly?: boolean;
+    /** Shows error styling. */
+    error?: boolean;
+    /** Helper/error text below the field. */
+    helperText?: string;
+    /** Error message displayed below the field when in error state. */
+    errorMessage?: string;
+    /** { detail: { value: string } } when the date changes */
+    onChange?: (event: CustomEvent<ChangeDetail>) => void;
+}
+export declare const FlintDatePicker: React.ForwardRefExoticComponent<FlintDatePickerProps & React.RefAttributes<FlintDatePickerElement>>;

package/dist/components/FlintDatePickerCalendar.d.ts

@@ -1,7 +1,22 @@
 import React from 'react';
-import { type EventName } from '@lit/react';
 import { FlintDatePickerCalendar as FlintDatePickerCalendarElement } from '@getufy/flint-ui/date-picker/flint-date-picker';
-export declare const FlintDatePickerCalendar: import("@lit/react").ReactWebComponent<FlintDatePickerCalendarElement, {
-    onFlintDatePickerSelect: EventName<CustomEvent>;
-}>;
-export type FlintDatePickerCalendarProps = React.ComponentProps<typeof FlintDatePickerCalendar>;
+export interface FlintDatePickerSelectDetail {
+    value: string;
+}
+/**
+ * A standalone calendar grid — the core date-selection view.
+Used internally by flint-date-picker, but can also be used on its own.
+ */
+export interface FlintDatePickerCalendarProps extends React.HTMLAttributes<FlintDatePickerCalendarElement> {
+    /** Currently selected value as ISO string (YYYY-MM-DD). */
+    value?: string;
+    /** Minimum selectable date (ISO). */
+    min?: string;
+    /** Maximum selectable date (ISO). */
+    max?: string;
+    /** Disable all interaction. */
+    disabled?: boolean;
+    /** { detail: { value: string } } ISO date YYYY-MM-DD */
+    onFlintDatePickerSelect?: (event: CustomEvent<FlintDatePickerSelectDetail>) => void;
+}
+export declare const FlintDatePickerCalendar: React.ForwardRefExoticComponent<FlintDatePickerCalendarProps & React.RefAttributes<FlintDatePickerCalendarElement>>;

package/dist/components/FlintDateRangeCalendar.d.ts

@@ -1,7 +1,19 @@
 import React from 'react';
-import { type EventName } from '@lit/react';
 import { FlintDateRangeCalendar as FlintDateRangeCalendarElement } from '@getufy/flint-ui/date-range-picker/flint-date-range-calendar';
-export declare const FlintDateRangeCalendar: import("@lit/react").ReactWebComponent<FlintDateRangeCalendarElement, {
-    onFlintDateRangePickerSelect: EventName<CustomEvent>;
-}>;
-export type FlintDateRangeCalendarProps = React.ComponentProps<typeof FlintDateRangeCalendar>;
+/**
+ * A dual-month calendar for range selection.
+Shows two months side-by-side (or stacked on narrow screens).
+ */
+export interface FlintDateRangeCalendarProps extends React.HTMLAttributes<FlintDateRangeCalendarElement> {
+    /** Current selected range [startISO, endISO]. */
+    value?: FlintDateRangeCalendarElement['value'];
+    /** Minimum selectable date (ISO YYYY-MM-DD). */
+    min?: string;
+    /** Maximum selectable date (ISO YYYY-MM-DD). */
+    max?: string;
+    /** Disables the calendar and prevents date selection. */
+    disabled?: boolean;
+    /** { detail: { value: DateRange } } on each click */
+    onFlintDateRangePickerSelect?: (event: CustomEvent) => void;
+}
+export declare const FlintDateRangeCalendar: React.ForwardRefExoticComponent<FlintDateRangeCalendarProps & React.RefAttributes<FlintDateRangeCalendarElement>>;

package/dist/components/FlintDateRangePicker.d.ts

@@ -1,7 +1,38 @@
 import React from 'react';
-import { type EventName } from '@lit/react';
 import { FlintDateRangePicker as FlintDateRangePickerElement } from '@getufy/flint-ui/date-range-picker/flint-date-range-picker';
-export declare const FlintDateRangePicker: import("@lit/react").ReactWebComponent<FlintDateRangePickerElement, {
-    onFlintDateRangePickerChange: EventName<CustomEvent>;
-}>;
-export type FlintDateRangePickerProps = React.ComponentProps<typeof FlintDateRangePicker>;
+/**
+ * A date range picker combining a segmented field and a dual-month calendar.
+ */
+export interface FlintDateRangePickerProps extends React.HTMLAttributes<FlintDateRangePickerElement> {
+    /** Selected range [startISO, endISO]. Empty strings mean unset. */
+    value?: FlintDateRangePickerElement['value'];
+    /** Label shown above the field. */
+    label?: string;
+    /** Variant: 'desktop' | 'mobile' | 'static' | 'auto'. */
+    variant?: 'desktop' | 'mobile' | 'static' | 'auto';
+    /** Use a multi-input field (two separate fields) instead of single-input. Currently shows two simple text displays. */
+    multiInput?: boolean;
+    /** Show shortcuts panel. */
+    shortcuts?: boolean;
+    /** Custom shortcuts list. Defaults to built-in shortcuts when shortcuts=true. */
+    shortcutItems?: FlintDateRangePickerElement['shortcutItems'];
+    /** Minimum selectable date (ISO YYYY-MM-DD). */
+    min?: string;
+    /** Maximum selectable date (ISO YYYY-MM-DD). */
+    max?: string;
+    /** Form field name for hidden inputs. */
+    name?: string;
+    /** Disables the picker and prevents interaction. */
+    disabled?: boolean;
+    /** Makes the picker read-only (visible but not editable). */
+    readonly?: boolean;
+    /** Displays the picker in an error state. */
+    error?: boolean;
+    /** Helper text shown below the field. */
+    helperText?: string;
+    /** Error message displayed below the field when in error state. */
+    errorMessage?: string;
+    /** { detail: { value: DateRange } } when range is committed */
+    onFlintDateRangePickerChange?: (event: CustomEvent) => void;
+}
+export declare const FlintDateRangePicker: React.ForwardRefExoticComponent<FlintDateRangePickerProps & React.RefAttributes<FlintDateRangePickerElement>>;

package/dist/components/FlintDesktopTimePicker.d.ts

@@ -1,7 +1,31 @@
 import React from 'react';
-import { type EventName } from '@lit/react';
 import { FlintDesktopTimePicker as FlintDesktopTimePickerElement } from '@getufy/flint-ui/time-picker/flint-time-picker';
-export declare const FlintDesktopTimePicker: import("@lit/react").ReactWebComponent<FlintDesktopTimePickerElement, {
-    onChange: EventName<CustomEvent>;
-}>;
-export type FlintDesktopTimePickerProps = React.ComponentProps<typeof FlintDesktopTimePicker>;
+export interface ChangeDetail {
+    value: string;
+}
+/**
+ * Desktop Time Picker: a time field with a dropdown clock.
+ */
+export interface FlintDesktopTimePickerProps extends Omit<React.HTMLAttributes<FlintDesktopTimePickerElement>, 'onChange'> {
+    /** Time value in HH:MM:SS format. */
+    value?: string;
+    /** Field label text. */
+    label?: string;
+    /** Whether to use 12-hour (AM/PM) format instead of 24-hour. */
+    ampm?: boolean;
+    /** Whether to show a seconds segment. */
+    seconds?: boolean;
+    /** Disables the picker and prevents interaction. */
+    disabled?: boolean;
+    /** Makes the field read-only (visible but not editable). */
+    readonly?: boolean;
+    /** Displays the field in an error state. */
+    error?: boolean;
+    /** Helper text shown below the field. */
+    helperText?: string;
+    /** Error message displayed below the field when in error state. */
+    errorMessage?: string;
+    /** Fired when the time value changes. */
+    onChange?: (event: CustomEvent<ChangeDetail>) => void;
+}
+export declare const FlintDesktopTimePicker: React.ForwardRefExoticComponent<FlintDesktopTimePickerProps & React.RefAttributes<FlintDesktopTimePickerElement>>;

package/dist/components/FlintDialog.d.ts

@@ -1,7 +1,25 @@
 import React from 'react';
-import { type EventName } from '@lit/react';
 import { FlintDialog as FlintDialogElement } from '@getufy/flint-ui/dialog/flint-dialog';
-export declare const FlintDialog: import("@lit/react").ReactWebComponent<FlintDialogElement, {
-    onClose: EventName<CustomEvent>;
-}>;
-export type FlintDialogProps = React.ComponentProps<typeof FlintDialog>;
+export interface CloseDetail {
+    open: boolean;
+}
+/**
+ * flint-dialog: a modal dialog component.
+ *
+ * @slot - Default slot for dialog content (title, content, actions sub-components).
+ */
+export interface FlintDialogProps extends React.HTMLAttributes<FlintDialogElement> {
+    /** Controls the open / closed state of the dialog. */
+    open?: boolean;
+    /** Initial open state for uncontrolled usage. */
+    defaultOpen?: boolean;
+    /** Animation style: 'scale' (default), 'slide-up', or 'slide-down'. */
+    transition?: 'scale' | 'slide-up' | 'slide-down';
+    /** When true, clicking the backdrop will NOT close the dialog. */
+    disableBackdropClose?: boolean;
+    /** Dispatched when the dialog requests to be closed (backdrop click or
+       an explicit call to `requestClose()`). The host is responsible for
+       setting `open = false` in response. detail: `{ open: false }` */
+    onClose?: (event: CustomEvent<CloseDetail>) => void;
+}
+export declare const FlintDialog: React.ForwardRefExoticComponent<FlintDialogProps & React.RefAttributes<FlintDialogElement>>;

package/dist/components/FlintDialogActions.d.ts

@@ -1,4 +1,11 @@
 import React from 'react';
 import { FlintDialogActions as FlintDialogActionsElement } from '@getufy/flint-ui/dialog/flint-dialog';
-export declare const FlintDialogActions: import("@lit/react").ReactWebComponent<FlintDialogActionsElement, {}>;
-export type FlintDialogActionsProps = React.ComponentProps<typeof FlintDialogActions>;
+/**
+ * flint-dialog-actions: footer button row for a dialog.
+Use the `align` prop to control button alignment.
+ */
+export interface FlintDialogActionsProps extends React.HTMLAttributes<FlintDialogActionsElement> {
+    /** Alignment of action buttons: 'end' (default), 'start', 'center', 'space-between'. */
+    align?: 'start' | 'center' | 'end' | 'space-between';
+}
+export declare const FlintDialogActions: React.ForwardRefExoticComponent<FlintDialogActionsProps & React.RefAttributes<FlintDialogActionsElement>>;

package/dist/components/FlintDialogContent.d.ts

@@ -1,4 +1,8 @@
 import React from 'react';
 import { FlintDialogContent as FlintDialogContentElement } from '@getufy/flint-ui/dialog/flint-dialog';
-export declare const FlintDialogContent: import("@lit/react").ReactWebComponent<FlintDialogContentElement, {}>;
-export type FlintDialogContentProps = React.ComponentProps<typeof FlintDialogContent>;
+/**
+ * flint-dialog-content: scrollable content area of a dialog.
+ */
+export interface FlintDialogContentProps extends React.HTMLAttributes<FlintDialogContentElement> {
+}
+export declare const FlintDialogContent: React.ForwardRefExoticComponent<FlintDialogContentProps & React.RefAttributes<FlintDialogContentElement>>;

package/dist/components/FlintDialogContentText.d.ts

@@ -1,4 +1,8 @@
 import React from 'react';
 import { FlintDialogContentText as FlintDialogContentTextElement } from '@getufy/flint-ui/dialog/flint-dialog';
-export declare const FlintDialogContentText: import("@lit/react").ReactWebComponent<FlintDialogContentTextElement, {}>;
-export type FlintDialogContentTextProps = React.ComponentProps<typeof FlintDialogContentText>;
+/**
+ * flint-dialog-content-text: body text inside a dialog content area.
+ */
+export interface FlintDialogContentTextProps extends React.HTMLAttributes<FlintDialogContentTextElement> {
+}
+export declare const FlintDialogContentText: React.ForwardRefExoticComponent<FlintDialogContentTextProps & React.RefAttributes<FlintDialogContentTextElement>>;

package/dist/components/FlintDialogTitle.d.ts

@@ -1,4 +1,9 @@
 import React from 'react';
 import { FlintDialogTitle as FlintDialogTitleElement } from '@getufy/flint-ui/dialog/flint-dialog';
-export declare const FlintDialogTitle: import("@lit/react").ReactWebComponent<FlintDialogTitleElement, {}>;
-export type FlintDialogTitleProps = React.ComponentProps<typeof FlintDialogTitle>;
+/**
+ * flint-dialog-title: heading area of a dialog.
+Automatically assigned id="dialog-title" for aria-labelledby.
+ */
+export interface FlintDialogTitleProps extends React.HTMLAttributes<FlintDialogTitleElement> {
+}
+export declare const FlintDialogTitle: React.ForwardRefExoticComponent<FlintDialogTitleProps & React.RefAttributes<FlintDialogTitleElement>>;

package/dist/components/FlintDigitalClock.d.ts

@@ -1,7 +1,19 @@
 import React from 'react';
-import { type EventName } from '@lit/react';
 import { FlintDigitalClock as FlintDigitalClockElement } from '@getufy/flint-ui/time-picker/flint-time-picker';
-export declare const FlintDigitalClock: import("@lit/react").ReactWebComponent<FlintDigitalClockElement, {
-    onChange: EventName<CustomEvent>;
-}>;
-export type FlintDigitalClockProps = React.ComponentProps<typeof FlintDigitalClock>;
+export interface ChangeDetail {
+    value: string;
+}
+/**
+ * Digital Clock: a scrollable time-slot picker.
+ */
+export interface FlintDigitalClockProps extends Omit<React.HTMLAttributes<FlintDigitalClockElement>, 'onChange'> {
+    /** Time value in HH:MM:SS format. */
+    value?: string;
+    /** Step interval in minutes between selectable times. */
+    step?: number;
+    /** Whether to use 12-hour (AM/PM) format instead of 24-hour. */
+    ampm?: boolean;
+    /** Fired when a time slot is selected. */
+    onChange?: (event: CustomEvent<ChangeDetail>) => void;
+}
+export declare const FlintDigitalClock: React.ForwardRefExoticComponent<FlintDigitalClockProps & React.RefAttributes<FlintDigitalClockElement>>;

package/dist/components/FlintDivider.d.ts

@@ -1,4 +1,18 @@
 import React from 'react';
 import { FlintDivider as FlintDividerElement } from '@getufy/flint-ui/divider/flint-divider';
-export declare const FlintDivider: import("@lit/react").ReactWebComponent<FlintDividerElement, {}>;
-export type FlintDividerProps = React.ComponentProps<typeof FlintDivider>;
+/**
+ * A divider component that provides a thin line for grouping elements.
+ *
+ * @slot - Optional text or content to display within the divider.
+ */
+export interface FlintDividerProps extends React.HTMLAttributes<FlintDividerElement> {
+    /** Orientation of the divider line. */
+    orientation?: 'horizontal' | 'vertical';
+    /** Inset variant controlling how far the divider extends. */
+    variant?: 'full' | 'middle' | 'inset';
+    /** Thickness of the divider line. */
+    weight?: 'light' | 'medium' | 'heavy';
+    /** Alignment of text content within the divider. */
+    textAlign?: 'left' | 'center' | 'right';
+}
+export declare const FlintDivider: React.ForwardRefExoticComponent<FlintDividerProps & React.RefAttributes<FlintDividerElement>>;

package/dist/components/FlintDrawer.d.ts

@@ -1,7 +1,29 @@
 import React from 'react';
-import { type EventName } from '@lit/react';
 import { FlintDrawer as FlintDrawerElement } from '@getufy/flint-ui/drawer/flint-drawer';
-export declare const FlintDrawer: import("@lit/react").ReactWebComponent<FlintDrawerElement, {
-    onFlintDrawerClose: EventName<CustomEvent>;
-}>;
-export type FlintDrawerProps = React.ComponentProps<typeof FlintDrawer>;
+export interface FlintDrawerCloseDetail {
+    open: boolean;
+}
+/**
+ * Navigation drawers provide ergonomic access to destinations in a site or app.
+ *
+ * @slot - Drawer content.
+ */
+export interface FlintDrawerProps extends React.HTMLAttributes<FlintDrawerElement> {
+    /** Whether the drawer is open. */
+    open?: boolean;
+    /** Initial open state for uncontrolled usage. */
+    defaultOpen?: boolean;
+    /** Side from which the drawer slides in. */
+    anchor?: 'left' | 'right' | 'top' | 'bottom';
+    /** Drawer behavior mode. */
+    variant?: 'temporary' | 'persistent' | 'mini';
+    /** Whether the drawer uses edge spacing. */
+    edge?: boolean;
+    /** Whether the drawer is contained within its parent. */
+    container?: boolean;
+    /** Accessible label for the drawer panel (used as aria-label on the panel). */
+    label?: string;
+    /** Dispatched when the drawer requests to be closed (backdrop click or Escape). detail: `{ open: false }` */
+    onFlintDrawerClose?: (event: CustomEvent<FlintDrawerCloseDetail>) => void;
+}
+export declare const FlintDrawer: React.ForwardRefExoticComponent<FlintDrawerProps & React.RefAttributes<FlintDrawerElement>>;

package/dist/components/FlintEmpty.d.ts

@@ -1,4 +1,12 @@
 import React from 'react';
 import { FlintEmpty as FlintEmptyElement } from '@getufy/flint-ui/empty/flint-empty';
-export declare const FlintEmpty: import("@lit/react").ReactWebComponent<FlintEmptyElement, {}>;
-export type FlintEmptyProps = React.ComponentProps<typeof FlintEmpty>;
+/**
+ * Root container for an empty state. Wraps `flint-empty-header` and
+`flint-empty-content` in a vertically centred flex column.
+ *
+ * @slot - Accepts `flint-empty-header`, `flint-empty-content`, and any extra
+  elements (e.g. a "Learn More" link).
+ */
+export interface FlintEmptyProps extends React.HTMLAttributes<FlintEmptyElement> {
+}
+export declare const FlintEmpty: React.ForwardRefExoticComponent<FlintEmptyProps & React.RefAttributes<FlintEmptyElement>>;

package/dist/components/FlintEmptyContent.d.ts

@@ -1,4 +1,10 @@
 import React from 'react';
 import { FlintEmptyContent as FlintEmptyContentElement } from '@getufy/flint-ui/empty/flint-empty';
-export declare const FlintEmptyContent: import("@lit/react").ReactWebComponent<FlintEmptyContentElement, {}>;
-export type FlintEmptyContentProps = React.ComponentProps<typeof FlintEmptyContent>;
+/**
+ * Displays action content for an empty state (buttons, inputs, links).
+ *
+ * @slot - Action elements such as buttons or inputs.
+ */
+export interface FlintEmptyContentProps extends React.HTMLAttributes<FlintEmptyContentElement> {
+}
+export declare const FlintEmptyContent: React.ForwardRefExoticComponent<FlintEmptyContentProps & React.RefAttributes<FlintEmptyContentElement>>;

package/dist/components/FlintEmptyDescription.d.ts

@@ -1,4 +1,10 @@
 import React from 'react';
 import { FlintEmptyDescription as FlintEmptyDescriptionElement } from '@getufy/flint-ui/empty/flint-empty';
-export declare const FlintEmptyDescription: import("@lit/react").ReactWebComponent<FlintEmptyDescriptionElement, {}>;
-export type FlintEmptyDescriptionProps = React.ComponentProps<typeof FlintEmptyDescription>;
+/**
+ * Displays the descriptive text of an empty state.
+ *
+ * @slot - Description text.
+ */
+export interface FlintEmptyDescriptionProps extends React.HTMLAttributes<FlintEmptyDescriptionElement> {
+}
+export declare const FlintEmptyDescription: React.ForwardRefExoticComponent<FlintEmptyDescriptionProps & React.RefAttributes<FlintEmptyDescriptionElement>>;

package/dist/components/FlintEmptyHeader.d.ts

@@ -1,4 +1,10 @@
 import React from 'react';
 import { FlintEmptyHeader as FlintEmptyHeaderElement } from '@getufy/flint-ui/empty/flint-empty';
-export declare const FlintEmptyHeader: import("@lit/react").ReactWebComponent<FlintEmptyHeaderElement, {}>;
-export type FlintEmptyHeaderProps = React.ComponentProps<typeof FlintEmptyHeader>;
+/**
+ * Groups the media, title, and description of an empty state.
+ *
+ * @slot - Accepts `flint-empty-media`, `flint-empty-title`, `flint-empty-description`.
+ */
+export interface FlintEmptyHeaderProps extends React.HTMLAttributes<FlintEmptyHeaderElement> {
+}
+export declare const FlintEmptyHeader: React.ForwardRefExoticComponent<FlintEmptyHeaderProps & React.RefAttributes<FlintEmptyHeaderElement>>;

package/dist/components/FlintEmptyMedia.d.ts

@@ -1,4 +1,12 @@
 import React from 'react';
 import { FlintEmptyMedia as FlintEmptyMediaElement } from '@getufy/flint-ui/empty/flint-empty';
-export declare const FlintEmptyMedia: import("@lit/react").ReactWebComponent<FlintEmptyMediaElement, {}>;
-export type FlintEmptyMediaProps = React.ComponentProps<typeof FlintEmptyMedia>;
+/**
+ * Displays the media area of an empty state (icon, image, or avatar).
+ *
+ * @slot - Media content: icon, image, or avatar elements.
+ */
+export interface FlintEmptyMediaProps extends React.HTMLAttributes<FlintEmptyMediaElement> {
+    /** Visual treatment for the media container. */
+    variant?: 'default' | 'icon';
+}
+export declare const FlintEmptyMedia: React.ForwardRefExoticComponent<FlintEmptyMediaProps & React.RefAttributes<FlintEmptyMediaElement>>;

package/dist/components/FlintEmptyTitle.d.ts

@@ -1,4 +1,10 @@
 import React from 'react';
 import { FlintEmptyTitle as FlintEmptyTitleElement } from '@getufy/flint-ui/empty/flint-empty';
-export declare const FlintEmptyTitle: import("@lit/react").ReactWebComponent<FlintEmptyTitleElement, {}>;
-export type FlintEmptyTitleProps = React.ComponentProps<typeof FlintEmptyTitle>;
+/**
+ * Displays the heading of an empty state.
+ *
+ * @slot - Title text.
+ */
+export interface FlintEmptyTitleProps extends React.HTMLAttributes<FlintEmptyTitleElement> {
+}
+export declare const FlintEmptyTitle: React.ForwardRefExoticComponent<FlintEmptyTitleProps & React.RefAttributes<FlintEmptyTitleElement>>;

package/dist/components/FlintFab.d.ts

@@ -1,4 +1,17 @@
 import React from 'react';
 import { FlintFab as FlintFabElement } from '@getufy/flint-ui/fab/flint-fab';
-export declare const FlintFab: import("@lit/react").ReactWebComponent<FlintFabElement, {}>;
-export type FlintFabProps = React.ComponentProps<typeof FlintFab>;
+/**
+ * A floating action button (FAB) represents the primary action of a screen.
+ *
+ * @slot icon - The icon to display inside the FAB.
+ * @slot - Default slot for icon content (icon-only FAB).
+ * @slot label - The label to display in the extended FAB.
+ */
+export interface FlintFabProps extends React.HTMLAttributes<FlintFabElement> {
+    extended?: boolean;
+    disabled?: boolean;
+    /** Accessible label for icon-only (non-extended) FABs. */
+    label?: string;
+    position?: 'bottom-right' | 'bottom-left' | 'top-right' | 'top-left' | 'static';
+}
+export declare const FlintFab: React.ForwardRefExoticComponent<FlintFabProps & React.RefAttributes<FlintFabElement>>;

package/dist/components/FlintFormatDate.d.ts

@@ -1,4 +1,41 @@
 import React from 'react';
 import { FlintFormatDate as FlintFormatDateElement } from '@getufy/flint-ui/format-date/flint-format-date';
-export declare const FlintFormatDate: import("@lit/react").ReactWebComponent<FlintFormatDateElement, {}>;
-export type FlintFormatDateProps = React.ComponentProps<typeof FlintFormatDate>;
+/**
+ * Formats a date/time using the specified locale and options.
+Localization is handled by the browser's `Intl.DateTimeFormat` API — no language packs required.
+ */
+export interface FlintFormatDateProps extends Omit<React.HTMLAttributes<FlintFormatDateElement>, 'lang'> {
+    /** The date/time to format. Accepts a `Date` object or any string accepted by `new Date()`. */
+    date?: FlintFormatDateElement['date'];
+    /** The format for displaying the weekday. */
+    weekday?: 'narrow' | 'short' | 'long' | undefined;
+    /** The format for displaying the era. */
+    era?: 'narrow' | 'short' | 'long' | undefined;
+    /** The format for displaying the year. */
+    year?: 'numeric' | '2-digit' | undefined;
+    /** The format for displaying the month. */
+    month?: 'numeric' | '2-digit' | 'narrow' | 'short' | 'long' | undefined;
+    /** The format for displaying the day. */
+    day?: 'numeric' | '2-digit' | undefined;
+    /** The format for displaying the hour. */
+    hour?: 'numeric' | '2-digit' | undefined;
+    /** The format for displaying the minute. */
+    minute?: 'numeric' | '2-digit' | undefined;
+    /** The format for displaying the second. */
+    second?: 'numeric' | '2-digit' | undefined;
+    /** The format for displaying the time zone name. */
+    timeZoneName?: 'short' | 'long' | 'shortOffset' | 'longOffset' | 'shortGeneric' | 'longGeneric' | undefined;
+    /** The time zone to express the time in (e.g. "UTC", "America/New_York"). */
+    timeZone?: string | undefined;
+    /** Number of fractional second digits to display (1–3). */
+    fractionalSecondDigits?: 1 | 2 | 3 | undefined;
+    /** Shorthand date format style. Cannot be combined with individual date field props */
+    dateStyle?: 'full' | 'long' | 'medium' | 'short' | undefined;
+    /** Shorthand time format style. Cannot be combined with individual time field props */
+    timeStyle?: 'full' | 'long' | 'medium' | 'short' | undefined;
+    /** The hour format to use. `'auto'` uses the browser/locale default. */
+    hourFormat?: 'auto' | '12' | '24';
+    /** BCP 47 language tag for formatting locale (e.g. "en", "fr", "ru"). Inherits from the document when unset. */
+    lang?: string;
+}
+export declare const FlintFormatDate: React.ForwardRefExoticComponent<FlintFormatDateProps & React.RefAttributes<FlintFormatDateElement>>;