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

package/dist/index.d.ts

@@ -1,326 +0,0 @@
-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.js';
-export { Button, ButtonProps } from './components/Button.js';
-export { ButtonGroup, ButtonGroupProps } from './components/ButtonGroup.js';
-export { Slider, SliderProps } from './components/Slider.js';
-export { Switch, SwitchProps } from './components/Switch.js';
-export { Checkbox, CheckboxProps } from './components/Checkbox.js';
-export { CheckboxGroup, CheckboxGroupProps } from './components/CheckboxGroup.js';
-export { Radio, RadioProps } from './components/Radio.js';
-export { RadioGroup, RadioGroupProps } from './components/RadioGroup.js';
-export { Textarea, TextareaProps } from './components/Textarea.js';
-export { Input, InputProps } from './components/Input.js';
-export { InputNumber, InputNumberProps } from './components/InputNumber.js';
-export { Form, FormContextValue, FormHandle, FormProps, FormSubmitEvent, useFormContext } from './components/Form.js';
-export { FormItem, FormItemProps } from './components/FormItem.js';
-export { Space, SpaceProps } from './components/Space.js';
-export { Divider, DividerProps } from './components/Divider.js';
-export { Row, RowProps } from './components/Row.js';
-export { Col, ColProps } from './components/Col.js';
-export { Container, ContainerProps } from './components/Container.js';
-export { Link, LinkProps } from './components/Link.js';
-export { Text, TextProps } from './components/Text.js';
-export { default as Code, CodeProps } from './components/Code.js';
-export { Icon, IconProps } from './components/Icon.js';
-export { Layout, ReactLayoutProps as LayoutProps } from './components/Layout.js';
-export { Header, ReactHeaderProps as HeaderProps } from './components/Header.js';
-export { Sidebar, ReactSidebarProps as SidebarProps } from './components/Sidebar.js';
-export { Content, ReactContentProps as ContentProps } from './components/Content.js';
-export { Footer, ReactFooterProps as FooterProps } from './components/Footer.js';
-export { Select, SelectProps } from './components/Select.js';
-export { Cascader, CascaderProps } from './components/Cascader.js';
-export { AutoComplete, AutoCompleteProps } from './components/AutoComplete.js';
-export { default as Signature, SignatureProps, SignatureRef } from './components/Signature.js';
-export { default as NumberKeyboard, NumberKeyboardProps } from './components/NumberKeyboard.js';
-export { Transfer, TransferProps } from './components/Transfer.js';
-export { TreeSelect, TreeSelectProps } from './components/TreeSelect.js';
-export { DatePicker, DatePickerProps } from './components/DatePicker.js';
-export { TimePicker, TimePickerProps } from './components/TimePicker.js';
-export { Upload, UploadProps } from './components/Upload.js';
-export { Table } from './components/Table.js';
-export { Tag, TagProps } from './components/Tag.js';
-export { Badge, BadgeProps } from './components/Badge.js';
-export { Card, CardProps } from './components/Card.js';
-export { Avatar, AvatarProps } from './components/Avatar.js';
-export { AvatarGroup, AvatarGroupProps } from './components/AvatarGroup.js';
-export { Image, ImageProps } from './components/Image.js';
-export { ImagePreview, ImagePreviewProps } from './components/ImagePreview.js';
-export { ImageGroup, ImageGroupContext, ImageGroupContextValue, ImageGroupProps } from './components/ImageGroup.js';
-export { ImageCropper, ImageCropperProps, ImageCropperRef } from './components/ImageCropper.js';
-export { ImageAnnotation, ImageAnnotationProps } from './components/ImageAnnotation.js';
-export { List, ListProps } from './components/List.js';
-export { default as Descriptions, DescriptionsProps } from './components/Descriptions.js';
-export { Timeline, TimelineProps } from './components/Timeline.js';
-export { default as Countdown, CountdownProps } from './components/Countdown.js';
-export { default as Tree, TreeProps } from './components/Tree.js';
-export { Skeleton, SkeletonProps } from './components/Skeleton.js';
-export { Progress, ProgressProps } from './components/Progress.js';
-export { default as Collapse, CollapseContextValue, CollapseProps, useCollapseContext } from './components/Collapse.js';
-export { default as CollapsePanel, CollapsePanelProps } from './components/CollapsePanel.js';
-export { Menu, useMenuContext } from './components/Menu.js';
-export { TabPane, TabPaneProps, Tabs, TabsContextValue, TabsProps, useTabsContext } from './components/Tabs.js';
-export { Breadcrumb, BreadcrumbContextValue, BreadcrumbItem, BreadcrumbItemProps, BreadcrumbProps, useBreadcrumbContext } from './components/Breadcrumb.js';
-export { Steps, StepsContextValue, StepsItem, StepsItemProps, StepsProps, useStepsContext } from './components/Steps.js';
-export { default as Pagination, PaginationProps } from './components/Pagination.js';
-export { Dropdown, DropdownContextValue, DropdownMenu, DropdownMenuProps, DropdownProps } from './components/Dropdown.js';
-export { DropdownItem, DropdownItemProps } from './components/DropdownItem.js';
-export { default as Spotlight, SpotlightProps } from './components/Spotlight.js';
-export { default as ScrollSpy, ScrollSpyProps } from './components/ScrollSpy.js';
-export { Drawer, DrawerProps } from './components/Drawer.js';
-export { Modal, ModalProps } from './components/Modal.js';
-export { Alert, AlertProps } from './components/Alert.js';
-export { default as Message, MessageContainer, MessageContainerProps, MessageProps } from './components/Message.js';
-export { NotificationContainer, NotificationContainerProps, NotificationProps, default as notification } from './components/Notification.js';
-export { Loading, LoadingProps } from './components/Loading.js';
-export { Popconfirm, PopconfirmProps } from './components/Popconfirm.js';
-export { Popover, PopoverProps } from './components/Popover.js';
-export { Tooltip, TooltipProps } from './components/Tooltip.js';
-export { default as ActivityFeed, ActivityFeedProps } from './components/ActivityFeed.js';
-export { default as ChatWindow, ChatWindowProps } from './components/ChatWindow.js';
-export { default as CommentThread, CommentThreadProps } from './components/CommentThread.js';
-export { default as NotificationCenter, NotificationCenterProps } from './components/NotificationCenter.js';
-export { default as DataTableWithToolbar, DataTableWithToolbarProps, ReactTableToolbarFilter, ReactTableToolbarFilterRenderContext, ReactTableToolbarFiltersExtraContext, ReactTableToolbarProps, ReactTableToolbarRenderContext } from './components/DataTableWithToolbar.js';
-export { default as FormWizard, FormWizardProps } from './components/FormWizard.js';
-export { CropUpload, CropUploadProps } from './components/CropUpload.js';
-export { default as ChartCanvas, ChartCanvasProps } from './components/ChartCanvas.js';
-export { default as ChartAxis, ChartAxisProps } from './components/ChartAxis.js';
-export { default as ChartGrid, ChartGridProps } from './components/ChartGrid.js';
-export { default as ChartSeries, ChartSeriesProps } from './components/ChartSeries.js';
-export { default as BarChart, BarChartProps } from './components/BarChart.js';
-export { default as ScatterChart, ScatterChartProps } from './components/ScatterChart.js';
-export { default as PieChart, PieChartProps } from './components/PieChart.js';
-export { default as DonutChart, DonutChartProps } from './components/DonutChart.js';
-export { default as RadarChart, RadarChartProps } from './components/RadarChart.js';
-export { default as LineChart, LineChartProps } from './components/LineChart.js';
-export { default as AreaChart, AreaChartProps } from './components/AreaChart.js';
-export { default as ChartLegend, ChartLegendProps } from './components/ChartLegend.js';
-export { default as ChartTooltip, ChartTooltipProps } from './components/ChartTooltip.js';
-export { FunnelChart, FunnelChartProps } from './components/FunnelChart.js';
-export { GaugeChart, GaugeChartProps } from './components/GaugeChart.js';
-export { HeatmapChart, HeatmapChartProps } from './components/HeatmapChart.js';
-export { TreeMapChart, TreeMapChartProps } from './components/TreeMapChart.js';
-export { SunburstChart, SunburstChartProps } from './components/SunburstChart.js';
-export { Carousel, CarouselProps, CarouselRef } from './components/Carousel.js';
-export { default as BackTop, BackTopProps } from './components/BackTop.js';
-export { default as Anchor, AnchorContextValue, AnchorLink, AnchorLinkProps, AnchorProps, useAnchorContext } from './components/Anchor.js';
-export { default as TaskBoard, TaskBoardProps } from './components/TaskBoard.js';
-export { Rate, RateProps } from './components/Rate.js';
-export { Segmented, SegmentedProps } from './components/Segmented.js';
-export { Statistic, StatisticProps } from './components/Statistic.js';
-export { ColorPicker, ColorPickerProps } from './components/ColorPicker.js';
-export { default as ColorSwatch, ColorSwatchProps } from './components/ColorSwatch.js';
-export { VirtualList, VirtualListProps } from './components/VirtualList.js';
-export { Stepper, StepperProps } from './components/Stepper.js';
-export { default as CronEditor, CronEditorProps } from './components/CronEditor.js';
-export { default as Calendar, CalendarProps } from './components/Calendar.js';
-export { default as Mentions, MentionsProps } from './components/Mentions.js';
-export { default as QRCode, QRCodeProps } from './components/QRCode.js';
-export { Result, ResultProps } from './components/Result.js';
-export { Empty, EmptyProps } from './components/Empty.js';
-export { FloatButton, FloatButtonGroup, FloatButtonGroupProps, FloatButtonProps } from './components/FloatButton.js';
-export { Watermark, WatermarkProps } from './components/Watermark.js';
-export { Tour, TourProps } from './components/Tour.js';
-export { Affix, AffixProps } from './components/Affix.js';
-export { default as Splitter, SplitterProps, SplitterResizeEvent } from './components/Splitter.js';
-export { default as Resizable, ResizableProps } from './components/Resizable.js';
-export { default as CodeEditor, CodeEditorProps } from './components/CodeEditor.js';
-export { default as RichTextEditor, RichTextEditorProps } from './components/RichTextEditor.js';
-export { default as MarkdownEditor, MarkdownEditorProps } from './components/MarkdownEditor.js';
-export { default as Kanban, KanbanProps } from './components/Kanban.js';
-export { default as VirtualTable, VirtualTableProps } from './components/VirtualTable.js';
-export { default as InfiniteScroll, InfiniteScrollProps } from './components/InfiniteScroll.js';
-export { default as FileManager, FileManagerProps } from './components/FileManager.js';
-export { OrgChart, OrgChartProps } from './components/OrgChart.js';
-export { Gantt, GanttProps } from './components/Gantt.js';
-export { InputGroup, InputGroupAddon, InputGroupAddonProps, InputGroupProps } from './components/InputGroup.js';
-export { PrintLayout, PrintLayoutProps, PrintPageBreak, PrintPageBreakProps } from './components/PrintLayout.js';
-export { ImageViewer, ImageViewerProps } from './components/ImageViewer.js';
-export { T as TableProps } from './types-0oVwMXtR.js';
-export { M as MenuContextValue, c as MenuItemGroupProps, b as MenuItemProps, a as MenuProps, S as SubMenuProps } from './types-DaC4a0Ny.js';
-export { MenuItem } from './components/MenuItem.js';
-export { SubMenu } from './components/SubMenu.js';
-export { MenuItemGroup } from './components/MenuItemGroup.js';
-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
- *
- * React components for Tigercat UI library
- */
-
-declare const version = "1.4.0";
-
-export { type UseChartInteractionOptions, type UseChartInteractionReturn, type UseDragOptions, type UseDragReturn, useChartInteraction, useControlledState, useDrag, useFormController, version };