@juv/codego-react-ui 3.4.7 → 3.4.8

package/dist/index.d.cts

@@ -104,6 +104,26 @@ interface BreadcrumbProps {
 }
 declare function Breadcrumb({ items, separator, maxItems, className, }: BreadcrumbProps): react_jsx_runtime.JSX.Element;
 
+interface RepeaterField {
+    type: "input" | "image" | "attachment";
+    key: string;
+    label?: string;
+    placeholder?: string;
+}
+interface RepeaterProps<T> {
+    items: T[];
+    onAdd: () => void;
+    onRemove: (index: number) => void;
+    renderItem?: (item: T, index: number) => React.ReactNode;
+    /** Structured field definitions — when provided, renders fields automatically */
+    fields?: RepeaterField[];
+    /** Called when a field value changes: (rowIndex, key, value) */
+    onFieldChange?: (index: number, key: string, value: any) => void;
+    addButtonText?: string;
+    className?: string;
+}
+declare function Repeater<T extends Record<string, any>>({ items, onAdd, onRemove, renderItem, fields, onFieldChange, addButtonText, className, }: RepeaterProps<T>): react_jsx_runtime.JSX.Element;
+
 type ToastVariant = "default" | "success" | "error" | "warning" | "info";
 type ToastPosition = "top-left" | "top-center" | "top-right" | "bottom-left" | "bottom-center" | "bottom-right";
 interface ToastItem {
@@ -289,15 +309,46 @@ interface UseServerTableReturn<T> {
     error: string | null;
     goToPage: (page: number) => void;
     reload: () => void;
-    /** Manually trigger a data refresh (alias for reload, respects refresh option) */
     refresh: () => void;
-    searchValue?: string;
-    onSearchChange?: (value: string) => void;
+    searchValue: string;
+    onSearchChange: (value: string) => void;
+    page: number;
+    onPageChange: (page: number) => void;
+    sort: {
+        key: string;
+        direction: "asc" | "desc";
+    }[];
+    onSortChange: (sort: {
+        key: string;
+        direction: "asc" | "desc";
+    }[]) => void;
+    onRowClick?: (item: T) => void;
+    onRowDoubleClick?: (item: T) => void;
+    rowClassName?: (item: T) => string;
+    expandable?: boolean;
+    renderExpanded?: (item: T) => React.ReactNode;
+    columnVisibility?: Record<string, boolean>;
+    onColumnVisibilityChange?: (visibility: Record<string, boolean>) => void;
+    exportable?: boolean;
+    onExport?: (type: "csv" | "excel" | "pdf") => void;
+    virtualized?: boolean;
+    draggable?: boolean;
+    onRowReorder?: (data: T[]) => void;
+    keyboardNavigation?: boolean;
+    theme?: "light" | "dark" | "auto";
+    meta?: Record<string, any>;
+    actions?: Record<string, (item: T) => void>;
+    searchable?: boolean;
+    searchPlaceholder?: string;
+    clientPagination?: boolean;
+    itemsPerPage?: number;
+    selectable?: boolean;
+    onBulkDelete?: (selectedIds: string[]) => void;
+    bulkDeleteBaseUrl?: string;
+    idKey?: keyof T;
+    defaultActions?: DefaultActionsConfig<T>;
+    className?: string;
 }
-/**
- * Server-side pagination prop passed to the Table component
- * @interface ServerPaginationProp
- */
 interface ServerPaginationProp {
     pagination: ServerPagination;
     currentPage: number;
@@ -329,7 +380,7 @@ type ActionFieldType = "input" | "password" | "textarea" | "checkbox" | "toggle"
  * Display type for viewForm fields — controls how the value is rendered in the View modal
  * @type {ViewFieldType}
  */
-type ViewFieldType = "text" | "image" | "checkbox" | "toggle" | "attachment" | "text-url" | "text-url-open-other-tabs" | "image-url" | "image-url-open-other-tabs";
+type ViewFieldType = "text" | "image" | "checkbox" | "toggle" | "attachment" | "text-url" | "text-url-open-other-tabs" | "image-url" | "image-url-open-other-tabs" | "repeater";
 /**
  * Configuration for a single field in action forms (edit/view modals)
  * @interface ActionField
@@ -355,6 +406,8 @@ interface ActionField {
     step?: number;
     /** Number of OTP digits for type="otp" */
     digits?: number;
+    /** Field definitions for type="repeater" / viewType="repeater" */
+    repeaterFields?: RepeaterField[];
     /** Validation: regex or built-in preset ("email" | "url" | "numeric" | "alpha" | "alphanumeric") */
     validation?: RegExp | "email" | "url" | "numeric" | "alpha" | "alphanumeric";
     /** Custom message shown when validation fails */
@@ -636,7 +689,7 @@ interface TableProps<T> {
     actions?: Record<string, (item: T) => void>;
     searchable?: boolean;
     searchPlaceholder?: string;
-    pagination?: boolean;
+    clientPagination?: boolean;
     itemsPerPage?: number;
     selectable?: boolean;
     onBulkDelete?: (selectedIds: string[]) => void;
@@ -651,6 +704,15 @@ interface TableProps<T> {
     defaultActions?: DefaultActionsConfig<T>;
     /** Pass the serverPagination object from useServerTable to enable server-side pagination */
     serverPagination?: ServerPaginationProp | null;
+    /**
+     * Visual variant of the table.
+     * - `"default"` — bordered card with subtle bg (original style)
+     * - `"zebra"` — alternating row colors for easy scanning
+     * - `"card"` — each row rendered as an individual card
+     * - `"glass"` — glassmorphism: transparent + backdrop blur
+     * - `"soft"` — neumorphic soft shadows, no hard borders
+     */
+    variant?: "default" | "zebra" | "card" | "glass" | "soft";
     className?: string;
 }
 /**
@@ -670,7 +732,7 @@ interface TableProps<T> {
  *     { key: "active", type: "toggle", onChange: handleToggle },
  *   ]}
  *   searchable
- *   pagination
+ *   clientPagination
  *   selectable
  *   onBulkDelete={handleBulkDelete}
  *   defaultActions={{
@@ -680,7 +742,7 @@ interface TableProps<T> {
  * />
  * ```
  */
-declare function Table<T extends Record<string, any>>({ data, columns, searchable, searchPlaceholder, pagination, itemsPerPage, selectable, onBulkDelete, idKey, bulkDeleteBaseUrl, defaultActions, serverPagination, className, }: TableProps<T>): react_jsx_runtime.JSX.Element;
+declare function Table<T extends Record<string, any>>({ data, columns, loading, emptyState, error: errorProp, searchable, searchPlaceholder, searchValue: controlledSearch, onSearchChange, clientPagination, itemsPerPage, selectable, onBulkDelete, idKey, bulkDeleteBaseUrl, defaultActions, serverPagination, variant, className, onRowClick, onRowDoubleClick, rowClassName, expandable, renderExpanded, columnVisibility, onColumnVisibilityChange, exportable, onExport, virtualized, draggable, onRowReorder, keyboardNavigation, }: TableProps<T>): react_jsx_runtime.JSX.Element;
 
 type BulletinPriority = "low" | "medium" | "high" | "urgent";
 type BulletinLayout = "grid" | "list" | "masonry";
@@ -1961,16 +2023,6 @@ interface RadioGroupProps {
 }
 declare function RadioGroup({ options, value: controlledValue, defaultValue, onChange, variant, size, orientation, name, className, required, error, }: RadioGroupProps): react_jsx_runtime.JSX.Element;
 
-interface RepeaterProps<T> {
-    items: T[];
-    onAdd: () => void;
-    onRemove: (index: number) => void;
-    renderItem: (item: T, index: number) => React.ReactNode;
-    addButtonText?: string;
-    className?: string;
-}
-declare function Repeater<T>({ items, onAdd, onRemove, renderItem, addButtonText, className, }: RepeaterProps<T>): react_jsx_runtime.JSX.Element;
-
 interface ResizablePanelsProps {
     children: [React.ReactNode, React.ReactNode];
     orientation?: "horizontal" | "vertical";

package/dist/index.d.ts

@@ -104,6 +104,26 @@ interface BreadcrumbProps {
 }
 declare function Breadcrumb({ items, separator, maxItems, className, }: BreadcrumbProps): react_jsx_runtime.JSX.Element;
 
+interface RepeaterField {
+    type: "input" | "image" | "attachment";
+    key: string;
+    label?: string;
+    placeholder?: string;
+}
+interface RepeaterProps<T> {
+    items: T[];
+    onAdd: () => void;
+    onRemove: (index: number) => void;
+    renderItem?: (item: T, index: number) => React.ReactNode;
+    /** Structured field definitions — when provided, renders fields automatically */
+    fields?: RepeaterField[];
+    /** Called when a field value changes: (rowIndex, key, value) */
+    onFieldChange?: (index: number, key: string, value: any) => void;
+    addButtonText?: string;
+    className?: string;
+}
+declare function Repeater<T extends Record<string, any>>({ items, onAdd, onRemove, renderItem, fields, onFieldChange, addButtonText, className, }: RepeaterProps<T>): react_jsx_runtime.JSX.Element;
+
 type ToastVariant = "default" | "success" | "error" | "warning" | "info";
 type ToastPosition = "top-left" | "top-center" | "top-right" | "bottom-left" | "bottom-center" | "bottom-right";
 interface ToastItem {
@@ -289,15 +309,46 @@ interface UseServerTableReturn<T> {
     error: string | null;
     goToPage: (page: number) => void;
     reload: () => void;
-    /** Manually trigger a data refresh (alias for reload, respects refresh option) */
     refresh: () => void;
-    searchValue?: string;
-    onSearchChange?: (value: string) => void;
+    searchValue: string;
+    onSearchChange: (value: string) => void;
+    page: number;
+    onPageChange: (page: number) => void;
+    sort: {
+        key: string;
+        direction: "asc" | "desc";
+    }[];
+    onSortChange: (sort: {
+        key: string;
+        direction: "asc" | "desc";
+    }[]) => void;
+    onRowClick?: (item: T) => void;
+    onRowDoubleClick?: (item: T) => void;
+    rowClassName?: (item: T) => string;
+    expandable?: boolean;
+    renderExpanded?: (item: T) => React.ReactNode;
+    columnVisibility?: Record<string, boolean>;
+    onColumnVisibilityChange?: (visibility: Record<string, boolean>) => void;
+    exportable?: boolean;
+    onExport?: (type: "csv" | "excel" | "pdf") => void;
+    virtualized?: boolean;
+    draggable?: boolean;
+    onRowReorder?: (data: T[]) => void;
+    keyboardNavigation?: boolean;
+    theme?: "light" | "dark" | "auto";
+    meta?: Record<string, any>;
+    actions?: Record<string, (item: T) => void>;
+    searchable?: boolean;
+    searchPlaceholder?: string;
+    clientPagination?: boolean;
+    itemsPerPage?: number;
+    selectable?: boolean;
+    onBulkDelete?: (selectedIds: string[]) => void;
+    bulkDeleteBaseUrl?: string;
+    idKey?: keyof T;
+    defaultActions?: DefaultActionsConfig<T>;
+    className?: string;
 }
-/**
- * Server-side pagination prop passed to the Table component
- * @interface ServerPaginationProp
- */
 interface ServerPaginationProp {
     pagination: ServerPagination;
     currentPage: number;
@@ -329,7 +380,7 @@ type ActionFieldType = "input" | "password" | "textarea" | "checkbox" | "toggle"
  * Display type for viewForm fields — controls how the value is rendered in the View modal
  * @type {ViewFieldType}
  */
-type ViewFieldType = "text" | "image" | "checkbox" | "toggle" | "attachment" | "text-url" | "text-url-open-other-tabs" | "image-url" | "image-url-open-other-tabs";
+type ViewFieldType = "text" | "image" | "checkbox" | "toggle" | "attachment" | "text-url" | "text-url-open-other-tabs" | "image-url" | "image-url-open-other-tabs" | "repeater";
 /**
  * Configuration for a single field in action forms (edit/view modals)
  * @interface ActionField
@@ -355,6 +406,8 @@ interface ActionField {
     step?: number;
     /** Number of OTP digits for type="otp" */
     digits?: number;
+    /** Field definitions for type="repeater" / viewType="repeater" */
+    repeaterFields?: RepeaterField[];
     /** Validation: regex or built-in preset ("email" | "url" | "numeric" | "alpha" | "alphanumeric") */
     validation?: RegExp | "email" | "url" | "numeric" | "alpha" | "alphanumeric";
     /** Custom message shown when validation fails */
@@ -636,7 +689,7 @@ interface TableProps<T> {
     actions?: Record<string, (item: T) => void>;
     searchable?: boolean;
     searchPlaceholder?: string;
-    pagination?: boolean;
+    clientPagination?: boolean;
     itemsPerPage?: number;
     selectable?: boolean;
     onBulkDelete?: (selectedIds: string[]) => void;
@@ -651,6 +704,15 @@ interface TableProps<T> {
     defaultActions?: DefaultActionsConfig<T>;
     /** Pass the serverPagination object from useServerTable to enable server-side pagination */
     serverPagination?: ServerPaginationProp | null;
+    /**
+     * Visual variant of the table.
+     * - `"default"` — bordered card with subtle bg (original style)
+     * - `"zebra"` — alternating row colors for easy scanning
+     * - `"card"` — each row rendered as an individual card
+     * - `"glass"` — glassmorphism: transparent + backdrop blur
+     * - `"soft"` — neumorphic soft shadows, no hard borders
+     */
+    variant?: "default" | "zebra" | "card" | "glass" | "soft";
     className?: string;
 }
 /**
@@ -670,7 +732,7 @@ interface TableProps<T> {
  *     { key: "active", type: "toggle", onChange: handleToggle },
  *   ]}
  *   searchable
- *   pagination
+ *   clientPagination
  *   selectable
  *   onBulkDelete={handleBulkDelete}
  *   defaultActions={{
@@ -680,7 +742,7 @@ interface TableProps<T> {
  * />
  * ```
  */
-declare function Table<T extends Record<string, any>>({ data, columns, searchable, searchPlaceholder, pagination, itemsPerPage, selectable, onBulkDelete, idKey, bulkDeleteBaseUrl, defaultActions, serverPagination, className, }: TableProps<T>): react_jsx_runtime.JSX.Element;
+declare function Table<T extends Record<string, any>>({ data, columns, loading, emptyState, error: errorProp, searchable, searchPlaceholder, searchValue: controlledSearch, onSearchChange, clientPagination, itemsPerPage, selectable, onBulkDelete, idKey, bulkDeleteBaseUrl, defaultActions, serverPagination, variant, className, onRowClick, onRowDoubleClick, rowClassName, expandable, renderExpanded, columnVisibility, onColumnVisibilityChange, exportable, onExport, virtualized, draggable, onRowReorder, keyboardNavigation, }: TableProps<T>): react_jsx_runtime.JSX.Element;
 
 type BulletinPriority = "low" | "medium" | "high" | "urgent";
 type BulletinLayout = "grid" | "list" | "masonry";
@@ -1961,16 +2023,6 @@ interface RadioGroupProps {
 }
 declare function RadioGroup({ options, value: controlledValue, defaultValue, onChange, variant, size, orientation, name, className, required, error, }: RadioGroupProps): react_jsx_runtime.JSX.Element;
 
-interface RepeaterProps<T> {
-    items: T[];
-    onAdd: () => void;
-    onRemove: (index: number) => void;
-    renderItem: (item: T, index: number) => React.ReactNode;
-    addButtonText?: string;
-    className?: string;
-}
-declare function Repeater<T>({ items, onAdd, onRemove, renderItem, addButtonText, className, }: RepeaterProps<T>): react_jsx_runtime.JSX.Element;
-
 interface ResizablePanelsProps {
     children: [React.ReactNode, React.ReactNode];
     orientation?: "horizontal" | "vertical";