@cosmicdrift/kumiko-framework 0.413.1 → 0.415.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 (479) hide show
  1. package/AGENTS.md +5 -2
  2. package/agents/api/framework-db.md +14 -3
  3. package/agents/api/framework-engine.md +69 -13
  4. package/agents/api/framework-errors.md +1 -1
  5. package/agents/api/framework-event-store.md +14 -0
  6. package/agents/api/framework-ui-types.md +158 -21
  7. package/agents/api/renderer-web.md +112 -11
  8. package/agents/api/testing-helpers.md +3 -2
  9. package/agents/api/testing-stack.md +3 -0
  10. package/agents/api/types.md +248 -24
  11. package/agents/api.md +7 -7
  12. package/agents/boot-rules.md +66 -10
  13. package/agents/examples/api-docs.md +2 -6
  14. package/agents/examples/auth-mfa.md +57 -10
  15. package/agents/examples/chat-channels.md +2 -0
  16. package/agents/examples/crypto-shredding-hr.md +63 -1
  17. package/agents/examples/currencies-global.md +1 -0
  18. package/agents/examples/env-composition.md +7 -11
  19. package/agents/examples/managed-pages.md +90 -1
  20. package/agents/examples/pwa-shell.md +210 -0
  21. package/agents/examples/rate-limiting.md +3 -3
  22. package/agents/examples/record-detail-layout.md +1643 -67
  23. package/agents/examples/workflow-engine.md +16 -12
  24. package/agents/examples.md +1 -0
  25. package/agents/features-index.md +4 -2
  26. package/agents/features.md +22 -7
  27. package/agents/widgets.md +26 -1
  28. package/dist/api/api-constants.d.ts +1 -0
  29. package/dist/api/api-constants.js +4 -0
  30. package/dist/api/auth-middleware.js +4 -3
  31. package/dist/api/auth-routes-shared.js +2 -1
  32. package/dist/api/entity-read-access.d.ts +1 -0
  33. package/dist/api/entity-read-access.js +18 -0
  34. package/dist/api/export/export-route.d.ts +6 -1
  35. package/dist/api/export/export-route.js +27 -1
  36. package/dist/api/export/export-rows.js +19 -3
  37. package/dist/api/request-context-internals.d.ts +2 -0
  38. package/dist/api/request-context-scopes.js +9 -2
  39. package/dist/api/request-context.js +1 -1
  40. package/dist/api/routes.d.ts +2 -0
  41. package/dist/api/routes.js +9 -1
  42. package/dist/api/server-event-dispatcher.js +3 -0
  43. package/dist/api/server-extra-routes.js +2 -1
  44. package/dist/api/server-feature-http-routes.d.ts +9 -0
  45. package/dist/api/server-feature-http-routes.js +109 -0
  46. package/dist/api/server-middleware.js +2 -19
  47. package/dist/api/server-pat-rate-limit-guard.d.ts +3 -0
  48. package/dist/api/server-pat-rate-limit-guard.js +19 -0
  49. package/dist/api/server-rate-limit-wiring.d.ts +10 -0
  50. package/dist/api/server-rate-limit-wiring.js +37 -0
  51. package/dist/api/server-routes.d.ts +4 -12
  52. package/dist/api/server-routes.js +12 -171
  53. package/dist/api/server-schema-route.d.ts +3 -0
  54. package/dist/api/server-schema-route.js +58 -0
  55. package/dist/api/server-wiring.js +2 -37
  56. package/dist/api/server.js +3 -1
  57. package/dist/compliance/override-schema.js +5 -5
  58. package/dist/compliance/sub-processors.js +10 -1
  59. package/dist/crypto/index.d.ts +1 -1
  60. package/dist/crypto/index.js +1 -1
  61. package/dist/crypto/pii-field-encryption.d.ts +2 -0
  62. package/dist/crypto/pii-field-encryption.js +16 -1
  63. package/dist/db/apply-entity-event.js +4 -0
  64. package/dist/db/bun-sql-connection-codes.d.ts +1 -0
  65. package/dist/db/bun-sql-connection-codes.js +7 -0
  66. package/dist/db/collect-table-metas.js +4 -1
  67. package/dist/db/config-seed.js +1 -1
  68. package/dist/db/derived-field-sql.js +15 -13
  69. package/dist/db/derived-related-sql.d.ts +2 -2
  70. package/dist/db/derived-related-sql.js +4 -2
  71. package/dist/db/dialect.d.ts +3 -0
  72. package/dist/db/dialect.js +1 -3
  73. package/dist/db/driver-row-coercion.js +2 -2
  74. package/dist/db/driver-value-preparation.js +1 -1
  75. package/dist/db/eagerload.js +15 -12
  76. package/dist/db/entity-table-meta.d.ts +2 -0
  77. package/dist/db/entity-table-meta.js +7 -0
  78. package/dist/db/event-store-executor-context.js +13 -8
  79. package/dist/db/event-store-executor-read-aggregate-currencies.js +2 -2
  80. package/dist/db/event-store-executor-read-aggregate.js +2 -2
  81. package/dist/db/event-store-executor-read-filter.d.ts +4 -0
  82. package/dist/db/event-store-executor-read-filter.js +28 -11
  83. package/dist/db/event-store-executor-read-search.d.ts +1 -0
  84. package/dist/db/event-store-executor-read-search.js +6 -6
  85. package/dist/db/event-store-executor-read-sort.js +3 -3
  86. package/dist/db/event-store-executor-read-where.js +14 -5
  87. package/dist/db/event-store-executor-read.js +7 -7
  88. package/dist/db/event-store-executor-write.js +50 -95
  89. package/dist/db/executor-managed-tables.js +4 -1
  90. package/dist/db/index.d.ts +4 -2
  91. package/dist/db/index.js +4 -2
  92. package/dist/db/known-table-names.d.ts +1 -0
  93. package/dist/db/known-table-names.js +7 -5
  94. package/dist/db/list-aggregate-labels.d.ts +1 -0
  95. package/dist/db/list-aggregate-labels.js +9 -1
  96. package/dist/db/migrate-generator.js +23 -4
  97. package/dist/db/migrate-rls-diff.d.ts +1 -0
  98. package/dist/db/migrate-rls-diff.js +15 -1
  99. package/dist/db/migrate-runner.js +2 -2
  100. package/dist/db/money.d.ts +1 -1
  101. package/dist/db/money.js +1 -4
  102. package/dist/db/parent-ref-clause.d.ts +6 -2
  103. package/dist/db/parent-ref-clause.js +105 -24
  104. package/dist/db/parent-ref-global-hosts.d.ts +23 -0
  105. package/dist/db/parent-ref-global-hosts.js +85 -0
  106. package/dist/db/production-schema-command-hint.d.ts +1 -0
  107. package/dist/db/production-schema-command-hint.js +3 -0
  108. package/dist/db/queries/backfill-pii.js +55 -29
  109. package/dist/db/queries/ddl.js +13 -2
  110. package/dist/db/queries/event-store-open-streams.d.ts +15 -0
  111. package/dist/db/queries/event-store-open-streams.js +33 -0
  112. package/dist/db/queries/event-store-payload-scrub.d.ts +5 -0
  113. package/dist/db/queries/event-store-payload-scrub.js +11 -0
  114. package/dist/db/queries/event-store.js +0 -1
  115. package/dist/db/queries/raw-sql.js +0 -1
  116. package/dist/db/queries/rebuild-rls-guard.d.ts +2 -1
  117. package/dist/db/queries/rebuild-rls-guard.js +24 -11
  118. package/dist/db/queries/rls-boot-catalog.d.ts +1 -0
  119. package/dist/db/queries/rls-boot-catalog.js +13 -9
  120. package/dist/db/queries/rls-shape.d.ts +3 -1
  121. package/dist/db/queries/rls-shape.js +31 -6
  122. package/dist/db/queries/session-advisory-lock.js +2 -1
  123. package/dist/db/queries/test-stack.js +7 -7
  124. package/dist/db/query.js +16 -11
  125. package/dist/db/rebuild-marker.js +11 -2
  126. package/dist/db/render-rls-ddl.d.ts +2 -0
  127. package/dist/db/render-rls-ddl.js +16 -11
  128. package/dist/db/replay-migration-sql.js +1 -1
  129. package/dist/db/row-level-security-boot-check.js +18 -5
  130. package/dist/db/row-level-security-connection.js +25 -12
  131. package/dist/db/row-level-security-scope.d.ts +2 -1
  132. package/dist/db/row-level-security-scope.js +9 -5
  133. package/dist/db/sql-identifier.d.ts +1 -0
  134. package/dist/db/sql-identifier.js +3 -0
  135. package/dist/db/system-tenant-read-db.d.ts +5 -0
  136. package/dist/db/system-tenant-read-db.js +28 -0
  137. package/dist/db/table-builder.d.ts +3 -1
  138. package/dist/db/table-builder.js +18 -8
  139. package/dist/db/table-info.d.ts +1 -2
  140. package/dist/db/table-introspection.d.ts +3 -0
  141. package/dist/db/table-introspection.js +6 -0
  142. package/dist/db/table-push.d.ts +1 -0
  143. package/dist/db/table-push.js +7 -1
  144. package/dist/db/tenant-db-runner.d.ts +3 -0
  145. package/dist/db/tenant-db-runner.js +19 -1
  146. package/dist/db/transaction-serialization.d.ts +1 -0
  147. package/dist/db/transaction-serialization.js +20 -3
  148. package/dist/db/where-clause.js +11 -2
  149. package/dist/db/write-ownership-failures.d.ts +25 -0
  150. package/dist/db/write-ownership-failures.js +82 -0
  151. package/dist/engine/boot-validator/boot-check.js +7 -1
  152. package/dist/engine/boot-validator/boot-phases-app.js +5 -5
  153. package/dist/engine/boot-validator/boot-phases.js +3 -2
  154. package/dist/engine/boot-validator/boot-rules.d.ts +305 -28
  155. package/dist/engine/boot-validator/boot-rules.js +4 -0
  156. package/dist/engine/boot-validator/bundled-lists-table.js +2 -2
  157. package/dist/engine/boot-validator/card-meta-overflow-rules.d.ts +2 -2
  158. package/dist/engine/boot-validator/card-meta-overflow-rules.js +2 -2
  159. package/dist/engine/boot-validator/card-meta-overflow.js +8 -5
  160. package/dist/engine/boot-validator/config-deps.d.ts +0 -1
  161. package/dist/engine/boot-validator/config-deps.js +0 -28
  162. package/dist/engine/boot-validator/config-key-rules.d.ts +0 -15
  163. package/dist/engine/boot-validator/config-key-rules.js +0 -15
  164. package/dist/engine/boot-validator/dashboard-screen-target.d.ts +22 -0
  165. package/dist/engine/boot-validator/dashboard-screen-target.js +20 -0
  166. package/dist/engine/boot-validator/dashboard-stat-navigate.d.ts +1 -0
  167. package/dist/engine/boot-validator/dashboard-stat-navigate.js +25 -17
  168. package/dist/engine/boot-validator/definition-webhook-events-rules.d.ts +5 -0
  169. package/dist/engine/boot-validator/definition-webhook-events-rules.js +5 -0
  170. package/dist/engine/boot-validator/derived-sql-fields.js +1 -2
  171. package/dist/engine/boot-validator/entity-declaration-rules.d.ts +5 -0
  172. package/dist/engine/boot-validator/entity-declaration-rules.js +5 -0
  173. package/dist/engine/boot-validator/entity-list-screens.d.ts +1 -0
  174. package/dist/engine/boot-validator/entity-list-screens.js +35 -13
  175. package/dist/engine/boot-validator/entity-structure-rules.d.ts +5 -0
  176. package/dist/engine/boot-validator/entity-structure-rules.js +5 -0
  177. package/dist/engine/boot-validator/list-column-layout.js +10 -6
  178. package/dist/engine/boot-validator/list-row-guidance-rules.d.ts +67 -0
  179. package/dist/engine/boot-validator/list-row-guidance-rules.js +67 -0
  180. package/dist/engine/boot-validator/list-row-guidance.d.ts +20 -0
  181. package/dist/engine/boot-validator/list-row-guidance.js +143 -0
  182. package/dist/engine/boot-validator/list-sort-summary-rules.d.ts +42 -0
  183. package/dist/engine/boot-validator/list-sort-summary-rules.js +42 -0
  184. package/dist/engine/boot-validator/list-sort-summary.d.ts +5 -0
  185. package/dist/engine/boot-validator/list-sort-summary.js +160 -0
  186. package/dist/engine/boot-validator/list-table-options.js +15 -1
  187. package/dist/engine/boot-validator/list-table-rules.d.ts +10 -5
  188. package/dist/engine/boot-validator/list-table-rules.js +10 -5
  189. package/dist/engine/boot-validator/list-toolbar-options.d.ts +10 -0
  190. package/dist/engine/boot-validator/list-toolbar-options.js +30 -0
  191. package/dist/engine/boot-validator/named-filter-rules.d.ts +42 -2
  192. package/dist/engine/boot-validator/named-filter-rules.js +42 -2
  193. package/dist/engine/boot-validator/ownership.js +10 -1
  194. package/dist/engine/boot-validator/parent-ref.js +87 -50
  195. package/dist/engine/boot-validator/projection-list-screens.d.ts +1 -0
  196. package/dist/engine/boot-validator/projection-list-screens.js +32 -1
  197. package/dist/engine/boot-validator/query-output-columns.js +62 -9
  198. package/dist/engine/boot-validator/query-output-guidance.d.ts +7 -0
  199. package/dist/engine/boot-validator/query-output-guidance.js +40 -0
  200. package/dist/engine/boot-validator/query-refs.js +34 -1
  201. package/dist/engine/boot-validator/row-decoration.d.ts +11 -0
  202. package/dist/engine/boot-validator/row-decoration.js +16 -0
  203. package/dist/engine/boot-validator/screens-actions.js +1 -1
  204. package/dist/engine/boot-validator/screens-dashboard-links.d.ts +10 -0
  205. package/dist/engine/boot-validator/screens-dashboard-links.js +36 -0
  206. package/dist/engine/boot-validator/screens-dashboard-narrow.d.ts +4 -0
  207. package/dist/engine/boot-validator/screens-dashboard-narrow.js +211 -0
  208. package/dist/engine/boot-validator/screens-dashboard-rules.d.ts +84 -4
  209. package/dist/engine/boot-validator/screens-dashboard-rules.js +84 -4
  210. package/dist/engine/boot-validator/screens-dashboard.js +29 -7
  211. package/dist/engine/boot-validator/screens-kind-entity-list.js +32 -27
  212. package/dist/engine/boot-validator/screens-kind-projection-detail-guidance.d.ts +3 -0
  213. package/dist/engine/boot-validator/screens-kind-projection-detail-guidance.js +46 -0
  214. package/dist/engine/boot-validator/screens-kind-projection-detail-rules.d.ts +20 -0
  215. package/dist/engine/boot-validator/screens-kind-projection-detail-rules.js +20 -0
  216. package/dist/engine/boot-validator/screens-kind-projection-detail.js +2 -0
  217. package/dist/engine/boot-validator/screens-kind-projection-list.js +4 -0
  218. package/dist/engine/boot-validator/screens-kind-rules.d.ts +25 -0
  219. package/dist/engine/boot-validator/screens-kind-rules.js +25 -0
  220. package/dist/engine/boot-validator/screens-lists.d.ts +8 -2
  221. package/dist/engine/boot-validator/screens-lists.js +19 -3
  222. package/dist/engine/boot-validator/screens.js +1 -1
  223. package/dist/engine/boot-validator/sort-nulls.d.ts +2 -0
  224. package/dist/engine/boot-validator/sort-nulls.js +15 -0
  225. package/dist/engine/boot-validator/zod-shape.d.ts +2 -1
  226. package/dist/engine/boot-validator/zod-shape.js +19 -1
  227. package/dist/engine/build-app-schema.js +4 -0
  228. package/dist/engine/config-helpers.d.ts +1 -2
  229. package/dist/engine/config-helpers.js +6 -7
  230. package/dist/engine/define-feature.js +1 -0
  231. package/dist/engine/define-handler.d.ts +1 -0
  232. package/dist/engine/define-handler.js +4 -2
  233. package/dist/engine/definition-violations.js +2 -2
  234. package/dist/engine/entity-handlers.js +3 -8
  235. package/dist/engine/entity-list-runtime-options.js +9 -8
  236. package/dist/engine/factories.d.ts +2 -0
  237. package/dist/engine/feature-config-events-jobs.js +1 -0
  238. package/dist/engine/feature-entity-handlers.js +5 -2
  239. package/dist/engine/field-access.d.ts +1 -1
  240. package/dist/engine/field-access.js +7 -10
  241. package/dist/engine/find-entity.js +3 -3
  242. package/dist/engine/form-derivations.js +3 -3
  243. package/dist/engine/index.d.ts +3 -3
  244. package/dist/engine/index.js +2 -2
  245. package/dist/engine/named-filter-roles.d.ts +3 -0
  246. package/dist/engine/named-filter-roles.js +15 -0
  247. package/dist/engine/pipeline.js +0 -1
  248. package/dist/engine/project-app-schema-for-roles.js +17 -2
  249. package/dist/engine/qualified-name.js +0 -1
  250. package/dist/engine/registry-facade.js +1 -2
  251. package/dist/engine/registry-state.d.ts +1 -1
  252. package/dist/engine/registry-state.js +5 -2
  253. package/dist/engine/registry-validate.js +2 -1
  254. package/dist/engine/resolve-named-list-filters.js +5 -2
  255. package/dist/engine/schema-builder.js +9 -11
  256. package/dist/engine/screen-helpers.d.ts +12 -0
  257. package/dist/engine/screen-helpers.js +17 -1
  258. package/dist/engine/soft-delete-cleanup.js +3 -5
  259. package/dist/engine/state-machine.js +0 -1
  260. package/dist/engine/steps/_database-clock.d.ts +2 -0
  261. package/dist/engine/steps/_database-clock.js +6 -0
  262. package/dist/engine/steps/compute.js +1 -1
  263. package/dist/engine/steps/retry.js +5 -1
  264. package/dist/engine/steps/return.js +0 -1
  265. package/dist/engine/steps/wait-for-event.js +2 -1
  266. package/dist/engine/steps/wait.js +2 -1
  267. package/dist/engine/system-user.d.ts +2 -2
  268. package/dist/engine/system-user.js +2 -2
  269. package/dist/engine/types/handlers.d.ts +1 -1
  270. package/dist/engine/types/handlers.js +1 -1
  271. package/dist/engine/types/screen.d.ts +1 -1
  272. package/dist/engine/types/screen.js +1 -1
  273. package/dist/engine/webhook-contracts.d.ts +2 -3
  274. package/dist/engine/webhook-contracts.js +2 -25
  275. package/dist/engine/webhook-events.js +48 -29
  276. package/dist/engine/webhook-payload-strictness.d.ts +7 -0
  277. package/dist/engine/webhook-payload-strictness.js +53 -0
  278. package/dist/env/_zod-introspect.d.ts +1 -0
  279. package/dist/env/dry-run.d.ts +1 -1
  280. package/dist/env/dry-run.js +1 -1
  281. package/dist/env/field-meta.d.ts +4 -0
  282. package/dist/env/field-meta.js +67 -0
  283. package/dist/env/field-rules.d.ts +9 -0
  284. package/dist/env/field-rules.js +46 -0
  285. package/dist/env/index.d.ts +3 -3
  286. package/dist/env/index.js +16 -71
  287. package/dist/env/internals.d.ts +3 -0
  288. package/dist/env/internals.js +1 -2
  289. package/dist/env/required-env.d.ts +3 -1
  290. package/dist/env/required-env.js +5 -2
  291. package/dist/errors/reasons.d.ts +1 -0
  292. package/dist/errors/reasons.js +4 -0
  293. package/dist/errors/serialize.js +2 -2
  294. package/dist/errors/write-error-info.js +0 -2
  295. package/dist/es-ops/operations-schema.js +18 -7
  296. package/dist/event-store/admin-api.js +3 -3
  297. package/dist/event-store/event-store.js +0 -3
  298. package/dist/event-store/index.d.ts +1 -0
  299. package/dist/event-store/index.js +1 -0
  300. package/dist/event-store/transfer.js +1 -1
  301. package/dist/files/assert-file-refs-belong-to-tenant.d.ts +2 -1
  302. package/dist/files/assert-file-refs-belong-to-tenant.js +15 -13
  303. package/dist/files/bind-pending-file-refs.d.ts +3 -1
  304. package/dist/files/bind-pending-file-refs.js +54 -27
  305. package/dist/files/copy-pending-file-refs-to-tenant.js +7 -3
  306. package/dist/files/create-file-ref.d.ts +4 -1
  307. package/dist/files/create-file-ref.js +14 -3
  308. package/dist/files/default-file-guard.js +4 -1
  309. package/dist/files/file-claim.d.ts +6 -0
  310. package/dist/files/file-claim.js +17 -0
  311. package/dist/files/file-field-slots.d.ts +2 -0
  312. package/dist/files/file-field-slots.js +28 -0
  313. package/dist/files/file-ref-entity.d.ts +3 -0
  314. package/dist/files/file-ref-entity.js +2 -0
  315. package/dist/files/file-ref-table.d.ts +3 -0
  316. package/dist/files/file-routes.d.ts +4 -1
  317. package/dist/files/file-routes.js +80 -16
  318. package/dist/files/in-memory-provider.d.ts +1 -1
  319. package/dist/files/in-memory-provider.js +2 -1
  320. package/dist/files/index.d.ts +1 -1
  321. package/dist/files/index.js +1 -1
  322. package/dist/files/invalid-file-ref-error.d.ts +2 -0
  323. package/dist/files/invalid-file-ref-error.js +15 -0
  324. package/dist/files/local-provider.js +9 -2
  325. package/dist/files/provider-resolver.js +1 -1
  326. package/dist/files/rebind-file-ref.d.ts +3 -2
  327. package/dist/files/rebind-file-ref.js +24 -18
  328. package/dist/files/resolve-file-handles.d.ts +13 -0
  329. package/dist/files/resolve-file-handles.js +57 -0
  330. package/dist/files/storage-tracking.d.ts +1 -1
  331. package/dist/files/storage-tracking.js +5 -2
  332. package/dist/files/sweep-stale-pending-file-refs.js +10 -4
  333. package/dist/files/types.d.ts +4 -0
  334. package/dist/files/types.js +10 -0
  335. package/dist/files/upload-field-resolution.d.ts +1 -0
  336. package/dist/files/upload-field-resolution.js +16 -2
  337. package/dist/files/upload-ledger.js +1 -1
  338. package/dist/i18n/required-surface-guidance-keys.d.ts +3 -0
  339. package/dist/i18n/required-surface-guidance-keys.js +9 -0
  340. package/dist/i18n/required-surface-keys.js +21 -5
  341. package/dist/internal/boot-rule-table-expectations.d.ts +2 -0
  342. package/dist/internal/boot-rule-table-expectations.js +29 -0
  343. package/dist/internal/row-level-security.d.ts +1 -0
  344. package/dist/internal/row-level-security.js +1 -0
  345. package/dist/internal/testing.d.ts +1 -0
  346. package/dist/internal/testing.js +1 -0
  347. package/dist/jobs/index.d.ts +1 -0
  348. package/dist/jobs/index.js +1 -0
  349. package/dist/jobs/job-load-events.d.ts +10 -0
  350. package/dist/jobs/job-load-events.js +12 -0
  351. package/dist/jobs/job-runner-context.js +6 -158
  352. package/dist/jobs/job-runner-dispatch.d.ts +7 -0
  353. package/dist/jobs/job-runner-dispatch.js +57 -0
  354. package/dist/jobs/job-runner-event-triggers.js +18 -9
  355. package/dist/jobs/job-runner-execution.js +5 -2
  356. package/dist/jobs/job-runner-facets.d.ts +48 -0
  357. package/dist/jobs/job-runner-facets.js +156 -0
  358. package/dist/jobs/job-runner-gates.js +19 -11
  359. package/dist/jobs/job-runner-helpers.d.ts +5 -1
  360. package/dist/jobs/job-runner-helpers.js +18 -3
  361. package/dist/jobs/job-runner-scope.d.ts +1 -0
  362. package/dist/jobs/job-runner-scope.js +2 -0
  363. package/dist/jobs/job-runner-tenant-cap-lock.d.ts +2 -0
  364. package/dist/jobs/job-runner-tenant-cap-lock.js +30 -0
  365. package/dist/jobs/job-runner-types.d.ts +1 -0
  366. package/dist/jobs/job-runner.js +39 -70
  367. package/dist/jobs/obliterate-job-queues.d.ts +6 -0
  368. package/dist/jobs/obliterate-job-queues.js +23 -0
  369. package/dist/lifecycle/lifecycle.js +1 -1
  370. package/dist/migrations/event-header-scrub.d.ts +11 -0
  371. package/dist/migrations/event-header-scrub.js +33 -0
  372. package/dist/migrations/event-payload-scrub.d.ts +1 -1
  373. package/dist/migrations/event-payload-scrub.js +36 -4
  374. package/dist/migrations/index.d.ts +1 -0
  375. package/dist/migrations/index.js +2 -0
  376. package/dist/migrations/kumiko-drift.d.ts +5 -2
  377. package/dist/migrations/kumiko-drift.js +51 -14
  378. package/dist/migrations/pending-rebuilds.js +4 -5
  379. package/dist/observability/sensitive-filter.js +0 -12
  380. package/dist/pipeline/aggregate-type-removal.js +17 -4
  381. package/dist/pipeline/context-services.d.ts +2 -0
  382. package/dist/pipeline/context-services.js +5 -2
  383. package/dist/pipeline/dispatch-batch.js +4 -3
  384. package/dist/pipeline/dispatch-context-helpers.d.ts +11 -0
  385. package/dist/pipeline/dispatch-context-helpers.js +58 -0
  386. package/dist/pipeline/dispatch-nested-write.d.ts +7 -0
  387. package/dist/pipeline/dispatch-nested-write.js +119 -0
  388. package/dist/pipeline/dispatch-query.js +10 -3
  389. package/dist/pipeline/dispatch-scope.js +4 -3
  390. package/dist/pipeline/dispatch-shared.d.ts +2 -6
  391. package/dist/pipeline/dispatch-shared.js +6 -38
  392. package/dist/pipeline/dispatch-write.d.ts +0 -1
  393. package/dist/pipeline/dispatch-write.js +3 -302
  394. package/dist/pipeline/dispatcher-utils.js +6 -0
  395. package/dist/pipeline/effective-system-scope.d.ts +3 -0
  396. package/dist/pipeline/effective-system-scope.js +22 -0
  397. package/dist/pipeline/event-dispatcher-delivery.d.ts +1 -0
  398. package/dist/pipeline/event-dispatcher-delivery.js +20 -9
  399. package/dist/pipeline/event-dispatcher.d.ts +6 -1
  400. package/dist/pipeline/event-dispatcher.js +6 -7
  401. package/dist/pipeline/handler-context-auth.d.ts +3 -2
  402. package/dist/pipeline/handler-context-auth.js +3 -4
  403. package/dist/pipeline/handler-context-db.js +11 -4
  404. package/dist/pipeline/handler-context-dispatch.js +2 -2
  405. package/dist/pipeline/handler-context-events.d.ts +8 -3
  406. package/dist/pipeline/handler-context-events.js +20 -65
  407. package/dist/pipeline/handler-context-member-resolution.js +16 -8
  408. package/dist/pipeline/handler-context-notify.d.ts +1 -0
  409. package/dist/pipeline/handler-context-notify.js +2 -0
  410. package/dist/pipeline/handler-context-phase-denials.js +3 -2
  411. package/dist/pipeline/handler-context-projection.d.ts +3 -0
  412. package/dist/pipeline/handler-context-projection.js +39 -0
  413. package/dist/pipeline/handler-context-scope.d.ts +1 -1
  414. package/dist/pipeline/handler-context-scope.js +14 -2
  415. package/dist/pipeline/index.d.ts +1 -1
  416. package/dist/pipeline/index.js +1 -1
  417. package/dist/pipeline/irreversible-operation-gate.js +36 -10
  418. package/dist/pipeline/lifecycle-pipeline.d.ts +1 -0
  419. package/dist/pipeline/lifecycle-pipeline.js +7 -4
  420. package/dist/pipeline/member-reader.js +4 -2
  421. package/dist/pipeline/msp-rebuild.js +1 -1
  422. package/dist/pipeline/nested-write-parent-guard.d.ts +5 -0
  423. package/dist/pipeline/nested-write-parent-guard.js +81 -0
  424. package/dist/pipeline/projection-rebuild.d.ts +2 -0
  425. package/dist/pipeline/projection-rebuild.js +16 -7
  426. package/dist/pipeline/projection-state.js +4 -6
  427. package/dist/pipeline/system-hooks.js +36 -6
  428. package/dist/pipeline/write-result-masking.js +31 -3
  429. package/dist/pipeline/write-transition-guard.d.ts +7 -0
  430. package/dist/pipeline/write-transition-guard.js +95 -0
  431. package/dist/schema-cli/shared.d.ts +2 -0
  432. package/dist/schema-cli/shared.js +4 -2
  433. package/dist/schema-cli/validate-command.js +43 -28
  434. package/dist/search/meilisearch-adapter-internals.d.ts +2 -0
  435. package/dist/search/meilisearch-adapter-internals.js +5 -0
  436. package/dist/search/meilisearch-adapter.d.ts +1 -0
  437. package/dist/search/meilisearch-adapter.js +17 -11
  438. package/dist/search/reindex-entity.d.ts +2 -0
  439. package/dist/search/reindex-entity.js +32 -4
  440. package/dist/search/reindex-tenants-search.js +20 -4
  441. package/dist/time/tz-context.js +1 -1
  442. package/dist/ui-types/card-column-roles.d.ts +6 -0
  443. package/dist/ui-types/card-column-roles.js +21 -3
  444. package/dist/ui-types/index.d.ts +3 -3
  445. package/dist/ui-types/index.js +2 -2
  446. package/dist/utils/ids.js +0 -1
  447. package/dist/utils/index.d.ts +1 -0
  448. package/dist/utils/index.js +1 -0
  449. package/dist/utils/return-path-limit.d.ts +1 -0
  450. package/dist/utils/return-path-limit.js +1 -0
  451. package/package.json +5 -3
  452. package/presets/biome-app.json +39 -21
  453. package/presets/biome-plugins/admin-api.grit +10 -0
  454. package/presets/biome-plugins/error-reasons.grit +53 -0
  455. package/presets/biome-plugins/es-literal-writes-tests.grit +18 -0
  456. package/presets/biome-plugins/es-literal-writes.grit +22 -0
  457. package/presets/biome-plugins/i18n-locale-terminology-de.grit +15 -0
  458. package/presets/biome-plugins/i18n-locale-terminology-romance.grit +10 -0
  459. package/presets/biome-plugins/no-create-test-dispatcher.grit +5 -0
  460. package/presets/biome-plugins/no-css-properties-type.grit +7 -0
  461. package/presets/biome-plugins/no-date-api.grit +11 -0
  462. package/presets/biome-plugins/no-direct-fetch.grit +16 -0
  463. package/presets/biome-plugins/no-direct-fs.grit +16 -0
  464. package/presets/biome-plugins/no-external-font-cdn-css.grit +9 -0
  465. package/presets/biome-plugins/no-external-font-cdn.grit +12 -0
  466. package/presets/biome-plugins/no-raw-hooks.grit +10 -0
  467. package/presets/biome-plugins/no-same-folder-barrel-import.grit +11 -0
  468. package/presets/biome-plugins/no-screen-container-classes.grit +7 -0
  469. package/presets/biome-plugins/no-skipped-or-retried-tests.grit +34 -0
  470. package/presets/biome-plugins/no-temporal-polyfill-require.grit +10 -0
  471. package/presets/biome-plugins/raw-html-in-web.grit +40 -0
  472. package/presets/biome-plugins/raw-ui-in-app.grit +142 -0
  473. package/presets/biome-plugins/restricted-event-store-symbols.grit +18 -0
  474. package/presets/biome-plugins/test-title.grit +20 -0
  475. package/presets/biome-plugins/unsafe-json-parse.grit +12 -0
  476. package/presets/biome-rules.json +467 -0
  477. package/src/changes.json +366 -0
  478. package/dist/engine/minor-units.d.ts +0 -2
  479. package/dist/engine/minor-units.js +0 -8
@@ -485,6 +485,7 @@ type GenerateMigrationOutput = {
485
485
  retiredDrops: RetiredFrameworkTable[];
486
486
  rowLevelSecurityChanges: RowLevelSecurityChange[];
487
487
  };
488
+ const SNAPSHOT_VERSION: 1;
488
489
  type SchemaDiff = {
489
490
  newTables: EntityTableMeta[];
490
491
  droppedTables: string[];
@@ -699,6 +700,8 @@ type RenderDdlOptions = {
699
700
  ## packages/framework/src/db/render-rls-ddl.ts
700
701
 
701
702
  ```ts
703
+ const POLICY_COMMANDS: ["ALL", "SELECT", "INSERT", "UPDATE", "DELETE"];
704
+ const POLICY_KINDS: ["PERMISSIVE", "RESTRICTIVE"];
702
705
  type RowLevelSecurityPolicy = {
703
706
  name: string;
704
707
  command: (typeof POLICY_COMMANDS)[number];
@@ -859,7 +862,6 @@ type ConfigKeyOptions<T extends ConfigKeyType> = {
859
862
  pattern?: T extends "text" ? { regex: string; flags?: string; } : never;
860
863
  computed?: ConfigComputedFn<T>;
861
864
  validate?: ConfigValidateFn<T>;
862
- allowPerRequest?: T extends "text" ? never : boolean;
863
865
  required?: boolean;
864
866
  env?: string;
865
867
  inheritedToTenant?: boolean;
@@ -996,6 +998,7 @@ type UserId = string;
996
998
  ## packages/framework/src/engine/feature-changelog.ts
997
999
 
998
1000
  ```ts
1001
+ const CHANGELOG_TYPES: ["breaking", "improvement", "fix"];
999
1002
  type ChangelogType = (typeof CHANGELOG_TYPES)[number];
1000
1003
  type FeatureChangelog = {
1001
1004
  feature: string;
@@ -1059,6 +1062,7 @@ type QnType = string;
1059
1062
  ## packages/framework/src/engine/role-assignment.ts
1060
1063
 
1061
1064
  ```ts
1065
+ const ASSIGNABLE_FROM_ROLE_LIST: ["User", "Member", "Editor", "Admin", "TenantAdmin", "SystemAdmin"];
1062
1066
  type AssignableFromRole = (typeof ASSIGNABLE_FROM_ROLE_LIST)[number];
1063
1067
  ```
1064
1068
 
@@ -1083,6 +1087,10 @@ type StepListOutcome =
1083
1087
  ## packages/framework/src/engine/screen-helpers.ts
1084
1088
 
1085
1089
  ```ts
1090
+ type EmptyStateText = {
1091
+ title: string;
1092
+ description?: string | undefined;
1093
+ };
1086
1094
  type FieldsOrGroupsSection = { // Structural reader contract for every section that can carry `fields` and/or `groups`: the `EditFieldsSection` union members and `EditWriteFormSection` all assign without narrowing.
1087
1095
  fields?: EditFieldSpec[];
1088
1096
  groups?: { title: string; fields: EditFieldSpec[]; }[];
@@ -1268,6 +1276,7 @@ type JobRunner = {
1268
1276
  handleCatchUpEvent(jobName: string, eventName: string, payload: Record<string, unknown>, user: SessionUser, triggerEvent: JobTriggerEvent): Promise<void>;
1269
1277
  attachDispatcher(ref: DispatchWriteRef): void;
1270
1278
  countPendingJobs(): Promise<number>;
1279
+ isJobPending?(jobName: string, jobId: string): Promise<boolean>;
1271
1280
  };
1272
1281
  type JobRunnerOptions = {
1273
1282
  registry: Registry;
@@ -1413,7 +1422,7 @@ type Dispatcher = {
1413
1422
 
1414
1423
  ```ts
1415
1424
  type BatchTurnControl = {
1416
- holdForRetry: (eventIds: string[], reason: string) => void;
1425
+ holdForRetry: (eventIds: string[], reason: string, options?: { stillBackingOff?: boolean; }) => void;
1417
1426
  };
1418
1427
  type DispatcherPassResult = {
1419
1428
  processed: number;
@@ -1428,6 +1437,7 @@ type EventConsumer = {
1428
1437
  featureName?: string;
1429
1438
  delivery?: "shared" | "per-instance";
1430
1439
  startFrom?: "beginning" | "now";
1440
+ irreversibleWithoutEntryHandler?: IrreversibleWithoutEntryHandler;
1431
1441
  };
1432
1442
  type EventConsumerBatchHandler = (events: StoredEvent[], ctx: AppContext, turn: BatchTurnControl) => Promise<void>;
1433
1443
  type EventConsumerErrorPolicy = {
@@ -1515,6 +1525,7 @@ type RunEventStoreSeedOptions<TId extends string | number = string, TExisting ex
1515
1525
  ```ts
1516
1526
  type CardColumnRoles<C extends CardRoleColumn> = {
1517
1527
  image: C | undefined;
1528
+ lead: C | undefined; // The "to do" sentence shown above the title.
1518
1529
  title: C | undefined;
1519
1530
  status: C | undefined;
1520
1531
  meta: C[];
@@ -1525,9 +1536,11 @@ type CardRoleColumn = {
1525
1536
  type?: string;
1526
1537
  renderer?: unknown;
1527
1538
  hideOnNarrow?: boolean;
1539
+ narrowInline?: boolean;
1528
1540
  fileDisplay?: {
1529
1541
  kind: string;
1530
1542
  };
1543
+ hint?: unknown; // A "to do" hint column: never the default card title.
1531
1544
  };
1532
1545
  ```
1533
1546
 
@@ -1593,6 +1606,40 @@ type ContentEditorProps = {
1593
1606
  };
1594
1607
  ```
1595
1608
 
1609
+ ## packages/renderer/src/app/content-previews.tsx
1610
+
1611
+ ```ts
1612
+ type ContentPreviewsMap = Partial<Record<PreviewTarget, PreviewRenderer>>;
1613
+ const PREVIEW_TARGETS: ["pdf", "mail", "web", "text"];
1614
+ type PreviewRenderer = ComponentType<PreviewRendererProps>;
1615
+ type PreviewRendererProps = {
1616
+ content: string;
1617
+ editFormat: ContentEditorFormat;
1618
+ variables: Readonly<Record<string, unknown>>;
1619
+ subject: PreviewSubject;
1620
+ onResult?: (result: unknown) => void; // The renderer hands the answer of its server call to a host that shows it elsewhere (the mail editor's side rail).
1621
+ };
1622
+ type PreviewSubject =
1623
+ | {
1624
+ kind: "template";
1625
+ templateKind: string;
1626
+ slug: string;
1627
+ locale: string;
1628
+ meta: unknown;
1629
+ variableSchema?: unknown; // Placeholder schema of the template; the server derives sample values from it.
1630
+ }
1631
+ | {
1632
+ kind: "layout";
1633
+ templateKind: string;
1634
+ html: string;
1635
+ }
1636
+ | {
1637
+ kind: "body";
1638
+ }
1639
+ ;
1640
+ type PreviewTarget = (typeof PREVIEW_TARGETS)[number];
1641
+ ```
1642
+
1596
1643
  ## packages/renderer/src/app/extension-sections.tsx
1597
1644
 
1598
1645
  ```ts
@@ -1634,6 +1681,27 @@ type ScreenTarget = {
1634
1681
  };
1635
1682
  ```
1636
1683
 
1684
+ ## packages/renderer/src/card-options.ts
1685
+
1686
+ ```ts
1687
+ type CardOptions = { // Card-Options — Verhalten/Optik, ebenfalls additiv erweiterbar.
1688
+ padded?: boolean; // Body-Padding (px-6 py-6).
1689
+ radius?: "lg" | "xl"; // Eckenradius.
1690
+ footerBordered?: boolean; // Separates the footer with `border-t` and `bg-muted/30`.
1691
+ footerInset?: boolean; // Footer horizontal padding.
1692
+ fillHeight?: boolean; // Joins the ancestor fillHeight flex chain — a tabs-mode relatedList table sizing to the panel instead of the page — instead of normal document-flow height.
1693
+ framed?: boolean; // false drops border, background, shadow and radius but keeps padding and header slots — a panel inside a host surface such as a tab panel.
1694
+ screenBody?: boolean; // The card is the whole screen body (secretMint reveal and done phase): no frame, the shared screen insets and width of form screens, children stacked with a gap.
1695
+ headerLayout?: "stacked" | "inline"; // "inline": title and subtitle on one baseline row at 16px inset, compact padding (the board's side panel).
1696
+ };
1697
+ ```
1698
+
1699
+ ## packages/renderer/src/components/form-pending-uploads.tsx
1700
+
1701
+ ```ts
1702
+ type TrackFormUpload = <T>(upload: () => Promise<T>) => Promise<T>;
1703
+ ```
1704
+
1637
1705
  ## packages/renderer/src/components/list-empty-state.tsx
1638
1706
 
1639
1707
  ```ts
@@ -1642,6 +1710,15 @@ type ListEmptyStateContent = {
1642
1710
  description?: string;
1643
1711
  action?: RenderEditAction;
1644
1712
  };
1713
+ type NamedFilterEmptyContent = {
1714
+ title: string;
1715
+ description?: string;
1716
+ describedByQuery?: {
1717
+ query: string;
1718
+ describe: (params: Readonly<Record<string, unknown>>) => string;
1719
+ }; // The description needs params from a query; it renders only once the query returned an object.
1720
+ onReset: () => void;
1721
+ };
1645
1722
  ```
1646
1723
 
1647
1724
  ## packages/renderer/src/components/render-edit-types.ts
@@ -1652,6 +1729,7 @@ type RenderEditAction = {
1652
1729
  label: string;
1653
1730
  onPress: () => void | Promise<void>;
1654
1731
  style?: "primary" | "secondary" | "danger";
1732
+ display?: RowActionDisplay; // `"link"` draws the action as a text link; `style: "danger"` keeps its colour.
1655
1733
  confirm?: string;
1656
1734
  confirmLabel?: string;
1657
1735
  confirmRequired?: boolean; // Overrides the default "danger implies a confirm dialog" rule.
@@ -1670,7 +1748,7 @@ type ToolbarActionButton = {
1670
1748
  confirmLabel?: string;
1671
1749
  confirmRequired?: boolean; // Overrides the default "danger implies a confirm dialog" rule.
1672
1750
  onTrigger: () => Promise<void> | void;
1673
- icon?: IconKey; // Id-derived default icon (ACTION_ICON_BY_ID in kumiko-screen.tsx) — ToolbarAction has no author-declared icon field, unlike RowAction.
1751
+ icon?: IconKey; // The action's declared icon, else the id-derived default (ACTION_ICON_BY_ID).
1674
1752
  };
1675
1753
  ```
1676
1754
 
@@ -1767,8 +1845,10 @@ type DataTableFacet = {
1767
1845
  label: string; // Translated Button-Label ("Status", "Active").
1768
1846
  options: { value: string; label: string; }[]; // Selectable values with display labels.
1769
1847
  chips?: DataTableFacetChip[]; // Present: render the facet as a row of single-choice toggle chips instead of a dropdown.
1848
+ display?: "select"; // Chips only: "select" renders the chips as one single-choice dropdown instead of a row of toggles.
1770
1849
  showCounts?: boolean; // Chips only: show each chip's `count` next to its label.
1771
1850
  hideEmpty?: boolean; // Chips only: hide chips whose `count` is 0 (unless pressed).
1851
+ narrowPlacement?: "behind-filter"; // Below `sm` the facet opens behind the filter icon next to the search field instead of standing as a pill.
1772
1852
  onSearchChange?: (query: string) => void; // Present: the options come from a server-side search (reference facets), so the dropdown shows a search field and reports the typed term instead of filtering `options` itself.
1773
1853
  searching?: boolean; // The search is loading; the option list may still show the previous term's rows.
1774
1854
  };
@@ -1776,6 +1856,7 @@ type DataTableFacetChip = {
1776
1856
  id: string;
1777
1857
  label: string; // Translated chip label.
1778
1858
  values: string[]; // Selection a click sets; `[]` clears the facet.
1859
+ separatorAfter?: boolean; // Select display: a divider line follows this chip.
1779
1860
  count?: number; // Matching row count, undefined while unknown.
1780
1861
  };
1781
1862
  ```
@@ -1802,12 +1883,24 @@ type DataTableResetAll = {
1802
1883
  active: boolean; // True while something deviates from the screen default.
1803
1884
  onReset: () => void;
1804
1885
  };
1886
+ type DataTableSummaryItem = {
1887
+ label?: string; // Absent: the cell shows the value alone, for values that carry their own meaning ("7 need action").
1888
+ value: string | number;
1889
+ tone?: SelectOptionTone;
1890
+ column?: string; // Column field the value stands under when the table draws the row as cells; absent goes to the first column.
1891
+ };
1892
+ type DataTableSummaryRow = { // One line of "label value" pairs (the label is optional) under the rows, answered by the screen's summaryRow query.
1893
+ items: DataTableSummaryItem[];
1894
+ };
1805
1895
  type DataTableTableBlock = { // The DataTable props a screen's `table` block feeds.
1806
1896
  view?: DataTableViewOptions; // View menu (column picker, density); absent = no menu.
1807
1897
  resetAll?: DataTableResetAll; // Replaces the facet reset with one that also covers sort, search and page size.
1808
1898
  exportList?: DataTableExport; // Present: the toolbar has an export button (web only).
1809
1899
  compactHeader?: boolean; // Smaller (12px) semibold header row.
1900
+ frame?: ListTableFrame; // "card": table, summary row and pager in one bordered card from sm; bordered cards with a gap below sm.
1901
+ narrowFacets?: ListNarrowFacets; // "pills": below sm the select facets render as rounded pill triggers with a stronger border.
1810
1902
  serverGroups?: DataTableServerGroups; // Present: the rows are grouped on the server; replaces pager and infinite scroll.
1903
+ summaryRow?: DataTableSummaryRow; // Present: a footer line above the totals row with the summary query's items.
1811
1904
  totals?: DataTableTotals; // Present: a footer row with the server-computed totals of the filtered list.
1812
1905
  notice?: DataTableListNotice; // Present: the toolbar says the answer is incomplete and asks to narrow the list.
1813
1906
  rangeFacets?: DataTableRangeFacet[];
@@ -2195,6 +2288,7 @@ type EmbeddedListCellViewModel = {
2195
2288
  refOptionsQuery?: string;
2196
2289
  scale?: number; // Only for `type: "decimal"`.
2197
2290
  };
2291
+ type ListColumnCellDisplay = "badge" | "button";
2198
2292
  type ListColumnFileDisplay = // How a list cell shows a FileRef value (id or id array).
2199
2293
  | {
2200
2294
  kind: "image";
@@ -2202,14 +2296,28 @@ type ListColumnFileDisplay = // How a list cell shows a FileRef value (id or id
2202
2296
  }
2203
2297
  | {
2204
2298
  kind: "file";
2299
+ viewInDrawer?: true;
2205
2300
  }
2206
2301
  ;
2302
+ type ListColumnHintViewModel = {
2303
+ detailField?: string;
2304
+ narrowDetailField?: string; // `ListColumnHint.narrowDetailField`: replaces `detailField` in the phone card.
2305
+ narrowField?: string; // `ListColumnHint.narrowField`: replaces the sentence value in the phone card.
2306
+ toneField?: string;
2307
+ reasonField?: string;
2308
+ reasonOpenField?: string;
2309
+ reasonTitleField?: string;
2310
+ plainSentence?: boolean; // `ListColumnHint.plainSentence`: the sentence keeps the normal text color.
2311
+ emptyLabel: string;
2312
+ reasonLabel: string; // Label of the reason toggle, already translated.
2313
+ };
2207
2314
  type ListColumnViewModel = {
2208
2315
  field: string;
2209
2316
  label: string;
2210
2317
  type: string;
2211
2318
  renderer?: FieldRenderer | RuntimeRenderer;
2212
2319
  linkFor?: RuntimeCellLink;
2320
+ rowActionLink?: boolean; // Per-row action link column: a text link right-aligned without header text from sm, a small outline button on cards.
2213
2321
  linkItemsFor?: RuntimeCellLinkItems;
2214
2322
  sortable: boolean;
2215
2323
  optionLabels?: Readonly<Record<string, string>>; // Only for `type: "select"` or `type: "multiSelect"` — translated option labels keyed by raw value.
@@ -2219,8 +2327,17 @@ type ListColumnViewModel = {
2219
2327
  refLabelField?: string; // Only for `type: "reference"` — which field of the referenced entity appears as the display value in the cell (default "id").
2220
2328
  highlighted?: boolean; // Set by the caller at runtime (not schema-derived) to emphasize one column — e.g. the currently selected base-year column in a multi-year statement grid.
2221
2329
  hideOnNarrow?: boolean; // Mirrors `ListColumnSpec.hideOnNarrow`: card layout skips the column.
2330
+ showOnNarrowOnly?: boolean; // Mirrors `ListColumnSpec.showOnNarrowOnly`: the table layout skips the column.
2331
+ narrowInline?: boolean; // Mirrors `ListColumnSpec.narrowInline`: the card draws consecutive such columns on one line.
2222
2332
  grouping?: boolean; // Only for `type: "number"` — mirrors `NumberFieldDef.grouping` (default `true`).
2223
2333
  fileDisplay?: ListColumnFileDisplay; // Set for file/image columns: from the entity field type, or from a `{ format: "image" | "file" }` renderer.
2334
+ hint?: ListColumnHintViewModel; // "To do" cell (`ListColumnSpec.hint`), `emptyLabel` already translated.
2335
+ width?: number; // Start width and floor in px of a hint column; unlike other columns they apply without `table.resizing`.
2336
+ minWidth?: number;
2337
+ display?: ListColumnCellDisplay; // `ListColumnSpec.display` for list tables: a status pill or a link drawn as a button.
2338
+ badgeToneField?: string; // Row field naming the pill tone; only with `display: "badge"`.
2339
+ badgeDot?: false; // `false`: the pill has no leading dot.
2340
+ emptyPlaceholder?: false; // `false`: an empty cell stays blank instead of showing "—".
2224
2341
  };
2225
2342
  type ListRowViewModel = {
2226
2343
  id: string;
@@ -2256,6 +2373,36 @@ type MetricProps = { // Compact label/value tile (record-detail metrics band).
2256
2373
  tile?: boolean; // Draw as a KPI tile (the dashboard StatCard) instead of a band entry.
2257
2374
  tone?: DashboardStatTone;
2258
2375
  icon?: NavIconKey;
2376
+ sub?: string; // Small muted line under the value (see `MetricSpec.subField`).
2377
+ narrowSub?: string; // Replaces `sub` below `sm` (see `MetricSpec.subFieldNarrow`).
2378
+ };
2379
+ ```
2380
+
2381
+ ## packages/renderer/src/primitives-record-guidance.ts
2382
+
2383
+ ```ts
2384
+ type RecordBreadcrumbProps = { // Path above a record header; an item with a `link` is a link, the last item without one names the current record.
2385
+ items: { label: string; link?: CellLink; }[];
2386
+ ariaLabel: string;
2387
+ testId?: string;
2388
+ };
2389
+ type RecordStepsProps = { // "Next steps" panel; an item's `reason` sits behind a toggle labelled `reasonLabel`.
2390
+ title: string;
2391
+ subtitle?: string;
2392
+ emptyLabel: string; // Shown instead of the list when there are no items.
2393
+ reasonLabel: string;
2394
+ narrowLimit?: number; // Below the sm breakpoint only this many steps show; the rest sits behind a toggle.
2395
+ moreLabel?: (hiddenCount: number) => string; // Toggle label for the hidden steps; receives their count.
2396
+ lessLabel?: string;
2397
+ items: { id: string; title: string; narrowTitle?: string; detail?: string; narrowDetail?: string; tone?: SelectOptionTone; reason?: string; reasonOpen?: true; reasonTitle?: string; actions?: ReactNode; moreActions?: ReactNode; }[];
2398
+ count?: number; // Total number of steps, shown small beside the heading even when `narrowLimit` shortens the list.
2399
+ testId?: string;
2400
+ };
2401
+ type RecordSummaryProps = { // One emphasized sentence below a record header; `tone` sets the accent color.
2402
+ text: string;
2403
+ narrowText?: string; // Shown instead of `text` below the sm breakpoint.
2404
+ tone?: SelectOptionTone;
2405
+ testId?: string;
2259
2406
  };
2260
2407
  ```
2261
2408
 
@@ -2295,15 +2442,6 @@ type ButtonBaseProps = {
2295
2442
  iconEnd?: NavIconKey; // Icon after the label (e.g. "Continue →").
2296
2443
  dataAttributes?: DataAttributes;
2297
2444
  };
2298
- type CardOptions = { // Card-Options — Verhalten/Optik, ebenfalls additiv erweiterbar.
2299
- padded?: boolean; // Body-Padding (px-6 py-6).
2300
- radius?: "lg" | "xl"; // Eckenradius.
2301
- footerBordered?: boolean; // Separates the footer with `border-t` and `bg-muted/30`.
2302
- footerInset?: boolean; // Footer horizontal padding.
2303
- fillHeight?: boolean; // Joins the ancestor fillHeight flex chain — a tabs-mode relatedList table sizing to the panel instead of the page — instead of normal document-flow height.
2304
- framed?: boolean; // false drops border, background, shadow and radius but keeps padding and header slots — a panel inside a host surface such as a tab panel.
2305
- screenBody?: boolean; // The card is the whole screen body (secretMint reveal and done phase): no frame, the shared screen insets and width of form screens, children stacked with a gap.
2306
- };
2307
2445
  type CardSlots = { // Card slots are named content regions, all optional.
2308
2446
  header?: ReactNode;
2309
2447
  title?: ReactNode;
@@ -2346,7 +2484,7 @@ type DataTableRowAction = {
2346
2484
  icon?: IconKey; // Resolved icon (author `RowAction.icon` or the id-derived default) — drives both the icon-left-of-text render and the icon-only collapse rule (see `shouldRenderActionsIconOnly`).
2347
2485
  display?: RowActionDisplay; // Author-chosen inline form (`RowAction.display`).
2348
2486
  };
2349
- type DataTableRowActionMode = "adaptive" | "inline";
2487
+ type DataTableRowActionMode = "adaptive" | "inline" | "menu";
2350
2488
  type DataTableSort = {
2351
2489
  field: string;
2352
2490
  dir: DataTableSortDir;
@@ -2383,6 +2521,7 @@ type FileValueListProps = { // Read-only list of stored files (FileRef ids): nam
2383
2521
  type FillContainerProps = { // Chromeless flex-fill layout host — no title, no card frame, no padding, just a container that sizes to its content and, once the ancestor chain is height-constrained, shrinks so one scrolling child can scroll internally instead of the page growing.
2384
2522
  children: ReactNode;
2385
2523
  testId?: string;
2524
+ className?: string; // Layout extras, merged via cn().
2386
2525
  grow?: boolean; // Claims the remaining height of the flex chain (`flex-1`) instead of sizing to its content, so a footer inside the child sits at the bottom edge even with few rows.
2387
2526
  };
2388
2527
  type FormSectionNavItem = { // One entry of a form's "on this page" navigation: `id` matches the `SectionProps.id` of the section it scrolls to.
@@ -2440,9 +2579,10 @@ type PageHeaderProps = { // Page title area rendered by the app shell's header i
2440
2579
  recordTitle?: string; // Name of the loaded record; shown as an extra breadcrumb before the last one.
2441
2580
  status?: ReactNode;
2442
2581
  actions?: ReactNode;
2582
+ bodyTitle?: boolean; // Screen renders its own h1: the shell header shows only the parent crumb, as text.
2443
2583
  overflowItems?: ActionMenuItemSpec[]; // Land in the shell header's overflow menu at phone width.
2444
- hideBreadcrumb?: boolean; // Hide the shell header's breadcrumb while mounted, for a screen that stands in for the one the route names (a locked screen's fallback).
2445
- breadcrumbScreenId?: string; // Label the breadcrumb with this screen (id as in the route) instead of the one the route names, for a locked screen's fallback.
2584
+ hideBreadcrumb?: boolean; // Hide the shell header's breadcrumb while mounted (a locked screen's fallback).
2585
+ breadcrumbScreenId?: string; // Label the breadcrumb with this screen (route id) instead of the routed one; wins over `hideBreadcrumb`.
2446
2586
  };
2447
2587
  type PickedFile = { // Platform-neutral view of a picked file; the DOM `File` satisfies it.
2448
2588
  name: string;
@@ -2510,10 +2650,10 @@ type StepBarProps = { // Wizard step overview — numbered chips, one per step l
2510
2650
  doneSteps?: boolean[]; // Explicit done state per step index.
2511
2651
  selectableSteps?: "done" | "all"; // "done" (default): only done steps are jump targets.
2512
2652
  narrowLayout?: "label" | "steps"; // "label" (default) swaps the step row for `compactLabel` on narrow viewports; "steps" keeps the row there too — for short wizards whose labels fit a phone and whose done steps must stay tappable.
2513
- orientation?: "horizontal" | "vertical"; // "vertical" renders a step rail (from `lg`, with `compactLabel` as the single line below it) instead of the chip row.
2653
+ orientation?: "horizontal" | "vertical" | "stacked"; // "vertical" renders a step rail (from `lg`, with `compactLabel` as the single line below it); "stacked": plain stage list at every width.
2514
2654
  heading?: string; // Vertical only: rail heading ("Step 4 of 6") and optional description.
2515
2655
  description?: string;
2516
- subtitles?: (string | undefined)[]; // Vertical only: line under each step label, same order as `steps`.
2656
+ subtitles?: (string | undefined)[]; // Vertical and stacked only: line under each step label, same order as `steps`.
2517
2657
  upNext?: {
2518
2658
  heading: string;
2519
2659
  title: string;
@@ -2554,7 +2694,6 @@ type WizardStepGroupProps = { // Wraps a single wizard step so it stays mounted
2554
2694
 
2555
2695
  ```ts
2556
2696
  type StatusBadgeOptionTone = StatusTone | "accent"; // Tones a select option can request: the status tones plus the brand `accent`.
2557
- type StatusTone = "ok" | "warn" | "bad" | "critical" | "muted";
2558
2697
  ```
2559
2698
 
2560
2699
  ## packages/renderer/src/web/app/client-plugin.tsx
@@ -2582,6 +2721,12 @@ type BoundaryErrorHandler = (error: Error, info: ErrorInfo, context: BoundaryErr
2582
2721
  type ResolverComponent = ComponentType<{ target: TargetRef; onClose: () => void; }>;
2583
2722
  ```
2584
2723
 
2724
+ ## packages/renderer/src/web/editor/editor-rail.tsx
2725
+
2726
+ ```ts
2727
+ const TRAILING_TONE: { ok: "text-status-ok"; bad: "text-status-bad"; muted: "text-muted-foreground"; };
2728
+ ```
2729
+
2585
2730
  ## packages/renderer/src/web/layout/default-app-shell.tsx
2586
2731
 
2587
2732
  ```ts
@@ -2591,6 +2736,12 @@ type DefaultAppShellUser = {
2591
2736
  };
2592
2737
  ```
2593
2738
 
2739
+ ## packages/renderer/src/web/layout/shell-style.tsx
2740
+
2741
+ ```ts
2742
+ type ShellNavStyle = "default" | "plain";
2743
+ ```
2744
+
2594
2745
  ## packages/renderer/src/web/layout/sidebar-panel.tsx
2595
2746
 
2596
2747
  ```ts
@@ -2633,6 +2784,7 @@ type PageSectionProps = {
2633
2784
  testId?: string;
2634
2785
  maxWidth?: ScreenWidth;
2635
2786
  };
2787
+ const STACK_GAP: { sm: "gap-2"; md: "gap-4"; lg: "gap-6"; };
2636
2788
  type ScreenWidth = FormWidth;
2637
2789
  type StackGap = keyof typeof STACK_GAP;
2638
2790
  type StackProps = {
@@ -2641,6 +2793,7 @@ type StackProps = {
2641
2793
  children?: ReactNode;
2642
2794
  testId?: string;
2643
2795
  };
2796
+ const screenFormColumnWidthClassName: Record<ScreenWidth, string>;
2644
2797
  ```
2645
2798
 
2646
2799
  ## packages/renderer/src/web/primitives/toast.tsx
@@ -2659,6 +2812,12 @@ type LiveEventTimers = {
2659
2812
  };
2660
2813
  ```
2661
2814
 
2815
+ ## packages/renderer/src/web/ui/sidebar.tsx
2816
+
2817
+ ```ts
2818
+ const sidebarMenuButtonVariants;
2819
+ ```
2820
+
2662
2821
  ## packages/renderer/src/web/widgets/ai-text-field.tsx
2663
2822
 
2664
2823
  ```ts
@@ -2808,6 +2967,9 @@ type ClockStep = {
2808
2967
  ## packages/testing/src/helpers/seed.ts
2809
2968
 
2810
2969
  ```ts
2970
+ type SeedOptions = {
2971
+ projectionOnly?: string;
2972
+ };
2811
2973
  type SeedTable = EntityTable | EntityTableMeta;
2812
2974
  ```
2813
2975
 
@@ -3042,6 +3204,8 @@ type ExtensionSelectorDef = {
3042
3204
  panels?: ExtensionSelectorPanel[];
3043
3205
  };
3044
3206
  type ExtensionSelectorPanel = DashboardCustomPanel | Omit<DashboardScreenPanel, "label">;
3207
+ const IRREVERSIBLE_WITHOUT_ENTRY_HANDLER_CASES: ["rebuildable-derived-data", "high-risk-or-cron-pipeline", "per-dispatch-record-key"];
3208
+ type IrreversibleWithoutEntryHandler = (typeof IRREVERSIBLE_WITHOUT_ENTRY_HANDLER_CASES)[number];
3045
3209
  type JobBackoff =
3046
3210
  | JobBackoffStrategy
3047
3211
  | {
@@ -3128,7 +3292,6 @@ type PgListenSubscription = {
3128
3292
  type RawDbClient = {
3129
3293
  unsafe: (sql: string, params?: unknown[]) => PromiseLike<unknown[]>;
3130
3294
  begin: <T>(fn: (tx: DbTx) => Promise<T>) => Promise<T>;
3131
- end?: (options?: { timeout?: number; }) => Promise<void>;
3132
3295
  };
3133
3296
  ```
3134
3297
 
@@ -3282,6 +3445,7 @@ type UnmanagedTableInput = {
3282
3445
  indexes?: IndexMeta[];
3283
3446
  compositePrimaryKey?: CompositePrimaryKeyMeta;
3284
3447
  tenancy?: EntityTenancy;
3448
+ systemRowsReadable?: true;
3285
3449
  };
3286
3450
  ```
3287
3451
 
@@ -3343,6 +3507,7 @@ type ParentVisibilityOption = {
3343
3507
  readModelEntities?: ReadonlyMap<string, { entity: EntityDefinition; table: SchemaTable; }>;
3344
3508
  canReadEntity?: (entityName: string) => boolean;
3345
3509
  resolveTable?: (entityName: string) => SchemaTable;
3510
+ globalHostIds?: ReadonlyMap<string, string[]>;
3346
3511
  };
3347
3512
  type PreSaveRunner = (changes: Record<string, unknown>, previous: Readonly<Record<string, unknown>>, isNew: boolean) => Promise<Record<string, unknown>>;
3348
3513
  type StreamTenantOption = {
@@ -3825,6 +3990,7 @@ type ResolvedPiiStance =
3825
3990
  subjectRef: true;
3826
3991
  }
3827
3992
  ;
3993
+ const SELECT_OPTION_TONES: ["ok", "warn", "bad", "critical", "accent", "neutral"];
3828
3994
  type SelectConditionalOptions<TOption extends string = string> = { // Options of a select field that are only available while `when` holds for the row values.
3829
3995
  options: TOption[];
3830
3996
  when: Exclude<FieldCondition, boolean>;
@@ -3976,6 +4142,7 @@ type ContextServices = { // Infrastructure the app wired at boot, as the handler
3976
4142
  _notifyFactory?: NotifyFactory;
3977
4143
  _notifyInTransactionFactory?: (user: SessionUser, tenantId: TenantId) => NotifyFn;
3978
4144
  _notifyAfterCommitFactory?: (user: SessionUser, tenantId: TenantId) => NotifyFn;
4145
+ _logOwnDeliveryAttempt?: DeliveryAttemptLogFn;
3979
4146
  _escapeHatchAuditSink?: EscapeHatchAuditSink;
3980
4147
  extensions: Readonly<Record<string, unknown>>;
3981
4148
  };
@@ -4060,6 +4227,7 @@ type DispatchWriteRef = {
4060
4227
  queryAs: (user: SessionUser, qn: string, payload: unknown, inheritedOrigin?: WriteOrigin) => Promise<unknown>;
4061
4228
  createMemberReader: (tenantId: TenantId) => MemberReader;
4062
4229
  };
4230
+ const ESCAPE_HATCH_GRANTS: ["systemIdentity", "globalWrites", "unsafeRaw", "crossTenantReads"];
4063
4231
  type EntityRef = {
4064
4232
  name: string;
4065
4233
  table: string;
@@ -4113,6 +4281,7 @@ type JobRunnerRef = {
4113
4281
  handleEvent(eventName: string, payload: Record<string, unknown>, user?: SessionUser, triggerEvent?: JobTriggerEvent): Promise<void>;
4114
4282
  handleCatchUpEvent?(jobName: string, eventName: string, payload: Record<string, unknown>, user: SessionUser, triggerEvent: JobTriggerEvent): Promise<void>;
4115
4283
  dispatch?(jobName: string, payload: Record<string, unknown>, meta?: { priority?: number; jobId?: string; }): Promise<unknown>;
4284
+ isJobPending?(jobName: string, jobId: string): Promise<boolean>;
4116
4285
  };
4117
4286
  type JobTriggerEvent = {
4118
4287
  id: string;
@@ -4149,6 +4318,7 @@ type PreparedOrSkipped<TPrepared, TWhenNested> = [ TWhenNested ] extends [ Befor
4149
4318
  type PreparedWriteEvent<TPayload = unknown, TPrepared = unknown> = WriteEvent<TPayload> & ([ TPrepared ] extends [ undefined ] ? { prepared?: undefined; } : { prepared: TPrepared; }); // What a handler sees when its `beforeTransaction` phase ran: the phase's `data` as `prepared`; absent for handlers without the phase.
4150
4319
  type QualifiedEventName<TFeature extends string, TInner extends string> = `${CamelToKebab<TFeature>}:event:${CamelToKebab<TInner>}`; // Builds the qualified event-name from feature + inner-name in the same shape the runtime emits via `qn(toKebab(feature), "event", toKebab(inner))`.
4151
4320
  type QueryHandlerFn<TPayload = unknown, TResult = unknown> = (query: QueryEvent<TPayload>, context: HandlerContext) => Promise<TResult>;
4321
+ const RATE_LIMIT_PERS: ["user", "tenant", "ip", "user+handler", "tenant+handler", "ip+handler"];
4152
4322
  type RateLimitDeclaration = RateLimitOption | RateLimitOptions | RateLimitDisabled;
4153
4323
  type RateLimitDisabled = {
4154
4324
  disabled: true;
@@ -4196,6 +4366,8 @@ type SharedContextFields = {
4196
4366
  _notifyFactory?: NotifyFactory;
4197
4367
  _notifyInTransactionFactory?: (user: SessionUser, tenantId: TenantId) => NotifyFn;
4198
4368
  _notifyAfterCommitFactory?: (user: SessionUser, tenantId: TenantId) => NotifyFn;
4369
+ _deliveryAttemptLogFactory?: DeliveryAttemptLogFactory;
4370
+ _logOwnDeliveryAttempt?: DeliveryAttemptLogFn;
4199
4371
  _escapeHatchAuditSink?: EscapeHatchAuditSink;
4200
4372
  secrets?: SecretsContext;
4201
4373
  masterKeyProvider?: MasterKeyProvider;
@@ -4346,6 +4518,7 @@ type SubjectId =
4346
4518
  ## packages/types/src/list-aggregate-types.ts
4347
4519
 
4348
4520
  ```ts
4521
+ const LIST_AGGREGATE_MEASURE_KINDS: ["sum", "avg", "count", "min", "max"];
4349
4522
  type ListAggregateCurrencyAmount = {
4350
4523
  currency: string;
4351
4524
  value: number;
@@ -4386,7 +4559,7 @@ type Logger = {
4386
4559
  ```ts
4387
4560
  type MultiStreamApplyContext<TMap extends object = KumikoEventTypeMap> = {
4388
4561
  appendEvent: AppendEventFn<TMap>;
4389
- unsafeAppendEvent: UnsafeAppendEventFn;
4562
+ unsafeAppendEvent: (args: Parameters<UnsafeAppendEventFn>[0] & { expectedVersion?: number; }) => Promise<void>;
4390
4563
  loadAggregate: (aggregateId: string, options?: { asOf?: Temporal.Instant; }) => Promise<StoredEvent[]>;
4391
4564
  registry: Registry;
4392
4565
  files?: FileContext;
@@ -4401,6 +4574,14 @@ type MultiStreamApplyContext<TMap extends object = KumikoEventTypeMap> = {
4401
4574
  ## packages/types/src/named-list-filters.ts
4402
4575
 
4403
4576
  ```ts
4577
+ type ListSortDir = "asc" | "desc";
4578
+ type NamedFilterFacetOptions = { // How the named filters appear in the toolbar: toggle chips (default) or one single-choice select.
4579
+ display?: "chips" | "select";
4580
+ showCounts?: boolean; // Ask the list query for each filter's hit count and show it next to the label.
4581
+ hideEmpty?: boolean; // Select entries with zero hits are left out (the active one and "all" stay).
4582
+ narrowPlacement?: "behind-filter"; // "behind-filter": the select opens behind the filter icon next to the search field instead of standing as a pill.
4583
+ label?: string; // i18n key for the select's label, e.g. "To do".
4584
+ };
4404
4585
  type NamedListFilterCondition = {
4405
4586
  field: string;
4406
4587
  op: NamedListFilterOp;
@@ -4414,6 +4595,14 @@ type NamedListFilterOp = "eq" | "ne" | "lt" | "gt" | "lte" | "gte" | "in";
4414
4595
  type NamedListFilterRef = { // Screen-side reference to an entity-defined named filter; `label` is an i18n key.
4415
4596
  id: string;
4416
4597
  label: string;
4598
+ sort?: ListSortSpec; // Order while this filter is active and the URL carries no sort of its own; wins over `defaultSort`.
4599
+ separatorAfter?: boolean; // Select display: draws a divider line below this entry in the dropdown.
4600
+ emptyState?: {
4601
+ title: string;
4602
+ description?: string;
4603
+ paramsQuery?: string;
4604
+ }; // Shown instead of the generic "no matches" text when this filter yields an empty list and no search term is set; `title` and `description` are i18n keys.
4605
+ access?: AccessRule; // Set by the framework from the entity filter's access rule; the client offers the chip only where `isUiAccessGranted` allows it.
4417
4606
  };
4418
4607
  type NamedListFilterScope = {
4419
4608
  ctx: HandlerContext;
@@ -4422,6 +4611,12 @@ type NamedListFilterScope = {
4422
4611
  };
4423
4612
  ```
4424
4613
 
4614
+ ## packages/types/src/nav-icon.ts
4615
+
4616
+ ```ts
4617
+ const NAV_ICON_KEYS;
4618
+ ```
4619
+
4425
4620
  ## packages/types/src/nav.ts
4426
4621
 
4427
4622
  ```ts
@@ -4488,8 +4683,6 @@ type SamplingConfig = {
4488
4683
  };
4489
4684
  };
4490
4685
  type SensitiveFilterConfig = {
4491
- redactedHeaders: string[];
4492
- redactedQueryParams: string[];
4493
4686
  redactedAttributeKeyPatterns: RegExp[];
4494
4687
  };
4495
4688
  ```
@@ -4768,6 +4961,7 @@ type SecretsEditSection = {
4768
4961
  ## packages/types/src/screen-dashboard.ts
4769
4962
 
4770
4963
  ```ts
4964
+ const DASHBOARD_STAT_TONES: ["default", "positive", "ok", "warn", "negative"];
4771
4965
  type DashboardChartKind = "timeseries" | "stacked-bars" | "segment-bars" | "stacked-area";
4772
4966
  type DashboardChartRangeOption = { // One option of a stacked-area range switch.
4773
4967
  value: string;
@@ -4779,6 +4973,13 @@ type DashboardChartRanges = {
4779
4973
  default: string;
4780
4974
  };
4781
4975
  type DashboardChartTone = "positive" | "negative" | "active" | "neutral";
4976
+ type DashboardListRowLink = ({ screen: string; paramField?: string; screenField?: never; paramsField?: never; } | { screenField: string; paramsField?: string; screen?: never; paramField?: never; }) & { // Row link of a list panel: one fixed target screen (`screen`) or, when the rows point to different places, the screen named by each row (`screenField`).
4977
+ icon?: "arrow" | "chevron"; // "arrow" (default) draws ↗ for a jump to another place, "chevron" draws › for opening the row.
4978
+ };
4979
+ type DashboardListShowTotal = { // Texts of the "n of m" count in a list panel's subtitle; without `text` the default i18n text stands.
4980
+ text?: string; // i18n key, placeholders `{shown}` and `{total}`.
4981
+ narrowText?: string; // i18n key used instead of `text` below `sm`.
4982
+ };
4782
4983
  type DashboardPanelGate = {
4783
4984
  visibleWhen?: DashboardPanelVisibility;
4784
4985
  };
@@ -4840,10 +5041,10 @@ type EntityListFacetExtraOption = { // An extra choice on a facet next to the fi
4840
5041
  label: string; // i18n key.
4841
5042
  values: string[]; // Option values this choice selects; `[]` selects nothing, i.e. no filter.
4842
5043
  position?: "start" | "end"; // Where the chip sits relative to the field's own options.
5044
+ separatorAfter?: boolean; // Draws a divider line below this choice in the select dropdown (e.g. after a "needs action" bundle).
4843
5045
  };
4844
- type ListColumnDisplay = "bar" | "badge" | "datetime";
5046
+ type ListColumnDisplay = "bar" | "badge" | "datetime" | "button";
4845
5047
  type ListPaginationMode = "pages" | "infinite" | false;
4846
- type ListSortDir = "asc" | "desc";
4847
5048
  type RowActionNavigateBase = {
4848
5049
  kind: "navigate";
4849
5050
  id: string;
@@ -4882,12 +5083,19 @@ type ExpandableRowGrouping = Omit<ListTableGrouping, "field" | "userChoice" | "f
4882
5083
  ## packages/types/src/screen-list-table.ts
4883
5084
 
4884
5085
  ```ts
5086
+ const LIST_COLUMN_PINS: ["left", "right"];
5087
+ const LIST_NARROW_FACETS: ["pills"];
5088
+ const LIST_TABLE_DENSITIES: ["comfortable", "compact", "relaxed"];
5089
+ const LIST_TABLE_FRAMES: ["card"];
5090
+ const LIST_TOOLBAR_ACTIONS_PLACEMENTS: ["header", "toolbar"];
4885
5091
  type ListColumnPin = (typeof LIST_COLUMN_PINS)[number];
5092
+ type ListNarrowFacets = (typeof LIST_NARROW_FACETS)[number];
4886
5093
  type ListTableDensity = (typeof LIST_TABLE_DENSITIES)[number];
4887
5094
  type ListTableExportOptions = {
4888
5095
  xlsx: true;
4889
5096
  maxRows?: number; // Export is refused above this many rows.
4890
5097
  };
5098
+ type ListTableFrame = (typeof LIST_TABLE_FRAMES)[number];
4891
5099
  type ListTableGrouping = {
4892
5100
  field?: string; // Start grouping.
4893
5101
  collapsedWhen?: string | number | boolean | null; // Groups whose key equals this start collapsed and load no rows until opened.
@@ -4908,14 +5116,21 @@ type ListTableTotal = {
4908
5116
  type MetricSpec = {
4909
5117
  field: string;
4910
5118
  label: string;
5119
+ labelField?: string; // Record field of the detail query holding the label text, e.g. "Rent from 01.12."; it replaces the static `label` while it holds a non-empty string.
4911
5120
  navigate?: MetricNavigate;
5121
+ hideOnNarrow?: true; // Leaves the metric out below `sm`.
4912
5122
  tone?: DashboardStatTone; // Tile color as on dashboard stat panels; not applied while the value is 0.
5123
+ toneField?: string; // Record field of the detail query holding a SelectOptionTone; a valid value overrides `tone`, also at value 0.
5124
+ subField?: string; // Record field of the detail query shown as a small line under the value; the value stays the number.
5125
+ subFieldNarrow?: string; // Record field shown instead of `subField` below `sm` ("of 2,850 €" instead of "0 of 2,850.00 €").
4913
5126
  icon?: NavIconKey; // Icon chip of the tile; only drawn with `metricsStyle: "tiles"`.
4914
5127
  format?: FormatSpec; // Formats the displayed value (e.g. `date`, `enumOption`); the tone still resolves on the raw value.
4915
5128
  };
4916
5129
  type RecordHeaderSpec = {
4917
5130
  title: string;
5131
+ shortTitle?: string; // Field holding a short title for the desktop top bar ("Orders › SO-10482 ● processing"); the body keeps the full `title` as the h1.
4918
5132
  subtitle?: string | RecordHeaderSubtitlePart[]; // Field name, or several parts (field name or `{ field, navigate }`) joined by a separator; parts with an empty value are dropped.
5133
+ narrowSubtitle?: string; // Field holding a plain-text subtitle shown instead of `subtitle` below `sm` (e.g. "Main St 12, Berlin · 3 rooms").
4919
5134
  status?: string;
4920
5135
  statusFormat?: FormatSpec; // Formats the badge text (typically `enumOption` with a `keyPrefix`); tones still resolve on the raw value.
4921
5136
  subtitleHref?: string; // Record field holding an absolute http(s) URL.
@@ -4926,6 +5141,15 @@ type RecordHeaderSpec = {
4926
5141
  };
4927
5142
  ```
4928
5143
 
5144
+ ## packages/types/src/screen-record-guidance.ts
5145
+
5146
+ ```ts
5147
+ type RecordGuidanceAction = RowAction & { // A banner or step action.
5148
+ hideIcon?: true;
5149
+ narrowLabel?: string; // i18n key shown as the button label below `sm` (a shorter word, e.g. "Plan" for "Plan handover").
5150
+ };
5151
+ ```
5152
+
4929
5153
  ## packages/types/src/screen.ts
4930
5154
 
4931
5155
  ```ts