@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,36 @@
1
+ import { bootRuleError } from "./boot-rule.js";
2
+ import { declaredNamedFilterIds, resolveDashboardScreenTarget } from "./dashboard-screen-target.js";
3
+ import { validateNavigateParams } from "./dashboard-stat-navigate.js";
4
+ import { DASHBOARD_RULES } from "./screens-dashboard-rules.js";
5
+ // A rowLink naming its target per row (screenField) has nothing to resolve at boot.
6
+ export function validateListRowLinkTarget(where, rowLink, featureName, featureMap) {
7
+ if (rowLink?.screen === undefined)
8
+ return;
9
+ validateDashboardPanelLink(where, { screen: rowLink.screen }, featureName, featureMap);
10
+ }
11
+ // `where` names the option ("... list-panel "x" footerLink") so the one rule reads right for
12
+ // both the list footer and the stat-group link.
13
+ export function validateDashboardPanelLink(where, link, featureName, featureMap) {
14
+ // skip: the panel declares no link
15
+ if (link === undefined)
16
+ return;
17
+ validateNavigateParams(where, link.params);
18
+ const resolved = resolveDashboardScreenTarget(featureName, link.screen, featureMap);
19
+ if (resolved.kind === "unresolved") {
20
+ throw bootRuleError(DASHBOARD_RULES.panelLinkTarget, {
21
+ message: `${where} screen "${link.screen}" does not resolve to a registered screen (checked "${resolved.qn}"). Use a same-feature short id or a cross-feature QN "<feature>:screen:<id>".`,
22
+ });
23
+ }
24
+ if (link.namedFilter === undefined)
25
+ return;
26
+ if (resolved.kind !== "list") {
27
+ throw bootRuleError(DASHBOARD_RULES.panelLinkTarget, {
28
+ message: `${where} sets namedFilter "${link.namedFilter}" but screen "${resolved.screenId}" is not a list screen. Remove namedFilter.`,
29
+ });
30
+ }
31
+ if (!declaredNamedFilterIds(resolved.target).has(link.namedFilter)) {
32
+ throw bootRuleError(DASHBOARD_RULES.panelLinkTarget, {
33
+ message: `${where} namedFilter "${link.namedFilter}" is not declared in namedFilters of screen "${resolved.target.screen.id}". Add { id, label } to that screen.`,
34
+ });
35
+ }
36
+ }
@@ -0,0 +1,4 @@
1
+ import type { DashboardListPanel, DashboardPanelDefinition } from "../types/screen.ts";
2
+ /** The screen itself is checked by validateDashboardPanelLink; this covers the rest of the shape. */
3
+ export declare function validateListRowLinkShape(context: string, panel: DashboardListPanel): void;
4
+ export declare function validateDashboardPanelNarrow(featureName: string, screenId: string, panel: DashboardPanelDefinition): void;
@@ -0,0 +1,211 @@
1
+ import { normalizeListColumn } from "../screen-helpers.js";
2
+ import { bootRuleError } from "./boot-rule.js";
3
+ import { DASHBOARD_RULES } from "./screens-dashboard-rules.js";
4
+ import { isSelectOptionTone } from "./select-option-tone.js";
5
+ const STAT_GROUP_COLUMN_COUNTS = [2, 3, 4];
6
+ const LIST_NARROW_LAYOUTS = ["cards", "line"];
7
+ const ROW_TONE_MARKERS = ["bar", "dot"];
8
+ function validateListNarrowTexts(context, panel, narrow) {
9
+ if (narrow.titleField !== undefined) {
10
+ const hasHintColumn = panel.columns.some((column) => normalizeListColumn(column).hint !== undefined);
11
+ if (narrow.layout === "line" || !hasHintColumn || narrow.titleField.trim().length === 0) {
12
+ throw bootRuleError(DASHBOARD_RULES.listNarrowFieldUnknown, {
13
+ message: `${context} sets narrow.titleField "${narrow.titleField}", which needs a non-empty field name, the "cards" layout and a hint column whose sentence it replaces.`,
14
+ });
15
+ }
16
+ }
17
+ if (narrow.moreText !== undefined &&
18
+ (narrow.layout !== "line" || narrow.moreText.trim().length === 0)) {
19
+ throw bootRuleError(DASHBOARD_RULES.listNarrowInvalid, {
20
+ message: `${context} sets narrow.moreText, which needs a non-empty i18n key and narrow.layout "line" (the only layout that draws it).`,
21
+ });
22
+ }
23
+ }
24
+ function validateListLook(context, panel) {
25
+ if (panel.icon !== undefined && panel.narrow?.layout !== "line") {
26
+ throw bootRuleError(DASHBOARD_RULES.listNarrowInvalid, {
27
+ message: `${context} sets icon, which only the narrow.layout "line" draws. Set narrow.layout "line" or remove icon.`,
28
+ });
29
+ }
30
+ if (panel.footerLink?.narrowOnly === true && panel.narrow?.layout !== "line") {
31
+ throw bootRuleError(DASHBOARD_RULES.listNarrowInvalid, {
32
+ message: `${context} sets footerLink.narrowOnly, which only serves the narrow.layout "line". Set narrow.layout "line" or remove narrowOnly (the footer link would never be drawn).`,
33
+ });
34
+ }
35
+ if (panel.rowToneMarker !== undefined && !ROW_TONE_MARKERS.includes(panel.rowToneMarker)) {
36
+ throw bootRuleError(DASHBOARD_RULES.listRowToneMarkerInvalid, {
37
+ message: `${context} rowToneMarker "${String(panel.rowToneMarker)}" is not "bar" or "dot".`,
38
+ });
39
+ }
40
+ }
41
+ function validateListNarrow(context, panel) {
42
+ const { narrow } = panel;
43
+ validateListLook(context, panel);
44
+ // skip: the list keeps its table on a phone
45
+ if (narrow === undefined)
46
+ return;
47
+ if (narrow.limit !== undefined && (!Number.isInteger(narrow.limit) || narrow.limit < 1)) {
48
+ throw bootRuleError(DASHBOARD_RULES.listNarrowInvalid, {
49
+ message: `${context} narrow.limit "${String(narrow.limit)}" is not a positive integer. Set it to a whole number of at least 1.`,
50
+ });
51
+ }
52
+ if (narrow.layout !== undefined && !LIST_NARROW_LAYOUTS.includes(narrow.layout)) {
53
+ throw bootRuleError(DASHBOARD_RULES.listNarrowInvalid, {
54
+ message: `${context} narrow.layout "${String(narrow.layout)}" is not "cards" or "line".`,
55
+ });
56
+ }
57
+ if (narrow.field !== undefined) {
58
+ if (narrow.layout !== "line" || narrow.field.trim().length === 0) {
59
+ throw bootRuleError(DASHBOARD_RULES.listNarrowFieldUnknown, {
60
+ message: `${context} sets narrow.field "${narrow.field}", which needs narrow.layout "line" and a non-empty name of a field of the query output.`,
61
+ });
62
+ }
63
+ }
64
+ validateListNarrowTexts(context, panel, narrow);
65
+ if (narrow.layout === "line" && panel.footerLink === undefined) {
66
+ throw bootRuleError(DASHBOARD_RULES.listNarrowLineWithoutFooterLink, {
67
+ message: `${context} sets narrow.layout "line" without footerLink — the line links to it. Add footerLink or use "cards".`,
68
+ });
69
+ }
70
+ }
71
+ const ROW_LINK_ICONS = ["arrow", "chevron"];
72
+ /** The screen itself is checked by validateDashboardPanelLink; this covers the rest of the shape. */
73
+ export function validateListRowLinkShape(context, panel) {
74
+ const { rowLink } = panel;
75
+ // skip: the rows are not links
76
+ if (rowLink === undefined)
77
+ return;
78
+ if ((rowLink.screen === undefined) === (rowLink.screenField === undefined)) {
79
+ throw bootRuleError(DASHBOARD_RULES.listRowLinkInvalid, {
80
+ message: `${context} rowLink sets ${rowLink.screen === undefined ? "neither screen nor screenField" : "both screen and screenField"}. Name one target screen with screen, or the row field holding it with screenField.`,
81
+ });
82
+ }
83
+ if (rowLink.screen !== undefined && rowLink.paramsField !== undefined) {
84
+ throw bootRuleError(DASHBOARD_RULES.listRowLinkInvalid, {
85
+ message: `${context} rowLink combines screen with paramsField. Use paramField with screen, paramsField with screenField.`,
86
+ });
87
+ }
88
+ if (rowLink.screenField !== undefined && rowLink.paramField !== undefined) {
89
+ throw bootRuleError(DASHBOARD_RULES.listRowLinkInvalid, {
90
+ message: `${context} rowLink combines screenField with paramField. Use paramsField with screenField, paramField with screen.`,
91
+ });
92
+ }
93
+ for (const [option, field] of [
94
+ ["paramField", rowLink.paramField],
95
+ ["screenField", rowLink.screenField],
96
+ ["paramsField", rowLink.paramsField],
97
+ ]) {
98
+ if (field !== undefined && field.trim().length === 0) {
99
+ throw bootRuleError(DASHBOARD_RULES.listRowLinkInvalid, {
100
+ message: `${context} rowLink.${option} is empty. Name the row field or remove it.`,
101
+ });
102
+ }
103
+ }
104
+ if (rowLink.icon !== undefined && !ROW_LINK_ICONS.includes(rowLink.icon)) {
105
+ throw bootRuleError(DASHBOARD_RULES.listRowLinkInvalid, {
106
+ message: `${context} rowLink.icon "${String(rowLink.icon)}" is not "arrow" or "chevron".`,
107
+ });
108
+ }
109
+ }
110
+ // "strip" is the default only without a label; a labelled group defaults to "cards".
111
+ function isTitledStrip(panel) {
112
+ return panel.label !== undefined && panel.layout === "strip";
113
+ }
114
+ function validateStatGroupChildren(context, panel) {
115
+ for (const stat of panel.stats) {
116
+ if (stat.narrowLabel !== undefined && !isTitledStrip(panel)) {
117
+ throw bootRuleError(DASHBOARD_RULES.statNarrowLabelOutsideGroup, {
118
+ message: `${context} child "${stat.id}" sets narrowLabel, but only the one-line phone strip of a titled group with layout "strip" draws it. Give the group a label and layout "strip", or remove narrowLabel.`,
119
+ });
120
+ }
121
+ if (stat.hideOnNarrow !== undefined) {
122
+ throw bootRuleError(DASHBOARD_RULES.statGroupChildHideOnNarrow, {
123
+ message: `${context} child "${stat.id}" sets hideOnNarrow — set it on the whole group instead; a hidden cell would leave a gap.`,
124
+ });
125
+ }
126
+ if (stat.narrowOrder !== undefined) {
127
+ throw bootRuleError(DASHBOARD_RULES.narrowOrderInvalid, {
128
+ message: `${context} child "${stat.id}" sets narrowOrder — set it on the whole group instead.`,
129
+ });
130
+ }
131
+ if (stat.narrowLabel !== undefined && stat.narrowLabel.trim().length === 0) {
132
+ throw bootRuleError(DASHBOARD_RULES.statNarrowLabelOutsideGroup, {
133
+ message: `${context} child "${stat.id}" sets an empty narrowLabel. Name an i18n key or remove it.`,
134
+ });
135
+ }
136
+ }
137
+ }
138
+ function validateStatGroupNarrow(context, panel) {
139
+ validateStatGroupChildren(context, panel);
140
+ if (panel.icon !== undefined && !isTitledStrip(panel)) {
141
+ throw bootRuleError(DASHBOARD_RULES.statGroupIconWithoutTitledStrip, {
142
+ message: `${context} sets icon without a label or with layout "cards" — only the titled strip draws it. Add a label and layout "strip", or remove icon.`,
143
+ });
144
+ }
145
+ if (panel.narrow !== undefined && !isTitledStrip(panel)) {
146
+ throw bootRuleError(DASHBOARD_RULES.statGroupNarrowWithoutTitledStrip, {
147
+ message: `${context} sets narrow without a label or with layout "cards" — only the titled strip has a phone line to tint. Add a label and layout "strip", or remove narrow.`,
148
+ });
149
+ }
150
+ if (panel.narrow?.tone !== undefined && !isSelectOptionTone(panel.narrow.tone)) {
151
+ throw bootRuleError(DASHBOARD_RULES.statGroupNarrowToneInvalid, {
152
+ message: `${context} narrow.tone "${String(panel.narrow.tone)}" is not a select option tone.`,
153
+ });
154
+ }
155
+ // skip: no column count declared
156
+ if (panel.columns === undefined)
157
+ return;
158
+ if (!STAT_GROUP_COLUMN_COUNTS.includes(panel.columns)) {
159
+ throw bootRuleError(DASHBOARD_RULES.statGroupColumnsInvalid, {
160
+ message: `${context} columns "${String(panel.columns)}" is not 2, 3 or 4.`,
161
+ });
162
+ }
163
+ const layout = panel.layout ?? (panel.label === undefined ? "strip" : "cards");
164
+ if (layout !== "cards") {
165
+ throw bootRuleError(DASHBOARD_RULES.statGroupColumnsInvalid, {
166
+ message: `${context} sets columns on a "strip" group — columns only lays out layout "cards". Give the group a label or layout: "cards", or remove columns.`,
167
+ });
168
+ }
169
+ }
170
+ function validateTextNarrow(context, panel) {
171
+ // skip: no narrow variant
172
+ if (panel.narrowBlocks === undefined)
173
+ return;
174
+ if (panel.narrowBlocks.length === 0 || (panel.blocks ?? []).length === 0) {
175
+ throw bootRuleError(DASHBOARD_RULES.textNarrowBlocksWithoutBlocks, {
176
+ message: `${context} sets narrowBlocks without blocks, or an empty narrowBlocks. Declare blocks (shown from sm up) and at least one narrow block, or remove narrowBlocks.`,
177
+ });
178
+ }
179
+ }
180
+ function validateStatNarrowLabel(context, panel) {
181
+ if (panel.narrowLabel !== undefined) {
182
+ throw bootRuleError(DASHBOARD_RULES.statNarrowLabelOutsideGroup, {
183
+ message: `${context} sets narrowLabel outside a stat-group — only the one-line phone strip of a titled stat-group draws it. Move the stat into a group or remove narrowLabel.`,
184
+ });
185
+ }
186
+ }
187
+ function validateNarrowOrder(context, panel) {
188
+ const { narrowOrder } = panel;
189
+ // skip: declared order
190
+ if (narrowOrder === undefined)
191
+ return;
192
+ if (!Number.isInteger(narrowOrder) || narrowOrder < 0) {
193
+ throw bootRuleError(DASHBOARD_RULES.narrowOrderInvalid, {
194
+ message: `${context} narrowOrder "${String(narrowOrder)}" is not an integer of at least 0.`,
195
+ });
196
+ }
197
+ }
198
+ // Phone-layout options per panel kind; `hideOnNarrow` itself is a plain flag with no cross-field rule.
199
+ export function validateDashboardPanelNarrow(featureName, screenId, panel) {
200
+ const prefix = `[Feature ${featureName}] Screen "${screenId}" (dashboard)`;
201
+ validateNarrowOrder(`${prefix} panel "${panel.id}"`, panel);
202
+ if (panel.kind === "stat")
203
+ validateStatNarrowLabel(`${prefix} stat "${panel.id}"`, panel);
204
+ if (panel.kind === "list")
205
+ validateListNarrow(`${prefix} list-panel "${panel.id}"`, panel);
206
+ else if (panel.kind === "stat-group") {
207
+ validateStatGroupNarrow(`${prefix} stat-group "${panel.id}"`, panel);
208
+ }
209
+ else if (panel.kind === "text")
210
+ validateTextNarrow(`${prefix} text-panel "${panel.id}"`, panel);
211
+ }
@@ -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);