@particle-academy/react-fancy 4.12.1 → 4.13.0

package/dist/index.d.cts

@@ -2622,6 +2622,271 @@ declare const TreeNav: typeof TreeNavRoot & {
 
 declare function useTreeNav(): TreeNavContextValue;
 
+/** Entry kind — regular file or directory. */
+type FileKind = "file" | "dir";
+/**
+ * A single file-system entry. JSON-friendly by design so agents and remote
+ * hosts can emit entries directly (over MCP, a relay, or a WebSocket).
+ * `path` is the stable identity — POSIX-style, never an index.
+ */
+interface FileEntry {
+    /** Stable identity — POSIX-style path (e.g. `"/src/App.tsx"`). */
+    path: string;
+    /** Display name (usually the last path segment). */
+    name: string;
+    /** `"file"` or `"dir"`. */
+    kind: FileKind;
+    /** Size in bytes (optional; shown for files and used by size sorting). */
+    size?: number;
+    /** Last-modified timestamp, ISO 8601 (optional; used by mtime sorting). */
+    mtime?: string;
+    /**
+     * Dirs only: `false` = known-empty (no expand affordance), `true` = has
+     * children, `undefined` = unknown (expandable when a provider is present).
+     */
+    hasChildren?: boolean;
+    /** Disabled entries render dimmed and cannot be selected, expanded, or navigated into. */
+    disabled?: boolean;
+}
+/**
+ * JSON-friendly snapshot node — a {@link FileEntry} plus optionally
+ * materialized children. `children: undefined` on a dir = unknown depth (a
+ * provider fills it lazily in hybrid mode); `children: []` = known-empty.
+ */
+interface FileSnapshotNode extends FileEntry {
+    children?: FileSnapshotNode[];
+}
+/** Async data source for provider mode. Works against local FS, HTTP, MCP bridges, SSH adapters — anything that resolves a listing. */
+interface FileBrowserProvider {
+    /**
+     * Load the direct children of `path`. Called lazily — only for the current
+     * directory and explicitly expanded folders. The component never walks the
+     * tree eagerly.
+     */
+    loadChildren: (path: string) => Promise<FileEntry[]>;
+}
+/** Which entry kinds are selectable. */
+type FileSelectMode = "file" | "directory" | "both";
+type FileSortField = "name" | "size" | "mtime";
+type FileSortDirection = "asc" | "desc";
+/** Sort order for directory listings. Directories always sort before files. */
+interface FileSort {
+    by: FileSortField;
+    direction: FileSortDirection;
+}
+/** Per-path load lifecycle for provider mode. */
+type FileLoadStatus = "idle" | "loading" | "loaded" | "error";
+interface FileBrowserProps {
+    /** Async data source (provider mode). Folders load on first expand — never an eager walk. */
+    provider?: FileBrowserProvider;
+    /**
+     * JSON-friendly tree value (snapshot mode). Replace or patch it from outside
+     * as stream chunks land — the component treats it as the source of truth for
+     * every path it covers. May be combined with `provider` (hybrid): the
+     * snapshot seeds, the provider fills unknown-depth folders.
+     */
+    snapshot?: FileSnapshotNode[];
+    /** Which entry kinds are selectable (default `"file"`). Non-selectable entries stay browsable. */
+    select?: FileSelectMode;
+    /** Allow selecting multiple entries; `value` becomes `string[]` (default `false`). */
+    multiple?: boolean;
+    /** Controlled selection — a path, an array of paths (`multiple`), or `null`. */
+    value?: string | string[] | null;
+    /** Initial selection (uncontrolled). */
+    defaultValue?: string | string[] | null;
+    /** Called with the next selection and the matching known entries. */
+    onChange?: (value: string | string[] | null, entries: FileEntry[]) => void;
+    /** Controlled current directory. */
+    path?: string;
+    /** Initial current directory (uncontrolled, default `"/"`). */
+    defaultPath?: string;
+    /** Called when the current directory changes (breadcrumb click, path input, double-clicked folder). */
+    onPathChange?: (path: string) => void;
+    /** Controlled expanded folder paths. */
+    expandedPaths?: string[];
+    /** Initially expanded folder paths (uncontrolled). */
+    defaultExpandedPaths?: string[];
+    /** Called when the expanded set changes. */
+    onExpandedChange?: (paths: string[]) => void;
+    /** Controlled sort order. */
+    sort?: FileSort;
+    /** Initial sort order (uncontrolled, default `{ by: "name", direction: "asc" }`). */
+    defaultSort?: FileSort;
+    /** Called when the sort order changes. */
+    onSortChange?: (sort: FileSort) => void;
+    /** Controlled name filter — a client-side substring match over loaded nodes. */
+    filter?: string;
+    /** Initial name filter (uncontrolled). */
+    defaultFilter?: string;
+    /** Called when the name filter changes. */
+    onFilterChange?: (filter: string) => void;
+    /** Called when a provider load rejects; the failed folder shows an inline error with a retry. */
+    onError?: (path: string, error: unknown) => void;
+    /** Indent per nesting level in px (default `16`). */
+    indentSize?: number;
+    /** Show file/folder icons (default `true`). */
+    showIcons?: boolean;
+    /** Custom className for the outer shell. */
+    className?: string;
+    /**
+     * Custom layout. When omitted, renders the default
+     * `<FileBrowser.PathBar />` + `<FileBrowser.Toolbar />` + `<FileBrowser.Tree />`.
+     */
+    children?: ReactNode;
+}
+/** A flattened, visible row — the keyboard-navigation order of the tree pane. */
+interface FileBrowserRow {
+    entry: FileEntry;
+    depth: number;
+    /** Whether the row shows an expand affordance. */
+    expandable: boolean;
+    /** Whether the row is currently expanded. */
+    expanded: boolean;
+    /** Path of the parent row, or `null` for top-level rows of the current directory. */
+    parentPath: string | null;
+}
+interface FileBrowserContextValue {
+    /** Known children of a path (snapshot first, then provider cache), or `undefined` when not yet loaded. */
+    entriesFor: (path: string) => FileEntry[] | undefined;
+    /** Children of a path after the name filter + sort are applied (empty when unknown). */
+    visibleChildrenFor: (path: string) => FileEntry[];
+    statusFor: (path: string) => FileLoadStatus;
+    errorFor: (path: string) => string | undefined;
+    /** Request a lazy load of a path's children (no-op without a provider or when already known/loading). */
+    loadPath: (path: string, options?: {
+        reload?: boolean;
+    }) => void;
+    hasProvider: boolean;
+    path: string;
+    /** Change the current directory (also clears the name filter and resets roving focus). */
+    navigate: (path: string) => void;
+    expandedPaths: string[];
+    toggleExpanded: (path: string) => void;
+    select: FileSelectMode;
+    multiple: boolean;
+    selectedPaths: string[];
+    isSelected: (path: string) => boolean;
+    isSelectable: (entry: FileEntry) => boolean;
+    selectEntry: (entry: FileEntry) => void;
+    sort: FileSort;
+    setSort: (sort: FileSort) => void;
+    filter: string;
+    setFilter: (filter: string) => void;
+    visibleRows: FileBrowserRow[];
+    focusedPath: string | null;
+    setFocusedPath: (path: string | null) => void;
+    /** The row that currently owns `tabIndex={0}`. */
+    tabFocusPath: string | null;
+    focusRow: (path: string) => void;
+    registerRow: (path: string, el: HTMLElement | null) => void;
+    indentSize: number;
+    showIcons: boolean;
+}
+interface FileBrowserPathBarProps {
+    /** Allow switching to the editable path input (default `true`). */
+    editable?: boolean;
+    /** Placeholder for the path input. */
+    placeholder?: string;
+    className?: string;
+}
+interface FileBrowserToolbarProps {
+    /** Placeholder for the name filter input (default `"Filter"`). */
+    filterPlaceholder?: string;
+    className?: string;
+}
+interface FileBrowserTreeProps {
+    /** Accessible label for the tree (default `"Files"`). */
+    ariaLabel?: string;
+    className?: string;
+}
+interface FileBrowserNodeProps {
+    entry: FileEntry;
+    depth: number;
+}
+
+/**
+ * Breadcrumb trail over the current directory plus an editable path input —
+ * type a POSIX-style path and press Enter to navigate (lazy-loading it in
+ * provider mode). Escape or blur cancels the edit.
+ */
+declare function FileBrowserPathBar({ editable, placeholder, className, }: FileBrowserPathBarProps): react.JSX.Element;
+declare namespace FileBrowserPathBar {
+    var displayName: string;
+}
+
+/**
+ * Toolbar: client-side name filter (over loaded nodes only — never triggers
+ * loads) plus a dirs-first sort control. Clicking the active sort field flips
+ * its direction.
+ */
+declare function FileBrowserToolbar({ filterPlaceholder, className }: FileBrowserToolbarProps): react.JSX.Element;
+declare namespace FileBrowserToolbar {
+    var displayName: string;
+}
+
+/**
+ * The tree pane: ARIA `tree` semantics, roving tabindex, and full keyboard
+ * navigation (arrows / Enter / Space / Home / End) over the flattened row
+ * order. Lazy loads fire on expand only.
+ */
+declare function FileBrowserTree({ ariaLabel, className }: FileBrowserTreeProps): react.JSX.Element;
+declare namespace FileBrowserTree {
+    var displayName: string;
+}
+
+declare function FileBrowserNode({ entry, depth }: FileBrowserNodeProps): react.JSX.Element;
+declare namespace FileBrowserNode {
+    var displayName: string;
+}
+
+/**
+ * FileBrowser — remote-capable file/folder browser + directory picker.
+ *
+ * Browses any file tree the host can describe — local FS, HTTP, SSH, or a
+ * remote machine streaming snapshots — via two feeding modes that may be
+ * combined:
+ *
+ * - **Provider mode (lazy pull):** pass `provider.loadChildren(path)`. Folders
+ *   load on first expand with per-node loading + error states; the tree is
+ *   never walked eagerly.
+ * - **Snapshot mode (streamed push):** pass a JSON-friendly `snapshot` tree
+ *   and replace/patch it as chunks arrive (relay / WebSocket / MCP). The
+ *   snapshot is the source of truth for every path it covers; with a provider
+ *   also present, unknown-depth folders stay lazily loadable (hybrid).
+ *
+ * Fully controlled per the Human+ component contract (`value`/`onChange`,
+ * `path`/`onPathChange`, `expandedPaths`/`onExpandedChange`, plus
+ * `sort`/`filter`), with uncontrolled `defaultX` fallbacks. Every row carries
+ * a `data-path` attribute — paths are the stable handles agents target, never
+ * indexes or generated ids.
+ *
+ * Agent bridge sketch (ships later in `@particle-academy/agent-integrations`):
+ * `registerFilesBridge(server, { adapter })` will expose MCP tools over this
+ * surface — `files_list(path)`, `files_expand(path)` / `files_collapse(path)`,
+ * `files_select(paths)`, `files_navigate(path)`, and
+ * `files_request_snapshot(path, depth)` — with each mutation emitting an
+ * `AgentActivity` event so presence, undo, and coaching layers compose. The
+ * adapter maps those tools onto the same controlled props
+ * (`value`/`path`/`expandedPaths`) and provider/snapshot contract; no DOM
+ * scraping required.
+ *
+ * Read-only in v1: no content preview (pair with fancy-code's `FileViewer`)
+ * and no write operations — rename/delete/upload arrive later behind a
+ * `pendingMode`-gated iteration.
+ */
+declare function FileBrowserRoot({ provider, snapshot, select, multiple, value, defaultValue, onChange, path, defaultPath, onPathChange, expandedPaths, defaultExpandedPaths, onExpandedChange, sort, defaultSort, onSortChange, filter, defaultFilter, onFilterChange, onError, indentSize, showIcons, className, children, }: FileBrowserProps): react.JSX.Element;
+declare namespace FileBrowserRoot {
+    var displayName: string;
+}
+declare const FileBrowser: typeof FileBrowserRoot & {
+    PathBar: typeof FileBrowserPathBar;
+    Toolbar: typeof FileBrowserToolbar;
+    Tree: typeof FileBrowserTree;
+    Node: typeof FileBrowserNode;
+};
+
+declare function useFileBrowser(): FileBrowserContextValue;
+
 declare function cn(...inputs: ClassValue[]): string;
 
 /**
@@ -3375,4 +3640,4 @@ declare const AudioViewer: react.ForwardRefExoticComponent<AudioViewerProps & re
  */
 declare const PdfViewer: react.ForwardRefExoticComponent<PdfViewerProps & react.RefAttributes<HTMLDivElement>>;
 
-export { Accordion, type AccordionContentProps, type AccordionContextValue, type AccordionItemProps, type AccordionOrientation, AccordionPanel, AccordionPanelContent, type AccordionPanelContentProps, type AccordionPanelProps, AccordionPanelSection, type AccordionPanelSectionProps, AccordionPanelTrigger, type AccordionPanelTriggerProps, type AccordionProps, type AccordionTriggerProps, Action, type ActionColor, type ActionProps, type AffixPosition, AudioViewer, type AudioViewerProps, Autocomplete, type AutocompleteOption, type AutocompleteProps, Avatar, type AvatarProps, Badge, type BadgeProps, Brand, type BrandProps, Breadcrumbs, type BreadcrumbsItemProps, type BreadcrumbsProps, Button, type ButtonColor, type ButtonProps, Calendar, type CalendarMode, type CalendarProps, Callout, type CalloutProps, Card, type CardBodyProps, type CardFooterProps, type CardHeaderProps, type CardProps, Carousel, type CarouselContextValue, type CarouselControlsProps, type CarouselPanelsProps, type CarouselProps, type CarouselSlideProps, type CarouselStepsProps, type CarouselVariant, Chart, type ChartAreaProps, type ChartBarData, type ChartBarProps, type ChartCommonProps, type ChartDonutData, type ChartDonutProps, type ChartHorizontalBarProps, type ChartLineProps, type ChartPieData, type ChartPieProps, type ChartSeries, type ChartSparklineProps, type ChartStackedBarProps, ChatDrawer, type ChatDrawerProps, type ChatDrawerTab, Checkbox, CheckboxGroup, type CheckboxGroupProps, type CheckboxProps, type Color, ColorPicker, type ColorPickerProps, Command, type CommandContextValue, type CommandEmptyProps, type CommandGroupProps, type CommandInputProps, type CommandItemProps, type CommandListProps, type CommandProps, Composer, type ComposerProps, ContentRenderer, type ContentRendererProps, ContextMenu, type ContextMenuContentProps, type ContextMenuContextValue, type ContextMenuItemProps, type ContextMenuProps, type ContextMenuSeparatorProps, type ContextMenuTriggerProps, type ControlledAdapterHandle, DatePicker, type DatePickerProps, type DateRange, DisplayValue, type DisplayValueProps, type DropPosition, Dropdown, type DropdownContextValue, type DropdownItemProps, type DropdownItemsProps, type DropdownProps, type DropdownSeparatorProps, type DropdownTriggerProps, EMOJI_CATEGORY_ORDER, EMOJI_DATA, EMOJI_ENTRIES, Editor, type EditorAction, type EditorContentProps, type EditorContextValue, type EditorProps, type EditorToolbarProps, Emoji, type EmojiCategory, type EmojiCategoryKey, type EmojiEntry, type EmojiFlatEntry, type EmojiProps, EmojiSelect, type EmojiSelectProps, FauxClient, type FauxClientProps, Field, type FieldMode, FieldModeContext, type FieldModeContextValue, type FieldProps, FileUpload, type FileUploadContextValue, type FileUploadDropzoneProps, type FileUploadListProps, type FileUploadProps, Form, type FormProps, FormProvider, type FormProviderProps, Heading, type HeadingProps, Icon, type IconProps, type IconSet, ImageViewer, type ImageViewerProps, type ImageViewerViewport, Input, type InputAffixProps, type InputBaseProps, type InputOption, type InputOptionGroup, type InputProps, InputTag, type InputTagAdapter, type InputTagAdapterState, type InputTagProps, type InputTagTrigger, type InputTagTriggers, Kanban, type KanbanCardMoveHandler, type KanbanCardProps, type KanbanColumnHandleProps, type KanbanColumnMoveHandler, type KanbanColumnProps, type KanbanContextValue, type KanbanProps, MagicWand, type MagicWandAction, type MagicWandAppearance, type MagicWandProps, type MagicWandSelection, Marquee, type MarqueeDirection, type MarqueeProps, type MediaKind, MediaViewer, type MediaViewerProps, Menu, type MenuContextValue, type MenuGroupProps, type MenuItemProps, type MenuOrientation, type MenuProps, type MenuSubmenuProps, MobileMenu, type MobileMenuBottomBarProps, type MobileMenuContextValue, type MobileMenuFlyoutProps, type MobileMenuItemProps, type MobileMenuSide, type MobileMenuVariant, Modal, type ModalBodyProps, type ModalContextValue, type ModalFooterProps, type ModalHeaderProps, type ModalProps, MoodMeter, type MoodMeterProps, MultiSwitch, type MultiSwitchProps, Navbar, type NavbarBrandProps, type NavbarContextValue, type NavbarItemProps, type NavbarItemsProps, type NavbarProps, type NavbarToggleProps, type NodeRect, OtpInput, type OtpInputProps, Pagination, type PaginationProps, PdfViewer, type PdfViewerProps, Pillbox, type PillboxProps, type Placement, Popover, type PopoverContentProps, type PopoverContextValue, type PopoverProps, type PopoverTriggerProps, Portal, type PortalProps, Profile, type ProfileProps, Progress, type ProgressProps, type PromptAttachment, type PromptCmd, PromptInput, type PromptInputProps, type PromptMention, RadioGroup, type RadioGroupProps, ReasonTag, type ReasonTagProps, type ReasonTagSource, type ReasonTagTheme, type RenderExtension, type RenderExtensionProps, type ResolveMediaTypeInput, SKIN_TONES, type SectionRenderState, type SectionRenderable, Select, type SelectProps, Separator, type SeparatorProps, Sidebar, type SidebarCollapseMode, type SidebarContextValue, type SidebarGroupProps, type SidebarItemProps, type SidebarProps, type SidebarSubmenuProps, type SidebarToggleProps, type Size, Skeleton, type SkeletonProps, type SkinTone, Slider, type SliderProps, StickyNote, type StickyNoteColor, type StickyNoteProps, Switch, type SwitchProps, Table, type TableBodyProps, type TableCellProps, type TableColumnProps, type TableHeadProps, type TablePaginationProps, type TableProps, type TableRowProps, type TableRowTrayProps, type TableSearchProps, type TableTrayProps, Tabs, type TabsContextValue, type TabsListProps, type TabsPanelProps, type TabsPanelsProps, type TabsProps, type TabsTabProps, type TabsVariant, Text, type TextProps, Textarea, type TextareaProps, TimeGrid, type TimeGridProps, type TimeGridTone, TimePicker, type TimePickerProps, Timeline, type TimelineBlockProps, type TimelineEvent, type TimelineItemProps, type TimelineOrientation, type TimelineProps, type TimelineVariant, Toast, type ToastContextValue, type ToastData, type ToastPosition, type ToastProviderProps, type ToastVariant, Tooltip, type TooltipProps, TreeNav, type TreeNavContextValue, type TreeNavProps, type TreeNodeData, type TreeNodeProps, type Variant, VideoViewer, type VideoViewerProps, applyTone, cn, configureIcons, contentEditableAdapter, controlledAdapter, find, hasSkinTones, inputAdapter, registerExtension, registerExtensions, registerIconAddendum, registerIconSet, registerIcons, resolve, resolveMediaType, sanitizeHref, sanitizeHtml, search, skinTones, textareaAdapter, useAccordion, useAccordionPanel, useAccordionSection, useAnimation, useCarousel, useCommand, useContextMenu, useControllableState, useDropdown, useEditor, useEscapeKey, useFieldMode, useFileUpload, useFloatingPosition, useFocusTrap, useId, useKanban, useMenu, useMobileMenu, useModal, useNavbar, useNodeRegistry, useOutsideClick, usePanZoom, usePopover, useSidebar, useTabs, useToast, useTreeNav };
+export { Accordion, type AccordionContentProps, type AccordionContextValue, type AccordionItemProps, type AccordionOrientation, AccordionPanel, AccordionPanelContent, type AccordionPanelContentProps, type AccordionPanelProps, AccordionPanelSection, type AccordionPanelSectionProps, AccordionPanelTrigger, type AccordionPanelTriggerProps, type AccordionProps, type AccordionTriggerProps, Action, type ActionColor, type ActionProps, type AffixPosition, AudioViewer, type AudioViewerProps, Autocomplete, type AutocompleteOption, type AutocompleteProps, Avatar, type AvatarProps, Badge, type BadgeProps, Brand, type BrandProps, Breadcrumbs, type BreadcrumbsItemProps, type BreadcrumbsProps, Button, type ButtonColor, type ButtonProps, Calendar, type CalendarMode, type CalendarProps, Callout, type CalloutProps, Card, type CardBodyProps, type CardFooterProps, type CardHeaderProps, type CardProps, Carousel, type CarouselContextValue, type CarouselControlsProps, type CarouselPanelsProps, type CarouselProps, type CarouselSlideProps, type CarouselStepsProps, type CarouselVariant, Chart, type ChartAreaProps, type ChartBarData, type ChartBarProps, type ChartCommonProps, type ChartDonutData, type ChartDonutProps, type ChartHorizontalBarProps, type ChartLineProps, type ChartPieData, type ChartPieProps, type ChartSeries, type ChartSparklineProps, type ChartStackedBarProps, ChatDrawer, type ChatDrawerProps, type ChatDrawerTab, Checkbox, CheckboxGroup, type CheckboxGroupProps, type CheckboxProps, type Color, ColorPicker, type ColorPickerProps, Command, type CommandContextValue, type CommandEmptyProps, type CommandGroupProps, type CommandInputProps, type CommandItemProps, type CommandListProps, type CommandProps, Composer, type ComposerProps, ContentRenderer, type ContentRendererProps, ContextMenu, type ContextMenuContentProps, type ContextMenuContextValue, type ContextMenuItemProps, type ContextMenuProps, type ContextMenuSeparatorProps, type ContextMenuTriggerProps, type ControlledAdapterHandle, DatePicker, type DatePickerProps, type DateRange, DisplayValue, type DisplayValueProps, type DropPosition, Dropdown, type DropdownContextValue, type DropdownItemProps, type DropdownItemsProps, type DropdownProps, type DropdownSeparatorProps, type DropdownTriggerProps, EMOJI_CATEGORY_ORDER, EMOJI_DATA, EMOJI_ENTRIES, Editor, type EditorAction, type EditorContentProps, type EditorContextValue, type EditorProps, type EditorToolbarProps, Emoji, type EmojiCategory, type EmojiCategoryKey, type EmojiEntry, type EmojiFlatEntry, type EmojiProps, EmojiSelect, type EmojiSelectProps, FauxClient, type FauxClientProps, Field, type FieldMode, FieldModeContext, type FieldModeContextValue, type FieldProps, FileBrowser, type FileBrowserContextValue, type FileBrowserNodeProps, type FileBrowserPathBarProps, type FileBrowserProps, type FileBrowserProvider, type FileBrowserRow, type FileBrowserToolbarProps, type FileBrowserTreeProps, type FileEntry, type FileKind, type FileLoadStatus, type FileSelectMode, type FileSnapshotNode, type FileSort, type FileSortDirection, type FileSortField, FileUpload, type FileUploadContextValue, type FileUploadDropzoneProps, type FileUploadListProps, type FileUploadProps, Form, type FormProps, FormProvider, type FormProviderProps, Heading, type HeadingProps, Icon, type IconProps, type IconSet, ImageViewer, type ImageViewerProps, type ImageViewerViewport, Input, type InputAffixProps, type InputBaseProps, type InputOption, type InputOptionGroup, type InputProps, InputTag, type InputTagAdapter, type InputTagAdapterState, type InputTagProps, type InputTagTrigger, type InputTagTriggers, Kanban, type KanbanCardMoveHandler, type KanbanCardProps, type KanbanColumnHandleProps, type KanbanColumnMoveHandler, type KanbanColumnProps, type KanbanContextValue, type KanbanProps, MagicWand, type MagicWandAction, type MagicWandAppearance, type MagicWandProps, type MagicWandSelection, Marquee, type MarqueeDirection, type MarqueeProps, type MediaKind, MediaViewer, type MediaViewerProps, Menu, type MenuContextValue, type MenuGroupProps, type MenuItemProps, type MenuOrientation, type MenuProps, type MenuSubmenuProps, MobileMenu, type MobileMenuBottomBarProps, type MobileMenuContextValue, type MobileMenuFlyoutProps, type MobileMenuItemProps, type MobileMenuSide, type MobileMenuVariant, Modal, type ModalBodyProps, type ModalContextValue, type ModalFooterProps, type ModalHeaderProps, type ModalProps, MoodMeter, type MoodMeterProps, MultiSwitch, type MultiSwitchProps, Navbar, type NavbarBrandProps, type NavbarContextValue, type NavbarItemProps, type NavbarItemsProps, type NavbarProps, type NavbarToggleProps, type NodeRect, OtpInput, type OtpInputProps, Pagination, type PaginationProps, PdfViewer, type PdfViewerProps, Pillbox, type PillboxProps, type Placement, Popover, type PopoverContentProps, type PopoverContextValue, type PopoverProps, type PopoverTriggerProps, Portal, type PortalProps, Profile, type ProfileProps, Progress, type ProgressProps, type PromptAttachment, type PromptCmd, PromptInput, type PromptInputProps, type PromptMention, RadioGroup, type RadioGroupProps, ReasonTag, type ReasonTagProps, type ReasonTagSource, type ReasonTagTheme, type RenderExtension, type RenderExtensionProps, type ResolveMediaTypeInput, SKIN_TONES, type SectionRenderState, type SectionRenderable, Select, type SelectProps, Separator, type SeparatorProps, Sidebar, type SidebarCollapseMode, type SidebarContextValue, type SidebarGroupProps, type SidebarItemProps, type SidebarProps, type SidebarSubmenuProps, type SidebarToggleProps, type Size, Skeleton, type SkeletonProps, type SkinTone, Slider, type SliderProps, StickyNote, type StickyNoteColor, type StickyNoteProps, Switch, type SwitchProps, Table, type TableBodyProps, type TableCellProps, type TableColumnProps, type TableHeadProps, type TablePaginationProps, type TableProps, type TableRowProps, type TableRowTrayProps, type TableSearchProps, type TableTrayProps, Tabs, type TabsContextValue, type TabsListProps, type TabsPanelProps, type TabsPanelsProps, type TabsProps, type TabsTabProps, type TabsVariant, Text, type TextProps, Textarea, type TextareaProps, TimeGrid, type TimeGridProps, type TimeGridTone, TimePicker, type TimePickerProps, Timeline, type TimelineBlockProps, type TimelineEvent, type TimelineItemProps, type TimelineOrientation, type TimelineProps, type TimelineVariant, Toast, type ToastContextValue, type ToastData, type ToastPosition, type ToastProviderProps, type ToastVariant, Tooltip, type TooltipProps, TreeNav, type TreeNavContextValue, type TreeNavProps, type TreeNodeData, type TreeNodeProps, type Variant, VideoViewer, type VideoViewerProps, applyTone, cn, configureIcons, contentEditableAdapter, controlledAdapter, find, hasSkinTones, inputAdapter, registerExtension, registerExtensions, registerIconAddendum, registerIconSet, registerIcons, resolve, resolveMediaType, sanitizeHref, sanitizeHtml, search, skinTones, textareaAdapter, useAccordion, useAccordionPanel, useAccordionSection, useAnimation, useCarousel, useCommand, useContextMenu, useControllableState, useDropdown, useEditor, useEscapeKey, useFieldMode, useFileBrowser, useFileUpload, useFloatingPosition, useFocusTrap, useId, useKanban, useMenu, useMobileMenu, useModal, useNavbar, useNodeRegistry, useOutsideClick, usePanZoom, usePopover, useSidebar, useTabs, useToast, useTreeNav };

package/dist/index.d.ts

@@ -2622,6 +2622,271 @@ declare const TreeNav: typeof TreeNavRoot & {
 
 declare function useTreeNav(): TreeNavContextValue;
 
+/** Entry kind — regular file or directory. */
+type FileKind = "file" | "dir";
+/**
+ * A single file-system entry. JSON-friendly by design so agents and remote
+ * hosts can emit entries directly (over MCP, a relay, or a WebSocket).
+ * `path` is the stable identity — POSIX-style, never an index.
+ */
+interface FileEntry {
+    /** Stable identity — POSIX-style path (e.g. `"/src/App.tsx"`). */
+    path: string;
+    /** Display name (usually the last path segment). */
+    name: string;
+    /** `"file"` or `"dir"`. */
+    kind: FileKind;
+    /** Size in bytes (optional; shown for files and used by size sorting). */
+    size?: number;
+    /** Last-modified timestamp, ISO 8601 (optional; used by mtime sorting). */
+    mtime?: string;
+    /**
+     * Dirs only: `false` = known-empty (no expand affordance), `true` = has
+     * children, `undefined` = unknown (expandable when a provider is present).
+     */
+    hasChildren?: boolean;
+    /** Disabled entries render dimmed and cannot be selected, expanded, or navigated into. */
+    disabled?: boolean;
+}
+/**
+ * JSON-friendly snapshot node — a {@link FileEntry} plus optionally
+ * materialized children. `children: undefined` on a dir = unknown depth (a
+ * provider fills it lazily in hybrid mode); `children: []` = known-empty.
+ */
+interface FileSnapshotNode extends FileEntry {
+    children?: FileSnapshotNode[];
+}
+/** Async data source for provider mode. Works against local FS, HTTP, MCP bridges, SSH adapters — anything that resolves a listing. */
+interface FileBrowserProvider {
+    /**
+     * Load the direct children of `path`. Called lazily — only for the current
+     * directory and explicitly expanded folders. The component never walks the
+     * tree eagerly.
+     */
+    loadChildren: (path: string) => Promise<FileEntry[]>;
+}
+/** Which entry kinds are selectable. */
+type FileSelectMode = "file" | "directory" | "both";
+type FileSortField = "name" | "size" | "mtime";
+type FileSortDirection = "asc" | "desc";
+/** Sort order for directory listings. Directories always sort before files. */
+interface FileSort {
+    by: FileSortField;
+    direction: FileSortDirection;
+}
+/** Per-path load lifecycle for provider mode. */
+type FileLoadStatus = "idle" | "loading" | "loaded" | "error";
+interface FileBrowserProps {
+    /** Async data source (provider mode). Folders load on first expand — never an eager walk. */
+    provider?: FileBrowserProvider;
+    /**
+     * JSON-friendly tree value (snapshot mode). Replace or patch it from outside
+     * as stream chunks land — the component treats it as the source of truth for
+     * every path it covers. May be combined with `provider` (hybrid): the
+     * snapshot seeds, the provider fills unknown-depth folders.
+     */
+    snapshot?: FileSnapshotNode[];
+    /** Which entry kinds are selectable (default `"file"`). Non-selectable entries stay browsable. */
+    select?: FileSelectMode;
+    /** Allow selecting multiple entries; `value` becomes `string[]` (default `false`). */
+    multiple?: boolean;
+    /** Controlled selection — a path, an array of paths (`multiple`), or `null`. */
+    value?: string | string[] | null;
+    /** Initial selection (uncontrolled). */
+    defaultValue?: string | string[] | null;
+    /** Called with the next selection and the matching known entries. */
+    onChange?: (value: string | string[] | null, entries: FileEntry[]) => void;
+    /** Controlled current directory. */
+    path?: string;
+    /** Initial current directory (uncontrolled, default `"/"`). */
+    defaultPath?: string;
+    /** Called when the current directory changes (breadcrumb click, path input, double-clicked folder). */
+    onPathChange?: (path: string) => void;
+    /** Controlled expanded folder paths. */
+    expandedPaths?: string[];
+    /** Initially expanded folder paths (uncontrolled). */
+    defaultExpandedPaths?: string[];
+    /** Called when the expanded set changes. */
+    onExpandedChange?: (paths: string[]) => void;
+    /** Controlled sort order. */
+    sort?: FileSort;
+    /** Initial sort order (uncontrolled, default `{ by: "name", direction: "asc" }`). */
+    defaultSort?: FileSort;
+    /** Called when the sort order changes. */
+    onSortChange?: (sort: FileSort) => void;
+    /** Controlled name filter — a client-side substring match over loaded nodes. */
+    filter?: string;
+    /** Initial name filter (uncontrolled). */
+    defaultFilter?: string;
+    /** Called when the name filter changes. */
+    onFilterChange?: (filter: string) => void;
+    /** Called when a provider load rejects; the failed folder shows an inline error with a retry. */
+    onError?: (path: string, error: unknown) => void;
+    /** Indent per nesting level in px (default `16`). */
+    indentSize?: number;
+    /** Show file/folder icons (default `true`). */
+    showIcons?: boolean;
+    /** Custom className for the outer shell. */
+    className?: string;
+    /**
+     * Custom layout. When omitted, renders the default
+     * `<FileBrowser.PathBar />` + `<FileBrowser.Toolbar />` + `<FileBrowser.Tree />`.
+     */
+    children?: ReactNode;
+}
+/** A flattened, visible row — the keyboard-navigation order of the tree pane. */
+interface FileBrowserRow {
+    entry: FileEntry;
+    depth: number;
+    /** Whether the row shows an expand affordance. */
+    expandable: boolean;
+    /** Whether the row is currently expanded. */
+    expanded: boolean;
+    /** Path of the parent row, or `null` for top-level rows of the current directory. */
+    parentPath: string | null;
+}
+interface FileBrowserContextValue {
+    /** Known children of a path (snapshot first, then provider cache), or `undefined` when not yet loaded. */
+    entriesFor: (path: string) => FileEntry[] | undefined;
+    /** Children of a path after the name filter + sort are applied (empty when unknown). */
+    visibleChildrenFor: (path: string) => FileEntry[];
+    statusFor: (path: string) => FileLoadStatus;
+    errorFor: (path: string) => string | undefined;
+    /** Request a lazy load of a path's children (no-op without a provider or when already known/loading). */
+    loadPath: (path: string, options?: {
+        reload?: boolean;
+    }) => void;
+    hasProvider: boolean;
+    path: string;
+    /** Change the current directory (also clears the name filter and resets roving focus). */
+    navigate: (path: string) => void;
+    expandedPaths: string[];
+    toggleExpanded: (path: string) => void;
+    select: FileSelectMode;
+    multiple: boolean;
+    selectedPaths: string[];
+    isSelected: (path: string) => boolean;
+    isSelectable: (entry: FileEntry) => boolean;
+    selectEntry: (entry: FileEntry) => void;
+    sort: FileSort;
+    setSort: (sort: FileSort) => void;
+    filter: string;
+    setFilter: (filter: string) => void;
+    visibleRows: FileBrowserRow[];
+    focusedPath: string | null;
+    setFocusedPath: (path: string | null) => void;
+    /** The row that currently owns `tabIndex={0}`. */
+    tabFocusPath: string | null;
+    focusRow: (path: string) => void;
+    registerRow: (path: string, el: HTMLElement | null) => void;
+    indentSize: number;
+    showIcons: boolean;
+}
+interface FileBrowserPathBarProps {
+    /** Allow switching to the editable path input (default `true`). */
+    editable?: boolean;
+    /** Placeholder for the path input. */
+    placeholder?: string;
+    className?: string;
+}
+interface FileBrowserToolbarProps {
+    /** Placeholder for the name filter input (default `"Filter"`). */
+    filterPlaceholder?: string;
+    className?: string;
+}
+interface FileBrowserTreeProps {
+    /** Accessible label for the tree (default `"Files"`). */
+    ariaLabel?: string;
+    className?: string;
+}
+interface FileBrowserNodeProps {
+    entry: FileEntry;
+    depth: number;
+}
+
+/**
+ * Breadcrumb trail over the current directory plus an editable path input —
+ * type a POSIX-style path and press Enter to navigate (lazy-loading it in
+ * provider mode). Escape or blur cancels the edit.
+ */
+declare function FileBrowserPathBar({ editable, placeholder, className, }: FileBrowserPathBarProps): react.JSX.Element;
+declare namespace FileBrowserPathBar {
+    var displayName: string;
+}
+
+/**
+ * Toolbar: client-side name filter (over loaded nodes only — never triggers
+ * loads) plus a dirs-first sort control. Clicking the active sort field flips
+ * its direction.
+ */
+declare function FileBrowserToolbar({ filterPlaceholder, className }: FileBrowserToolbarProps): react.JSX.Element;
+declare namespace FileBrowserToolbar {
+    var displayName: string;
+}
+
+/**
+ * The tree pane: ARIA `tree` semantics, roving tabindex, and full keyboard
+ * navigation (arrows / Enter / Space / Home / End) over the flattened row
+ * order. Lazy loads fire on expand only.
+ */
+declare function FileBrowserTree({ ariaLabel, className }: FileBrowserTreeProps): react.JSX.Element;
+declare namespace FileBrowserTree {
+    var displayName: string;
+}
+
+declare function FileBrowserNode({ entry, depth }: FileBrowserNodeProps): react.JSX.Element;
+declare namespace FileBrowserNode {
+    var displayName: string;
+}
+
+/**
+ * FileBrowser — remote-capable file/folder browser + directory picker.
+ *
+ * Browses any file tree the host can describe — local FS, HTTP, SSH, or a
+ * remote machine streaming snapshots — via two feeding modes that may be
+ * combined:
+ *
+ * - **Provider mode (lazy pull):** pass `provider.loadChildren(path)`. Folders
+ *   load on first expand with per-node loading + error states; the tree is
+ *   never walked eagerly.
+ * - **Snapshot mode (streamed push):** pass a JSON-friendly `snapshot` tree
+ *   and replace/patch it as chunks arrive (relay / WebSocket / MCP). The
+ *   snapshot is the source of truth for every path it covers; with a provider
+ *   also present, unknown-depth folders stay lazily loadable (hybrid).
+ *
+ * Fully controlled per the Human+ component contract (`value`/`onChange`,
+ * `path`/`onPathChange`, `expandedPaths`/`onExpandedChange`, plus
+ * `sort`/`filter`), with uncontrolled `defaultX` fallbacks. Every row carries
+ * a `data-path` attribute — paths are the stable handles agents target, never
+ * indexes or generated ids.
+ *
+ * Agent bridge sketch (ships later in `@particle-academy/agent-integrations`):
+ * `registerFilesBridge(server, { adapter })` will expose MCP tools over this
+ * surface — `files_list(path)`, `files_expand(path)` / `files_collapse(path)`,
+ * `files_select(paths)`, `files_navigate(path)`, and
+ * `files_request_snapshot(path, depth)` — with each mutation emitting an
+ * `AgentActivity` event so presence, undo, and coaching layers compose. The
+ * adapter maps those tools onto the same controlled props
+ * (`value`/`path`/`expandedPaths`) and provider/snapshot contract; no DOM
+ * scraping required.
+ *
+ * Read-only in v1: no content preview (pair with fancy-code's `FileViewer`)
+ * and no write operations — rename/delete/upload arrive later behind a
+ * `pendingMode`-gated iteration.
+ */
+declare function FileBrowserRoot({ provider, snapshot, select, multiple, value, defaultValue, onChange, path, defaultPath, onPathChange, expandedPaths, defaultExpandedPaths, onExpandedChange, sort, defaultSort, onSortChange, filter, defaultFilter, onFilterChange, onError, indentSize, showIcons, className, children, }: FileBrowserProps): react.JSX.Element;
+declare namespace FileBrowserRoot {
+    var displayName: string;
+}
+declare const FileBrowser: typeof FileBrowserRoot & {
+    PathBar: typeof FileBrowserPathBar;
+    Toolbar: typeof FileBrowserToolbar;
+    Tree: typeof FileBrowserTree;
+    Node: typeof FileBrowserNode;
+};
+
+declare function useFileBrowser(): FileBrowserContextValue;
+
 declare function cn(...inputs: ClassValue[]): string;
 
 /**
@@ -3375,4 +3640,4 @@ declare const AudioViewer: react.ForwardRefExoticComponent<AudioViewerProps & re
  */
 declare const PdfViewer: react.ForwardRefExoticComponent<PdfViewerProps & react.RefAttributes<HTMLDivElement>>;
 
-export { Accordion, type AccordionContentProps, type AccordionContextValue, type AccordionItemProps, type AccordionOrientation, AccordionPanel, AccordionPanelContent, type AccordionPanelContentProps, type AccordionPanelProps, AccordionPanelSection, type AccordionPanelSectionProps, AccordionPanelTrigger, type AccordionPanelTriggerProps, type AccordionProps, type AccordionTriggerProps, Action, type ActionColor, type ActionProps, type AffixPosition, AudioViewer, type AudioViewerProps, Autocomplete, type AutocompleteOption, type AutocompleteProps, Avatar, type AvatarProps, Badge, type BadgeProps, Brand, type BrandProps, Breadcrumbs, type BreadcrumbsItemProps, type BreadcrumbsProps, Button, type ButtonColor, type ButtonProps, Calendar, type CalendarMode, type CalendarProps, Callout, type CalloutProps, Card, type CardBodyProps, type CardFooterProps, type CardHeaderProps, type CardProps, Carousel, type CarouselContextValue, type CarouselControlsProps, type CarouselPanelsProps, type CarouselProps, type CarouselSlideProps, type CarouselStepsProps, type CarouselVariant, Chart, type ChartAreaProps, type ChartBarData, type ChartBarProps, type ChartCommonProps, type ChartDonutData, type ChartDonutProps, type ChartHorizontalBarProps, type ChartLineProps, type ChartPieData, type ChartPieProps, type ChartSeries, type ChartSparklineProps, type ChartStackedBarProps, ChatDrawer, type ChatDrawerProps, type ChatDrawerTab, Checkbox, CheckboxGroup, type CheckboxGroupProps, type CheckboxProps, type Color, ColorPicker, type ColorPickerProps, Command, type CommandContextValue, type CommandEmptyProps, type CommandGroupProps, type CommandInputProps, type CommandItemProps, type CommandListProps, type CommandProps, Composer, type ComposerProps, ContentRenderer, type ContentRendererProps, ContextMenu, type ContextMenuContentProps, type ContextMenuContextValue, type ContextMenuItemProps, type ContextMenuProps, type ContextMenuSeparatorProps, type ContextMenuTriggerProps, type ControlledAdapterHandle, DatePicker, type DatePickerProps, type DateRange, DisplayValue, type DisplayValueProps, type DropPosition, Dropdown, type DropdownContextValue, type DropdownItemProps, type DropdownItemsProps, type DropdownProps, type DropdownSeparatorProps, type DropdownTriggerProps, EMOJI_CATEGORY_ORDER, EMOJI_DATA, EMOJI_ENTRIES, Editor, type EditorAction, type EditorContentProps, type EditorContextValue, type EditorProps, type EditorToolbarProps, Emoji, type EmojiCategory, type EmojiCategoryKey, type EmojiEntry, type EmojiFlatEntry, type EmojiProps, EmojiSelect, type EmojiSelectProps, FauxClient, type FauxClientProps, Field, type FieldMode, FieldModeContext, type FieldModeContextValue, type FieldProps, FileUpload, type FileUploadContextValue, type FileUploadDropzoneProps, type FileUploadListProps, type FileUploadProps, Form, type FormProps, FormProvider, type FormProviderProps, Heading, type HeadingProps, Icon, type IconProps, type IconSet, ImageViewer, type ImageViewerProps, type ImageViewerViewport, Input, type InputAffixProps, type InputBaseProps, type InputOption, type InputOptionGroup, type InputProps, InputTag, type InputTagAdapter, type InputTagAdapterState, type InputTagProps, type InputTagTrigger, type InputTagTriggers, Kanban, type KanbanCardMoveHandler, type KanbanCardProps, type KanbanColumnHandleProps, type KanbanColumnMoveHandler, type KanbanColumnProps, type KanbanContextValue, type KanbanProps, MagicWand, type MagicWandAction, type MagicWandAppearance, type MagicWandProps, type MagicWandSelection, Marquee, type MarqueeDirection, type MarqueeProps, type MediaKind, MediaViewer, type MediaViewerProps, Menu, type MenuContextValue, type MenuGroupProps, type MenuItemProps, type MenuOrientation, type MenuProps, type MenuSubmenuProps, MobileMenu, type MobileMenuBottomBarProps, type MobileMenuContextValue, type MobileMenuFlyoutProps, type MobileMenuItemProps, type MobileMenuSide, type MobileMenuVariant, Modal, type ModalBodyProps, type ModalContextValue, type ModalFooterProps, type ModalHeaderProps, type ModalProps, MoodMeter, type MoodMeterProps, MultiSwitch, type MultiSwitchProps, Navbar, type NavbarBrandProps, type NavbarContextValue, type NavbarItemProps, type NavbarItemsProps, type NavbarProps, type NavbarToggleProps, type NodeRect, OtpInput, type OtpInputProps, Pagination, type PaginationProps, PdfViewer, type PdfViewerProps, Pillbox, type PillboxProps, type Placement, Popover, type PopoverContentProps, type PopoverContextValue, type PopoverProps, type PopoverTriggerProps, Portal, type PortalProps, Profile, type ProfileProps, Progress, type ProgressProps, type PromptAttachment, type PromptCmd, PromptInput, type PromptInputProps, type PromptMention, RadioGroup, type RadioGroupProps, ReasonTag, type ReasonTagProps, type ReasonTagSource, type ReasonTagTheme, type RenderExtension, type RenderExtensionProps, type ResolveMediaTypeInput, SKIN_TONES, type SectionRenderState, type SectionRenderable, Select, type SelectProps, Separator, type SeparatorProps, Sidebar, type SidebarCollapseMode, type SidebarContextValue, type SidebarGroupProps, type SidebarItemProps, type SidebarProps, type SidebarSubmenuProps, type SidebarToggleProps, type Size, Skeleton, type SkeletonProps, type SkinTone, Slider, type SliderProps, StickyNote, type StickyNoteColor, type StickyNoteProps, Switch, type SwitchProps, Table, type TableBodyProps, type TableCellProps, type TableColumnProps, type TableHeadProps, type TablePaginationProps, type TableProps, type TableRowProps, type TableRowTrayProps, type TableSearchProps, type TableTrayProps, Tabs, type TabsContextValue, type TabsListProps, type TabsPanelProps, type TabsPanelsProps, type TabsProps, type TabsTabProps, type TabsVariant, Text, type TextProps, Textarea, type TextareaProps, TimeGrid, type TimeGridProps, type TimeGridTone, TimePicker, type TimePickerProps, Timeline, type TimelineBlockProps, type TimelineEvent, type TimelineItemProps, type TimelineOrientation, type TimelineProps, type TimelineVariant, Toast, type ToastContextValue, type ToastData, type ToastPosition, type ToastProviderProps, type ToastVariant, Tooltip, type TooltipProps, TreeNav, type TreeNavContextValue, type TreeNavProps, type TreeNodeData, type TreeNodeProps, type Variant, VideoViewer, type VideoViewerProps, applyTone, cn, configureIcons, contentEditableAdapter, controlledAdapter, find, hasSkinTones, inputAdapter, registerExtension, registerExtensions, registerIconAddendum, registerIconSet, registerIcons, resolve, resolveMediaType, sanitizeHref, sanitizeHtml, search, skinTones, textareaAdapter, useAccordion, useAccordionPanel, useAccordionSection, useAnimation, useCarousel, useCommand, useContextMenu, useControllableState, useDropdown, useEditor, useEscapeKey, useFieldMode, useFileUpload, useFloatingPosition, useFocusTrap, useId, useKanban, useMenu, useMobileMenu, useModal, useNavbar, useNodeRegistry, useOutsideClick, usePanZoom, usePopover, useSidebar, useTabs, useToast, useTreeNav };
+export { Accordion, type AccordionContentProps, type AccordionContextValue, type AccordionItemProps, type AccordionOrientation, AccordionPanel, AccordionPanelContent, type AccordionPanelContentProps, type AccordionPanelProps, AccordionPanelSection, type AccordionPanelSectionProps, AccordionPanelTrigger, type AccordionPanelTriggerProps, type AccordionProps, type AccordionTriggerProps, Action, type ActionColor, type ActionProps, type AffixPosition, AudioViewer, type AudioViewerProps, Autocomplete, type AutocompleteOption, type AutocompleteProps, Avatar, type AvatarProps, Badge, type BadgeProps, Brand, type BrandProps, Breadcrumbs, type BreadcrumbsItemProps, type BreadcrumbsProps, Button, type ButtonColor, type ButtonProps, Calendar, type CalendarMode, type CalendarProps, Callout, type CalloutProps, Card, type CardBodyProps, type CardFooterProps, type CardHeaderProps, type CardProps, Carousel, type CarouselContextValue, type CarouselControlsProps, type CarouselPanelsProps, type CarouselProps, type CarouselSlideProps, type CarouselStepsProps, type CarouselVariant, Chart, type ChartAreaProps, type ChartBarData, type ChartBarProps, type ChartCommonProps, type ChartDonutData, type ChartDonutProps, type ChartHorizontalBarProps, type ChartLineProps, type ChartPieData, type ChartPieProps, type ChartSeries, type ChartSparklineProps, type ChartStackedBarProps, ChatDrawer, type ChatDrawerProps, type ChatDrawerTab, Checkbox, CheckboxGroup, type CheckboxGroupProps, type CheckboxProps, type Color, ColorPicker, type ColorPickerProps, Command, type CommandContextValue, type CommandEmptyProps, type CommandGroupProps, type CommandInputProps, type CommandItemProps, type CommandListProps, type CommandProps, Composer, type ComposerProps, ContentRenderer, type ContentRendererProps, ContextMenu, type ContextMenuContentProps, type ContextMenuContextValue, type ContextMenuItemProps, type ContextMenuProps, type ContextMenuSeparatorProps, type ContextMenuTriggerProps, type ControlledAdapterHandle, DatePicker, type DatePickerProps, type DateRange, DisplayValue, type DisplayValueProps, type DropPosition, Dropdown, type DropdownContextValue, type DropdownItemProps, type DropdownItemsProps, type DropdownProps, type DropdownSeparatorProps, type DropdownTriggerProps, EMOJI_CATEGORY_ORDER, EMOJI_DATA, EMOJI_ENTRIES, Editor, type EditorAction, type EditorContentProps, type EditorContextValue, type EditorProps, type EditorToolbarProps, Emoji, type EmojiCategory, type EmojiCategoryKey, type EmojiEntry, type EmojiFlatEntry, type EmojiProps, EmojiSelect, type EmojiSelectProps, FauxClient, type FauxClientProps, Field, type FieldMode, FieldModeContext, type FieldModeContextValue, type FieldProps, FileBrowser, type FileBrowserContextValue, type FileBrowserNodeProps, type FileBrowserPathBarProps, type FileBrowserProps, type FileBrowserProvider, type FileBrowserRow, type FileBrowserToolbarProps, type FileBrowserTreeProps, type FileEntry, type FileKind, type FileLoadStatus, type FileSelectMode, type FileSnapshotNode, type FileSort, type FileSortDirection, type FileSortField, FileUpload, type FileUploadContextValue, type FileUploadDropzoneProps, type FileUploadListProps, type FileUploadProps, Form, type FormProps, FormProvider, type FormProviderProps, Heading, type HeadingProps, Icon, type IconProps, type IconSet, ImageViewer, type ImageViewerProps, type ImageViewerViewport, Input, type InputAffixProps, type InputBaseProps, type InputOption, type InputOptionGroup, type InputProps, InputTag, type InputTagAdapter, type InputTagAdapterState, type InputTagProps, type InputTagTrigger, type InputTagTriggers, Kanban, type KanbanCardMoveHandler, type KanbanCardProps, type KanbanColumnHandleProps, type KanbanColumnMoveHandler, type KanbanColumnProps, type KanbanContextValue, type KanbanProps, MagicWand, type MagicWandAction, type MagicWandAppearance, type MagicWandProps, type MagicWandSelection, Marquee, type MarqueeDirection, type MarqueeProps, type MediaKind, MediaViewer, type MediaViewerProps, Menu, type MenuContextValue, type MenuGroupProps, type MenuItemProps, type MenuOrientation, type MenuProps, type MenuSubmenuProps, MobileMenu, type MobileMenuBottomBarProps, type MobileMenuContextValue, type MobileMenuFlyoutProps, type MobileMenuItemProps, type MobileMenuSide, type MobileMenuVariant, Modal, type ModalBodyProps, type ModalContextValue, type ModalFooterProps, type ModalHeaderProps, type ModalProps, MoodMeter, type MoodMeterProps, MultiSwitch, type MultiSwitchProps, Navbar, type NavbarBrandProps, type NavbarContextValue, type NavbarItemProps, type NavbarItemsProps, type NavbarProps, type NavbarToggleProps, type NodeRect, OtpInput, type OtpInputProps, Pagination, type PaginationProps, PdfViewer, type PdfViewerProps, Pillbox, type PillboxProps, type Placement, Popover, type PopoverContentProps, type PopoverContextValue, type PopoverProps, type PopoverTriggerProps, Portal, type PortalProps, Profile, type ProfileProps, Progress, type ProgressProps, type PromptAttachment, type PromptCmd, PromptInput, type PromptInputProps, type PromptMention, RadioGroup, type RadioGroupProps, ReasonTag, type ReasonTagProps, type ReasonTagSource, type ReasonTagTheme, type RenderExtension, type RenderExtensionProps, type ResolveMediaTypeInput, SKIN_TONES, type SectionRenderState, type SectionRenderable, Select, type SelectProps, Separator, type SeparatorProps, Sidebar, type SidebarCollapseMode, type SidebarContextValue, type SidebarGroupProps, type SidebarItemProps, type SidebarProps, type SidebarSubmenuProps, type SidebarToggleProps, type Size, Skeleton, type SkeletonProps, type SkinTone, Slider, type SliderProps, StickyNote, type StickyNoteColor, type StickyNoteProps, Switch, type SwitchProps, Table, type TableBodyProps, type TableCellProps, type TableColumnProps, type TableHeadProps, type TablePaginationProps, type TableProps, type TableRowProps, type TableRowTrayProps, type TableSearchProps, type TableTrayProps, Tabs, type TabsContextValue, type TabsListProps, type TabsPanelProps, type TabsPanelsProps, type TabsProps, type TabsTabProps, type TabsVariant, Text, type TextProps, Textarea, type TextareaProps, TimeGrid, type TimeGridProps, type TimeGridTone, TimePicker, type TimePickerProps, Timeline, type TimelineBlockProps, type TimelineEvent, type TimelineItemProps, type TimelineOrientation, type TimelineProps, type TimelineVariant, Toast, type ToastContextValue, type ToastData, type ToastPosition, type ToastProviderProps, type ToastVariant, Tooltip, type TooltipProps, TreeNav, type TreeNavContextValue, type TreeNavProps, type TreeNodeData, type TreeNodeProps, type Variant, VideoViewer, type VideoViewerProps, applyTone, cn, configureIcons, contentEditableAdapter, controlledAdapter, find, hasSkinTones, inputAdapter, registerExtension, registerExtensions, registerIconAddendum, registerIconSet, registerIcons, resolve, resolveMediaType, sanitizeHref, sanitizeHtml, search, skinTones, textareaAdapter, useAccordion, useAccordionPanel, useAccordionSection, useAnimation, useCarousel, useCommand, useContextMenu, useControllableState, useDropdown, useEditor, useEscapeKey, useFieldMode, useFileBrowser, useFileUpload, useFloatingPosition, useFocusTrap, useId, useKanban, useMenu, useMobileMenu, useModal, useNavbar, useNodeRegistry, useOutsideClick, usePanZoom, usePopover, useSidebar, useTabs, useToast, useTreeNav };