@getufy/flint-ui-react 0.2.2 → 1.0.0

package/dist/components/FlintMenuDivider.d.ts

@@ -1,4 +1,8 @@
 import React from 'react';
 import { FlintMenuDivider as FlintMenuDividerElement } from '@getufy/flint-ui/menu/flint-menu';
-export declare const FlintMenuDivider: import("@lit/react").ReactWebComponent<FlintMenuDividerElement, {}>;
-export type FlintMenuDividerProps = React.ComponentProps<typeof FlintMenuDivider>;
+/**
+ * A hairline separator for grouping items in a menu.
+ */
+export interface FlintMenuDividerProps extends React.HTMLAttributes<FlintMenuDividerElement> {
+}
+export declare const FlintMenuDivider: React.ForwardRefExoticComponent<FlintMenuDividerProps & React.RefAttributes<FlintMenuDividerElement>>;

package/dist/components/FlintMenuGroup.d.ts

@@ -1,4 +1,13 @@
 import React from 'react';
 import { FlintMenuGroup as FlintMenuGroupElement } from '@getufy/flint-ui/menu/flint-menu';
-export declare const FlintMenuGroup: import("@lit/react").ReactWebComponent<FlintMenuGroupElement, {}>;
-export type FlintMenuGroupProps = React.ComponentProps<typeof FlintMenuGroup>;
+/**
+ * A labelled group of menu items. Wraps items in a `role="group"` for
+screen-reader announcements.
+ *
+ * @slot - Group items (flint-menu-item elements).
+ */
+export interface FlintMenuGroupProps extends React.HTMLAttributes<FlintMenuGroupElement> {
+    /** Visible heading rendered above the group items. */
+    label?: string;
+}
+export declare const FlintMenuGroup: React.ForwardRefExoticComponent<FlintMenuGroupProps & React.RefAttributes<FlintMenuGroupElement>>;

package/dist/components/FlintMenuItem.d.ts

@@ -1,7 +1,25 @@
 import React from 'react';
-import { type EventName } from '@lit/react';
 import { FlintMenuItem as FlintMenuItemElement } from '@getufy/flint-ui/menu/flint-menu';
-export declare const FlintMenuItem: import("@lit/react").ReactWebComponent<FlintMenuItemElement, {
-    onFlintMenuItemSelect: EventName<CustomEvent>;
-}>;
-export type FlintMenuItemProps = React.ComponentProps<typeof FlintMenuItem>;
+/**
+ * A single option inside a `flint-menu`.
+ *
+ * @slot - Item label text.
+ * @slot icon - Leading icon.
+ * @slot end-icon - Trailing icon or shortcut hint.
+ */
+export interface FlintMenuItemProps extends React.HTMLAttributes<FlintMenuItemElement> {
+    /** Marks this item as the currently selected option. */
+    selected?: boolean;
+    /** Disables the item — it becomes non-interactive. */
+    disabled?: boolean;
+    /** Dense padding mode (for desktop-density menus). */
+    dense?: boolean;
+    /** Renders a hairline separator below this item. */
+    divider?: boolean;
+    /** The machine-readable value carried in the `flint-menu-item-select` event detail. */
+    value?: string;
+    /** Fired when the item is activated.
+detail: { value: string | null, label: string } */
+    onFlintMenuItemSelect?: (event: CustomEvent) => void;
+}
+export declare const FlintMenuItem: React.ForwardRefExoticComponent<FlintMenuItemProps & React.RefAttributes<FlintMenuItemElement>>;

package/dist/components/FlintMenubar.d.ts

@@ -1,4 +1,13 @@
 import React from 'react';
 import { FlintMenubar as FlintMenubarElement } from '@getufy/flint-ui/menubar/flint-menubar';
-export declare const FlintMenubar: import("@lit/react").ReactWebComponent<FlintMenubarElement, {}>;
-export type FlintMenubarProps = React.ComponentProps<typeof FlintMenubar>;
+/**
+ * A visually persistent horizontal menu bar, common in desktop applications.
+Hosts one or more `<flint-menubar-menu>` children.
+ *
+ * @slot - One or more `<flint-menubar-menu>` elements.
+ */
+export interface FlintMenubarProps extends React.HTMLAttributes<FlintMenubarElement> {
+    /** Accessible label for the menubar region. Defaults to "Menu bar". */
+    label?: string;
+}
+export declare const FlintMenubar: React.ForwardRefExoticComponent<FlintMenubarProps & React.RefAttributes<FlintMenubarElement>>;

package/dist/components/FlintMenubarCheckboxItem.d.ts

@@ -1,7 +1,22 @@
 import React from 'react';
-import { type EventName } from '@lit/react';
 import { FlintMenubarCheckboxItem as FlintMenubarCheckboxItemElement } from '@getufy/flint-ui/menubar/flint-menubar';
-export declare const FlintMenubarCheckboxItem: import("@lit/react").ReactWebComponent<FlintMenubarCheckboxItemElement, {
-    onFlintMenubarCheckboxChange: EventName<CustomEvent>;
-}>;
-export type FlintMenubarCheckboxItemProps = React.ComponentProps<typeof FlintMenubarCheckboxItem>;
+export interface FlintMenubarCheckboxChangeDetail {
+    checked: boolean;
+    value: string;
+}
+/**
+ * A toggleable checkbox menu item.
+ */
+export interface FlintMenubarCheckboxItemProps extends React.HTMLAttributes<FlintMenubarCheckboxItemElement> {
+    /** Whether the checkbox item is currently checked. */
+    checked?: boolean;
+    /** Whether the item is non-interactive. */
+    disabled?: boolean;
+    /** Whether the item is visually highlighted (e.g. via keyboard or hover). */
+    highlighted?: boolean;
+    /** Explicit value for the change event. Falls back to label text (excludes shortcut). */
+    value?: string;
+    /** detail: `{ checked: boolean, value: string }` */
+    onFlintMenubarCheckboxChange?: (event: CustomEvent<FlintMenubarCheckboxChangeDetail>) => void;
+}
+export declare const FlintMenubarCheckboxItem: React.ForwardRefExoticComponent<FlintMenubarCheckboxItemProps & React.RefAttributes<FlintMenubarCheckboxItemElement>>;

package/dist/components/FlintMenubarContent.d.ts

@@ -1,7 +1,15 @@
 import React from 'react';
-import { type EventName } from '@lit/react';
 import { FlintMenubarContent as FlintMenubarContentElement } from '@getufy/flint-ui/menubar/flint-menubar';
-export declare const FlintMenubarContent: import("@lit/react").ReactWebComponent<FlintMenubarContentElement, {
-    onFlintMenubarRequestClose: EventName<CustomEvent>;
-}>;
-export type FlintMenubarContentProps = React.ComponentProps<typeof FlintMenubarContent>;
+export interface FlintMenubarRequestCloseDetail {
+    open: boolean;
+}
+/**
+ * The dropdown content panel for a menubar menu.
+Positioned absolutely below the trigger.
+ */
+export interface FlintMenubarContentProps extends React.HTMLAttributes<FlintMenubarContentElement> {
+    /** Whether the content dropdown panel is visible. */
+    open?: boolean;
+    onFlintMenubarRequestClose?: (event: CustomEvent<FlintMenubarRequestCloseDetail>) => void;
+}
+export declare const FlintMenubarContent: React.ForwardRefExoticComponent<FlintMenubarContentProps & React.RefAttributes<FlintMenubarContentElement>>;

package/dist/components/FlintMenubarGroup.d.ts

@@ -1,4 +1,10 @@
 import React from 'react';
 import { FlintMenubarGroup as FlintMenubarGroupElement } from '@getufy/flint-ui/menubar/flint-menubar';
-export declare const FlintMenubarGroup: import("@lit/react").ReactWebComponent<FlintMenubarGroupElement, {}>;
-export type FlintMenubarGroupProps = React.ComponentProps<typeof FlintMenubarGroup>;
+/**
+ * Groups related menu items. Optional `heading` shows a label.
+ */
+export interface FlintMenubarGroupProps extends React.HTMLAttributes<FlintMenubarGroupElement> {
+    /** Label text displayed above the group. */
+    heading?: string;
+}
+export declare const FlintMenubarGroup: React.ForwardRefExoticComponent<FlintMenubarGroupProps & React.RefAttributes<FlintMenubarGroupElement>>;

package/dist/components/FlintMenubarItem.d.ts

@@ -1,7 +1,23 @@
 import React from 'react';
-import { type EventName } from '@lit/react';
 import { FlintMenubarItem as FlintMenubarItemElement } from '@getufy/flint-ui/menubar/flint-menubar';
-export declare const FlintMenubarItem: import("@lit/react").ReactWebComponent<FlintMenubarItemElement, {
-    onFlintMenubarItemSelect: EventName<CustomEvent>;
-}>;
-export type FlintMenubarItemProps = React.ComponentProps<typeof FlintMenubarItem>;
+export interface FlintMenubarItemSelectDetail {
+    value: string;
+}
+/**
+ * A single interactive option inside a menubar dropdown.
+ *
+ * @slot - Item label text plus optional `<flint-menubar-shortcut>`.
+ */
+export interface FlintMenubarItemProps extends React.HTMLAttributes<FlintMenubarItemElement> {
+    /** Whether the item is non-interactive. */
+    disabled?: boolean;
+    /** Whether the item is visually highlighted (e.g. via keyboard or hover). */
+    highlighted?: boolean;
+    /** Whether the item label is inset to align with checkbox/radio items. */
+    inset?: boolean;
+    /** Explicit value for the select event. Falls back to label text (excludes shortcut). */
+    value?: string;
+    /** Fired on activation. detail: `{ value: string }` */
+    onFlintMenubarItemSelect?: (event: CustomEvent<FlintMenubarItemSelectDetail>) => void;
+}
+export declare const FlintMenubarItem: React.ForwardRefExoticComponent<FlintMenubarItemProps & React.RefAttributes<FlintMenubarItemElement>>;

package/dist/components/FlintMenubarMenu.d.ts

@@ -1,4 +1,10 @@
 import React from 'react';
 import { FlintMenubarMenu as FlintMenubarMenuElement } from '@getufy/flint-ui/menubar/flint-menubar';
-export declare const FlintMenubarMenu: import("@lit/react").ReactWebComponent<FlintMenubarMenuElement, {}>;
-export type FlintMenubarMenuProps = React.ComponentProps<typeof FlintMenubarMenu>;
+/**
+ * Wraps a trigger and content pair for a single menu in the menubar.
+ */
+export interface FlintMenubarMenuProps extends React.HTMLAttributes<FlintMenubarMenuElement> {
+    /** Disables this menu: the trigger is non-interactive and keyboard nav skips it. */
+    disabled?: boolean;
+}
+export declare const FlintMenubarMenu: React.ForwardRefExoticComponent<FlintMenubarMenuProps & React.RefAttributes<FlintMenubarMenuElement>>;

package/dist/components/FlintMenubarRadioGroup.d.ts

@@ -1,7 +1,15 @@
 import React from 'react';
-import { type EventName } from '@lit/react';
 import { FlintMenubarRadioGroup as FlintMenubarRadioGroupElement } from '@getufy/flint-ui/menubar/flint-menubar';
-export declare const FlintMenubarRadioGroup: import("@lit/react").ReactWebComponent<FlintMenubarRadioGroupElement, {
-    onFlintMenubarRadioChange: EventName<CustomEvent>;
-}>;
-export type FlintMenubarRadioGroupProps = React.ComponentProps<typeof FlintMenubarRadioGroup>;
+export interface FlintMenubarRadioChangeDetail {
+    value: string;
+}
+/**
+ * Manages single-select radio items.
+ */
+export interface FlintMenubarRadioGroupProps extends React.HTMLAttributes<FlintMenubarRadioGroupElement> {
+    /** The value of the currently selected radio item. */
+    value?: string;
+    /** detail: `{ value: string }` */
+    onFlintMenubarRadioChange?: (event: CustomEvent<FlintMenubarRadioChangeDetail>) => void;
+}
+export declare const FlintMenubarRadioGroup: React.ForwardRefExoticComponent<FlintMenubarRadioGroupProps & React.RefAttributes<FlintMenubarRadioGroupElement>>;

package/dist/components/FlintMenubarRadioItem.d.ts

@@ -1,7 +1,20 @@
 import React from 'react';
-import { type EventName } from '@lit/react';
 import { FlintMenubarRadioItem as FlintMenubarRadioItemElement } from '@getufy/flint-ui/menubar/flint-menubar';
-export declare const FlintMenubarRadioItem: import("@lit/react").ReactWebComponent<FlintMenubarRadioItemElement, {
-    onFlintMenubarRadioSelect: EventName<CustomEvent>;
-}>;
-export type FlintMenubarRadioItemProps = React.ComponentProps<typeof FlintMenubarRadioItem>;
+export interface FlintMenubarRadioSelectDetail {
+    value: string;
+}
+/**
+ * A radio option inside a `<flint-menubar-radio-group>`.
+ */
+export interface FlintMenubarRadioItemProps extends React.HTMLAttributes<FlintMenubarRadioItemElement> {
+    /** Value identifying this radio option within its group. */
+    value?: string;
+    /** Whether this radio item is currently selected. */
+    checked?: boolean;
+    /** Whether the item is non-interactive. */
+    disabled?: boolean;
+    /** Whether the item is visually highlighted (e.g. via keyboard or hover). */
+    highlighted?: boolean;
+    onFlintMenubarRadioSelect?: (event: CustomEvent<FlintMenubarRadioSelectDetail>) => void;
+}
+export declare const FlintMenubarRadioItem: React.ForwardRefExoticComponent<FlintMenubarRadioItemProps & React.RefAttributes<FlintMenubarRadioItemElement>>;

package/dist/components/FlintMenubarSeparator.d.ts

@@ -1,4 +1,8 @@
 import React from 'react';
 import { FlintMenubarSeparator as FlintMenubarSeparatorElement } from '@getufy/flint-ui/menubar/flint-menubar';
-export declare const FlintMenubarSeparator: import("@lit/react").ReactWebComponent<FlintMenubarSeparatorElement, {}>;
-export type FlintMenubarSeparatorProps = React.ComponentProps<typeof FlintMenubarSeparator>;
+/**
+ * A hairline separator between menu groups.
+ */
+export interface FlintMenubarSeparatorProps extends React.HTMLAttributes<FlintMenubarSeparatorElement> {
+}
+export declare const FlintMenubarSeparator: React.ForwardRefExoticComponent<FlintMenubarSeparatorProps & React.RefAttributes<FlintMenubarSeparatorElement>>;

package/dist/components/FlintMenubarShortcut.d.ts

@@ -1,4 +1,10 @@
 import React from 'react';
 import { FlintMenubarShortcut as FlintMenubarShortcutElement } from '@getufy/flint-ui/menubar/flint-menubar';
-export declare const FlintMenubarShortcut: import("@lit/react").ReactWebComponent<FlintMenubarShortcutElement, {}>;
-export type FlintMenubarShortcutProps = React.ComponentProps<typeof FlintMenubarShortcut>;
+/**
+ * Displays a keyboard shortcut hint inside a menu item.
+ *
+ * @slot - Shortcut text, e.g. `⌘T` or `Ctrl+N`.
+ */
+export interface FlintMenubarShortcutProps extends React.HTMLAttributes<FlintMenubarShortcutElement> {
+}
+export declare const FlintMenubarShortcut: React.ForwardRefExoticComponent<FlintMenubarShortcutProps & React.RefAttributes<FlintMenubarShortcutElement>>;

package/dist/components/FlintMenubarSub.d.ts

@@ -1,4 +1,9 @@
 import React from 'react';
 import { FlintMenubarSub as FlintMenubarSubElement } from '@getufy/flint-ui/menubar/flint-menubar';
-export declare const FlintMenubarSub: import("@lit/react").ReactWebComponent<FlintMenubarSubElement, {}>;
-export type FlintMenubarSubProps = React.ComponentProps<typeof FlintMenubarSub>;
+/**
+ * Wraps a sub-trigger and sub-content pair.
+Opens on hover/focus and ArrowRight; closes on ArrowLeft or blur.
+ */
+export interface FlintMenubarSubProps extends React.HTMLAttributes<FlintMenubarSubElement> {
+}
+export declare const FlintMenubarSub: React.ForwardRefExoticComponent<FlintMenubarSubProps & React.RefAttributes<FlintMenubarSubElement>>;

package/dist/components/FlintMenubarSubContent.d.ts

@@ -1,4 +1,11 @@
 import React from 'react';
 import { FlintMenubarSubContent as FlintMenubarSubContentElement } from '@getufy/flint-ui/menubar/flint-menubar';
-export declare const FlintMenubarSubContent: import("@lit/react").ReactWebComponent<FlintMenubarSubContentElement, {}>;
-export type FlintMenubarSubContentProps = React.ComponentProps<typeof FlintMenubarSubContent>;
+/**
+ * The dropdown panel of a sub-menu. Positioned to the right of the trigger.
+Auto-flips left when the panel would overflow the viewport edge.
+ */
+export interface FlintMenubarSubContentProps extends React.HTMLAttributes<FlintMenubarSubContentElement> {
+    /** Whether the sub-menu dropdown panel is visible. */
+    open?: boolean;
+}
+export declare const FlintMenubarSubContent: React.ForwardRefExoticComponent<FlintMenubarSubContentProps & React.RefAttributes<FlintMenubarSubContentElement>>;

package/dist/components/FlintMenubarSubTrigger.d.ts

@@ -1,4 +1,16 @@
 import React from 'react';
 import { FlintMenubarSubTrigger as FlintMenubarSubTriggerElement } from '@getufy/flint-ui/menubar/flint-menubar';
-export declare const FlintMenubarSubTrigger: import("@lit/react").ReactWebComponent<FlintMenubarSubTriggerElement, {}>;
-export type FlintMenubarSubTriggerProps = React.ComponentProps<typeof FlintMenubarSubTrigger>;
+/**
+ * Trigger for a sub-menu. Shows an arrow indicator.
+ */
+export interface FlintMenubarSubTriggerProps extends React.HTMLAttributes<FlintMenubarSubTriggerElement> {
+    /** Whether the trigger is visually highlighted (e.g. via keyboard or hover). */
+    highlighted?: boolean;
+    /** Whether the trigger is non-interactive. */
+    disabled?: boolean;
+    /** Whether the trigger label is inset to align with checkbox/radio items. */
+    inset?: boolean;
+    /** Set by the parent `flint-menubar-sub` to reflect open state for aria-expanded. */
+    expanded?: boolean;
+}
+export declare const FlintMenubarSubTrigger: React.ForwardRefExoticComponent<FlintMenubarSubTriggerProps & React.RefAttributes<FlintMenubarSubTriggerElement>>;

package/dist/components/FlintMenubarTrigger.d.ts

@@ -1,4 +1,14 @@
 import React from 'react';
 import { FlintMenubarTrigger as FlintMenubarTriggerElement } from '@getufy/flint-ui/menubar/flint-menubar';
-export declare const FlintMenubarTrigger: import("@lit/react").ReactWebComponent<FlintMenubarTriggerElement, {}>;
-export type FlintMenubarTriggerProps = React.ComponentProps<typeof FlintMenubarTrigger>;
+/**
+ * The trigger button for a menubar menu.
+ *
+ * @slot - Trigger label text.
+ */
+export interface FlintMenubarTriggerProps extends React.HTMLAttributes<FlintMenubarTriggerElement> {
+    /** Whether the trigger's associated menu is currently open. */
+    active?: boolean;
+    /** Whether the trigger is non-interactive. */
+    disabled?: boolean;
+}
+export declare const FlintMenubarTrigger: React.ForwardRefExoticComponent<FlintMenubarTriggerProps & React.RefAttributes<FlintMenubarTriggerElement>>;

package/dist/components/FlintMobileStepper.d.ts

@@ -1,4 +1,23 @@
 import React from 'react';
 import { FlintMobileStepper as FlintMobileStepperElement } from '@getufy/flint-ui/stepper/flint-stepper';
-export declare const FlintMobileStepper: import("@lit/react").ReactWebComponent<FlintMobileStepperElement, {}>;
-export type FlintMobileStepperProps = React.ComponentProps<typeof FlintMobileStepper>;
+/**
+ * Mobile Stepper: a compact stepper for mobile layouts.
+ *
+ * @slot back-button - Back navigation button.
+ * @slot next-button - Next navigation button.
+ */
+export interface FlintMobileStepperProps extends React.HTMLAttributes<FlintMobileStepperElement> {
+    /** Total number of steps. */
+    steps?: number;
+    /** Zero-based index of the currently active step. */
+    activeStep?: number;
+    /** Progress indicator style: text counter, dot indicators, or a progress bar. */
+    variant?: 'text' | 'dots' | 'progress';
+    /** Positioning of the mobile stepper within its container. */
+    position?: 'top' | 'bottom' | 'static';
+    /** Label text for the Back navigation button (supports i18n). */
+    backLabel?: string;
+    /** Label text for the Next navigation button (supports i18n). */
+    nextLabel?: string;
+}
+export declare const FlintMobileStepper: React.ForwardRefExoticComponent<FlintMobileStepperProps & React.RefAttributes<FlintMobileStepperElement>>;

package/dist/components/FlintMobileTimePicker.d.ts

@@ -1,7 +1,26 @@
 import React from 'react';
-import { type EventName } from '@lit/react';
 import { FlintMobileTimePicker as FlintMobileTimePickerElement } from '@getufy/flint-ui/time-picker/flint-time-picker';
-export declare const FlintMobileTimePicker: import("@lit/react").ReactWebComponent<FlintMobileTimePickerElement, {
-    onChange: EventName<CustomEvent>;
-}>;
-export type FlintMobileTimePickerProps = React.ComponentProps<typeof FlintMobileTimePicker>;
+/**
+ * Mobile Time Picker: a time field with a modal clock dialog.
+ */
+export interface FlintMobileTimePickerProps extends Omit<React.HTMLAttributes<FlintMobileTimePickerElement>, '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;
+    /** 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;
+    /** Fired when the time value changes. */
+    onChange?: (event: CustomEvent) => void;
+}
+export declare const FlintMobileTimePicker: React.ForwardRefExoticComponent<FlintMobileTimePickerProps & React.RefAttributes<FlintMobileTimePickerElement>>;

package/dist/components/FlintMultiSectionDigitalClock.d.ts

@@ -1,7 +1,19 @@
 import React from 'react';
-import { type EventName } from '@lit/react';
 import { FlintMultiSectionDigitalClock as FlintMultiSectionDigitalClockElement } from '@getufy/flint-ui/time-picker/flint-time-picker';
-export declare const FlintMultiSectionDigitalClock: import("@lit/react").ReactWebComponent<FlintMultiSectionDigitalClockElement, {
-    onChange: EventName<CustomEvent>;
-}>;
-export type FlintMultiSectionDigitalClockProps = React.ComponentProps<typeof FlintMultiSectionDigitalClock>;
+export interface ChangeDetail {
+    value: string;
+}
+/**
+ * Multi Section Digital Clock: hours, minutes, and optional seconds columns.
+ */
+export interface FlintMultiSectionDigitalClockProps extends Omit<React.HTMLAttributes<FlintMultiSectionDigitalClockElement>, 'onChange'> {
+    /** Time value in HH:MM:SS format. */
+    value?: string;
+    /** Whether to use 12-hour (AM/PM) format instead of 24-hour. */
+    ampm?: boolean;
+    /** Whether to show a seconds column. */
+    seconds?: boolean;
+    /** Fired when the time value changes. */
+    onChange?: (event: CustomEvent<ChangeDetail>) => void;
+}
+export declare const FlintMultiSectionDigitalClock: React.ForwardRefExoticComponent<FlintMultiSectionDigitalClockProps & React.RefAttributes<FlintMultiSectionDigitalClockElement>>;

package/dist/components/FlintNavigationMenu.d.ts

@@ -1,4 +1,10 @@
 import React from 'react';
 import { FlintNavigationMenu as FlintNavigationMenuElement } from '@getufy/flint-ui/navigation-menu/flint-navigation-menu';
-export declare const FlintNavigationMenu: import("@lit/react").ReactWebComponent<FlintNavigationMenuElement, {}>;
-export type FlintNavigationMenuProps = React.ComponentProps<typeof FlintNavigationMenu>;
+/**
+ * @slot default - The menu content (NavigationMenuList)
+ */
+export interface FlintNavigationMenuProps extends Omit<React.HTMLAttributes<FlintNavigationMenuElement>, 'dir'> {
+    /** The direction of the menu (ltr or rtl) */
+    dir?: 'ltr' | 'rtl';
+}
+export declare const FlintNavigationMenu: React.ForwardRefExoticComponent<FlintNavigationMenuProps & React.RefAttributes<FlintNavigationMenuElement>>;

package/dist/components/FlintNavigationMenuContent.d.ts

@@ -1,7 +1,22 @@
 import React from 'react';
-import { type EventName } from '@lit/react';
 import { FlintNavigationMenuContent as FlintNavigationMenuContentElement } from '@getufy/flint-ui/navigation-menu/flint-navigation-menu-content';
-export declare const FlintNavigationMenuContent: import("@lit/react").ReactWebComponent<FlintNavigationMenuContentElement, {
-    onFlintNavigationMenuContentToggle: EventName<CustomEvent>;
-}>;
-export type FlintNavigationMenuContentProps = React.ComponentProps<typeof FlintNavigationMenuContent>;
+export interface FlintNavigationMenuContentToggleDetail {
+    contentId: string;
+    open: boolean;
+}
+/**
+ * @slot default - Menu content items
+ */
+export interface FlintNavigationMenuContentProps extends Omit<React.HTMLAttributes<FlintNavigationMenuContentElement>, 'id' | 'dir'> {
+    /** Unique identifier for this content panel */
+    id?: string;
+    /** Whether the content is open/visible */
+    open?: boolean;
+    /** The direction (ltr or rtl) */
+    dir?: 'ltr' | 'rtl';
+    /** Gap between items in the content */
+    gap?: number;
+    /** Fired when the content panel opens or closes. */
+    onFlintNavigationMenuContentToggle?: (event: CustomEvent<FlintNavigationMenuContentToggleDetail>) => void;
+}
+export declare const FlintNavigationMenuContent: React.ForwardRefExoticComponent<FlintNavigationMenuContentProps & React.RefAttributes<FlintNavigationMenuContentElement>>;

package/dist/components/FlintNavigationMenuItem.d.ts

@@ -1,8 +1,20 @@
 import React from 'react';
-import { type EventName } from '@lit/react';
 import { FlintNavigationMenuItem as FlintNavigationMenuItemElement } from '@getufy/flint-ui/navigation-menu/flint-navigation-menu-item';
-export declare const FlintNavigationMenuItem: import("@lit/react").ReactWebComponent<FlintNavigationMenuItemElement, {
-    onFlintNavigationMenuTriggerClick: EventName<CustomEvent>;
-    onFlintNavigationMenuContentToggle: EventName<CustomEvent>;
-}>;
-export type FlintNavigationMenuItemProps = React.ComponentProps<typeof FlintNavigationMenuItem>;
+/**
+ * @slot default - Item content (NavigationMenuTrigger and NavigationMenuContent)
+ */
+export interface FlintNavigationMenuItemProps extends React.HTMLAttributes<FlintNavigationMenuItemElement> {
+    /** Unique identifier for this menu item */
+    itemId?: string;
+    /** Whether this item is disabled */
+    disabled?: boolean;
+    /** Delay in ms before opening on hover */
+    openDelay?: number;
+    /** Delay in ms before closing after mouse leaves */
+    closeDelay?: number;
+    /** Fired when the item's trigger is clicked. */
+    onFlintNavigationMenuTriggerClick?: (event: CustomEvent) => void;
+    /** Fired when content visibility changes. */
+    onFlintNavigationMenuContentToggle?: (event: CustomEvent) => void;
+}
+export declare const FlintNavigationMenuItem: React.ForwardRefExoticComponent<FlintNavigationMenuItemProps & React.RefAttributes<FlintNavigationMenuItemElement>>;

package/dist/components/FlintNavigationMenuLink.d.ts

@@ -1,4 +1,18 @@
 import React from 'react';
 import { FlintNavigationMenuLink as FlintNavigationMenuLinkElement } from '@getufy/flint-ui/navigation-menu/flint-navigation-menu-link';
-export declare const FlintNavigationMenuLink: import("@lit/react").ReactWebComponent<FlintNavigationMenuLinkElement, {}>;
-export type FlintNavigationMenuLinkProps = React.ComponentProps<typeof FlintNavigationMenuLink>;
+/**
+ * @slot default - Link text/content
+ */
+export interface FlintNavigationMenuLinkProps extends Omit<React.HTMLAttributes<FlintNavigationMenuLinkElement>, 'title'> {
+    /** The link URL */
+    href?: string;
+    /** The link target (e.g., '_blank') */
+    target?: string;
+    /** Link title/tooltip */
+    title?: string;
+    /** Whether the link is disabled */
+    disabled?: boolean;
+    /** Whether this link represents the current page. */
+    active?: boolean;
+}
+export declare const FlintNavigationMenuLink: React.ForwardRefExoticComponent<FlintNavigationMenuLinkProps & React.RefAttributes<FlintNavigationMenuLinkElement>>;

package/dist/components/FlintNavigationMenuList.d.ts

@@ -1,4 +1,14 @@
 import React from 'react';
 import { FlintNavigationMenuList as FlintNavigationMenuListElement } from '@getufy/flint-ui/navigation-menu/flint-navigation-menu-list';
-export declare const FlintNavigationMenuList: import("@lit/react").ReactWebComponent<FlintNavigationMenuListElement, {}>;
-export type FlintNavigationMenuListProps = React.ComponentProps<typeof FlintNavigationMenuList>;
+/**
+ * @slot default - Menu items (NavigationMenuItem elements)
+ */
+export interface FlintNavigationMenuListProps extends React.HTMLAttributes<FlintNavigationMenuListElement> {
+    /** Gap between menu items */
+    gap?: number;
+    /** Flex direction for the list */
+    direction?: 'row' | 'column';
+    /** Accessible label for the navigation landmark. */
+    ariaLabel?: string;
+}
+export declare const FlintNavigationMenuList: React.ForwardRefExoticComponent<FlintNavigationMenuListProps & React.RefAttributes<FlintNavigationMenuListElement>>;

package/dist/components/FlintNavigationMenuTrigger.d.ts

@@ -1,7 +1,14 @@
 import React from 'react';
-import { type EventName } from '@lit/react';
 import { FlintNavigationMenuTrigger as FlintNavigationMenuTriggerElement } from '@getufy/flint-ui/navigation-menu/flint-navigation-menu-trigger';
-export declare const FlintNavigationMenuTrigger: import("@lit/react").ReactWebComponent<FlintNavigationMenuTriggerElement, {
-    onFlintNavigationMenuTriggerClick: EventName<CustomEvent>;
-}>;
-export type FlintNavigationMenuTriggerProps = React.ComponentProps<typeof FlintNavigationMenuTrigger>;
+/**
+ * @slot default - Trigger label/content
+ */
+export interface FlintNavigationMenuTriggerProps extends React.HTMLAttributes<FlintNavigationMenuTriggerElement> {
+    /** The ID of the associated content element */
+    contentId?: string;
+    /** Whether the trigger is disabled */
+    disabled?: boolean;
+    /** Fired when trigger is clicked */
+    onFlintNavigationMenuTriggerClick?: (event: CustomEvent) => void;
+}
+export declare const FlintNavigationMenuTrigger: React.ForwardRefExoticComponent<FlintNavigationMenuTriggerProps & React.RefAttributes<FlintNavigationMenuTriggerElement>>;

package/dist/components/FlintPagination.d.ts

@@ -1,7 +1,50 @@
 import React from 'react';
-import { type EventName } from '@lit/react';
 import { FlintPagination as FlintPaginationElement } from '@getufy/flint-ui/pagination/flint-pagination';
-export declare const FlintPagination: import("@lit/react").ReactWebComponent<FlintPaginationElement, {
-    onFlintPaginationChange: EventName<CustomEvent>;
-}>;
-export type FlintPaginationProps = React.ComponentProps<typeof FlintPagination>;
+export interface FlintPaginationChangeDetail {
+    page: number;
+}
+/**
+ * Pagination component enabling the user to select a specific page from
+a range of pages.
+ *
+ * @slot prev-icon - Icon for the previous button (default: chevron left SVG).
+ * @slot next-icon - Icon for the next button (default: chevron right SVG).
+ * @slot first-icon - Icon for the first button (default: skip-to-start SVG).
+ * @slot last-icon - Icon for the last button (default: skip-to-end SVG).
+ * @slot ellipsis-icon - Icon for ellipsis items (default: three-dot SVG).
+ */
+export interface FlintPaginationProps extends Omit<React.HTMLAttributes<FlintPaginationElement>, 'color'> {
+    /** Total number of pages. */
+    count?: number;
+    /** The current page (1-based). In controlled mode, update this from the flint-pagination-change event. */
+    page?: number;
+    /** Initial page for uncontrolled mode. Ignored after first render. */
+    defaultPage?: number;
+    /** Accessible label for the nav landmark (aria-label). */
+    label?: string;
+    /** Variant. */
+    variant?: 'text' | 'outlined';
+    /** Shape. */
+    shape?: 'circular' | 'rounded' | 'square';
+    /** Size. */
+    size?: 'small' | 'medium' | 'large';
+    /** Color. */
+    color?: 'primary' | 'secondary' | 'standard';
+    /** Show first-page button. */
+    showFirstButton?: boolean;
+    /** Show last-page button. */
+    showLastButton?: boolean;
+    /** Hide previous button. */
+    hidePrevButton?: boolean;
+    /** Hide next button. */
+    hideNextButton?: boolean;
+    /** Number of sibling pages around the current page. */
+    siblingCount?: number;
+    /** Number of pages always shown at start and end. */
+    boundaryCount?: number;
+    /** Disable the whole component. */
+    disabled?: boolean;
+    /** { page: number } when the active page changes. */
+    onFlintPaginationChange?: (event: CustomEvent<FlintPaginationChangeDetail>) => void;
+}
+export declare const FlintPagination: React.ForwardRefExoticComponent<FlintPaginationProps & React.RefAttributes<FlintPaginationElement>>;

package/dist/components/FlintPaper.d.ts

@@ -1,4 +1,15 @@
 import React from 'react';
 import { FlintPaper as FlintPaperElement } from '@getufy/flint-ui/paper/flint-paper';
-export declare const FlintPaper: import("@lit/react").ReactWebComponent<FlintPaperElement, {}>;
-export type FlintPaperProps = React.ComponentProps<typeof FlintPaper>;
+/**
+ * The Paper component is a container for displaying content on an elevated surface.
+Shadow styles are influenced by real-world physical counterparts.
+ */
+export interface FlintPaperProps extends React.HTMLAttributes<FlintPaperElement> {
+    /** Shadow depth. Supported values: 0, 1, 2, 3, 4, 6, 8, 12, 16, 24. */
+    elevation?: number;
+    /** If true, the paper will have square corners (border-radius: 0). */
+    square?: boolean;
+    /** Visual variant. */
+    variant?: 'elevated' | 'outlined' | 'flat';
+}
+export declare const FlintPaper: React.ForwardRefExoticComponent<FlintPaperProps & React.RefAttributes<FlintPaperElement>>;