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

package/dist/components/Popover.mjs

@@ -1,7 +1,7 @@
 import {
   Popover
-} from "../chunk-RYHM75MP.mjs";
-import "../chunk-C44WSDEY.mjs";
+} from "../chunk-QWUDJC6K.mjs";
+import "../chunk-S7IB6YST.mjs";
 import "../chunk-SEWNVIHH.mjs";
 export {
   Popover

package/dist/components/RadarChart.mjs

@@ -1,12 +1,12 @@
 import {
   RadarChart,
   RadarChart_default
-} from "../chunk-BRPOEVRT.mjs";
-import "../chunk-6QML6T3Y.mjs";
+} from "../chunk-I3SE5HMH.mjs";
+import "../chunk-DNOPEJ5I.mjs";
+import "../chunk-YORCCCQX.mjs";
+import "../chunk-DKNVSQSV.mjs";
 import "../chunk-ZG2W4HS5.mjs";
 import "../chunk-SDLMB34Y.mjs";
-import "../chunk-O6YIPNXX.mjs";
-import "../chunk-DKNVSQSV.mjs";
 export {
   RadarChart,
   RadarChart_default as default

package/dist/components/Radio.mjs

@@ -1,8 +1,8 @@
 import {
   Radio
-} from "../chunk-3RBRWBUG.mjs";
-import "../chunk-4MONGWU5.mjs";
-import "../chunk-WHYHLUXG.mjs";
+} from "../chunk-IIWUQK2P.mjs";
+import "../chunk-AKNWUI7K.mjs";
+import "../chunk-MEFARVQI.mjs";
 export {
   Radio
 };

package/dist/components/RadioGroup.d.mts

@@ -1,5 +1,5 @@
 import React from 'react';
-import { RadioGroupProps as RadioGroupProps$1, RadioSize } from '@expcat/tigercat-core';
+import { RadioGroupProps as RadioGroupProps$1, ComponentSize } from '@expcat/tigercat-core';
 
 interface RadioGroupProps extends Omit<React.HTMLAttributes<HTMLDivElement>, 'onChange' | 'children' | 'defaultValue'>, RadioGroupProps$1 {
     /**
@@ -19,7 +19,7 @@ interface RadioGroupContextValue {
     value?: string | number;
     name: string;
     disabled: boolean;
-    size: RadioSize;
+    size: ComponentSize;
     onChange?: (value: string | number) => void;
 }
 declare const RadioGroupContext: React.Context<RadioGroupContextValue | null>;

package/dist/components/RadioGroup.mjs

@@ -1,8 +1,8 @@
 import {
   RadioGroup,
   RadioGroupContext
-} from "../chunk-4MONGWU5.mjs";
-import "../chunk-WHYHLUXG.mjs";
+} from "../chunk-AKNWUI7K.mjs";
+import "../chunk-MEFARVQI.mjs";
 export {
   RadioGroup,
   RadioGroupContext

package/dist/components/RichTextEditor.mjs

@@ -1,8 +1,8 @@
 import {
   RichTextEditor,
   RichTextEditor_default
-} from "../chunk-WYPTAUCX.mjs";
-import "../chunk-WHYHLUXG.mjs";
+} from "../chunk-SHJNDDYK.mjs";
+import "../chunk-MEFARVQI.mjs";
 export {
   RichTextEditor,
   RichTextEditor_default as default

package/dist/components/ScatterChart.mjs

@@ -1,14 +1,14 @@
 import {
   ScatterChart,
   ScatterChart_default
-} from "../chunk-NEHSCSQP.mjs";
-import "../chunk-6QML6T3Y.mjs";
-import "../chunk-ZG2W4HS5.mjs";
-import "../chunk-SDLMB34Y.mjs";
-import "../chunk-O6YIPNXX.mjs";
+} from "../chunk-7TVZTASQ.mjs";
+import "../chunk-DNOPEJ5I.mjs";
+import "../chunk-YORCCCQX.mjs";
 import "../chunk-RQSQXQN6.mjs";
 import "../chunk-DKNVSQSV.mjs";
 import "../chunk-677VSTPW.mjs";
+import "../chunk-ZG2W4HS5.mjs";
+import "../chunk-SDLMB34Y.mjs";
 export {
   ScatterChart,
   ScatterChart_default as default

package/dist/components/ScrollSpy.d.mts

@@ -5,7 +5,7 @@ interface ScrollSpyProps extends Omit<ScrollSpyProps$1, 'className' | 'style'>,
     getContainer?: () => HTMLElement | Window;
     className?: string;
     style?: React.CSSProperties;
-    onChange?: (activeKey: ScrollSpyKey, item: ScrollSpyItem, payload: ScrollSpyChangePayload) => void;
+    onActiveKeyChange?: (activeKey: ScrollSpyKey, item: ScrollSpyItem, payload: ScrollSpyChangePayload) => void;
     onClick?: (item: ScrollSpyItem, event: React.MouseEvent<HTMLAnchorElement>) => void;
 }
 declare const ScrollSpy: React.FC<ScrollSpyProps>;

package/dist/components/ScrollSpy.mjs

@@ -1,7 +1,7 @@
 import {
   ScrollSpy,
   ScrollSpy_default
-} from "../chunk-FUE7IBTJ.mjs";
+} from "../chunk-OGG2TQDG.mjs";
 export {
   ScrollSpy,
   ScrollSpy_default as default

package/dist/components/Select.d.mts

@@ -4,7 +4,7 @@ import { SelectProps as SelectProps$1, SelectOptions, SelectOption, TigerLocale,
 type SelectDivProps = Omit<React.HTMLAttributes<HTMLDivElement>, 'defaultValue' | 'value' | 'onChange'>;
 interface SelectBaseProps extends Omit<SelectProps$1, 'multiple' | 'options'>, SelectDivProps {
     options?: SelectOptions;
-    onSearch?: (query: string) => void;
+    onSearchChange?: (query: string) => void;
     onCreate?: (option: SelectOption) => void;
     className?: string;
     locale?: Partial<TigerLocale>;

package/dist/components/Select.mjs

@@ -1,6 +1,6 @@
 import {
   Select
-} from "../chunk-LUABLBKS.mjs";
+} from "../chunk-JSBWEK6D.mjs";
 import "../chunk-QAIBQHIO.mjs";
 export {
   Select

package/dist/components/Spotlight.mjs

@@ -1,8 +1,8 @@
 import {
   Spotlight,
   Spotlight_default
-} from "../chunk-2L7QEOFD.mjs";
-import "../chunk-WHYHLUXG.mjs";
+} from "../chunk-KWVA2DN3.mjs";
+import "../chunk-MEFARVQI.mjs";
 import "../chunk-SEWNVIHH.mjs";
 import "../chunk-QAIBQHIO.mjs";
 export {

package/dist/components/SunburstChart.mjs

@@ -1,10 +1,10 @@
 import {
   SunburstChart
-} from "../chunk-GA4YOE57.mjs";
-import "../chunk-6QML6T3Y.mjs";
-import "../chunk-ZG2W4HS5.mjs";
-import "../chunk-O6YIPNXX.mjs";
+} from "../chunk-2PZICT2T.mjs";
+import "../chunk-DNOPEJ5I.mjs";
+import "../chunk-YORCCCQX.mjs";
 import "../chunk-DKNVSQSV.mjs";
+import "../chunk-ZG2W4HS5.mjs";
 export {
   SunburstChart
 };

package/dist/components/Table.d.mts

@@ -2,6 +2,6 @@ import React from 'react';
 import { T as TableProps } from '../types-0oVwMXtR.mjs';
 import '@expcat/tigercat-core';
 
-declare function Table<T extends Record<string, unknown> = Record<string, unknown>>({ columns, columnLockable, dataSource, hiddenColumnKeys, defaultHiddenColumnKeys, sort, defaultSort, filters, defaultFilters, size, bordered, striped, hoverable, loading, locale, labels, emptyText, pagination, rowSelection, expandable, rowKey, rowClassName, stickyHeader, maxHeight, tableLayout, responsiveMode, cardBreakpoint, cardClassName, renderCard, cardLayout, cardSelectionPosition, cardPadding, cardFieldGap, virtual, autoVirtual, virtualHeight, virtualItemHeight, autoVirtualThreshold, virtualThreshold, editable, editableCells, filterMode, advancedFilterRules, columnDraggable, rowDraggable, summaryRow, groupBy, exportable, exportFormat, exportFilename, onChange, onRowClick, onSelectionChange, onSortChange, onFilterChange, onHiddenColumnKeysChange, onPageChange, onExpandChange, onCellChange, onColumnOrderChange, onRowOrderChange, onExport, className, ...props }: TableProps<T>): React.JSX.Element;
+declare function Table<T extends Record<string, unknown> = Record<string, unknown>>({ columns, columnLockable, dataSource, hiddenColumnKeys, defaultHiddenColumnKeys, sort, defaultSort, filters, defaultFilters, size, bordered, striped, hoverable, loading, locale, labels, emptyText, pagination, rowSelection, expandable, rowKey, rowClassName, stickyHeader, maxHeight, tableLayout, responsiveMode, cardBreakpoint, cardClassName, renderCard, cardLayout, cardSelectionPosition, cardPadding, cardFieldGap, virtual, autoVirtual, virtualHeight, virtualItemHeight, virtualThreshold, editable, editableCells, filterMode, advancedFilterRules, columnDraggable, rowDraggable, summaryRow, groupBy, exportable, exportFormat, exportFilename, onChange, onRowClick, onSelectionChange, onSortChange, onFilterChange, onHiddenColumnKeysChange, onPageChange, onExpandChange, onCellChange, onColumnOrderChange, onRowOrderChange, onExport, className, ...props }: TableProps<T>): React.JSX.Element;
 
 export { Table, TableProps };

package/dist/components/Table.mjs

@@ -1,13 +1,13 @@
 import {
   Table
-} from "../chunk-S4NGDDAM.mjs";
-import "../chunk-LUABLBKS.mjs";
-import "../chunk-3RBRWBUG.mjs";
-import "../chunk-4MONGWU5.mjs";
+} from "../chunk-MQ34GFHN.mjs";
+import "../chunk-JSBWEK6D.mjs";
+import "../chunk-IIWUQK2P.mjs";
+import "../chunk-AKNWUI7K.mjs";
 import "../chunk-NJHZQBA7.mjs";
-import "../chunk-6BOSSZM3.mjs";
-import "../chunk-MV2JQ6XQ.mjs";
-import "../chunk-WHYHLUXG.mjs";
+import "../chunk-EPWAROC2.mjs";
+import "../chunk-OL3RXYMG.mjs";
+import "../chunk-MEFARVQI.mjs";
 import "../chunk-QAIBQHIO.mjs";
 export {
   Table

package/dist/components/Tabs.d.mts

@@ -119,9 +119,9 @@ interface TabsProps {
      */
     className?: string;
     /**
-     * Tab change event handler
+     * Controlled active tab key change handler
      */
-    onChange?: (key: string | number) => void;
+    onActiveKeyChange?: (key: string | number) => void;
     /**
      * Tab click event handler
      */

package/dist/components/Tabs.mjs

@@ -2,7 +2,7 @@ import {
   TabPane,
   Tabs,
   useTabsContext
-} from "../chunk-4DRJA5ZK.mjs";
+} from "../chunk-J4HCTYJG.mjs";
 export {
   TabPane,
   Tabs,

package/dist/components/Textarea.mjs

@@ -1,8 +1,8 @@
 import {
   Textarea
-} from "../chunk-D4X3NBAI.mjs";
+} from "../chunk-UYJJLHVA.mjs";
 import "../chunk-34VGG7AK.mjs";
-import "../chunk-WHYHLUXG.mjs";
+import "../chunk-MEFARVQI.mjs";
 export {
   Textarea
 };

package/dist/components/TimePicker.d.mts

@@ -1,29 +1,30 @@
 import React from 'react';
-import { TimePickerProps as TimePickerProps$1, TimePickerSingleValue, TimePickerRangeValue as TimePickerRangeValue$1 } from '@expcat/tigercat-core';
+import { TimePickerProps as TimePickerProps$1 } from '@expcat/tigercat-core';
 
-type TimePickerRangeValue = TimePickerRangeValue$1;
+type TimePickerSingleInputValue = string | null;
+type TimePickerRangeInputValue = [string | null, string | null];
 type NativeDivProps = Omit<React.HTMLAttributes<HTMLDivElement>, 'onChange'>;
 type BaseTimePickerProps = Omit<TimePickerProps$1, 'value' | 'defaultValue' | 'range'> & NativeDivProps & {
     onClear?: () => void;
 };
 type TimePickerProps = (BaseTimePickerProps & {
     range?: false;
-    value?: TimePickerSingleValue;
-    defaultValue?: TimePickerSingleValue;
+    value?: TimePickerSingleInputValue;
+    defaultValue?: TimePickerSingleInputValue;
     /**
      * Change event handler
      */
-    onChange?: (time: TimePickerSingleValue) => void;
+    onChange?: (time: TimePickerSingleInputValue) => void;
 }) | (BaseTimePickerProps & {
     range: true;
-    value?: TimePickerRangeValue | null;
-    defaultValue?: TimePickerRangeValue | null;
+    value?: TimePickerRangeInputValue | null;
+    defaultValue?: TimePickerRangeInputValue | null;
     /**
      * Change event handler
      */
-    onChange?: (time: TimePickerRangeValue) => void;
+    onChange?: (time: TimePickerRangeInputValue) => void;
 });
 
 declare const TimePicker: React.FC<TimePickerProps>;
 
-export { TimePicker, type TimePickerProps, type TimePickerRangeValue };
+export { TimePicker, type TimePickerProps };

package/dist/components/TimePicker.mjs

@@ -1,7 +1,7 @@
 import {
   TimePicker
-} from "../chunk-DO3MVZZN.mjs";
-import "../chunk-WHYHLUXG.mjs";
+} from "../chunk-K6JLLCY7.mjs";
+import "../chunk-MEFARVQI.mjs";
 import "../chunk-QAIBQHIO.mjs";
 export {
   TimePicker

package/dist/components/Tooltip.mjs

@@ -1,7 +1,7 @@
 import {
   Tooltip
-} from "../chunk-MV54EEKO.mjs";
-import "../chunk-C44WSDEY.mjs";
+} from "../chunk-2UOGBS3C.mjs";
+import "../chunk-S7IB6YST.mjs";
 import "../chunk-SEWNVIHH.mjs";
 export {
   Tooltip

package/dist/components/Transfer.d.mts

@@ -1,11 +1,13 @@
 import React from 'react';
-import { TransferProps as TransferProps$1, TigerLocale } from '@expcat/tigercat-core';
+import { TransferProps as TransferProps$1, TransferSearchValue, TigerLocale } from '@expcat/tigercat-core';
 
 interface TransferProps extends TransferProps$1, Omit<React.HTMLAttributes<HTMLDivElement>, 'onChange'> {
     /** Controlled target keys */
     value?: (string | number)[];
     /** Called when target keys change */
     onChange?: (targetKeys: (string | number)[], direction: 'left' | 'right', movedKeys: (string | number)[]) => void;
+    /** Called when either panel search input changes */
+    onSearchChange?: (value: TransferSearchValue) => void;
     /** Locale overrides merged on top of ConfigProvider locale */
     locale?: Partial<TigerLocale>;
 }

package/dist/components/Transfer.mjs

@@ -1,6 +1,6 @@
 import {
   Transfer
-} from "../chunk-ZLP4XEAO.mjs";
+} from "../chunk-XSAKD4MX.mjs";
 import "../chunk-QAIBQHIO.mjs";
 export {
   Transfer

package/dist/components/Tree.d.mts

@@ -107,6 +107,18 @@ interface TreeProps {
      * @default 'Tree'
      */
     ariaLabel?: string;
+    /**
+     * Controlled expanded keys change handler
+     */
+    onExpandedKeysChange?: (expandedKeys: (string | number)[]) => void;
+    /**
+     * Controlled selected keys change handler
+     */
+    onSelectedKeysChange?: (selectedKeys: (string | number)[]) => void;
+    /**
+     * Controlled checked keys change handler
+     */
+    onCheckedKeysChange?: (checkedKeys: (string | number)[]) => void;
     /**
      * Expand event handler
      */

package/dist/components/Tree.mjs

@@ -1,7 +1,7 @@
 import {
   Tree,
   Tree_default
-} from "../chunk-WT72F56O.mjs";
+} from "../chunk-LJWQ7T57.mjs";
 import "../chunk-Y5X3G2LD.mjs";
 import "../chunk-QAIBQHIO.mjs";
 export {

package/dist/components/TreeMapChart.mjs

@@ -1,10 +1,10 @@
 import {
   TreeMapChart
-} from "../chunk-GTDLZF7K.mjs";
-import "../chunk-6QML6T3Y.mjs";
-import "../chunk-ZG2W4HS5.mjs";
-import "../chunk-O6YIPNXX.mjs";
+} from "../chunk-ZFGSZW7S.mjs";
+import "../chunk-DNOPEJ5I.mjs";
+import "../chunk-YORCCCQX.mjs";
 import "../chunk-DKNVSQSV.mjs";
+import "../chunk-ZG2W4HS5.mjs";
 export {
   TreeMapChart
 };

package/dist/components/TreeSelect.d.mts

@@ -6,6 +6,8 @@ interface TreeSelectProps extends TreeSelectProps$1, Omit<React.HTMLAttributes<H
     value?: TreeSelectValue;
     /** Called when value changes */
     onChange?: (value: TreeSelectValue) => void;
+    /** Called when search text changes */
+    onSearchChange?: (value: string) => void;
     /** Locale overrides merged on top of ConfigProvider locale */
     locale?: Partial<TigerLocale>;
 }

package/dist/components/TreeSelect.mjs

@@ -1,6 +1,6 @@
 import {
   TreeSelect
-} from "../chunk-VAIWWELW.mjs";
+} from "../chunk-3OBUJIJI.mjs";
 import "../chunk-QAIBQHIO.mjs";
 export {
   TreeSelect

package/dist/components/Upload.mjs

@@ -1,7 +1,7 @@
 import {
   Upload
-} from "../chunk-H7D7UBDC.mjs";
-import "../chunk-WHYHLUXG.mjs";
+} from "../chunk-2UFTDDPW.mjs";
+import "../chunk-MEFARVQI.mjs";
 import "../chunk-QAIBQHIO.mjs";
 export {
   Upload

package/dist/components/VirtualTable.d.mts

@@ -1,11 +1,11 @@
 import React from 'react';
-import { TableColumn, TigerLocale } from '@expcat/tigercat-core';
+import { TableColumn, TigerLocale, RowSelectionConfig } from '@expcat/tigercat-core';
 
 interface VirtualTableProps<T = Record<string, unknown>> {
-    data?: T[];
+    dataSource?: T[];
     columns?: TableColumn<T>[];
-    rowHeight?: number;
-    height?: number;
+    virtualItemHeight?: number;
+    virtualHeight?: number;
     /** Viewport width in px or 'auto' */
     width?: number | 'auto';
     overscan?: number;
@@ -18,15 +18,14 @@ interface VirtualTableProps<T = Record<string, unknown>> {
     loading?: boolean;
     emptyText?: string;
     locale?: Partial<TigerLocale>;
-    selectable?: boolean;
-    selectedKeys?: (string | number)[];
+    rowSelection?: RowSelectionConfig<T>;
     striped?: boolean;
     bordered?: boolean;
     className?: string;
     onRowClick?: (row: T, index: number) => void;
-    onSelect?: (key: string | number, row: T, index: number) => void;
+    onSelectionChange?: (selectedKeys: (string | number)[]) => void;
     renderCell?: (value: unknown, row: T, column: TableColumn<T>) => React.ReactNode;
 }
-declare const VirtualTable: <T extends Record<string, unknown> = Record<string, unknown>>({ data, columns, rowHeight, height, width, overscan, stickyHeader, virtualizeColumns, rowKey, rowClassName, loading, emptyText, locale, selectable, selectedKeys, striped, bordered, className, onRowClick, onSelect, renderCell, ...rest }: VirtualTableProps<T>) => React.JSX.Element;
+declare const VirtualTable: <T extends Record<string, unknown> = Record<string, unknown>>({ dataSource, columns, virtualItemHeight, virtualHeight, width, overscan, stickyHeader, virtualizeColumns, rowKey, rowClassName, loading, emptyText, locale, rowSelection, striped, bordered, className, onRowClick, onSelectionChange, renderCell, ...rest }: VirtualTableProps<T>) => React.JSX.Element;
 
 export { VirtualTable, type VirtualTableProps, VirtualTable as default };

package/dist/components/VirtualTable.mjs

@@ -1,7 +1,7 @@
 import {
   VirtualTable,
   VirtualTable_default
-} from "../chunk-AI4V7L6K.mjs";
+} from "../chunk-GFLKO46C.mjs";
 import "../chunk-QAIBQHIO.mjs";
 export {
   VirtualTable,

package/dist/hooks/useChartInteraction.d.mts

@@ -0,0 +1,85 @@
+import { ChartLegendPosition, ChartLegendItem } from '@expcat/tigercat-core';
+
+/**
+ * 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;
+
+export { type UseChartInteractionOptions, type UseChartInteractionReturn, useChartInteraction };

package/dist/hooks/useChartInteraction.mjs

@@ -0,0 +1,6 @@
+import {
+  useChartInteraction
+} from "../chunk-DNOPEJ5I.mjs";
+export {
+  useChartInteraction
+};

package/dist/hooks/useControlledState.d.mts

@@ -0,0 +1,33 @@
+/**
+ * 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>];
+
+export { type SetControlledState, useControlledState };

package/dist/hooks/useControlledState.mjs

@@ -0,0 +1,6 @@
+import {
+  useControlledState
+} from "../chunk-MEFARVQI.mjs";
+export {
+  useControlledState
+};

package/dist/hooks/useDrag.d.mts

@@ -0,0 +1,39 @@
+import { DragCallbacks, DragConfig, DragState, DragItem, DragDropEvent, DragReorderResult, DragMoveResult } from '@expcat/tigercat-core';
+
+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;
+
+export { type UseDragOptions, type UseDragReturn, useDrag };

package/dist/hooks/useDrag.mjs

@@ -0,0 +1,6 @@
+import {
+  useDrag
+} from "../chunk-BBK37UMR.mjs";
+export {
+  useDrag
+};