jcicl 1.0.56 → 1.0.57

package/Table/Table.d.ts

@@ -5,6 +5,29 @@ import { default as React } from 'react';
 export interface TableValueHandle {
     getTableValue: () => string | number;
 }
+/**
+ * A cell value that displays one thing but sorts by a numeric priority.
+ *
+ * Use this when a column's display text doesn't sort in the desired order.
+ * The Table renders `value` in the cell, searches by `value`, and exports `value` to CSV,
+ * but sorts by `sortPriority` when the column header is clicked.
+ *
+ * Plain values still work as before — SortableCell is opt-in per cell.
+ *
+ * @example
+ * // Priority column: displays "Critical" but sorts numerically (0 first)
+ * const data = [
+ *   { name: 'Task A', priority: { value: 'Critical', sortPriority: 0 } },
+ *   { name: 'Task B', priority: { value: 'Low',      sortPriority: 3 } },
+ *   { name: 'Task C', priority: { value: 'High',     sortPriority: 1 } },
+ * ];
+ */
+export interface SortableCell {
+    /** The value displayed in the cell, used for search and CSV export. */
+    value: string | number | React.ReactNode;
+    /** The numeric value used for sorting when the column header is clicked. Lower numbers sort first in ascending order. */
+    sortPriority: number;
+}
 export interface TableProps {
     data: Record<string, any>[];
     columnTitles?: Record<string, string>;