@axzydev/axzy_ui_system 1.3.3 → 1.3.4

package/dist/index.d.cts

@@ -19,6 +19,16 @@ interface UseDebouncedSearchResult {
 declare function useDebouncedSearch({ initialValue, debounceMs, onSearch, }: UseDebouncedSearchOptions): UseDebouncedSearchResult;
 
 type TableVariants = "default" | "striped" | "bordered";
+/**
+ * Value stored for a single column filter.
+ *
+ * - `string | number | boolean` — text/number/boolean filters and catalog ids.
+ * - `Date` — a single-date filter (`Column.filter: "date"`).
+ * - `[Date | null, Date | null]` — a date-range filter (`Column.filter: "date-range"`).
+ */
+type ColumnFilterValue = string | number | boolean | Date | [Date | null, Date | null];
+/** Map of column `key` to its active filter value. */
+type ColumnFilters = Record<string, ColumnFilterValue>;
 type TableSize = "sm" | "md" | "lg";
 /**
  * Cell padding / row-height preset for tables. Independent of `TableSize`
@@ -186,13 +196,13 @@ interface UseTableStateOptions {
 interface UseTableStateResult {
     currentPage: number;
     itemsPerPage: number;
-    filters: Record<string, string | boolean | number>;
+    filters: ColumnFilters;
     sortConfig: SortConfig | null;
     totalPages: number;
     setTotalPages: (pages: number) => void;
     goToPage: (page: number) => void;
     handleItemsPerPageChange: (value: number) => void;
-    handleFilterChange: (key: string, value: string | boolean | number | undefined) => void;
+    handleFilterChange: (key: string, value: ColumnFilterValue | undefined) => void;
     handleSort: (key: string, sortable?: boolean) => void;
     resetPage: () => void;
     clearFilters: () => void;
@@ -1123,6 +1133,17 @@ declare function ITConfirmDialog({ isOpen, onClose, onConfirm, title, message, c
 
 /** Data type of a table column, controls default rendering, filter UI, and sort comparison. */
 type ColumnType = "string" | "date" | "number" | "boolean" | "actions" | "catalog";
+/**
+ * Per-column filter mode, set through `Column.filter`.
+ *
+ * - `true` — text/number input (or boolean toggle when `type: "boolean"`).
+ * - `"catalog"` — `ITSelect` dropdown populated from `catalogOptions`.
+ * - `"search"` — `ITSearchSelect` typeahead populated from `catalogOptions`
+ *   (respects `catalogOptions.onSearch` for server-side search).
+ * - `"date"` — `ITDatePicker` single-date filter.
+ * - `"date-range"` — `ITDatePicker` in range mode.
+ */
+type ColumnFilterMode = boolean | "catalog" | "search" | "date" | "date-range";
 /** A single selectable entry for a `"catalog"`-type column's filter/value lookup. */
 interface CatalogOption {
     /** Unique identifier matched against the row's field value. */
@@ -1142,8 +1163,8 @@ interface Column<T = any> {
     currencyMX?: boolean;
     /** Custom action buttons/content rendered for a `"actions"`-type column. Receives the full row object. */
     actions?: (row: T) => React.ReactNode;
-    /** Enables per-column filtering. Pass `true` for a text/number/boolean filter matching `type`, or `"catalog"` to filter against `catalogOptions`. @default false */
-    filter?: boolean | "catalog";
+    /** Enables per-column filtering. Pass `true` for a text/number/boolean filter matching `type`, `"catalog"` for an `ITSelect` fed by `catalogOptions`, `"search"` for an `ITSearchSelect` typeahead, or `"date"` / `"date-range"` for an `ITDatePicker`. @default false */
+    filter?: ColumnFilterMode;
     /** Column data type. Drives default cell rendering, filter UI, and sort comparison. */
     type: ColumnType;
     /** Whether clicking the header sorts by this column. Ignored for `type: "actions"`. @default false */
@@ -1164,6 +1185,22 @@ interface Column<T = any> {
         loading?: boolean;
         /** Shows an error state in the filter UI when the catalog failed to load. @default false */
         error?: boolean;
+        /**
+         * Server-side search handler for a `filter: "search"` column. When provided,
+         * `ITSearchSelect` delegates filtering to this callback (debounced) instead
+         * of filtering `data` locally; the parent is expected to update `data`.
+         */
+        onSearch?: (query: string) => void;
+    };
+    /**
+     * Date bounds applied by the `"date"` and `"date-range"` filters, forwarded to
+     * the underlying `ITDatePicker`. Ignored by every other filter mode.
+     */
+    dateFilterOptions?: {
+        /** Earliest selectable date. */
+        minDate?: Date;
+        /** Latest selectable date. */
+        maxDate?: Date;
     };
     /**
      * Fixed column width. A `number` is treated as pixels (`width: 120` → `120px`);
@@ -1277,8 +1314,12 @@ interface ITDataTableFetchParams {
     page: number;
     /** Number of rows requested per page. */
     limit: number;
-    /** Active per-column filter values (from `Column.filter`), keyed by column `key`. */
-    filters: Record<string, string | number | boolean | Date>;
+    /**
+     * Active per-column filter values (from `Column.filter`), keyed by column
+     * `key`. Scalars for text/number/boolean/date filters, a `Date` for
+     * `filter: "date"`, and a `[start, end]` tuple for `filter: "date-range"`.
+     */
+    filters: ColumnFilters;
     /** Active sort, present only when the user has clicked a sortable column header. */
     sort?: {
         /** Column `key` currently sorted by. */
@@ -1314,7 +1355,7 @@ interface ITDataTableProps<T extends Record<string, unknown>> {
      * Filters managed outside of the ITDataTable (e.g. a date range picker).
      * These will be merged with the internal column filters before calling fetchData.
      */
-    externalFilters?: Record<string, string | number | boolean | Date>;
+    externalFilters?: ColumnFilters;
     /**
      * Custom element to display instead of the default spinner while `isLoading` is true.
      */
@@ -3976,4 +4017,4 @@ declare const resolveCssColor: (colorStr: string, palette?: ITThemePalette$1, is
  */
 declare const getContrastTextColor: (bgColor: string, palette?: ITThemePalette$1, isDarkMode?: boolean) => "text-white" | "text-slate-800";
 
-export { type Column, type FieldConfig, type FieldConfigV2, FileTypeEnum, ITAccordion, type ITAccordionItem, type ITAccordionProps, ITAlert, type ITAlertProps, ITAvatar, type ITAvatarProps, ITBadget, type ITBadgetProps, type ITBreadcrumbItem, ITBreadcrumbs, type ITBreadcrumbsProps, ITButton, type ITButtonProps, ITCalendar, type ITCalendarProps, ITCard, type ITCardProps, ITCheckbox, type ITCheckboxProps, ITChip, ITChipInput, type ITChipInputProps, type ITChipProps, ITConfirmDialog, type ITConfirmDialogProps, ITDataTable, type ITDataTableFetchParams, type ITDataTableProps, type ITDataTableResponse, ITDatePicker, type ITDatePickerProps, ITDialog, type ITDialogProps, ITDivider, type ITDividerProps, ITDrawer, type ITDrawerProps, ITDropdownMenu, type ITDropdownMenuItem, type ITDropdownMenuProps, ITDropfile, ITEmptyState, type ITEmptyStateProps, ITField, type ITFieldProps, ITFlex, type ITFlexProps, ITFormBuilder, type ITFormBuilderProps, ITFormHeader, type ITFormHeaderProps, ITGrid, type ITGridProps, ITImage, type ITImageProps, ITInput, type ITInputProps, ITLayout, type ITLayoutProps, ITLoader, type LoaderProps as ITLoaderProps, ITMaskedInput, type ITMaskedInputProps, ITMultiSelect, type ITMultiSelectOption, type ITMultiSelectProps, ITNavbar, type ITNavbarProps, type ITNavigationItem, type ITNavigationSubItem, ITPage, ITPageHeader, type ITPageHeaderProps, type ITPageProps, ITPagination, type ITPaginationProps, ITPopover, type ITPopoverProps, ITProgress, type ITProgressProps, ITRadioGroup, type ITRadioGroupProps, type ITRadioOption, ITSearchSelect, type ITSearchSelectProps, ITSearchTable, type ITSearchTableProps, ITSegmentedControl, type ITSegmentedControlProps, ITSelect, type ITSelectProps, ITSidebar, type ITSidebarProps, ITSkeleton, type ITSkeletonProps, ITSlideToggle, type ITSlideToggleProps, ITSlider, type ITSliderProps, ITStack, type ITStackProps, ITStatCard, type ITStatCardProps, ITStepper, type ITStepperProps, type ITTabItem, ITTable, type ITTableProps, ITTabs, type ITTabsProps, ITText, type ITTextProps, ITTextarea, type ITTextareaProps, type ITThemeConfig, type ITThemePalette$1 as ITThemePalette, ITThemeProvider, type ITThemeProviderProps, ITTimePicker, type ITTimePickerProps, ITToast, type ITToastProps, ITTripleFilter, type ITTripleFilterOption, type ITTripleFilterProps, ITWysiwyg, type ITWysiwygProps, type TableDensity, UploadStatus, type UseTableStateOptions, type UseTableStateResult, createValidationSchema, getContrastTextColor, isLightColor, resolveCssColor, useClickOutside, useDebouncedSearch, useEditableRow, useFloatingPanel, useITTheme, useITThemeSafe, useTableState };
+export { type Column, type ColumnFilterMode, type ColumnFilterValue, type ColumnFilters, type FieldConfig, type FieldConfigV2, FileTypeEnum, ITAccordion, type ITAccordionItem, type ITAccordionProps, ITAlert, type ITAlertProps, ITAvatar, type ITAvatarProps, ITBadget, type ITBadgetProps, type ITBreadcrumbItem, ITBreadcrumbs, type ITBreadcrumbsProps, ITButton, type ITButtonProps, ITCalendar, type ITCalendarProps, ITCard, type ITCardProps, ITCheckbox, type ITCheckboxProps, ITChip, ITChipInput, type ITChipInputProps, type ITChipProps, ITConfirmDialog, type ITConfirmDialogProps, ITDataTable, type ITDataTableFetchParams, type ITDataTableProps, type ITDataTableResponse, ITDatePicker, type ITDatePickerProps, ITDialog, type ITDialogProps, ITDivider, type ITDividerProps, ITDrawer, type ITDrawerProps, ITDropdownMenu, type ITDropdownMenuItem, type ITDropdownMenuProps, ITDropfile, ITEmptyState, type ITEmptyStateProps, ITField, type ITFieldProps, ITFlex, type ITFlexProps, ITFormBuilder, type ITFormBuilderProps, ITFormHeader, type ITFormHeaderProps, ITGrid, type ITGridProps, ITImage, type ITImageProps, ITInput, type ITInputProps, ITLayout, type ITLayoutProps, ITLoader, type LoaderProps as ITLoaderProps, ITMaskedInput, type ITMaskedInputProps, ITMultiSelect, type ITMultiSelectOption, type ITMultiSelectProps, ITNavbar, type ITNavbarProps, type ITNavigationItem, type ITNavigationSubItem, ITPage, ITPageHeader, type ITPageHeaderProps, type ITPageProps, ITPagination, type ITPaginationProps, ITPopover, type ITPopoverProps, ITProgress, type ITProgressProps, ITRadioGroup, type ITRadioGroupProps, type ITRadioOption, ITSearchSelect, type ITSearchSelectProps, ITSearchTable, type ITSearchTableProps, ITSegmentedControl, type ITSegmentedControlProps, ITSelect, type ITSelectProps, ITSidebar, type ITSidebarProps, ITSkeleton, type ITSkeletonProps, ITSlideToggle, type ITSlideToggleProps, ITSlider, type ITSliderProps, ITStack, type ITStackProps, ITStatCard, type ITStatCardProps, ITStepper, type ITStepperProps, type ITTabItem, ITTable, type ITTableProps, ITTabs, type ITTabsProps, ITText, type ITTextProps, ITTextarea, type ITTextareaProps, type ITThemeConfig, type ITThemePalette$1 as ITThemePalette, ITThemeProvider, type ITThemeProviderProps, ITTimePicker, type ITTimePickerProps, ITToast, type ITToastProps, ITTripleFilter, type ITTripleFilterOption, type ITTripleFilterProps, ITWysiwyg, type ITWysiwygProps, type TableDensity, UploadStatus, type UseTableStateOptions, type UseTableStateResult, createValidationSchema, getContrastTextColor, isLightColor, resolveCssColor, useClickOutside, useDebouncedSearch, useEditableRow, useFloatingPanel, useITTheme, useITThemeSafe, useTableState };

package/dist/index.d.ts

@@ -19,6 +19,16 @@ interface UseDebouncedSearchResult {
 declare function useDebouncedSearch({ initialValue, debounceMs, onSearch, }: UseDebouncedSearchOptions): UseDebouncedSearchResult;
 
 type TableVariants = "default" | "striped" | "bordered";
+/**
+ * Value stored for a single column filter.
+ *
+ * - `string | number | boolean` — text/number/boolean filters and catalog ids.
+ * - `Date` — a single-date filter (`Column.filter: "date"`).
+ * - `[Date | null, Date | null]` — a date-range filter (`Column.filter: "date-range"`).
+ */
+type ColumnFilterValue = string | number | boolean | Date | [Date | null, Date | null];
+/** Map of column `key` to its active filter value. */
+type ColumnFilters = Record<string, ColumnFilterValue>;
 type TableSize = "sm" | "md" | "lg";
 /**
  * Cell padding / row-height preset for tables. Independent of `TableSize`
@@ -186,13 +196,13 @@ interface UseTableStateOptions {
 interface UseTableStateResult {
     currentPage: number;
     itemsPerPage: number;
-    filters: Record<string, string | boolean | number>;
+    filters: ColumnFilters;
     sortConfig: SortConfig | null;
     totalPages: number;
     setTotalPages: (pages: number) => void;
     goToPage: (page: number) => void;
     handleItemsPerPageChange: (value: number) => void;
-    handleFilterChange: (key: string, value: string | boolean | number | undefined) => void;
+    handleFilterChange: (key: string, value: ColumnFilterValue | undefined) => void;
     handleSort: (key: string, sortable?: boolean) => void;
     resetPage: () => void;
     clearFilters: () => void;
@@ -1123,6 +1133,17 @@ declare function ITConfirmDialog({ isOpen, onClose, onConfirm, title, message, c
 
 /** Data type of a table column, controls default rendering, filter UI, and sort comparison. */
 type ColumnType = "string" | "date" | "number" | "boolean" | "actions" | "catalog";
+/**
+ * Per-column filter mode, set through `Column.filter`.
+ *
+ * - `true` — text/number input (or boolean toggle when `type: "boolean"`).
+ * - `"catalog"` — `ITSelect` dropdown populated from `catalogOptions`.
+ * - `"search"` — `ITSearchSelect` typeahead populated from `catalogOptions`
+ *   (respects `catalogOptions.onSearch` for server-side search).
+ * - `"date"` — `ITDatePicker` single-date filter.
+ * - `"date-range"` — `ITDatePicker` in range mode.
+ */
+type ColumnFilterMode = boolean | "catalog" | "search" | "date" | "date-range";
 /** A single selectable entry for a `"catalog"`-type column's filter/value lookup. */
 interface CatalogOption {
     /** Unique identifier matched against the row's field value. */
@@ -1142,8 +1163,8 @@ interface Column<T = any> {
     currencyMX?: boolean;
     /** Custom action buttons/content rendered for a `"actions"`-type column. Receives the full row object. */
     actions?: (row: T) => React.ReactNode;
-    /** Enables per-column filtering. Pass `true` for a text/number/boolean filter matching `type`, or `"catalog"` to filter against `catalogOptions`. @default false */
-    filter?: boolean | "catalog";
+    /** Enables per-column filtering. Pass `true` for a text/number/boolean filter matching `type`, `"catalog"` for an `ITSelect` fed by `catalogOptions`, `"search"` for an `ITSearchSelect` typeahead, or `"date"` / `"date-range"` for an `ITDatePicker`. @default false */
+    filter?: ColumnFilterMode;
     /** Column data type. Drives default cell rendering, filter UI, and sort comparison. */
     type: ColumnType;
     /** Whether clicking the header sorts by this column. Ignored for `type: "actions"`. @default false */
@@ -1164,6 +1185,22 @@ interface Column<T = any> {
         loading?: boolean;
         /** Shows an error state in the filter UI when the catalog failed to load. @default false */
         error?: boolean;
+        /**
+         * Server-side search handler for a `filter: "search"` column. When provided,
+         * `ITSearchSelect` delegates filtering to this callback (debounced) instead
+         * of filtering `data` locally; the parent is expected to update `data`.
+         */
+        onSearch?: (query: string) => void;
+    };
+    /**
+     * Date bounds applied by the `"date"` and `"date-range"` filters, forwarded to
+     * the underlying `ITDatePicker`. Ignored by every other filter mode.
+     */
+    dateFilterOptions?: {
+        /** Earliest selectable date. */
+        minDate?: Date;
+        /** Latest selectable date. */
+        maxDate?: Date;
     };
     /**
      * Fixed column width. A `number` is treated as pixels (`width: 120` → `120px`);
@@ -1277,8 +1314,12 @@ interface ITDataTableFetchParams {
     page: number;
     /** Number of rows requested per page. */
     limit: number;
-    /** Active per-column filter values (from `Column.filter`), keyed by column `key`. */
-    filters: Record<string, string | number | boolean | Date>;
+    /**
+     * Active per-column filter values (from `Column.filter`), keyed by column
+     * `key`. Scalars for text/number/boolean/date filters, a `Date` for
+     * `filter: "date"`, and a `[start, end]` tuple for `filter: "date-range"`.
+     */
+    filters: ColumnFilters;
     /** Active sort, present only when the user has clicked a sortable column header. */
     sort?: {
         /** Column `key` currently sorted by. */
@@ -1314,7 +1355,7 @@ interface ITDataTableProps<T extends Record<string, unknown>> {
      * Filters managed outside of the ITDataTable (e.g. a date range picker).
      * These will be merged with the internal column filters before calling fetchData.
      */
-    externalFilters?: Record<string, string | number | boolean | Date>;
+    externalFilters?: ColumnFilters;
     /**
      * Custom element to display instead of the default spinner while `isLoading` is true.
      */
@@ -3976,4 +4017,4 @@ declare const resolveCssColor: (colorStr: string, palette?: ITThemePalette$1, is
  */
 declare const getContrastTextColor: (bgColor: string, palette?: ITThemePalette$1, isDarkMode?: boolean) => "text-white" | "text-slate-800";
 
-export { type Column, type FieldConfig, type FieldConfigV2, FileTypeEnum, ITAccordion, type ITAccordionItem, type ITAccordionProps, ITAlert, type ITAlertProps, ITAvatar, type ITAvatarProps, ITBadget, type ITBadgetProps, type ITBreadcrumbItem, ITBreadcrumbs, type ITBreadcrumbsProps, ITButton, type ITButtonProps, ITCalendar, type ITCalendarProps, ITCard, type ITCardProps, ITCheckbox, type ITCheckboxProps, ITChip, ITChipInput, type ITChipInputProps, type ITChipProps, ITConfirmDialog, type ITConfirmDialogProps, ITDataTable, type ITDataTableFetchParams, type ITDataTableProps, type ITDataTableResponse, ITDatePicker, type ITDatePickerProps, ITDialog, type ITDialogProps, ITDivider, type ITDividerProps, ITDrawer, type ITDrawerProps, ITDropdownMenu, type ITDropdownMenuItem, type ITDropdownMenuProps, ITDropfile, ITEmptyState, type ITEmptyStateProps, ITField, type ITFieldProps, ITFlex, type ITFlexProps, ITFormBuilder, type ITFormBuilderProps, ITFormHeader, type ITFormHeaderProps, ITGrid, type ITGridProps, ITImage, type ITImageProps, ITInput, type ITInputProps, ITLayout, type ITLayoutProps, ITLoader, type LoaderProps as ITLoaderProps, ITMaskedInput, type ITMaskedInputProps, ITMultiSelect, type ITMultiSelectOption, type ITMultiSelectProps, ITNavbar, type ITNavbarProps, type ITNavigationItem, type ITNavigationSubItem, ITPage, ITPageHeader, type ITPageHeaderProps, type ITPageProps, ITPagination, type ITPaginationProps, ITPopover, type ITPopoverProps, ITProgress, type ITProgressProps, ITRadioGroup, type ITRadioGroupProps, type ITRadioOption, ITSearchSelect, type ITSearchSelectProps, ITSearchTable, type ITSearchTableProps, ITSegmentedControl, type ITSegmentedControlProps, ITSelect, type ITSelectProps, ITSidebar, type ITSidebarProps, ITSkeleton, type ITSkeletonProps, ITSlideToggle, type ITSlideToggleProps, ITSlider, type ITSliderProps, ITStack, type ITStackProps, ITStatCard, type ITStatCardProps, ITStepper, type ITStepperProps, type ITTabItem, ITTable, type ITTableProps, ITTabs, type ITTabsProps, ITText, type ITTextProps, ITTextarea, type ITTextareaProps, type ITThemeConfig, type ITThemePalette$1 as ITThemePalette, ITThemeProvider, type ITThemeProviderProps, ITTimePicker, type ITTimePickerProps, ITToast, type ITToastProps, ITTripleFilter, type ITTripleFilterOption, type ITTripleFilterProps, ITWysiwyg, type ITWysiwygProps, type TableDensity, UploadStatus, type UseTableStateOptions, type UseTableStateResult, createValidationSchema, getContrastTextColor, isLightColor, resolveCssColor, useClickOutside, useDebouncedSearch, useEditableRow, useFloatingPanel, useITTheme, useITThemeSafe, useTableState };
+export { type Column, type ColumnFilterMode, type ColumnFilterValue, type ColumnFilters, type FieldConfig, type FieldConfigV2, FileTypeEnum, ITAccordion, type ITAccordionItem, type ITAccordionProps, ITAlert, type ITAlertProps, ITAvatar, type ITAvatarProps, ITBadget, type ITBadgetProps, type ITBreadcrumbItem, ITBreadcrumbs, type ITBreadcrumbsProps, ITButton, type ITButtonProps, ITCalendar, type ITCalendarProps, ITCard, type ITCardProps, ITCheckbox, type ITCheckboxProps, ITChip, ITChipInput, type ITChipInputProps, type ITChipProps, ITConfirmDialog, type ITConfirmDialogProps, ITDataTable, type ITDataTableFetchParams, type ITDataTableProps, type ITDataTableResponse, ITDatePicker, type ITDatePickerProps, ITDialog, type ITDialogProps, ITDivider, type ITDividerProps, ITDrawer, type ITDrawerProps, ITDropdownMenu, type ITDropdownMenuItem, type ITDropdownMenuProps, ITDropfile, ITEmptyState, type ITEmptyStateProps, ITField, type ITFieldProps, ITFlex, type ITFlexProps, ITFormBuilder, type ITFormBuilderProps, ITFormHeader, type ITFormHeaderProps, ITGrid, type ITGridProps, ITImage, type ITImageProps, ITInput, type ITInputProps, ITLayout, type ITLayoutProps, ITLoader, type LoaderProps as ITLoaderProps, ITMaskedInput, type ITMaskedInputProps, ITMultiSelect, type ITMultiSelectOption, type ITMultiSelectProps, ITNavbar, type ITNavbarProps, type ITNavigationItem, type ITNavigationSubItem, ITPage, ITPageHeader, type ITPageHeaderProps, type ITPageProps, ITPagination, type ITPaginationProps, ITPopover, type ITPopoverProps, ITProgress, type ITProgressProps, ITRadioGroup, type ITRadioGroupProps, type ITRadioOption, ITSearchSelect, type ITSearchSelectProps, ITSearchTable, type ITSearchTableProps, ITSegmentedControl, type ITSegmentedControlProps, ITSelect, type ITSelectProps, ITSidebar, type ITSidebarProps, ITSkeleton, type ITSkeletonProps, ITSlideToggle, type ITSlideToggleProps, ITSlider, type ITSliderProps, ITStack, type ITStackProps, ITStatCard, type ITStatCardProps, ITStepper, type ITStepperProps, type ITTabItem, ITTable, type ITTableProps, ITTabs, type ITTabsProps, ITText, type ITTextProps, ITTextarea, type ITTextareaProps, type ITThemeConfig, type ITThemePalette$1 as ITThemePalette, ITThemeProvider, type ITThemeProviderProps, ITTimePicker, type ITTimePickerProps, ITToast, type ITToastProps, ITTripleFilter, type ITTripleFilterOption, type ITTripleFilterProps, ITWysiwyg, type ITWysiwygProps, type TableDensity, UploadStatus, type UseTableStateOptions, type UseTableStateResult, createValidationSchema, getContrastTextColor, isLightColor, resolveCssColor, useClickOutside, useDebouncedSearch, useEditableRow, useFloatingPanel, useITTheme, useITThemeSafe, useTableState };