react-start-kit-shared 1.0.0

package/dist/types/components/datatable/DataTable.d.ts

@@ -0,0 +1,196 @@
+import { ReactNode } from 'react';
+import { DropdownContainerProps } from 'react-start-kit/dropdown';
+import { ColumnType } from '../../types';
+import { ActionInterface, ActionsProps } from '../actions';
+import { ExportDataInterface, ExportDataProps } from '../export';
+import { FilterInterface, FilterWrapperProps, SearchProps } from '../filters';
+import { MyPaginationProps } from '../pagination/MyPagination.tsx';
+import { MyTableProps } from './MyTable';
+/**
+ * Minimal pagination wrapper contract used by `DataTable`.
+ *
+ * Notes
+ * - Only `page`, `limit`, and `totalPages` are required. Other fields are optional and
+ *   may be provided by your API for convenience.
+ * - The actual rows array can be stored in any key, controlled via `dataKey` prop
+ *   (defaults to `"docs"`).
+ */
+export interface PaginationInterface<TData> {
+    /** Array of rows for the current page. Used when `dataKey` is set to `"docs"`. */
+    docs?: TData[];
+    /** Zero-based index of the first item on the current page (if provided by API). */
+    offset?: number;
+    /** Page size (items per page). */
+    limit: number;
+    /** Total number of pages available. */
+    totalPages: number;
+    /** Total number of items across all pages (if available). */
+    total?: number;
+    /** Current page number (1-based). */
+    page: number;
+    /** Convenience counter for the first item index on the page (if provided). */
+    pagingCounter?: number;
+    /** Whether a previous page exists. */
+    hasPrevPage?: boolean;
+    /** Whether a next page exists. */
+    hasNextPage?: boolean;
+    /** Previous page number, if available. */
+    prevPage?: number;
+    /** Next page number, if available. */
+    nextPage?: number;
+}
+/**
+ * Props for the DataTable component.
+ *
+ * @template TData - Row data type.
+ * @template TPaginationData - Pagination wrapper type.
+ */
+export interface DataTableProps<TData, TPaginationData extends PaginationInterface<TData>> extends Omit<MyTableProps<TData>, 'rows'> {
+    /** Pagination data source. */
+    dataSource?: TPaginationData;
+    /** Callback for parameter changes (pagination, sorting, filtering). */
+    onParamChange?: (param: Record<string, unknown>) => void;
+    /** Whether to enable pagination. */
+    hasPagination?: true;
+    /** Options for the export data dropdown. */
+    exportOptions?: ExportDataInterface[];
+    /** Whether to enable search functionality. */
+    hasSearch?: true;
+    /** Whether the table data is loading. */
+    loading?: boolean;
+    /** Array of filters to display. */
+    filters?: FilterInterface[];
+    /** Array of actions to display. */
+    actions?: ActionInterface[];
+    /** Callback for filter changes. */
+    handleFilterChange?: (filters: Record<string, unknown>) => void;
+    /** Unique key for the table, used for column persistence. */
+    tableKey: string;
+    /** The key in dataSource where the data array is located. Defaults to "docs". */
+    dataKey?: keyof TPaginationData;
+    /** Whether to show the columns visibility dropdown. */
+    hasColumnsVisibilityDropdown?: true;
+    /** Whether to show the columns visibility dropdown. */
+    showAppliedFilters?: boolean;
+    /** Callback when columns are updated (e.g., visibility toggled). */
+    onColumnsUpdate?: (columns: ColumnType<TData>[]) => void;
+    /** Whether the export action is loading. */
+    exportLoading?: boolean;
+    /** Props for the Actions component. */
+    actionProps?: Partial<ActionsProps>;
+    /** Props for the FilterWrapper component. */
+    filterWrapperProps?: Partial<FilterWrapperProps>;
+    /** Props for the ExportData component. */
+    exportOptionsProps?: Partial<ExportDataProps>;
+    searchProps?: Partial<SearchProps>;
+    paginationProps?: Partial<MyPaginationProps>;
+    /** Props for the columns visibility dropdown. */
+    columnsVisibilityProps?: DropdownContainerProps & {
+        title?: ReactNode;
+        resetText?: ReactNode;
+    };
+}
+/**
+ * DataTable is a composable, high-level table that brings together search, filters,
+ * column visibility management, header actions, exporting, and pagination.
+ * It renders `MyTable` for rows and, when enabled, shows header controls and a footer with pagination.
+ *
+ * Generic Types
+ * - `TData` — Row data shape (type of each item in the rows array).
+ * - `TPaginationData` — Pagination wrapper type containing rows and pagination meta; defaults to
+ *   `PaginationInterface<TData>`.
+ *
+ * Key Behaviors
+ * - Emits `onParamChange` when search text, filters, page, limit, or sort order change.
+ * - Persists column visibility per `tableKey` via `useColumns` and informs parent with `onColumnsUpdate`.
+ * - Renders header controls only when the related feature is enabled/has content.
+ *
+ * Accessibility
+ * - Header controls and dropdowns reuse shared primitives that include keyboard and ARIA support.
+ *
+ * Internationalization
+ * - Text such as "Export", "Customize columns", and "Reset columns" are resolved via `react-i18next`.
+ *
+ * Usage Examples
+ * 1) Minimal paginated table (uses default `dataKey = "docs"`)
+ * ```tsx
+ * type User = { id: string; name: string };
+ * const data = { docs: [{ id: '1', name: 'Ada' }], page: 1, limit: 10, totalPages: 1 };
+ *
+ * <DataTable<User>
+ *   tableKey="users-table"
+ *   columns={[{ key: 'name', name: 'Name' }]}
+ *   rowKey="id"
+ *   dataSource={data}
+ *   hasPagination
+ * />
+ * ```
+ *
+ * 2) Custom `dataKey` and column visibility persistence
+ * ```tsx
+ * type Row = { id: number; title: string };
+ * const payload = { items: [{ id: 1, title: 'Hello' }], page: 1, limit: 20, totalPages: 1 };
+ *
+ * <DataTable<Row>
+ *   tableKey="posts"
+ *   columns={[{ key: 'title', name: 'Title' }]}
+ *   rowKey="id"
+ *   dataSource={payload}
+ *   dataKey="items"
+ *   hasColumnsVisibilityDropdown
+ * />
+ * ```
+ *
+ * 3) Responding to user interactions via `onParamChange`
+ * ```tsx
+ * const [params, setParams] = useState({ page: 1, limit: 10 });
+ *
+ * <DataTable
+ *   tableKey="logs"
+ *   columns={[{ key: 'message', name: 'Message' }]}
+ *   rowKey="id"
+ *   params={params}
+ *   onParamChange={setParams}
+ *   hasSearch
+ *   hasPagination
+ * />
+ * ```
+ *
+ * Notes and Best Practices
+ * - Ensure `rowKey` points to a stable unique field in `TData` to avoid key collisions.
+ * - When arrays like `exportOptions`, `filters`, or `actions` are empty, their sections are not rendered.
+ * - Sorting emits `{ sortField, sortOrder }` through `onParamChange` when the user toggles a column sort.
+ *
+ * @template TData - Row data type.
+ * @template TPaginationData - Pagination wrapper type.
+ * @param dataSource - Paginated data source object.
+ * @param columns - Column definitions.
+ * @param rowKey - Property name used as a unique row key.
+ * @param hasSearch - Whether to display the search input.
+ * @param exportOptions - Export menu options.
+ * @param hasPagination - Whether to render the pagination footer.
+ * @param onParamChange - Emits parameter changes for pagination/sorting/search/filters.
+ * @param dataKey - Key within `dataSource` that contains the row array.
+ * @param loading - Whether the table data is loading.
+ * @param tableKey - Unique key for persisting column visibility state.
+ * @param filters - Filter configurations to render.
+ * @param actions - Header actions.
+ * @param handleFilterChange - Callback executed when filter values change.
+ * @param params - Current list parameters.
+ * @param exportLoading - Whether the export action is loading.
+ * @param onColumnsUpdate - Notifies parent whenever columns state changes.
+ * @param hasColumnsVisibilityDropdown - Whether to show columns customize dropdown.
+ * @param showAppliedFilters - Whether to show applied filters.
+ * @param onSelectedItemsChange - Callback when selected rows change.
+ * @param actionProps - Props for the Actions component.
+ * @param filterWrapperProps - Props for the FilterWrapper component.
+ * @param exportOptionsProps - Props for the ExportData component.
+ * @param columnsVisibilityProps - Props for columns visibility dropdown.
+ * @param paginationProps - Props for the MyPagination component.
+ * @param searchProps - Props for the Search component.
+ * @param className - Additional CSS classes.
+ * @param props - Additional props passed to MyTable.
+ * @returns {JSX.Element} React element that renders a complete data table experience.
+ */
+export declare const DataTable: <TData, TPaginationData extends PaginationInterface<TData> = PaginationInterface<TData>>({ dataSource, columns, rowKey, hasSearch, exportOptions, hasPagination, onParamChange, dataKey, loading, tableKey, filters, actions, handleFilterChange, params, exportLoading, onColumnsUpdate, hasColumnsVisibilityDropdown, showAppliedFilters, actionProps, filterWrapperProps, exportOptionsProps, columnsVisibilityProps, paginationProps, searchProps, className, ...props }: DataTableProps<TData, TPaginationData>) => import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=DataTable.d.ts.map

package/dist/types/components/datatable/DataTable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DataTable.d.ts","sourceRoot":"","sources":["../../../../src/components/datatable/DataTable.tsx"],"names":[],"mappings":"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"}

package/dist/types/components/datatable/MyTable.d.ts

@@ -0,0 +1,56 @@
+import { ComponentProps } from 'react';
+import { UseSortableProps } from '../../hooks';
+import { ColumnType } from '../../types';
+/**
+ * Props for the MyTable component.
+ * @template TData - The type of data in the table.
+ */
+export interface MyTableProps<TData> extends ComponentProps<'table'> {
+    /** Array of data rows to display. */
+    rows?: TData[];
+    /** Column definitions. */
+    columns: ColumnType<TData>[];
+    /** Callback when a row is clicked. */
+    onRowClick?: (row: TData) => void;
+    /** Whether to show row numbers. */
+    hasNumbers?: boolean;
+    /** Whether to show selection checkboxes. */
+    hasCheckbox?: boolean;
+    /** Unique key for each row. */
+    rowKey: keyof TData;
+    /** Current table parameters (page, limit, sort). */
+    params?: Record<string, unknown>;
+    /** Total number of items (optional, often used with pagination context). */
+    total?: number;
+    /** Array of currently selected item keys. */
+    selectedItems?: TData[keyof TData][];
+    /** Callback when selected items change. */
+    onSelectedItemsChange?: (selectedItems?: TData[keyof TData][]) => void;
+    /** Callback when sort order changes. */
+    onSortOrderChange?: (params: Omit<UseSortableProps<TData>, 'onSortOrderChange'>) => void;
+    /** Whether the header should stick to the top. */
+    isStickyHeader?: true;
+}
+/**
+ * MyTable renders a generic data table with optional numbering, selection checkboxes,
+ * sortable columns and sticky header. It is a presentational component and delegates
+ * sorting/selection state via hooks and callbacks.
+ *
+ * @template TData - The row data type.
+ * @param rows - Array of data rows.
+ * @param columns - Column definitions.
+ * @param onRowClick - Callback when a row is clicked.
+ * @param rowKey - Unique key for each row.
+ * @param params - Current table parameters.
+ * @param hasNumbers - Whether to show row numbers.
+ * @param hasCheckbox - Whether to show selection checkboxes.
+ * @param selectedItems - Array of currently selected item keys.
+ * @param onSelectedItemsChange - Callback when selected items change.
+ * @param onSortOrderChange - Callback when sort order changes.
+ * @param isStickyHeader - Whether the header should stick to the top.
+ * @param className - Additional CSS classes.
+ * @param props - Component props.
+ * @returns {JSX.Element} React element containing the table.
+ */
+export declare const MyTable: <TData>({ rows, columns, onRowClick, rowKey, params, hasNumbers, hasCheckbox, selectedItems, onSelectedItemsChange, onSortOrderChange, isStickyHeader, className, ...props }: MyTableProps<TData>) => import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=MyTable.d.ts.map

package/dist/types/components/datatable/MyTable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MyTable.d.ts","sourceRoot":"","sources":["../../../../src/components/datatable/MyTable.tsx"],"names":[],"mappings":"AAMA,OAAO,EAAE,KAAK,cAAc,EAAa,MAAM,OAAO,CAAC;AAYvD,OAAO,EAA6B,KAAK,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAI9C;;;GAGG;AACH,MAAM,WAAW,YAAY,CAAC,KAAK,CAAE,SAAQ,cAAc,CAAC,OAAO,CAAC;IAClE,qCAAqC;IACrC,IAAI,CAAC,EAAE,KAAK,EAAE,CAAC;IACf,0BAA0B;IAC1B,OAAO,EAAE,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;IAC7B,sCAAsC;IACtC,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,KAAK,KAAK,IAAI,CAAC;IAClC,mCAAmC;IACnC,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,4CAA4C;IAC5C,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,+BAA+B;IAC/B,MAAM,EAAE,MAAM,KAAK,CAAC;IACpB,oDAAoD;IACpD,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,4EAA4E;IAC5E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,6CAA6C;IAC7C,aAAa,CAAC,EAAE,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;IACrC,2CAA2C;IAC3C,qBAAqB,CAAC,EAAE,CAAC,aAAa,CAAC,EAAE,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,KAAK,IAAI,CAAC;IACvE,wCAAwC;IACxC,iBAAiB,CAAC,EAAE,CAClB,MAAM,EAAE,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,EAAE,mBAAmB,CAAC,KACvD,IAAI,CAAC;IACV,kDAAkD;IAClD,cAAc,CAAC,EAAE,IAAI,CAAC;CACvB;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,OAAO,GAAI,KAAK,EAAG,sKAiB7B,YAAY,CAAC,KAAK,CAAC,4CAmIrB,CAAC"}

package/dist/types/components/datatable/index.d.ts

@@ -0,0 +1,3 @@
+export * from './DataTable';
+export * from './MyTable';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/components/datatable/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/datatable/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC"}

package/dist/types/components/datepicker/DateRangePicker.d.ts

@@ -0,0 +1,50 @@
+import { ReactNode } from 'react';
+import { DateRange } from 'react-day-picker';
+import { CalendarProps } from 'react-start-kit/calendar';
+import { InputProps } from 'react-start-kit/form';
+/**
+ * Type definition for a date range preset configuration.
+ */
+export type PresetType = {
+    from: Date;
+    to: Date;
+    /** Label for the preset (e.g., "Last 7 days"). */
+    label: ReactNode;
+    isActive?: boolean;
+};
+/**
+ * Props for the DateRangePicker component.
+ */
+export type DateRangePickerProps = Omit<CalendarProps, 'mode' | 'disabled' | 'selected'> & {
+    /** The date format string (e.g., 'YYYY-MM-DD'). */
+    format?: string;
+    /** Placeholder text when no date is selected. */
+    placeholder?: string;
+    /** The currently selected date range. */
+    selected?: DateRange;
+    /** Timezone for date calculations. */
+    timezone?: string;
+    /** Error message to display (modifies styling). */
+    error?: string;
+    /** Callback function when a date range is selected. */
+    onRangeSelected?: (value?: DateRange) => void;
+    inputProps?: InputProps;
+    disabled?: boolean;
+    defaultPresets?: PresetType[];
+};
+/**
+ * DateRangePicker displays a two-month range picker with helpful presets.
+ *
+ * @param props.format - Display date format.
+ * @param props.selected - Currently selected date range.
+ * @param props.timezone - Time zone for date calculations.
+ * @param props.onRangeSelected - Callback when a full range is selected.
+ * @param props.placeholder - Placeholder when no date selected.
+ * @param props.error - Optional error message that adjusts styling.
+ * @param props.inputProps - Props passed to the underlying Input component.
+ * @param props.disabled - Whether the date range picker is disabled.
+ * @param props.defaultPresets - dafault presets list for the picker.
+ * @returns A date range picker component.
+ */
+export declare const DateRangePicker: ({ className, format, selected, timezone, onRangeSelected, placeholder, defaultPresets, disabled, error, inputProps, ...props }: DateRangePickerProps) => import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=DateRangePicker.d.ts.map

package/dist/types/components/datepicker/DateRangePicker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DateRangePicker.d.ts","sourceRoot":"","sources":["../../../../src/components/datepicker/DateRangePicker.tsx"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,SAAS,EAAgC,MAAM,OAAO,CAAC;AACrE,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAGlD,OAAO,EAAY,KAAK,aAAa,EAAQ,MAAM,0BAA0B,CAAC;AAC9E,OAAO,EAAS,KAAK,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAQ9D;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG;IACvB,IAAI,EAAE,IAAI,CAAC;IACX,EAAE,EAAE,IAAI,CAAC;IACT,kDAAkD;IAClD,KAAK,EAAE,SAAS,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,IAAI,CACrC,aAAa,EACb,MAAM,GAAG,UAAU,GAAG,UAAU,CACjC,GAAG;IACF,mDAAmD;IACnD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iDAAiD;IACjD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yCAAyC;IACzC,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,sCAAsC;IACtC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,mDAAmD;IACnD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uDAAuD;IACvD,eAAe,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,SAAS,KAAK,IAAI,CAAC;IAC9C,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,cAAc,CAAC,EAAE,UAAU,EAAE,CAAC;CAC/B,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,eAAe,GAAI,gIAY7B,oBAAoB,4CA2KtB,CAAC"}

package/dist/types/components/datepicker/index.d.ts

@@ -0,0 +1,2 @@
+export * from './DateRangePicker';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/components/datepicker/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/datepicker/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC"}

package/dist/types/components/empty/Empty.d.ts

@@ -0,0 +1,19 @@
+import { HTMLAttributes, ReactNode } from 'react';
+/**
+ * Props for the Empty component.
+ */
+export interface EmptyProps extends HTMLAttributes<HTMLDivElement> {
+    /** Optional custom icon. Defaults to a folder icon. */
+    icon?: ReactNode;
+}
+/**
+ * Empty displays a simple empty state with an optional icon and message.
+ *
+ * @param children - Optional custom message/content.
+ * @param icon - Optional custom icon. Defaults to a folder icon.
+ * @param className - Additional CSS classes.
+ * @param props - Additional HTML attributes for the container.
+ * @returns {JSX.Element} A centered empty state component.
+ */
+export declare const Empty: ({ children, icon, className, ...props }: EmptyProps) => import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=Empty.d.ts.map

package/dist/types/components/empty/Empty.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Empty.d.ts","sourceRoot":"","sources":["../../../../src/components/empty/Empty.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAIvD;;GAEG;AACH,MAAM,WAAW,UAAW,SAAQ,cAAc,CAAC,cAAc,CAAC;IAChE,uDAAuD;IACvD,IAAI,CAAC,EAAE,SAAS,CAAC;CAClB;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,KAAK,GAAI,yCAAyC,UAAU,4CAexE,CAAC"}

package/dist/types/components/empty/index.d.ts

@@ -0,0 +1,2 @@
+export * from './Empty';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/components/empty/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/empty/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC"}

package/dist/types/components/export/ExportData.d.ts

@@ -0,0 +1,52 @@
+import { ReactNode } from 'react';
+import { DropdownContainerProps } from 'react-start-kit/dropdown';
+/**
+ * Describes a single export option in the ExportData dropdown.
+ *
+ * - Use `label` to render the visible option content (text or any React node).
+ * - Provide `onClick` to trigger the export logic (CSV/XLS/PDF, etc.).
+ */
+export interface ExportDataInterface {
+    /** Visible content for the dropdown item (text, icon, etc.). */
+    label: ReactNode;
+    /** Callback executed when the export option is selected. */
+    onClick: () => void;
+    access?: string[];
+}
+/**
+ * Props for the `ExportData` component.
+ *
+ * - `options` — A list of export actions displayed in the dropdown.
+ * - `loading` — When `true`, shows a small spinner in the button to indicate an export is in progress.
+ */
+export interface ExportDataProps extends DropdownContainerProps {
+    /** Export actions displayed in the dropdown. */
+    options: ExportDataInterface[];
+    /** If `true`, renders a spinner icon in the button. */
+    loading?: boolean;
+    /** Title for the export button. */
+    title?: ReactNode;
+}
+/**
+ * ExportData renders a compact dropdown button for exporting data in various formats.
+ *
+ * Behavior
+ * - Shows a button with an export icon and localized "Export" label.
+ * - Clicking opens a dropdown with the provided `options` list.
+ * - Each option calls its `onClick` handler when selected.
+ *
+ * Accessibility
+ * - Uses the shared Dropdown primitives and Button which provide keyboard and ARIA support.
+ *
+ * Internationalization
+ * - The button label is translated via `react-i18next` using the `Export` key.
+ *
+ * @param options - Array of export actions with label and onClick handler.
+ * @param loading - When true, shows a spinner in the button.
+ * @param triggerProps - Props passed to the dropdown trigger.
+ * @param contentProps - Props passed to the dropdown content.
+ * @param title - Optional title for the export button.
+ * @returns {JSX.Element} React element rendering the export data dropdown.
+ */
+export declare const ExportData: ({ options, loading, triggerProps, contentProps, title, }: ExportDataProps) => import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=ExportData.d.ts.map

package/dist/types/components/export/ExportData.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExportData.d.ts","sourceRoot":"","sources":["../../../../src/components/export/ExportData.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAGvC,OAAO,EACL,KAAK,sBAAsB,EAK5B,MAAM,0BAA0B,CAAC;AAGlC;;;;;GAKG;AACH,MAAM,WAAW,mBAAmB;IAClC,gEAAgE;IAChE,KAAK,EAAE,SAAS,CAAC;IACjB,4DAA4D;IAC5D,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;;;;GAKG;AACH,MAAM,WAAW,eAAgB,SAAQ,sBAAsB;IAC7D,gDAAgD;IAChD,OAAO,EAAE,mBAAmB,EAAE,CAAC;IAC/B,uDAAuD;IACvD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,mCAAmC;IACnC,KAAK,CAAC,EAAE,SAAS,CAAC;CACnB;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,UAAU,GAAI,0DAMxB,eAAe,4CA+BjB,CAAC"}

package/dist/types/components/export/index.d.ts

@@ -0,0 +1,2 @@
+export * from './ExportData';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/components/export/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/export/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC"}

package/dist/types/components/filters/AppliedFilters.d.ts

@@ -0,0 +1,24 @@
+import { CardProps } from 'react-start-kit/card';
+import { FilterInterface } from './FilterWrapper.tsx';
+/**
+ * Props for the AppliedFilters component.
+ */
+export interface AppliedFiltersProps extends CardProps {
+    /** Array of filter definitions to render. */
+    filters?: FilterInterface[];
+    /** Current active parameters/filters. */
+    params?: Record<string, unknown>;
+    /** Callback fired when filters are applied. */
+    onFilter?: (filters: Record<string, unknown>) => void;
+}
+/**
+ * AppliedFilters displays active filter values as removable buttons/tags.
+ *
+ * @param props.filters - Array of filter definitions to map values to labels.
+ * @param props.params - Current active filter parameters.
+ * @param props.onFilter - Callback fired when a filter is removed.
+ * @param props.className - Additional CSS classes.
+ * @returns {JSX.Element | false} A list of active filter buttons or false if no filters are active
+ */
+export declare const AppliedFilters: import('react').NamedExoticComponent<AppliedFiltersProps>;
+//# sourceMappingURL=AppliedFilters.d.ts.map

package/dist/types/components/filters/AppliedFilters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AppliedFilters.d.ts","sourceRoot":"","sources":["../../../../src/components/filters/AppliedFilters.tsx"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAEtD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAE3D;;GAEG;AACH,MAAM,WAAW,mBAAoB,SAAQ,SAAS;IACpD,6CAA6C;IAC7C,OAAO,CAAC,EAAE,eAAe,EAAE,CAAC;IAC5B,yCAAyC;IACzC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;CACvD;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,cAAc,2DAuEzB,CAAC"}

package/dist/types/components/filters/FilterWrapper.d.ts

@@ -0,0 +1,58 @@
+import { ReactNode } from 'react';
+import { FieldValues } from 'react-hook-form';
+import { ButtonProps } from 'react-start-kit/button';
+import { Option } from 'react-start-kit/form';
+import { PopoverContainerProps } from 'react-start-kit/popover';
+/**
+ * Interface representing a filter configuration.
+ */
+export interface FilterInterface {
+    /** Label for the filter field. */
+    label?: ReactNode;
+    /** Placeholder text for the input/select. */
+    placeholder?: string;
+    /** Default value for the filter. */
+    value?: string | string[];
+    /** Name of the filter field (used as key). */
+    name: string;
+    /** Whether the filter supports multiple values (for select inputs). */
+    isMulti?: boolean;
+    /** Whether the filter supports searchable inputs (for select inputs). */
+    isSearchable?: boolean;
+    /** Options for select inputs. */
+    options?: Option[];
+    access?: string[];
+}
+/**
+ * Props for the FilterWrapper component.
+ */
+export interface FilterWrapperProps extends Omit<ButtonProps, 'title'>, PopoverContainerProps {
+    /** Array of filter definitions to render. */
+    filters: FilterInterface[];
+    /** Current active parameters/filters. */
+    params?: Record<string, unknown>;
+    /** Callback fired when filters are applied. */
+    onFilter?: (filters: Record<string, unknown>) => void;
+    /** Callback fired when the filter popover is closed/cancelled. */
+    onCancel?: () => void;
+    /** Callback fired when filter form values change. */
+    onChange?: (filters: FieldValues) => void;
+    /** Title for the filter button. */
+    title?: ReactNode;
+    /** Text for the reset button. */
+    resetText?: ReactNode;
+    /** Text for the apply button. */
+    applyText?: ReactNode;
+}
+/**
+ * FilterWrapper shows a popover with a dynamic list of field filters and emits selected filter values.
+ *
+ * @param props.filters - Array of filter definitions to render.
+ * @param props.params - Current params used to detect active filters.
+ * @param props.onFilter - Callback fired when user applies filters.
+ * @param props.onCancel - Callback fired on cancel.
+ * @param props.onChange - Callback fired whenever filter form values change.
+ * @returns {JSX.Element} A filter button that opens a popover with filter controls
+ */
+export declare const FilterWrapper: import('react').NamedExoticComponent<FilterWrapperProps>;
+//# sourceMappingURL=FilterWrapper.d.ts.map

package/dist/types/components/filters/FilterWrapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FilterWrapper.d.ts","sourceRoot":"","sources":["../../../../src/components/filters/FilterWrapper.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAQ,KAAK,SAAS,EAAoC,MAAM,OAAO,CAAC;AAC/E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEnD,OAAO,EAAU,KAAK,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,EAAQ,KAAK,MAAM,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAEL,KAAK,qBAAqB,EAG3B,MAAM,yBAAyB,CAAC;AAIjC;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,kCAAkC;IAClC,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,6CAA6C;IAC7C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oCAAoC;IACpC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAC1B,8CAA8C;IAC9C,IAAI,EAAE,MAAM,CAAC;IACb,uEAAuE;IACvE,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,yEAAyE;IACzE,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,iCAAiC;IACjC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,kBACf,SAAQ,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC,EAAE,qBAAqB;IACzD,6CAA6C;IAC7C,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,yCAAyC;IACzC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IACtD,kEAAkE;IAClE,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;IACtB,qDAAqD;IACrD,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,IAAI,CAAC;IAC1C,mCAAmC;IACnC,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,iCAAiC;IACjC,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,iCAAiC;IACjC,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,aAAa,0DA4HxB,CAAC"}

package/dist/types/components/filters/Search.d.ts

@@ -0,0 +1,28 @@
+import { CardProps } from 'react-start-kit/card';
+import { InputProps } from 'react-start-kit/form';
+/**
+ * Props for the Search component.
+ */
+export type SearchProps = Omit<CardProps, 'title'> & {
+    /** Custom placeholder text for the input. */
+    placeholder?: string;
+    /** Callback fired when the search is triggered. */
+    onSearchChange: (search?: string) => void;
+    inputProps?: InputProps;
+};
+/**
+ * Search input with a submit button that triggers a search action.
+ *
+ * This component renders a search input field and a search button. The search
+ * is triggered when the user presses Enter or clicks the button. The search
+ * value is then passed to the `onSearchChange` callback.
+ *
+ * @param {SearchProps} props - The props for the component.
+ * @param {string} [props.placeholder] - Optional placeholder text for the input field.
+ * @param {Function} props.onSearchChange - Callback function that is called when a search is performed.
+ * @param {string} [props.className] - Optional class name for the component.
+ * @param {InputProps} [props.inputProps] - Optional props to pass to the underlying Input component.
+ * @returns {JSX.Element} A search input field with submit button
+ */
+export declare const Search: ({ placeholder, onSearchChange, className, inputProps, ...props }: SearchProps) => import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=Search.d.ts.map

package/dist/types/components/filters/Search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Search.d.ts","sourceRoot":"","sources":["../../../../src/components/filters/Search.tsx"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAS,KAAK,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAI9D;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,GAAG;IACnD,6CAA6C;IAC7C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mDAAmD;IACnD,cAAc,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1C,UAAU,CAAC,EAAE,UAAU,CAAC;CACzB,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,MAAM,GAAI,kEAMpB,WAAW,4CAoCb,CAAC"}

package/dist/types/components/filters/SearchWithCtrl.d.ts

@@ -0,0 +1,25 @@
+import { CardProps } from 'react-start-kit/card';
+import { InputProps } from 'react-start-kit/form';
+/**
+ * Props for the SearchWithCtrl component.
+ */
+type SearchWithCtrlProps = Omit<CardProps, 'title'> & {
+    /** Custom placeholder text for the input. */
+    placeholder?: string;
+    /** Callback fired when the search is triggered. */
+    onSearchChange: (search?: string) => void;
+    inputProps?: InputProps;
+};
+/**
+ * A search input that submits when the user presses Ctrl + Enter or clicks the search button.
+ *
+ * @param {SearchWithCtrlProps} props - The props for the component.
+ * @param {string} [props.placeholder] - Custom placeholder text for the input.
+ * @param {Function} props.onSearchChange - Callback fired with the search value.
+ * @param {string} [props.className] - Optional class name for the component.
+ * @param {InputProps} [props.inputProps] - Optional props to pass to the underlying Input component.
+ * @returns {JSX.Element} A search input field with Ctrl+Enter support
+ */
+export declare const SearchWithCtrl: ({ placeholder, onSearchChange, className, inputProps, ...props }: SearchWithCtrlProps) => import("react/jsx-runtime").JSX.Element;
+export {};
+//# sourceMappingURL=SearchWithCtrl.d.ts.map

package/dist/types/components/filters/SearchWithCtrl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SearchWithCtrl.d.ts","sourceRoot":"","sources":["../../../../src/components/filters/SearchWithCtrl.tsx"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAS,KAAK,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAI9D;;GAEG;AACH,KAAK,mBAAmB,GAAG,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,GAAG;IACpD,6CAA6C;IAC7C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mDAAmD;IACnD,cAAc,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1C,UAAU,CAAC,EAAE,UAAU,CAAC;CACzB,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,cAAc,GAAI,kEAM5B,mBAAmB,4CAgCrB,CAAC"}

package/dist/types/components/filters/index.d.ts

@@ -0,0 +1,4 @@
+export * from './FilterWrapper';
+export * from './Search';
+export * from './SearchWithCtrl';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/components/filters/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/filters/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,UAAU,CAAC;AACzB,cAAc,kBAAkB,CAAC"}

package/dist/types/components/form/MyCheckbox.d.ts

@@ -0,0 +1,20 @@
+import { FieldValues } from 'react-hook-form';
+import { CheckboxProps, FormItemProps } from 'react-start-kit/form';
+/**
+ * Props for the MyCheckbox component.
+ * @template TFieldValues - The type of the form values.
+ */
+export type MyCheckboxProps<TFieldValues extends FieldValues> = FormItemProps<TFieldValues> & CheckboxProps;
+/**
+ * MyCheckbox is a checkbox component with optional react-hook-form integration.
+ *
+ * @template TFieldValues - Form values type used by react-hook-form.
+ * @param control - The `react-hook-form` control object.
+ * @param name - The name of the field in `react-hook-form`.
+ * @param label - The label to display for the checkbox.
+ * @param rules - The `react-hook-form` validation rules.
+ * @param props - Checkbox and form item props.
+ * @returns {JSX.Element | null} A checkbox component wrapped with form handling logic, or null if name/control are missing
+ */
+export declare const MyCheckbox: <TFieldValues extends FieldValues>({ control, name, label, rules, ...props }: MyCheckboxProps<TFieldValues>) => import("react/jsx-runtime").JSX.Element | null;
+//# sourceMappingURL=MyCheckbox.d.ts.map

package/dist/types/components/form/MyCheckbox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MyCheckbox.d.ts","sourceRoot":"","sources":["../../../../src/components/form/MyCheckbox.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAa,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9D,OAAO,EAEL,KAAK,aAAa,EAIlB,KAAK,aAAa,EAEnB,MAAM,sBAAsB,CAAC;AAE9B;;;GAGG;AACH,MAAM,MAAM,eAAe,CAAC,YAAY,SAAS,WAAW,IAC1D,aAAa,CAAC,YAAY,CAAC,GAAG,aAAa,CAAC;AAE9C;;;;;;;;;;GAUG;AACH,eAAO,MAAM,UAAU,GAAI,YAAY,SAAS,WAAW,EAAE,2CAM1D,eAAe,CAAC,YAAY,CAAC,mDA2B/B,CAAC"}