@getufy/flint-ui-react 0.2.1 → 1.0.0

package/dist/components/FlintLink.d.ts

@@ -1,4 +1,29 @@
 import React from 'react';
 import { FlintLink as FlintLinkElement } from '@getufy/flint-ui/link/flint-link';
-export declare const FlintLink: import("@lit/react").ReactWebComponent<FlintLinkElement, {}>;
-export type FlintLinkProps = React.ComponentProps<typeof FlintLink>;
+/**
+ * The Link component allows you to easily customize anchor elements
+with theme colors and typography styles.
+ *
+ * @slot - Link text or content.
+ */
+export interface FlintLinkProps extends Omit<React.HTMLAttributes<FlintLinkElement>, 'color'> {
+    /** The URL of the link. */
+    href?: string;
+    /** Where to open the link. */
+    target?: '_self' | '_blank' | '_parent' | '_top';
+    /** Specifies the relationship of the target object. */
+    rel?: string;
+    /** The color of the link. */
+    color?: FlintLinkElement['color'];
+    /** Controls the underline behavior. */
+    underline?: 'none' | 'hover' | 'always';
+    /** Applies typography variant styles. */
+    variant?: FlintLinkElement['variant'];
+    /** If true, the link is disabled. */
+    disabled?: boolean;
+    /** The download attribute. */
+    download?: string;
+    /** The ARIA label. */
+    label?: string;
+}
+export declare const FlintLink: React.ForwardRefExoticComponent<FlintLinkProps & React.RefAttributes<FlintLinkElement>>;

package/dist/components/FlintList.d.ts

@@ -1,4 +1,12 @@
 import React from 'react';
 import { FlintList as FlintListElement } from '@getufy/flint-ui/list/flint-list';
-export declare const FlintList: import("@lit/react").ReactWebComponent<FlintListElement, {}>;
-export type FlintListProps = React.ComponentProps<typeof FlintList>;
+/**
+ * flint-list: A wrapper for list items.
+ */
+export interface FlintListProps extends React.HTMLAttributes<FlintListElement> {
+    /** Whether to disable the default padding on the list. */
+    disablePadding?: boolean;
+    /** Whether to use compact spacing for list items. */
+    dense?: boolean;
+}
+export declare const FlintList: React.ForwardRefExoticComponent<FlintListProps & React.RefAttributes<FlintListElement>>;

package/dist/components/FlintListItem.d.ts

@@ -1,4 +1,8 @@
 import React from 'react';
 import { FlintListItem as FlintListItemElement } from '@getufy/flint-ui/list/flint-list';
-export declare const FlintListItem: import("@lit/react").ReactWebComponent<FlintListItemElement, {}>;
-export type FlintListItemProps = React.ComponentProps<typeof FlintListItem>;
+/**
+ * flint-list-item: A common list item.
+ */
+export interface FlintListItemProps extends React.HTMLAttributes<FlintListItemElement> {
+}
+export declare const FlintListItem: React.ForwardRefExoticComponent<FlintListItemProps & React.RefAttributes<FlintListItemElement>>;

package/dist/components/FlintListItemAvatar.d.ts

@@ -1,4 +1,8 @@
 import React from 'react';
 import { FlintListItemAvatar as FlintListItemAvatarElement } from '@getufy/flint-ui/list/flint-list';
-export declare const FlintListItemAvatar: import("@lit/react").ReactWebComponent<FlintListItemAvatarElement, {}>;
-export type FlintListItemAvatarProps = React.ComponentProps<typeof FlintListItemAvatar>;
+/**
+ * flint-list-item-avatar: An avatar wrapper inside a list item.
+ */
+export interface FlintListItemAvatarProps extends React.HTMLAttributes<FlintListItemAvatarElement> {
+}
+export declare const FlintListItemAvatar: React.ForwardRefExoticComponent<FlintListItemAvatarProps & React.RefAttributes<FlintListItemAvatarElement>>;

package/dist/components/FlintListItemButton.d.ts

@@ -1,4 +1,12 @@
 import React from 'react';
 import { FlintListItemButton as FlintListItemButtonElement } from '@getufy/flint-ui/list/flint-list';
-export declare const FlintListItemButton: import("@lit/react").ReactWebComponent<FlintListItemButtonElement, {}>;
-export type FlintListItemButtonProps = React.ComponentProps<typeof FlintListItemButton>;
+/**
+ * flint-list-item-button: An action element inside a list item.
+ */
+export interface FlintListItemButtonProps extends React.HTMLAttributes<FlintListItemButtonElement> {
+    /** Whether the list item button is disabled. */
+    disabled?: boolean;
+    /** Whether the list item button is selected. */
+    selected?: boolean;
+}
+export declare const FlintListItemButton: React.ForwardRefExoticComponent<FlintListItemButtonProps & React.RefAttributes<FlintListItemButtonElement>>;

package/dist/components/FlintListItemIcon.d.ts

@@ -1,4 +1,8 @@
 import React from 'react';
 import { FlintListItemIcon as FlintListItemIconElement } from '@getufy/flint-ui/list/flint-list';
-export declare const FlintListItemIcon: import("@lit/react").ReactWebComponent<FlintListItemIconElement, {}>;
-export type FlintListItemIconProps = React.ComponentProps<typeof FlintListItemIcon>;
+/**
+ * flint-list-item-icon: An icon wrapper inside a list item.
+ */
+export interface FlintListItemIconProps extends React.HTMLAttributes<FlintListItemIconElement> {
+}
+export declare const FlintListItemIcon: React.ForwardRefExoticComponent<FlintListItemIconProps & React.RefAttributes<FlintListItemIconElement>>;

package/dist/components/FlintListItemText.d.ts

@@ -1,4 +1,12 @@
 import React from 'react';
 import { FlintListItemText as FlintListItemTextElement } from '@getufy/flint-ui/list/flint-list';
-export declare const FlintListItemText: import("@lit/react").ReactWebComponent<FlintListItemTextElement, {}>;
-export type FlintListItemTextProps = React.ComponentProps<typeof FlintListItemText>;
+/**
+ * flint-list-item-text: A container for text content.
+ */
+export interface FlintListItemTextProps extends React.HTMLAttributes<FlintListItemTextElement> {
+    /** Primary text content of the list item. */
+    primary?: string;
+    /** Secondary text content of the list item. */
+    secondary?: string;
+}
+export declare const FlintListItemText: React.ForwardRefExoticComponent<FlintListItemTextProps & React.RefAttributes<FlintListItemTextElement>>;

package/dist/components/FlintListSubheader.d.ts

@@ -1,4 +1,8 @@
 import React from 'react';
 import { FlintListSubheader as FlintListSubheaderElement } from '@getufy/flint-ui/list/flint-list';
-export declare const FlintListSubheader: import("@lit/react").ReactWebComponent<FlintListSubheaderElement, {}>;
-export type FlintListSubheaderProps = React.ComponentProps<typeof FlintListSubheader>;
+/**
+ * flint-list-subheader: A label for a nested list.
+ */
+export interface FlintListSubheaderProps extends React.HTMLAttributes<FlintListSubheaderElement> {
+}
+export declare const FlintListSubheader: React.ForwardRefExoticComponent<FlintListSubheaderProps & React.RefAttributes<FlintListSubheaderElement>>;

package/dist/components/FlintMenu.d.ts

@@ -1,7 +1,26 @@
 import React from 'react';
-import { type EventName } from '@lit/react';
 import { FlintMenu as FlintMenuElement } from '@getufy/flint-ui/menu/flint-menu';
-export declare const FlintMenu: import("@lit/react").ReactWebComponent<FlintMenuElement, {
-    onFlintMenuClose: EventName<CustomEvent>;
-}>;
-export type FlintMenuProps = React.ComponentProps<typeof FlintMenu>;
+export interface FlintMenuCloseDetail {
+    open: boolean;
+}
+/**
+ * A menu displays a list of choices on a temporary surface.
+Place it as a sibling to its anchor element inside a `position:relative` container.
+ *
+ * @slot - Menu content (flint-menu-item elements).
+ */
+export interface FlintMenuProps extends React.HTMLAttributes<FlintMenuElement> {
+    /** Whether the menu is open/visible. */
+    open?: boolean;
+    /** Menu placement relative to its anchor container. */
+    placement?: string;
+    /** When true, selecting an item automatically fires flint-menu-close. */
+    closeOnSelect?: boolean;
+    /** When true, constrains height to --flint-menu-max-height (default 300px) and enables scrolling. */
+    scrollable?: boolean;
+    /** Accessible label for the menu surface (aria-label on role="menu"). */
+    label?: string;
+    /** Fired when the menu requests to be closed (backdrop click, Escape, or item select). detail: `{ open: false }` */
+    onFlintMenuClose?: (event: CustomEvent<FlintMenuCloseDetail>) => void;
+}
+export declare const FlintMenu: React.ForwardRefExoticComponent<FlintMenuProps & React.RefAttributes<FlintMenuElement>>;

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