@react-fabric/data 1.0.0-beta.6 → 1.0.0-beta.60

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (103) hide show
  1. package/{src/histogram/Histogram.module.css → css/_histogram.css} +16 -13
  2. package/css/styles.css +24 -0
  3. package/dist/cjs/checklist/CheckList.js +23 -0
  4. package/dist/cjs/histogram/Histogram.js +37 -7
  5. package/dist/cjs/hooks/useFilteredList.js +88 -10
  6. package/dist/cjs/hooks/usePagination.js +27 -4
  7. package/dist/cjs/hooks/useSelectableList.js +29 -0
  8. package/dist/cjs/i18n/ar.json.js +8 -1
  9. package/dist/cjs/i18n/en.json.js +8 -1
  10. package/dist/cjs/json/JsonViewer.js +67 -27
  11. package/dist/cjs/pagination/Pagination.js +10 -0
  12. package/dist/cjs/table/AddColumn.js +1 -1
  13. package/dist/cjs/table/BodyCell.js +5 -4
  14. package/dist/cjs/table/BodyRow.js +2 -2
  15. package/dist/cjs/table/CheckboxCell.js +1 -1
  16. package/dist/cjs/table/ColumnFilters.js +97 -0
  17. package/dist/cjs/table/HeaderCell.js +71 -43
  18. package/dist/cjs/table/Table.js +58 -12
  19. package/dist/cjs/table/types.js +29 -0
  20. package/dist/cjs/table/useResizer.js +4 -4
  21. package/dist/cjs/table/useVirtualTable.js +127 -19
  22. package/dist/cjs/tree/TreeNode.js +48 -30
  23. package/dist/cjs/tree/TreePanel.js +45 -11
  24. package/dist/cjs/tree/useTree.js +199 -38
  25. package/dist/cjs/tree/utils.js +39 -12
  26. package/dist/cjs/virtual/Gallery.js +97 -45
  27. package/dist/cjs/virtual/List.js +93 -39
  28. package/dist/cjs/virtual/Scroller.js +16 -8
  29. package/dist/esm/checklist/CheckList.js +23 -0
  30. package/dist/esm/histogram/Histogram.js +38 -8
  31. package/dist/esm/hooks/useFilteredList.js +89 -11
  32. package/dist/esm/hooks/usePagination.js +27 -4
  33. package/dist/esm/hooks/useSelectableList.js +29 -0
  34. package/dist/esm/i18n/ar.json.js +8 -2
  35. package/dist/esm/i18n/en.json.js +8 -2
  36. package/dist/esm/json/JsonViewer.js +68 -28
  37. package/dist/esm/pagination/Pagination.js +10 -0
  38. package/dist/esm/table/AddColumn.js +1 -1
  39. package/dist/esm/table/BodyCell.js +5 -4
  40. package/dist/esm/table/BodyRow.js +2 -2
  41. package/dist/esm/table/CheckboxCell.js +1 -1
  42. package/dist/esm/table/ColumnFilters.js +97 -0
  43. package/dist/esm/table/HeaderCell.js +72 -44
  44. package/dist/esm/table/Table.js +59 -13
  45. package/dist/esm/table/types.js +29 -0
  46. package/dist/esm/table/useResizer.js +4 -4
  47. package/dist/esm/table/useVirtualTable.js +129 -21
  48. package/dist/esm/tree/TreeNode.js +51 -33
  49. package/dist/esm/tree/TreePanel.js +46 -12
  50. package/dist/esm/tree/useTree.js +202 -41
  51. package/dist/esm/tree/utils.js +40 -13
  52. package/dist/esm/virtual/Gallery.js +97 -45
  53. package/dist/esm/virtual/List.js +93 -39
  54. package/dist/esm/virtual/Scroller.js +16 -8
  55. package/dist/types/checklist/CheckList.d.ts +22 -0
  56. package/dist/types/histogram/Histogram.d.ts +28 -1
  57. package/dist/types/hooks/useFilteredList.d.ts +66 -5
  58. package/dist/types/hooks/usePagination.d.ts +19 -0
  59. package/dist/types/hooks/useSelectableList.d.ts +29 -0
  60. package/dist/types/json/JsonViewer.d.ts +27 -2
  61. package/dist/types/pagination/Pagination.d.ts +10 -1
  62. package/dist/types/table/ColumnFilters.d.ts +9 -0
  63. package/dist/types/table/HeaderCell.d.ts +1 -1
  64. package/dist/types/table/Table.d.ts +14 -1
  65. package/dist/types/table/types.d.ts +44 -5
  66. package/dist/types/table/useVirtualTable.d.ts +23 -9
  67. package/dist/types/tree/TreeNode.d.ts +1 -1
  68. package/dist/types/tree/TreePanel.d.ts +42 -1
  69. package/dist/types/tree/types.d.ts +65 -19
  70. package/dist/types/tree/useTree.d.ts +9 -10
  71. package/dist/types/tree/utils.d.ts +10 -3
  72. package/dist/types/virtual/Gallery.d.ts +42 -3
  73. package/dist/types/virtual/List.d.ts +42 -3
  74. package/package.json +16 -14
  75. package/src/checklist/CheckList.tsx +22 -0
  76. package/src/histogram/Histogram.tsx +40 -10
  77. package/src/hooks/useFilteredList.tsx +109 -9
  78. package/src/hooks/usePagination.tsx +32 -7
  79. package/src/hooks/useSelectableList.ts +29 -0
  80. package/src/i18n/ar.json +5 -0
  81. package/src/i18n/en.json +5 -0
  82. package/src/json/JsonViewer.tsx +71 -35
  83. package/src/pagination/Pagination.tsx +10 -0
  84. package/src/table/AddColumn.tsx +1 -1
  85. package/src/table/BodyCell.tsx +6 -4
  86. package/src/table/BodyRow.tsx +3 -2
  87. package/src/table/CheckboxCell.tsx +1 -1
  88. package/src/table/ColumnFilters.tsx +105 -0
  89. package/src/table/HeaderCell.tsx +72 -18
  90. package/src/table/Table.tsx +99 -11
  91. package/src/table/types.ts +46 -8
  92. package/src/table/useResizer.ts +5 -3
  93. package/src/table/useVirtualTable.ts +158 -27
  94. package/src/tree/TreeNode.tsx +98 -58
  95. package/src/tree/TreePanel.tsx +77 -6
  96. package/src/tree/types.ts +73 -18
  97. package/src/tree/useTree.ts +220 -44
  98. package/src/tree/utils.ts +58 -20
  99. package/src/virtual/Gallery.tsx +118 -54
  100. package/src/virtual/List.tsx +99 -39
  101. package/src/virtual/Scroller.tsx +16 -8
  102. package/dist/cjs/histogram/Histogram.module.css +0 -1
  103. package/dist/esm/histogram/Histogram.module.css +0 -1
@@ -4,23 +4,50 @@ import _defineProperty from '@babel/runtime/helpers/defineProperty';
4
4
  import _toConsumableArray from '@babel/runtime/helpers/toConsumableArray';
5
5
  import _objectWithoutProperties from '@babel/runtime/helpers/objectWithoutProperties';
6
6
  import { EmptyContent, Icon, ActionLabel, Button, CoreIcons } from '@react-fabric/core';
7
- import { compareValues, Format } from '@react-fabric/utilities';
7
+ import { compareValues, isColor, Format } from '@react-fabric/utilities';
8
8
  import classNames from 'classnames';
9
9
  import { useMemo } from 'react';
10
10
  import { useTranslation } from 'react-i18next';
11
- import classes from './Histogram.module.css';
12
11
  import { jsxs, jsx } from 'react/jsx-runtime';
13
12
 
14
13
  var _excluded = ["items", "total", "color", "sortBy", "emptyTitle", "emptyMessage", "onClick"];
15
14
  function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
16
15
  function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
17
16
  var emptyIcon = "M20.84 22.73L11.11 13H3V11H9.11L6.11 8H3V6H4.11L1.11 3L2.39 1.73L22.11 21.46L20.84 22.73M15 11H14.2L15 11.8V11M21 8V6H9.2L11.2 8H21M3 18H9V16H3V18Z";
17
+ /**
18
+ * Histogram component displays a bar chart of items with counts.
19
+ * It allows users to visualize the distribution of counts across different items.
20
+ * The component supports sorting, custom colors, and click handling for each item.
21
+ * It also provides an empty state when there are no items to display.
22
+ *
23
+ * @param {HistogramProps} props - The properties for the Histogram component.
24
+ * @returns {JSX.Element} - The rendered Histogram component.
25
+ *
26
+ * @example
27
+ * ```jsx
28
+ * <Histogram
29
+ * items={[
30
+ * { id: "1", label: "Item 1", count: 10 },
31
+ * { id: "2", label: "Item 2", count: 20 },
32
+ * { id: "3", label: "Item 3", count: 5, disabled: true },
33
+ * ]}
34
+ * total={30}
35
+ * color="primary-500"
36
+ * sortBy="count"
37
+ * emptyTitle="No Data Available"
38
+ * emptyMessage="Please check back later."
39
+ * onClick={(id, negative) => console.log(`Clicked on ${id}`, negative ? "Negative" : "Positive")}
40
+ * />
41
+ * ```
42
+ *
43
+ * @see {@link https://adarshpastakia.github.io/react-fabric/?path=/docs/data-histogram--docs}
44
+ */
18
45
  var Histogram = function Histogram(_ref) {
19
46
  var _ref$items = _ref.items,
20
47
  items = _ref$items === void 0 ? [] : _ref$items,
21
48
  total = _ref.total,
22
49
  _ref$color = _ref.color,
23
- color = _ref$color === void 0 ? "primary" : _ref$color,
50
+ color = _ref$color === void 0 ? "primary-500" : _ref$color,
24
51
  _ref$sortBy = _ref.sortBy,
25
52
  sortBy = _ref$sortBy === void 0 ? "count" : _ref$sortBy,
26
53
  emptyTitle = _ref.emptyTitle,
@@ -39,10 +66,10 @@ var Histogram = function Histogram(_ref) {
39
66
  return items.sort(compareValues(sortBy === "label" ? "asc" : "desc", sortBy));
40
67
  }, [items, sortBy]);
41
68
  return /*#__PURE__*/jsxs("div", _objectSpread(_objectSpread({
42
- className: classes.histogram
69
+ className: "fabric-histogram from-0% to-100%"
43
70
  }, aria), {}, {
44
71
  style: {
45
- "--color": "var(--".concat(color, ")")
72
+ "--color": isColor(color) ? color : "var(--color-".concat(color, ")")
46
73
  },
47
74
  children: [sorted.length === 0 && /*#__PURE__*/jsx(EmptyContent, {
48
75
  icon: /*#__PURE__*/jsx(Icon, {
@@ -52,16 +79,17 @@ var Histogram = function Histogram(_ref) {
52
79
  title: emptyTitle,
53
80
  message: emptyMessage !== null && emptyMessage !== void 0 ? emptyMessage : t("histogram.empty")
54
81
  }), sorted === null || sorted === void 0 ? void 0 : sorted.map(function (item) {
82
+ var _item$total;
55
83
  return /*#__PURE__*/jsxs("div", {
56
84
  role: "none",
57
85
  "data-disabled": item.count === 0 || item.disabled,
58
- className: classNames("relative cursor-pointer flex flex-nowrap items-center select-none overflow-hidden min-h-6 my-px", classes.histoLabel, (item.count === 0 || item.disabled) && "pointer-events-none"),
86
+ className: classNames("relative cursor-pointer flex flex-nowrap items-center select-none overflow-hidden min-h-6 my-px", "fabric-histoLabel", (((_item$total = item.total) !== null && _item$total !== void 0 ? _item$total : item.count) === 0 || item.disabled) && "pointer-events-none"),
59
87
  "data-testid": item.id,
60
88
  onClick: function onClick(e) {
61
89
  return [_onClick === null || _onClick === void 0 ? void 0 : _onClick(item.id), e.stopPropagation()];
62
90
  },
63
91
  children: [/*#__PURE__*/jsx("div", {
64
- className: classNames("absolute z-0 inset-0 opacity-50 min-w-2 ltr:bg-gradient-to-r rtl:bg-gradient-to-l from-0% to-100%", classes.histoBar),
92
+ className: classNames("absolute z-0 inset-0 opacity-50 min-w-2 ltr:bg-linear-to-r rtl:bg-linear-to-l", "fabric-histoBar"),
65
93
  style: {
66
94
  width: "".concat(Math.min(item.count / maxTotal, 1) * 100, "%")
67
95
  }
@@ -70,6 +98,7 @@ var Histogram = function Histogram(_ref) {
70
98
  actions: [/*#__PURE__*/jsx(Button, {
71
99
  color: "danger",
72
100
  size: "sm",
101
+ stopPropagation: true,
73
102
  icon: CoreIcons.funnelMinus,
74
103
  "aria-label": "Filter Negative",
75
104
  onClick: function onClick() {
@@ -78,6 +107,7 @@ var Histogram = function Histogram(_ref) {
78
107
  }, "negative"), /*#__PURE__*/jsx(Button, {
79
108
  color: "primary",
80
109
  size: "sm",
110
+ stopPropagation: true,
81
111
  icon: CoreIcons.funnelPlus,
82
112
  "aria-label": "Filter",
83
113
  onClick: function onClick() {
@@ -86,7 +116,7 @@ var Histogram = function Histogram(_ref) {
86
116
  }, "positive")],
87
117
  children: item.label
88
118
  }), /*#__PURE__*/jsx("span", {
89
- className: classNames("z-1 rounded-full text-xs font-medium px-2 py-1 leading-none", classes.histoBadge),
119
+ className: classNames("z-1 rounded-full text-xs font-medium px-2 py-1 leading-none", "fabric-histoBadge"),
90
120
  children: Format.number(item.count)
91
121
  })]
92
122
  }, item.id);
@@ -1,20 +1,34 @@
1
1
  'use client';
2
2
 
3
3
  import _slicedToArray from '@babel/runtime/helpers/slicedToArray';
4
- import { isString, matchString } from '@react-fabric/utilities';
4
+ import { isArray, matchString, isString } from '@react-fabric/utilities';
5
5
  import { useState, useDeferredValue, useTransition, useCallback, useEffect } from 'react';
6
6
 
7
7
  var filterList = function filterList(items) {
8
8
  var query = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : "";
9
- var matcher = arguments.length > 2 ? arguments[2] : undefined;
9
+ var matchAll = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : true;
10
+ var matcher = arguments.length > 3 ? arguments[3] : undefined;
10
11
  var newList = [];
11
12
  items.forEach(function (item) {
12
13
  if (matcher) {
13
14
  return (matcher === null || matcher === void 0 ? void 0 : matcher(item, query)) && newList.push(item);
14
15
  }
15
- if (query && isString(query)) {
16
- var _item$label;
17
- if (matchString((_item$label = item.label) !== null && _item$label !== void 0 ? _item$label : item.toString(), query)) {
16
+ if (query && isArray(query) && query.length > 0) {
17
+ if (matchAll && query.every(function (q) {
18
+ var _item$label;
19
+ return matchString((_item$label = item.label) !== null && _item$label !== void 0 ? _item$label : item.toString(), q);
20
+ })) {
21
+ return newList.push(item);
22
+ }
23
+ if (!matchAll && query.some(function (q) {
24
+ var _item$label2;
25
+ return matchString((_item$label2 = item.label) !== null && _item$label2 !== void 0 ? _item$label2 : item.toString(), q);
26
+ })) {
27
+ return newList.push(item);
28
+ }
29
+ } else if (query && isString(query)) {
30
+ var _item$label3;
31
+ if (matchString((_item$label3 = item.label) !== null && _item$label3 !== void 0 ? _item$label3 : item.toString(), query)) {
18
32
  return newList.push(item);
19
33
  }
20
34
  } else {
@@ -23,7 +37,69 @@ var filterList = function filterList(items) {
23
37
  });
24
38
  return newList;
25
39
  };
26
- var useFilteredList = function useFilteredList(items, matcher) {
40
+
41
+ /**
42
+ * Custom hook to filter a list of items based on a query.
43
+ * It provides a way to search through the items and returns the filtered list.
44
+ * The hook uses a deferred value to optimize performance during transitions.
45
+ * It also allows for a custom matcher function to define how items should be matched against the query.
46
+ *
47
+ * @param items - The list of items to filter.
48
+ * @param matchAll - Match all phrases in the query list against the items.
49
+ * @returns An object containing the search function, current query, filtered list, and a boolean indicating if a search is in progress.
50
+ *
51
+ * @example
52
+ * ```jsx
53
+ * useFilteredList(items, (item, query) => {
54
+ * return item.name.includes(query);
55
+ * });
56
+ * ```
57
+ *
58
+ * @see {@link https://adarshpastakia.github.io/react-fabric/?path=/docs/data-usefilteredlist--docs}
59
+ */
60
+
61
+ /**
62
+ * Custom hook to filter a list of items based on a query.
63
+ * It provides a way to search through the items and returns the filtered list.
64
+ * The hook uses a deferred value to optimize performance during transitions.
65
+ * It also allows for a custom matcher function to define how items should be matched against the query.
66
+ *
67
+ * @param items - The list of items to filter.
68
+ * @param matcher - An optional function to match items against the query.
69
+ * @returns An object containing the search function, current query, filtered list, and a boolean indicating if a search is in progress.
70
+ *
71
+ * @example
72
+ * ```jsx
73
+ * useFilteredList(items, (item, query) => {
74
+ * return item.name.includes(query);
75
+ * });
76
+ * ```
77
+ *
78
+ * @see {@link https://adarshpastakia.github.io/react-fabric/?path=/docs/data-usefilteredlist--docs}
79
+ */
80
+
81
+ /**
82
+ * Custom hook to filter a list of items based on a query.
83
+ * It provides a way to search through the items and returns the filtered list.
84
+ * The hook uses a deferred value to optimize performance during transitions.
85
+ * It also allows for a custom matcher function to define how items should be matched against the query.
86
+ *
87
+ * @param items - The list of items to filter.
88
+ * @param matchAll - Match all phrases in the query list against the items.
89
+ * @param matcher - An optional function to match items against the query.
90
+ * @returns An object containing the search function, current query, filtered list, and a boolean indicating if a search is in progress.
91
+ *
92
+ * @example
93
+ * ```jsx
94
+ * useFilteredList(items, (item, query) => {
95
+ * return item.name.includes(query);
96
+ * });
97
+ * ```
98
+ *
99
+ * @see {@link https://adarshpastakia.github.io/react-fabric/?path=/docs/data-usefilteredlist--docs}
100
+ */
101
+
102
+ function useFilteredList(items, matchAll, matcher) {
27
103
  var _useState = useState(),
28
104
  _useState2 = _slicedToArray(_useState, 2),
29
105
  query = _useState2[0],
@@ -37,20 +113,22 @@ var useFilteredList = function useFilteredList(items, matcher) {
37
113
  _useTransition2 = _slicedToArray(_useTransition, 2),
38
114
  isSearching = _useTransition2[0],
39
115
  startTransition = _useTransition2[1];
40
- var filterItems = useCallback(function (items, query) {
116
+ var matchingAll = typeof matchAll === "boolean" ? matchAll : true;
117
+ var matcherFn = typeof matchAll === "function" ? matchAll : matcher;
118
+ var filterItems = useCallback(function (items, query, matchingAll) {
41
119
  return startTransition(function () {
42
- return setFilteredList(filterList(items, query, matcher));
120
+ return setFilteredList(filterList(items, query, matchingAll, matcherFn));
43
121
  });
44
122
  }, []);
45
123
  useEffect(function () {
46
- if (query) filterItems(_items, query);else setFilteredList(items);
47
- }, [query, _items]);
124
+ if (query) filterItems(_items, query, matchingAll);else setFilteredList(items);
125
+ }, [query, matchingAll, _items]);
48
126
  return {
49
127
  onSearch: setQuery,
50
128
  query: query,
51
129
  filteredList: filteredList,
52
130
  isSearching: isSearching
53
131
  };
54
- };
132
+ }
55
133
 
56
134
  export { useFilteredList };
@@ -15,6 +15,26 @@ var makeRange = function makeRange(start, end) {
15
15
  return idx + start;
16
16
  });
17
17
  };
18
+
19
+ /**
20
+ * Custom hook to manage pagination state and logic.
21
+ * It calculates the total number of pages, generates page ranges,
22
+ * and provides a way to change the current page.
23
+ * It also handles the transition of page changes to optimize performance.
24
+ *
25
+ * @param options - The pagination options including total records, current page, records per page, and change handler.
26
+ * @returns An object containing the current page, total pages, head label, ranges for pagination pills, and a function to change the page.
27
+ *
28
+ * @example
29
+ * ```jsx
30
+ * const { page, totalPages, headLabel, ranges, onPageChange } = usePagination({
31
+ * totalRecords: 100,
32
+ * currentPage: 0,
33
+ * perPage: 10,
34
+ * onChange: (newPage) => console.log("Page changed to:", newPage),
35
+ * });
36
+ * ```
37
+ */
18
38
  var usePagination = function usePagination(_ref) {
19
39
  var totalRecords = _ref.totalRecords,
20
40
  _ref$currentPage = _ref.currentPage,
@@ -58,9 +78,12 @@ var usePagination = function usePagination(_ref) {
58
78
 
59
79
  /** ***************** set page *******************/
60
80
  useEffect(function () {
61
- setPage(Math.min(currentPage, totalPages - 1));
62
- onChange === null || onChange === void 0 || onChange(Math.min(currentPage, totalPages - 1));
63
- }, [currentPage, totalPages]);
81
+ if (totalRecords > -1) {
82
+ var actual = Math.min(currentPage, totalPages - 1);
83
+ setPage(actual);
84
+ actual !== currentPage && (onChange === null || onChange === void 0 ? void 0 : onChange(actual));
85
+ }
86
+ }, [currentPage, totalRecords, totalPages]);
64
87
  var headLabel = useMemo(function () {
65
88
  return /*#__PURE__*/jsxs("span", {
66
89
  className: "text-muted",
@@ -72,7 +95,7 @@ var usePagination = function usePagination(_ref) {
72
95
  startTransition(function () {
73
96
  return onChange === null || onChange === void 0 ? void 0 : onChange(page);
74
97
  });
75
- }, []);
98
+ }, [onChange]);
76
99
  return {
77
100
  page: page,
78
101
  totalPages: totalPages,
@@ -6,6 +6,35 @@ import { useRef, useState, useTransition, useEffect, useCallback } from 'react';
6
6
 
7
7
  function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
8
8
  function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
9
+ /**
10
+ * Custom hook to manage selection of items in a list.
11
+ * It allows toggling selection state of items, handling both selected and non-selected states.
12
+ * The hook maintains a selection state and provides a function to toggle the selection of items.
13
+ * It also supports callbacks for when the selection changes or when an item is clicked.
14
+ *
15
+ * @param items - The list of items to manage selection for.
16
+ * @param selected - An array of item IDs that are currently selected.
17
+ * @param nonselected - An array of item IDs that are currently non-selected.
18
+ * @param onChange - Callback function that is called when the selection changes.
19
+ * @param onClick - Callback function that is called when an item is clicked.
20
+ * @returns An object containing the current selection state and a function to toggle selection of items.
21
+ *
22
+ * @example
23
+ * ```jsx
24
+ * const { selection, toggleSelection } = useSelectableList({
25
+ * items: [{ id: '1', label: 'Item 1' }, { id: '2', label: 'Item 2' }],
26
+ * selected: ['1'],
27
+ * nonselected: ['2'],
28
+ * onChange: (selectedIds, nonSelectedIds) => {
29
+ * console.log('Selected:', selectedIds);
30
+ * console.log('Non-selected:', nonSelectedIds);
31
+ * },
32
+ * onClick: (id, isNegative) => {
33
+ * console.log(`Item ${id} clicked, isNegative: ${isNegative}`);
34
+ * },
35
+ * });
36
+ * ```
37
+ */
9
38
  var useSelectableList = function useSelectableList(_ref) {
10
39
  var items = _ref.items,
11
40
  selected = _ref.selected,
@@ -34,6 +34,11 @@ var action = {
34
34
  addFilter: "أضف عامل تصفية",
35
35
  addFilterNot: "إضافة لا تصفية"
36
36
  };
37
+ var data = {
38
+ tree: {
39
+ noItems: "لا توجد عناصر شجرة متوفرة"
40
+ }
41
+ };
37
42
  var ar = {
38
43
  label: label,
39
44
  tree: tree,
@@ -41,7 +46,8 @@ var ar = {
41
46
  json: json,
42
47
  checkList: checkList,
43
48
  histogram: histogram,
44
- action: action
49
+ action: action,
50
+ data: data
45
51
  };
46
52
 
47
- export { action, checkList, datagrid, ar as default, histogram, json, label, tree };
53
+ export { action, checkList, data, datagrid, ar as default, histogram, json, label, tree };
@@ -34,6 +34,11 @@ var action = {
34
34
  addFilter: "Add Filter",
35
35
  addFilterNot: "Add not Filter"
36
36
  };
37
+ var data = {
38
+ tree: {
39
+ noItems: "No tree items available"
40
+ }
41
+ };
37
42
  var en = {
38
43
  label: label,
39
44
  tree: tree,
@@ -41,7 +46,8 @@ var en = {
41
46
  json: json,
42
47
  checkList: checkList,
43
48
  histogram: histogram,
44
- action: action
49
+ action: action,
50
+ data: data
45
51
  };
46
52
 
47
- export { action, checkList, datagrid, en as default, histogram, json, label, tree };
53
+ export { action, checkList, data, datagrid, en as default, histogram, json, label, tree };
@@ -4,7 +4,7 @@ import _objectWithoutProperties from '@babel/runtime/helpers/objectWithoutProper
4
4
  import _defineProperty from '@babel/runtime/helpers/defineProperty';
5
5
  import _toConsumableArray from '@babel/runtime/helpers/toConsumableArray';
6
6
  import _slicedToArray from '@babel/runtime/helpers/slicedToArray';
7
- import { EmptyContent, Text, Meter, ActionLabel, Button, CoreIcons, Icon, Copy } from '@react-fabric/core';
7
+ import { EmptyContent, Text, Meter, Button, CoreIcons, Icon, Copy } from '@react-fabric/core';
8
8
  import { isEmpty, isArray, isObject, isNil, Format, isBoolean, isTrue } from '@react-fabric/utilities';
9
9
  import classNames from 'classnames';
10
10
  import { useMemo, useState, Fragment } from 'react';
@@ -99,6 +99,11 @@ var JsonEntry = function JsonEntry(_ref3) {
99
99
  clamp: 3,
100
100
  children: ret
101
101
  });
102
+ } else {
103
+ ret = /*#__PURE__*/jsx("div", {
104
+ className: "break-words",
105
+ children: ret
106
+ });
102
107
  }
103
108
  return /*#__PURE__*/jsxs(Fragment, {
104
109
  children: [ret, isObject(value) && value._score_ > 0 && /*#__PURE__*/jsx(Meter, {
@@ -120,28 +125,30 @@ var JsonEntry = function JsonEntry(_ref3) {
120
125
  }, [filters, path, pathWithoutOrdinal]);
121
126
  var labelDisplay = useMemo(function () {
122
127
  var _labeler;
123
- return /*#__PURE__*/jsx(ActionLabel, {
124
- className: "text-dimmed text-sm px-2 flex-1 truncate",
125
- actions: !canExpand && canFilter ? [/*#__PURE__*/jsx(Button, {
126
- color: "danger",
127
- size: "sm",
128
- variant: "link",
129
- icon: CoreIcons.funnelMinus,
130
- "aria-label": "Filter Negative",
131
- onClick: function onClick() {
132
- return onFilter === null || onFilter === void 0 ? void 0 : onFilter(pathWithoutOrdinal, actualValue, true);
133
- }
134
- }, "negative"), /*#__PURE__*/jsx(Button, {
135
- color: "primary",
136
- size: "sm",
137
- variant: "link",
138
- icon: CoreIcons.funnelPlus,
139
- "aria-label": "Filter",
140
- onClick: function onClick() {
141
- return onFilter === null || onFilter === void 0 ? void 0 : onFilter(pathWithoutOrdinal, actualValue);
142
- }
143
- }, "positive")] : [],
144
- children: (_labeler = labeler === null || labeler === void 0 ? void 0 : labeler(path)) !== null && _labeler !== void 0 ? _labeler : field
128
+ return /*#__PURE__*/jsxs("div", {
129
+ className: classNames("text-dimmed text-sm px-2 flex-1 group", inline ? "truncate" : "break-words"),
130
+ children: [!canExpand && canFilter && /*#__PURE__*/jsxs("div", {
131
+ className: "hidden pe-1 group-hover:inline-block",
132
+ children: [/*#__PURE__*/jsx(Button, {
133
+ color: "danger",
134
+ size: "xs",
135
+ variant: "link",
136
+ icon: CoreIcons.funnelMinus,
137
+ "aria-label": "Filter Negative",
138
+ onClick: function onClick() {
139
+ return onFilter === null || onFilter === void 0 ? void 0 : onFilter(pathWithoutOrdinal, actualValue, true);
140
+ }
141
+ }, "negative"), /*#__PURE__*/jsx(Button, {
142
+ color: "primary",
143
+ size: "xs",
144
+ variant: "link",
145
+ icon: CoreIcons.funnelPlus,
146
+ "aria-label": "Filter",
147
+ onClick: function onClick() {
148
+ return onFilter === null || onFilter === void 0 ? void 0 : onFilter(pathWithoutOrdinal, actualValue);
149
+ }
150
+ }, "positive")]
151
+ }), (_labeler = labeler === null || labeler === void 0 ? void 0 : labeler(path)) !== null && _labeler !== void 0 ? _labeler : field]
145
152
  });
146
153
  }, [field, labeler, pathWithoutOrdinal, actualValue, canExpand, canFilter]);
147
154
  return /*#__PURE__*/jsxs(Fragment, {
@@ -164,11 +171,14 @@ var JsonEntry = function JsonEntry(_ref3) {
164
171
  icon: expanded ? CoreIcons.chevronDown : CoreIcons.chevronRight
165
172
  }), labelDisplay]
166
173
  }), display && /*#__PURE__*/jsxs("div", {
167
- className: classNames("px-2", inline && "flex-1"),
174
+ className: classNames("px-2 flex flex-nowrap overflow-hidden", inline && "flex-1"),
168
175
  children: [canCopy && /*#__PURE__*/jsx(Copy, {
169
176
  size: "xs",
170
177
  text: actualValue
171
- }), display]
178
+ }), /*#__PURE__*/jsx("div", {
179
+ className: "flex-1",
180
+ children: display
181
+ })]
172
182
  })]
173
183
  }), !showPropertyTree && !children && /*#__PURE__*/jsxs("div", {
174
184
  className: classNames("py-2", inline && "flex flex-nowrap items-center"),
@@ -180,11 +190,14 @@ var JsonEntry = function JsonEntry(_ref3) {
180
190
  },
181
191
  children: labelDisplay
182
192
  }), /*#__PURE__*/jsxs("div", {
183
- className: classNames("px-2", inline && "flex-1"),
193
+ className: classNames("px-2 flex flex-nowrap overflow-hidden", inline && "flex-1"),
184
194
  children: [canCopy && /*#__PURE__*/jsx(Copy, {
185
195
  size: "xs",
186
196
  text: value
187
- }), display]
197
+ }), /*#__PURE__*/jsx("div", {
198
+ className: "flex-1",
199
+ children: display
200
+ })]
188
201
  })]
189
202
  }), expanded && (children === null || children === void 0 ? void 0 : children.map(function (item) {
190
203
  return /*#__PURE__*/jsx(JsonEntry, _objectSpread(_objectSpread({}, item), {}, {
@@ -202,6 +215,33 @@ var JsonEntry = function JsonEntry(_ref3) {
202
215
  }))]
203
216
  });
204
217
  };
218
+
219
+ /**
220
+ * JsonViewer component to display JSON data in a structured format.
221
+ * It supports inline display, property filtering, and custom formatting.
222
+ * The component can handle nested objects and arrays, displaying them in a tree-like structure.
223
+ * It also provides options for copying values and filtering properties.
224
+ *
225
+ * @param {JsonViewProps<T>} props - The properties for the JsonViewer component.
226
+ * @returns {JSX.Element} The rendered JsonViewer component.
227
+ *
228
+ * @example
229
+ * ```jsx
230
+ * <JsonViewer
231
+ * json={{ name: "John", age: 30, address: { city: "New York", zip: "10001" } }}
232
+ * copy={true}
233
+ * filters={true}
234
+ * propertyScheme={{ date: ["createdAt"], phone: ["contact"] }}
235
+ * inline={true}
236
+ * labelWidth="25%"
237
+ * formatter={(path, value) => (path === "age" ? `${value} years` : value)}
238
+ * labeler={(path) => path.replace(/_/g, " ").toUpperCase()}
239
+ * onFilter={(path, value, negate) => console.log(`Filter ${negate ? "negate" : ""} on ${path}:`, value)}
240
+ * />
241
+ * ```
242
+ *
243
+ * @see {@link https://adarshpastakia.github.io/react-fabric/?path=/docs/data-jsonviewer--docs}
244
+ */
205
245
  var JsonViewer = function JsonViewer(_ref5) {
206
246
  var className = _ref5.className,
207
247
  json = _ref5.json,
@@ -223,7 +263,7 @@ var JsonViewer = function JsonViewer(_ref5) {
223
263
  return reduceObject(json);
224
264
  }, [json]);
225
265
  return /*#__PURE__*/jsx("div", _objectSpread(_objectSpread({}, rest), {}, {
226
- className: classNames(className, "p-4 bg-alternate"),
266
+ className: classNames(className, "bg-alternate"),
227
267
  children: !isEmpty(json) ? list.map(function (item) {
228
268
  return /*#__PURE__*/jsx(JsonEntry, _objectSpread(_objectSpread({}, item), {}, {
229
269
  copy: copy,
@@ -6,6 +6,16 @@ import classNames from 'classnames';
6
6
  import { memo, useMemo, Fragment } from 'react';
7
7
  import { jsxs, jsx } from 'react/jsx-runtime';
8
8
 
9
+ /**
10
+ * Pagination component to navigate through pages of data.
11
+ * It displays buttons for navigating to the first, previous, next, and last pages,
12
+ * as well as buttons for specific page numbers based on the provided ranges.
13
+ * The component supports a minimal view that shows the current page and total pages.
14
+ * It uses memoization to optimize rendering performance.
15
+ *
16
+ * @param {PaginationProps} props - The properties for the Pagination component.
17
+ * @returns {JSX.Element} The rendered Pagination component.
18
+ */
9
19
  var Pagination = /*#__PURE__*/memo(function (_ref) {
10
20
  var page = _ref.page,
11
21
  ranges = _ref.ranges,
@@ -30,7 +30,7 @@ var AddColumn = function AddColumn(_ref) {
30
30
  var columns = _ref.columns,
31
31
  onClick = _ref.onClick;
32
32
  return /*#__PURE__*/jsx("div", {
33
- className: "group font-medium w-6 flex flex-nowrap text-start items-end",
33
+ className: "group font-medium w-6 flex flex-nowrap text-start items-center",
34
34
  children: /*#__PURE__*/jsxs(Dropdown, {
35
35
  placement: "bottom-end",
36
36
  children: [/*#__PURE__*/jsx(Icon, {
@@ -43,9 +43,10 @@ var BodyCell = function BodyCell(_ref) {
43
43
  return (_widths$get = widths.get(column.id.toString())) !== null && _widths$get !== void 0 ? _widths$get : column.width;
44
44
  }, [widths, column]);
45
45
  var content = useMemo(function () {
46
+ var _column$dataType;
46
47
  var value = getByPath(item, column.id.toString());
47
48
  if (column.renderer != null) {
48
- return column.renderer(item[column.id], item, index);
49
+ return column.renderer(value, item, index);
49
50
  }
50
51
  if (column.dataType === "boolean") {
51
52
  var _column$valueMap;
@@ -60,7 +61,7 @@ var BodyCell = function BodyCell(_ref) {
60
61
  return column.valueMap[value];
61
62
  }
62
63
  }
63
- if (column.dataType === "date") {
64
+ if (["date", "time", "datetime"].includes((_column$dataType = column.dataType) !== null && _column$dataType !== void 0 ? _column$dataType : "")) {
64
65
  return /*#__PURE__*/jsx(DateDisplay, {
65
66
  date: value,
66
67
  format: column.format
@@ -72,14 +73,14 @@ var BodyCell = function BodyCell(_ref) {
72
73
  return value !== null && value !== void 0 ? value : "";
73
74
  }, [item, column]);
74
75
  return /*#__PURE__*/jsx("div", {
75
- className: "overflow-hidden bg-inherit start-0",
76
+ className: "overflow-hidden bg-inherit start-0 border-e group/table-col",
76
77
  style: {
77
78
  width: width !== null && width !== void 0 ? width : COL_DEFAULT_WIDTH,
78
79
  minWidth: (_column$minWidth = column.minWidth) !== null && _column$minWidth !== void 0 ? _column$minWidth : COL_MIN_WIDTH,
79
80
  maxWidth: (_column$maxWidth = column.maxWidth) !== null && _column$maxWidth !== void 0 ? _column$maxWidth : COL_MAX_WIDTH
80
81
  },
81
82
  children: /*#__PURE__*/jsx("div", {
82
- className: classNames("px-2 py-1 border-e truncate", column.align === "center" && "text-center", column.align === "end" && "text-end"),
83
+ className: classNames("px-2 py-1", column.className, column.truncate && "truncate", column.align === "center" && "text-center", column.align === "end" && "text-end"),
83
84
  children: content
84
85
  })
85
86
  });
@@ -55,14 +55,14 @@ var BodyRow = function BodyRow(_ref) {
55
55
  children: [/*#__PURE__*/jsxs("div", {
56
56
  role: "none",
57
57
  "data-row": index,
58
- className: classNames("flex flex-nowrap datatable-row data-[hilight]:outline-1 -outline-offset-1 outline-primary-500", onRowClick && "hover:bg-primary-50 active:bg-primary-100"),
58
+ className: classNames("flex flex-nowrap datatable-row data-hilight:outline-1 -outline-offset-1 outline-primary-500 group/table-row", onRowClick && "hover:bg-primary-50 active:bg-primary-100", index % 2 ? "bg-even" : "bg-odd"),
59
59
  onClick: function onClick() {
60
60
  return checkableRows && keyProperty && !onRowClick ? toggleChecked(data[keyProperty]) : onRowClick === null || onRowClick === void 0 ? void 0 : onRowClick(data);
61
61
  },
62
62
  children: [/*#__PURE__*/jsxs("div", {
63
63
  className: wrapperStart,
64
64
  children: [!!canExpand && /*#__PURE__*/jsx("div", {
65
- className: classNames("group font-medium w-6 flex flex-nowrap text-start items-center", !canExpand(data) && "pointer-events-none opacity-35"),
65
+ className: classNames("group font-medium w-6 flex flex-nowrap text-start py-1", !canExpand(data) && "pointer-events-none opacity-35"),
66
66
  children: /*#__PURE__*/jsx(Icon, {
67
67
  className: "p-1 text-tint-700 hover:text-primary-600",
68
68
  icon: expanded ? CoreIcons.collapse : CoreIcons.expand,
@@ -30,7 +30,7 @@ var CheckboxCell = function CheckboxCell(_ref) {
30
30
  var state = _ref.state,
31
31
  _onClick = _ref.onClick;
32
32
  return /*#__PURE__*/jsx("div", {
33
- className: "group font-medium border-e w-6 flex flex-nowrap text-start items-center",
33
+ className: "group font-medium border-e w-6 flex flex-nowrap text-start py-1",
34
34
  children: /*#__PURE__*/jsx(Icon, {
35
35
  icon: state === 2 ? CoreIcons.checkboxInt : state === 1 ? CoreIcons.checkboxOn : CoreIcons.checkboxOff,
36
36
  className: "p-1 text-tint-700 hover:text-primary-600",