blixify-ui-web-mcp 0.1.3 → 0.1.19

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 (168) hide show
  1. package/lib/components/action/button/README.md +12 -11
  2. package/lib/components/action/button/button.stories.tsx +38 -27
  3. package/lib/components/action/buttonGroup/buttonGroup.stories.tsx +82 -16
  4. package/lib/components/action/iconButton/README.md +1 -0
  5. package/lib/components/action/iconButton/iconButton.stories.tsx +6 -12
  6. package/lib/components/action/radioList/radioList.stories.tsx +10 -16
  7. package/lib/components/action/slider/slider.stories.tsx +9 -15
  8. package/lib/components/action/textButton/textButton.stories.tsx +6 -12
  9. package/lib/components/action/toggle/toggle.stories.tsx +6 -12
  10. package/lib/components/advanced/collapse/collapse.stories.tsx +240 -24
  11. package/lib/components/advanced/infoWindow/infoWindow.stories.tsx +10 -16
  12. package/lib/components/advanced/popUp/README.md +33 -7
  13. package/lib/components/advanced/popUp/popUp.stories.tsx +9 -15
  14. package/lib/components/auth/bareSignIn/bareSignIn.stories.tsx +36 -16
  15. package/lib/components/auth/bareSignUp/bareSignUp.stories.tsx +7 -13
  16. package/lib/components/auth/signIn/signIn.stories.tsx +4 -10
  17. package/lib/components/auth/signUp/signUp.stories.tsx +4 -10
  18. package/lib/components/chart/areaChart/areaChart.stories.tsx +12 -18
  19. package/lib/components/chart/barChart/barChart.stories.tsx +12 -18
  20. package/lib/components/chart/boxPlotChart/boxPlotChart.stories.tsx +11 -17
  21. package/lib/components/chart/bubbleChart/bubbleChart.stories.tsx +11 -17
  22. package/lib/components/chart/card/card.stories.tsx +172 -38
  23. package/lib/components/chart/ganttChart/ganttChart.stories.tsx +10 -16
  24. package/lib/components/chart/heatmapChart/heatmapChart.stories.tsx +11 -17
  25. package/lib/components/chart/lineChart/lineChart.stories.tsx +8 -14
  26. package/lib/components/chart/pieChart/pieChart.stories.tsx +11 -17
  27. package/lib/components/chart/polarAreaChart/polarAreaChart.stories.tsx +11 -17
  28. package/lib/components/chart/radarChart/radarChart.stories.tsx +6 -12
  29. package/lib/components/chart/radialBar/radialChart.stories.tsx +4 -10
  30. package/lib/components/chart/rangeBarChart/rangeBarChart.stories.tsx +8 -14
  31. package/lib/components/chart/statsCard/statsCard.stories.tsx +12 -18
  32. package/lib/components/chart/treemapChart/treemapChart.stories.tsx +11 -17
  33. package/lib/components/chat/chatAnchor/README.md +7 -0
  34. package/lib/components/chat/chatAnchor/chatAnchor.stories.tsx +15 -21
  35. package/lib/components/chat/chatBase/README.md +103 -22
  36. package/lib/components/chat/chatBase/chatBase.stories.tsx +657 -57
  37. package/lib/components/chat/chatDashboard/README.md +17 -15
  38. package/lib/components/chat/chatDashboard/chatDashboard.stories.tsx +358 -46
  39. package/lib/components/data/dataGraph/dataGraph.stories.tsx +8 -14
  40. package/lib/components/data/dataReference/dataReference.stories.tsx +9 -15
  41. package/lib/components/data/dataTemplate/README.md +443 -129
  42. package/lib/components/data/dataTemplate/dataModule.stories.tsx +10 -15
  43. package/lib/components/data/dataTemplate/dataTemplate.stories.tsx +20 -34
  44. package/lib/components/data/dataWrapper/README.md +207 -84
  45. package/lib/components/data/dataWrapper/dataWrapper.consumer.stories.tsx +2125 -0
  46. package/lib/components/data/dataWrapper/dataWrapper.edit.stories.tsx +607 -0
  47. package/lib/components/data/dataWrapper/dataWrapper.utils.stories.tsx +576 -0
  48. package/lib/components/data/dataWrapper/dataWrapper.view.stories.tsx +1273 -0
  49. package/lib/components/data/flexFilter/flexFilter.stories.tsx +171 -0
  50. package/lib/components/data/queryForm/queryForm.stories.tsx +6 -12
  51. package/lib/components/data/readQuery/readQuery.stories.tsx +6 -11
  52. package/lib/components/data/readQueryHoc/readQueryHoc.stories.tsx +6 -12
  53. package/lib/components/data/writeQuery/README.md +21 -10
  54. package/lib/components/data/writeQuery/writeQuery.stories.tsx +6 -10
  55. package/lib/components/design/actionSection/actionSection.stories.tsx +10 -14
  56. package/lib/components/design/banner/banner.stories.tsx +6 -12
  57. package/lib/components/design/bannerAction/bannerAction.stories.tsx +100 -21
  58. package/lib/components/design/blogSection/blogSection.stories.tsx +6 -12
  59. package/lib/components/design/carouselSection/carouselSection.stories.tsx +6 -12
  60. package/lib/components/design/designList/designList.stories.tsx +6 -12
  61. package/lib/components/design/faq/faq.stories.tsx +53 -31
  62. package/lib/components/design/fileGrid/fileGrid.stories.tsx +10 -16
  63. package/lib/components/design/fileViewer/fileViewer.stories.tsx +6 -12
  64. package/lib/components/design/footerSection/footerSection.stories.tsx +6 -12
  65. package/lib/components/design/googleReview/googleReview.stories.tsx +6 -12
  66. package/lib/components/design/heroSection/heroSection.stories.tsx +10 -16
  67. package/lib/components/design/iconList/iconList.stories.tsx +6 -12
  68. package/lib/components/design/imageGallery/imageGallery.stories.tsx +6 -12
  69. package/lib/components/design/imageZoom/imageZoom.stories.tsx +6 -12
  70. package/lib/components/design/leftContent/leftContent.stories.tsx +6 -12
  71. package/lib/components/design/logoCloud/logoCloud.stories.tsx +6 -12
  72. package/lib/components/design/onboarding/onboarding.stories.tsx +8 -14
  73. package/lib/components/design/pricing/pricing.stories.tsx +6 -12
  74. package/lib/components/design/rightContent/rightContent.stories.tsx +6 -12
  75. package/lib/components/design/sectionList/sectionList.stories.tsx +6 -12
  76. package/lib/components/design/teams/teams.stories.tsx +6 -12
  77. package/lib/components/display/alert/alert.stories.tsx +8 -14
  78. package/lib/components/display/calendar/README.md +49 -0
  79. package/lib/components/display/calendar/calendar.stories.tsx +78 -35
  80. package/lib/components/display/clipboard/clipboard.stories.tsx +6 -12
  81. package/lib/components/display/detailList/detailList.stories.tsx +172 -48
  82. package/lib/components/display/drawer/README.md +44 -11
  83. package/lib/components/display/drawer/drawer.stories.tsx +71 -16
  84. package/lib/components/display/emptyState/emptyState.stories.tsx +47 -15
  85. package/lib/components/display/feeds/feeds.stories.tsx +6 -12
  86. package/lib/components/display/flexTable/README.md +11 -7
  87. package/lib/components/display/flexTable/flexTable.stories.tsx +318 -20
  88. package/lib/components/display/grid/README.md +29 -30
  89. package/lib/components/display/grid/grid.stories.tsx +16 -23
  90. package/lib/components/display/kanban/kanban.stories.tsx +17 -23
  91. package/lib/components/display/list/README.md +30 -29
  92. package/lib/components/display/list/list.stories.tsx +11 -17
  93. package/lib/components/display/loading/loading.stories.tsx +7 -12
  94. package/lib/components/display/mapView/mapView.stories.tsx +9 -15
  95. package/lib/components/display/modal/modal.stories.tsx +6 -13
  96. package/lib/components/display/newCalendar/README.md +163 -0
  97. package/lib/components/display/newCalendar/newCalendar.stories.tsx +292 -0
  98. package/lib/components/display/newFeeds/README.md +53 -0
  99. package/lib/components/display/newFeeds/newFeeds.stories.tsx +104 -0
  100. package/lib/components/display/newKanban/README.md +25 -0
  101. package/lib/components/display/newKanban/newKanban.stories.tsx +131 -0
  102. package/lib/components/display/newList/README.md +30 -0
  103. package/lib/components/display/newList/newList.stories.tsx +231 -0
  104. package/lib/components/display/newPagination/README.md +15 -0
  105. package/lib/components/display/newTable/README.md +121 -0
  106. package/lib/components/display/newTable/newTable.stories.tsx +551 -0
  107. package/lib/components/display/notification/notification.stories.tsx +6 -12
  108. package/lib/components/display/progress/progress.stories.tsx +7 -12
  109. package/lib/components/display/stepper/README.md +4 -0
  110. package/lib/components/display/stepper/stepper.stories.tsx +70 -23
  111. package/lib/components/display/table/README.md +38 -37
  112. package/lib/components/display/table/table.stories.tsx +34 -36
  113. package/lib/components/display/tag/tag.stories.tsx +34 -40
  114. package/lib/components/input/address/address.stories.tsx +12 -18
  115. package/lib/components/input/canvas/canvas.stories.tsx +12 -18
  116. package/lib/components/input/checkbox/checkbox.stories.tsx +7 -13
  117. package/lib/components/input/datePicker/datePicker.stories.tsx +41 -11
  118. package/lib/components/input/form/form.stories.tsx +11 -17
  119. package/lib/components/input/markdown/README.md +80 -2
  120. package/lib/components/input/markdown/markdown.stories.tsx +83 -32
  121. package/lib/components/input/monthYearPicker/monthYearPicker.stories.tsx +52 -24
  122. package/lib/components/input/netPromoterScore/netPromoterScore.stories.tsx +6 -12
  123. package/lib/components/input/rating/rating.stories.tsx +6 -12
  124. package/lib/components/input/select/README.md +31 -29
  125. package/lib/components/input/select/select.stories.tsx +33 -39
  126. package/lib/components/input/signature/signature.stories.tsx +12 -18
  127. package/lib/components/input/textArea/textArea.stories.tsx +6 -12
  128. package/lib/components/input/textInput/textinput.stories.tsx +14 -20
  129. package/lib/components/input/uploadInput/uploadInput.stories.tsx +143 -19
  130. package/lib/components/navigation/bars/README.md +27 -0
  131. package/lib/components/navigation/bars/bars.stories.tsx +56 -19
  132. package/lib/components/navigation/bottomTab/bottomTab.stories.tsx +7 -12
  133. package/lib/components/navigation/breadcrumb/breadcrumb.stories.tsx +8 -14
  134. package/lib/components/navigation/header/header.stories.tsx +33 -21
  135. package/lib/components/navigation/leftNav/leftNav.stories.tsx +10 -16
  136. package/lib/components/navigation/tabs/tabs.stories.tsx +10 -16
  137. package/lib/components/structure/column/column.stories.tsx +10 -15
  138. package/lib/components/structure/container/container.stories.tsx +8 -13
  139. package/lib/components/structure/link/link.stories.tsx +11 -17
  140. package/lib/components/structure/text/text.stories.tsx +12 -17
  141. package/lib/components/template/authPage/authPage.stories.tsx +6 -5
  142. package/lib/components/template/calendarView/calendarView.stories.tsx +726 -0
  143. package/lib/components/template/chatDashboard/chatDashboard.stories.tsx +497 -0
  144. package/lib/components/template/landingPage/landingPage.stories.tsx +10 -7
  145. package/lib/components/template/mapLayout/mapLayout.stories.tsx +519 -0
  146. package/lib/components/template/productListing/productListing.stories.tsx +7 -13
  147. package/lib/components/template/productOverview/productOverview.stories.tsx +5 -11
  148. package/lib/components/template/shoppingCart/shoppingCart.stories.tsx +6 -12
  149. package/lib/components/template/userHomePage/userHomePage.stories.tsx +384 -524
  150. package/lib/components/template/userRankingDashboard/userRankingDashboard.stories.tsx +145 -75
  151. package/lib/mcp/tools/componentsRoot.d.ts +2 -0
  152. package/lib/mcp/tools/componentsRoot.d.ts.map +1 -0
  153. package/lib/mcp/tools/componentsRoot.js +59 -0
  154. package/lib/mcp/tools/componentsRoot.js.map +1 -0
  155. package/lib/mcp/tools/getBackendComponent.d.ts.map +1 -1
  156. package/lib/mcp/tools/getBackendComponent.js +2 -5
  157. package/lib/mcp/tools/getBackendComponent.js.map +1 -1
  158. package/lib/mcp/tools/getComponent.d.ts.map +1 -1
  159. package/lib/mcp/tools/getComponent.js +2 -5
  160. package/lib/mcp/tools/getComponent.js.map +1 -1
  161. package/lib/mcp/tools/listComponents.d.ts.map +1 -1
  162. package/lib/mcp/tools/listComponents.js +15 -10
  163. package/lib/mcp/tools/listComponents.js.map +1 -1
  164. package/lib/mcp/tools/suggestTemplate.d.ts.map +1 -1
  165. package/lib/mcp/tools/suggestTemplate.js +107 -21
  166. package/lib/mcp/tools/suggestTemplate.js.map +1 -1
  167. package/package.json +1 -1
  168. package/lib/components/data/dataWrapper/dataWrapper.stories.tsx +0 -831
@@ -0,0 +1,231 @@
1
+ import { MagnifyingGlassIcon } from "@heroicons/react/24/solid";
2
+ import React from "react";
3
+ import { NewList as NewListImpl, NewListItem, NewListTag } from ".";
4
+ import { StorySection } from "../../storyUtils";
5
+
6
+ const meta = { title: "Display/New List" };
7
+ export default meta;
8
+
9
+ // INFO: identical sample data to legacy Display/List for side-by-side comparison
10
+ const baseLists: NewListItem[] = [
11
+ {
12
+ id: "1",
13
+ title: "Back End Developer",
14
+ img: "https://images.unsplash.com/photo-1494790108377-be9c29b29330?ixlib=rb-1.2.1&auto=format&fit=facearea&facepad=2&w=256&h=256&q=80",
15
+ description: "Engineering",
16
+ tag: "Full time",
17
+ date: new Date(),
18
+ action: (
19
+ <div className="ml-2 whitespace-nowrap">
20
+ <p className="rounded-full bg-green-100 px-2 text-xs font-semibold leading-5 text-green-800">
21
+ Active
22
+ </p>
23
+ </div>
24
+ ),
25
+ },
26
+ {
27
+ id: "2",
28
+ title: "Front End Developer",
29
+ img: "https://images.unsplash.com/photo-1519244703995-f4e0f30006d5?ixlib=rb-1.2.1&auto=format&fit=facearea&facepad=2&w=256&h=256&q=80",
30
+ description: "Engineering",
31
+ tag: "Full time",
32
+ date: new Date(),
33
+ },
34
+ {
35
+ id: "3",
36
+ title: "Product Designer",
37
+ img: "https://images.unsplash.com/photo-1506794778202-cad84cf45f1d?ixlib=rb-1.2.1&auto=format&fit=facearea&facepad=2&w=256&h=256&q=80",
38
+ description: "Design",
39
+ tag: "Part time",
40
+ date: new Date(),
41
+ },
42
+ {
43
+ id: "4",
44
+ title: "DevOps Engineer",
45
+ img: "https://images.unsplash.com/photo-1517841905240-472988babdf9?ixlib=rb-1.2.1&auto=format&fit=facearea&facepad=2&w=256&h=256&q=80",
46
+ description: "Infrastructure",
47
+ tag: "Full time",
48
+ date: new Date(),
49
+ },
50
+ ];
51
+
52
+ // INFO: sample data with multi-tag colours
53
+ const colouredTagLists: (NewListItem & { tags?: NewListTag[] })[] = [
54
+ {
55
+ id: "c1",
56
+ title: "Back End Developer",
57
+ img: "https://images.unsplash.com/photo-1494790108377-be9c29b29330?ixlib=rb-1.2.1&auto=format&fit=facearea&facepad=2&w=256&h=256&q=80",
58
+ description: "Engineering",
59
+ tags: [
60
+ { text: "Full time", color: "green" },
61
+ { text: "Senior", color: "indigo" },
62
+ ],
63
+ date: new Date(),
64
+ },
65
+ {
66
+ id: "c2",
67
+ title: "Front End Developer",
68
+ img: "https://images.unsplash.com/photo-1519244703995-f4e0f30006d5?ixlib=rb-1.2.1&auto=format&fit=facearea&facepad=2&w=256&h=256&q=80",
69
+ description: "Engineering",
70
+ tags: [{ text: "Full time", color: "green" }],
71
+ date: new Date(),
72
+ },
73
+ {
74
+ id: "c3",
75
+ title: "Product Designer",
76
+ img: "https://images.unsplash.com/photo-1506794778202-cad84cf45f1d?ixlib=rb-1.2.1&auto=format&fit=facearea&facepad=2&w=256&h=256&q=80",
77
+ description: "Design",
78
+ tags: [
79
+ { text: "Part time", color: "yellow" },
80
+ { text: "Contract", color: "red" },
81
+ ],
82
+ date: new Date(),
83
+ },
84
+ {
85
+ id: "c4",
86
+ title: "DevOps Engineer",
87
+ img: "https://images.unsplash.com/photo-1517841905240-472988babdf9?ixlib=rb-1.2.1&auto=format&fit=facearea&facepad=2&w=256&h=256&q=80",
88
+ description: "Infrastructure",
89
+ tags: [
90
+ { text: "Full time", color: "green" },
91
+ { text: "Remote", color: "blue" },
92
+ ],
93
+ date: new Date(),
94
+ },
95
+ ];
96
+
97
+ const searchSlot = (
98
+ <div className="flex items-center gap-2 rounded-lg bg-gray-50 px-3 py-2">
99
+ <MagnifyingGlassIcon className="h-4 w-4 text-gray-400" />
100
+ <span className="text-sm text-gray-400">Search…</span>
101
+ </div>
102
+ );
103
+
104
+ export const NewList = () => (
105
+ <div className="font-sans p-6">
106
+ <StorySection
107
+ title="NewList — same data as legacy Display/List"
108
+ description="NewListItem = ListClass. Pass legacy ListClass[] data directly via the `list` prop alias — drop-in swap from <List list={data}> to <NewListImpl list={data}>."
109
+ >
110
+ <NewListImpl list={baseLists} />
111
+ </StorySection>
112
+
113
+ <StorySection
114
+ title="NewList — With Sticky Search Slot"
115
+ description="searchSlot is rendered above the first section. Consumer owns input state."
116
+ >
117
+ <NewListImpl list={baseLists} searchSlot={searchSlot} />
118
+ </StorySection>
119
+
120
+ <StorySection
121
+ title="NewList — Coloured Multi-Tags"
122
+ description="Pass `tags: NewListTag[]` on each item for individually coloured tag pills next to the title. Legacy single `tag: string` still works as fallback."
123
+ >
124
+ <NewListImpl list={colouredTagLists} />
125
+ </StorySection>
126
+
127
+ <StorySection
128
+ title="NewList — Expandable Tabs"
129
+ description="When `expandableTabs=true` and `sections` are provided, a tab bar renders at the top. Only the active tab's items show. Collapses long lists into digestible groups."
130
+ >
131
+ <NewListImpl
132
+ expandableTabs
133
+ sections={[
134
+ {
135
+ id: "fulltime",
136
+ title: "Full Time",
137
+ items: baseLists.filter((i) => (i as any).tag === "Full time"),
138
+ },
139
+ {
140
+ id: "parttime",
141
+ title: "Part Time",
142
+ items: baseLists.filter((i) => (i as any).tag === "Part time"),
143
+ },
144
+ ]}
145
+ />
146
+ </StorySection>
147
+
148
+ <StorySection
149
+ title="NewList — Expandable Tabs with Item Limit"
150
+ description="tabItemLimit=2 shows only the first 2 items per tab with a 'View all' button."
151
+ >
152
+ <NewListImpl
153
+ expandableTabs
154
+ tabItemLimit={2}
155
+ sections={[
156
+ {
157
+ id: "engineering",
158
+ title: "Engineering",
159
+ items: baseLists.filter(
160
+ (i) => (i as any).description === "Engineering",
161
+ ),
162
+ },
163
+ {
164
+ id: "other",
165
+ title: "Other",
166
+ items: baseLists.filter(
167
+ (i) => (i as any).description !== "Engineering",
168
+ ),
169
+ },
170
+ ]}
171
+ />
172
+ </StorySection>
173
+
174
+ <StorySection
175
+ title="NewList — Hover Tooltip"
176
+ description="When mobileTooltip is set, hovering a row shows a floating tooltip card with image, summary info, and tags. No click needed — info visible at a glance."
177
+ >
178
+ <div className="max-w-96">
179
+ <NewListImpl
180
+ list={colouredTagLists}
181
+ mobileTooltip={{
182
+ imageKey: "img",
183
+ summaryKeys: ["description"],
184
+ tagKeys: ["tag"],
185
+ tagColors: {
186
+ "Full time": "green",
187
+ "Part time": "yellow",
188
+ },
189
+ }}
190
+ onClickItem={(item) => console.log("Navigate to:", item.id)}
191
+ />
192
+ </div>
193
+ </StorySection>
194
+
195
+ <StorySection
196
+ title="NewList — Sectioned (modern grouping)"
197
+ description="Pass `sections` instead of `list` to render named groups with sticky section headers."
198
+ >
199
+ <NewListImpl
200
+ sections={[
201
+ {
202
+ id: "fulltime",
203
+ title: "FULL TIME",
204
+ items: baseLists.filter((i) => (i as any).tag === "Full time"),
205
+ },
206
+ {
207
+ id: "parttime",
208
+ title: "PART TIME",
209
+ items: baseLists.filter((i) => (i as any).tag === "Part time"),
210
+ },
211
+ ]}
212
+ />
213
+ </StorySection>
214
+
215
+ <StorySection
216
+ title="NewList — Dark Mode"
217
+ description="darkMode flips bg + text tokens."
218
+ >
219
+ <NewListImpl list={baseLists} darkMode />
220
+ </StorySection>
221
+
222
+ <StorySection
223
+ title="Comparing with the legacy List"
224
+ description="Open Display/List in another tab — same sample data renders. NewListItem is exactly ListClass — drop-in data swap. NewListImpl renders the same shape with modernised card styling, optional sticky section headers, and sticky search slot."
225
+ >
226
+ <div className="rounded-lg bg-gray-50 p-6 text-center text-sm text-gray-500">
227
+ → See <code>Display/List</code> in the sidebar for the legacy component.
228
+ </div>
229
+ </StorySection>
230
+ </div>
231
+ );
@@ -0,0 +1,15 @@
1
+ # NewPagination
2
+
3
+ The footer every new-DTW list renderer shares — NewTable, NewList and the grid
4
+ view: "Showing N result(s)" on the left, bare chevrons with an outlined current
5
+ page on the right. Dark mode follows `darkMode` / `darkModeBg` like the tables.
6
+
7
+ | Prop | Type | Notes |
8
+ | -------------------------------------- | --------------------------------------------- | ----------------------------------------------------------------------- |
9
+ | `paginationType` | `"page" \| "cursor" \| "scroll"` | `scroll` shows only the result count; nothing renders when unset |
10
+ | `pageIndex`, `limit`, `size`, `cursor` | | same meaning as on NewTable |
11
+ | `resultCount` | `number` | rows on the current page — the count shown for cursor / scroll paging |
12
+ | `customPaginationSize` | `number` | overrides the shown count |
13
+ | `hidePagination` | `boolean` | renders nothing |
14
+ | `handleUpdatePageIndex` | `(value: number \| "prev" \| "next") => void` | page numbers for `page`, `prev` / `next` for `cursor` |
15
+ | `className` | `string` | extra classes on the footer row (NewTable uses it for the fixed footer) |
@@ -0,0 +1,121 @@
1
+ # NewTable
2
+
3
+ Tabular display with a List-shaped mobile breakpoint. The architectural key: **`mobileView=true` delegates row rendering to `NewListRow`**, so the same tap-rhythm and avatar/title/trailing geometry shows up across NewList, NewFeeds, and NewTable mobile.
4
+
5
+ ## Design reference
6
+
7
+ PR #1666 — `uiRefresh.stories.tsx`:
8
+
9
+ - **"Table — Desktop (clean borderless)"** (~line 491, `DesktopTable`)
10
+ - **"Table — Mobile Card View"** (~line 552, `MobileCardTable`)
11
+
12
+ Note: the Mobile Card View mock in #1666 invented a bespoke avatar/name/status layout. That pattern is being replaced — the mobile rendering should use `NewListRow` (composition), not duplicate it.
13
+
14
+ ## Mobile column flags
15
+
16
+ Columns expose three optional booleans that map them to the `NewListItem` shape:
17
+
18
+ | Flag | Maps to | Example |
19
+ | ---------------- | --------------- | -------------- |
20
+ | `mobileTitle` | `item.title` | Customer name |
21
+ | `mobileSubtitle` | `item.subtitle` | Order ID |
22
+ | `mobileTrailing` | `item.trailing` | Status / price |
23
+
24
+ Columns flagged `hideOnMobile` are dropped from the mobile rendering entirely.
25
+
26
+ ## Column width
27
+
28
+ Drag the grip on a header's right border to resize that column. The line is
29
+ invisible at rest, fades in when the header is hovered so the affordance is
30
+ discoverable, and turns primary when the grip itself is hovered. The hit area is
31
+ 8px and straddles the border, so it does not need pixel hunting. The width is held
32
+ in component state, keyed by column key — a resize is a per-viewer preference, and
33
+ there is no storage for it yet, so it resets when the list unmounts.
34
+
35
+ `col.width` stays the way a consumer sets a static width (a Tailwind class such as
36
+ `w-48`). A dragged width overrides it through an inline style, because Tailwind
37
+ generates classes at build time and cannot emit a runtime `w-[Npx]`. Resolution
38
+ order is dragged width → `col.width` class → measured / auto, and pinned columns
39
+ measure from the dragged width once one is set. The default minimum is 80px, but a column configured narrower than that (a 40px
40
+ icon column, say) keeps its own width as the floor — a resize never forces a
41
+ column wider than the consumer asked for.
42
+
43
+ The grip is part of `NewTable` itself, so it appears wherever the component is
44
+ used, not only inside a DataTemplate.
45
+
46
+ ## Status
47
+
48
+ 🚧 **Scaffold only.** Mobile delegation wired; desktop table rendering still placeholder. Implementation lands per #1714.
49
+
50
+ | `enableCopy` | `boolean` | Shows **Copy** in the floating selection bar — the selected rows' visible columns as TSV on the clipboard, header first (default true) |
51
+
52
+ ##### Adding a column from the table
53
+
54
+ `advSettings.addColumnEnabled` puts a `+` at the end of the header row. It opens a portalled popover beside the button on desktop and a modal on mobile — the panel has to be portalled or the table's own scroll container clips it. What it
55
+ opens depends on which callback you give it:
56
+
57
+ | Provide | You get |
58
+ | -------------------------------------- | ------------------------------------------------------- |
59
+ | `renderAddColumnElements(id, onClose)` | your own form in the modal, full control |
60
+ | `onAddColumn(column)` | a built-in popup — name, type, and the derived field id |
61
+
62
+ The built-in form asks only for a name and a type. The stored field id is
63
+ generated from the name and shown while typing, so the key that lands on every
64
+ record is never a surprise, and a name whose id collides with an existing column
65
+ is refused rather than silently overwriting it.
66
+
67
+ ```tsx
68
+ advSettings={{
69
+ addColumnEnabled: true,
70
+ onAddColumn: async (column) => handleAppendToSchema(column),
71
+ }}
72
+ ```
73
+
74
+ Every field type the popup can finish is offered. `math` has its own expression
75
+ builder, and `object` / `listObject` are left out because they need a nested
76
+ schema — creating one here would only ever produce a dead column.
77
+
78
+ Types that need more than a name and a type are completed in the popup:
79
+
80
+ | Type | Also asks for |
81
+ | -------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
82
+ | `reference`, `listReference`, `referenceSelection` | endpoint and label, from `renderReferenceSpaceOptions` / `renderReferenceLabelOptions` — required, since a reference with no target resolves nothing |
83
+ | `list`, `multipleList` | options, as a comma-separated line |
84
+ | `image`, `file`, `multipleImage`, `multipleFile` | nothing — the consumer fills the storage path from its own settings |
85
+
86
+ A **Required** toggle sets the field's `optional` flag. New columns default to
87
+ optional, since the rows already in the table have no value for one the moment it
88
+ is added — ticking it says so.
89
+
90
+ Through `DataTemplate` the storage path is filled in automatically from the
91
+ collection the table is already on, and the upload endpoint from the workspace's
92
+ `devSettings` — an asset column needs nothing in the schema you write by hand.
93
+
94
+ ##### Flat
95
+
96
+ `advSettings.flat` drops the rounding, border and shadow so the table sits flush
97
+ in whatever is behind it. The default card treatment separates a table from a
98
+ grey dashboard, but on a page that is already white it shows only a stray
99
+ outline and a shadow floating for no reason. Through `DataTemplate` the flag is
100
+ `bareSettings.bareFlatTable`.
101
+
102
+ ##### Deleting a column
103
+
104
+ `advSettings.onDeleteColumn` puts a bin beside the hide icon, revealed on hover.
105
+ Without it there is no delete affordance at all — adding a column from the table
106
+ is otherwise one-way, and a typo means leaving the page for the schema editor.
107
+
108
+ Deleting a column orphans that field in every existing record, so the table only
109
+ reports the intent; the caller confirms and decides. Through `DataTemplate` it
110
+ arrives at the same `organise.onAddColumns(model)` as adding one, with the column
111
+ already removed from the model — one destination for the schema rather than two.
112
+
113
+ `bareSettings.bareAddColumns` is therefore a privileged flag: it turns on the bin
114
+ as well as the `+`, and neither the table nor `DataTemplate` reads `edit` or any
115
+ notion of a role before showing them. Whoever can see the table can reshape its
116
+ schema. Gate the flag on the viewer's permission where you set it — setting it
117
+ unconditionally hands every viewer a delete button.
118
+
119
+ The older `organise.addColumnEnabled` path is unaffected: it still opens the
120
+ formula builder and gets no bin, since those tables never gained a plain-column
121
+ `+` and so have no way to add a deleted column back.