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

package/dist/components/TaskBoard.mjs

@@ -1,7 +1,7 @@
 import {
   TaskBoard,
   TaskBoard_default
-} from "../chunk-JOB47R6Q.mjs";
+} from "../chunk-GCOA4AO6.mjs";
 import "../chunk-QAIBQHIO.mjs";
 export {
   TaskBoard,

package/dist/components/Textarea.mjs

@@ -1,7 +1,8 @@
 import {
   Textarea
-} from "../chunk-DVEK5SO6.mjs";
-import "../chunk-WHYHLUXG.mjs";
+} from "../chunk-UYJJLHVA.mjs";
+import "../chunk-34VGG7AK.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-SQTOVSDU.mjs";
-import "../chunk-WHYHLUXG.mjs";
+} from "../chunk-K6JLLCY7.mjs";
+import "../chunk-MEFARVQI.mjs";
 import "../chunk-QAIBQHIO.mjs";
 export {
   TimePicker

package/dist/components/Timeline.d.mts

@@ -1,5 +1,5 @@
 import React from 'react';
-import { TimelineItem, TimelineMode } from '@expcat/tigercat-core';
+import { TimelineItem, TimelineMode, TigerLocale } from '@expcat/tigercat-core';
 
 interface TimelineProps extends Omit<React.HTMLAttributes<HTMLUListElement>, 'children'> {
     /**
@@ -41,6 +41,10 @@ interface TimelineProps extends Omit<React.HTMLAttributes<HTMLUListElement>, 'ch
      * Additional CSS classes
      */
     className?: string;
+    /**
+     * Locale override; falls back to ConfigProvider locale
+     */
+    locale?: Partial<TigerLocale>;
 }
 declare const Timeline: React.FC<TimelineProps>;
 

package/dist/components/Timeline.mjs

@@ -1,6 +1,7 @@
 import {
   Timeline
-} from "../chunk-ZA5EFHET.mjs";
+} from "../chunk-Z6BDNV3S.mjs";
+import "../chunk-QAIBQHIO.mjs";
 export {
   Timeline
 };

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/Tour.mjs

@@ -1,8 +1,9 @@
 import {
   Tour
-} from "../chunk-I7FEGKX2.mjs";
-import "../chunk-QAIBQHIO.mjs";
+} from "../chunk-CR4QBH46.mjs";
+import "../chunk-SEWNVIHH.mjs";
 import "../chunk-FLYJVZED.mjs";
+import "../chunk-QAIBQHIO.mjs";
 export {
   Tour
 };

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-CME2IFUT.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,8 +1,8 @@
 import {
   Tree,
   Tree_default
-} from "../chunk-CAQPYJFA.mjs";
-import "../chunk-7DUHHRAU.mjs";
+} from "../chunk-LJWQ7T57.mjs";
+import "../chunk-Y5X3G2LD.mjs";
 import "../chunk-QAIBQHIO.mjs";
 export {
   Tree,

package/dist/components/TreeMapChart.mjs

@@ -1,10 +1,10 @@
 import {
   TreeMapChart
-} from "../chunk-NKSYX4R7.mjs";
-import "../chunk-6QML6T3Y.mjs";
-import "../chunk-UBP7HZSU.mjs";
-import "../chunk-NASC6XHN.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-OXQOKKTP.mjs";
-import "../chunk-WHYHLUXG.mjs";
+} from "../chunk-2UFTDDPW.mjs";
+import "../chunk-MEFARVQI.mjs";
 import "../chunk-QAIBQHIO.mjs";
 export {
   Upload

package/dist/components/VirtualList.mjs

@@ -1,6 +1,6 @@
 import {
   VirtualList
-} from "../chunk-7DUHHRAU.mjs";
+} from "../chunk-Y5X3G2LD.mjs";
 export {
   VirtualList
 };

package/dist/components/VirtualTable.d.mts

@@ -1,27 +1,31 @@
-import * as react_jsx_runtime from 'react/jsx-runtime';
 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;
     stickyHeader?: boolean;
+    /** Enable horizontal column virtualization (when no fixed columns) */
+    virtualizeColumns?: boolean;
     rowKey?: keyof T | ((row: T, index: number) => string | number);
+    /** Row class name (static or per-row resolver) */
+    rowClassName?: string | ((row: T, index: number) => string);
     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, overscan, stickyHeader, rowKey, loading, emptyText, locale, selectable, selectedKeys, striped, bordered, className, onRowClick, onSelect, renderCell, ...rest }: VirtualTableProps<T>) => react_jsx_runtime.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-EPJ6W4VI.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
+};

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
+};