@cosmicdrift/kumiko-framework 0.413.1 → 0.414.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (463) hide show
  1. package/AGENTS.md +5 -2
  2. package/agents/api/framework-db.md +14 -3
  3. package/agents/api/framework-engine.md +63 -13
  4. package/agents/api/framework-event-store.md +14 -0
  5. package/agents/api/framework-ui-types.md +149 -21
  6. package/agents/api/renderer-web.md +93 -9
  7. package/agents/api/testing-helpers.md +3 -2
  8. package/agents/api/testing-stack.md +3 -0
  9. package/agents/api/types.md +205 -14
  10. package/agents/api.md +7 -7
  11. package/agents/boot-rules.md +63 -9
  12. package/agents/examples/api-docs.md +2 -6
  13. package/agents/examples/auth-mfa.md +57 -10
  14. package/agents/examples/chat-channels.md +2 -0
  15. package/agents/examples/currencies-global.md +1 -0
  16. package/agents/examples/env-composition.md +7 -11
  17. package/agents/examples/managed-pages.md +90 -1
  18. package/agents/examples/pwa-shell.md +210 -0
  19. package/agents/examples/rate-limiting.md +3 -3
  20. package/agents/examples/record-detail-layout.md +1537 -67
  21. package/agents/examples/workflow-engine.md +16 -12
  22. package/agents/examples.md +1 -0
  23. package/agents/features-index.md +4 -2
  24. package/agents/features.md +22 -7
  25. package/agents/widgets.md +19 -1
  26. package/dist/api/api-constants.d.ts +1 -0
  27. package/dist/api/api-constants.js +4 -0
  28. package/dist/api/auth-middleware.js +4 -3
  29. package/dist/api/auth-routes-shared.js +2 -1
  30. package/dist/api/entity-read-access.d.ts +1 -0
  31. package/dist/api/entity-read-access.js +18 -0
  32. package/dist/api/export/export-route.d.ts +6 -1
  33. package/dist/api/export/export-route.js +27 -1
  34. package/dist/api/export/export-rows.js +19 -3
  35. package/dist/api/routes.d.ts +2 -0
  36. package/dist/api/routes.js +9 -1
  37. package/dist/api/server-extra-routes.js +2 -1
  38. package/dist/api/server-feature-http-routes.d.ts +9 -0
  39. package/dist/api/server-feature-http-routes.js +109 -0
  40. package/dist/api/server-middleware.js +2 -19
  41. package/dist/api/server-pat-rate-limit-guard.d.ts +3 -0
  42. package/dist/api/server-pat-rate-limit-guard.js +19 -0
  43. package/dist/api/server-rate-limit-wiring.d.ts +10 -0
  44. package/dist/api/server-rate-limit-wiring.js +37 -0
  45. package/dist/api/server-routes.d.ts +4 -12
  46. package/dist/api/server-routes.js +12 -171
  47. package/dist/api/server-schema-route.d.ts +3 -0
  48. package/dist/api/server-schema-route.js +58 -0
  49. package/dist/api/server-wiring.js +2 -37
  50. package/dist/api/server.js +3 -1
  51. package/dist/compliance/override-schema.js +5 -5
  52. package/dist/compliance/sub-processors.js +10 -1
  53. package/dist/crypto/index.d.ts +1 -1
  54. package/dist/crypto/index.js +1 -1
  55. package/dist/crypto/pii-field-encryption.d.ts +2 -0
  56. package/dist/crypto/pii-field-encryption.js +16 -1
  57. package/dist/db/apply-entity-event.js +4 -0
  58. package/dist/db/bun-sql-connection-codes.d.ts +1 -0
  59. package/dist/db/bun-sql-connection-codes.js +7 -0
  60. package/dist/db/collect-table-metas.js +4 -1
  61. package/dist/db/config-seed.js +1 -1
  62. package/dist/db/derived-field-sql.js +15 -13
  63. package/dist/db/derived-related-sql.d.ts +2 -2
  64. package/dist/db/derived-related-sql.js +4 -2
  65. package/dist/db/dialect.d.ts +3 -0
  66. package/dist/db/dialect.js +1 -3
  67. package/dist/db/driver-row-coercion.js +2 -2
  68. package/dist/db/driver-value-preparation.js +1 -1
  69. package/dist/db/eagerload.js +15 -12
  70. package/dist/db/entity-table-meta.d.ts +2 -0
  71. package/dist/db/entity-table-meta.js +7 -0
  72. package/dist/db/event-store-executor-context.js +13 -8
  73. package/dist/db/event-store-executor-read-aggregate-currencies.js +2 -2
  74. package/dist/db/event-store-executor-read-aggregate.js +2 -2
  75. package/dist/db/event-store-executor-read-filter.d.ts +4 -0
  76. package/dist/db/event-store-executor-read-filter.js +28 -11
  77. package/dist/db/event-store-executor-read-search.d.ts +1 -0
  78. package/dist/db/event-store-executor-read-search.js +6 -6
  79. package/dist/db/event-store-executor-read-sort.js +3 -3
  80. package/dist/db/event-store-executor-read-where.js +14 -5
  81. package/dist/db/event-store-executor-read.js +7 -7
  82. package/dist/db/event-store-executor-write.js +50 -95
  83. package/dist/db/executor-managed-tables.js +4 -1
  84. package/dist/db/index.d.ts +4 -2
  85. package/dist/db/index.js +4 -2
  86. package/dist/db/known-table-names.d.ts +1 -0
  87. package/dist/db/known-table-names.js +7 -5
  88. package/dist/db/list-aggregate-labels.d.ts +1 -0
  89. package/dist/db/list-aggregate-labels.js +9 -1
  90. package/dist/db/migrate-generator.js +23 -4
  91. package/dist/db/migrate-rls-diff.d.ts +1 -0
  92. package/dist/db/migrate-rls-diff.js +15 -1
  93. package/dist/db/migrate-runner.js +2 -2
  94. package/dist/db/money.d.ts +1 -1
  95. package/dist/db/money.js +1 -4
  96. package/dist/db/parent-ref-clause.d.ts +6 -2
  97. package/dist/db/parent-ref-clause.js +76 -23
  98. package/dist/db/parent-ref-global-hosts.d.ts +20 -0
  99. package/dist/db/parent-ref-global-hosts.js +47 -0
  100. package/dist/db/production-schema-command-hint.d.ts +1 -0
  101. package/dist/db/production-schema-command-hint.js +3 -0
  102. package/dist/db/queries/backfill-pii.js +55 -29
  103. package/dist/db/queries/ddl.js +13 -2
  104. package/dist/db/queries/event-store-open-streams.d.ts +15 -0
  105. package/dist/db/queries/event-store-open-streams.js +33 -0
  106. package/dist/db/queries/event-store-payload-scrub.d.ts +5 -0
  107. package/dist/db/queries/event-store-payload-scrub.js +11 -0
  108. package/dist/db/queries/event-store.js +0 -1
  109. package/dist/db/queries/raw-sql.js +0 -1
  110. package/dist/db/queries/rebuild-rls-guard.d.ts +2 -1
  111. package/dist/db/queries/rebuild-rls-guard.js +24 -11
  112. package/dist/db/queries/rls-boot-catalog.d.ts +1 -0
  113. package/dist/db/queries/rls-boot-catalog.js +13 -8
  114. package/dist/db/queries/rls-shape.d.ts +2 -1
  115. package/dist/db/queries/rls-shape.js +10 -0
  116. package/dist/db/queries/session-advisory-lock.js +2 -1
  117. package/dist/db/queries/test-stack.js +7 -7
  118. package/dist/db/query.js +16 -11
  119. package/dist/db/rebuild-marker.js +11 -2
  120. package/dist/db/render-rls-ddl.d.ts +2 -0
  121. package/dist/db/render-rls-ddl.js +16 -11
  122. package/dist/db/replay-migration-sql.js +1 -1
  123. package/dist/db/row-level-security-boot-check.js +18 -5
  124. package/dist/db/row-level-security-connection.js +25 -12
  125. package/dist/db/row-level-security-scope.d.ts +2 -1
  126. package/dist/db/row-level-security-scope.js +9 -5
  127. package/dist/db/sql-identifier.d.ts +1 -0
  128. package/dist/db/sql-identifier.js +3 -0
  129. package/dist/db/system-tenant-read-db.d.ts +5 -0
  130. package/dist/db/system-tenant-read-db.js +28 -0
  131. package/dist/db/table-builder.d.ts +3 -1
  132. package/dist/db/table-builder.js +18 -8
  133. package/dist/db/table-info.d.ts +1 -2
  134. package/dist/db/table-introspection.d.ts +3 -0
  135. package/dist/db/table-introspection.js +6 -0
  136. package/dist/db/table-push.d.ts +1 -0
  137. package/dist/db/table-push.js +7 -1
  138. package/dist/db/tenant-db-runner.d.ts +3 -0
  139. package/dist/db/tenant-db-runner.js +19 -1
  140. package/dist/db/transaction-serialization.d.ts +1 -0
  141. package/dist/db/transaction-serialization.js +20 -3
  142. package/dist/db/where-clause.js +11 -2
  143. package/dist/db/write-ownership-failures.d.ts +25 -0
  144. package/dist/db/write-ownership-failures.js +82 -0
  145. package/dist/engine/boot-validator/boot-check.js +7 -1
  146. package/dist/engine/boot-validator/boot-phases-app.js +5 -5
  147. package/dist/engine/boot-validator/boot-phases.js +3 -2
  148. package/dist/engine/boot-validator/boot-rules.d.ts +293 -26
  149. package/dist/engine/boot-validator/boot-rules.js +4 -0
  150. package/dist/engine/boot-validator/bundled-lists-table.js +2 -2
  151. package/dist/engine/boot-validator/card-meta-overflow.js +1 -0
  152. package/dist/engine/boot-validator/config-deps.d.ts +0 -1
  153. package/dist/engine/boot-validator/config-deps.js +0 -28
  154. package/dist/engine/boot-validator/config-key-rules.d.ts +0 -15
  155. package/dist/engine/boot-validator/config-key-rules.js +0 -15
  156. package/dist/engine/boot-validator/dashboard-screen-target.d.ts +22 -0
  157. package/dist/engine/boot-validator/dashboard-screen-target.js +20 -0
  158. package/dist/engine/boot-validator/dashboard-stat-navigate.d.ts +1 -0
  159. package/dist/engine/boot-validator/dashboard-stat-navigate.js +25 -17
  160. package/dist/engine/boot-validator/definition-webhook-events-rules.d.ts +5 -0
  161. package/dist/engine/boot-validator/definition-webhook-events-rules.js +5 -0
  162. package/dist/engine/boot-validator/derived-sql-fields.js +1 -2
  163. package/dist/engine/boot-validator/entity-declaration-rules.d.ts +5 -0
  164. package/dist/engine/boot-validator/entity-declaration-rules.js +5 -0
  165. package/dist/engine/boot-validator/entity-list-screens.d.ts +1 -0
  166. package/dist/engine/boot-validator/entity-list-screens.js +33 -6
  167. package/dist/engine/boot-validator/entity-structure-rules.d.ts +5 -0
  168. package/dist/engine/boot-validator/entity-structure-rules.js +5 -0
  169. package/dist/engine/boot-validator/list-column-layout.js +10 -6
  170. package/dist/engine/boot-validator/list-row-guidance-rules.d.ts +67 -0
  171. package/dist/engine/boot-validator/list-row-guidance-rules.js +67 -0
  172. package/dist/engine/boot-validator/list-row-guidance.d.ts +20 -0
  173. package/dist/engine/boot-validator/list-row-guidance.js +129 -0
  174. package/dist/engine/boot-validator/list-sort-summary-rules.d.ts +42 -0
  175. package/dist/engine/boot-validator/list-sort-summary-rules.js +42 -0
  176. package/dist/engine/boot-validator/list-sort-summary.d.ts +5 -0
  177. package/dist/engine/boot-validator/list-sort-summary.js +149 -0
  178. package/dist/engine/boot-validator/list-table-options.js +15 -1
  179. package/dist/engine/boot-validator/list-table-rules.d.ts +10 -5
  180. package/dist/engine/boot-validator/list-table-rules.js +10 -5
  181. package/dist/engine/boot-validator/list-toolbar-options.d.ts +10 -0
  182. package/dist/engine/boot-validator/list-toolbar-options.js +31 -0
  183. package/dist/engine/boot-validator/named-filter-rules.d.ts +32 -2
  184. package/dist/engine/boot-validator/named-filter-rules.js +32 -2
  185. package/dist/engine/boot-validator/ownership.js +10 -1
  186. package/dist/engine/boot-validator/parent-ref.js +87 -50
  187. package/dist/engine/boot-validator/projection-list-screens.d.ts +1 -0
  188. package/dist/engine/boot-validator/projection-list-screens.js +31 -1
  189. package/dist/engine/boot-validator/query-output-columns.js +62 -9
  190. package/dist/engine/boot-validator/query-output-guidance.d.ts +7 -0
  191. package/dist/engine/boot-validator/query-output-guidance.js +39 -0
  192. package/dist/engine/boot-validator/query-refs.js +24 -1
  193. package/dist/engine/boot-validator/row-decoration.d.ts +11 -0
  194. package/dist/engine/boot-validator/row-decoration.js +16 -0
  195. package/dist/engine/boot-validator/screens-dashboard-links.d.ts +10 -0
  196. package/dist/engine/boot-validator/screens-dashboard-links.js +36 -0
  197. package/dist/engine/boot-validator/screens-dashboard-narrow.d.ts +4 -0
  198. package/dist/engine/boot-validator/screens-dashboard-narrow.js +211 -0
  199. package/dist/engine/boot-validator/screens-dashboard-rules.d.ts +84 -4
  200. package/dist/engine/boot-validator/screens-dashboard-rules.js +84 -4
  201. package/dist/engine/boot-validator/screens-dashboard.js +29 -7
  202. package/dist/engine/boot-validator/screens-kind-entity-list.js +32 -27
  203. package/dist/engine/boot-validator/screens-kind-projection-detail-guidance.d.ts +3 -0
  204. package/dist/engine/boot-validator/screens-kind-projection-detail-guidance.js +46 -0
  205. package/dist/engine/boot-validator/screens-kind-projection-detail-rules.d.ts +20 -0
  206. package/dist/engine/boot-validator/screens-kind-projection-detail-rules.js +20 -0
  207. package/dist/engine/boot-validator/screens-kind-projection-detail.js +2 -0
  208. package/dist/engine/boot-validator/screens-kind-projection-list.js +4 -0
  209. package/dist/engine/boot-validator/screens-kind-rules.d.ts +25 -0
  210. package/dist/engine/boot-validator/screens-kind-rules.js +25 -0
  211. package/dist/engine/boot-validator/screens-lists.d.ts +8 -2
  212. package/dist/engine/boot-validator/screens-lists.js +19 -3
  213. package/dist/engine/boot-validator/screens.js +1 -1
  214. package/dist/engine/boot-validator/sort-nulls.d.ts +2 -0
  215. package/dist/engine/boot-validator/sort-nulls.js +15 -0
  216. package/dist/engine/boot-validator/zod-shape.d.ts +2 -1
  217. package/dist/engine/boot-validator/zod-shape.js +19 -1
  218. package/dist/engine/build-app-schema.js +4 -0
  219. package/dist/engine/config-helpers.d.ts +1 -2
  220. package/dist/engine/config-helpers.js +6 -7
  221. package/dist/engine/define-feature.js +1 -0
  222. package/dist/engine/define-handler.d.ts +1 -0
  223. package/dist/engine/define-handler.js +4 -2
  224. package/dist/engine/definition-violations.js +2 -2
  225. package/dist/engine/entity-handlers.js +3 -8
  226. package/dist/engine/entity-list-runtime-options.js +9 -8
  227. package/dist/engine/factories.d.ts +2 -0
  228. package/dist/engine/feature-config-events-jobs.js +1 -0
  229. package/dist/engine/feature-entity-handlers.js +5 -2
  230. package/dist/engine/field-access.d.ts +1 -1
  231. package/dist/engine/field-access.js +7 -10
  232. package/dist/engine/find-entity.js +3 -3
  233. package/dist/engine/form-derivations.js +3 -3
  234. package/dist/engine/index.d.ts +3 -3
  235. package/dist/engine/index.js +2 -2
  236. package/dist/engine/named-filter-roles.d.ts +3 -0
  237. package/dist/engine/named-filter-roles.js +23 -0
  238. package/dist/engine/pipeline.js +0 -1
  239. package/dist/engine/project-app-schema-for-roles.js +17 -2
  240. package/dist/engine/qualified-name.js +0 -1
  241. package/dist/engine/registry-facade.js +1 -2
  242. package/dist/engine/registry-state.d.ts +1 -1
  243. package/dist/engine/registry-state.js +5 -2
  244. package/dist/engine/registry-validate.js +2 -1
  245. package/dist/engine/resolve-named-list-filters.js +5 -2
  246. package/dist/engine/schema-builder.js +6 -10
  247. package/dist/engine/screen-helpers.d.ts +12 -0
  248. package/dist/engine/screen-helpers.js +17 -1
  249. package/dist/engine/soft-delete-cleanup.js +1 -5
  250. package/dist/engine/state-machine.js +0 -1
  251. package/dist/engine/steps/_database-clock.d.ts +2 -0
  252. package/dist/engine/steps/_database-clock.js +6 -0
  253. package/dist/engine/steps/compute.js +1 -1
  254. package/dist/engine/steps/retry.js +5 -1
  255. package/dist/engine/steps/return.js +0 -1
  256. package/dist/engine/steps/wait-for-event.js +2 -1
  257. package/dist/engine/steps/wait.js +2 -1
  258. package/dist/engine/system-user.d.ts +2 -2
  259. package/dist/engine/system-user.js +2 -2
  260. package/dist/engine/types/handlers.d.ts +1 -1
  261. package/dist/engine/types/handlers.js +1 -1
  262. package/dist/engine/types/screen.d.ts +1 -1
  263. package/dist/engine/types/screen.js +1 -1
  264. package/dist/engine/webhook-contracts.d.ts +2 -3
  265. package/dist/engine/webhook-contracts.js +2 -25
  266. package/dist/engine/webhook-events.js +48 -29
  267. package/dist/engine/webhook-payload-strictness.d.ts +7 -0
  268. package/dist/engine/webhook-payload-strictness.js +53 -0
  269. package/dist/env/_zod-introspect.d.ts +1 -0
  270. package/dist/env/dry-run.d.ts +1 -1
  271. package/dist/env/dry-run.js +1 -1
  272. package/dist/env/field-meta.d.ts +4 -0
  273. package/dist/env/field-meta.js +67 -0
  274. package/dist/env/field-rules.d.ts +9 -0
  275. package/dist/env/field-rules.js +46 -0
  276. package/dist/env/index.d.ts +3 -3
  277. package/dist/env/index.js +16 -71
  278. package/dist/env/internals.d.ts +3 -0
  279. package/dist/env/internals.js +1 -2
  280. package/dist/env/required-env.d.ts +3 -1
  281. package/dist/env/required-env.js +5 -2
  282. package/dist/errors/serialize.js +2 -2
  283. package/dist/errors/write-error-info.js +0 -2
  284. package/dist/es-ops/operations-schema.js +18 -7
  285. package/dist/event-store/admin-api.js +3 -3
  286. package/dist/event-store/event-store.js +0 -3
  287. package/dist/event-store/index.d.ts +1 -0
  288. package/dist/event-store/index.js +1 -0
  289. package/dist/event-store/transfer.js +1 -1
  290. package/dist/files/assert-file-refs-belong-to-tenant.d.ts +2 -1
  291. package/dist/files/assert-file-refs-belong-to-tenant.js +15 -13
  292. package/dist/files/bind-pending-file-refs.d.ts +3 -1
  293. package/dist/files/bind-pending-file-refs.js +54 -27
  294. package/dist/files/copy-pending-file-refs-to-tenant.js +7 -3
  295. package/dist/files/create-file-ref.d.ts +4 -1
  296. package/dist/files/create-file-ref.js +14 -3
  297. package/dist/files/default-file-guard.js +4 -1
  298. package/dist/files/file-claim.d.ts +6 -0
  299. package/dist/files/file-claim.js +17 -0
  300. package/dist/files/file-field-slots.d.ts +2 -0
  301. package/dist/files/file-field-slots.js +28 -0
  302. package/dist/files/file-ref-entity.d.ts +3 -0
  303. package/dist/files/file-ref-entity.js +2 -0
  304. package/dist/files/file-ref-table.d.ts +3 -0
  305. package/dist/files/file-routes.d.ts +4 -1
  306. package/dist/files/file-routes.js +80 -16
  307. package/dist/files/in-memory-provider.d.ts +1 -1
  308. package/dist/files/in-memory-provider.js +2 -1
  309. package/dist/files/index.d.ts +1 -1
  310. package/dist/files/index.js +1 -1
  311. package/dist/files/invalid-file-ref-error.d.ts +2 -0
  312. package/dist/files/invalid-file-ref-error.js +15 -0
  313. package/dist/files/local-provider.js +9 -2
  314. package/dist/files/provider-resolver.js +1 -1
  315. package/dist/files/rebind-file-ref.d.ts +3 -2
  316. package/dist/files/rebind-file-ref.js +24 -18
  317. package/dist/files/resolve-file-handles.d.ts +13 -0
  318. package/dist/files/resolve-file-handles.js +57 -0
  319. package/dist/files/storage-tracking.d.ts +1 -1
  320. package/dist/files/storage-tracking.js +5 -2
  321. package/dist/files/sweep-stale-pending-file-refs.js +10 -4
  322. package/dist/files/types.d.ts +4 -0
  323. package/dist/files/types.js +10 -0
  324. package/dist/files/upload-field-resolution.d.ts +1 -0
  325. package/dist/files/upload-field-resolution.js +16 -2
  326. package/dist/files/upload-ledger.js +1 -1
  327. package/dist/i18n/required-surface-guidance-keys.d.ts +3 -0
  328. package/dist/i18n/required-surface-guidance-keys.js +9 -0
  329. package/dist/i18n/required-surface-keys.js +19 -4
  330. package/dist/internal/boot-rule-table-expectations.d.ts +2 -0
  331. package/dist/internal/boot-rule-table-expectations.js +29 -0
  332. package/dist/internal/row-level-security.d.ts +1 -0
  333. package/dist/internal/row-level-security.js +1 -0
  334. package/dist/internal/testing.d.ts +1 -0
  335. package/dist/internal/testing.js +1 -0
  336. package/dist/jobs/index.d.ts +1 -0
  337. package/dist/jobs/index.js +1 -0
  338. package/dist/jobs/job-load-events.d.ts +10 -0
  339. package/dist/jobs/job-load-events.js +12 -0
  340. package/dist/jobs/job-runner-context.js +6 -158
  341. package/dist/jobs/job-runner-dispatch.d.ts +7 -0
  342. package/dist/jobs/job-runner-dispatch.js +57 -0
  343. package/dist/jobs/job-runner-event-triggers.js +18 -9
  344. package/dist/jobs/job-runner-execution.js +2 -2
  345. package/dist/jobs/job-runner-facets.d.ts +48 -0
  346. package/dist/jobs/job-runner-facets.js +156 -0
  347. package/dist/jobs/job-runner-gates.js +19 -11
  348. package/dist/jobs/job-runner-helpers.d.ts +5 -1
  349. package/dist/jobs/job-runner-helpers.js +18 -3
  350. package/dist/jobs/job-runner-scope.d.ts +1 -0
  351. package/dist/jobs/job-runner-scope.js +2 -0
  352. package/dist/jobs/job-runner-tenant-cap-lock.d.ts +2 -0
  353. package/dist/jobs/job-runner-tenant-cap-lock.js +30 -0
  354. package/dist/jobs/job-runner.js +31 -70
  355. package/dist/jobs/obliterate-job-queues.d.ts +6 -0
  356. package/dist/jobs/obliterate-job-queues.js +23 -0
  357. package/dist/lifecycle/lifecycle.js +1 -1
  358. package/dist/migrations/event-header-scrub.d.ts +11 -0
  359. package/dist/migrations/event-header-scrub.js +33 -0
  360. package/dist/migrations/event-payload-scrub.d.ts +1 -1
  361. package/dist/migrations/event-payload-scrub.js +36 -4
  362. package/dist/migrations/index.d.ts +1 -0
  363. package/dist/migrations/index.js +2 -0
  364. package/dist/migrations/kumiko-drift.d.ts +5 -2
  365. package/dist/migrations/kumiko-drift.js +51 -14
  366. package/dist/migrations/pending-rebuilds.js +4 -5
  367. package/dist/observability/sensitive-filter.js +0 -12
  368. package/dist/pipeline/aggregate-type-removal.js +17 -4
  369. package/dist/pipeline/context-services.d.ts +2 -0
  370. package/dist/pipeline/context-services.js +5 -2
  371. package/dist/pipeline/dispatch-batch.js +4 -3
  372. package/dist/pipeline/dispatch-context-helpers.d.ts +11 -0
  373. package/dist/pipeline/dispatch-context-helpers.js +58 -0
  374. package/dist/pipeline/dispatch-nested-write.d.ts +7 -0
  375. package/dist/pipeline/dispatch-nested-write.js +119 -0
  376. package/dist/pipeline/dispatch-query.js +10 -3
  377. package/dist/pipeline/dispatch-scope.js +4 -3
  378. package/dist/pipeline/dispatch-shared.d.ts +2 -6
  379. package/dist/pipeline/dispatch-shared.js +6 -38
  380. package/dist/pipeline/dispatch-write.d.ts +0 -1
  381. package/dist/pipeline/dispatch-write.js +3 -302
  382. package/dist/pipeline/dispatcher-utils.js +6 -0
  383. package/dist/pipeline/effective-system-scope.d.ts +3 -0
  384. package/dist/pipeline/effective-system-scope.js +22 -0
  385. package/dist/pipeline/event-dispatcher-delivery.d.ts +1 -0
  386. package/dist/pipeline/event-dispatcher-delivery.js +17 -9
  387. package/dist/pipeline/event-dispatcher.d.ts +4 -1
  388. package/dist/pipeline/event-dispatcher.js +6 -7
  389. package/dist/pipeline/handler-context-auth.d.ts +3 -2
  390. package/dist/pipeline/handler-context-auth.js +3 -4
  391. package/dist/pipeline/handler-context-db.js +11 -4
  392. package/dist/pipeline/handler-context-dispatch.js +2 -2
  393. package/dist/pipeline/handler-context-events.d.ts +8 -3
  394. package/dist/pipeline/handler-context-events.js +20 -65
  395. package/dist/pipeline/handler-context-member-resolution.js +16 -8
  396. package/dist/pipeline/handler-context-notify.d.ts +1 -0
  397. package/dist/pipeline/handler-context-notify.js +2 -0
  398. package/dist/pipeline/handler-context-phase-denials.js +3 -2
  399. package/dist/pipeline/handler-context-projection.d.ts +3 -0
  400. package/dist/pipeline/handler-context-projection.js +39 -0
  401. package/dist/pipeline/handler-context-scope.d.ts +1 -1
  402. package/dist/pipeline/handler-context-scope.js +14 -2
  403. package/dist/pipeline/index.d.ts +1 -1
  404. package/dist/pipeline/index.js +1 -1
  405. package/dist/pipeline/lifecycle-pipeline.d.ts +1 -0
  406. package/dist/pipeline/lifecycle-pipeline.js +7 -4
  407. package/dist/pipeline/member-reader.js +4 -2
  408. package/dist/pipeline/msp-rebuild.js +1 -1
  409. package/dist/pipeline/nested-write-parent-guard.d.ts +5 -0
  410. package/dist/pipeline/nested-write-parent-guard.js +81 -0
  411. package/dist/pipeline/projection-rebuild.d.ts +2 -0
  412. package/dist/pipeline/projection-rebuild.js +16 -7
  413. package/dist/pipeline/projection-state.js +4 -6
  414. package/dist/pipeline/system-hooks.js +36 -6
  415. package/dist/pipeline/write-result-masking.js +31 -3
  416. package/dist/pipeline/write-transition-guard.d.ts +7 -0
  417. package/dist/pipeline/write-transition-guard.js +95 -0
  418. package/dist/schema-cli/shared.d.ts +2 -0
  419. package/dist/schema-cli/shared.js +4 -2
  420. package/dist/schema-cli/validate-command.js +43 -28
  421. package/dist/search/meilisearch-adapter.js +14 -9
  422. package/dist/search/reindex-entity.d.ts +2 -0
  423. package/dist/search/reindex-entity.js +32 -4
  424. package/dist/search/reindex-tenants-search.js +20 -4
  425. package/dist/time/tz-context.js +1 -1
  426. package/dist/ui-types/card-column-roles.d.ts +4 -0
  427. package/dist/ui-types/card-column-roles.js +6 -3
  428. package/dist/ui-types/index.d.ts +2 -2
  429. package/dist/ui-types/index.js +1 -1
  430. package/dist/utils/ids.js +0 -1
  431. package/dist/utils/index.d.ts +1 -0
  432. package/dist/utils/index.js +1 -0
  433. package/dist/utils/return-path-limit.d.ts +1 -0
  434. package/dist/utils/return-path-limit.js +1 -0
  435. package/package.json +5 -3
  436. package/presets/biome-app.json +39 -21
  437. package/presets/biome-plugins/admin-api.grit +10 -0
  438. package/presets/biome-plugins/error-reasons.grit +53 -0
  439. package/presets/biome-plugins/es-literal-writes-tests.grit +18 -0
  440. package/presets/biome-plugins/es-literal-writes.grit +22 -0
  441. package/presets/biome-plugins/i18n-locale-terminology-de.grit +15 -0
  442. package/presets/biome-plugins/i18n-locale-terminology-romance.grit +10 -0
  443. package/presets/biome-plugins/no-create-test-dispatcher.grit +5 -0
  444. package/presets/biome-plugins/no-css-properties-type.grit +7 -0
  445. package/presets/biome-plugins/no-date-api.grit +9 -0
  446. package/presets/biome-plugins/no-direct-fetch.grit +16 -0
  447. package/presets/biome-plugins/no-direct-fs.grit +16 -0
  448. package/presets/biome-plugins/no-external-font-cdn-css.grit +9 -0
  449. package/presets/biome-plugins/no-external-font-cdn.grit +12 -0
  450. package/presets/biome-plugins/no-raw-hooks.grit +10 -0
  451. package/presets/biome-plugins/no-same-folder-barrel-import.grit +11 -0
  452. package/presets/biome-plugins/no-screen-container-classes.grit +7 -0
  453. package/presets/biome-plugins/no-skipped-or-retried-tests.grit +34 -0
  454. package/presets/biome-plugins/no-temporal-polyfill-require.grit +10 -0
  455. package/presets/biome-plugins/raw-html-in-web.grit +40 -0
  456. package/presets/biome-plugins/raw-ui-in-app.grit +142 -0
  457. package/presets/biome-plugins/restricted-event-store-symbols.grit +18 -0
  458. package/presets/biome-plugins/test-title.grit +20 -0
  459. package/presets/biome-plugins/unsafe-json-parse.grit +6 -0
  460. package/presets/biome-rules.json +465 -0
  461. package/src/changes.json +309 -0
  462. package/dist/engine/minor-units.d.ts +0 -2
  463. package/dist/engine/minor-units.js +0 -8
@@ -136,14 +136,94 @@ export declare const DASHBOARD_RULES: {
136
136
  };
137
137
  readonly textPanelEmpty: {
138
138
  readonly id: "dashboard/text-panel-empty";
139
- readonly summary: "A text panel declares at least one block.";
140
- readonly fix: "Add at least one block.";
139
+ readonly summary: "A text panel declares at least one block or a query.";
140
+ readonly fix: "Add at least one block or set query.";
141
+ };
142
+ readonly statNavigateParamsInvalid: {
143
+ readonly id: "dashboard/stat-navigate-params-invalid";
144
+ readonly summary: "A stat's navigate.params has non-empty keys and string values.";
145
+ readonly fix: "Use { key: 'value' } with non-empty keys and string values, or remove params.";
141
146
  };
142
147
  readonly textListBlockEmpty: {
143
148
  readonly id: "dashboard/text-list-block-empty";
144
149
  readonly summary: "A text list block has items.";
145
150
  readonly fix: "Add items or remove the block.";
146
151
  };
152
+ readonly statNavigateCustomWithFilter: {
153
+ readonly id: "dashboard/stat-navigate-custom-with-filter";
154
+ readonly summary: "A stat navigating to a custom screen does not set namedFilter.";
155
+ readonly fix: "Remove navigate.namedFilter; a custom screen has no namedFilters.";
156
+ };
157
+ readonly panelLinkTarget: {
158
+ readonly id: "dashboard/panel-link-target";
159
+ readonly summary: "A list panel footerLink or stat-group link targets a registered screen, sets string-valued params, and uses namedFilter only on a list screen that declares it.";
160
+ readonly fix: "Point screen at a registered screen, give params string values, and drop namedFilter unless the target list declares it.";
161
+ };
162
+ readonly listNarrowInvalid: {
163
+ readonly id: "dashboard/list-narrow-invalid";
164
+ readonly summary: 'A list panel\'s narrow.limit is a positive integer, narrow.layout is "cards" or "line", and narrow.moreText and icon appear only with the "line" layout.';
165
+ readonly fix: 'Set narrow.limit to a whole number of at least 1 and narrow.layout to "cards" or "line"; use narrow.moreText and icon only with "line".';
166
+ };
167
+ readonly listNarrowLineWithoutFooterLink: {
168
+ readonly id: "dashboard/list-narrow-line-without-footer-link";
169
+ readonly summary: 'A list panel with narrow.layout "line" declares footerLink, the target of the line.';
170
+ readonly fix: 'Add footerLink or use narrow.layout "cards".';
171
+ };
172
+ readonly listRowLinkInvalid: {
173
+ readonly id: "dashboard/list-row-link-invalid";
174
+ readonly summary: 'A list panel rowLink names exactly one target (a registered screen, or the row field screenField holding it), takes the matching params field (paramField with screen, paramsField with screenField), non-empty field names and an icon of "arrow" or "chevron".';
175
+ readonly fix: 'Set either rowLink.screen to a registered screen (params from paramField) or rowLink.screenField to the row field holding the screen name (params from paramsField), and icon to "arrow" or "chevron".';
176
+ };
177
+ readonly listRowToneMarkerInvalid: {
178
+ readonly id: "dashboard/list-row-tone-marker-invalid";
179
+ readonly summary: 'A list panel rowToneMarker is "bar" or "dot".';
180
+ readonly fix: 'Set rowToneMarker to "bar" or "dot", or remove it.';
181
+ };
182
+ readonly statGroupColumnsInvalid: {
183
+ readonly id: "dashboard/stat-group-columns-invalid";
184
+ readonly summary: 'A stat-group\'s columns is 2, 3 or 4 and needs layout "cards".';
185
+ readonly fix: 'Set columns to 2, 3 or 4 and give the group a label or layout: "cards", or remove columns.';
186
+ };
187
+ readonly statGroupChildHideOnNarrow: {
188
+ readonly id: "dashboard/stat-group-child-hide-on-narrow";
189
+ readonly summary: "Stat-group children do not set hideOnNarrow.";
190
+ readonly fix: "Set hideOnNarrow on the whole group instead.";
191
+ };
192
+ readonly listNarrowFieldUnknown: {
193
+ readonly id: "dashboard/list-narrow-field-unknown";
194
+ readonly summary: 'A list panel\'s narrow.field is set only with narrow.layout "line" and names a non-empty query output field; narrow.titleField needs the cards layout and a hint column.';
195
+ readonly fix: 'Set narrow.layout "line" and name a field of the query output, or remove narrow.field. For narrow.titleField keep the cards layout and a hint column.';
196
+ };
197
+ readonly narrowOrderInvalid: {
198
+ readonly id: "dashboard/narrow-order-invalid";
199
+ readonly summary: "A panel's narrowOrder is an integer of at least 0 and is not set on a stat-group child.";
200
+ readonly fix: "Set narrowOrder to a whole number from 0 up on the panel (or the whole stat-group).";
201
+ };
202
+ readonly statNarrowLabelOutsideGroup: {
203
+ readonly id: "dashboard/stat-narrow-label-outside-group";
204
+ readonly summary: "A stat's narrowLabel is non-empty and only set on a stat-group child (the one-line phone strip is the only place it is drawn).";
205
+ readonly fix: "Move the stat into a titled stat-group or remove narrowLabel.";
206
+ };
207
+ readonly statGroupNarrowWithoutTitledStrip: {
208
+ readonly id: "dashboard/stat-group-narrow-without-titled-strip";
209
+ readonly summary: 'A stat-group\'s narrow.tone needs a label and layout "strip" (it tints the one-line phone strip).';
210
+ readonly fix: 'Give the group a label and layout "strip", or remove narrow.';
211
+ };
212
+ readonly statGroupNarrowToneInvalid: {
213
+ readonly id: "dashboard/stat-group-narrow-tone-invalid";
214
+ readonly summary: "A stat-group's narrow.tone must be one of the select option tones.";
215
+ readonly fix: "Use accent, ok, warn, bad, critical or neutral.";
216
+ };
217
+ readonly statGroupIconWithoutTitledStrip: {
218
+ readonly id: "dashboard/stat-group-icon-without-titled-strip";
219
+ readonly summary: 'A stat-group\'s icon needs a label and layout "strip" (the icon stands in the one-line phone strip).';
220
+ readonly fix: 'Give the group a label and layout "strip", or remove icon.';
221
+ };
222
+ readonly textNarrowBlocksWithoutBlocks: {
223
+ readonly id: "dashboard/text-narrow-blocks-without-blocks";
224
+ readonly summary: "A text panel with narrowBlocks also declares blocks, and narrowBlocks is non-empty.";
225
+ readonly fix: "Add blocks (the wide variant) or remove narrowBlocks.";
226
+ };
147
227
  readonly textLinkUnresolved: {
148
228
  readonly id: "dashboard/text-link-unresolved";
149
229
  readonly summary: "A text link block's screen resolves to a registered screen.";
@@ -161,8 +241,8 @@ export declare const DASHBOARD_RULES: {
161
241
  };
162
242
  readonly panelSpanInvalid: {
163
243
  readonly id: "dashboard/panel-span-invalid";
164
- readonly summary: 'A panel\'s span is "half" or "full".';
165
- readonly fix: 'Set span to "half" or "full".';
244
+ readonly summary: 'A panel\'s span is "half", "full", "third" or "two-thirds".';
245
+ readonly fix: 'Set span to "half", "full", "third" or "two-thirds".';
166
246
  };
167
247
  readonly statGroupEmpty: {
168
248
  readonly id: "dashboard/stat-group-empty";
@@ -136,14 +136,94 @@ export const DASHBOARD_RULES = {
136
136
  },
137
137
  textPanelEmpty: {
138
138
  id: "dashboard/text-panel-empty",
139
- summary: "A text panel declares at least one block.",
140
- fix: "Add at least one block.",
139
+ summary: "A text panel declares at least one block or a query.",
140
+ fix: "Add at least one block or set query.",
141
+ },
142
+ statNavigateParamsInvalid: {
143
+ id: "dashboard/stat-navigate-params-invalid",
144
+ summary: "A stat's navigate.params has non-empty keys and string values.",
145
+ fix: "Use { key: 'value' } with non-empty keys and string values, or remove params.",
141
146
  },
142
147
  textListBlockEmpty: {
143
148
  id: "dashboard/text-list-block-empty",
144
149
  summary: "A text list block has items.",
145
150
  fix: "Add items or remove the block.",
146
151
  },
152
+ statNavigateCustomWithFilter: {
153
+ id: "dashboard/stat-navigate-custom-with-filter",
154
+ summary: "A stat navigating to a custom screen does not set namedFilter.",
155
+ fix: "Remove navigate.namedFilter; a custom screen has no namedFilters.",
156
+ },
157
+ panelLinkTarget: {
158
+ id: "dashboard/panel-link-target",
159
+ summary: "A list panel footerLink or stat-group link targets a registered screen, sets string-valued params, and uses namedFilter only on a list screen that declares it.",
160
+ fix: "Point screen at a registered screen, give params string values, and drop namedFilter unless the target list declares it.",
161
+ },
162
+ listNarrowInvalid: {
163
+ id: "dashboard/list-narrow-invalid",
164
+ summary: 'A list panel\'s narrow.limit is a positive integer, narrow.layout is "cards" or "line", and narrow.moreText and icon appear only with the "line" layout.',
165
+ fix: 'Set narrow.limit to a whole number of at least 1 and narrow.layout to "cards" or "line"; use narrow.moreText and icon only with "line".',
166
+ },
167
+ listNarrowLineWithoutFooterLink: {
168
+ id: "dashboard/list-narrow-line-without-footer-link",
169
+ summary: 'A list panel with narrow.layout "line" declares footerLink, the target of the line.',
170
+ fix: 'Add footerLink or use narrow.layout "cards".',
171
+ },
172
+ listRowLinkInvalid: {
173
+ id: "dashboard/list-row-link-invalid",
174
+ summary: 'A list panel rowLink names exactly one target (a registered screen, or the row field screenField holding it), takes the matching params field (paramField with screen, paramsField with screenField), non-empty field names and an icon of "arrow" or "chevron".',
175
+ fix: 'Set either rowLink.screen to a registered screen (params from paramField) or rowLink.screenField to the row field holding the screen name (params from paramsField), and icon to "arrow" or "chevron".',
176
+ },
177
+ listRowToneMarkerInvalid: {
178
+ id: "dashboard/list-row-tone-marker-invalid",
179
+ summary: 'A list panel rowToneMarker is "bar" or "dot".',
180
+ fix: 'Set rowToneMarker to "bar" or "dot", or remove it.',
181
+ },
182
+ statGroupColumnsInvalid: {
183
+ id: "dashboard/stat-group-columns-invalid",
184
+ summary: 'A stat-group\'s columns is 2, 3 or 4 and needs layout "cards".',
185
+ fix: 'Set columns to 2, 3 or 4 and give the group a label or layout: "cards", or remove columns.',
186
+ },
187
+ statGroupChildHideOnNarrow: {
188
+ id: "dashboard/stat-group-child-hide-on-narrow",
189
+ summary: "Stat-group children do not set hideOnNarrow.",
190
+ fix: "Set hideOnNarrow on the whole group instead.",
191
+ },
192
+ listNarrowFieldUnknown: {
193
+ id: "dashboard/list-narrow-field-unknown",
194
+ summary: 'A list panel\'s narrow.field is set only with narrow.layout "line" and names a non-empty query output field; narrow.titleField needs the cards layout and a hint column.',
195
+ fix: 'Set narrow.layout "line" and name a field of the query output, or remove narrow.field. For narrow.titleField keep the cards layout and a hint column.',
196
+ },
197
+ narrowOrderInvalid: {
198
+ id: "dashboard/narrow-order-invalid",
199
+ summary: "A panel's narrowOrder is an integer of at least 0 and is not set on a stat-group child.",
200
+ fix: "Set narrowOrder to a whole number from 0 up on the panel (or the whole stat-group).",
201
+ },
202
+ statNarrowLabelOutsideGroup: {
203
+ id: "dashboard/stat-narrow-label-outside-group",
204
+ summary: "A stat's narrowLabel is non-empty and only set on a stat-group child (the one-line phone strip is the only place it is drawn).",
205
+ fix: "Move the stat into a titled stat-group or remove narrowLabel.",
206
+ },
207
+ statGroupNarrowWithoutTitledStrip: {
208
+ id: "dashboard/stat-group-narrow-without-titled-strip",
209
+ summary: 'A stat-group\'s narrow.tone needs a label and layout "strip" (it tints the one-line phone strip).',
210
+ fix: 'Give the group a label and layout "strip", or remove narrow.',
211
+ },
212
+ statGroupNarrowToneInvalid: {
213
+ id: "dashboard/stat-group-narrow-tone-invalid",
214
+ summary: "A stat-group's narrow.tone must be one of the select option tones.",
215
+ fix: "Use accent, ok, warn, bad, critical or neutral.",
216
+ },
217
+ statGroupIconWithoutTitledStrip: {
218
+ id: "dashboard/stat-group-icon-without-titled-strip",
219
+ summary: 'A stat-group\'s icon needs a label and layout "strip" (the icon stands in the one-line phone strip).',
220
+ fix: 'Give the group a label and layout "strip", or remove icon.',
221
+ },
222
+ textNarrowBlocksWithoutBlocks: {
223
+ id: "dashboard/text-narrow-blocks-without-blocks",
224
+ summary: "A text panel with narrowBlocks also declares blocks, and narrowBlocks is non-empty.",
225
+ fix: "Add blocks (the wide variant) or remove narrowBlocks.",
226
+ },
147
227
  textLinkUnresolved: {
148
228
  id: "dashboard/text-link-unresolved",
149
229
  summary: "A text link block's screen resolves to a registered screen.",
@@ -161,8 +241,8 @@ export const DASHBOARD_RULES = {
161
241
  },
162
242
  panelSpanInvalid: {
163
243
  id: "dashboard/panel-span-invalid",
164
- summary: 'A panel\'s span is "half" or "full".',
165
- fix: 'Set span to "half" or "full".',
244
+ summary: 'A panel\'s span is "half", "full", "third" or "two-thirds".',
245
+ fix: 'Set span to "half", "full", "third" or "two-thirds".',
166
246
  },
167
247
  statGroupEmpty: {
168
248
  id: "dashboard/stat-group-empty",
@@ -1,8 +1,11 @@
1
1
  import { DASHBOARD_MIN_REFRESH_SECONDS } from "@cosmicdrift/kumiko-types/screen";
2
2
  import { normalizeListColumn } from "../screen-helpers.js";
3
3
  import { bootRuleError } from "./boot-rule.js";
4
+ import { validateListRowGuidance } from "./list-row-guidance.js";
4
5
  import { assertWriteHandlerRegistered, isRowClickAction, resolveRowActionNavigateTarget, resolveScreenTargetQn, validateActionHasIcon, validateClientActionName, validateRowActionNavigateParams, } from "./screens-actions.js";
5
6
  import { DASHBOARD_CHART_RULES } from "./screens-dashboard-chart-rules.js";
7
+ import { validateDashboardPanelLink, validateListRowLinkTarget, } from "./screens-dashboard-links.js";
8
+ import { validateDashboardPanelNarrow, validateListRowLinkShape, } from "./screens-dashboard-narrow.js";
6
9
  import { DASHBOARD_RULES } from "./screens-dashboard-rules.js";
7
10
  import { assertRefTargetRegistered, validateColumnRendererForm } from "./screens-lists.js";
8
11
  // Panel-driven, no entity — structural checks (unique panel ids, non-empty
@@ -26,8 +29,9 @@ export function validateDashboardScreen(featureName, screenId, screen, featureMa
26
29
  };
27
30
  for (const panel of screen.panels) {
28
31
  addPanelId(panel.id, panel.kind);
32
+ validateDashboardPanelNarrow(featureName, screenId, panel);
29
33
  if (panel.kind === "stat-group") {
30
- validateDashboardStatGroupPanel(featureName, screenId, panel, addPanelId);
34
+ validateDashboardStatGroupPanel(featureName, screenId, panel, addPanelId, featureMap);
31
35
  }
32
36
  else if (panel.kind === "custom") {
33
37
  validateDashboardCustomPanel(featureName, screenId, panel);
@@ -276,14 +280,20 @@ export function validateDashboardScreenPanel(featureName, screenId, panel, featu
276
280
  }
277
281
  function validateDashboardTextPanel(featureName, screenId, panel, featureMap) {
278
282
  const context = `[Feature ${featureName}] Screen "${screenId}" (dashboard) text-panel "${panel.id}"`;
279
- if (panel.blocks.length === 0) {
283
+ const blocks = panel.blocks ?? [];
284
+ if (panel.query === "") {
285
+ throw bootRuleError(DASHBOARD_RULES.panelQueryEmpty, {
286
+ message: `${context} has an empty query. Set query to a registered query name or remove it.`,
287
+ });
288
+ }
289
+ if (blocks.length === 0 && panel.query === undefined) {
280
290
  throw bootRuleError(DASHBOARD_RULES.textPanelEmpty, {
281
- message: `${context} has an empty blocks list. Add at least one block.`,
291
+ message: `${context} has no blocks and no query. Add at least one block or set query.`,
282
292
  });
283
293
  }
284
294
  validateDashboardPanelSpan(featureName, screenId, panel);
285
295
  validateDashboardPanelVisibleWhen(context, panel.visibleWhen);
286
- for (const block of panel.blocks) {
296
+ for (const block of [...blocks, ...(panel.narrowBlocks ?? [])]) {
287
297
  if (block.kind === "list" && block.items.length === 0) {
288
298
  throw bootRuleError(DASHBOARD_RULES.textListBlockEmpty, {
289
299
  message: `${context} has a list block without items. Add items or remove the block.`,
@@ -316,15 +326,22 @@ export function validateDashboardPanelVisibleWhen(context, visibleWhen) {
316
326
  });
317
327
  }
318
328
  }
329
+ const DASHBOARD_PANEL_SPANS = [
330
+ "half",
331
+ "full",
332
+ "third",
333
+ "two-thirds",
334
+ ];
319
335
  function validateDashboardPanelSpan(featureName, screenId, panel) {
320
- if (panel.span !== undefined && panel.span !== "half" && panel.span !== "full") {
336
+ if (panel.span !== undefined && !DASHBOARD_PANEL_SPANS.includes(panel.span)) {
321
337
  throw bootRuleError(DASHBOARD_RULES.panelSpanInvalid, {
322
- message: `[Feature ${featureName}] Screen "${screenId}" (dashboard) panel "${panel.id}" has span "${String(panel.span)}" — expected "half" or "full".`,
338
+ message: `[Feature ${featureName}] Screen "${screenId}" (dashboard) panel "${panel.id}" has span "${String(panel.span)}" — expected "half", "full", "third" or "two-thirds".`,
323
339
  });
324
340
  }
325
341
  }
326
- function validateDashboardStatGroupPanel(featureName, screenId, panel, addPanelId) {
342
+ function validateDashboardStatGroupPanel(featureName, screenId, panel, addPanelId, featureMap) {
327
343
  const context = `[Feature ${featureName}] Screen "${screenId}" (dashboard) stat-group "${panel.id}"`;
344
+ validateDashboardPanelLink(`${context} link`, panel.link, featureName, featureMap);
328
345
  if (panel.stats.length === 0) {
329
346
  throw bootRuleError(DASHBOARD_RULES.statGroupEmpty, {
330
347
  message: `${context} has an empty stats list. Add at least one stat.`,
@@ -541,6 +558,7 @@ export function validateDashboardCustomPanel(featureName, screenId, panel) {
541
558
  `declare a react/native component marker.`,
542
559
  });
543
560
  }
561
+ validateDashboardPanelSpan(featureName, screenId, panel);
544
562
  }
545
563
  function validateDashboardQueryPanel(featureName, screenId, panel, featureMap) {
546
564
  if (!panel.query || typeof panel.query !== "string") {
@@ -561,11 +579,15 @@ function validateDashboardQueryPanel(featureName, screenId, panel, featureMap) {
561
579
  if (panel.kind === "chart")
562
580
  validateDashboardChartDisplay(featureName, screenId, panel);
563
581
  if (panel.kind === "list") {
582
+ validateDashboardPanelLink(`[Feature ${featureName}] Screen "${screenId}" (dashboard) list-panel "${panel.id}" footerLink`, panel.footerLink, featureName, featureMap);
583
+ validateListRowLinkTarget(`[Feature ${featureName}] Screen "${screenId}" (dashboard) list-panel "${panel.id}" rowLink`, panel.rowLink, featureName, featureMap);
584
+ validateListRowLinkShape(`[Feature ${featureName}] Screen "${screenId}" (dashboard) list-panel "${panel.id}"`, panel);
564
585
  if (panel.columns.length === 0) {
565
586
  throw bootRuleError(DASHBOARD_RULES.listPanelColumnsEmpty, {
566
587
  message: `[Feature ${featureName}] Screen "${screenId}" (dashboard) list-panel "${panel.id}" has an empty columns list. Add at least one column.`,
567
588
  });
568
589
  }
590
+ validateListRowGuidance(featureName, screenId, "dashboard", panel, undefined, panel.id);
569
591
  for (const col of panel.columns) {
570
592
  const normalized = normalizeListColumn(col);
571
593
  validateColumnRendererForm(featureName, screenId, normalized);
@@ -8,13 +8,16 @@ import { validateEntityListAggregateOptions } from "./entity-list-aggregate-opti
8
8
  import { LIST_ROW_META_COLUMN_NAMES } from "./entity-list-screens.js";
9
9
  import { ENTITY_LIST_RULES } from "./entity-list-screens-rules.js";
10
10
  import { validateListBulkActions } from "./list-bulk-actions.js";
11
+ import { validateListRowGuidance } from "./list-row-guidance.js";
11
12
  import { validateListTableOptions } from "./list-table-options.js";
12
- import { assertWriteHandlerRegistered, rejectRedirectOnListRowAction, resolveRowActionNavigateTarget, resolveScreenTargetQn, validateActionFieldRefs, validateAtMostOneRowClick, validateDrawerTargetAction, validateRowActionNavigateParams, } from "./screens-actions.js";
13
+ import { validateListToolbarOptions } from "./list-toolbar-options.js";
14
+ import { acceptsRowDecorationField, resolveRowDecorationFields, } from "./row-decoration.js";
15
+ import { assertWriteHandlerRegistered, resolveRowActionNavigateTarget, resolveScreenTargetQn, validateActionFieldRefs, validateAtMostOneRowClick, validateDrawerTargetAction, } from "./screens-actions.js";
13
16
  import { SCREEN_ACTION_RULES } from "./screens-actions-rules.js";
14
17
  import { validateDashboardPanelVisibleWhen } from "./screens-dashboard.js";
15
18
  import { SCREEN_KIND_RULES } from "./screens-kind-rules.js";
16
19
  import { buildUnknownFieldMessage, listActionContext, rejectEmptyColumns, rejectNonArrayInFilter, resolveScreenEntity, validateListColumnRendering, } from "./screens-kind-shared.js";
17
- import { validateRelatedListSection, validateRowActionTarget } from "./screens-lists.js";
20
+ import { validateListActionTargets, validateRelatedListSection } from "./screens-lists.js";
18
21
  function resolveEntityListFields(ctx, screenId, entityName) {
19
22
  const entityDef = resolveScreenEntity(ctx, screenId, entityName);
20
23
  const fieldNames = new Set(Object.keys(entityDef.fields));
@@ -27,7 +30,7 @@ function resolveEntityListFields(ctx, screenId, entityName) {
27
30
  const rowMeta = rowMetaFieldNames(entityDef.softDelete ?? false);
28
31
  return { entityDef, fieldNames, columnFieldNames, rowMeta };
29
32
  }
30
- function validateEntityListColumns(ctx, screenId, screen, fields) {
33
+ function validateEntityListColumns(ctx, screenId, screen, fields, decoration) {
31
34
  const featureName = ctx.feature.name;
32
35
  rejectEmptyColumns(featureName, screenId, "entityList", screen.columns.length);
33
36
  for (const col of screen.columns) {
@@ -47,6 +50,7 @@ function validateEntityListColumns(ctx, screenId, screen, fields) {
47
50
  // a typo worth failing the boot.
48
51
  if (!fields.columnFieldNames.has(normalized.field) &&
49
52
  !LIST_ROW_META_COLUMN_NAMES.has(normalized.field) &&
53
+ !acceptsRowDecorationField(decoration, normalized.field) &&
50
54
  !(normalized.label !== undefined && normalized.renderer !== undefined)) {
51
55
  throw bootRuleError(SCREEN_KIND_RULES.unknownFieldReference, {
52
56
  message: buildUnknownFieldMessage(featureName, screenId, normalized.field, screen.entity, fields.columnFieldNames),
@@ -150,29 +154,15 @@ function rejectCrossFeatureEditTargetWithoutEntityId(featureName, screenId, acti
150
154
  // Pin rowActions at boot: a navigate target must exist and a writeHandler QN
151
155
  // must be registered. Typos would otherwise only surface on the first click as
152
156
  // "Screen not found" or a 404.
153
- function validateEntityListRowAction(ctx, screenId, screen, fields, action) {
157
+ function validateEntityListRowAction(ctx, screenId, screen, fields, decoration, action) {
154
158
  const featureName = ctx.feature.name;
155
- rejectRedirectOnListRowAction(featureName, screenId, "entityList", action);
156
- if (action.kind === "navigate") {
157
- const target = resolveRowActionNavigateTarget(featureName, screenId, "entityList", "rowAction", action, ctx.allScreenQns, ctx.navTargetShortIds, ctx.screensByShortId, ctx.detailForScreens);
158
- rejectCrossFeatureEditTargetWithoutEntityId(featureName, screenId, action, target);
159
- // params only have a reader in actionForm and entityEdit-CREATE; on
160
- // projectionDetail/dashboard/configEdit/entityEdit-update they are
161
- // silently ignored at runtime. `custom` is deliberately exempt: it renders
162
- // an app-registered component the framework has no visibility into, so
163
- // flagging it would be a false positive on working code.
164
- //
165
- // Whether an entityEdit target lands in create or update mode is decided
166
- // by the same rule the renderer's runNavigate() uses: an explicit
167
- // entityId always forces update mode, and (absent an explicit entityId) a
168
- // same-entity target gets row["id"] auto-injected — only a cross-entity
169
- // target with no explicit entityId reaches create.
170
- validateRowActionNavigateParams(featureName, screenId, "entityList", screen.entity, action, target);
171
- }
172
- else {
173
- validateRowActionTarget(listActionContext(ctx, screenId, "entityList", screen.entity, `Screen "${screenId}" (entityList)`), "rowAction", "rowAction", action);
174
- }
175
- validateActionFieldRefs(featureName, screenId, "rowAction", action.id, action, fields.fieldNames, fields.rowMeta);
159
+ validateListActionTargets(listActionContext(ctx, screenId, "entityList", screen.entity, `Screen "${screenId}" (entityList)`), "rowAction", action, (navigateAction, target) => rejectCrossFeatureEditTargetWithoutEntityId(featureName, screenId, navigateAction, target));
160
+ // skip: an undeclared decoration outputSchema leaves the action's field names unpinnable
161
+ if (decoration?.kind === "opaque")
162
+ return;
163
+ validateActionFieldRefs(featureName, screenId, "rowAction", action.id, action, decoration === undefined
164
+ ? fields.fieldNames
165
+ : new Set([...fields.fieldNames, ...decoration.names]), fields.rowMeta);
176
166
  }
177
167
  // toolbarActions, analogous to rowActions: misspelled navigate targets and
178
168
  // unregistered writeHandler QNs fail at boot instead of on the first click.
@@ -219,10 +209,24 @@ function validateEntityListExpandableRow(ctx, screenId, expandableRow, fields) {
219
209
  validateActionFieldRefs(ctx.feature.name, screenId, "toolbarAction", action.id, action, fields.fieldNames, fields.rowMeta);
220
210
  }
221
211
  }
212
+ function validateToolbarOptions(where, screen) {
213
+ if (screen.createPlacement === "toolbar" && screen.allowCreate === false) {
214
+ throw bootRuleError(SCREEN_KIND_RULES.createPlacementWithoutCreate, {
215
+ message: `${where} sets createPlacement "toolbar" with allowCreate: false — there is no create button to place. Remove createPlacement or allowCreate: false.`,
216
+ });
217
+ }
218
+ validateListToolbarOptions(where, screen);
219
+ }
222
220
  export function validateEntityListScreen(ctx, screenId, screen) {
223
221
  const featureName = ctx.feature.name;
224
222
  const fields = resolveEntityListFields(ctx, screenId, screen.entity);
225
- validateEntityListColumns(ctx, screenId, screen, fields);
223
+ const decoration = resolveRowDecorationFields(ctx.featureMap.values(), screen.rowDecoration);
224
+ validateEntityListColumns(ctx, screenId, screen, fields, decoration);
225
+ validateListRowGuidance(featureName, screenId, "entityList", screen, {
226
+ entityName: screen.entity,
227
+ fieldNames: new Set([...fields.columnFieldNames, ...LIST_ROW_META_COLUMN_NAMES]),
228
+ rowDecorationFields: decoration,
229
+ });
226
230
  // Validate pagination, sorting, and search at boot so authoring errors
227
231
  // fail before runtime debugging of empty or incorrectly sorted lists.
228
232
  if (screen.pageSize !== undefined && screen.pageSize <= 0) {
@@ -245,12 +249,13 @@ export function validateEntityListScreen(ctx, screenId, screen) {
245
249
  `Known screens in this feature: ${Object.keys(ctx.feature.screens).sort().join(", ") || "(none)"}.`,
246
250
  });
247
251
  }
252
+ validateToolbarOptions(where, screen);
248
253
  if (screen.filter !== undefined) {
249
254
  validateEntityListFilter(featureName, screenId, screen.filter, fields);
250
255
  }
251
256
  if (screen.rowActions !== undefined) {
252
257
  for (const action of screen.rowActions) {
253
- validateEntityListRowAction(ctx, screenId, screen, fields, action);
258
+ validateEntityListRowAction(ctx, screenId, screen, fields, decoration, action);
254
259
  }
255
260
  validateAtMostOneRowClick(featureName, screenId, "entityList", screen.rowActions);
256
261
  }
@@ -0,0 +1,3 @@
1
+ import type { ProjectionDetailScreenDefinition } from "../types/screen.ts";
2
+ import { type ScreenValidationContext } from "./screens-kind-shared.ts";
3
+ export declare function validateProjectionDetailGuidance(ctx: ScreenValidationContext, screenId: string, screen: ProjectionDetailScreenDefinition): void;
@@ -0,0 +1,46 @@
1
+ import { bootRuleError } from "./boot-rule.js";
2
+ import { detailGuidanceFieldRefs } from "./query-output-guidance.js";
3
+ import { validateActionHasIcon } from "./screens-actions.js";
4
+ import { PROJECTION_DETAIL_RULES } from "./screens-kind-projection-detail-rules.js";
5
+ import { validateRecordHeaderAction } from "./screens-kind-shared.js";
6
+ function validateGuidanceAction(ctx, screenId, screen, block, action) {
7
+ const featureName = ctx.feature.name;
8
+ validateActionHasIcon(featureName, screenId, "projectionDetail", `${block} action`, action);
9
+ validateRecordHeaderAction(ctx, screenId, "projectionDetail", screen.detailFor, action);
10
+ if (action.showOnTabs !== undefined) {
11
+ throw bootRuleError(PROJECTION_DETAIL_RULES.guidanceActionShowOnTabs, {
12
+ message: `[Feature ${featureName}] Screen "${screenId}" (projectionDetail) ${block} action ` +
13
+ `"${action.id}" sets showOnTabs — ${block} actions sit outside the tabs. Remove showOnTabs.`,
14
+ });
15
+ }
16
+ }
17
+ // Field existence is pinned against the query's outputSchema in query-output-columns.ts.
18
+ export function validateProjectionDetailGuidance(ctx, screenId, screen) {
19
+ for (const { option, field } of detailGuidanceFieldRefs(screen)) {
20
+ if (field.trim().length === 0) {
21
+ throw bootRuleError(PROJECTION_DETAIL_RULES.guidanceFieldEmpty, {
22
+ message: `[Feature ${ctx.feature.name}] Screen "${screenId}" (projectionDetail) sets ${option} to ` +
23
+ `an empty string. Name a query output field or remove the block.`,
24
+ });
25
+ }
26
+ }
27
+ if (screen.progress?.placement === "beside-steps" && screen.steps === undefined) {
28
+ throw bootRuleError(PROJECTION_DETAIL_RULES.progressBesideStepsWithoutSteps, {
29
+ message: `[Feature ${ctx.feature.name}] Screen "${screenId}" (projectionDetail) sets progress.placement ` +
30
+ `"beside-steps" without steps. Add steps or remove the placement.`,
31
+ });
32
+ }
33
+ const narrowLimit = screen.steps?.narrowLimit;
34
+ if (narrowLimit !== undefined && (!Number.isInteger(narrowLimit) || narrowLimit < 1)) {
35
+ throw bootRuleError(PROJECTION_DETAIL_RULES.stepsNarrowLimitInvalid, {
36
+ message: `[Feature ${ctx.feature.name}] Screen "${screenId}" (projectionDetail) sets steps.narrowLimit ` +
37
+ `"${String(narrowLimit)}", which is not a positive integer. Set a whole number of at least 1.`,
38
+ });
39
+ }
40
+ for (const action of screen.banner?.actions ?? []) {
41
+ validateGuidanceAction(ctx, screenId, screen, "banner", action);
42
+ }
43
+ for (const action of screen.steps?.actions ?? []) {
44
+ validateGuidanceAction(ctx, screenId, screen, "steps", action);
45
+ }
46
+ }
@@ -59,6 +59,26 @@ export declare const PROJECTION_DETAIL_RULES: {
59
59
  readonly summary: "A header.subtitle part navigate names a screen or an entity.";
60
60
  readonly fix: "Set screen or entity on the part's navigate.";
61
61
  };
62
+ readonly guidanceFieldEmpty: {
63
+ readonly id: "projection-detail/guidance-field-empty";
64
+ readonly summary: "The field names of breadcrumb, summary, banner, steps and progress are non-empty strings.";
65
+ readonly fix: "Name a query output field or remove the block.";
66
+ };
67
+ readonly progressBesideStepsWithoutSteps: {
68
+ readonly id: "projection-detail/progress-beside-steps-without-steps";
69
+ readonly summary: 'progress.placement "beside-steps" needs a steps block to sit next to.';
70
+ readonly fix: "Add steps to the projectionDetail or remove progress.placement.";
71
+ };
72
+ readonly stepsNarrowLimitInvalid: {
73
+ readonly id: "projection-detail/steps-narrow-limit-invalid";
74
+ readonly summary: "steps.narrowLimit is a positive integer.";
75
+ readonly fix: "Set narrowLimit to a whole number of at least 1 or remove it.";
76
+ };
77
+ readonly guidanceActionShowOnTabs: {
78
+ readonly id: "projection-detail/guidance-action-show-on-tabs";
79
+ readonly summary: "Banner and steps actions set no showOnTabs.";
80
+ readonly fix: "Remove showOnTabs.";
81
+ };
62
82
  readonly extensionContributesToFormSubmit: {
63
83
  readonly id: "projection-detail/extension-contributes-to-form-submit";
64
84
  readonly summary: "A projectionDetail extension section does not set contributesToFormSubmit.";
@@ -59,6 +59,26 @@ export const PROJECTION_DETAIL_RULES = {
59
59
  summary: "A header.subtitle part navigate names a screen or an entity.",
60
60
  fix: "Set screen or entity on the part's navigate.",
61
61
  },
62
+ guidanceFieldEmpty: {
63
+ id: "projection-detail/guidance-field-empty",
64
+ summary: "The field names of breadcrumb, summary, banner, steps and progress are non-empty strings.",
65
+ fix: "Name a query output field or remove the block.",
66
+ },
67
+ progressBesideStepsWithoutSteps: {
68
+ id: "projection-detail/progress-beside-steps-without-steps",
69
+ summary: 'progress.placement "beside-steps" needs a steps block to sit next to.',
70
+ fix: "Add steps to the projectionDetail or remove progress.placement.",
71
+ },
72
+ stepsNarrowLimitInvalid: {
73
+ id: "projection-detail/steps-narrow-limit-invalid",
74
+ summary: "steps.narrowLimit is a positive integer.",
75
+ fix: "Set narrowLimit to a whole number of at least 1 or remove it.",
76
+ },
77
+ guidanceActionShowOnTabs: {
78
+ id: "projection-detail/guidance-action-show-on-tabs",
79
+ summary: "Banner and steps actions set no showOnTabs.",
80
+ fix: "Remove showOnTabs.",
81
+ },
62
82
  extensionContributesToFormSubmit: {
63
83
  id: "projection-detail/extension-contributes-to-form-submit",
64
84
  summary: "A projectionDetail extension section does not set contributesToFormSubmit.",
@@ -3,6 +3,7 @@ import { isExtensionEditSection, isFieldsEditSection, isWriteFormEditSection, no
3
3
  import { bootRuleError } from "./boot-rule.js";
4
4
  import { assertWriteHandlerRegistered, resolveRowActionNavigateTarget, validateActionHasIcon, validatePrimaryActionTarget, } from "./screens-actions.js";
5
5
  import { rejectWriteOnlyFormField, validateFieldsXorGroups, validateFormSelectOptions, validateTabSections, } from "./screens-forms.js";
6
+ import { validateProjectionDetailGuidance } from "./screens-kind-projection-detail-guidance.js";
6
7
  import { PROJECTION_DETAIL_RULES } from "./screens-kind-projection-detail-rules.js";
7
8
  import { assertExtensionSectionHasComponent, editSectionLabel, listActionContext, navigateActionFromLink, rejectEmptySections, rejectMissingQuery, validateRecordHeaderAction, validateRecordSectionActions, } from "./screens-kind-shared.js";
8
9
  import { assertRefTargetRegistered, validateListActionTargets, validateRelatedListSection, } from "./screens-lists.js";
@@ -297,4 +298,5 @@ export function validateProjectionDetailScreen(ctx, screenId, screen) {
297
298
  validateRecordHeaderAction(ctx, screenId, "projectionDetail", screen.detailFor, action);
298
299
  validateHeaderActionShowOnTabs(featureName, screenId, screen, action);
299
300
  }
301
+ validateProjectionDetailGuidance(ctx, screenId, screen);
300
302
  }
@@ -1,6 +1,8 @@
1
1
  import { normalizeListColumn } from "../screen-helpers.js";
2
2
  import { validateListBulkActions } from "./list-bulk-actions.js";
3
+ import { validateListRowGuidance } from "./list-row-guidance.js";
3
4
  import { validateListTableOptions } from "./list-table-options.js";
5
+ import { validateListToolbarOptions } from "./list-toolbar-options.js";
4
6
  import { assertWriteHandlerRegistered, resolveRowActionNavigateTarget, validateAtMostOneRowClick, validateDrawerTargetAction, } from "./screens-actions.js";
5
7
  import { validateDashboardPanelVisibleWhen } from "./screens-dashboard.js";
6
8
  import { listActionContext, rejectEmptyColumns, rejectMissingQuery, rejectNonArrayInFilter, validateListColumnRendering, } from "./screens-kind-shared.js";
@@ -38,7 +40,9 @@ export function validateProjectionListScreen(ctx, screenId, screen) {
38
40
  for (const col of screen.columns) {
39
41
  validateListColumnRendering(ctx, screenId, "projectionList", normalizeListColumn(col));
40
42
  }
43
+ validateListRowGuidance(featureName, screenId, "projectionList", screen);
41
44
  validateListTableOptions(`[Feature ${featureName}] Screen "${screenId}" (projectionList)`, screen.table, screen.columns, true);
45
+ validateListToolbarOptions(`[Feature ${featureName}] Screen "${screenId}" (projectionList)`, screen);
42
46
  // Screen filter: field existence can't be checked without an entity (columns
43
47
  // aren't a complete field inventory of the underlying query), so only the
44
48
  // structure is pinned: "in" requires an array.
@@ -69,6 +69,31 @@ export declare const SCREEN_KIND_RULES: {
69
69
  readonly summary: "createScreen resolves to a registered screen in the same feature.";
70
70
  readonly fix: "Point createScreen at a screen of this feature.";
71
71
  };
72
+ readonly createPlacementWithoutCreate: {
73
+ readonly id: "entity-list/create-placement-without-create";
74
+ readonly summary: 'createPlacement "toolbar" moves the create button, so the list has one (no allowCreate: false).';
75
+ readonly fix: "Remove createPlacement or drop allowCreate: false.";
76
+ };
77
+ readonly toolbarSortWithoutSortOptions: {
78
+ readonly id: "entity-list/toolbar-sort-without-sort-options";
79
+ readonly summary: "toolbarSort draws the sortOptions as a select in the filter row, so it needs sortOptions.";
80
+ readonly fix: "Declare sortOptions or remove toolbarSort.";
81
+ };
82
+ readonly narrowFacetsInvalid: {
83
+ readonly id: "list/narrow-facets-invalid";
84
+ readonly summary: 'narrowFacets is "pills".';
85
+ readonly fix: 'Use "pills", or remove narrowFacets.';
86
+ };
87
+ readonly toolbarActionsPlacementInvalid: {
88
+ readonly id: "list/toolbar-actions-placement-invalid";
89
+ readonly summary: 'toolbarActionsPlacement is "header" or "toolbar".';
90
+ readonly fix: 'Use "header" or "toolbar", or remove toolbarActionsPlacement.';
91
+ };
92
+ readonly toolbarActionsPlacementWithoutActions: {
93
+ readonly id: "list/toolbar-actions-placement-without-actions";
94
+ readonly summary: 'toolbarActionsPlacement "toolbar" moves the toolbarActions, so the list declares some.';
95
+ readonly fix: "Declare toolbarActions or remove toolbarActionsPlacement.";
96
+ };
72
97
  readonly configEditFieldsEmpty: {
73
98
  readonly id: "config-edit/fields-empty";
74
99
  readonly summary: "A configEdit screen declares at least one field.";