@expcat/tigercat-react 1.4.0 → 2.0.0-preview.1

package/dist/index.d.mts

@@ -1,4 +1,3 @@
-import { FormControllerOptions, FormController, ChartLegendPosition, ChartLegendItem, DragCallbacks, DragConfig, DragState, DragItem, DragDropEvent, DragReorderResult, DragMoveResult } from '@expcat/tigercat-core';
 export * from '@expcat/tigercat-core';
 export { ConfigProvider, ConfigProviderProps, useTigerConfig } from './components/ConfigProvider.mjs';
 export { Button, ButtonProps } from './components/Button.mjs';
@@ -14,6 +13,7 @@ export { Input, InputProps } from './components/Input.mjs';
 export { InputNumber, InputNumberProps } from './components/InputNumber.mjs';
 export { Form, FormContextValue, FormHandle, FormProps, FormSubmitEvent, useFormContext } from './components/Form.mjs';
 export { FormItem, FormItemProps } from './components/FormItem.mjs';
+export { useFormController } from './hooks/useFormController.mjs';
 export { Space, SpaceProps } from './components/Space.mjs';
 export { Divider, DividerProps } from './components/Divider.mjs';
 export { Row, RowProps } from './components/Row.mjs';
@@ -21,7 +21,7 @@ export { Col, ColProps } from './components/Col.mjs';
 export { Container, ContainerProps } from './components/Container.mjs';
 export { Link, LinkProps } from './components/Link.mjs';
 export { Text, TextProps } from './components/Text.mjs';
-export { default as Code, CodeProps } from './components/Code.mjs';
+export { Code, CodeProps } from './components/Code.mjs';
 export { Icon, IconProps } from './components/Icon.mjs';
 export { Layout, ReactLayoutProps as LayoutProps } from './components/Layout.mjs';
 export { Header, ReactHeaderProps as HeaderProps } from './components/Header.mjs';
@@ -31,8 +31,8 @@ export { Footer, ReactFooterProps as FooterProps } from './components/Footer.mjs
 export { Select, SelectProps } from './components/Select.mjs';
 export { Cascader, CascaderProps } from './components/Cascader.mjs';
 export { AutoComplete, AutoCompleteProps } from './components/AutoComplete.mjs';
-export { default as Signature, SignatureProps, SignatureRef } from './components/Signature.mjs';
-export { default as NumberKeyboard, NumberKeyboardProps } from './components/NumberKeyboard.mjs';
+export { Signature, SignatureProps, SignatureRef } from './components/Signature.mjs';
+export { NumberKeyboard, NumberKeyboardProps } from './components/NumberKeyboard.mjs';
 export { Transfer, TransferProps } from './components/Transfer.mjs';
 export { TreeSelect, TreeSelectProps } from './components/TreeSelect.mjs';
 export { DatePicker, DatePickerProps } from './components/DatePicker.mjs';
@@ -50,270 +50,98 @@ export { ImageGroup, ImageGroupContext, ImageGroupContextValue, ImageGroupProps
 export { ImageCropper, ImageCropperProps, ImageCropperRef } from './components/ImageCropper.mjs';
 export { ImageAnnotation, ImageAnnotationProps } from './components/ImageAnnotation.mjs';
 export { List, ListProps } from './components/List.mjs';
-export { default as Descriptions, DescriptionsProps } from './components/Descriptions.mjs';
+export { Descriptions, DescriptionsProps } from './components/Descriptions.mjs';
 export { Timeline, TimelineProps } from './components/Timeline.mjs';
-export { default as Countdown, CountdownProps } from './components/Countdown.mjs';
-export { default as Tree, TreeProps } from './components/Tree.mjs';
+export { Countdown, CountdownProps } from './components/Countdown.mjs';
+export { Tree, TreeProps } from './components/Tree.mjs';
 export { Skeleton, SkeletonProps } from './components/Skeleton.mjs';
 export { Progress, ProgressProps } from './components/Progress.mjs';
-export { default as Collapse, CollapseContextValue, CollapseProps, useCollapseContext } from './components/Collapse.mjs';
-export { default as CollapsePanel, CollapsePanelProps } from './components/CollapsePanel.mjs';
-export { Menu, useMenuContext } from './components/Menu.mjs';
+export { Collapse, CollapseContextValue, CollapseProps, useCollapseContext } from './components/Collapse.mjs';
+export { CollapsePanel, CollapsePanelProps } from './components/CollapsePanel.mjs';
+export { Menu, MenuContextValue, MenuItem, MenuItemGroup, MenuItemGroupProps, MenuItemProps, MenuProps, SubMenu, SubMenuProps, useMenuContext } from './components/Menu.mjs';
 export { TabPane, TabPaneProps, Tabs, TabsContextValue, TabsProps, useTabsContext } from './components/Tabs.mjs';
 export { Breadcrumb, BreadcrumbContextValue, BreadcrumbItem, BreadcrumbItemProps, BreadcrumbProps, useBreadcrumbContext } from './components/Breadcrumb.mjs';
 export { Steps, StepsContextValue, StepsItem, StepsItemProps, StepsProps, useStepsContext } from './components/Steps.mjs';
-export { default as Pagination, PaginationProps } from './components/Pagination.mjs';
-export { Dropdown, DropdownContextValue, DropdownMenu, DropdownMenuProps, DropdownProps } from './components/Dropdown.mjs';
-export { DropdownItem, DropdownItemProps } from './components/DropdownItem.mjs';
-export { default as Spotlight, SpotlightProps } from './components/Spotlight.mjs';
-export { default as ScrollSpy, ScrollSpyProps } from './components/ScrollSpy.mjs';
+export { Pagination, PaginationProps } from './components/Pagination.mjs';
+export { Dropdown, DropdownContextValue, DropdownItem, DropdownItemProps, DropdownMenu, DropdownMenuProps, DropdownProps } from './components/Dropdown.mjs';
+export { Spotlight, SpotlightProps } from './components/Spotlight.mjs';
+export { ScrollSpy, ScrollSpyProps } from './components/ScrollSpy.mjs';
 export { Drawer, DrawerProps } from './components/Drawer.mjs';
 export { Modal, ModalProps } from './components/Modal.mjs';
 export { Alert, AlertProps } from './components/Alert.mjs';
-export { default as Message, MessageContainer, MessageContainerProps, MessageProps } from './components/Message.mjs';
-export { NotificationContainer, NotificationContainerProps, NotificationProps, default as notification } from './components/Notification.mjs';
+export { Message, MessageProps } from './components/MessageRoot.mjs';
+export { MessageContainer, MessageContainerProps } from './components/MessageContainer.mjs';
+export { NotificationProps, notification } from './components/NotificationRoot.mjs';
+export { NotificationContainer, NotificationContainerProps } from './components/NotificationContainer.mjs';
 export { Loading, LoadingProps } from './components/Loading.mjs';
 export { Popconfirm, PopconfirmProps } from './components/Popconfirm.mjs';
 export { Popover, PopoverProps } from './components/Popover.mjs';
 export { Tooltip, TooltipProps } from './components/Tooltip.mjs';
-export { default as ActivityFeed, ActivityFeedProps } from './components/ActivityFeed.mjs';
-export { default as ChatWindow, ChatWindowProps } from './components/ChatWindow.mjs';
-export { default as CommentThread, CommentThreadProps } from './components/CommentThread.mjs';
-export { default as NotificationCenter, NotificationCenterProps } from './components/NotificationCenter.mjs';
-export { default as DataTableWithToolbar, DataTableWithToolbarProps, ReactTableToolbarFilter, ReactTableToolbarFilterRenderContext, ReactTableToolbarFiltersExtraContext, ReactTableToolbarProps, ReactTableToolbarRenderContext } from './components/DataTableWithToolbar.mjs';
-export { default as FormWizard, FormWizardProps } from './components/FormWizard.mjs';
+export { ActivityFeed, ActivityFeedProps } from './components/ActivityFeed.mjs';
+export { ChatWindow, ChatWindowProps } from './components/ChatWindow.mjs';
+export { CommentThread, CommentThreadProps } from './components/CommentThread.mjs';
+export { NotificationCenter, NotificationCenterProps } from './components/NotificationCenter.mjs';
+export { DataTableWithToolbar, DataTableWithToolbarProps, ReactTableToolbarFilter, ReactTableToolbarFilterRenderContext, ReactTableToolbarFiltersExtraContext, ReactTableToolbarProps, ReactTableToolbarRenderContext } from './components/DataTableWithToolbar.mjs';
+export { FormWizard, FormWizardProps } from './components/FormWizard.mjs';
 export { CropUpload, CropUploadProps } from './components/CropUpload.mjs';
-export { default as ChartCanvas, ChartCanvasProps } from './components/ChartCanvas.mjs';
-export { default as ChartAxis, ChartAxisProps } from './components/ChartAxis.mjs';
-export { default as ChartGrid, ChartGridProps } from './components/ChartGrid.mjs';
-export { default as ChartSeries, ChartSeriesProps } from './components/ChartSeries.mjs';
-export { default as BarChart, BarChartProps } from './components/BarChart.mjs';
-export { default as ScatterChart, ScatterChartProps } from './components/ScatterChart.mjs';
-export { default as PieChart, PieChartProps } from './components/PieChart.mjs';
-export { default as DonutChart, DonutChartProps } from './components/DonutChart.mjs';
-export { default as RadarChart, RadarChartProps } from './components/RadarChart.mjs';
-export { default as LineChart, LineChartProps } from './components/LineChart.mjs';
-export { default as AreaChart, AreaChartProps } from './components/AreaChart.mjs';
-export { default as ChartLegend, ChartLegendProps } from './components/ChartLegend.mjs';
-export { default as ChartTooltip, ChartTooltipProps } from './components/ChartTooltip.mjs';
+export { ChartCanvas, ChartCanvasProps } from './components/ChartCanvas.mjs';
+export { ChartAxis, ChartAxisProps } from './components/ChartAxis.mjs';
+export { ChartGrid, ChartGridProps } from './components/ChartGrid.mjs';
+export { ChartSeries, ChartSeriesProps } from './components/ChartSeries.mjs';
+export { BarChart, BarChartProps } from './components/BarChart.mjs';
+export { ScatterChart, ScatterChartProps } from './components/ScatterChart.mjs';
+export { PieChart, PieChartProps } from './components/PieChart.mjs';
+export { DonutChart, DonutChartProps } from './components/DonutChart.mjs';
+export { RadarChart, RadarChartProps } from './components/RadarChart.mjs';
+export { LineChart, LineChartProps } from './components/LineChart.mjs';
+export { AreaChart, AreaChartProps } from './components/AreaChart.mjs';
+export { ChartLegend, ChartLegendProps } from './components/ChartLegend.mjs';
+export { ChartTooltip, ChartTooltipProps } from './components/ChartTooltip.mjs';
 export { FunnelChart, FunnelChartProps } from './components/FunnelChart.mjs';
 export { GaugeChart, GaugeChartProps } from './components/GaugeChart.mjs';
 export { HeatmapChart, HeatmapChartProps } from './components/HeatmapChart.mjs';
 export { TreeMapChart, TreeMapChartProps } from './components/TreeMapChart.mjs';
 export { SunburstChart, SunburstChartProps } from './components/SunburstChart.mjs';
 export { Carousel, CarouselProps, CarouselRef } from './components/Carousel.mjs';
-export { default as BackTop, BackTopProps } from './components/BackTop.mjs';
-export { default as Anchor, AnchorContextValue, AnchorLink, AnchorLinkProps, AnchorProps, useAnchorContext } from './components/Anchor.mjs';
-export { default as TaskBoard, TaskBoardProps } from './components/TaskBoard.mjs';
+export { BackTop, BackTopProps } from './components/BackTop.mjs';
+export { Anchor, AnchorContextValue, AnchorLink, AnchorLinkProps, AnchorProps, useAnchorContext } from './components/Anchor.mjs';
+export { TaskBoard, TaskBoardProps } from './components/TaskBoard.mjs';
 export { Rate, RateProps } from './components/Rate.mjs';
 export { Segmented, SegmentedProps } from './components/Segmented.mjs';
 export { Statistic, StatisticProps } from './components/Statistic.mjs';
 export { ColorPicker, ColorPickerProps } from './components/ColorPicker.mjs';
-export { default as ColorSwatch, ColorSwatchProps } from './components/ColorSwatch.mjs';
+export { ColorSwatch, ColorSwatchProps } from './components/ColorSwatch.mjs';
 export { VirtualList, VirtualListProps } from './components/VirtualList.mjs';
 export { Stepper, StepperProps } from './components/Stepper.mjs';
-export { default as CronEditor, CronEditorProps } from './components/CronEditor.mjs';
-export { default as Calendar, CalendarProps } from './components/Calendar.mjs';
-export { default as Mentions, MentionsProps } from './components/Mentions.mjs';
-export { default as QRCode, QRCodeProps } from './components/QRCode.mjs';
+export { CronEditor, CronEditorProps } from './components/CronEditor.mjs';
+export { Calendar, CalendarProps } from './components/Calendar.mjs';
+export { Mentions, MentionsProps } from './components/Mentions.mjs';
+export { QRCode, QRCodeProps } from './components/QRCode.mjs';
 export { Result, ResultProps } from './components/Result.mjs';
 export { Empty, EmptyProps } from './components/Empty.mjs';
 export { FloatButton, FloatButtonGroup, FloatButtonGroupProps, FloatButtonProps } from './components/FloatButton.mjs';
 export { Watermark, WatermarkProps } from './components/Watermark.mjs';
 export { Tour, TourProps } from './components/Tour.mjs';
 export { Affix, AffixProps } from './components/Affix.mjs';
-export { default as Splitter, SplitterProps, SplitterResizeEvent } from './components/Splitter.mjs';
-export { default as Resizable, ResizableProps } from './components/Resizable.mjs';
-export { default as CodeEditor, CodeEditorProps } from './components/CodeEditor.mjs';
-export { default as RichTextEditor, RichTextEditorProps } from './components/RichTextEditor.mjs';
-export { default as MarkdownEditor, MarkdownEditorProps } from './components/MarkdownEditor.mjs';
-export { default as Kanban, KanbanProps } from './components/Kanban.mjs';
-export { default as VirtualTable, VirtualTableProps } from './components/VirtualTable.mjs';
-export { default as InfiniteScroll, InfiniteScrollProps } from './components/InfiniteScroll.mjs';
-export { default as FileManager, FileManagerProps } from './components/FileManager.mjs';
+export { UseChartInteractionOptions, UseChartInteractionReturn, useChartInteraction } from './hooks/useChartInteraction.mjs';
+export { UseDragOptions, UseDragReturn, useDrag } from './hooks/useDrag.mjs';
+export { useControlledState } from './hooks/useControlledState.mjs';
+export { Splitter, SplitterProps, SplitterResizeEvent } from './components/Splitter.mjs';
+export { Resizable, ResizableProps } from './components/Resizable.mjs';
+export { CodeEditor, CodeEditorProps } from './components/CodeEditor.mjs';
+export { RichTextEditor, RichTextEditorProps } from './components/RichTextEditor.mjs';
+export { MarkdownEditor, MarkdownEditorProps } from './components/MarkdownEditor.mjs';
+export { Kanban, KanbanProps } from './components/Kanban.mjs';
+export { VirtualTable, VirtualTableProps } from './components/VirtualTable.mjs';
+export { InfiniteScroll, InfiniteScrollProps } from './components/InfiniteScroll.mjs';
+export { FileManager, FileManagerProps } from './components/FileManager.mjs';
 export { OrgChart, OrgChartProps } from './components/OrgChart.mjs';
 export { Gantt, GanttProps } from './components/Gantt.mjs';
 export { InputGroup, InputGroupAddon, InputGroupAddonProps, InputGroupProps } from './components/InputGroup.mjs';
 export { PrintLayout, PrintLayoutProps, PrintPageBreak, PrintPageBreakProps } from './components/PrintLayout.mjs';
 export { ImageViewer, ImageViewerProps } from './components/ImageViewer.mjs';
 export { T as TableProps } from './types-0oVwMXtR.mjs';
-export { M as MenuContextValue, c as MenuItemGroupProps, b as MenuItemProps, a as MenuProps, S as SubMenuProps } from './types-DaC4a0Ny.mjs';
-export { MenuItem } from './components/MenuItem.mjs';
-export { SubMenu } from './components/SubMenu.mjs';
-export { MenuItemGroup } from './components/MenuItemGroup.mjs';
 import 'react';
-import 'react/jsx-runtime';
-
-/**
- * Headless form controller hook.
- *
- * Returns a `FormController` that manages values, validation, and undo/redo
- * independently of any `<Form>` component.
- *
- * @example
- * ```tsx
- * const form = useFormController({
- *   initialValues: { name: '', email: '' },
- *   rules: { name: { required: true, message: 'Required' } }
- * })
- *
- * // Standalone usage
- * <input value={form.values.name} onChange={e => form.setFieldValue('name', e.target.value)} />
- * {form.errorsByField.name && <span>{form.errorsByField.name}</span>}
- * <button onClick={() => form.validate()}>Submit</button>
- * ```
- */
-declare function useFormController(options?: FormControllerOptions): FormController;
-
-/**
- * Options for useChartInteraction hook
- */
-interface UseChartInteractionOptions<T = unknown> {
-    /** Enable hover highlight */
-    hoverable: boolean;
-    /** Controlled hovered index from props */
-    hoveredIndexProp?: number | null;
-    /** Enable click selection */
-    selectable: boolean;
-    /** Controlled selected index from props */
-    selectedIndexProp?: number | null;
-    /** Opacity for active element */
-    activeOpacity: number;
-    /** Opacity for inactive elements */
-    inactiveOpacity: number;
-    /** Legend position for wrapper classes */
-    legendPosition?: ChartLegendPosition;
-    /** Callback when hover changes */
-    onHoveredIndexChange?: (index: number | null) => void;
-    /** Callback when selection changes */
-    onSelectedIndexChange?: (index: number | null) => void;
-    /** Get data item by index */
-    getData?: (index: number) => T | undefined;
-    /** Custom callbacks */
-    callbacks?: {
-        onHover?: (index: number | null, datum: T | null) => void;
-        onClick?: (index: number, datum: T) => void;
-    };
-}
-/**
- * Return type for useChartInteraction
- */
-interface UseChartInteractionReturn {
-    /** Local hovered index state */
-    localHoveredIndex: number | null;
-    /** Local selected index state */
-    localSelectedIndex: number | null;
-    /** Tooltip position state */
-    tooltipPosition: {
-        x: number;
-        y: number;
-    };
-    /** Resolved hovered index (controlled or uncontrolled) */
-    resolvedHoveredIndex: number | null;
-    /** Resolved selected index (controlled or uncontrolled) */
-    resolvedSelectedIndex: number | null;
-    /** Current active index for highlighting */
-    activeIndex: number | null;
-    /** Get element opacity based on active state */
-    getElementOpacity: (index: number) => number | undefined;
-    /** Handle mouse enter on chart element */
-    handleMouseEnter: (index: number, event: React.MouseEvent) => void;
-    /** Handle mouse move for tooltip */
-    handleMouseMove: (event: React.MouseEvent) => void;
-    /** Handle mouse leave */
-    handleMouseLeave: () => void;
-    /** Handle click on chart element */
-    handleClick: (index: number) => void;
-    /** Handle keydown for accessibility */
-    handleKeyDown: (event: React.KeyboardEvent, index: number) => void;
-    /** Handle legend item click */
-    handleLegendClick: (index: number) => void;
-    /** Handle legend item hover */
-    handleLegendHover: (index: number) => void;
-    /** Handle legend item leave */
-    handleLegendLeave: () => void;
-    /** Wrapper classes for legend layout */
-    wrapperClasses: string;
-    /** Create legend items from data */
-    createLegendItems: (items: Array<{
-        label?: string;
-        color?: string;
-        x?: unknown;
-    }>, palette: string[], labelFormatter?: (item: unknown, index: number) => string) => ChartLegendItem[];
-}
-/**
- * Hook for chart interaction state and handlers
- * Extracts common interaction logic from high-level chart components
- */
-declare function useChartInteraction<T = unknown>(options: UseChartInteractionOptions<T>): UseChartInteractionReturn;
-
-interface UseDragOptions extends DragCallbacks {
-    /** Drag configuration */
-    config?: DragConfig;
-    /** Container id (for cross-container scenarios) */
-    containerId?: string;
-}
-interface UseDragReturn {
-    /** Current drag state */
-    state: DragState;
-    /** Whether a drag is currently active */
-    isDragging: boolean;
-    /** The item currently being dragged */
-    draggedItem: DragItem | null;
-    /** Start a drag operation */
-    startDrag: (item: DragItem, event?: React.DragEvent) => void;
-    /** Handle drag over an item */
-    dragOver: (item: DragItem | null, event?: React.DragEvent) => void;
-    /** Handle drop */
-    drop: (event?: React.DragEvent) => DragDropEvent | null;
-    /** Cancel or end drag */
-    endDrag: (cancelled?: boolean) => void;
-    /** Reorder items in the current list */
-    reorder: <T extends DragItem>(items: readonly T[]) => DragReorderResult<T> | null;
-    /** Move item between two containers */
-    moveBetween: <T extends DragItem>(sourceItems: readonly T[], targetItems: readonly T[]) => DragMoveResult<T> | null;
-    /** Check if current drag is within same container */
-    isSameContainer: boolean;
-    /** Check if current drag crosses containers */
-    isCrossContainer: boolean;
-    /** HTML attribute bindings for a draggable item */
-    getDragItemProps: (item: DragItem) => Record<string, unknown>;
-    /** HTML attribute bindings for a drop zone */
-    getDropZoneProps: () => Record<string, unknown>;
-}
-declare function useDrag(options?: UseDragOptions): UseDragReturn;
-
-/**
- * Setter returned by {@link useControlledState}.
- *
- * Accepts either the next value or an updater `(prev) => next`. When the
- * component is uncontrolled the internal state is updated; in both controlled
- * and uncontrolled modes the `onChange` callback (if provided) is always
- * invoked with the resolved value followed by any forwarded extra arguments.
- */
-type SetControlledState<T, Args extends unknown[] = []> = (next: T | ((prev: T) => T), ...args: Args) => void;
-/**
- * Hook for the controlled/uncontrolled component state pattern, modeled after
- * Ant Design's `useMergedState` / Radix's `useControllableState`.
- *
- * Unlike a bare `useState`, the returned setter merges the `onChange`
- * callback: it writes internal state only when uncontrolled and always fires
- * `onChange`, removing the `const isControlled = value !== undefined` +
- * `if (!isControlled) setInternal(...)` + `onChange?.()` boilerplate that was
- * otherwise repeated across components.
- *
- * `Args` lets callers forward extra arguments (e.g. the originating DOM event)
- * to `onChange`: `setValue(nextChecked, event)` calls `onChange(nextChecked, event)`.
- *
- * @param controlledValue - The controlled value (from props). Pass `undefined` for uncontrolled.
- * @param defaultValue - The initial value for uncontrolled mode.
- * @param onChange - Optional change callback, always invoked by the returned setter.
- * @returns A tuple of `[currentValue, setValue]`.
- *
- * @remarks The setter treats a function argument as an updater (mirroring
- * `useState`), so it cannot store a function as the value `T` directly.
- */
-declare function useControlledState<T, Args extends unknown[] = []>(controlledValue: T | undefined, defaultValue: T, onChange?: (value: T, ...args: Args) => void): [T, SetControlledState<T, Args>];
 
 /**
  * Tigercat React
@@ -321,6 +149,6 @@ declare function useControlledState<T, Args extends unknown[] = []>(controlledVa
  * React components for Tigercat UI library
  */
 
-declare const version = "1.4.0";
+declare const version = "2.0.0-preview.1";
 
-export { type UseChartInteractionOptions, type UseChartInteractionReturn, type UseDragOptions, type UseDragReturn, useChartInteraction, useControlledState, useDrag, useFormController, version };
+export { version };