@cosmicdrift/kumiko-renderer 0.413.1 → 0.414.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 (334) hide show
  1. package/dist/app/action-form-support.js +4 -0
  2. package/dist/app/content-previews.d.ts +39 -0
  3. package/dist/app/content-previews.js +28 -0
  4. package/dist/app/entity-edit-screen.js +2 -5
  5. package/dist/app/entity-list-screen.js +30 -50
  6. package/dist/app/form-schema.d.ts +1 -0
  7. package/dist/app/form-schema.js +24 -0
  8. package/dist/app/list-sort-options.d.ts +4 -0
  9. package/dist/app/list-sort-options.js +11 -0
  10. package/dist/app/named-filter-facet.d.ts +17 -3
  11. package/dist/app/named-filter-facet.js +88 -5
  12. package/dist/app/projection-detail-body.d.ts +2 -4
  13. package/dist/app/projection-detail-body.js +7 -1
  14. package/dist/app/projection-detail-guidance-data.d.ts +7 -0
  15. package/dist/app/projection-detail-guidance-data.js +101 -0
  16. package/dist/app/projection-detail-guidance.d.ts +13 -0
  17. package/dist/app/projection-detail-guidance.js +197 -0
  18. package/dist/app/projection-detail-header-model.d.ts +1 -3
  19. package/dist/app/projection-detail-header-model.js +4 -8
  20. package/dist/app/projection-detail-header-region.d.ts +2 -1
  21. package/dist/app/projection-detail-header-region.js +63 -23
  22. package/dist/app/projection-detail-header.d.ts +6 -1
  23. package/dist/app/projection-detail-header.js +75 -18
  24. package/dist/app/projection-detail-states.d.ts +3 -3
  25. package/dist/app/projection-list-body.js +4 -2
  26. package/dist/app/projection-list-render.js +3 -1
  27. package/dist/app/projection-list-shim.d.ts +4 -1
  28. package/dist/app/projection-list-shim.js +35 -8
  29. package/dist/app/reference-link.d.ts +3 -2
  30. package/dist/app/reference-link.js +19 -4
  31. package/dist/app/row-actions.js +3 -3
  32. package/dist/app/screen-access.d.ts +4 -0
  33. package/dist/app/screen-access.js +19 -0
  34. package/dist/app/screen-shared.js +3 -1
  35. package/dist/app/unique-label-keys.d.ts +1 -0
  36. package/dist/app/unique-label-keys.js +9 -0
  37. package/dist/app/use-entity-list-payload.d.ts +25 -0
  38. package/dist/app/use-entity-list-payload.js +57 -0
  39. package/dist/app/use-entity-range-facets.js +2 -3
  40. package/dist/app/use-facet-counts.d.ts +5 -0
  41. package/dist/app/use-facet-counts.js +7 -0
  42. package/dist/app/use-list-summary-row.d.ts +10 -0
  43. package/dist/app/use-list-summary-row.js +33 -0
  44. package/dist/app/use-named-filter-queue.d.ts +20 -0
  45. package/dist/app/use-named-filter-queue.js +9 -0
  46. package/dist/app/use-projection-detail-actions.d.ts +4 -4
  47. package/dist/app/use-projection-detail-actions.js +30 -1
  48. package/dist/app/use-projection-list-data.d.ts +5 -0
  49. package/dist/app/use-projection-list-data.js +35 -6
  50. package/dist/app/use-projection-list-query.d.ts +2 -0
  51. package/dist/app/use-projection-list-query.js +29 -16
  52. package/dist/app/use-related-list-tab-counts.js +5 -1
  53. package/dist/app/use-row-decoration.d.ts +11 -0
  54. package/dist/app/use-row-decoration.js +55 -0
  55. package/dist/app/use-screen-list-rows.d.ts +4 -1
  56. package/dist/app/use-screen-list-rows.js +14 -5
  57. package/dist/app/use-screen-list-table.d.ts +3 -1
  58. package/dist/app/use-screen-list-table.js +10 -1
  59. package/dist/app/write-failed-error.d.ts +1 -0
  60. package/dist/app/write-failed-error.js +10 -0
  61. package/dist/compact-tap-classes.d.ts +1 -0
  62. package/dist/compact-tap-classes.js +3 -0
  63. package/dist/components/embedded-list-field.js +13 -12
  64. package/dist/components/list-empty-state.d.ts +8 -1
  65. package/dist/components/list-empty-state.js +4 -1
  66. package/dist/components/list-group-page-bridges.d.ts +1 -1
  67. package/dist/components/list-group-page-bridges.js +2 -2
  68. package/dist/components/related-list-section.js +4 -22
  69. package/dist/components/render-edit-action-button.d.ts +3 -1
  70. package/dist/components/render-edit-action-button.js +5 -3
  71. package/dist/components/render-edit-render-model.d.ts +2 -2
  72. package/dist/components/render-edit-types.d.ts +4 -2
  73. package/dist/components/render-edit.js +3 -1
  74. package/dist/components/render-list-hint-columns.d.ts +8 -0
  75. package/dist/components/render-list-hint-columns.js +77 -0
  76. package/dist/components/render-list-reference-columns.js +4 -2
  77. package/dist/components/render-list-row-tone.d.ts +3 -0
  78. package/dist/components/render-list-row-tone.js +10 -0
  79. package/dist/components/render-list-table-props.d.ts +9 -1
  80. package/dist/components/render-list-table-props.js +4 -1
  81. package/dist/components/render-list-toolbar-action.d.ts +1 -2
  82. package/dist/components/render-list-toolbar-model.d.ts +3 -0
  83. package/dist/components/render-list-toolbar-model.js +21 -6
  84. package/dist/components/render-list-toolbar.d.ts +3 -2
  85. package/dist/components/render-list-toolbar.js +8 -6
  86. package/dist/components/render-list-types.d.ts +6 -1
  87. package/dist/components/render-list.js +26 -7
  88. package/dist/components/use-render-edit-controlled-sync.js +3 -5
  89. package/dist/components/use-render-edit-draft-save.js +7 -9
  90. package/dist/components/use-render-edit-schema.d.ts +3 -0
  91. package/dist/components/use-render-edit-schema.js +15 -0
  92. package/dist/components/use-render-edit-state.d.ts +1 -0
  93. package/dist/components/use-render-edit-state.js +4 -1
  94. package/dist/components/use-render-edit-steps.js +2 -3
  95. package/dist/components/use-render-list-columns.d.ts +3 -1
  96. package/dist/components/use-render-list-columns.js +22 -10
  97. package/dist/context/screen-focus-context.d.ts +14 -0
  98. package/dist/context/screen-focus-context.js +28 -0
  99. package/dist/data-table-facet-types.d.ts +2 -0
  100. package/dist/data-table-view-types.d.ts +20 -1
  101. package/dist/headless/form/form-controller.js +3 -1
  102. package/dist/headless/form/zod-bridge.d.ts +7 -1
  103. package/dist/headless/form/zod-bridge.js +10 -0
  104. package/dist/headless/index.d.ts +2 -1
  105. package/dist/headless/index.js +1 -0
  106. package/dist/headless/pwa-service-worker-meta.d.ts +1 -0
  107. package/dist/headless/pwa-service-worker-meta.js +3 -0
  108. package/dist/headless/view-model/index.d.ts +1 -1
  109. package/dist/headless/view-model/list-file-display.js +3 -2
  110. package/dist/headless/view-model/list.js +16 -0
  111. package/dist/headless/view-model/types.d.ts +33 -0
  112. package/dist/hooks/list-column-layout.js +2 -1
  113. package/dist/hooks/list-server-groups.js +14 -1
  114. package/dist/hooks/list-state-schema.d.ts +1 -0
  115. package/dist/hooks/list-state-schema.js +9 -1
  116. package/dist/hooks/use-debounced-value.d.ts +1 -0
  117. package/dist/hooks/use-debounced-value.js +11 -0
  118. package/dist/hooks/use-list-aggregates.d.ts +5 -1
  119. package/dist/hooks/use-list-aggregates.js +9 -5
  120. package/dist/hooks/use-list-table.d.ts +2 -1
  121. package/dist/hooks/use-list-table.js +3 -9
  122. package/dist/hooks/use-list-url-state.d.ts +2 -0
  123. package/dist/hooks/use-list-url-state.js +12 -4
  124. package/dist/hooks/use-list-view-state.js +23 -3
  125. package/dist/hooks/use-reference-lookup.js +7 -2
  126. package/dist/hooks/use-remembered-list-params.d.ts +6 -2
  127. package/dist/hooks/use-remembered-list-params.js +18 -3
  128. package/dist/hooks/use-store.js +0 -1
  129. package/dist/i18n-defaults.js +37 -2
  130. package/dist/index.d.ts +7 -2
  131. package/dist/index.js +4 -1
  132. package/dist/live/dispatcher-live.js +2 -0
  133. package/dist/metric-types.d.ts +2 -0
  134. package/dist/primitives-record-guidance.d.ts +53 -0
  135. package/dist/primitives-record-guidance.js +1 -0
  136. package/dist/primitives.d.ts +41 -31
  137. package/dist/server-clock.d.ts +6 -0
  138. package/dist/server-clock.js +20 -0
  139. package/dist/session/session-ended.d.ts +1 -0
  140. package/dist/session/session-ended.js +2 -2
  141. package/dist/status-tone.d.ts +1 -0
  142. package/dist/status-tone.js +5 -0
  143. package/dist/web/app/browser-locale.js +1 -1
  144. package/dist/web/app/client-plugin.d.ts +6 -1
  145. package/dist/web/app/create-app.d.ts +2 -1
  146. package/dist/web/app/create-app.js +15 -5
  147. package/dist/web/app/dashboard-body.js +25 -11
  148. package/dist/web/app/dashboard-header.d.ts +2 -1
  149. package/dist/web/app/dashboard-header.js +19 -7
  150. package/dist/web/app/dashboard-list-panel.d.ts +12 -0
  151. package/dist/web/app/dashboard-list-panel.js +149 -0
  152. package/dist/web/app/dashboard-narrow-gate.d.ts +6 -0
  153. package/dist/web/app/dashboard-narrow-gate.js +6 -0
  154. package/dist/web/app/dashboard-narrow-order.d.ts +3 -0
  155. package/dist/web/app/dashboard-narrow-order.js +6 -0
  156. package/dist/web/app/dashboard-navigation-link.d.ts +12 -0
  157. package/dist/web/app/dashboard-navigation-link.js +21 -0
  158. package/dist/web/app/dashboard-panels.d.ts +6 -23
  159. package/dist/web/app/dashboard-panels.js +53 -123
  160. package/dist/web/app/dashboard-reference-list-table.d.ts +5 -1
  161. package/dist/web/app/dashboard-reference-list-table.js +12 -4
  162. package/dist/web/app/dashboard-shared.d.ts +23 -7
  163. package/dist/web/app/dashboard-shared.js +44 -17
  164. package/dist/web/app/dashboard-stat-group-panel.d.ts +13 -0
  165. package/dist/web/app/dashboard-stat-group-panel.js +67 -0
  166. package/dist/web/app/dashboard-text-panel.d.ts +12 -0
  167. package/dist/web/app/dashboard-text-panel.js +163 -0
  168. package/dist/web/app/dashboard-text.d.ts +2 -0
  169. package/dist/web/app/dashboard-text.js +1 -1
  170. package/dist/web/app/dashboard-visibility.js +1 -1
  171. package/dist/web/app/relative-time.js +2 -1
  172. package/dist/web/editor/editor-footer.d.ts +28 -0
  173. package/dist/web/editor/editor-footer.js +23 -0
  174. package/dist/web/editor/editor-frame.d.ts +23 -0
  175. package/dist/web/editor/editor-frame.js +24 -0
  176. package/dist/web/editor/editor-header.d.ts +36 -0
  177. package/dist/web/editor/editor-header.js +30 -0
  178. package/dist/web/editor/editor-rail.d.ts +32 -0
  179. package/dist/web/editor/editor-rail.js +37 -0
  180. package/dist/web/editor/editor-workbench.d.ts +34 -0
  181. package/dist/web/editor/editor-workbench.js +19 -0
  182. package/dist/web/editor/index.d.ts +6 -0
  183. package/dist/web/editor/index.js +6 -0
  184. package/dist/web/editor/relative-when.d.ts +1 -0
  185. package/dist/web/editor/relative-when.js +18 -0
  186. package/dist/web/index.d.ts +7 -1
  187. package/dist/web/index.js +5 -1
  188. package/dist/web/layout/default-app-shell.js +6 -4
  189. package/dist/web/layout/focus-aware-sidebar.d.ts +4 -7
  190. package/dist/web/layout/focus-aware-sidebar.js +5 -7
  191. package/dist/web/layout/header-action-pinned.d.ts +8 -0
  192. package/dist/web/layout/header-action-pinned.js +25 -0
  193. package/dist/web/layout/nav-collapse-state.d.ts +5 -0
  194. package/dist/web/layout/nav-collapse-state.js +66 -0
  195. package/dist/web/layout/nav-tree.js +25 -5
  196. package/dist/web/layout/page-header-slot.d.ts +2 -0
  197. package/dist/web/layout/page-header-slot.js +4 -0
  198. package/dist/web/layout/screen-focus.d.ts +8 -0
  199. package/dist/web/layout/screen-focus.js +42 -0
  200. package/dist/web/layout/shell-focus.d.ts +6 -5
  201. package/dist/web/layout/shell-focus.js +12 -9
  202. package/dist/web/layout/shell-header.js +38 -10
  203. package/dist/web/layout/sidebar-open-state.d.ts +6 -0
  204. package/dist/web/layout/sidebar-open-state.js +28 -0
  205. package/dist/web/layout/uniform-bar-controls.d.ts +2 -2
  206. package/dist/web/layout/uniform-bar-controls.js +4 -3
  207. package/dist/web/layout/use-in-app-inbox.js +8 -1
  208. package/dist/web/layout/workspace-shell.js +6 -4
  209. package/dist/web/lib/upload-file-ref.d.ts +2 -2
  210. package/dist/web/lib/upload-file-ref.js +4 -9
  211. package/dist/web/presence/use-presence.js +7 -2
  212. package/dist/web/primitives/banner.d.ts +1 -1
  213. package/dist/web/primitives/banner.js +14 -6
  214. package/dist/web/primitives/calendar-day-picker.js +24 -5
  215. package/dist/web/primitives/card.js +1 -1
  216. package/dist/web/primitives/code-input.js +6 -1
  217. package/dist/web/primitives/data-table/actions-column.d.ts +1 -0
  218. package/dist/web/primitives/data-table/actions-column.js +4 -2
  219. package/dist/web/primitives/data-table/card-body.d.ts +5 -0
  220. package/dist/web/primitives/data-table/card-body.js +47 -5
  221. package/dist/web/primitives/data-table/card-frame.d.ts +8 -0
  222. package/dist/web/primitives/data-table/card-frame.js +9 -0
  223. package/dist/web/primitives/data-table/card-row.js +40 -7
  224. package/dist/web/primitives/data-table/card-sort-select.d.ts +6 -2
  225. package/dist/web/primitives/data-table/card-sort-select.js +10 -7
  226. package/dist/web/primitives/data-table/card-view.js +12 -2
  227. package/dist/web/primitives/data-table/column-picker-section.js +9 -2
  228. package/dist/web/primitives/data-table/column-resize-handle.js +3 -4
  229. package/dist/web/primitives/data-table/column-role.d.ts +1 -0
  230. package/dist/web/primitives/data-table/column-role.js +1 -0
  231. package/dist/web/primitives/data-table/data-cell-props.d.ts +5 -0
  232. package/dist/web/primitives/data-table/data-cell-props.js +5 -0
  233. package/dist/web/primitives/data-table/density.js +1 -0
  234. package/dist/web/primitives/data-table/facet-cluster.d.ts +2 -1
  235. package/dist/web/primitives/data-table/facet-cluster.js +2 -2
  236. package/dist/web/primitives/data-table/group-band.js +4 -0
  237. package/dist/web/primitives/data-table/hint-cell.d.ts +16 -0
  238. package/dist/web/primitives/data-table/hint-cell.js +74 -0
  239. package/dist/web/primitives/data-table/hint-column-width.d.ts +3 -0
  240. package/dist/web/primitives/data-table/hint-column-width.js +11 -0
  241. package/dist/web/primitives/data-table/measure-value.js +2 -3
  242. package/dist/web/primitives/data-table/row-action-column.d.ts +3 -0
  243. package/dist/web/primitives/data-table/row-action-column.js +4 -0
  244. package/dist/web/primitives/data-table/sort-options-select.d.ts +22 -0
  245. package/dist/web/primitives/data-table/sort-options-select.js +46 -0
  246. package/dist/web/primitives/data-table/sortable-header.d.ts +3 -1
  247. package/dist/web/primitives/data-table/sortable-header.js +5 -3
  248. package/dist/web/primitives/data-table/table-body.d.ts +1 -1
  249. package/dist/web/primitives/data-table/table-body.js +5 -3
  250. package/dist/web/primitives/data-table/table-chrome.js +3 -1
  251. package/dist/web/primitives/data-table/table-content.js +10 -5
  252. package/dist/web/primitives/data-table/table-data-cell.js +9 -3
  253. package/dist/web/primitives/data-table/table-header-row.js +5 -2
  254. package/dist/web/primitives/data-table/table-view.js +17 -3
  255. package/dist/web/primitives/data-table/toolbar-end-cluster.js +1 -1
  256. package/dist/web/primitives/data-table/toolbar.js +31 -3
  257. package/dist/web/primitives/data-table/totals-footer.d.ts +20 -0
  258. package/dist/web/primitives/data-table/totals-footer.js +40 -9
  259. package/dist/web/primitives/data-table/use-bulk-selection.js +2 -1
  260. package/dist/web/primitives/data-table/use-column-pins.js +4 -0
  261. package/dist/web/primitives/data-table/use-data-table-state.d.ts +1 -0
  262. package/dist/web/primitives/data-table/use-data-table-state.js +9 -5
  263. package/dist/web/primitives/data-table/use-measured-column-widths.js +5 -4
  264. package/dist/web/primitives/data-table/use-row-selection.js +22 -11
  265. package/dist/web/primitives/data-table/view-menu.js +7 -1
  266. package/dist/web/primitives/data-table-cell.d.ts +21 -2
  267. package/dist/web/primitives/data-table-cell.js +96 -19
  268. package/dist/web/primitives/embedded-file-cell.js +3 -2
  269. package/dist/web/primitives/embedded-list-cards.js +3 -4
  270. package/dist/web/primitives/facet-filter.d.ts +4 -2
  271. package/dist/web/primitives/facet-filter.js +26 -3
  272. package/dist/web/primitives/facet-search-filter.js +1 -1
  273. package/dist/web/primitives/file-thumbnail.d.ts +6 -2
  274. package/dist/web/primitives/file-thumbnail.js +13 -6
  275. package/dist/web/primitives/file-upload.js +3 -2
  276. package/dist/web/primitives/file-view-action.d.ts +6 -0
  277. package/dist/web/primitives/file-view-action.js +19 -0
  278. package/dist/web/primitives/files-dropzone.js +20 -9
  279. package/dist/web/primitives/form-footer-parts.d.ts +0 -1
  280. package/dist/web/primitives/form.js +0 -1
  281. package/dist/web/primitives/hint-reason-row.d.ts +32 -0
  282. package/dist/web/primitives/hint-reason-row.js +45 -0
  283. package/dist/web/primitives/index.js +6 -0
  284. package/dist/web/primitives/layout-elements.d.ts +1 -1
  285. package/dist/web/primitives/layout-elements.js +2 -2
  286. package/dist/web/primitives/metric.js +8 -6
  287. package/dist/web/primitives/page-header.d.ts +1 -1
  288. package/dist/web/primitives/page-header.js +8 -1
  289. package/dist/web/primitives/pager.js +29 -18
  290. package/dist/web/primitives/reason-box.d.ts +20 -0
  291. package/dist/web/primitives/reason-box.js +13 -0
  292. package/dist/web/primitives/record-breadcrumb.d.ts +3 -0
  293. package/dist/web/primitives/record-breadcrumb.js +11 -0
  294. package/dist/web/primitives/record-steps.d.ts +3 -0
  295. package/dist/web/primitives/record-steps.js +45 -0
  296. package/dist/web/primitives/record-summary.d.ts +3 -0
  297. package/dist/web/primitives/record-summary.js +18 -0
  298. package/dist/web/primitives/row-actions.d.ts +3 -1
  299. package/dist/web/primitives/row-actions.js +14 -5
  300. package/dist/web/primitives/segmented-select.js +5 -7
  301. package/dist/web/pwa/pwa-support.d.ts +4 -0
  302. package/dist/web/pwa/pwa-support.js +113 -0
  303. package/dist/web/sse/live-events.js +2 -2
  304. package/dist/web/tokens.js +0 -3
  305. package/dist/web/widgets/chart-parts.d.ts +7 -1
  306. package/dist/web/widgets/chart-parts.js +10 -4
  307. package/dist/web/widgets/collapsible-section.js +1 -1
  308. package/dist/web/widgets/dashboard-list-cards.d.ts +17 -0
  309. package/dist/web/widgets/dashboard-list-cards.js +54 -0
  310. package/dist/web/widgets/dashboard-list.d.ts +37 -5
  311. package/dist/web/widgets/dashboard-list.js +95 -20
  312. package/dist/web/widgets/drawer-sizing.js +1 -1
  313. package/dist/web/widgets/floating-panel.js +4 -2
  314. package/dist/web/widgets/index.d.ts +2 -0
  315. package/dist/web/widgets/index.js +2 -0
  316. package/dist/web/widgets/infinity-list.js +18 -11
  317. package/dist/web/widgets/preview-width-frame.d.ts +7 -0
  318. package/dist/web/widgets/preview-width-frame.js +10 -0
  319. package/dist/web/widgets/section-card.d.ts +1 -1
  320. package/dist/web/widgets/stacked-area-chrome.js +3 -3
  321. package/dist/web/widgets/stacked-area-tooltip.js +2 -10
  322. package/dist/web/widgets/stat-box-cell.d.ts +19 -0
  323. package/dist/web/widgets/stat-box-cell.js +10 -0
  324. package/dist/web/widgets/stat.d.ts +10 -1
  325. package/dist/web/widgets/stat.js +14 -5
  326. package/dist/web/widgets/status-badge.d.ts +7 -5
  327. package/dist/web/widgets/status-badge.js +2 -2
  328. package/dist/web/widgets/step-bar.d.ts +1 -1
  329. package/dist/web/widgets/step-bar.js +37 -7
  330. package/dist/web/widgets/upload-zone.d.ts +8 -1
  331. package/dist/web/widgets/upload-zone.js +13 -3
  332. package/package.json +5 -5
  333. package/src/changes.json +217 -0
  334. package/src/web/styles.css +9 -0
@@ -0,0 +1,36 @@
1
+ import type { ReactNode } from "react";
2
+ export type EditorMode = "edit" | "preview";
3
+ export declare function EditorModeSwitch({ testIdPrefix, mode, onMode, }: {
4
+ readonly testIdPrefix: string;
5
+ readonly mode: EditorMode;
6
+ readonly onMode: (mode: EditorMode) => void;
7
+ }): ReactNode;
8
+ export declare function EditorLocaleSwitch({ testIdPrefix, locales, locale, onLocale, }: {
9
+ readonly testIdPrefix: string;
10
+ readonly locales: readonly string[];
11
+ readonly locale: string;
12
+ readonly onLocale: (locale: string) => void;
13
+ }): ReactNode;
14
+ export type EditorSaveActions = {
15
+ readonly busy: boolean;
16
+ readonly canSave: boolean;
17
+ readonly onSave: () => void;
18
+ /** Replaces "Save", e.g. "Create" for a record that does not exist yet. */
19
+ readonly saveLabel?: string;
20
+ /** Without them the header has no publish button. */
21
+ readonly canPublish?: boolean;
22
+ readonly onPublish?: () => void;
23
+ };
24
+ export type EditorHeaderTestIds = {
25
+ readonly save: string;
26
+ readonly publish: string;
27
+ };
28
+ export declare function EditorHeader({ title, status, actions, testIds, children, }: {
29
+ readonly title: string;
30
+ /** Badge next to the title, e.g. the stored version's state. */
31
+ readonly status?: ReactNode;
32
+ readonly actions: EditorSaveActions;
33
+ readonly testIds?: EditorHeaderTestIds;
34
+ /** View controls left of the save actions (mode or kind switch). */
35
+ readonly children: ReactNode;
36
+ }): ReactNode;
@@ -0,0 +1,30 @@
1
+ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
2
+ import { useTranslation } from "../../i18n.js";
3
+ import { usePrimitives } from "../../primitives.js";
4
+ import { ModeSwitch } from "../widgets/index.js";
5
+ export function EditorModeSwitch({ testIdPrefix, mode, onMode, }) {
6
+ const t = useTranslation();
7
+ return (_jsx(ModeSwitch, { value: mode, onChange: onMode, ariaLabel: t("kumiko.editor.modeSwitch"), testId: `${testIdPrefix}-mode-switch`, options: [
8
+ { value: "edit", label: t("kumiko.contentEditor.editMode") },
9
+ { value: "preview", label: t("kumiko.contentEditor.preview") },
10
+ ] }));
11
+ }
12
+ export function EditorLocaleSwitch({ testIdPrefix, locales, locale, onLocale, }) {
13
+ const t = useTranslation();
14
+ return (_jsx(ModeSwitch, { value: locale, onChange: onLocale, ariaLabel: t("kumiko.editor.localeSwitch"), testId: `${testIdPrefix}-locale-switch`, options: locales.map((code) => ({ value: code, label: code })) }));
15
+ }
16
+ const DEFAULT_HEADER_TEST_IDS = {
17
+ save: "editor-header-save",
18
+ publish: "editor-header-publish",
19
+ };
20
+ // Title, status and the save/publish actions live in the shell header. The origin badge, the
21
+ // locale switch and the secondary action sit in the info bar below: at 1280px next to the
22
+ // sidebar, assistant and theme toggle the header has no room for them and the title would clip.
23
+ export function EditorHeader({ title, status, actions, testIds = DEFAULT_HEADER_TEST_IDS, children, }) {
24
+ const t = useTranslation();
25
+ const { Button, PageHeader } = usePrimitives();
26
+ if (PageHeader === undefined)
27
+ return null;
28
+ const { onPublish } = actions;
29
+ return (_jsx(PageHeader, { title: title, status: status, actions: _jsxs("span", { className: "flex items-center gap-2 [&_button]:px-2.5 [&_button]:text-sm", children: [children, _jsxs("span", { className: "hidden items-center gap-2 xl:flex", children: [_jsx(Button, { variant: onPublish === undefined ? "primary" : "secondary", size: "sm", disabled: !actions.canSave, loading: actions.busy, onClick: actions.onSave, testId: testIds.save, children: actions.saveLabel ?? t("kumiko.actions.save") }), onPublish !== undefined && (_jsx(Button, { size: "sm", disabled: actions.canPublish !== true, onClick: onPublish, testId: testIds.publish, children: t("kumiko.editor.publish") }))] })] }) }));
30
+ }
@@ -0,0 +1,32 @@
1
+ import type { ReactNode } from "react";
2
+ export declare function RailSection({ title, action, testId, children, }: {
3
+ readonly title: string;
4
+ readonly action?: ReactNode;
5
+ readonly testId?: string;
6
+ readonly children: ReactNode;
7
+ }): ReactNode;
8
+ export declare function RailField({ children }: {
9
+ readonly children: ReactNode;
10
+ }): ReactNode;
11
+ declare const TRAILING_TONE: {
12
+ readonly ok: "text-status-ok";
13
+ readonly bad: "text-status-bad";
14
+ readonly muted: "text-muted-foreground";
15
+ };
16
+ export declare function RailRow({ symbol, label, nameHint, required, trailing, trailingTone, action, bad, testId, onPress, }: {
17
+ readonly symbol?: string;
18
+ readonly label: string;
19
+ /** Technical name behind a translated label, shown as tooltip. */
20
+ readonly nameHint?: string;
21
+ readonly required?: boolean;
22
+ readonly trailing?: ReactNode;
23
+ readonly trailingTone?: keyof typeof TRAILING_TONE;
24
+ readonly action?: ReactNode;
25
+ readonly bad?: boolean;
26
+ readonly testId?: string;
27
+ readonly onPress?: () => void;
28
+ }): ReactNode;
29
+ export declare function RailHint({ children }: {
30
+ readonly children: ReactNode;
31
+ }): ReactNode;
32
+ export {};
@@ -0,0 +1,37 @@
1
+ import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
2
+ import { cn } from "../lib/cn.js";
3
+ export function RailSection({ title, action, testId, children, }) {
4
+ return (_jsxs("section", { className: "flex flex-col border-b pb-1", "data-testid": testId, children: [_jsxs("div", { className: "flex flex-wrap items-center gap-x-2 gap-y-1 px-3.5 pt-2.5 pb-1", children: [_jsx("span", { className: "min-w-0 text-xs font-medium uppercase tracking-wider text-muted-foreground", children: title }), action !== undefined && _jsx("div", { className: "ml-auto", children: action })] }), children] }));
5
+ }
6
+ export function RailField({ children }) {
7
+ return _jsx("div", { className: "flex flex-col gap-3 px-3.5 py-2", children: children });
8
+ }
9
+ const TRAILING_TONE = {
10
+ ok: "text-status-ok",
11
+ bad: "text-status-bad",
12
+ muted: "text-muted-foreground",
13
+ };
14
+ // The star rides on the last word so a wrapping label never leaves it alone on a line.
15
+ function RequiredLabel({ label }) {
16
+ const lastSpace = label.lastIndexOf(" ");
17
+ return (_jsxs(_Fragment, { children: [label.slice(0, lastSpace + 1), _jsxs("span", { className: "whitespace-nowrap", children: [label.slice(lastSpace + 1), _jsx("span", { className: "font-semibold text-status-bad", children: " *" })] })] }));
18
+ }
19
+ function RailSymbol({ symbol }) {
20
+ return (_jsx("span", { className: "inline-flex h-[18px] w-[22px] shrink-0 items-center justify-center rounded-sm bg-muted font-mono text-xs text-muted-foreground", children: symbol }));
21
+ }
22
+ function RailTrailing({ tone, bad, withAction, children, }) {
23
+ return (_jsx("span", { className: cn("min-w-0 text-xs", withAction ? "basis-full wrap-anywhere" : "truncate text-right", bad ? "text-status-bad" : TRAILING_TONE[tone]), title: typeof children === "string" ? children : undefined, children: children }));
24
+ }
25
+ export function RailRow({ symbol, label, nameHint, required, trailing, trailingTone = "muted", action, bad, testId, onPress, }) {
26
+ const content = (_jsxs(_Fragment, { children: [symbol !== undefined && _jsx(RailSymbol, { symbol: symbol }), _jsx("span", { className: cn(
27
+ // anywhere, not break-word: only it lets a file name without spaces narrow the min-content
28
+ // width, so the label wraps instead of running under the action.
29
+ "min-w-0 grow wrap-anywhere text-sm", trailing !== undefined && "min-w-min max-w-[65%] shrink-0", bad === true && "text-status-bad"), title: nameHint !== undefined && nameHint !== label ? nameHint : undefined, children: required === true ? _jsx(RequiredLabel, { label: label }) : label }), trailing !== undefined && (_jsx(RailTrailing, { tone: trailingTone, bad: bad === true, withAction: action !== undefined, children: trailing }))] }));
30
+ // Beside an action the row is too narrow for label and trailing text: the trailing text takes its
31
+ // own line and wraps there instead of being clipped to an ellipsis.
32
+ const rowClass = cn("flex min-h-10 min-w-0 grow items-center gap-2 px-3.5 text-left", action !== undefined && "flex-wrap gap-y-0.5 py-1");
33
+ return (_jsxs("div", { className: cn("flex items-center border-b", bad === true && "bg-status-bad-surface"), "data-testid": testId, "data-bad": bad === true ? "true" : undefined, children: [onPress === undefined ? (_jsx("div", { className: rowClass, children: content })) : (_jsx("button", { type: "button", onClick: onPress, className: cn(rowClass, "hover:bg-muted"), ...(testId !== undefined && { "data-testid": `${testId}-insert` }), children: content })), action !== undefined && _jsx("div", { className: "shrink-0 pr-2", children: action })] }));
34
+ }
35
+ export function RailHint({ children }) {
36
+ return _jsx("p", { className: "px-3.5 pt-1 pb-2 text-xs text-muted-foreground", children: children });
37
+ }
@@ -0,0 +1,34 @@
1
+ import { type ReactNode } from "react";
2
+ export type WorkbenchSave = {
3
+ readonly busy: boolean;
4
+ readonly canSave: boolean;
5
+ readonly dirty: boolean;
6
+ readonly onSave: () => void;
7
+ readonly saveLabel?: string;
8
+ readonly onDiscard: () => void;
9
+ readonly saveError: string | null;
10
+ readonly modifiedAt?: string | null;
11
+ };
12
+ export type EditorWorkbenchProps = {
13
+ readonly testId: string;
14
+ readonly title: string;
15
+ readonly status?: ReactNode;
16
+ /** Info bar text per mode. */
17
+ readonly info: {
18
+ readonly edit: ReactNode;
19
+ readonly preview: ReactNode;
20
+ };
21
+ /** Info bar controls shared by both modes, e.g. the locale switch. */
22
+ readonly controls?: ReactNode;
23
+ readonly banners?: ReactNode;
24
+ readonly edit: ReactNode;
25
+ readonly preview: ReactNode;
26
+ /** Right rail per mode; `left` adds a rail on the left (a placeholder list) shown in both modes. */
27
+ readonly rail: {
28
+ readonly edit: ReactNode;
29
+ readonly preview: ReactNode;
30
+ readonly left?: ReactNode;
31
+ };
32
+ readonly save: WorkbenchSave;
33
+ };
34
+ export declare function EditorWorkbench({ testId, title, status, info, controls, banners, edit, preview, rail, save, }: EditorWorkbenchProps): ReactNode;
@@ -0,0 +1,19 @@
1
+ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
2
+ import { useState } from "react";
3
+ import { useTranslation } from "../../i18n.js";
4
+ import { EditorFooter } from "./editor-footer.js";
5
+ import { EditorBody, EditorFrame, EditorInfoBar } from "./editor-frame.js";
6
+ import { EditorHeader, EditorModeSwitch } from "./editor-header.js";
7
+ // The shared edit/preview mask: editors that only differ in what they edit, which preview
8
+ // renderer they mount and which fields sit in the right rail compose this instead of a form.
9
+ export function EditorWorkbench({ testId, title, status, info, controls, banners, edit, preview, rail, save, }) {
10
+ const t = useTranslation();
11
+ const [mode, setMode] = useState("edit");
12
+ const editing = mode === "edit";
13
+ return (_jsxs(EditorFrame, { testId: testId, children: [_jsx(EditorHeader, { title: title, status: status, actions: {
14
+ busy: save.busy,
15
+ canSave: save.canSave,
16
+ onSave: save.onSave,
17
+ ...(save.saveLabel !== undefined && { saveLabel: save.saveLabel }),
18
+ }, children: _jsx(EditorModeSwitch, { testIdPrefix: testId, mode: mode, onMode: setMode }) }), _jsx(EditorInfoBar, { tone: "muted", testId: `${testId}-info`, controls: controls, children: editing ? info.edit : info.preview }), banners, _jsx(EditorBody, { testId: `${testId}-${mode}`, center: editing ? edit : preview, right: editing ? rail.edit : rail.preview, ...(rail.left !== undefined && { left: rail.left }) }), _jsx(EditorFooter, { testIdPrefix: testId, message: save.dirty ? { tone: "warn", text: t("kumiko.editor.unsavedChanges") } : null, saveError: save.saveError, modifiedAt: save.modifiedAt ?? null, dirty: save.dirty, busy: save.busy, canSave: save.canSave, onDiscard: save.onDiscard, onSave: save.onSave, ...(save.saveLabel !== undefined && { saveLabel: save.saveLabel }) })] }));
19
+ }
@@ -0,0 +1,6 @@
1
+ export { type EditorActionTestIds, EditorFooter, type FooterTone } from "./editor-footer.tsx";
2
+ export { EditorBody, EditorFrame, EditorInfoBar, type InfoBarTone } from "./editor-frame.tsx";
3
+ export { EditorHeader, type EditorHeaderTestIds, EditorLocaleSwitch, type EditorMode, EditorModeSwitch, type EditorSaveActions, } from "./editor-header.tsx";
4
+ export { RailField, RailHint, RailRow, RailSection } from "./editor-rail.tsx";
5
+ export { EditorWorkbench, type EditorWorkbenchProps, type WorkbenchSave, } from "./editor-workbench.tsx";
6
+ export { formatRelativeWhen } from "./relative-when.ts";
@@ -0,0 +1,6 @@
1
+ export { EditorFooter } from "./editor-footer.js";
2
+ export { EditorBody, EditorFrame, EditorInfoBar } from "./editor-frame.js";
3
+ export { EditorHeader, EditorLocaleSwitch, EditorModeSwitch, } from "./editor-header.js";
4
+ export { RailField, RailHint, RailRow, RailSection } from "./editor-rail.js";
5
+ export { EditorWorkbench, } from "./editor-workbench.js";
6
+ export { formatRelativeWhen } from "./relative-when.js";
@@ -0,0 +1 @@
1
+ export declare function formatRelativeWhen(value: string, now?: number): string;
@@ -0,0 +1,18 @@
1
+ const UNITS = [
2
+ ["day", 86_400_000],
3
+ ["hour", 3_600_000],
4
+ ["minute", 60_000],
5
+ ];
6
+ // Falls back to the raw value for an unparseable timestamp, like formatWhen.
7
+ export function formatRelativeWhen(value, now = Date.now()) {
8
+ const then = Date.parse(value);
9
+ if (Number.isNaN(then))
10
+ return value;
11
+ const formatter = new Intl.RelativeTimeFormat(undefined, { numeric: "auto" });
12
+ const elapsed = then - now;
13
+ for (const [unit, size] of UNITS) {
14
+ if (Math.abs(elapsed) >= size)
15
+ return formatter.format(Math.round(elapsed / size), unit);
16
+ }
17
+ return formatter.format(0, "minute");
18
+ }
@@ -13,6 +13,8 @@ export { KumikoLink, useBrowserNavApi } from "./app/nav.tsx";
13
13
  export { PlainContentEditor } from "./app/plain-content-editor.tsx";
14
14
  export { useResolvers } from "./app/resolvers-context.tsx";
15
15
  export { clearRememberedListState } from "./app/session-list-state-store.ts";
16
+ export type { EditorActionTestIds, EditorHeaderTestIds, EditorMode, EditorSaveActions, EditorWorkbenchProps, FooterTone, InfoBarTone, WorkbenchSave, } from "./editor/index.ts";
17
+ export { EditorBody, EditorFooter, EditorFrame, EditorHeader, EditorInfoBar, EditorLocaleSwitch, EditorModeSwitch, EditorWorkbench, formatRelativeWhen, RailField, RailHint, RailRow, RailSection, } from "./editor/index.ts";
16
18
  export type { NavIconKey } from "./icons.tsx";
17
19
  export { Icon } from "./icons.tsx";
18
20
  export type { AppLayoutProps } from "./layout/app-layout.tsx";
@@ -27,6 +29,7 @@ export type { NavReparentOverride } from "./layout/filter-app-schema-navs.ts";
27
29
  export { filterAppSchemaNavsByAllowlist, reparentAppSchemaNavs, } from "./layout/filter-app-schema-navs.ts";
28
30
  export type { HeaderActionGroupProps } from "./layout/header-action-group.tsx";
29
31
  export { HeaderActionGroup } from "./layout/header-action-group.tsx";
32
+ export { HeaderActionPinned } from "./layout/header-action-pinned.tsx";
30
33
  export type { LanguageMenuItemsProps } from "./layout/language-menu-items.tsx";
31
34
  export { LanguageMenuItems } from "./layout/language-menu-items.tsx";
32
35
  export type { LanguageSwitcherProps, LocaleOption } from "./layout/language-switcher.tsx";
@@ -65,6 +68,9 @@ export { PresenceAvatars, PresenceNotice, usePresence, usePresenceList, } from "
65
68
  export type { ActionMenuProps, MenuItemDef } from "./primitives/action-menu.tsx";
66
69
  export { ActionMenu } from "./primitives/action-menu.tsx";
67
70
  export { DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuSeparator, DropdownMenuTrigger, } from "./primitives/dropdown-menu.tsx";
71
+ export type { FileMeta } from "./primitives/file-thumbnail.tsx";
72
+ export { useFileMeta } from "./primitives/file-thumbnail.tsx";
73
+ export { FileViewAction } from "./primitives/file-view-action.tsx";
68
74
  export { BareFormProvider, DefaultCard as Card, defaultPrimitives, FormScreenShell, ScreenWidthProvider, } from "./primitives/index.tsx";
69
75
  export { PageSection, Stack } from "./primitives/layout.tsx";
70
76
  export { formatMoney } from "./primitives/money-input.tsx";
@@ -79,4 +85,4 @@ export { SidebarMenu, SidebarMenuButton, SidebarMenuItem, SidebarProvider } from
79
85
  export type { KumikoBuild } from "./version/update-checker.tsx";
80
86
  export { readLoadedBuild } from "./version/update-checker.tsx";
81
87
  export type { AiTextAreaProps, AiTextEndAction, AiTextFieldProps, BooleanFieldProps, ComparisonMetric, ComposerProps, DateFieldProps, DrawerProps, FeedRow, FileFieldProps, FloatingPanelGeometry, FloatingPanelPlacement, FloatingPanelProps, InfinityListProps, InfinityListSelection, MessageAttachment, MessageBody, MessageReaderProps, MessageReaderTab, MessageThreadProps, MobileTopBarProps, ModeSwitchVariant, NumberFieldProps, PdfMatchInfo, PdfPreviewProps, PdfPreviewSource, PhotoSlotSpec, PhotoSlotsProps, PlanCardActionSlot, PlanCardLinkSlot, PlanCardPrice, PlanCardProps, PlanGridProps, ProgressListRow, PublicShellProps, PublicShellVariant, QueryTableColumn, QueryTableProps, RangeFieldProps, ResultColumn, SectionNavLayoutProps, SelectFieldProps, SideBySideTableCell, SideBySideTableColumn, SideBySideTableRow, StatDelta, StatTone, StatusBadgeTone, StatusBarEntry, StatusTone, StepAction, StepListItem, StepListProps, StepListSelection, StepSelectability, StepSelectionAction, StepSource, StepStatus, StepTag, TextareaFieldProps, TextFieldProps, ThreadMessage, TimeseriesHeight, TimeseriesPoint, TimeseriesReferenceLine, TimeseriesXAxis, TimeseriesYAxis, UploadZoneProps, } from "./widgets/index.ts";
82
- export { AiSurface, AiTextArea, AiTextField, AttachmentCard, AttachmentChip, BooleanField, ChoiceCards, ClampedText, CollapsibleSection, ComparisonTable, Composer, DateField, DetailList, Drawer, EmptyState, ErrorState, FeedList, FileField, FloatingPanel, InfinityList, LoadingState, MessageReader, MessageThread, MiniStat, MobileTopBar, ModeSwitch, MoneyField, NumberField, PdfPreview, PercentField, PhotoSlots, PlanCard, PlanGrid, ProgressBar, ProgressList, PublicShell, QueryTable, RangeField, ResultPanel, ResultTable, SectionCard, SectionNavLayout, SelectField, SenderFrame, SenderSheet, SideBySideTable, Sparkline, STATUS_TONE_TEXT, StatCard, StatusBadge, StatusBarChart, StepBar, StepList, smoothPath, TextareaField, TextField, TimeseriesChart, UploadZone, useDraft, } from "./widgets/index.ts";
88
+ export { AiSurface, AiTextArea, AiTextField, AttachmentCard, AttachmentChip, BooleanField, ChoiceCards, ClampedText, CollapsibleSection, ComparisonTable, Composer, DateField, DetailList, Drawer, EmptyState, ErrorState, FeedList, FileField, FloatingPanel, HtmlMailFrame, InfinityList, LoadingState, MessageReader, MessageThread, MiniStat, MobileTopBar, ModeSwitch, MoneyField, NumberField, PdfPreview, PercentField, PhotoSlots, PlanCard, PlanGrid, type PreviewDevice, PreviewWidthFrame, ProgressBar, ProgressList, PublicShell, QueryTable, RangeField, ResultPanel, ResultTable, SectionCard, SectionNavLayout, SelectField, SenderFrame, SenderSheet, SideBySideTable, Sparkline, STATUS_TONE_TEXT, StatCard, StatusBadge, StatusBarChart, StepBar, StepList, smoothPath, TextareaField, TextField, TimeseriesChart, UploadZone, useDraft, } from "./widgets/index.ts";
package/dist/web/index.js CHANGED
@@ -12,6 +12,7 @@ export { KumikoLink, useBrowserNavApi } from "./app/nav.js";
12
12
  export { PlainContentEditor } from "./app/plain-content-editor.js";
13
13
  export { useResolvers } from "./app/resolvers-context.js";
14
14
  export { clearRememberedListState } from "./app/session-list-state-store.js";
15
+ export { EditorBody, EditorFooter, EditorFrame, EditorHeader, EditorInfoBar, EditorLocaleSwitch, EditorModeSwitch, EditorWorkbench, formatRelativeWhen, RailField, RailHint, RailRow, RailSection, } from "./editor/index.js";
15
16
  export { Icon } from "./icons.js";
16
17
  export { AppLayout } from "./layout/app-layout.js";
17
18
  export { Avatar } from "./layout/avatar.js";
@@ -19,6 +20,7 @@ export { DefaultAppShell } from "./layout/default-app-shell.js";
19
20
  export { EditorPanel } from "./layout/editor-panel.js";
20
21
  export { filterAppSchemaNavsByAllowlist, reparentAppSchemaNavs, } from "./layout/filter-app-schema-navs.js";
21
22
  export { HeaderActionGroup } from "./layout/header-action-group.js";
23
+ export { HeaderActionPinned } from "./layout/header-action-pinned.js";
22
24
  export { LanguageMenuItems } from "./layout/language-menu-items.js";
23
25
  export { LanguageSwitcher } from "./layout/language-switcher.js";
24
26
  export { buildNavRegistrySlice, buildNavRegistrySliceForApp, NavTree } from "./layout/nav-tree.js";
@@ -43,6 +45,8 @@ export { FileUploadFailedError, uploadFileRef } from "./lib/upload-file-ref.js";
43
45
  export { PresenceAvatars, PresenceNotice, usePresence, usePresenceList, } from "./presence/index.js";
44
46
  export { ActionMenu } from "./primitives/action-menu.js";
45
47
  export { DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuSeparator, DropdownMenuTrigger, } from "./primitives/dropdown-menu.js";
48
+ export { useFileMeta } from "./primitives/file-thumbnail.js";
49
+ export { FileViewAction } from "./primitives/file-view-action.js";
46
50
  export { BareFormProvider, DefaultCard as Card, defaultPrimitives, FormScreenShell, ScreenWidthProvider, } from "./primitives/index.js";
47
51
  export { PageSection, Stack } from "./primitives/layout.js";
48
52
  export { formatMoney } from "./primitives/money-input.js";
@@ -53,4 +57,4 @@ export { applyTokensToCssVars, defaultTokens, lightTokens, useBrowserTokensApi,
53
57
  export { ResizableHandle, ResizablePanel, ResizablePanelGroup } from "./ui/resizable.js";
54
58
  export { SidebarMenu, SidebarMenuButton, SidebarMenuItem, SidebarProvider } from "./ui/sidebar.js";
55
59
  export { readLoadedBuild } from "./version/update-checker.js";
56
- export { AiSurface, AiTextArea, AiTextField, AttachmentCard, AttachmentChip, BooleanField, ChoiceCards, ClampedText, CollapsibleSection, ComparisonTable, Composer, DateField, DetailList, Drawer, EmptyState, ErrorState, FeedList, FileField, FloatingPanel, InfinityList, LoadingState, MessageReader, MessageThread, MiniStat, MobileTopBar, ModeSwitch, MoneyField, NumberField, PdfPreview, PercentField, PhotoSlots, PlanCard, PlanGrid, ProgressBar, ProgressList, PublicShell, QueryTable, RangeField, ResultPanel, ResultTable, SectionCard, SectionNavLayout, SelectField, SenderFrame, SenderSheet, SideBySideTable, Sparkline, STATUS_TONE_TEXT, StatCard, StatusBadge, StatusBarChart, StepBar, StepList, smoothPath, TextareaField, TextField, TimeseriesChart, UploadZone, useDraft, } from "./widgets/index.js";
60
+ export { AiSurface, AiTextArea, AiTextField, AttachmentCard, AttachmentChip, BooleanField, ChoiceCards, ClampedText, CollapsibleSection, ComparisonTable, Composer, DateField, DetailList, Drawer, EmptyState, ErrorState, FeedList, FileField, FloatingPanel, HtmlMailFrame, InfinityList, LoadingState, MessageReader, MessageThread, MiniStat, MobileTopBar, ModeSwitch, MoneyField, NumberField, PdfPreview, PercentField, PhotoSlots, PlanCard, PlanGrid, PreviewWidthFrame, ProgressBar, ProgressList, PublicShell, QueryTable, RangeField, ResultPanel, ResultTable, SectionCard, SectionNavLayout, SelectField, SenderFrame, SenderSheet, SideBySideTable, Sparkline, STATUS_TONE_TEXT, StatCard, StatusBadge, StatusBarChart, StepBar, StepList, smoothPath, TextareaField, TextField, TimeseriesChart, UploadZone, useDraft, } from "./widgets/index.js";
@@ -1,12 +1,13 @@
1
1
  import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
2
- import { UserRolesProvider, useTranslation, } from "../../index.js";
2
+ import { ScreenFocusProvider, UserRolesProvider, useTranslation, } from "../../index.js";
3
3
  import { Sidebar, SidebarContent, SidebarFooter, SidebarGroup, SidebarHeader, SidebarInset, SidebarProvider, SidebarRail, } from "../ui/sidebar.js";
4
4
  import { fillClasses } from "./fill-classes.js";
5
- import { FocusAwareSidebarBody, focusSidebarProviderProps } from "./focus-aware-sidebar.js";
5
+ import { FocusAwareSidebarBody, sidebarProviderProps } from "./focus-aware-sidebar.js";
6
6
  import { NavTree } from "./nav-tree.js";
7
7
  import { PageHeaderSlotProvider } from "./page-header-slot.js";
8
8
  import { ShellFocusProvider, useShellFocusHost } from "./shell-focus.js";
9
9
  import { ShellHeader } from "./shell-header.js";
10
+ import { usePersistedSidebarOpen } from "./sidebar-open-state.js";
10
11
  import { SidebarPanelProvider, useSidebarPanelHost } from "./sidebar-panel.js";
11
12
  export function DefaultAppShell({ brand, schema, user, sidebarActions, headerActions, navBadges, sidebarFooter, focusRailNavQns, fill = true, children, }) {
12
13
  const fillCls = fillClasses(fill);
@@ -14,6 +15,7 @@ export function DefaultAppShell({ brand, schema, user, sidebarActions, headerAct
14
15
  // Second column only when a screen fills it (sidebar-09 pattern) — otherwise
15
16
  // every other screen would carry an empty strip next to the navigation.
16
17
  const panel = useSidebarPanelHost();
17
- const focus = useShellFocusHost();
18
- return (_jsx(SidebarProvider, { ...fillCls.provider, ...focusSidebarProviderProps(focus), children: _jsx(ShellFocusProvider, { value: focus.value, children: _jsxs(SidebarPanelProvider, { value: panel.value, children: [_jsxs(Sidebar, { collapsible: "icon", mobileTitle: t("kumiko.sidebar.title"), mobileDescription: t("kumiko.sidebar.description"), children: [_jsxs(FocusAwareSidebarBody, { focused: focus.focused, brand: brand, schema: schema, user: user, railNavQns: focusRailNavQns, footer: sidebarFooter, children: [_jsx(SidebarHeader, { "data-kumiko-layout": "sidebar-header", children: brand }), sidebarActions !== undefined && (_jsx(SidebarGroup, { "data-kumiko-layout": "sidebar-actions", className: "flex-row flex-wrap items-center gap-1 py-0", children: sidebarActions })), _jsx(SidebarContent, { "data-kumiko-layout": "sidebar-nav", children: _jsx(NavTree, { schema: schema, ...(user !== undefined && { user }), ...(navBadges !== undefined && { navBadges }) }) }), sidebarFooter !== undefined && (_jsx(SidebarFooter, { "data-kumiko-layout": "sidebar-footer", className: "border-t border-sidebar-border", children: sidebarFooter }))] }), _jsx(SidebarRail, { "aria-label": t("kumiko.sidebar.toggle"), title: t("kumiko.sidebar.toggle") })] }), _jsx("div", { ref: panel.ref, "data-kumiko-layout": "sidebar-panel", className: panel.occupied ? "flex h-svh shrink-0 flex-col" : "hidden" }), _jsx(SidebarInset, { className: fillCls.inset, children: _jsxs(PageHeaderSlotProvider, { children: [_jsx(ShellHeader, { schema: schema, ...(user !== undefined && { user }), ...(headerActions !== undefined && { headerActions }) }), _jsx("main", { className: fillCls.main, children: _jsx(UserRolesProvider, { roles: user?.roles, children: children }) })] }) })] }) }) }));
18
+ const focus = useShellFocusHost(headerActions);
19
+ const sidebarOpen = usePersistedSidebarOpen();
20
+ return (_jsx(ScreenFocusProvider, { children: _jsx(SidebarProvider, { ...fillCls.provider, ...sidebarProviderProps(focus, sidebarOpen), children: _jsx(ShellFocusProvider, { value: focus.value, children: _jsxs(SidebarPanelProvider, { value: panel.value, children: [_jsxs(Sidebar, { collapsible: "icon", mobileTitle: t("kumiko.sidebar.title"), mobileDescription: t("kumiko.sidebar.description"), children: [_jsxs(FocusAwareSidebarBody, { focused: focus.focused, brand: brand, schema: schema, user: user, railNavQns: focusRailNavQns, footer: sidebarFooter, children: [_jsx(SidebarHeader, { "data-kumiko-layout": "sidebar-header", children: brand }), sidebarActions !== undefined && (_jsx(SidebarGroup, { "data-kumiko-layout": "sidebar-actions", className: "flex-row flex-wrap items-center gap-1 py-0", children: sidebarActions })), _jsx(SidebarContent, { "data-kumiko-layout": "sidebar-nav", children: _jsx(NavTree, { schema: schema, ...(user !== undefined && { user }), ...(navBadges !== undefined && { navBadges }) }) }), sidebarFooter !== undefined && (_jsx(SidebarFooter, { "data-kumiko-layout": "sidebar-footer", className: "border-t border-sidebar-border", children: sidebarFooter }))] }), _jsx(SidebarRail, { "aria-label": t("kumiko.sidebar.toggle"), title: t("kumiko.sidebar.toggle") })] }), _jsx("div", { ref: panel.ref, "data-kumiko-layout": "sidebar-panel", className: panel.occupied ? "flex h-svh shrink-0 flex-col" : "hidden" }), _jsx(SidebarInset, { className: fillCls.inset, children: _jsxs(PageHeaderSlotProvider, { children: [_jsx(ShellHeader, { schema: schema, ...(user !== undefined && { user }), ...(headerActions !== undefined && { headerActions }) }), _jsx("main", { className: fillCls.main, children: _jsx(UserRolesProvider, { roles: user?.roles, children: children }) })] }) })] }) }) }) }));
19
21
  }
@@ -1,15 +1,12 @@
1
1
  import type { CSSProperties, ReactNode } from "react";
2
2
  import type { AppSchema, FeatureSchema } from "../../index.ts";
3
3
  import type { ShellFocusHost } from "./shell-focus.tsx";
4
- /** SidebarProvider props that hand the rail state to the focus host while a screen holds focus mode. */
5
- export declare function focusSidebarProviderProps(focus: ShellFocusHost): {
6
- open?: undefined;
7
- onOpenChange?: undefined;
8
- style?: undefined;
9
- } | {
4
+ import type { PersistedSidebarOpen } from "./sidebar-open-state.ts";
5
+ /** SidebarProvider props: the user-owned open state, plus the narrow rail width while a screen holds focus mode. */
6
+ export declare function sidebarProviderProps(focus: ShellFocusHost, sidebar: PersistedSidebarOpen): {
10
7
  open: boolean;
11
8
  onOpenChange: (open: boolean) => void;
12
- style: CSSProperties;
9
+ style?: CSSProperties | undefined;
13
10
  };
14
11
  /** Swaps the whole sidebar content for the focus rail while focused and collapsed on desktop. */
15
12
  export declare function FocusAwareSidebarBody({ focused, brand, schema, user, allowedNavQns, railNavQns, footer, children, }: {
@@ -3,14 +3,12 @@ import { useSidebar } from "../ui/sidebar.js";
3
3
  import { FocusRail } from "./focus-rail.js";
4
4
  // 3.5rem = the 56px rail of the focused screen; the default icon width stays 3rem.
5
5
  const FOCUS_RAIL_WIDTH_STYLE = { "--sidebar-width-icon": "3.5rem" };
6
- /** SidebarProvider props that hand the rail state to the focus host while a screen holds focus mode. */
7
- export function focusSidebarProviderProps(focus) {
8
- if (!focus.focused)
9
- return {};
6
+ /** SidebarProvider props: the user-owned open state, plus the narrow rail width while a screen holds focus mode. */
7
+ export function sidebarProviderProps(focus, sidebar) {
10
8
  return {
11
- open: focus.railOpen,
12
- onOpenChange: focus.setRailOpen,
13
- style: FOCUS_RAIL_WIDTH_STYLE,
9
+ open: sidebar.open,
10
+ onOpenChange: sidebar.setOpen,
11
+ ...(focus.focused && { style: FOCUS_RAIL_WIDTH_STYLE }),
14
12
  };
15
13
  }
16
14
  /** Swaps the whole sidebar content for the focus rail while focused and collapsed on desktop. */
@@ -0,0 +1,8 @@
1
+ import { type ReactNode } from "react";
2
+ /** Marks an app header action (e.g. the assistant trigger) that stays in the bar on a phone, next to the
3
+ * bell; the rest of `headerActions` folds into the "…" menu. Inside the menu it renders nothing. */
4
+ export declare function HeaderActionPinned({ children }: {
5
+ readonly children: ReactNode;
6
+ }): ReactNode;
7
+ export declare function collectPinnedHeaderActions(node: ReactNode): readonly ReactNode[];
8
+ export declare function isOnlyPinnedHeaderActions(node: ReactNode): boolean;
@@ -0,0 +1,25 @@
1
+ import { Children, Fragment, isValidElement, useContext } from "react";
2
+ import { HeaderOverflowMenuContext } from "./header-overflow-menu.js";
3
+ /** Marks an app header action (e.g. the assistant trigger) that stays in the bar on a phone, next to the
4
+ * bell; the rest of `headerActions` folds into the "…" menu. Inside the menu it renders nothing. */
5
+ export function HeaderActionPinned({ children }) {
6
+ const inMenu = useContext(HeaderOverflowMenuContext);
7
+ return inMenu ? null : children;
8
+ }
9
+ function isPinnedElement(node) {
10
+ return isValidElement(node) && node.type === HeaderActionPinned;
11
+ }
12
+ // Pinned markers are found in the JSX tree handed to the shell (fragments and arrays included); a marker
13
+ // hidden inside another component's render output is not seen.
14
+ function flattenFragments(node) {
15
+ return Children.toArray(node).flatMap((child) => isValidElement(child) && child.type === Fragment
16
+ ? flattenFragments(child.props.children)
17
+ : [child]);
18
+ }
19
+ export function collectPinnedHeaderActions(node) {
20
+ return flattenFragments(node).filter(isPinnedElement);
21
+ }
22
+ export function isOnlyPinnedHeaderActions(node) {
23
+ const children = flattenFragments(node);
24
+ return children.length > 0 && children.every(isPinnedElement);
25
+ }
@@ -0,0 +1,5 @@
1
+ export declare function usePersistedNavCollapse(): {
2
+ readonly collapsed: ReadonlySet<string>;
3
+ readonly toggle: (qualifiedName: string) => void;
4
+ readonly revealOnScreenChange: (screenId: string, qualifiedNames: readonly string[]) => void;
5
+ };
@@ -0,0 +1,66 @@
1
+ import { useCallback, useEffect, useState } from "react";
2
+ import { toggleSetMember } from "../../toggle-set-member.js";
3
+ const STORAGE_KEY = "kumiko.nav.collapsed";
4
+ const REVEALED_SCREEN_KEY = "kumiko.nav.revealedScreen";
5
+ // Storage can be missing (SSR, Metro), blocked (privacy mode) or hold foreign
6
+ // data, so every access degrades to "nothing collapsed" instead of throwing.
7
+ function readStoredCollapsed() {
8
+ try {
9
+ const raw = window.sessionStorage.getItem(STORAGE_KEY);
10
+ if (raw === null)
11
+ return new Set();
12
+ const parsed = JSON.parse(raw);
13
+ if (!Array.isArray(parsed))
14
+ return new Set();
15
+ return new Set(parsed.filter((entry) => typeof entry === "string"));
16
+ }
17
+ catch {
18
+ return new Set();
19
+ }
20
+ }
21
+ function writeStoredCollapsed(collapsed) {
22
+ try {
23
+ window.sessionStorage.setItem(STORAGE_KEY, JSON.stringify([...collapsed]));
24
+ }
25
+ catch {
26
+ // storage unavailable: the state just stops surviving a remount
27
+ }
28
+ }
29
+ function readRevealedScreen() {
30
+ try {
31
+ return window.sessionStorage.getItem(REVEALED_SCREEN_KEY);
32
+ }
33
+ catch {
34
+ return null;
35
+ }
36
+ }
37
+ function writeRevealedScreen(screenId) {
38
+ try {
39
+ window.sessionStorage.setItem(REVEALED_SCREEN_KEY, screenId);
40
+ }
41
+ catch {
42
+ // storage unavailable: a remount may reveal the active path once more
43
+ }
44
+ }
45
+ // The sidebar body remounts when the shell swaps it (focus mode, mobile sheet),
46
+ // so the explicitly collapsed qualified names live in sessionStorage, not in
47
+ // component state alone.
48
+ export function usePersistedNavCollapse() {
49
+ const [collapsed, setCollapsed] = useState(readStoredCollapsed);
50
+ useEffect(() => writeStoredCollapsed(collapsed), [collapsed]);
51
+ const toggle = useCallback((qualifiedName) => {
52
+ setCollapsed((prev) => toggleSetMember(prev, qualifiedName));
53
+ }, []);
54
+ const revealOnScreenChange = useCallback((screenId, qualifiedNames) => {
55
+ // skip: this screen's path was already revealed once; later collapses stay
56
+ if (readRevealedScreen() === screenId)
57
+ return;
58
+ writeRevealedScreen(screenId);
59
+ setCollapsed((prev) => {
60
+ if (!qualifiedNames.some((qn) => prev.has(qn)))
61
+ return prev;
62
+ return new Set([...prev].filter((qn) => !qualifiedNames.includes(qn)));
63
+ });
64
+ }, []);
65
+ return { collapsed, toggle, revealOnScreenChange };
66
+ }
@@ -5,12 +5,12 @@ import { rendererWarn } from "../../dev-console.js";
5
5
  import { resolveNavigation } from "../../headless/index.js";
6
6
  import { createLiveRefetchScheduler } from "../../hooks/live-refetch-scheduler.js";
7
7
  import { lastSegment, toAppSchema, useLiveEvents, useNav, useTranslation } from "../../index.js";
8
- import { toggleSetMember } from "../../toggle-set-member.js";
9
8
  import { KumikoLink } from "../app/nav.js";
10
9
  import { useNavEntities, useNavProviders } from "../app/nav-providers-context.js";
11
10
  import { NAV_ICONS } from "../icons.js";
12
11
  import { cn } from "../lib/cn.js";
13
12
  import { SidebarGroup, SidebarGroupContent, SidebarGroupLabel, SidebarInput, SidebarMenu, SidebarMenuAction, SidebarMenuButton, SidebarMenuItem, SidebarMenuSub, SidebarMenuSubButton, SidebarMenuSubItem, useSidebar, } from "../ui/sidebar.js";
13
+ import { usePersistedNavCollapse } from "./nav-collapse-state.js";
14
14
  import { resolveParentScreenId } from "./shell-breadcrumb.js";
15
15
  import { useDispatchTarget } from "./target-resolver-stub.js";
16
16
  import { parseTargetFromSearchParams } from "./target-url.js";
@@ -28,6 +28,17 @@ export function treeContainsScreen(nodes, screenId) {
28
28
  return nodes.some((n) => (n.screen !== undefined && lastSegment(n.screen) === screenId) ||
29
29
  treeContainsScreen(n.children, screenId));
30
30
  }
31
+ // Qualified names of the containers on the way to the node showing `screenId`.
32
+ function containerPathToScreen(nodes, screenId) {
33
+ for (const node of nodes) {
34
+ if (node.screen !== undefined && lastSegment(node.screen) === screenId)
35
+ return [];
36
+ const inner = containerPathToScreen(node.children, screenId);
37
+ if (inner !== undefined)
38
+ return [node.qualifiedName, ...inner];
39
+ }
40
+ return undefined;
41
+ }
31
42
  // A node survives filtering when it or a descendant matches.
32
43
  // Provider children are already materialized during filtering (provider nodes
33
44
  // are default-expanded → eagerly loaded), so static children recursion is
@@ -68,10 +79,19 @@ export function NavTree({ schema, user, testId, allowedNavQns, navBadges, }) {
68
79
  // The collapsed set contains only explicitly collapsed qualified names.
69
80
  // Everything is therefore expanded by default, so new features appear open
70
81
  // without requiring the user to click first.
71
- const [collapsed, setCollapsed] = useState(() => new Set());
72
- const onToggle = useCallback((qn) => {
73
- setCollapsed((prev) => toggleSetMember(prev, qn));
74
- }, []);
82
+ const { collapsed, toggle: onToggle, revealOnScreenChange } = usePersistedNavCollapse();
83
+ // Keyed on the active screen only, so a container the user collapses while
84
+ // staying on the screen is not reopened; other collapsed containers are left alone.
85
+ const revealScreenId = activeMarker?.screenId;
86
+ const treeRef = useRef(tree);
87
+ treeRef.current = tree;
88
+ useEffect(() => {
89
+ if (revealScreenId === undefined)
90
+ return;
91
+ const path = containerPathToScreen(treeRef.current, revealScreenId);
92
+ if (path !== undefined)
93
+ revealOnScreenChange(revealScreenId, path);
94
+ }, [revealScreenId, revealOnScreenChange]);
75
95
  const t = useTranslation();
76
96
  const { state: sidebarState } = useSidebar();
77
97
  const [filter, setFilter] = useState("");
@@ -10,6 +10,8 @@ export type PageHeaderSlot = {
10
10
  readonly setTitle: (title: string | undefined) => void;
11
11
  readonly recordTitle: string | undefined;
12
12
  readonly setRecordTitle: (recordTitle: string | undefined) => void;
13
+ readonly bodyTitle: boolean;
14
+ readonly setBodyTitle: (bodyTitle: boolean) => void;
13
15
  readonly breadcrumbHidden: boolean;
14
16
  readonly setBreadcrumbHidden: (hidden: boolean) => void;
15
17
  readonly breadcrumbScreenId: string | undefined;
@@ -18,6 +18,7 @@ export function PageHeaderSlotProvider({ children }) {
18
18
  const [actionsElement, setActionsElement] = useState(null);
19
19
  const [title, setTitle] = useState(undefined);
20
20
  const [recordTitle, setRecordTitle] = useState(undefined);
21
+ const [bodyTitle, setBodyTitle] = useState(false);
21
22
  const [breadcrumbHidden, setBreadcrumbHidden] = useState(false);
22
23
  const [breadcrumbScreenId, setBreadcrumbScreenId] = useState(undefined);
23
24
  const [overflowItems, setOverflowItems] = useState(undefined);
@@ -31,6 +32,8 @@ export function PageHeaderSlotProvider({ children }) {
31
32
  setTitle,
32
33
  recordTitle,
33
34
  setRecordTitle,
35
+ bodyTitle,
36
+ setBodyTitle,
34
37
  breadcrumbHidden,
35
38
  setBreadcrumbHidden,
36
39
  breadcrumbScreenId,
@@ -42,6 +45,7 @@ export function PageHeaderSlotProvider({ children }) {
42
45
  actionsElement,
43
46
  title,
44
47
  recordTitle,
48
+ bodyTitle,
45
49
  breadcrumbHidden,
46
50
  breadcrumbScreenId,
47
51
  overflowItems,
@@ -0,0 +1,8 @@
1
+ import type { ScreenDefinition } from "@cosmicdrift/kumiko-framework/ui-types";
2
+ import type { ReactNode } from "react";
3
+ /** Applies a screen's declarative `focus`: focused shell chrome on desktop, a MobileTopBar on phones. */
4
+ export declare function ScreenFocus({ screen, screens, children, }: {
5
+ readonly screen: ScreenDefinition;
6
+ readonly screens: readonly ScreenDefinition[];
7
+ readonly children: ReactNode;
8
+ }): ReactNode;