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

package/dist/hooks/useFormController.d.mts

@@ -0,0 +1,24 @@
+import { FormControllerOptions, FormController } from '@expcat/tigercat-core';
+
+/**
+ * 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;
+
+export { useFormController };

package/dist/hooks/useFormController.mjs

@@ -0,0 +1,6 @@
+import {
+  useFormController
+} from "../chunk-3O3AQLNS.mjs";
+export {
+  useFormController
+};

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';
@@ -58,20 +58,21 @@ export { Skeleton, SkeletonProps } from './components/Skeleton.mjs';
 export { Progress, ProgressProps } from './components/Progress.mjs';
 export { Collapse, CollapseContextValue, CollapseProps, useCollapseContext } from './components/Collapse.mjs';
 export { CollapsePanel, CollapsePanelProps } from './components/CollapsePanel.mjs';
-export { Menu, useMenuContext } from './components/Menu.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 { Pagination, PaginationProps } from './components/Pagination.mjs';
-export { Dropdown, DropdownContextValue, DropdownMenu, DropdownMenuProps, DropdownProps } from './components/Dropdown.mjs';
-export { DropdownItem, DropdownItemProps } from './components/DropdownItem.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 { 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';
@@ -122,6 +123,9 @@ export { FloatButton, FloatButtonGroup, FloatButtonGroupProps, FloatButtonProps
 export { Watermark, WatermarkProps } from './components/Watermark.mjs';
 export { Tour, TourProps } from './components/Tour.mjs';
 export { Affix, AffixProps } from './components/Affix.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';
@@ -136,190 +140,15 @@ 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 { M as MenuContextValue, b as MenuItemGroupProps, c as MenuItemProps, a as MenuProps, S as SubMenuProps } from './types-CcgZY0mv.mjs';
-export { MenuItem } from './components/MenuItem.mjs';
-export { MenuItemGroup } from './components/MenuItemGroup.mjs';
-export { SubMenu } from './components/SubMenu.mjs';
 export { T as TableProps } from './types-0oVwMXtR.mjs';
 import 'react';
 
-/**
- * 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.5.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 };