@multiplatform.one/table 7.69.2 → 7.71.0

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 (205) hide show
  1. package/dist/cjs/components/DataTable/DataTableCardControls.cjs +74 -12
  2. package/dist/cjs/components/DataTable/DataTableCardControls.native.js +83 -12
  3. package/dist/cjs/components/DataTable/DataTableCardControls.native.js.map +1 -1
  4. package/dist/cjs/components/DataTable/DataTableDocumentList.cjs +180 -114
  5. package/dist/cjs/components/DataTable/DataTableDocumentList.native.js +193 -124
  6. package/dist/cjs/components/DataTable/DataTableDocumentList.native.js.map +1 -1
  7. package/dist/cjs/components/DataTable/DataTableMobileCards.cjs +260 -127
  8. package/dist/cjs/components/DataTable/DataTableMobileCards.native.js +287 -156
  9. package/dist/cjs/components/DataTable/DataTableMobileCards.native.js.map +1 -1
  10. package/dist/cjs/components/DataTable/DataTableRoot.cjs +34 -5
  11. package/dist/cjs/components/DataTable/DataTableRoot.native.js +36 -5
  12. package/dist/cjs/components/DataTable/DataTableRoot.native.js.map +1 -1
  13. package/dist/cjs/components/DataTable/PhonePager.cjs +56 -0
  14. package/dist/cjs/components/DataTable/PhonePager.native.js +60 -0
  15. package/dist/cjs/components/DataTable/PhonePager.native.js.map +1 -0
  16. package/dist/cjs/components/DataTable/index.native.js +64 -7
  17. package/dist/cjs/components/DataTable/index.native.js.map +1 -1
  18. package/dist/cjs/components/DataTable/rowSlotParts.cjs +158 -0
  19. package/dist/cjs/components/DataTable/rowSlotParts.native.js +170 -0
  20. package/dist/cjs/components/DataTable/rowSlotParts.native.js.map +1 -0
  21. package/dist/cjs/components/DataTable/rowSlots.cjs +150 -0
  22. package/dist/cjs/components/DataTable/rowSlots.native.js +239 -0
  23. package/dist/cjs/components/DataTable/rowSlots.native.js.map +1 -0
  24. package/dist/cjs/components/DataTableFilterButton/index.cjs +25 -3
  25. package/dist/cjs/components/DataTableFilterButton/index.native.js +25 -3
  26. package/dist/cjs/components/DataTableFilterButton/index.native.js.map +1 -1
  27. package/dist/cjs/components/DataTablePagination/index.cjs +23 -0
  28. package/dist/cjs/components/DataTablePagination/index.native.js +25 -0
  29. package/dist/cjs/components/DataTablePagination/index.native.js.map +1 -1
  30. package/dist/cjs/components/DataTableToolbar/glyph.cjs +54 -0
  31. package/dist/cjs/components/DataTableToolbar/glyph.native.js +57 -0
  32. package/dist/cjs/components/DataTableToolbar/glyph.native.js.map +1 -0
  33. package/dist/cjs/components/DataTableToolbar/index.cjs +206 -114
  34. package/dist/cjs/components/DataTableToolbar/index.native.js +217 -112
  35. package/dist/cjs/components/DataTableToolbar/index.native.js.map +1 -1
  36. package/dist/cjs/index.cjs +5 -1
  37. package/dist/cjs/index.native.js +5 -1
  38. package/dist/cjs/index.native.js.map +1 -1
  39. package/dist/esm/components/DataTable/DataTableCardControls.mjs +74 -13
  40. package/dist/esm/components/DataTable/DataTableCardControls.mjs.map +1 -1
  41. package/dist/esm/components/DataTable/DataTableCardControls.native.js +83 -13
  42. package/dist/esm/components/DataTable/DataTableCardControls.native.js.map +1 -1
  43. package/dist/esm/components/DataTable/DataTableDocumentList.mjs +179 -113
  44. package/dist/esm/components/DataTable/DataTableDocumentList.mjs.map +1 -1
  45. package/dist/esm/components/DataTable/DataTableDocumentList.native.js +192 -123
  46. package/dist/esm/components/DataTable/DataTableDocumentList.native.js.map +1 -1
  47. package/dist/esm/components/DataTable/DataTableMobileCards.mjs +261 -129
  48. package/dist/esm/components/DataTable/DataTableMobileCards.mjs.map +1 -1
  49. package/dist/esm/components/DataTable/DataTableMobileCards.native.js +288 -158
  50. package/dist/esm/components/DataTable/DataTableMobileCards.native.js.map +1 -1
  51. package/dist/esm/components/DataTable/DataTableRoot.mjs +36 -7
  52. package/dist/esm/components/DataTable/DataTableRoot.mjs.map +1 -1
  53. package/dist/esm/components/DataTable/DataTableRoot.native.js +38 -7
  54. package/dist/esm/components/DataTable/DataTableRoot.native.js.map +1 -1
  55. package/dist/esm/components/DataTable/PhonePager.mjs +31 -0
  56. package/dist/esm/components/DataTable/PhonePager.mjs.map +1 -0
  57. package/dist/esm/components/DataTable/PhonePager.native.js +32 -0
  58. package/dist/esm/components/DataTable/PhonePager.native.js.map +1 -0
  59. package/dist/esm/components/DataTable/index.native.js +67 -10
  60. package/dist/esm/components/DataTable/index.native.js.map +1 -1
  61. package/dist/esm/components/DataTable/rowSlotParts.mjs +130 -0
  62. package/dist/esm/components/DataTable/rowSlotParts.mjs.map +1 -0
  63. package/dist/esm/components/DataTable/rowSlotParts.native.js +139 -0
  64. package/dist/esm/components/DataTable/rowSlotParts.native.js.map +1 -0
  65. package/dist/esm/components/DataTable/rowSlots.mjs +121 -0
  66. package/dist/esm/components/DataTable/rowSlots.mjs.map +1 -0
  67. package/dist/esm/components/DataTable/rowSlots.native.js +207 -0
  68. package/dist/esm/components/DataTable/rowSlots.native.js.map +1 -0
  69. package/dist/esm/components/DataTableFilterButton/index.mjs +24 -3
  70. package/dist/esm/components/DataTableFilterButton/index.mjs.map +1 -1
  71. package/dist/esm/components/DataTableFilterButton/index.native.js +24 -3
  72. package/dist/esm/components/DataTableFilterButton/index.native.js.map +1 -1
  73. package/dist/esm/components/DataTablePagination/index.mjs +23 -0
  74. package/dist/esm/components/DataTablePagination/index.mjs.map +1 -1
  75. package/dist/esm/components/DataTablePagination/index.native.js +25 -0
  76. package/dist/esm/components/DataTablePagination/index.native.js.map +1 -1
  77. package/dist/esm/components/DataTableToolbar/glyph.mjs +27 -0
  78. package/dist/esm/components/DataTableToolbar/glyph.mjs.map +1 -0
  79. package/dist/esm/components/DataTableToolbar/glyph.native.js +27 -0
  80. package/dist/esm/components/DataTableToolbar/glyph.native.js.map +1 -0
  81. package/dist/esm/components/DataTableToolbar/index.mjs +211 -119
  82. package/dist/esm/components/DataTableToolbar/index.mjs.map +1 -1
  83. package/dist/esm/components/DataTableToolbar/index.native.js +222 -117
  84. package/dist/esm/components/DataTableToolbar/index.native.js.map +1 -1
  85. package/dist/esm/index.mjs +2 -1
  86. package/dist/esm/index.mjs.map +1 -1
  87. package/dist/esm/index.native.js +2 -1
  88. package/dist/esm/index.native.js.map +1 -1
  89. package/dist/jsx/components/DataTable/DataTableCardControls.mjs +74 -13
  90. package/dist/jsx/components/DataTable/DataTableCardControls.mjs.map +1 -1
  91. package/dist/jsx/components/DataTable/DataTableCardControls.native.js +83 -12
  92. package/dist/jsx/components/DataTable/DataTableCardControls.native.js.map +1 -1
  93. package/dist/jsx/components/DataTable/DataTableDocumentList.mjs +179 -113
  94. package/dist/jsx/components/DataTable/DataTableDocumentList.mjs.map +1 -1
  95. package/dist/jsx/components/DataTable/DataTableDocumentList.native.js +193 -124
  96. package/dist/jsx/components/DataTable/DataTableDocumentList.native.js.map +1 -1
  97. package/dist/jsx/components/DataTable/DataTableMobileCards.mjs +261 -129
  98. package/dist/jsx/components/DataTable/DataTableMobileCards.mjs.map +1 -1
  99. package/dist/jsx/components/DataTable/DataTableMobileCards.native.js +287 -156
  100. package/dist/jsx/components/DataTable/DataTableMobileCards.native.js.map +1 -1
  101. package/dist/jsx/components/DataTable/DataTableRoot.mjs +36 -7
  102. package/dist/jsx/components/DataTable/DataTableRoot.mjs.map +1 -1
  103. package/dist/jsx/components/DataTable/DataTableRoot.native.js +36 -5
  104. package/dist/jsx/components/DataTable/DataTableRoot.native.js.map +1 -1
  105. package/dist/jsx/components/DataTable/PhonePager.mjs +31 -0
  106. package/dist/jsx/components/DataTable/PhonePager.mjs.map +1 -0
  107. package/dist/jsx/components/DataTable/PhonePager.native.js +60 -0
  108. package/dist/jsx/components/DataTable/PhonePager.native.js.map +1 -0
  109. package/dist/jsx/components/DataTable/index.native.js +64 -7
  110. package/dist/jsx/components/DataTable/index.native.js.map +1 -1
  111. package/dist/jsx/components/DataTable/rowSlotParts.mjs +130 -0
  112. package/dist/jsx/components/DataTable/rowSlotParts.mjs.map +1 -0
  113. package/dist/jsx/components/DataTable/rowSlotParts.native.js +170 -0
  114. package/dist/jsx/components/DataTable/rowSlotParts.native.js.map +1 -0
  115. package/dist/jsx/components/DataTable/rowSlots.mjs +121 -0
  116. package/dist/jsx/components/DataTable/rowSlots.mjs.map +1 -0
  117. package/dist/jsx/components/DataTable/rowSlots.native.js +239 -0
  118. package/dist/jsx/components/DataTable/rowSlots.native.js.map +1 -0
  119. package/dist/jsx/components/DataTableFilterButton/index.mjs +24 -3
  120. package/dist/jsx/components/DataTableFilterButton/index.mjs.map +1 -1
  121. package/dist/jsx/components/DataTableFilterButton/index.native.js +25 -3
  122. package/dist/jsx/components/DataTableFilterButton/index.native.js.map +1 -1
  123. package/dist/jsx/components/DataTablePagination/index.mjs +23 -0
  124. package/dist/jsx/components/DataTablePagination/index.mjs.map +1 -1
  125. package/dist/jsx/components/DataTablePagination/index.native.js +25 -0
  126. package/dist/jsx/components/DataTablePagination/index.native.js.map +1 -1
  127. package/dist/jsx/components/DataTableToolbar/glyph.mjs +27 -0
  128. package/dist/jsx/components/DataTableToolbar/glyph.mjs.map +1 -0
  129. package/dist/jsx/components/DataTableToolbar/glyph.native.js +57 -0
  130. package/dist/jsx/components/DataTableToolbar/glyph.native.js.map +1 -0
  131. package/dist/jsx/components/DataTableToolbar/index.mjs +211 -119
  132. package/dist/jsx/components/DataTableToolbar/index.mjs.map +1 -1
  133. package/dist/jsx/components/DataTableToolbar/index.native.js +217 -112
  134. package/dist/jsx/components/DataTableToolbar/index.native.js.map +1 -1
  135. package/dist/jsx/index.js +2 -1
  136. package/dist/jsx/index.js.map +1 -1
  137. package/dist/jsx/index.mjs +2 -1
  138. package/dist/jsx/index.mjs.map +1 -1
  139. package/dist/jsx/index.native.js +5 -1
  140. package/dist/jsx/index.native.js.map +1 -1
  141. package/package.json +12 -12
  142. package/src/components/DataTable/DataTable.spec.tsx +12 -9
  143. package/src/components/DataTable/DataTable.stories.tsx +110 -43
  144. package/src/components/DataTable/DataTableCardControls.tsx +103 -24
  145. package/src/components/DataTable/DataTableDocumentList.stories.tsx +113 -0
  146. package/src/components/DataTable/DataTableDocumentList.tsx +210 -120
  147. package/src/components/DataTable/DataTableMobileCards.tsx +280 -147
  148. package/src/components/DataTable/DataTableRoot.tsx +56 -5
  149. package/src/components/DataTable/PhonePager.tsx +44 -0
  150. package/src/components/DataTable/cardLayout.spec.tsx +20 -12
  151. package/src/components/DataTable/cardToolbar.spec.tsx +31 -26
  152. package/src/components/DataTable/dataTableCardControls.spec.tsx +10 -9
  153. package/src/components/DataTable/dataTableDocumentList.spec.tsx +98 -10
  154. package/src/components/DataTable/dataTableMobileCards.spec.tsx +29 -14
  155. package/src/components/DataTable/index.native.tsx +90 -9
  156. package/src/components/DataTable/nativeCardParity.spec.tsx +15 -0
  157. package/src/components/DataTable/pageRange.spec.tsx +12 -1
  158. package/src/components/DataTable/rowSlotParts.tsx +184 -0
  159. package/src/components/DataTable/rowSlots.ts +239 -0
  160. package/src/components/DataTable/smallTableFooter.spec.tsx +10 -0
  161. package/src/components/DataTableFilterButton/DataTableFilterButton.spec.tsx +3 -3
  162. package/src/components/DataTableFilterButton/index.tsx +30 -2
  163. package/src/components/DataTablePagination/index.tsx +30 -0
  164. package/src/components/DataTableToolbar/DataTableToolbar.spec.tsx +10 -0
  165. package/src/components/DataTableToolbar/DataTableToolbar.stories.tsx +16 -7
  166. package/src/components/DataTableToolbar/compactRow.spec.tsx +197 -0
  167. package/src/components/DataTableToolbar/glyph.ts +33 -0
  168. package/src/components/DataTableToolbar/index.tsx +269 -131
  169. package/src/components/Table/accessibility.spec.tsx +4 -3
  170. package/src/components/noMiddotJoin.spec.tsx +315 -0
  171. package/src/components/phoneBottomAccessory.spec.tsx +218 -0
  172. package/src/components/phoneCardPolish.spec.tsx +214 -0
  173. package/src/components/phoneCardsDefault.spec.tsx +34 -6
  174. package/src/components/phonePager.spec.tsx +141 -0
  175. package/src/components/tableDropdowns.spec.tsx +4 -3
  176. package/src/index.ts +5 -0
  177. package/src/types.ts +23 -0
  178. package/types/components/DataTable/DataTableCardControls.d.ts +12 -0
  179. package/types/components/DataTable/DataTableCardControls.d.ts.map +1 -1
  180. package/types/components/DataTable/DataTableDocumentList.d.ts +13 -7
  181. package/types/components/DataTable/DataTableDocumentList.d.ts.map +1 -1
  182. package/types/components/DataTable/DataTableMobileCards.d.ts +38 -12
  183. package/types/components/DataTable/DataTableMobileCards.d.ts.map +1 -1
  184. package/types/components/DataTable/DataTableRoot.d.ts +1 -1
  185. package/types/components/DataTable/DataTableRoot.d.ts.map +1 -1
  186. package/types/components/DataTable/PhonePager.d.ts +24 -0
  187. package/types/components/DataTable/PhonePager.d.ts.map +1 -0
  188. package/types/components/DataTable/index.native.d.ts +1 -1
  189. package/types/components/DataTable/index.native.d.ts.map +1 -1
  190. package/types/components/DataTable/rowSlotParts.d.ts +30 -0
  191. package/types/components/DataTable/rowSlotParts.d.ts.map +1 -0
  192. package/types/components/DataTable/rowSlots.d.ts +74 -0
  193. package/types/components/DataTable/rowSlots.d.ts.map +1 -0
  194. package/types/components/DataTableFilterButton/index.d.ts +1 -0
  195. package/types/components/DataTableFilterButton/index.d.ts.map +1 -1
  196. package/types/components/DataTablePagination/index.d.ts +5 -0
  197. package/types/components/DataTablePagination/index.d.ts.map +1 -1
  198. package/types/components/DataTableToolbar/glyph.d.ts +65 -0
  199. package/types/components/DataTableToolbar/glyph.d.ts.map +1 -0
  200. package/types/components/DataTableToolbar/index.d.ts +24 -0
  201. package/types/components/DataTableToolbar/index.d.ts.map +1 -1
  202. package/types/index.d.ts +1 -0
  203. package/types/index.d.ts.map +1 -1
  204. package/types/types.d.ts +23 -0
  205. package/types/types.d.ts.map +1 -1
@@ -9,9 +9,9 @@
9
9
  * distinct empty-state copies (no data vs no results) — plus the rule that an
10
10
  * in-flight refetch paints NO empty state over a momentarily blank body.
11
11
  *
12
- * It also pins `classifyCardField`, which decides whether a field prints its
13
- * column name at all. In the grid a header is written once for a whole
14
- * column; on a card it would be written once per value.
12
+ * It also pins the LC-261 slots on a card: no field prints its column name;
13
+ * a text value is the subtitle and a number a glyph fact, the name kept for
14
+ * assistive tech.
15
15
  */
16
16
 
17
17
  import { renderWithProviders } from "@multiplatform.one/test-utils";
@@ -77,23 +77,25 @@ describe("DataTableMobileCards", () => {
77
77
  expect(first.textContent).not.toContain("Last Name");
78
78
  });
79
79
 
80
- it("a self-naming string goes bare, into one wrapped flow with its name hidden", () => {
80
+ it("the first remaining text is the subtitle, its name hidden (LC-261)", () => {
81
81
  const { container } = renderCards();
82
82
  const first = cards(container)[0];
83
- const meta = first.querySelector('[data-card-slot="meta"]');
83
+ const meta = first.querySelector('[data-card-slot="subtitle"]');
84
84
  expect(meta).not.toBeNull();
85
85
  expect(meta!.textContent).toContain("Doe");
86
86
  expect(within(first).queryByText("Last Name")).toBeNull();
87
87
  expect(first.textContent).toContain("Last Name:");
88
88
  });
89
89
 
90
- it("a figure keeps its column name, inline beside the value", () => {
90
+ it("a number is a fact: a glyph and the value, its name hidden (LC-261, LC-260)", () => {
91
91
  const { container } = renderCards();
92
92
  const first = cards(container)[0];
93
- const figure = first.querySelector('[data-card-slot="figure"]');
94
- expect(figure).not.toBeNull();
95
- expect(figure!.textContent).toContain("28");
96
- expect(within(first).getByText("Age")).toBeDefined();
93
+ const fact = first.querySelector('[data-card-slot="fact"]');
94
+ expect(fact).not.toBeNull();
95
+ expect(fact!.textContent).toContain("28");
96
+ expect(fact!.querySelector("svg")).not.toBeNull();
97
+ expect(within(first).queryByText("Age")).toBeNull();
98
+ expect(first.textContent).toContain("Age:");
97
99
  });
98
100
 
99
101
  it("a field with no value spends no row at all", () => {
@@ -101,11 +103,11 @@ describe("DataTableMobileCards", () => {
101
103
  data: [{ id: 1, firstName: "John", lastName: "", age: 28 }],
102
104
  });
103
105
  const first = cards(container)[0];
104
- expect(first.querySelector('[data-card-slot="meta"]')).toBeNull();
106
+ expect(first.querySelector('[data-card-slot="subtitle"]')).toBeNull();
105
107
  expect(first.textContent).not.toContain("Last Name");
106
108
  });
107
109
 
108
- it("a control keeps a row of its own and prints no label", () => {
110
+ it("a row action rides the title line and prints no label", () => {
109
111
  const { container } = renderCards({
110
112
  columns: [
111
113
  { accessorKey: "firstName", header: "First Name" },
@@ -113,9 +115,22 @@ describe("DataTableMobileCards", () => {
113
115
  ],
114
116
  });
115
117
  const first = cards(container)[0];
116
- expect(first.querySelector('[data-card-slot="control"]')).not.toBeNull();
118
+ expect(first.querySelector('[data-card-slot="action"]')).not.toBeNull();
119
+ expect(first.querySelector('[data-card-slot="control"]')).toBeNull();
117
120
  expect(within(first).queryByText("Actions")).toBeNull();
118
- expect(first.textContent).toContain("Actions:");
121
+ });
122
+
123
+ it("a field control keeps a row of its own and prints no label", () => {
124
+ const { container } = renderCards({
125
+ columns: [
126
+ { accessorKey: "firstName", header: "First Name" },
127
+ { accessorKey: "age", header: "Score", field: "rating" },
128
+ ],
129
+ });
130
+ const first = cards(container)[0];
131
+ expect(first.querySelector('[data-card-slot="control"]')).not.toBeNull();
132
+ expect(within(first).queryByText("Score")).toBeNull();
133
+ expect(first.textContent).toContain("Score:");
119
134
  });
120
135
 
121
136
  it("selection adds a select-all bar above the stack and a checkbox per card", () => {
@@ -18,6 +18,7 @@ import {
18
18
  AsyncBoundary,
19
19
  EmptyState,
20
20
  useDirection,
21
+ useRevealTop,
21
22
  ScrollView,
22
23
  Text,
23
24
  } from "@multiplatform.one/components";
@@ -30,7 +31,7 @@ import {
30
31
  useResolvedKnobs,
31
32
  Surface,
32
33
  } from "@multiplatform.one/theme";
33
- import React, { useRef, useMemo, useCallback } from "react";
34
+ import React, { useEffect, useRef, useMemo, useCallback } from "react";
34
35
  import type { FontSizeTokens, SizeTokens } from "tamagui";
35
36
  import { Text as TamaguiText, View, useMedia, withStaticProperties } from "tamagui";
36
37
  import { useTranslation } from "react-i18next";
@@ -41,8 +42,9 @@ import { alignToFlex, getDefaultColumnAlign } from "../../utils/columnAlign";
41
42
  import { withInterp } from "../../utils/withInterp";
42
43
  import { DataTableColumnPinning } from "../DataTableColumnPinning";
43
44
  import { DataTablePagination } from "../DataTablePagination";
45
+ import { PhonePager } from "./PhonePager";
44
46
  import { CellContent } from "./CellContent";
45
- import { DataTableToolbar } from "../DataTableToolbar";
47
+ import { DataTableCardToolbar, DataTableToolbar } from "../DataTableToolbar";
46
48
  import { DataTableFilters } from "../DataTableFilters";
47
49
  import { DataTableBulkActions } from "../DataTableBulkActions";
48
50
  import { DataTableExport } from "../DataTableExport";
@@ -54,6 +56,7 @@ import { Table } from "@multiplatform.one/table-primitives";
54
56
  import { DataTableContext } from "./DataTableContext";
55
57
  import { DataTableDocumentList } from "./DataTableDocumentList";
56
58
  import { DataTableInfiniteTail } from "./DataTableInfiniteTail";
59
+ import { DataTableCardSortControl } from "./DataTableCardControls";
57
60
  import { DataTableMobileCards } from "./DataTableMobileCards";
58
61
  import {
59
62
  bledDataTableChrome,
@@ -176,6 +179,7 @@ function DataTableRoot<TData extends Record<string, any> = Record<string, any>>(
176
179
  renderSubComponent,
177
180
  getSubRows,
178
181
  enableRowSelection = false,
182
+ selectMode = false,
179
183
  selectAllScope: selectAllScopeProp,
180
184
  bulkActions,
181
185
  enableColumnPinning = false,
@@ -674,6 +678,30 @@ function DataTableRoot<TData extends Record<string, any> = Record<string, any>>(
674
678
  [renderRowContent, tableZebraOn, t, getRowPressProps, rowPressActive, bleed],
675
679
  );
676
680
 
681
+ const hasCardSort =
682
+ showCards &&
683
+ enableSorting &&
684
+ table.getVisibleLeafColumns().some((column) => column.getCanSort());
685
+ const defaultCardToolbar = showCards && !renderToolbar;
686
+ const ToolbarComponent = defaultCardToolbar ? DataTableCardToolbar : DataTableToolbar;
687
+ // FZ-7889: at the compact width the pager is one row of dots, so rows per
688
+ // page moves into the toolbar's view menu. A table that fits its smallest
689
+ // page has nothing to choose, so it gets no menu and no toolbar row for it.
690
+ const viewMenuSizes = pageSizeOptions ?? [...DEFAULT_PAGE_SIZE_OPTIONS];
691
+ const viewMenu =
692
+ sm === false &&
693
+ enablePagination &&
694
+ !infinite &&
695
+ !renderPagination &&
696
+ !renderToolbar &&
697
+ table.getRowCount() > Math.min(state.pagination.pageSize, ...viewMenuSizes)
698
+ ? {
699
+ value: state.pagination.pageSize,
700
+ options: viewMenuSizes,
701
+ onChange: (pageSize: number) => actions.setPagination({ pageIndex: 0, pageSize }),
702
+ disabled,
703
+ }
704
+ : undefined;
677
705
  const renderToolbarComponent = () => {
678
706
  if (renderToolbar) {
679
707
  return renderToolbar({
@@ -688,10 +716,17 @@ function DataTableRoot<TData extends Record<string, any> = Record<string, any>>(
688
716
  });
689
717
  }
690
718
  return (
691
- <DataTableToolbar
719
+ <ToolbarComponent
692
720
  globalFilter={state.globalFilter || ""}
693
721
  onGlobalFilterChange={actions.setGlobalFilter}
694
722
  onClearFilters={actions.clearFilters}
723
+ fieldActions={
724
+ defaultCardToolbar && hasCardSort ? (
725
+ <DataTableCardSortControl table={table} disabled={disabled} contained />
726
+ ) : undefined
727
+ }
728
+ pageSize={viewMenu}
729
+ activeFilterCount={table.getState().columnFilters?.length || 0}
695
730
  onSaveView={actions.saveView}
696
731
  onLoadView={actions.loadView}
697
732
  views={state.views}
@@ -699,7 +734,9 @@ function DataTableRoot<TData extends Record<string, any> = Record<string, any>>(
699
734
  enableViews={enableViews}
700
735
  enableGlobalSearch={enableGlobalSearch}
701
736
  enableFiltering={enableFiltering}
737
+ size={knobProps.sizeToken}
702
738
  isFetching={Boolean(state.isFetching)}
739
+ divider={!showCards && !(showList && sm === false)}
703
740
  />
704
741
  );
705
742
  };
@@ -728,6 +765,21 @@ function DataTableRoot<TData extends Record<string, any> = Record<string, any>>(
728
765
  [table, state, actions, computed, selectAllScope],
729
766
  );
730
767
 
768
+ // FZ-7889: turning the page replaces the rows in place. The page scrolls
769
+ // back to the table's top (and a virtualized body to its first row), as a
770
+ // list reloads at its first row; a table whose top is on screen stays put.
771
+ const pageReveal = useRevealTop();
772
+ const revealPageTop = pageReveal.reveal;
773
+ const shownPage = state.pagination.pageIndex;
774
+ const lastShownPage = useRef(shownPage);
775
+ useEffect(() => {
776
+ if (lastShownPage.current === shownPage) return;
777
+ lastShownPage.current = shownPage;
778
+ if (!enablePagination || infinite) return;
779
+ flashListRef.current?.scrollToOffset({ offset: 0, animated: false });
780
+ revealPageTop();
781
+ }, [shownPage, enablePagination, infinite, revealPageTop]);
782
+
731
783
  const renderTableInner = useCallback(
732
784
  (tableData: TData[], setTableData?: (d: TData[]) => void) => {
733
785
  const effectiveHandleAddRow = () => {
@@ -768,7 +820,7 @@ function DataTableRoot<TData extends Record<string, any> = Record<string, any>>(
768
820
  <DataTableStateContext.Provider value={stateContextValue}>
769
821
  <View
770
822
  flexDirection="column"
771
- gap="$6"
823
+ gap={showCards || (showList && sm === false) ? 0 : "$6"}
772
824
  aria-label={ariaLabel || "Data table"}
773
825
  aria-describedby={ariaDescribedBy}
774
826
  aria-live="polite"
@@ -787,10 +839,15 @@ function DataTableRoot<TData extends Record<string, any> = Record<string, any>>(
787
839
  pointerEvents: "none" as const,
788
840
  }
789
841
  : {})}
842
+ ref={pageReveal.ref as never}
790
843
  {...props}
791
844
  >
792
845
  <Surface size={tableSize}>
793
- {(enableGlobalSearch || enableFiltering || enableViews) && (
846
+ {(enableGlobalSearch ||
847
+ enableFiltering ||
848
+ enableViews ||
849
+ viewMenu ||
850
+ (defaultCardToolbar && hasCardSort)) && (
794
851
  <View width="100%" {...(disabled ? disabledState.chromeKnobProps : {})}>
795
852
  {renderToolbarComponent()}
796
853
  </View>
@@ -831,6 +888,7 @@ function DataTableRoot<TData extends Record<string, any> = Record<string, any>>(
831
888
  selectRowLabel={deriveSelectRowLabel}
832
889
  queryInFlight={queryInFlight}
833
890
  bleed={bleed}
891
+ selectMode={selectMode}
834
892
  {...(rowPressActive ? { getRowPressProps } : {})}
835
893
  />
836
894
  </Surface>
@@ -857,7 +915,16 @@ function DataTableRoot<TData extends Record<string, any> = Record<string, any>>(
857
915
  {...(rowPressActive ? { getRowPressProps } : {})}
858
916
  />
859
917
  </Surface>
860
- {enablePagination && !infinite && (
918
+ {enablePagination && !infinite && sm === false && !renderPagination && (
919
+ <PhonePager
920
+ value={stateContextValue}
921
+ disabled={disabled}
922
+ chrome={disabled ? disabledState.chromeKnobProps : undefined}
923
+ >
924
+ {renderPaginationComponent()}
925
+ </PhonePager>
926
+ )}
927
+ {enablePagination && !infinite && (sm !== false || renderPagination) && (
861
928
  <View width="100%" {...(disabled ? disabledState.chromeKnobProps : {})}>
862
929
  {renderPaginationComponent()}
863
930
  </View>
@@ -1149,11 +1216,23 @@ function DataTableRoot<TData extends Record<string, any> = Record<string, any>>(
1149
1216
  )}
1150
1217
  </Surface>
1151
1218
 
1152
- {!showCards && enablePagination && !infinite && (
1153
- <View width="100%" {...(disabled ? disabledState.chromeKnobProps : {})}>
1219
+ {!showCards && enablePagination && !infinite && sm === false && !renderPagination && (
1220
+ <PhonePager
1221
+ value={stateContextValue}
1222
+ disabled={disabled}
1223
+ chrome={disabled ? disabledState.chromeKnobProps : undefined}
1224
+ >
1154
1225
  {renderPaginationComponent()}
1155
- </View>
1226
+ </PhonePager>
1156
1227
  )}
1228
+ {!showCards &&
1229
+ enablePagination &&
1230
+ !infinite &&
1231
+ (sm !== false || renderPagination) && (
1232
+ <View width="100%" {...(disabled ? disabledState.chromeKnobProps : {})}>
1233
+ {renderPaginationComponent()}
1234
+ </View>
1235
+ )}
1157
1236
  </View>
1158
1237
  </DataTableStateContext.Provider>
1159
1238
  </DataTableContext.Provider>
@@ -1199,6 +1278,8 @@ function DataTableRoot<TData extends Record<string, any> = Record<string, any>>(
1199
1278
  showList,
1200
1279
  showCards,
1201
1280
  renderPaginationComponent,
1281
+ renderPagination,
1282
+ pageReveal.ref,
1202
1283
  showAddRow,
1203
1284
  maxRows,
1204
1285
  isFormMode,
@@ -89,6 +89,21 @@ describe("DataTable card renderer parity", () => {
89
89
  },
90
90
  );
91
91
 
92
+ // FZ-7889: native drew the grid toolbar over its cards, so Search shrank to
93
+ // an icon, Filter ran off the screen's edge and Sort was missing.
94
+ it("native puts the card toolbar, with Sort, over its cards as web does", () => {
95
+ const native = read("index.native.tsx");
96
+ expect(native).toMatch(/defaultCardToolbar \? DataTableCardToolbar : DataTableToolbar/);
97
+ expect(callSite(native, "DataTableCardSortControl")).toMatch(/contained/);
98
+ const toolbar = native.slice(native.indexOf("<ToolbarComponent"));
99
+ for (const prop of ["fieldActions", "activeFilterCount", "size"]) {
100
+ expect(toolbar).toMatch(new RegExp(`\\s${prop}=\\{`));
101
+ }
102
+ // The toolbar's bottom padding is the gap to the first card, as on web,
103
+ // so the assembly adds none of its own over cards.
104
+ expect(native).toMatch(/gap=\{showCards(?: \|\| [^?]+)? \? 0 : /);
105
+ });
106
+
92
107
  it("native hands the card list its press props, so a card is pressable there too", () => {
93
108
  expect(cardCallSite(read("index.native.tsx"))).toMatch(/getRowPressProps/);
94
109
  });
@@ -1,10 +1,21 @@
1
1
  // The pages-mode footer's "1–N of M" readout (DF-12), and the switch a
2
- // custom pagination slot uses when it states the range itself.
2
+ // custom pagination slot uses when it states the range itself. The readout
3
+ // is a regular-width part: at the compact width the footer is the one-row dot
4
+ // pager (FZ-7889, phonePager.spec.tsx). useMedia resolves a phone here, so
5
+ // these render wide.
3
6
  import { renderWithProviders } from "@multiplatform.one/test-utils";
4
7
  import { describe, expect, it, vi } from "vitest";
5
8
  import type { DataTableColumn } from "../../types";
6
9
  import { DataTable } from "./index";
7
10
 
11
+ vi.mock("tamagui", async (importOriginal) => {
12
+ const actual = await importOriginal<typeof import("tamagui")>();
13
+ return {
14
+ ...actual,
15
+ useMedia: (...args: any[]) => ({ ...(actual.useMedia as any)(...args), sm: true }),
16
+ };
17
+ });
18
+
8
19
  const data = Array.from({ length: 3 }, (_, i) => ({ id: i + 1, name: `Row ${i + 1}` }));
9
20
  const columns: DataTableColumn<(typeof data)[number]>[] = [{ accessorKey: "name", header: "Name" }];
10
21
 
@@ -0,0 +1,184 @@
1
+ import {
2
+ CalendarBlankIcon,
3
+ CheckCircleIcon,
4
+ CircleIcon,
5
+ CurrencyCircleDollarIcon,
6
+ HashIcon,
7
+ PercentIcon,
8
+ } from "@phosphor-icons/react";
9
+ import { StatusDot, type StatusTone } from "@multiplatform.one/components";
10
+ import {
11
+ IconSlot,
12
+ recipeKeyBelow,
13
+ sizeRecipeForToken,
14
+ useAccentOnSurface,
15
+ useGlyphColor,
16
+ useResolvedKnobs,
17
+ type SizeRecipeToken,
18
+ } from "@multiplatform.one/theme";
19
+ import type { ComponentType, ReactNode } from "react";
20
+ import { View, VisuallyHidden, XStack } from "tamagui";
21
+ import type { DataTableColumn } from "../../types";
22
+
23
+ const positive = new Set([
24
+ "active",
25
+ "enabled",
26
+ "approved",
27
+ "paid",
28
+ "completed",
29
+ "complete",
30
+ "closed",
31
+ "resolved",
32
+ "delivered",
33
+ "received",
34
+ "success",
35
+ "done",
36
+ "ok",
37
+ "yes",
38
+ ]);
39
+ const warning = new Set([
40
+ "pending",
41
+ "open",
42
+ "overdue",
43
+ "in progress",
44
+ "draft",
45
+ "on hold",
46
+ "review",
47
+ ]);
48
+ const critical = new Set([
49
+ "cancelled",
50
+ "canceled",
51
+ "failed",
52
+ "rejected",
53
+ "error",
54
+ "expired",
55
+ "unpaid",
56
+ "lost",
57
+ "down",
58
+ "urgent",
59
+ ]);
60
+
61
+ /** A status word's tone for its dot: done is positive, in flight warning, failed critical. */
62
+ export function statusToneOf(value: unknown): StatusTone {
63
+ const word = String(value ?? "")
64
+ .trim()
65
+ .toLowerCase();
66
+ if (positive.has(word)) return "positive";
67
+ if (warning.has(word)) return "warning";
68
+ if (critical.has(word)) return "critical";
69
+ return "neutral";
70
+ }
71
+
72
+ function columnDef(cell: any): DataTableColumn {
73
+ return cell.column.columnDef as DataTableColumn;
74
+ }
75
+
76
+ /** The status as a tone dot and one word beside the title (LC-169). */
77
+ export function RowStatus({ cell }: { cell: any }) {
78
+ const raw = cell.getValue?.();
79
+ if (raw == null || raw === "") return null;
80
+ const tone = columnDef(cell).meta?.statusTone?.(raw) ?? statusToneOf(raw);
81
+ const word = String(raw);
82
+ return (
83
+ <XStack flexShrink={0} {...({ "data-row-slot": "status" } as object)}>
84
+ <StatusDot tone={tone}>{word.charAt(0).toUpperCase() + word.slice(1)}</StatusDot>
85
+ </XStack>
86
+ );
87
+ }
88
+
89
+ function defaultFactIcon(cell: any): ComponentType<any> {
90
+ const def = columnDef(cell);
91
+ const fieldtype = def.meta?.fieldtype;
92
+ const raw = cell.getValue?.();
93
+ if (def.field === "money" || fieldtype === "Currency") return CurrencyCircleDollarIcon;
94
+ if (fieldtype === "Percent" || (typeof raw === "string" && raw.trim().endsWith("%"))) {
95
+ return PercentIcon;
96
+ }
97
+ if (fieldtype === "Check" || typeof raw === "boolean") return CheckCircleIcon;
98
+ if (fieldtype === "Date" || fieldtype === "Datetime") return CalendarBlankIcon;
99
+ return HashIcon;
100
+ }
101
+
102
+ /**
103
+ * A fact: its glyph and its value, no label in the run (LC-260). The column
104
+ * name stays with assistive tech.
105
+ */
106
+ export function RowFact({
107
+ cell,
108
+ label,
109
+ icon: iconProp,
110
+ children,
111
+ }: {
112
+ cell: any;
113
+ label: string;
114
+ icon?: ComponentType<any>;
115
+ children: ReactNode;
116
+ }) {
117
+ const { knobProps } = useResolvedKnobs({ component: "DataTable" });
118
+ const icon = columnDef(cell).meta?.icon ?? iconProp ?? defaultFactIcon(cell);
119
+ const iconSize = sizeRecipeForToken(
120
+ recipeKeyBelow(knobProps.sizeToken as SizeRecipeToken),
121
+ ).iconSize;
122
+ return (
123
+ <XStack
124
+ alignItems="center"
125
+ flexShrink={0}
126
+ {...knobProps.gapSm}
127
+ {...({ "data-row-slot": "fact" } as object)}
128
+ >
129
+ <View flexShrink={0}>
130
+ <IconSlot icon={icon} size={iconSize} color={knobProps.textRole.meta.color as string} />
131
+ </View>
132
+ <VisuallyHidden>{`${label}: `}</VisuallyHidden>
133
+ <View flexShrink={0} {...({ "data-row-slot": "fact-value" } as object)}>
134
+ {children}
135
+ </View>
136
+ </XStack>
137
+ );
138
+ }
139
+
140
+ /**
141
+ * The phone list's selection mark (LC-155): Mail's and Files' round check,
142
+ * centred on the row before its thumbnail. An open ring at rest, the accent
143
+ * disc with its check once selected. Only select mode draws it.
144
+ */
145
+ export function RowSelectMark({
146
+ checked,
147
+ disabled = false,
148
+ label,
149
+ onToggle,
150
+ }: {
151
+ checked: boolean;
152
+ disabled?: boolean;
153
+ label: string;
154
+ onToggle: (checked: boolean) => void;
155
+ }) {
156
+ const accent = useAccentOnSurface();
157
+ const ring = useGlyphColor("$color8");
158
+ const Mark = checked ? CheckCircleIcon : CircleIcon;
159
+ return (
160
+ <View
161
+ role="checkbox"
162
+ aria-checked={checked}
163
+ aria-label={label}
164
+ aria-disabled={disabled || undefined}
165
+ focusable={!disabled}
166
+ tabIndex={disabled ? -1 : 0}
167
+ width={28}
168
+ height={44}
169
+ flexShrink={0}
170
+ alignSelf="center"
171
+ alignItems="center"
172
+ justifyContent="center"
173
+ hitSlop={{ left: 8, right: 8 }}
174
+ opacity={disabled ? 0.5 : 1}
175
+ onPress={(event: any) => {
176
+ event?.stopPropagation?.();
177
+ if (!disabled) onToggle(!checked);
178
+ }}
179
+ {...({ "data-list-slot": "select-mark", "data-checked": String(checked) } as object)}
180
+ >
181
+ <Mark size={24} weight={checked ? "fill" : "regular"} color={checked ? accent : ring} />
182
+ </View>
183
+ );
184
+ }