@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
@@ -0,0 +1,143 @@
1
+ import { normalizeListColumn } from "../screen-helpers.js";
2
+ import { bootRuleError } from "./boot-rule.js";
3
+ import { LIST_ROW_GUIDANCE_RULES } from "./list-row-guidance-rules.js";
4
+ import { NAMED_FILTER_RULES } from "./named-filter-rules.js";
5
+ import { listGuidanceFieldRefs } from "./query-output-guidance.js";
6
+ import { acceptsRowDecorationField } from "./row-decoration.js";
7
+ import { SCREEN_KIND_RULES } from "./screens-kind-rules.js";
8
+ import { buildUnknownFieldMessage } from "./screens-kind-shared.js";
9
+ // The hint cell draws the column itself; these options would be silently ignored.
10
+ const HINT_CONFLICTS = [
11
+ { option: "renderer", rule: LIST_ROW_GUIDANCE_RULES.hintColumnRenderer },
12
+ { option: "display", rule: LIST_ROW_GUIDANCE_RULES.hintColumnDisplay },
13
+ { option: "linkScreenField", rule: LIST_ROW_GUIDANCE_RULES.hintColumnLink },
14
+ { option: "linkParamsField", rule: LIST_ROW_GUIDANCE_RULES.hintColumnLink },
15
+ { option: "refEntity", rule: LIST_ROW_GUIDANCE_RULES.hintColumnLink },
16
+ { option: "badgeToneField", rule: LIST_ROW_GUIDANCE_RULES.hintColumnLink },
17
+ { option: "badgeDot", rule: LIST_ROW_GUIDANCE_RULES.hintColumnLink },
18
+ { option: "emptyPlaceholder", rule: LIST_ROW_GUIDANCE_RULES.hintColumnEmptyPlaceholder },
19
+ ];
20
+ function validateHintColumn(where, column) {
21
+ if (column.hint?.narrowDetailField !== undefined && column.hint.detailField === undefined) {
22
+ throw bootRuleError(LIST_ROW_GUIDANCE_RULES.narrowDetailFieldWithoutDetailField, {
23
+ message: `${where} column "${column.field}" sets hint.narrowDetailField without hint.detailField. Set detailField or remove narrowDetailField.`,
24
+ });
25
+ }
26
+ const { hint } = column;
27
+ if (hint !== undefined &&
28
+ hint.reasonField === undefined &&
29
+ (hint.reasonOpenField !== undefined || hint.reasonTitleField !== undefined)) {
30
+ throw bootRuleError(LIST_ROW_GUIDANCE_RULES.reasonOptionWithoutReasonField, {
31
+ message: `${where} column "${column.field}" sets hint.reasonOpenField or hint.reasonTitleField without hint.reasonField. Set reasonField or remove them.`,
32
+ });
33
+ }
34
+ const conflict = column.hint === undefined
35
+ ? undefined
36
+ : HINT_CONFLICTS.find(({ option }) => column[option] !== undefined);
37
+ if (conflict !== undefined) {
38
+ throw bootRuleError(conflict.rule, {
39
+ message: `${where} column "${column.field}" sets both hint and ${conflict.option} — the hint cell ` +
40
+ `draws the column itself. Remove ${conflict.option} or hint.`,
41
+ });
42
+ }
43
+ }
44
+ // hideOnNarrow and hidden: false are legal alongside showOnNarrowOnly; a pin always conflicts.
45
+ function narrowOnlyConflictOf(column) {
46
+ if (column.hideOnNarrow === true)
47
+ return "hideOnNarrow";
48
+ if (column.hidden === true)
49
+ return "hidden";
50
+ return column.pinned !== undefined ? "pinned" : undefined;
51
+ }
52
+ function validateNarrowOnlyColumn(where, column) {
53
+ // skip: the column shows in the table too
54
+ if (column.showOnNarrowOnly === undefined)
55
+ return;
56
+ const conflict = narrowOnlyConflictOf(column);
57
+ if (conflict !== undefined) {
58
+ throw bootRuleError(LIST_ROW_GUIDANCE_RULES.narrowOnlyConflict, {
59
+ message: `${where} column "${column.field}" sets showOnNarrowOnly together with ${conflict}. Remove one of them.`,
60
+ });
61
+ }
62
+ }
63
+ function validateButtonColumn(where, column, kind) {
64
+ if (column.display === "button" && kind !== "dashboard") {
65
+ throw bootRuleError(LIST_ROW_GUIDANCE_RULES.buttonColumnInListTable, {
66
+ message: `${where} column "${column.field}" sets display "button", which only dashboard list panels draw. ` +
67
+ `A row button in a list table is a rowAction with display "button".`,
68
+ });
69
+ }
70
+ const hasLink = column.linkScreenField !== undefined || column.refEntity !== undefined;
71
+ if (column.display === "button" && !hasLink) {
72
+ throw bootRuleError(LIST_ROW_GUIDANCE_RULES.buttonColumnWithoutLink, {
73
+ message: `${where} column "${column.field}" sets display "button" without linkScreenField or refEntity ` +
74
+ `— the button is the link. Set a link option or remove display.`,
75
+ });
76
+ }
77
+ }
78
+ function validateNamedFilterOptions(where, screen) {
79
+ if (screen.namedFilterFacet !== undefined && (screen.namedFilters ?? []).length === 0) {
80
+ throw bootRuleError(NAMED_FILTER_RULES.facetWithoutFilters, {
81
+ message: `${where} sets namedFilterFacet without namedFilters — there is nothing to present. Declare namedFilters or remove namedFilterFacet.`,
82
+ });
83
+ }
84
+ for (const ref of screen.namedFilters ?? []) {
85
+ const { emptyState } = ref;
86
+ if (emptyState === undefined)
87
+ continue;
88
+ if (emptyState.title.trim().length === 0) {
89
+ throw bootRuleError(NAMED_FILTER_RULES.emptyStateTitleEmpty, {
90
+ message: `${where} namedFilters "${ref.id}" sets emptyState with an empty title. Name the i18n key or remove emptyState.`,
91
+ });
92
+ }
93
+ if (emptyState.paramsQuery !== undefined && emptyState.paramsQuery.trim().length === 0) {
94
+ throw bootRuleError(NAMED_FILTER_RULES.emptyStateParamsQueryEmpty, {
95
+ message: `${where} namedFilters "${ref.id}" sets emptyState.paramsQuery to an empty string. Name the query or remove paramsQuery.`,
96
+ });
97
+ }
98
+ if (emptyState.paramsQuery !== undefined && emptyState.description === undefined) {
99
+ throw bootRuleError(NAMED_FILTER_RULES.emptyStateParamsQueryWithoutDescription, {
100
+ message: `${where} namedFilters "${ref.id}" sets emptyState.paramsQuery without a description — the params only feed the description. Set description or remove paramsQuery.`,
101
+ });
102
+ }
103
+ }
104
+ }
105
+ function guidanceLocation(featureName, screenId, kind, partLabel) {
106
+ if (kind === "dashboard") {
107
+ return `[Feature ${featureName}] Screen "${screenId}" (dashboard) list-panel "${partLabel}"`;
108
+ }
109
+ if (kind === "relatedList")
110
+ return `[Feature ${featureName}] ${partLabel}`;
111
+ return `[Feature ${featureName}] Screen "${screenId}" (${kind})`;
112
+ }
113
+ export function validateListRowGuidance(featureName, screenId, kind, screen, entityFields,
114
+ // dashboard: the list-panel id; relatedList: the section's full location text
115
+ partLabel) {
116
+ const where = guidanceLocation(featureName, screenId, kind, partLabel ?? "");
117
+ if (screen.rowDecoration !== undefined && screen.rowDecoration.query.trim().length === 0) {
118
+ throw bootRuleError(LIST_ROW_GUIDANCE_RULES.rowDecorationQueryEmpty, {
119
+ message: `${where} sets rowDecoration.query to an empty string. Name the decoration query or remove rowDecoration.`,
120
+ });
121
+ }
122
+ for (const col of screen.columns) {
123
+ const column = normalizeListColumn(col);
124
+ validateHintColumn(where, column);
125
+ validateNarrowOnlyColumn(where, column);
126
+ validateButtonColumn(where, column, kind);
127
+ }
128
+ validateNamedFilterOptions(where, screen);
129
+ for (const { option, field } of listGuidanceFieldRefs(screen)) {
130
+ if (field.trim().length === 0) {
131
+ throw bootRuleError(LIST_ROW_GUIDANCE_RULES.guidanceFieldEmpty, {
132
+ message: `${where} sets ${option} to an empty string. Name a row field or remove the option.`,
133
+ });
134
+ }
135
+ if (entityFields !== undefined &&
136
+ !entityFields.fieldNames.has(field) &&
137
+ !acceptsRowDecorationField(entityFields.rowDecorationFields, field)) {
138
+ throw bootRuleError(SCREEN_KIND_RULES.unknownFieldReference, {
139
+ message: buildUnknownFieldMessage(featureName, screenId, field, entityFields.entityName, entityFields.fieldNames),
140
+ });
141
+ }
142
+ }
143
+ }
@@ -0,0 +1,42 @@
1
+ export declare const LIST_SORT_SUMMARY_RULES: {
2
+ readonly sortOptionNotSortable: {
3
+ readonly id: "list/sort-option-not-sortable";
4
+ readonly summary: "Every sortOptions field is a listed, sortable column (entityList); a projectionList's query takes sort and sortDirection and, when they are enums, lists every option field and dir.";
5
+ readonly fix: "Mark the field sortable and list it as a column, or give the projectionList's query sort and sortDirection parameters that accept the option fields.";
6
+ };
7
+ readonly sortOptionsInvalid: {
8
+ readonly id: "list/sort-options-invalid";
9
+ readonly summary: "sortOptions is not empty and lists each field and dir once.";
10
+ readonly fix: "Remove sortOptions, or list each field and dir pair once.";
11
+ };
12
+ readonly sortOptionsDefaultNotListed: {
13
+ readonly id: "list/sort-options-default-not-listed";
14
+ readonly summary: "A defaultSort is one of the sortOptions, so the select opens on an entry.";
15
+ readonly fix: "Add the defaultSort field and dir to sortOptions or change defaultSort.";
16
+ };
17
+ readonly summaryRowShape: {
18
+ readonly id: "list/summary-row-shape";
19
+ readonly summary: "table.summaryRow is an object with a query string and optional params object.";
20
+ readonly fix: 'Write table.summaryRow as { query: "feature:query:order:summary" }.';
21
+ };
22
+ readonly summaryRowQueryUnknown: {
23
+ readonly id: "list/summary-row-query-unknown";
24
+ readonly summary: "table.summaryRow.query names a registered query handler.";
25
+ readonly fix: "Use the qualified name of a query handler (feature:query:name) or remove summaryRow.";
26
+ };
27
+ readonly summaryRowQueryAcceptsListKeys: {
28
+ readonly id: "list/summary-row-query-accepts-list-keys";
29
+ readonly summary: "The summaryRow query's Zod schema accepts every list key the screen sends (search, namedFilter, filters) and every summaryRow.params key.";
30
+ readonly fix: "Add the missing keys to the query schema (or reuse the list query's filter shape) and apply them, or drop the feature on the screen.";
31
+ };
32
+ readonly summaryRowWithTotals: {
33
+ readonly id: "list/summary-row-with-totals";
34
+ readonly summary: "A table sets summaryRow or totals, not both; two footers under one table read as two answers.";
35
+ readonly fix: "Drop totals and put the figures into the summary query, or drop summaryRow.";
36
+ };
37
+ readonly summaryRowOnRelatedList: {
38
+ readonly id: "list/summary-row-on-related-list";
39
+ readonly summary: "A relatedList section or expandableRow sets no table.summaryRow; only entityList and projectionList screens have a list payload to carry it.";
40
+ readonly fix: "Remove summaryRow from the relatedList, or put the summary on the list screen itself.";
41
+ };
42
+ };
@@ -0,0 +1,42 @@
1
+ export const LIST_SORT_SUMMARY_RULES = {
2
+ sortOptionNotSortable: {
3
+ id: "list/sort-option-not-sortable",
4
+ summary: "Every sortOptions field is a listed, sortable column (entityList); a projectionList's query takes sort and sortDirection and, when they are enums, lists every option field and dir.",
5
+ fix: "Mark the field sortable and list it as a column, or give the projectionList's query sort and sortDirection parameters that accept the option fields.",
6
+ },
7
+ sortOptionsInvalid: {
8
+ id: "list/sort-options-invalid",
9
+ summary: "sortOptions is not empty and lists each field and dir once.",
10
+ fix: "Remove sortOptions, or list each field and dir pair once.",
11
+ },
12
+ sortOptionsDefaultNotListed: {
13
+ id: "list/sort-options-default-not-listed",
14
+ summary: "A defaultSort is one of the sortOptions, so the select opens on an entry.",
15
+ fix: "Add the defaultSort field and dir to sortOptions or change defaultSort.",
16
+ },
17
+ summaryRowShape: {
18
+ id: "list/summary-row-shape",
19
+ summary: "table.summaryRow is an object with a query string and optional params object.",
20
+ fix: 'Write table.summaryRow as { query: "feature:query:order:summary" }.',
21
+ },
22
+ summaryRowQueryUnknown: {
23
+ id: "list/summary-row-query-unknown",
24
+ summary: "table.summaryRow.query names a registered query handler.",
25
+ fix: "Use the qualified name of a query handler (feature:query:name) or remove summaryRow.",
26
+ },
27
+ summaryRowQueryAcceptsListKeys: {
28
+ id: "list/summary-row-query-accepts-list-keys",
29
+ summary: "The summaryRow query's Zod schema accepts every list key the screen sends (search, namedFilter, filters) and every summaryRow.params key.",
30
+ fix: "Add the missing keys to the query schema (or reuse the list query's filter shape) and apply them, or drop the feature on the screen.",
31
+ },
32
+ summaryRowWithTotals: {
33
+ id: "list/summary-row-with-totals",
34
+ summary: "A table sets summaryRow or totals, not both; two footers under one table read as two answers.",
35
+ fix: "Drop totals and put the figures into the summary query, or drop summaryRow.",
36
+ },
37
+ summaryRowOnRelatedList: {
38
+ id: "list/summary-row-on-related-list",
39
+ summary: "A relatedList section or expandableRow sets no table.summaryRow; only entityList and projectionList screens have a list payload to carry it.",
40
+ fix: "Remove summaryRow from the relatedList, or put the summary on the list screen itself.",
41
+ },
42
+ };
@@ -0,0 +1,5 @@
1
+ import type { FeatureDefinition } from "../types/index.ts";
2
+ export declare function validateSummaryRowShape(where: string, summaryRow: unknown): void;
3
+ /** `where` is the full message prefix, as for validateListTableOptions. */
4
+ export declare function rejectSummaryRowOnRelatedList(where: string, table: unknown): void;
5
+ export declare function validateListSortAndSummary(features: readonly FeatureDefinition[]): void;
@@ -0,0 +1,160 @@
1
+ import { entityListDeclaresFilters, entityListDeclaresSearch, listPayloadKeysSent, } from "@cosmicdrift/kumiko-types/screen";
2
+ import { isPlainObject } from "@cosmicdrift/kumiko-types/type-guards";
3
+ import { LIST_TABLE_SUMMARY_ROW_KEYS } from "../types/screen.js";
4
+ import { bootRuleError } from "./boot-rule.js";
5
+ import { LIST_SORT_SUMMARY_RULES } from "./list-sort-summary-rules.js";
6
+ import { rejectUnknownKeys } from "./list-table-reject-unknown-keys.js";
7
+ import { buildQueryHandlerMap, schemaAccepts } from "./projection-list-screens.js";
8
+ import { getZodObjectShape, getZodStringLiterals } from "./zod-shape.js";
9
+ export function validateSummaryRowShape(where, summaryRow) {
10
+ if (!isPlainObject(summaryRow)) {
11
+ throw bootRuleError(LIST_SORT_SUMMARY_RULES.summaryRowShape, {
12
+ message: `${where} table.summaryRow must be an object like { query: "feature:query:order:summary" }.`,
13
+ });
14
+ }
15
+ rejectUnknownKeys(where, "table.summaryRow", summaryRow, LIST_TABLE_SUMMARY_ROW_KEYS);
16
+ if (typeof summaryRow["query"] !== "string" || summaryRow["query"] === "") {
17
+ throw bootRuleError(LIST_SORT_SUMMARY_RULES.summaryRowShape, {
18
+ message: `${where} table.summaryRow.query must be a qualified query name.`,
19
+ });
20
+ }
21
+ if (summaryRow["params"] !== undefined && !isPlainObject(summaryRow["params"])) {
22
+ throw bootRuleError(LIST_SORT_SUMMARY_RULES.summaryRowShape, {
23
+ message: `${where} table.summaryRow.params must be an object.`,
24
+ });
25
+ }
26
+ }
27
+ /** `where` is the full message prefix, as for validateListTableOptions. */
28
+ export function rejectSummaryRowOnRelatedList(where, table) {
29
+ if (isPlainObject(table) && table["summaryRow"] !== undefined) {
30
+ throw bootRuleError(LIST_SORT_SUMMARY_RULES.summaryRowOnRelatedList, {
31
+ message: `${where} sets table.summaryRow, but a relatedList has no list payload to carry it. Remove it or summarise on the list screen.`,
32
+ });
33
+ }
34
+ }
35
+ function entityListCapabilities(feature, screen) {
36
+ const entity = feature.entities?.[screen.entity];
37
+ return {
38
+ searchable: entityListDeclaresSearch(screen, entity),
39
+ filters: entityListDeclaresFilters(screen, entity),
40
+ };
41
+ }
42
+ function projectionListCapabilities(screen, queryHandlers) {
43
+ const listSchema = queryHandlers.get(screen.query)?.schema;
44
+ return {
45
+ searchable: screen.searchable !== false && schemaAccepts(listSchema, "search"),
46
+ filters: screen.facets !== undefined,
47
+ };
48
+ }
49
+ // The keys the list sends for what the screen declares (mirrors the renderer); the summary query
50
+ // gets the same ones so its numbers follow the narrowing the user sees.
51
+ function listKeysSentBy(feature, screen, queryHandlers) {
52
+ const derived = screen.type === "entityList"
53
+ ? entityListCapabilities(feature, screen)
54
+ : projectionListCapabilities(screen, queryHandlers);
55
+ return listPayloadKeysSent({
56
+ ...derived,
57
+ namedFilters: screen.namedFilters !== undefined,
58
+ screenFilter: screen.filter !== undefined,
59
+ });
60
+ }
61
+ function validateSummaryRowQuery(prefix, feature, screen, summaryRow, queryHandlers) {
62
+ const handler = queryHandlers.get(summaryRow.query);
63
+ if (handler === undefined) {
64
+ throw bootRuleError(LIST_SORT_SUMMARY_RULES.summaryRowQueryUnknown, {
65
+ message: `${prefix}: table.summaryRow.query "${summaryRow.query}" is not a registered query handler.`,
66
+ });
67
+ }
68
+ const shape = getZodObjectShape(handler.schema);
69
+ const paramKeys = Object.keys(summaryRow.params ?? {});
70
+ const missing = [...listKeysSentBy(feature, screen, queryHandlers), ...paramKeys].filter((key) => shape === undefined || !(key in shape));
71
+ if (missing.length === 0)
72
+ return;
73
+ throw bootRuleError(LIST_SORT_SUMMARY_RULES.summaryRowQueryAcceptsListKeys, {
74
+ message: `${prefix}: table.summaryRow.query "${summaryRow.query}" must accept ${missing.map((key) => `"${key}"`).join(", ")} ` +
75
+ `in its Zod schema because the list sends them - add them to the schema or drop them from the screen.`,
76
+ });
77
+ }
78
+ // The query is the only thing that can order a projection; without sort and sortDirection in its schema
79
+ // every pick from the select would 422.
80
+ function validateProjectionSortOptions(prefix, screen, queryHandlers) {
81
+ const options = screen.sortOptions ?? [];
82
+ // skip: no sortOptions declared
83
+ if (options.length === 0)
84
+ return;
85
+ const shape = getZodObjectShape(queryHandlers.get(screen.query)?.schema);
86
+ if (shape === undefined || !("sort" in shape) || !("sortDirection" in shape)) {
87
+ throw bootRuleError(LIST_SORT_SUMMARY_RULES.sortOptionNotSortable, {
88
+ message: `${prefix}: sortOptions need query "${screen.query}" to accept "sort" and "sortDirection" ` +
89
+ `in its Zod schema - add them and order by them, or remove sortOptions.`,
90
+ });
91
+ }
92
+ // A closed enum of sortable fields is the one case where the schema can be checked per option.
93
+ const accepted = getZodStringLiterals(shape["sort"]);
94
+ // skip: "sort" is an open string, nothing to compare the options against
95
+ if (accepted === undefined)
96
+ return;
97
+ const rejected = options.find((option) => !accepted.includes(option.field));
98
+ if (rejected !== undefined) {
99
+ throw bootRuleError(LIST_SORT_SUMMARY_RULES.sortOptionNotSortable, {
100
+ message: `${prefix}: sortOptions field "${rejected.field}" is not one of the values query "${screen.query}" ` +
101
+ `accepts for "sort" (${accepted.join(", ")}) - every pick would fail with a 422.`,
102
+ });
103
+ }
104
+ const acceptedDirections = getZodStringLiterals(shape["sortDirection"]);
105
+ // skip: "sortDirection" is an open string
106
+ if (acceptedDirections === undefined)
107
+ return;
108
+ const rejectedDirection = options.find((option) => !acceptedDirections.includes(option.dir));
109
+ if (rejectedDirection !== undefined) {
110
+ throw bootRuleError(LIST_SORT_SUMMARY_RULES.sortOptionNotSortable, {
111
+ message: `${prefix}: sortOptions dir "${rejectedDirection.dir}" is not one of the values query "${screen.query}" ` +
112
+ `accepts for "sortDirection" (${acceptedDirections.join(", ")}) - every pick would fail with a 422.`,
113
+ });
114
+ }
115
+ }
116
+ function validateSortOptionsList(prefix, screen) {
117
+ const options = screen.sortOptions;
118
+ // skip: no sortOptions declared
119
+ if (options === undefined)
120
+ return;
121
+ if (options.length === 0) {
122
+ throw bootRuleError(LIST_SORT_SUMMARY_RULES.sortOptionsInvalid, {
123
+ message: `${prefix}: sortOptions is empty - list at least one option or remove sortOptions.`,
124
+ });
125
+ }
126
+ const seen = new Set();
127
+ for (const option of options) {
128
+ const key = `${option.field}\u0000${option.dir}`;
129
+ if (seen.has(key)) {
130
+ throw bootRuleError(LIST_SORT_SUMMARY_RULES.sortOptionsInvalid, {
131
+ message: `${prefix}: sortOptions lists field "${option.field}" with dir "${option.dir}" twice.`,
132
+ });
133
+ }
134
+ seen.add(key);
135
+ }
136
+ const defaultSort = screen.defaultSort;
137
+ if (defaultSort !== undefined &&
138
+ !options.some((o) => o.field === defaultSort.field && o.dir === defaultSort.dir)) {
139
+ throw bootRuleError(LIST_SORT_SUMMARY_RULES.sortOptionsDefaultNotListed, {
140
+ message: `${prefix}: defaultSort { field: "${defaultSort.field}", dir: "${defaultSort.dir}" } is not one of the sortOptions, so the select would open on no entry. Add it to sortOptions.`,
141
+ });
142
+ }
143
+ }
144
+ export function validateListSortAndSummary(features) {
145
+ const queryHandlers = buildQueryHandlerMap(features);
146
+ for (const feature of features) {
147
+ for (const screen of Object.values(feature.screens)) {
148
+ if (screen.type !== "entityList" && screen.type !== "projectionList")
149
+ continue;
150
+ const prefix = `[${screen.type}] Feature "${feature.name}" screen "${screen.id}"`;
151
+ validateSortOptionsList(prefix, screen);
152
+ if (screen.type === "projectionList") {
153
+ validateProjectionSortOptions(prefix, screen, queryHandlers);
154
+ }
155
+ if (screen.table?.summaryRow !== undefined) {
156
+ validateSummaryRowQuery(prefix, feature, screen, screen.table.summaryRow, queryHandlers);
157
+ }
158
+ }
159
+ }
160
+ }
@@ -1,8 +1,10 @@
1
1
  import { isOneOf, isPlainObject } from "@cosmicdrift/kumiko-types/type-guards";
2
2
  import { normalizeListColumn } from "../screen-helpers.js";
3
- import { LIST_TABLE_DENSITIES, LIST_TABLE_DENSITY_KEYS, LIST_TABLE_OPTION_KEYS, } from "../types/screen.js";
3
+ import { LIST_TABLE_DENSITIES, LIST_TABLE_DENSITY_KEYS, LIST_TABLE_FRAMES, LIST_TABLE_OPTION_KEYS, } from "../types/screen.js";
4
4
  import { bootRuleError } from "./boot-rule.js";
5
5
  import { validateColumnLayout } from "./list-column-layout.js";
6
+ import { validateSummaryRowShape } from "./list-sort-summary.js";
7
+ import { LIST_SORT_SUMMARY_RULES } from "./list-sort-summary-rules.js";
6
8
  import { validateListTableAggregateShape } from "./list-table-aggregate-options.js";
7
9
  import { validateExportOptions } from "./list-table-export-options.js";
8
10
  import { rejectUnknownKeys } from "./list-table-reject-unknown-keys.js";
@@ -88,11 +90,23 @@ export function validateListTableOptions(where, table, columns, exportAllowed =
88
90
  });
89
91
  }
90
92
  }
93
+ if (table["frame"] !== undefined && !isOneOf(LIST_TABLE_FRAMES, table["frame"])) {
94
+ throw bootRuleError(LIST_TABLE_RULES.frameInvalid, {
95
+ message: `${where} table.frame is ${JSON.stringify(table["frame"])} — must be one of ${LIST_TABLE_FRAMES.map((f) => `"${f}"`).join(", ")}.`,
96
+ });
97
+ }
91
98
  if (table["density"] !== undefined)
92
99
  validateDensity(where, table["density"]);
93
100
  if (table["export"] !== undefined)
94
101
  validateExportOptions(where, table["export"], exportAllowed);
95
102
  validateListTableAggregateShape(where, table, columns);
103
+ if (table["summaryRow"] !== undefined)
104
+ validateSummaryRowShape(where, table["summaryRow"]);
105
+ if (table["summaryRow"] !== undefined && table["totals"] !== undefined) {
106
+ throw bootRuleError(LIST_SORT_SUMMARY_RULES.summaryRowWithTotals, {
107
+ message: `${where} sets table.summaryRow and table.totals; a table has one footer. Keep one of them.`,
108
+ });
109
+ }
96
110
  validateHiddenColumns(where, table["columnPicker"] === true, columns);
97
111
  validateColumnLayout(where, { pinning: table["pinning"] === true, resizing: table["resizing"] === true }, columns);
98
112
  }
@@ -14,6 +14,11 @@ export declare const LIST_TABLE_RULES: {
14
14
  readonly summary: "The boolean table switches (rememberState, columnPicker, pinning, ...) are booleans.";
15
15
  readonly fix: "Set the table option to true or false.";
16
16
  };
17
+ readonly frameInvalid: {
18
+ readonly id: "list-table/frame-invalid";
19
+ readonly summary: "table.frame is one of the known frames.";
20
+ readonly fix: 'Use "card" or remove table.frame.';
21
+ };
17
22
  readonly densityNotObject: {
18
23
  readonly id: "list-table/density-not-object";
19
24
  readonly summary: "table.density is an object.";
@@ -86,12 +91,12 @@ export declare const LIST_TABLE_RULES: {
86
91
  };
87
92
  readonly columnWidthInvalid: {
88
93
  readonly id: "list-table/column-width-invalid";
89
- readonly summary: "A column's width and minWidth are finite pixel counts greater than 0.";
90
- readonly fix: "Set a positive finite number or remove the option.";
94
+ readonly summary: "A column's width and minWidth are finite pixel counts greater than 0 and at most 2000.";
95
+ readonly fix: "Set a positive finite number up to 2000 or remove the option.";
91
96
  };
92
97
  readonly columnWidthWithoutResizing: {
93
98
  readonly id: "list-table/column-width-without-resizing";
94
- readonly summary: "A column's width or minWidth needs table.resizing, otherwise it has no effect.";
99
+ readonly summary: "A column's width or minWidth needs table.resizing, otherwise it has no effect; a hint column is exempt.";
95
100
  readonly fix: "Set table: { resizing: true } or remove width and minWidth from the column.";
96
101
  };
97
102
  readonly columnMinWidthExceedsWidth: {
@@ -116,8 +121,8 @@ export declare const LIST_TABLE_RULES: {
116
121
  };
117
122
  readonly bundledListsScreenOnlyKey: {
118
123
  readonly id: "bundled-lists/screen-only-table-key";
119
- readonly summary: "bundledLists.table leaves out grouping and totals, which depend on one list's fields.";
120
- readonly fix: "Set grouping and totals in the table block of the individual screen.";
124
+ readonly summary: "bundledLists.table leaves out grouping, totals and summaryRow, which depend on one list's fields or query.";
125
+ readonly fix: "Set grouping, totals and summaryRow in the table block of the individual screen.";
121
126
  };
122
127
  readonly bundledListsPinFirstColumnNotBoolean: {
123
128
  readonly id: "bundled-lists/pin-first-column-not-boolean";
@@ -14,6 +14,11 @@ export const LIST_TABLE_RULES = {
14
14
  summary: "The boolean table switches (rememberState, columnPicker, pinning, ...) are booleans.",
15
15
  fix: "Set the table option to true or false.",
16
16
  },
17
+ frameInvalid: {
18
+ id: "list-table/frame-invalid",
19
+ summary: "table.frame is one of the known frames.",
20
+ fix: 'Use "card" or remove table.frame.',
21
+ },
17
22
  densityNotObject: {
18
23
  id: "list-table/density-not-object",
19
24
  summary: "table.density is an object.",
@@ -86,12 +91,12 @@ export const LIST_TABLE_RULES = {
86
91
  },
87
92
  columnWidthInvalid: {
88
93
  id: "list-table/column-width-invalid",
89
- summary: "A column's width and minWidth are finite pixel counts greater than 0.",
90
- fix: "Set a positive finite number or remove the option.",
94
+ summary: "A column's width and minWidth are finite pixel counts greater than 0 and at most 2000.",
95
+ fix: "Set a positive finite number up to 2000 or remove the option.",
91
96
  },
92
97
  columnWidthWithoutResizing: {
93
98
  id: "list-table/column-width-without-resizing",
94
- summary: "A column's width or minWidth needs table.resizing, otherwise it has no effect.",
99
+ summary: "A column's width or minWidth needs table.resizing, otherwise it has no effect; a hint column is exempt.",
95
100
  fix: "Set table: { resizing: true } or remove width and minWidth from the column.",
96
101
  },
97
102
  columnMinWidthExceedsWidth: {
@@ -116,8 +121,8 @@ export const LIST_TABLE_RULES = {
116
121
  },
117
122
  bundledListsScreenOnlyKey: {
118
123
  id: "bundled-lists/screen-only-table-key",
119
- summary: "bundledLists.table leaves out grouping and totals, which depend on one list's fields.",
120
- fix: "Set grouping and totals in the table block of the individual screen.",
124
+ summary: "bundledLists.table leaves out grouping, totals and summaryRow, which depend on one list's fields or query.",
125
+ fix: "Set grouping, totals and summaryRow in the table block of the individual screen.",
121
126
  },
122
127
  bundledListsPinFirstColumnNotBoolean: {
123
128
  id: "bundled-lists/pin-first-column-not-boolean",
@@ -0,0 +1,10 @@
1
+ type ListToolbarOptionScreen = {
2
+ readonly toolbarSort?: true;
3
+ readonly narrowFacets?: unknown;
4
+ readonly sortOptions?: readonly unknown[];
5
+ readonly toolbarActionsPlacement?: unknown;
6
+ readonly toolbarActions?: readonly unknown[];
7
+ };
8
+ /** Toolbar options shared by entityList and projectionList. */
9
+ export declare function validateListToolbarOptions(where: string, screen: ListToolbarOptionScreen): void;
10
+ export {};
@@ -0,0 +1,30 @@
1
+ import { LIST_NARROW_FACETS, LIST_TOOLBAR_ACTIONS_PLACEMENTS, } from "@cosmicdrift/kumiko-types/screen";
2
+ import { isOneOf } from "@cosmicdrift/kumiko-types/type-guards";
3
+ import { bootRuleError } from "./boot-rule.js";
4
+ import { SCREEN_KIND_RULES } from "./screens-kind-rules.js";
5
+ /** Toolbar options shared by entityList and projectionList. */
6
+ export function validateListToolbarOptions(where, screen) {
7
+ if (screen.toolbarSort === true && (screen.sortOptions ?? []).length === 0) {
8
+ throw bootRuleError(SCREEN_KIND_RULES.toolbarSortWithoutSortOptions, {
9
+ message: `${where} sets toolbarSort without sortOptions — the select lists the sortOptions. Declare sortOptions or remove toolbarSort.`,
10
+ });
11
+ }
12
+ if (screen.narrowFacets !== undefined && !isOneOf(LIST_NARROW_FACETS, screen.narrowFacets)) {
13
+ throw bootRuleError(SCREEN_KIND_RULES.narrowFacetsInvalid, {
14
+ message: `${where} sets narrowFacets ${JSON.stringify(screen.narrowFacets)} — must be "pills".`,
15
+ });
16
+ }
17
+ const placement = screen.toolbarActionsPlacement;
18
+ if (placement === undefined)
19
+ return;
20
+ if (!isOneOf(LIST_TOOLBAR_ACTIONS_PLACEMENTS, placement)) {
21
+ throw bootRuleError(SCREEN_KIND_RULES.toolbarActionsPlacementInvalid, {
22
+ message: `${where} sets toolbarActionsPlacement ${JSON.stringify(placement)} — must be ${LIST_TOOLBAR_ACTIONS_PLACEMENTS.map((p) => `"${p}"`).join(" or ")}.`,
23
+ });
24
+ }
25
+ if (placement === "toolbar" && (screen.toolbarActions ?? []).length === 0) {
26
+ throw bootRuleError(SCREEN_KIND_RULES.toolbarActionsPlacementWithoutActions, {
27
+ message: `${where} sets toolbarActionsPlacement "toolbar" without toolbarActions — there is nothing to place. Declare toolbarActions or remove toolbarActionsPlacement.`,
28
+ });
29
+ }
30
+ }
@@ -4,10 +4,50 @@ export declare const NAMED_FILTER_RULES: {
4
4
  readonly summary: "A projectionList with namedFilters binds a query whose schema has a namedFilter key.";
5
5
  readonly fix: "Add namedFilter: z.string().optional() to the query schema, resolve it with resolveNamedListFilters and pass the conditions into executor.list filters, the only path that applies field-read and PII guards.";
6
6
  };
7
+ readonly projectionQueryAcceptsCount: {
8
+ readonly id: "named-filter/projection-query-accepts-count";
9
+ readonly summary: "A projectionList with namedFilterFacet.showCounts binds a query whose schema has limit and totalCount keys.";
10
+ readonly fix: "Add limit and totalCount: z.boolean().optional() to the query schema and return the total, or drop showCounts.";
11
+ };
12
+ readonly projectionQueryAcceptsSort: {
13
+ readonly id: "named-filter/projection-query-accepts-sort";
14
+ readonly summary: "A projectionList whose namedFilter sets a sort binds a query whose schema has sort and sortDirection keys.";
15
+ readonly fix: "Add sort: z.enum([...sortable fields]) and sortDirection to the query schema and order by them, or remove sort from the named filter.";
16
+ };
17
+ readonly filterSortNotListed: {
18
+ readonly id: "list/named-filter-sort-not-listed";
19
+ readonly summary: "A named filter's sort.field is one of the listed columns.";
20
+ readonly fix: "Pick a field from columns or add it there.";
21
+ };
22
+ readonly filterSortNotSortable: {
23
+ readonly id: "list/named-filter-sort-not-sortable";
24
+ readonly summary: "A named filter's sort column is sortable.";
25
+ readonly fix: "Mark the field sortable or pick another sort field.";
26
+ };
27
+ readonly facetWithoutFilters: {
28
+ readonly id: "list/named-filter-facet-without-filters";
29
+ readonly summary: "namedFilterFacet only presents the screen's namedFilters.";
30
+ readonly fix: "Declare namedFilters on the screen or remove namedFilterFacet.";
31
+ };
32
+ readonly emptyStateTitleEmpty: {
33
+ readonly id: "list/named-filter-empty-state-title-empty";
34
+ readonly summary: "A named filter's emptyState.title is a non-empty i18n key.";
35
+ readonly fix: "Name the title key or remove emptyState from the filter.";
36
+ };
37
+ readonly emptyStateParamsQueryEmpty: {
38
+ readonly id: "list/named-filter-empty-state-params-query-empty";
39
+ readonly summary: "A named filter's emptyState.paramsQuery is a non-empty query QN.";
40
+ readonly fix: "Name the query or remove paramsQuery from the emptyState.";
41
+ };
42
+ readonly emptyStateParamsQueryWithoutDescription: {
43
+ readonly id: "list/named-filter-empty-state-params-query-without-description";
44
+ readonly summary: "A named filter's emptyState.paramsQuery feeds the description, so it needs one.";
45
+ readonly fix: "Set emptyState.description (an i18n key with {params}) or remove paramsQuery.";
46
+ };
7
47
  readonly statNavigateTarget: {
8
48
  readonly id: "named-filter/stat-navigate-target";
9
- readonly summary: "A stat navigate.screen resolves to an entityList or projectionList screen.";
10
- readonly fix: "Point navigate.screen at a registered list screen.";
49
+ readonly summary: "A stat navigate.screen resolves to an entityList, projectionList or custom screen.";
50
+ readonly fix: "Point navigate.screen at a registered list or custom screen.";
11
51
  };
12
52
  readonly statNavigateFilterDeclared: {
13
53
  readonly id: "named-filter/stat-navigate-filter-declared";