@getufy/flint-ui-react 0.2.2 → 1.0.0

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>>;

package/dist/components/FlintFormatNumber.d.ts

@@ -1,4 +1,41 @@
 import React from 'react';
 import { FlintFormatNumber as FlintFormatNumberElement } from '@getufy/flint-ui/format-number/flint-format-number';
-export declare const FlintFormatNumber: import("@lit/react").ReactWebComponent<FlintFormatNumberElement, {}>;
-export type FlintFormatNumberProps = React.ComponentProps<typeof FlintFormatNumber>;
+/**
+ * Formats a number using the specified locale and options.
+Localization is handled by the browser's `Intl.NumberFormat` API — no language packs required.
+ */
+export interface FlintFormatNumberProps extends Omit<React.HTMLAttributes<FlintFormatNumberElement>, 'lang'> {
+    /** The number to format. */
+    value?: number;
+    /** The formatting style to use. */
+    type?: 'currency' | 'decimal' | 'percent' | 'unit';
+    /** Turns off grouping separators (e.g. thousands separator). */
+    noGrouping?: boolean;
+    /** The ISO 4217 currency code to use when formatting (e.g. 'USD', 'EUR', 'GBP'). */
+    currency?: string;
+    /** How to display the currency. */
+    currencyDisplay?: 'symbol' | 'narrowSymbol' | 'code' | 'name';
+    /** Number notation style. 'compact' renders e.g. "1.2K" or "3.4M". */
+    notation?: 'standard' | 'scientific' | 'engineering' | 'compact';
+    /** How to display compact notation — 'short' (1K) or 'long' (1 thousand). */
+    compactDisplay?: 'short' | 'long';
+    /** When to show the sign. */
+    signDisplay?: 'auto' | 'never' | 'always' | 'exceptZero';
+    /** ECMA-402 unit identifier (e.g. 'kilometer', 'kilogram', 'celsius'). Required when type='unit'. */
+    unit?: string;
+    /** How to display the unit when type='unit'. */
+    unitDisplay?: 'short' | 'long' | 'narrow';
+    /** The minimum number of integer digits (1–21). */
+    minimumIntegerDigits?: number | undefined;
+    /** The minimum number of fraction digits (0–20). */
+    minimumFractionDigits?: number | undefined;
+    /** The maximum number of fraction digits (0–20). */
+    maximumFractionDigits?: number | undefined;
+    /** The minimum number of significant digits (1–21). */
+    minimumSignificantDigits?: number | undefined;
+    /** The maximum number of significant digits (1–21). */
+    maximumSignificantDigits?: number | undefined;
+    /** BCP 47 language tag for formatting locale. Inherits from the document when unset. */
+    lang?: string;
+}
+export declare const FlintFormatNumber: React.ForwardRefExoticComponent<FlintFormatNumberProps & React.RefAttributes<FlintFormatNumberElement>>;

package/dist/components/FlintGrid.d.ts

@@ -1,4 +1,37 @@
 import React from 'react';
 import { FlintGrid as FlintGridElement } from '@getufy/flint-ui/grid/flint-grid';
-export declare const FlintGrid: import("@lit/react").ReactWebComponent<FlintGridElement, {}>;
-export type FlintGridProps = React.ComponentProps<typeof FlintGrid>;
+export interface FlintGridProps extends React.HTMLAttributes<FlintGridElement> {
+    /** Whether this element acts as a grid container. */
+    container?: boolean;
+    /** Flex direction of the grid container. */
+    direction?: 'row' | 'row-reverse' | 'column' | 'column-reverse';
+    /** Flex wrap behavior of the grid container. */
+    wrap?: 'nowrap' | 'wrap' | 'wrap-reverse';
+    /** Cross-axis alignment of grid items. */
+    alignItems?: 'flex-start' | 'center' | 'flex-end' | 'stretch' | 'baseline';
+    /** Main-axis alignment of grid items. */
+    justifyContent?: 'flex-start' | 'center' | 'flex-end' | 'space-between' | 'space-around' | 'space-evenly';
+    /** Total number of columns. Default is 12. */
+    columns?: number;
+    /** Spacing between items. 1 unit = 8px. */
+    spacing?: FlintGridElement['spacing'];
+    /** Row spacing override; takes precedence over `spacing` for the row axis. */
+    rowSpacing?: FlintGridElement['rowSpacing'];
+    /** Column spacing override; takes precedence over `spacing` for the column axis. */
+    columnSpacing?: FlintGridElement['columnSpacing'];
+    /** Number of columns to span at the xs breakpoint. */
+    xs?: FlintGridElement['xs'];
+    /** Number of columns to span at the sm breakpoint. */
+    sm?: FlintGridElement['sm'];
+    /** Number of columns to span at the md breakpoint. */
+    md?: FlintGridElement['md'];
+    /** Number of columns to span at the lg breakpoint. */
+    lg?: FlintGridElement['lg'];
+    /** Number of columns to span at the xl breakpoint. */
+    xl?: FlintGridElement['xl'];
+    /** Offset per breakpoint, expressed in column units or 'auto'. */
+    offset?: FlintGridElement['offset'];
+    /** Flex order. Supports responsive values so items can be reordered at */
+    order?: FlintGridElement['order'];
+}
+export declare const FlintGrid: React.ForwardRefExoticComponent<FlintGridProps & React.RefAttributes<FlintGridElement>>;

package/dist/components/FlintHoverCard.d.ts

@@ -1,4 +1,15 @@
 import React from 'react';
 import { FlintHoverCard as FlintHoverCardElement } from '@getufy/flint-ui/hover-card/flint-hover-card';
-export declare const FlintHoverCard: import("@lit/react").ReactWebComponent<FlintHoverCardElement, {}>;
-export type FlintHoverCardProps = React.ComponentProps<typeof FlintHoverCard>;
+/**
+ * Root container for a hover card.
+Manages open/closed state with configurable open and close delays.
+ *
+ * @slot - Accepts `flint-hover-card-trigger` and `flint-hover-card-content`.
+ */
+export interface FlintHoverCardProps extends React.HTMLAttributes<FlintHoverCardElement> {
+    /** Delay in milliseconds before the hover card opens. */
+    openDelay?: number;
+    /** Delay in milliseconds before the hover card closes. */
+    closeDelay?: number;
+}
+export declare const FlintHoverCard: React.ForwardRefExoticComponent<FlintHoverCardProps & React.RefAttributes<FlintHoverCardElement>>;

package/dist/components/FlintHoverCardContent.d.ts

@@ -1,4 +1,17 @@
 import React from 'react';
 import { FlintHoverCardContent as FlintHoverCardContentElement } from '@getufy/flint-ui/hover-card/flint-hover-card';
-export declare const FlintHoverCardContent: import("@lit/react").ReactWebComponent<FlintHoverCardContentElement, {}>;
-export type FlintHoverCardContentProps = React.ComponentProps<typeof FlintHoverCardContent>;
+/**
+ * The floating card panel. Position is controlled via `side` and `align`.
+Place inside `flint-hover-card`; its `open` state is managed by the parent.
+ *
+ * @slot - Rich content displayed inside the card.
+ */
+export interface FlintHoverCardContentProps extends React.HTMLAttributes<FlintHoverCardContentElement> {
+    /** Which side of the trigger to display the card on. */
+    side?: 'top' | 'right' | 'bottom' | 'left';
+    /** Alignment of the card along the cross axis relative to the trigger. */
+    align?: 'start' | 'center' | 'end';
+    /** Whether the card is visible. Managed by the parent `flint-hover-card`. */
+    open?: boolean;
+}
+export declare const FlintHoverCardContent: React.ForwardRefExoticComponent<FlintHoverCardContentProps & React.RefAttributes<FlintHoverCardContentElement>>;

package/dist/components/FlintHoverCardTrigger.d.ts

@@ -1,4 +1,11 @@
 import React from 'react';
 import { FlintHoverCardTrigger as FlintHoverCardTriggerElement } from '@getufy/flint-ui/hover-card/flint-hover-card';
-export declare const FlintHoverCardTrigger: import("@lit/react").ReactWebComponent<FlintHoverCardTriggerElement, {}>;
-export type FlintHoverCardTriggerProps = React.ComponentProps<typeof FlintHoverCardTrigger>;
+/**
+ * Trigger element for a hover card. Place inside `flint-hover-card`.
+Automatically wires up to the nearest `flint-hover-card` ancestor.
+ *
+ * @slot - The element that activates the hover card (link, button, avatar…).
+ */
+export interface FlintHoverCardTriggerProps extends React.HTMLAttributes<FlintHoverCardTriggerElement> {
+}
+export declare const FlintHoverCardTrigger: React.ForwardRefExoticComponent<FlintHoverCardTriggerProps & React.RefAttributes<FlintHoverCardTriggerElement>>;