@cosmicdrift/kumiko-framework 0.405.0 → 0.409.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 (214) hide show
  1. package/agents/api/framework-db.md +1 -0
  2. package/agents/api/framework-engine.md +18 -2
  3. package/agents/api/framework-ui-types.md +15 -0
  4. package/agents/api/renderer-web.md +156 -2
  5. package/agents/api/types.md +113 -71
  6. package/agents/api.md +4 -4
  7. package/agents/boot-rules.md +743 -0
  8. package/agents/examples/contact.md +167 -0
  9. package/agents/examples/delivery-notifications.md +34 -1
  10. package/agents/examples/lane-routing.md +13 -0
  11. package/agents/examples/record-detail-layout.md +13 -2
  12. package/agents/examples/search.md +65 -3
  13. package/agents/examples/secrets-demo.md +96 -2
  14. package/agents/examples/tenant-inactivity.md +138 -0
  15. package/agents/examples.md +2 -0
  16. package/agents/features-index.md +4 -0
  17. package/agents/features.md +24 -1
  18. package/agents/widgets.md +12 -1
  19. package/dist/api/export/export-rows.js +1 -0
  20. package/dist/compliance/index.d.ts +1 -1
  21. package/dist/db/event-store-executor-read-where.js +15 -5
  22. package/dist/db/index.d.ts +1 -1
  23. package/dist/db/index.js +1 -1
  24. package/dist/db/migrate-generator.js +3 -1
  25. package/dist/db/queries/event-consumer.js +11 -7
  26. package/dist/db/queries/event-store.d.ts +2 -1
  27. package/dist/db/queries/event-store.js +25 -6
  28. package/dist/db/queries/rls-boot-catalog.js +3 -1
  29. package/dist/db/queries/session-advisory-lock.d.ts +7 -0
  30. package/dist/db/queries/session-advisory-lock.js +23 -0
  31. package/dist/db/query.js +7 -10
  32. package/dist/db/row-level-security-connection.js +4 -2
  33. package/dist/engine/active-membership.js +1 -0
  34. package/dist/engine/boot-validator/access-declarations.js +57 -33
  35. package/dist/engine/boot-validator/action-wiring.js +8 -6
  36. package/dist/engine/boot-validator/agent-effect-rules.d.ts +12 -0
  37. package/dist/engine/boot-validator/agent-effect-rules.js +12 -0
  38. package/dist/engine/boot-validator/agent-effect.d.ts +2 -0
  39. package/dist/engine/boot-validator/agent-effect.js +20 -0
  40. package/dist/engine/boot-validator/boot-context.js +5 -1
  41. package/dist/engine/boot-validator/boot-environment-rules.d.ts +12 -0
  42. package/dist/engine/boot-validator/boot-environment-rules.js +12 -0
  43. package/dist/engine/boot-validator/boot-phases-app.js +5 -1
  44. package/dist/engine/boot-validator/boot-phases.js +3 -1
  45. package/dist/engine/boot-validator/boot-rules.d.ts +2619 -0
  46. package/dist/engine/boot-validator/boot-rules.js +58 -0
  47. package/dist/engine/boot-validator/bundled-lists-table.js +23 -9
  48. package/dist/engine/boot-validator/config-deps.js +71 -23
  49. package/dist/engine/boot-validator/config-edit-action-rules.d.ts +17 -0
  50. package/dist/engine/boot-validator/config-edit-action-rules.js +17 -0
  51. package/dist/engine/boot-validator/config-key-rules.d.ts +117 -0
  52. package/dist/engine/boot-validator/config-key-rules.js +117 -0
  53. package/dist/engine/boot-validator/custom-screen-write-qns.js +6 -2
  54. package/dist/engine/boot-validator/derived-sql-fields-rules.d.ts +77 -0
  55. package/dist/engine/boot-validator/derived-sql-fields-rules.js +77 -0
  56. package/dist/engine/boot-validator/derived-sql-fields.js +53 -17
  57. package/dist/engine/boot-validator/detail-screens.js +10 -4
  58. package/dist/engine/boot-validator/entity-declaration-rules.d.ts +92 -0
  59. package/dist/engine/boot-validator/entity-declaration-rules.js +92 -0
  60. package/dist/engine/boot-validator/entity-handler-access-rules.d.ts +102 -0
  61. package/dist/engine/boot-validator/entity-handler-access-rules.js +102 -0
  62. package/dist/engine/boot-validator/entity-handler.d.ts +0 -7
  63. package/dist/engine/boot-validator/entity-handler.js +259 -355
  64. package/dist/engine/boot-validator/entity-image-variants.d.ts +2 -0
  65. package/dist/engine/boot-validator/entity-image-variants.js +91 -0
  66. package/dist/engine/boot-validator/entity-list-aggregate-options.js +8 -2
  67. package/dist/engine/boot-validator/entity-reference-embedded-rules.d.ts +117 -0
  68. package/dist/engine/boot-validator/entity-reference-embedded-rules.js +117 -0
  69. package/dist/engine/boot-validator/entity-select-image-rules.d.ts +122 -0
  70. package/dist/engine/boot-validator/entity-select-image-rules.js +122 -0
  71. package/dist/engine/boot-validator/entity-select.d.ts +8 -0
  72. package/dist/engine/boot-validator/entity-select.js +197 -0
  73. package/dist/engine/boot-validator/entity-structure-rules.d.ts +107 -0
  74. package/dist/engine/boot-validator/entity-structure-rules.js +107 -0
  75. package/dist/engine/boot-validator/field-conditions-rules.d.ts +92 -0
  76. package/dist/engine/boot-validator/field-conditions-rules.js +92 -0
  77. package/dist/engine/boot-validator/field-conditions.js +67 -22
  78. package/dist/engine/boot-validator/form-derivations-rules.d.ts +77 -0
  79. package/dist/engine/boot-validator/form-derivations-rules.js +77 -0
  80. package/dist/engine/boot-validator/form-derivations.js +52 -18
  81. package/dist/engine/boot-validator/global-tenancy.js +13 -7
  82. package/dist/engine/boot-validator/handler-declaration-rules.d.ts +72 -0
  83. package/dist/engine/boot-validator/handler-declaration-rules.js +72 -0
  84. package/dist/engine/boot-validator/handler-field-references-rules.d.ts +22 -0
  85. package/dist/engine/boot-validator/handler-field-references-rules.js +22 -0
  86. package/dist/engine/boot-validator/handler-field-references.js +14 -6
  87. package/dist/engine/boot-validator/list-bulk-actions-rules.d.ts +42 -0
  88. package/dist/engine/boot-validator/list-bulk-actions-rules.js +42 -0
  89. package/dist/engine/boot-validator/list-bulk-actions.js +29 -11
  90. package/dist/engine/boot-validator/list-column-layout.js +22 -10
  91. package/dist/engine/boot-validator/list-query-rules.d.ts +107 -0
  92. package/dist/engine/boot-validator/list-query-rules.js +107 -0
  93. package/dist/engine/boot-validator/list-table-aggregate-options.js +43 -15
  94. package/dist/engine/boot-validator/list-table-aggregate-query.js +7 -3
  95. package/dist/engine/boot-validator/list-table-aggregate-rules.d.ts +82 -0
  96. package/dist/engine/boot-validator/list-table-aggregate-rules.js +82 -0
  97. package/dist/engine/boot-validator/list-table-export-options.js +19 -7
  98. package/dist/engine/boot-validator/list-table-options.js +33 -13
  99. package/dist/engine/boot-validator/list-table-reject-unknown-keys.js +6 -2
  100. package/dist/engine/boot-validator/list-table-rules.d.ts +132 -0
  101. package/dist/engine/boot-validator/list-table-rules.js +132 -0
  102. package/dist/engine/boot-validator/nav-rules.d.ts +42 -0
  103. package/dist/engine/boot-validator/nav-rules.js +42 -0
  104. package/dist/engine/boot-validator/nav.js +29 -15
  105. package/dist/engine/boot-validator/ownership-rules.d.ts +27 -0
  106. package/dist/engine/boot-validator/ownership-rules.js +27 -0
  107. package/dist/engine/boot-validator/ownership.js +28 -12
  108. package/dist/engine/boot-validator/parent-ref.js +32 -20
  109. package/dist/engine/boot-validator/projection-list-screens.js +76 -35
  110. package/dist/engine/boot-validator/query-output-columns.js +9 -3
  111. package/dist/engine/boot-validator/query-refs.js +20 -10
  112. package/dist/engine/boot-validator/query-rules.d.ts +37 -0
  113. package/dist/engine/boot-validator/query-rules.js +37 -0
  114. package/dist/engine/boot-validator/read-gate.js +14 -10
  115. package/dist/engine/boot-validator/record-owned.js +5 -1
  116. package/dist/engine/boot-validator/related-list-table-rules.js +17 -7
  117. package/dist/engine/boot-validator/screens-actions-rules.d.ts +185 -0
  118. package/dist/engine/boot-validator/screens-actions-rules.js +185 -0
  119. package/dist/engine/boot-validator/screens-actions.js +169 -93
  120. package/dist/engine/boot-validator/screens-dashboard-chart-rules.d.ts +87 -0
  121. package/dist/engine/boot-validator/screens-dashboard-chart-rules.js +87 -0
  122. package/dist/engine/boot-validator/screens-dashboard-rules.d.ts +227 -0
  123. package/dist/engine/boot-validator/screens-dashboard-rules.js +227 -0
  124. package/dist/engine/boot-validator/screens-dashboard.js +222 -85
  125. package/dist/engine/boot-validator/screens-forms-layout-rules.d.ts +122 -0
  126. package/dist/engine/boot-validator/screens-forms-layout-rules.js +122 -0
  127. package/dist/engine/boot-validator/screens-forms-rules.d.ts +152 -0
  128. package/dist/engine/boot-validator/screens-forms-rules.js +152 -0
  129. package/dist/engine/boot-validator/screens-forms.js +240 -112
  130. package/dist/engine/boot-validator/screens-kind-config-edit.js +72 -16
  131. package/dist/engine/boot-validator/screens-kind-entity-edit.js +15 -7
  132. package/dist/engine/boot-validator/screens-kind-entity-list.js +57 -32
  133. package/dist/engine/boot-validator/screens-kind-projection-detail-rules.d.ts +92 -0
  134. package/dist/engine/boot-validator/screens-kind-projection-detail-rules.js +92 -0
  135. package/dist/engine/boot-validator/screens-kind-projection-detail.js +85 -47
  136. package/dist/engine/boot-validator/screens-kind-rules.d.ts +137 -0
  137. package/dist/engine/boot-validator/screens-kind-rules.js +137 -0
  138. package/dist/engine/boot-validator/screens-kind-secret-mint.js +18 -8
  139. package/dist/engine/boot-validator/screens-kind-shared.js +40 -22
  140. package/dist/engine/boot-validator/screens-lists-rules.d.ts +82 -0
  141. package/dist/engine/boot-validator/screens-lists-rules.js +82 -0
  142. package/dist/engine/boot-validator/screens-lists.js +90 -45
  143. package/dist/engine/boot-validator/screens-rules.d.ts +57 -0
  144. package/dist/engine/boot-validator/screens-rules.js +57 -0
  145. package/dist/engine/boot-validator/screens.js +17 -12
  146. package/dist/engine/boot-validator/transaction-phases.js +12 -4
  147. package/dist/engine/boot-validator/transfer-graph.js +17 -11
  148. package/dist/engine/boot-validator/url-prefill-fields.js +9 -5
  149. package/dist/engine/boot-validator/workspaces.js +11 -5
  150. package/dist/engine/boot-validator/zod-shape.js +6 -2
  151. package/dist/engine/entity-handlers.d.ts +1 -0
  152. package/dist/engine/entity-handlers.js +3 -0
  153. package/dist/engine/entity-list-runtime-options.js +23 -29
  154. package/dist/engine/extensions/tenant-data.d.ts +3 -0
  155. package/dist/engine/extensions/tenant-resource.d.ts +1 -0
  156. package/dist/engine/factories.d.ts +1 -1
  157. package/dist/engine/factories.js +4 -3
  158. package/dist/engine/feature-config-events-jobs.js +7 -0
  159. package/dist/engine/index.d.ts +4 -2
  160. package/dist/engine/index.js +2 -0
  161. package/dist/engine/project-app-schema-for-roles.js +29 -14
  162. package/dist/engine/registry-facade.js +7 -8
  163. package/dist/engine/registry-validate.js +5 -1
  164. package/dist/engine/soft-delete-cleanup.d.ts +1 -0
  165. package/dist/engine/soft-delete-cleanup.js +5 -0
  166. package/dist/engine/steps/describe-workflow-step-error.js +1 -0
  167. package/dist/es-ops/operations-schema.d.ts +1 -1
  168. package/dist/event-store/ensure-dead-letter-table.d.ts +2 -0
  169. package/dist/event-store/ensure-dead-letter-table.js +10 -0
  170. package/dist/event-store/rebuild-dead-letter.js +2 -8
  171. package/dist/event-store/upcaster-dead-letter.js +2 -8
  172. package/dist/files/copy-pending-file-refs-to-tenant.d.ts +28 -0
  173. package/dist/files/copy-pending-file-refs-to-tenant.js +87 -0
  174. package/dist/files/file-routes.d.ts +1 -1
  175. package/dist/files/file-routes.js +21 -6
  176. package/dist/files/index.d.ts +2 -0
  177. package/dist/files/index.js +1 -0
  178. package/dist/i18n/required-surface-keys.js +1 -0
  179. package/dist/jobs/job-runner-helpers.js +1 -0
  180. package/dist/jobs/job-runner-schedulers.d.ts +2 -2
  181. package/dist/jobs/job-runner-schedulers.js +8 -4
  182. package/dist/jobs/job-runner.js +14 -16
  183. package/dist/logging/utils.js +30 -60
  184. package/dist/observability/metrics-handle.js +10 -21
  185. package/dist/pipeline/cascade-handler.js +7 -6
  186. package/dist/pipeline/dispatch-query.js +18 -5
  187. package/dist/pipeline/dispatch-shared.d.ts +1 -0
  188. package/dist/pipeline/dispatch-shared.js +3 -1
  189. package/dist/pipeline/dispatch-write.js +10 -12
  190. package/dist/pipeline/dispatcher.js +12 -14
  191. package/dist/pipeline/event-dispatcher-admin.js +9 -8
  192. package/dist/pipeline/event-dispatcher-delivery.d.ts +19 -1
  193. package/dist/pipeline/event-dispatcher-delivery.js +121 -29
  194. package/dist/pipeline/event-dispatcher.d.ts +5 -1
  195. package/dist/pipeline/event-dispatcher.js +28 -21
  196. package/dist/pipeline/handler-context-phase-denials.js +2 -0
  197. package/dist/pipeline/multi-stream-apply-context.js +12 -20
  198. package/dist/pipeline/system-hooks.d.ts +4 -1
  199. package/dist/pipeline/system-hooks.js +79 -6
  200. package/dist/pipeline/system-identity-switch.js +10 -7
  201. package/dist/search/build-search-snippet.d.ts +9 -0
  202. package/dist/search/build-search-snippet.js +40 -0
  203. package/dist/search/index.d.ts +1 -0
  204. package/dist/search/index.js +1 -0
  205. package/dist/search/meilisearch-adapter.d.ts +32 -0
  206. package/dist/search/meilisearch-adapter.js +153 -56
  207. package/dist/search/meilisearch-chunking.d.ts +21 -0
  208. package/dist/search/meilisearch-chunking.js +96 -0
  209. package/dist/search/reindex-entity.d.ts +1 -0
  210. package/dist/search/reindex-entity.js +97 -52
  211. package/dist/ui-types/index.d.ts +1 -1
  212. package/dist/upgrade-cli.js +3 -14
  213. package/package.json +3 -3
  214. package/src/changes.json +85 -0
@@ -210,6 +210,207 @@ export declare const FRAMEWORK_BOOT_RULE_TABLES: readonly [{
210
210
  readonly summary: "Every screen action resolves to a registered icon.";
211
211
  readonly fix: "Set icon to a registered NAV_ICONS key or use an action id that resolves one via the default icon map.";
212
212
  };
213
+ readonly rowClickAtMostOne: {
214
+ readonly id: "screen/row-click-at-most-one";
215
+ readonly summary: "At most one row-body click target (rowClick) is declared per list.";
216
+ readonly fix: "Mark at most one rowAction with rowClick: true.";
217
+ };
218
+ readonly navigateParamsDashboardNoReader: {
219
+ readonly id: "screen/navigate-params-dashboard-no-reader";
220
+ readonly summary: "A navigate action with params targets a dashboard that declares a filter, time range or record binding.";
221
+ readonly fix: "Remove the params extractor, or add a filter (or record binding) to the target dashboard.";
222
+ };
223
+ readonly navigateParamsDashboardKeyMismatch: {
224
+ readonly id: "screen/navigate-params-dashboard-key-mismatch";
225
+ readonly summary: "Navigate params extract at least one key the target dashboard reads (filter id, time range id or record param).";
226
+ readonly fix: "Fix the params extractor to produce one of the dashboard's read keys, or remove it.";
227
+ };
228
+ readonly navigateParamsTargetIgnoresParams: {
229
+ readonly id: "screen/navigate-params-target-ignores-params";
230
+ readonly summary: "Navigate params only target screens that read URL search params as initial values (actionForm, secretMint, entityEdit-create).";
231
+ readonly fix: "Remove the params extractor or retarget to an actionForm, secretMint or cross-entity entityEdit-create screen.";
232
+ };
233
+ readonly actionUnknownFieldRef: {
234
+ readonly id: "screen/action-unknown-field-ref";
235
+ readonly summary: "Action payload and params extractors reference existing entity fields.";
236
+ readonly fix: "Name a known field in the pick/map extractor.";
237
+ };
238
+ readonly actionVisibleUnknownField: {
239
+ readonly id: "screen/action-visible-unknown-field";
240
+ readonly summary: "An action's visible.field references an existing entity field.";
241
+ readonly fix: "Point visible.field at a known field.";
242
+ };
243
+ readonly actionEntityIdUnknownField: {
244
+ readonly id: "screen/action-entity-id-unknown-field";
245
+ readonly summary: "An action's entityId references an existing entity field or the id column.";
246
+ readonly fix: "Point entityId at a known field.";
247
+ };
248
+ readonly screenShortIdCollision: {
249
+ readonly id: "screen/short-id-collision";
250
+ readonly summary: "A screen short id is registered by at most one feature.";
251
+ readonly fix: "Give each screen a distinct id.";
252
+ };
253
+ readonly navTargetUnresolved: {
254
+ readonly id: "screen/nav-target-unresolved";
255
+ readonly summary: "A redirect, cancelTarget, success link or fallback resolves to a registered screen.";
256
+ readonly fix: "Use the id of a screen in this feature or a fully-qualified <feature>:screen:<id>.";
257
+ };
258
+ readonly drawerTargetUnresolved: {
259
+ readonly id: "screen/drawer-target-unresolved";
260
+ readonly summary: "A drawer action targets a registered screen of the same feature.";
261
+ readonly fix: "Point screen at a screen declared in the same feature.";
262
+ };
263
+ readonly drawerTargetNotActionForm: {
264
+ readonly id: "screen/drawer-target-not-action-form";
265
+ readonly summary: "A drawer action targets an actionForm screen.";
266
+ readonly fix: "Point screen at an actionForm screen, or use kind: navigate for a full-page target.";
267
+ };
268
+ readonly prefillParamUnknownField: {
269
+ readonly id: "screen/prefill-param-unknown-field";
270
+ readonly summary: "Prefill params only name fields the target form declares.";
271
+ readonly fix: "Name a field the target form declares, or remove the param.";
272
+ };
273
+ readonly prefillParamSensitiveField: {
274
+ readonly id: "screen/prefill-param-sensitive-field";
275
+ readonly summary: "Prefill params never name sensitive or password fields of the target form.";
276
+ readonly fix: "Remove the param or prefill a non-sensitive field.";
277
+ };
278
+ readonly prefillParamNotRendered: {
279
+ readonly id: "screen/prefill-param-not-rendered";
280
+ readonly summary: "Prefill params only name fields the target form renders in its layout.";
281
+ readonly fix: "Add the field to the target layout or remove the param.";
282
+ };
283
+ readonly navigateTabTargetUnresolved: {
284
+ readonly id: "screen/navigate-tab-target-unresolved";
285
+ readonly summary: "A navigate action with tab has a navigate-target that resolves to a screen.";
286
+ readonly fix: "Point the navigate-target at a registered screen.";
287
+ };
288
+ readonly navigateTabTargetNotTabbed: {
289
+ readonly id: "screen/navigate-tab-target-not-tabbed";
290
+ readonly summary: "A navigate tab targets a projectionDetail screen with layout.mode tabs.";
291
+ readonly fix: "Remove the tab or navigate to a projectionDetail screen with layout.mode tabs.";
292
+ };
293
+ readonly navigateTabUnknownSection: {
294
+ readonly id: "screen/navigate-tab-unknown-section";
295
+ readonly summary: "A navigate tab names a section id of the target screen.";
296
+ readonly fix: "Use one of the target screen's section ids.";
297
+ };
298
+ readonly navigateTargetScreenAndEntity: {
299
+ readonly id: "screen/navigate-target-screen-and-entity";
300
+ readonly summary: "A navigate action sets either screen or entity, not both.";
301
+ readonly fix: "Remove one of screen and entity.";
302
+ };
303
+ readonly navigateEntityTargetNeedsEntityId: {
304
+ readonly id: "screen/navigate-entity-target-needs-entity-id";
305
+ readonly summary: "An entity navigate-target on a non-entityList screen sets an explicit entityId.";
306
+ readonly fix: "Set entityId on the navigate action.";
307
+ };
308
+ readonly navigateEntityTargetNoDetail: {
309
+ readonly id: "screen/navigate-entity-target-no-detail";
310
+ readonly summary: "An entity navigate-target has a screen declaring detailFor for that entity.";
311
+ readonly fix: "Add detailFor to a screen of the entity or navigate to a screen directly.";
312
+ };
313
+ readonly navigateTargetNeitherScreenNorEntity: {
314
+ readonly id: "screen/navigate-target-neither-screen-nor-entity";
315
+ readonly summary: "A navigate action sets exactly one of screen and entity.";
316
+ readonly fix: "Set screen or entity on the navigate action.";
317
+ };
318
+ readonly navigateTargetUnresolved: {
319
+ readonly id: "screen/navigate-target-unresolved";
320
+ readonly summary: "A navigate screen target resolves to a registered screen in any feature.";
321
+ readonly fix: 'Use "<feature>:screen:<id>" of an existing screen.';
322
+ };
323
+ readonly redirectIdFromEmpty: {
324
+ readonly id: "screen/redirect-id-from-empty";
325
+ readonly summary: "A redirect object's idFrom is a non-empty string.";
326
+ readonly fix: "Name the success-payload field carrying the navigation id, or use the plain string redirect.";
327
+ };
328
+ readonly redirectIdFromWhitespace: {
329
+ readonly id: "screen/redirect-id-from-whitespace";
330
+ readonly summary: "A redirect idFrom has no leading or trailing whitespace.";
331
+ readonly fix: "Remove the whitespace from idFrom.";
332
+ };
333
+ readonly redirectIdFromOnIdlessTarget: {
334
+ readonly id: "screen/redirect-id-from-on-idless-target";
335
+ readonly summary: "A redirect idFrom only targets entityEdit or projectionDetail screens.";
336
+ readonly fix: "Use the plain string redirect form.";
337
+ };
338
+ readonly successLinkTargetsRecordScreen: {
339
+ readonly id: "screen/success-link-targets-record-screen";
340
+ readonly summary: "A success link without idFrom does not target a record screen.";
341
+ readonly fix: "Set idFrom to the success-payload field carrying the record id.";
342
+ };
343
+ readonly clientActionName: {
344
+ readonly id: "screen/client-action-name";
345
+ readonly summary: "A clientAction names its handler as <feature>:<kebab-name>.";
346
+ readonly fix: 'Use a name like "auth-email-password:request-password-reset".';
347
+ };
348
+ readonly redirectOnListRowAction: {
349
+ readonly id: "screen/redirect-on-list-row-action";
350
+ readonly summary: "List and related-list row actions do not set redirect.";
351
+ readonly fix: "Remove redirect; it is only honored on record actions.";
352
+ };
353
+ readonly primaryActionUnknown: {
354
+ readonly id: "screen/primary-action-unknown";
355
+ readonly summary: "primaryAction and inlineActions name a declared action id or the default edit.";
356
+ readonly fix: 'Use a declared action id, or "edit" when the screen sets detailFor.';
357
+ };
358
+ readonly fallbackWithoutVisibleWhen: {
359
+ readonly id: "screen/fallback-without-visible-when";
360
+ readonly summary: "A screen with a fallback also declares visibleWhen.";
361
+ readonly fix: "Add visibleWhen or remove fallback.";
362
+ };
363
+ readonly visibleWhenEmpty: {
364
+ readonly id: "screen/visible-when-empty";
365
+ readonly summary: "visibleWhen has a non-empty query and field.";
366
+ readonly fix: "Set both visibleWhen.query and visibleWhen.field.";
367
+ };
368
+ readonly fallbackMapEmpty: {
369
+ readonly id: "screen/fallback-map-empty";
370
+ readonly summary: "A fallback map names at least one reason.";
371
+ readonly fix: "Set at least one fallback reason or use a screen id string.";
372
+ };
373
+ readonly fallbackUnknownReason: {
374
+ readonly id: "screen/fallback-unknown-reason";
375
+ readonly summary: "Fallback map keys are known fallback reasons.";
376
+ readonly fix: "Use only the documented fallback reasons.";
377
+ };
378
+ readonly fallbackSelf: {
379
+ readonly id: "screen/fallback-self";
380
+ readonly summary: "A screen's fallback points at a different screen.";
381
+ readonly fix: "Point fallback at a different screen.";
382
+ };
383
+ readonly fallbackHasVisibleWhen: {
384
+ readonly id: "screen/fallback-has-visible-when";
385
+ readonly summary: "A fallback target has no visibleWhen of its own.";
386
+ readonly fix: "Point fallback at a screen without visibleWhen.";
387
+ };
388
+ readonly writeHandlerUnregistered: {
389
+ readonly id: "screen/write-handler-unregistered";
390
+ readonly summary: "A handler reference resolves to a registered write handler.";
391
+ readonly fix: 'Check the QN spelling ("<feature>:write:<short>") and that r.writeHandler(...) declares it.';
392
+ };
393
+ readonly actionFormSuccessItemsRedirect: {
394
+ readonly id: "screen/action-form-success-items-redirect";
395
+ readonly summary: "An actionForm shows successItems or redirects after submit, not both.";
396
+ readonly fix: "Drop redirect to show the successItems on the screen, or drop successItems to leave it.";
397
+ };
398
+ }, {
399
+ readonly duplicateId: {
400
+ readonly id: "config-edit-action/duplicate-id";
401
+ readonly summary: "A configEdit screen declares each action id once.";
402
+ readonly fix: "Rename or remove the repeated action id.";
403
+ };
404
+ readonly unknownHandler: {
405
+ readonly id: "config-edit-action/unknown-handler";
406
+ readonly summary: "A configEdit action points at a registered write handler.";
407
+ readonly fix: 'Use the qualified write handler name "<feature>:write:<handler>" of a registered handler.';
408
+ };
409
+ readonly unknownAfterField: {
410
+ readonly id: "config-edit-action/unknown-after-field";
411
+ readonly summary: "A configEdit action sits after a field that is part of the layout.";
412
+ readonly fix: "Set afterField to a field name that appears in one of the layout sections.";
413
+ };
213
414
  }, {
214
415
  readonly unknownApi: {
215
416
  readonly id: "api/unknown-api";
@@ -242,5 +443,2423 @@ export declare const FRAMEWORK_BOOT_RULE_TABLES: readonly [{
242
443
  readonly summary: "A feature's r.bootCheck invariant holds for the mounted feature set.";
243
444
  readonly fix: "Satisfy the invariant named in the message or unmount the feature that declares it.";
244
445
  };
446
+ }, {
447
+ readonly emptyPanels: {
448
+ readonly id: "dashboard/empty-panels";
449
+ readonly summary: "A dashboard declares at least one panel.";
450
+ readonly fix: "Add a panel to panels.";
451
+ };
452
+ readonly duplicatePanelId: {
453
+ readonly id: "dashboard/duplicate-panel-id";
454
+ readonly summary: "Panel ids (including stat-group children) are unique within a dashboard.";
455
+ readonly fix: "Give each panel a unique id.";
456
+ };
457
+ readonly actionRowClick: {
458
+ readonly id: "dashboard/action-row-click";
459
+ readonly summary: "A dashboard action does not set rowClick.";
460
+ readonly fix: "Remove rowClick from the action.";
461
+ };
462
+ readonly actionDrawer: {
463
+ readonly id: "dashboard/action-drawer";
464
+ readonly summary: "A dashboard action is not a drawer action.";
465
+ readonly fix: "Use a navigate, writeHandler or clientAction action.";
466
+ };
467
+ readonly actionRedirect: {
468
+ readonly id: "dashboard/action-redirect";
469
+ readonly summary: "A dashboard writeHandler action does not set redirect.";
470
+ readonly fix: "Remove redirect from the action.";
471
+ };
472
+ readonly actionsWithoutRecord: {
473
+ readonly id: "dashboard/actions-without-record";
474
+ readonly summary: "A dashboard with actions declares a record binding.";
475
+ readonly fix: "Add record: { param } or remove actions.";
476
+ };
477
+ readonly recordParamEmpty: {
478
+ readonly id: "dashboard/record-param-empty";
479
+ readonly summary: "record.param is a non-empty string.";
480
+ readonly fix: "Name the URL search param carrying the record id.";
481
+ };
482
+ readonly recordPayloadKeyEmpty: {
483
+ readonly id: "dashboard/record-payload-key-empty";
484
+ readonly summary: "record.payloadKey is non-empty when set.";
485
+ readonly fix: "Omit payloadKey to reuse record.param, or name a key.";
486
+ };
487
+ readonly recordQueryEmpty: {
488
+ readonly id: "dashboard/record-query-empty";
489
+ readonly summary: "record.query is non-empty when set.";
490
+ readonly fix: "Set a registered query name or omit record.query.";
491
+ };
492
+ readonly recordTitleFieldUnusable: {
493
+ readonly id: "dashboard/record-title-field-unusable";
494
+ readonly summary: "record.titleField needs record.query and a non-empty field name.";
495
+ readonly fix: "Add record.query and name a field, or remove titleField.";
496
+ };
497
+ readonly recordParamCollision: {
498
+ readonly id: "dashboard/record-param-collision";
499
+ readonly summary: "record.param and payloadKey differ from the filter and timeRange ids.";
500
+ readonly fix: "Use a different name for the record param or the filter/timeRange id.";
501
+ };
502
+ readonly refreshSecondsAndField: {
503
+ readonly id: "dashboard/refresh-seconds-and-field";
504
+ readonly summary: "A dashboard refresh sets either seconds or field, not both.";
505
+ readonly fix: "Keep exactly one of seconds and field.";
506
+ };
507
+ readonly refreshSecondsTooShort: {
508
+ readonly id: "dashboard/refresh-seconds-too-short";
509
+ readonly summary: "refresh.seconds is a number of at least DASHBOARD_MIN_REFRESH_SECONDS.";
510
+ readonly fix: "Raise refresh.seconds to the minimum or more.";
511
+ };
512
+ readonly refreshFieldEmpty: {
513
+ readonly id: "dashboard/refresh-field-empty";
514
+ readonly summary: "refresh.field is non-empty.";
515
+ readonly fix: "Name the record field holding the seconds.";
516
+ };
517
+ readonly refreshFieldWithoutRecordQuery: {
518
+ readonly id: "dashboard/refresh-field-without-record-query";
519
+ readonly summary: "A field-driven refresh has a record.query to read the seconds from.";
520
+ readonly fix: "Add record: { param, query } or use refresh: { seconds }.";
521
+ };
522
+ readonly timeRangeIdEmpty: {
523
+ readonly id: "dashboard/time-range-id-empty";
524
+ readonly summary: "The dashboard timeRange has a non-empty id.";
525
+ readonly fix: "Set a non-empty timeRange.id.";
526
+ };
527
+ readonly timeRangeIdCollidesFilter: {
528
+ readonly id: "dashboard/time-range-id-collides-filter";
529
+ readonly summary: "The timeRange id differs from the filter id.";
530
+ readonly fix: "Use a timeRange.id different from the filter id.";
531
+ };
532
+ readonly timeRangeOptionsEmpty: {
533
+ readonly id: "dashboard/time-range-options-empty";
534
+ readonly summary: "The timeRange declares at least one option.";
535
+ readonly fix: "Add an option to timeRange.options.";
536
+ };
537
+ readonly timeRangeOptionIncomplete: {
538
+ readonly id: "dashboard/time-range-option-incomplete";
539
+ readonly summary: "Every timeRange option has a non-empty value and label.";
540
+ readonly fix: "Give every option a value and a label.";
541
+ };
542
+ readonly timeRangeOptionDuplicate: {
543
+ readonly id: "dashboard/time-range-option-duplicate";
544
+ readonly summary: "timeRange option values are unique.";
545
+ readonly fix: "Use each option value once.";
546
+ };
547
+ readonly timeRangeDefaultUnknown: {
548
+ readonly id: "dashboard/time-range-default-unknown";
549
+ readonly summary: "timeRange.default is one of the option values.";
550
+ readonly fix: "Set default to one of the options.";
551
+ };
552
+ readonly embeddedScreenUnresolved: {
553
+ readonly id: "dashboard/embedded-screen-unresolved";
554
+ readonly summary: "A screen panel's screen and fallback resolve to registered screens.";
555
+ readonly fix: 'Use a same-feature short id or a cross-feature QN "<feature>:screen:<id>".';
556
+ };
557
+ readonly embeddedScreenType: {
558
+ readonly id: "dashboard/embedded-screen-type";
559
+ readonly summary: "A screen panel embeds only an embeddable screen type.";
560
+ readonly fix: "Embed a projectionList, projectionDetail, actionForm, secretMint, configEdit or secretsEdit screen, or use a custom panel.";
561
+ };
562
+ readonly embeddedDetailWithoutRecord: {
563
+ readonly id: "dashboard/embedded-detail-without-record";
564
+ readonly summary: "Embedding a projectionDetail needs a record binding on the host dashboard.";
565
+ readonly fix: "Add record: { param } to the dashboard or embed another screen type.";
566
+ };
567
+ readonly embeddedFormNavigates: {
568
+ readonly id: "dashboard/embedded-form-navigates";
569
+ readonly summary: "An embedded actionForm or secretMint sets neither redirect nor a cancelTarget.";
570
+ readonly fix: "Embed a screen without redirect and with cancelTarget: false (or omitted).";
571
+ };
572
+ readonly panelFallbackWithoutVisibleWhen: {
573
+ readonly id: "dashboard/panel-fallback-without-visible-when";
574
+ readonly summary: "A screen panel with a fallback also declares visibleWhen.";
575
+ readonly fix: "Add visibleWhen or remove fallback.";
576
+ };
577
+ readonly panelFallbackGated: {
578
+ readonly id: "dashboard/panel-fallback-gated";
579
+ readonly summary: "A panel fallback screen has no visibleWhen of its own.";
580
+ readonly fix: "Embed a fallback screen without visibleWhen.";
581
+ };
582
+ readonly textPanelEmpty: {
583
+ readonly id: "dashboard/text-panel-empty";
584
+ readonly summary: "A text panel declares at least one block.";
585
+ readonly fix: "Add at least one block.";
586
+ };
587
+ readonly textListBlockEmpty: {
588
+ readonly id: "dashboard/text-list-block-empty";
589
+ readonly summary: "A text list block has items.";
590
+ readonly fix: "Add items or remove the block.";
591
+ };
592
+ readonly textLinkUnresolved: {
593
+ readonly id: "dashboard/text-link-unresolved";
594
+ readonly summary: "A text link block's screen resolves to a registered screen.";
595
+ readonly fix: 'Use a same-feature short id or a cross-feature QN "<feature>:screen:<id>".';
596
+ };
597
+ readonly textLinkRolesEmpty: {
598
+ readonly id: "dashboard/text-link-roles-empty";
599
+ readonly summary: "A text link block's roles list is non-empty when set.";
600
+ readonly fix: "List the roles or omit roles.";
601
+ };
602
+ readonly panelVisibleWhenIncomplete: {
603
+ readonly id: "dashboard/panel-visible-when-incomplete";
604
+ readonly summary: "A panel's visibleWhen names a non-empty query and field.";
605
+ readonly fix: "Set both visibleWhen.query and visibleWhen.field.";
606
+ };
607
+ readonly panelSpanInvalid: {
608
+ readonly id: "dashboard/panel-span-invalid";
609
+ readonly summary: 'A panel\'s span is "half" or "full".';
610
+ readonly fix: 'Set span to "half" or "full".';
611
+ };
612
+ readonly statGroupEmpty: {
613
+ readonly id: "dashboard/stat-group-empty";
614
+ readonly summary: "A stat-group declares at least one stat.";
615
+ readonly fix: "Add at least one stat.";
616
+ };
617
+ readonly statGroupSubtitleWithoutLabel: {
618
+ readonly id: "dashboard/stat-group-subtitle-without-label";
619
+ readonly summary: "A stat-group with a subtitle also has a label.";
620
+ readonly fix: "Set a label or remove subtitle.";
621
+ };
622
+ readonly statGroupChildVisibleWhen: {
623
+ readonly id: "dashboard/stat-group-child-visible-when";
624
+ readonly summary: "Stat-group children do not set visibleWhen.";
625
+ readonly fix: "Gate the whole group with visibleWhen instead.";
626
+ };
627
+ readonly panelQueryEmpty: {
628
+ readonly id: "dashboard/panel-query-empty";
629
+ readonly summary: "A stat, stat-group child and query panel names a non-empty query string.";
630
+ readonly fix: "Set query to a registered query name.";
631
+ };
632
+ readonly statValueFieldEmpty: {
633
+ readonly id: "dashboard/stat-value-field-empty";
634
+ readonly summary: "A stat panel and stat-group child has a non-empty valueField.";
635
+ readonly fix: "Set valueField to a field of the query result.";
636
+ };
637
+ readonly customPanelNoComponent: {
638
+ readonly id: "dashboard/custom-panel-no-component";
639
+ readonly summary: "A custom panel declares a react or native component.";
640
+ readonly fix: "Declare a react/native component marker.";
641
+ };
642
+ readonly listPanelColumnsEmpty: {
643
+ readonly id: "dashboard/list-panel-columns-empty";
644
+ readonly summary: "A list panel declares at least one column.";
645
+ readonly fix: "Add at least one column.";
646
+ };
647
+ readonly filterIdEmpty: {
648
+ readonly id: "dashboard/filter-id-empty";
649
+ readonly summary: "The dashboard filter has a non-empty id.";
650
+ readonly fix: "Set a non-empty filter.id.";
651
+ };
652
+ readonly filterLabelEmpty: {
653
+ readonly id: "dashboard/filter-label-empty";
654
+ readonly summary: "The dashboard filter has a non-empty label.";
655
+ readonly fix: "Set a non-empty filter.label.";
656
+ };
657
+ readonly filterOptionsXor: {
658
+ readonly id: "dashboard/filter-options-xor";
659
+ readonly summary: "The dashboard filter sets exactly one of options and optionsQuery.";
660
+ readonly fix: "Keep either options or optionsQuery.";
661
+ };
662
+ readonly filterOptionsEmpty: {
663
+ readonly id: "dashboard/filter-options-empty";
664
+ readonly summary: "Static filter options are non-empty.";
665
+ readonly fix: "Declare at least one option or use optionsQuery.";
666
+ };
667
+ readonly filterOptionsQueryEmpty: {
668
+ readonly id: "dashboard/filter-options-query-empty";
669
+ readonly summary: "filter.optionsQuery is non-empty when set.";
670
+ readonly fix: "Set optionsQuery to a query name or remove it.";
671
+ };
672
+ }, {
673
+ readonly chartFromTodayUnreachable: {
674
+ readonly id: "dashboard/chart-from-today-unreachable";
675
+ readonly summary: 'A chart with initialWindow "from-today" has ranges or brush.';
676
+ readonly fix: "Add ranges or brush, or change initialWindow.";
677
+ };
678
+ readonly chartFlagNonBoolean: {
679
+ readonly id: "dashboard/chart-flag-non-boolean";
680
+ readonly summary: "Chart flags (scrollable, brush, legendTotals, markerLabels) are booleans.";
681
+ readonly fix: "Use true or false.";
682
+ };
683
+ readonly chartStackedAreaOnly: {
684
+ readonly id: "dashboard/chart-stacked-area-only";
685
+ readonly summary: 'Stacked-area chart props are only set on a "stacked-area" chart.';
686
+ readonly fix: 'Remove the props or use chart "stacked-area".';
687
+ };
688
+ readonly chartUnitTimeseriesOnly: {
689
+ readonly id: "dashboard/chart-unit-timeseries-only";
690
+ readonly summary: 'A chart unit is only set on a "timeseries" chart.';
691
+ readonly fix: 'Remove unit or use chart "timeseries".';
692
+ };
693
+ readonly chartColorInvalid: {
694
+ readonly id: "dashboard/chart-color-invalid";
695
+ readonly summary: "Chart series and marker colors are non-empty CSS colors.";
696
+ readonly fix: "Set a non-empty CSS color.";
697
+ };
698
+ readonly chartEnumPropInvalid: {
699
+ readonly id: "dashboard/chart-enum-prop-invalid";
700
+ readonly summary: "Stacked-area dateFormat, initialWindow and markerLegend use an allowed value.";
701
+ readonly fix: "Set the prop to one of the allowed values.";
702
+ };
703
+ readonly chartMarkerLookMissing: {
704
+ readonly id: "dashboard/chart-marker-look-missing";
705
+ readonly summary: "A chart marker kind sets a tone or a color.";
706
+ readonly fix: "Set tone or color.";
707
+ };
708
+ readonly chartMarkerToneInvalid: {
709
+ readonly id: "dashboard/chart-marker-tone-invalid";
710
+ readonly summary: "A chart marker tone is a known dashboard tone.";
711
+ readonly fix: "Use positive, negative, active or neutral.";
712
+ };
713
+ readonly chartMarkerLabelInvalid: {
714
+ readonly id: "dashboard/chart-marker-label-invalid";
715
+ readonly summary: "A chart marker label is a non-empty i18n key.";
716
+ readonly fix: "Set a non-empty i18n key or remove label.";
717
+ };
718
+ readonly chartRangesOptionsEmpty: {
719
+ readonly id: "dashboard/chart-ranges-options-empty";
720
+ readonly summary: "Chart ranges declare at least one option.";
721
+ readonly fix: "Add an option to ranges.options.";
722
+ };
723
+ readonly chartRangesOptionIncomplete: {
724
+ readonly id: "dashboard/chart-ranges-option-incomplete";
725
+ readonly summary: "Every chart range option has a non-empty value and label.";
726
+ readonly fix: "Give every option a value and a label.";
727
+ };
728
+ readonly chartRangesOptionDuplicate: {
729
+ readonly id: "dashboard/chart-ranges-option-duplicate";
730
+ readonly summary: "Chart range option values are unique.";
731
+ readonly fix: "Use each option value once.";
732
+ };
733
+ readonly chartRangesMonthsInvalid: {
734
+ readonly id: "dashboard/chart-ranges-months-invalid";
735
+ readonly summary: "A chart range option's months is a positive integer.";
736
+ readonly fix: "Set months to a positive integer or remove it.";
737
+ };
738
+ readonly chartRangesDefaultUnknown: {
739
+ readonly id: "dashboard/chart-ranges-default-unknown";
740
+ readonly summary: "ranges.default is one of the option values.";
741
+ readonly fix: "Set default to one of the options.";
742
+ };
743
+ readonly valueFormatKind: {
744
+ readonly id: "dashboard/value-format-kind";
745
+ readonly summary: "A valueFormat kind is allowed for the panel type.";
746
+ readonly fix: "Use an allowed kind for this panel type.";
747
+ };
748
+ readonly valueFormatCurrency: {
749
+ readonly id: "dashboard/value-format-currency";
750
+ readonly summary: "A currency valueFormat uses a 3-letter uppercase ISO currency code.";
751
+ readonly fix: 'Set currency to an ISO 4217 code such as "EUR".';
752
+ };
753
+ readonly valueFormatFractionDigits: {
754
+ readonly id: "dashboard/value-format-fraction-digits";
755
+ readonly summary: "valueFormat.fractionDigits is an integer from 0 to the maximum.";
756
+ readonly fix: "Set fractionDigits to an integer within range.";
757
+ };
758
+ }, {
759
+ readonly embeddedListUnknownSubField: {
760
+ readonly id: "form/embedded-list-unknown-sub-field";
761
+ readonly summary: "embeddedList cell options name sub-fields of the embedded schema.";
762
+ readonly fix: "Name an existing sub-field.";
763
+ };
764
+ readonly embeddedListCardHiddenEditable: {
765
+ readonly id: "form/embedded-list-card-hidden-editable";
766
+ readonly summary: "embeddedList.cardHiddenCells lists only read-only cells.";
767
+ readonly fix: "Add the cell to readOnlyCells or remove it from cardHiddenCells.";
768
+ };
769
+ readonly embeddedListOnNonListField: {
770
+ readonly id: "form/embedded-list-on-non-list-field";
771
+ readonly summary: "embeddedList is set only on an embedded list field.";
772
+ readonly fix: "Remove embeddedList or point it at an embedded list field.";
773
+ };
774
+ readonly prefillTodayNeedsDate: {
775
+ readonly id: "form/prefill-today-needs-date";
776
+ readonly summary: 'The "today" prefill is set only on a date field.';
777
+ readonly fix: "Use a date field or a different prefill.";
778
+ };
779
+ readonly prefillCurrentUserFieldType: {
780
+ readonly id: "form/prefill-current-user-field-type";
781
+ readonly summary: "A currentUser prefill matches the field type.";
782
+ readonly fix: "Use a text field (or text/reference for id) or a different prefill property.";
783
+ };
784
+ readonly affixUnknownField: {
785
+ readonly id: "form/affix-unknown-field";
786
+ readonly summary: "A { field } prefix or suffix names another field of the same form.";
787
+ readonly fix: "Name a field of the same form.";
788
+ };
789
+ readonly fillActionUnknownField: {
790
+ readonly id: "form/fill-action-unknown-field";
791
+ readonly summary: "fillAction.params read fields of the same form.";
792
+ readonly fix: "Name fields of the same form in pick or map.";
793
+ };
794
+ readonly fillActionFieldType: {
795
+ readonly id: "form/fill-action-field-type";
796
+ readonly summary: "fillAction targets a text, number, decimal or bigInt field.";
797
+ readonly fix: "Remove fillAction or use a fitting field type.";
798
+ };
799
+ readonly fillActionSensitiveField: {
800
+ readonly id: "form/fill-action-sensitive-field";
801
+ readonly summary: "fillAction does not target a sensitive, writeOnly or password field.";
802
+ readonly fix: "Remove fillAction.";
803
+ };
804
+ readonly requiredFieldWithoutWidget: {
805
+ readonly id: "form/required-field-without-widget";
806
+ readonly summary: "A required entityEdit field has a widget to fill it.";
807
+ readonly fix: "Set required: false, move the field to a custom-component section, or drop the required constraint.";
808
+ };
809
+ readonly handlerEmpty: {
810
+ readonly id: "form/handler-empty";
811
+ readonly summary: "An inline form's handler is a non-empty string.";
812
+ readonly fix: "Set handler to a non-empty handler name.";
813
+ };
814
+ readonly fieldsEmpty: {
815
+ readonly id: "form/fields-empty";
816
+ readonly summary: "An inline form declares at least one field.";
817
+ readonly fix: "Declare at least one field.";
818
+ };
819
+ readonly fieldTypeMissing: {
820
+ readonly id: "form/field-type-missing";
821
+ readonly summary: "Every inline form field declares a type.";
822
+ readonly fix: 'Declare a type such as "text", "number" or "select".';
823
+ };
824
+ readonly optionsQueryPayloadSelfReference: {
825
+ readonly id: "form/options-query-payload-self-reference";
826
+ readonly summary: "optionsQueryPayload does not reference its own field.";
827
+ readonly fix: "Reference a different field of the form.";
828
+ };
829
+ readonly optionsQueryPayloadUnknownField: {
830
+ readonly id: "form/options-query-payload-unknown-field";
831
+ readonly summary: "optionsQueryPayload references fields of the same form.";
832
+ readonly fix: "Reference another field of the same form.";
833
+ };
834
+ readonly configSecretAlsoConfigKey: {
835
+ readonly id: "form/config-secret-also-config-key";
836
+ readonly summary: "A configEdit field is mapped in configKeys or secretKeys, not both.";
837
+ readonly fix: "Keep one of the mappings.";
838
+ };
839
+ readonly configSecretScope: {
840
+ readonly id: "form/config-secret-scope";
841
+ readonly summary: "Secret-mapped configEdit fields are on a tenant- or system-scope screen.";
842
+ readonly fix: 'Use scope "tenant" or "system", or drop the secret mapping.';
843
+ };
844
+ readonly configSecretFieldType: {
845
+ readonly id: "form/config-secret-field-type";
846
+ readonly summary: "A secret-mapped configEdit field is a writeOnly text field.";
847
+ readonly fix: "Make the field a writeOnly text field.";
848
+ };
849
+ readonly configSecretUndeclared: {
850
+ readonly id: "form/config-secret-undeclared";
851
+ readonly summary: "A secret-mapped configEdit field names a secret declared via r.secret().";
852
+ readonly fix: "Declare the secret with r.secret() or fix the secret name.";
853
+ };
854
+ readonly writeOnlyField: {
855
+ readonly id: "form/write-only-field";
856
+ readonly summary: "Inline form fields do not declare writeOnly.";
857
+ readonly fix: 'Remove writeOnly; use format: "password" for a masked input.';
858
+ };
859
+ readonly selectConditionalOptions: {
860
+ readonly id: "form/select-conditional-options";
861
+ readonly summary: "Inline form select fields do not declare conditionalOptions.";
862
+ readonly fix: "Remove conditionalOptions from the field.";
863
+ };
864
+ readonly selectOptionsQueryEmpty: {
865
+ readonly id: "form/select-options-query-empty";
866
+ readonly summary: "A select field's optionsQuery is non-empty when set.";
867
+ readonly fix: "Set it to a query name or remove it.";
868
+ };
869
+ readonly selectOptionsAndQuery: {
870
+ readonly id: "form/select-options-and-query";
871
+ readonly summary: "A select field declares static options or optionsQuery, not both.";
872
+ readonly fix: "Pick one of options and optionsQuery.";
873
+ };
874
+ readonly selectQueryAndAvailability: {
875
+ readonly id: "form/select-query-and-availability";
876
+ readonly summary: "optionsAvailabilityQuery is not combined with optionsQuery.";
877
+ readonly fix: "Remove optionsAvailabilityQuery or use static options.";
878
+ };
879
+ readonly optionsAvailabilityQueryEmpty: {
880
+ readonly id: "form/options-availability-query-empty";
881
+ readonly summary: "optionsAvailabilityQuery is non-empty when set.";
882
+ readonly fix: "Set it to a query name or remove it.";
883
+ };
884
+ readonly optionsQueryPayloadWithoutQuery: {
885
+ readonly id: "form/options-query-payload-without-query";
886
+ readonly summary: "optionsQueryPayload is set only together with optionsQuery.";
887
+ readonly fix: "Set optionsQuery or remove optionsQueryPayload.";
888
+ };
889
+ readonly moneyCurrencyMissing: {
890
+ readonly id: "form/money-currency-missing";
891
+ readonly summary: "An inline form money field declares its currency source.";
892
+ readonly fix: 'Declare currency: { kind: "literal", code } or { kind: "tenant" }.';
893
+ };
894
+ readonly moneyCurrencyNotObject: {
895
+ readonly id: "form/money-currency-not-object";
896
+ readonly summary: "A money field's currency is an object.";
897
+ readonly fix: 'Declare currency: { kind: "literal", code } or { kind: "tenant" }.';
898
+ };
899
+ readonly moneyCurrencyLiteralCode: {
900
+ readonly id: "form/money-currency-literal-code";
901
+ readonly summary: "A literal money currency has a non-empty string code.";
902
+ readonly fix: 'Pass the ISO code, for example { kind: "literal", code: "EUR" }.';
903
+ };
904
+ readonly moneyCurrencyUnknownKind: {
905
+ readonly id: "form/money-currency-unknown-kind";
906
+ readonly summary: 'A money field\'s currency kind is "literal" or "tenant".';
907
+ readonly fix: 'Declare currency: { kind: "literal", code } or { kind: "tenant" }.';
908
+ };
909
+ }, {
910
+ readonly tabsTooFewSections: {
911
+ readonly id: "form/tabs-too-few-sections";
912
+ readonly summary: "A tabs layout has at least two sections.";
913
+ readonly fix: "Add a section or use another mode.";
914
+ };
915
+ readonly tabTitleMissing: {
916
+ readonly id: "form/tab-title-missing";
917
+ readonly summary: "Every tab section has a non-empty title.";
918
+ readonly fix: "Give each tab section a title.";
919
+ };
920
+ readonly tabIdMissing: {
921
+ readonly id: "form/tab-id-missing";
922
+ readonly summary: "Every tab section has a non-empty id.";
923
+ readonly fix: "Give each tab section a stable id.";
924
+ };
925
+ readonly tabIdNotKebab: {
926
+ readonly id: "form/tab-id-not-kebab";
927
+ readonly summary: "Tab section ids are kebab-case.";
928
+ readonly fix: "Rename the section id to kebab-case.";
929
+ };
930
+ readonly tabIdDuplicate: {
931
+ readonly id: "form/tab-id-duplicate";
932
+ readonly summary: "Tab section ids are unique.";
933
+ readonly fix: "Give each tab section a unique id.";
934
+ };
935
+ readonly tabsUnsupportedScreenType: {
936
+ readonly id: "form/tabs-unsupported-screen-type";
937
+ readonly summary: "Tabs layout is used only on projectionDetail and entityEdit screens.";
938
+ readonly fix: 'Use mode: "wizard" or "single".';
939
+ };
940
+ readonly draftWithoutWizard: {
941
+ readonly id: "form/draft-without-wizard";
942
+ readonly summary: "layout.draft is set only on a wizard layout.";
943
+ readonly fix: 'Remove draft: true or set mode: "wizard".';
944
+ };
945
+ readonly draftFeatureMissing: {
946
+ readonly id: "form/draft-feature-missing";
947
+ readonly summary: "A draft layout needs the form-draft feature mounted.";
948
+ readonly fix: "Add createFormDraftFeature() from @cosmicdrift/kumiko-bundled-features to the app's features.";
949
+ };
950
+ readonly wizardTooFewSections: {
951
+ readonly id: "form/wizard-too-few-sections";
952
+ readonly summary: "A wizard layout has at least two sections.";
953
+ readonly fix: "Add a section or use another mode.";
954
+ };
955
+ readonly wizardStepTitleMissing: {
956
+ readonly id: "form/wizard-step-title-missing";
957
+ readonly summary: "Every wizard section has a non-empty title.";
958
+ readonly fix: "Give each wizard section a title.";
959
+ };
960
+ readonly sectionFieldsAndGroups: {
961
+ readonly id: "form/section-fields-and-groups";
962
+ readonly summary: "A section declares fields or groups, not both.";
963
+ readonly fix: "Remove `fields: []` when using groups.";
964
+ };
965
+ readonly sectionEmpty: {
966
+ readonly id: "form/section-empty";
967
+ readonly summary: "A section declares at least one field or group.";
968
+ readonly fix: "Drop the section or add fields or groups.";
969
+ };
970
+ readonly sectionsEmpty: {
971
+ readonly id: "form/sections-empty";
972
+ readonly summary: "An inline form layout declares at least one section.";
973
+ readonly fix: "Declare at least one section.";
974
+ };
975
+ readonly extensionSectionNoComponent: {
976
+ readonly id: "form/extension-section-no-component";
977
+ readonly summary: "An extension section declares a react or native component.";
978
+ readonly fix: "Declare a react/native component marker.";
979
+ };
980
+ readonly relatedListSectionUnsupported: {
981
+ readonly id: "form/related-list-section-unsupported";
982
+ readonly summary: "Inline form layouts have no relatedList sections.";
983
+ readonly fix: "Move the section to a projectionDetail screen or remove it.";
984
+ };
985
+ readonly writeFormSectionUnsupported: {
986
+ readonly id: "form/write-form-section-unsupported";
987
+ readonly summary: "Inline form layouts have no writeForm sections.";
988
+ readonly fix: "Move the section to a projectionDetail screen or remove it.";
989
+ };
990
+ readonly layoutUnknownField: {
991
+ readonly id: "form/layout-unknown-field";
992
+ readonly summary: "Layout fields name fields of the form.";
993
+ readonly fix: "Name an existing field of the form.";
994
+ };
995
+ readonly successFactsWithRedirect: {
996
+ readonly id: "form/success-facts-with-redirect";
997
+ readonly summary: "An actionForm sets either redirect or successFacts.";
998
+ readonly fix: "Use one of them.";
999
+ };
1000
+ readonly successLinksWithRedirect: {
1001
+ readonly id: "form/success-links-with-redirect";
1002
+ readonly summary: "An actionForm sets either redirect or successLinks.";
1003
+ readonly fix: "Use one of them.";
1004
+ };
1005
+ readonly loadSingletonWithIdParam: {
1006
+ readonly id: "form/load-singleton-with-id-param";
1007
+ readonly summary: "A singleton actionForm load has no idParam.";
1008
+ readonly fix: "Remove idParam.";
1009
+ };
1010
+ readonly confirmLayoutMode: {
1011
+ readonly id: "form/confirm-layout-mode";
1012
+ readonly summary: "A secretMint confirm layout is a single-step form.";
1013
+ readonly fix: 'Remove mode or set it to "single".';
1014
+ };
1015
+ readonly confirmLayoutDraft: {
1016
+ readonly id: "form/confirm-layout-draft";
1017
+ readonly summary: "A secretMint confirm layout does not persist drafts.";
1018
+ readonly fix: "Remove draft: true.";
1019
+ };
1020
+ readonly confirmCarryEntryEmpty: {
1021
+ readonly id: "form/confirm-carry-entry-empty";
1022
+ readonly summary: "secretMint confirm.carry entries are non-empty strings.";
1023
+ readonly fix: "Use non-empty strings in carry.";
1024
+ };
1025
+ readonly confirmCarryCollidesField: {
1026
+ readonly id: "form/confirm-carry-collides-field";
1027
+ readonly summary: "A confirm.carry entry does not share a name with a confirm.fields entry.";
1028
+ readonly fix: "Rename the carry entry or the field.";
1029
+ };
1030
+ }, {
1031
+ readonly listScreenIdUnresolved: {
1032
+ readonly id: "list/screen-id-unresolved";
1033
+ readonly summary: "listScreenId names a mounted screen.";
1034
+ readonly fix: "Fix the listScreenId or mount the list screen.";
1035
+ };
1036
+ readonly screenNoNavEntry: {
1037
+ readonly id: "list/screen-unreachable";
1038
+ readonly summary: "A screen without a nav entry has a resolvable list, or is marked dormant.";
1039
+ readonly fix: "Declare listScreenId, add a standalone r.nav() pointing at it, or set dormant: true.";
1040
+ };
1041
+ readonly relatedReadOnlyWithRowInteraction: {
1042
+ readonly id: "list/related-read-only-with-row-interaction";
1043
+ readonly summary: "A readOnly relatedList section declares no rowClick or rowActions.";
1044
+ readonly fix: "Remove readOnly or the row interaction.";
1045
+ };
1046
+ readonly relatedRowClickNoDetail: {
1047
+ readonly id: "list/related-row-click-no-detail";
1048
+ readonly summary: "A relatedList rowClick entity target has a screen declaring detailFor for it.";
1049
+ readonly fix: "Add detailFor to the screen that shows the entity.";
1050
+ };
1051
+ readonly emptyStateActionParams: {
1052
+ readonly id: "list/empty-state-action-params";
1053
+ readonly summary: "Empty-state actions set no params, because an empty list has no row to read them from.";
1054
+ readonly fix: "Remove the params.";
1055
+ };
1056
+ readonly relatedToolbarVisibleWhen: {
1057
+ readonly id: "list/related-toolbar-visible-when";
1058
+ readonly summary: "relatedList toolbarActions use visible instead of visibleWhen.";
1059
+ readonly fix: "Use visible, a condition on the enclosing record.";
1060
+ };
1061
+ readonly columnSortableInert: {
1062
+ readonly id: "list/column-sortable-inert";
1063
+ readonly summary: "A column only sets sortable where the screen type honors it.";
1064
+ readonly fix: "Remove sortable from the column.";
1065
+ };
1066
+ readonly columnRendererReactNotObject: {
1067
+ readonly id: "list/column-renderer-react-not-object";
1068
+ readonly summary: "A column renderer's react branch is an object.";
1069
+ readonly fix: 'Use { react: { __component: "Name" } }.';
1070
+ };
1071
+ readonly columnRendererComponentInvalid: {
1072
+ readonly id: "list/column-renderer-component-invalid";
1073
+ readonly summary: "A column renderer's react.__component is a non-empty string.";
1074
+ readonly fix: "Set react.__component to the name of a client columnRenderers entry.";
1075
+ };
1076
+ readonly enumOptionTonesInvalid: {
1077
+ readonly id: "list/enum-option-tones-invalid";
1078
+ readonly summary: "enumOption column tones are known select option tones.";
1079
+ readonly fix: "Use only the allowed tones (SELECT_OPTION_TONES).";
1080
+ };
1081
+ readonly refTargetFeatureNotMounted: {
1082
+ readonly id: "list/ref-target-feature-not-mounted";
1083
+ readonly summary: "An entity reference target belongs to a mounted feature.";
1084
+ readonly fix: "Mount the feature and declare it in r.requires({ features }).";
1085
+ };
1086
+ readonly refTargetEntityUnknown: {
1087
+ readonly id: "list/ref-target-entity-unknown";
1088
+ readonly summary: "An entity reference target resolves to a registered entity.";
1089
+ readonly fix: "Name an entity the target feature registers.";
1090
+ };
1091
+ readonly facetDuplicate: {
1092
+ readonly id: "list/facet-duplicate";
1093
+ readonly summary: "Each facet field is declared once.";
1094
+ readonly fix: "Declare each facet field once.";
1095
+ };
1096
+ readonly facetUnknownColumn: {
1097
+ readonly id: "list/facet-unknown-column";
1098
+ readonly summary: "A non-reference facet names a declared column.";
1099
+ readonly fix: "Name a declared column or add the column.";
1100
+ };
1101
+ readonly facetSelectNoOptions: {
1102
+ readonly id: "list/facet-select-no-options";
1103
+ readonly summary: "A select facet declares at least one option.";
1104
+ readonly fix: "Declare at least one option.";
1105
+ };
1106
+ readonly facetQueryUnregistered: {
1107
+ readonly id: "list/facet-query-unregistered";
1108
+ readonly summary: "A reference facet loads its options from a registered query handler.";
1109
+ readonly fix: "Register the entity's list handler (defineEntityListHandler).";
1110
+ };
1111
+ }, {
1112
+ readonly unknownFieldReference: {
1113
+ readonly id: "screen/unknown-field-reference";
1114
+ readonly summary: "A column or layout field names a field that exists on the screen's entity.";
1115
+ readonly fix: "Name a field of the entity.";
1116
+ };
1117
+ readonly entityNotDeclared: {
1118
+ readonly id: "screen/entity-not-declared";
1119
+ readonly summary: "A screen's entity is declared in its feature.";
1120
+ readonly fix: "Declare the entity in this feature or fix the name.";
1121
+ };
1122
+ readonly queryEmpty: {
1123
+ readonly id: "screen/query-empty";
1124
+ readonly summary: "A screen or section query is a non-empty string.";
1125
+ readonly fix: "Set query to a registered query name.";
1126
+ };
1127
+ readonly columnsEmpty: {
1128
+ readonly id: "screen/columns-empty";
1129
+ readonly summary: "A list screen declares at least one column.";
1130
+ readonly fix: "Declare at least one column.";
1131
+ };
1132
+ readonly filterInNeedsArray: {
1133
+ readonly id: "screen/filter-in-needs-array";
1134
+ readonly summary: "A filter with op in has an array value.";
1135
+ readonly fix: "Pass an array as filter.value.";
1136
+ };
1137
+ readonly headerActionRowClick: {
1138
+ readonly id: "screen/header-action-row-click";
1139
+ readonly summary: "Record header actions do not set rowClick, because a record screen has no row.";
1140
+ readonly fix: "Remove rowClick.";
1141
+ };
1142
+ readonly defaultSortUnknownField: {
1143
+ readonly id: "entity-list/default-sort-unknown-field";
1144
+ readonly summary: "defaultSort.field is a field of the entity.";
1145
+ readonly fix: "Name an existing entity field.";
1146
+ };
1147
+ readonly filterUnknownField: {
1148
+ readonly id: "entity-list/filter-unknown-field";
1149
+ readonly summary: "A screen filter names a field of the entity.";
1150
+ readonly fix: "Name an existing entity field.";
1151
+ };
1152
+ readonly filterFieldNotAllowed: {
1153
+ readonly id: "entity-list/filter-field-not-allowed";
1154
+ readonly summary: "A screen filter does not target an encrypted, personal or secret field the list handler rejects.";
1155
+ readonly fix: "Drop the filter or filter on another field; personal fields only allow op eq with find exact or fuzzy.";
1156
+ };
1157
+ readonly filterFieldNotFilterable: {
1158
+ readonly id: "entity-list/filter-field-not-filterable";
1159
+ readonly summary: "A screen filter targets a filterable field.";
1160
+ readonly fix: "Set filterable: true on the field or pick another field.";
1161
+ };
1162
+ readonly filterOpNotAllowed: {
1163
+ readonly id: "entity-list/filter-op-not-allowed";
1164
+ readonly summary: "A screen filter uses an op allowed for the field type.";
1165
+ readonly fix: "Use one of the allowed ops for the field.";
1166
+ };
1167
+ readonly crossFeatureEditNeedsEntityId: {
1168
+ readonly id: "entity-list/cross-feature-edit-needs-entity-id";
1169
+ readonly summary: "A rowAction navigating to a cross-feature entityEdit screen sets entityId.";
1170
+ readonly fix: "Set entityId to the row field naming the target entity's id.";
1171
+ };
1172
+ readonly pageSizeInvalid: {
1173
+ readonly id: "entity-list/page-size-invalid";
1174
+ readonly summary: "pageSize is a positive integer.";
1175
+ readonly fix: "Set pageSize to a positive integer.";
1176
+ };
1177
+ readonly createScreenUnresolved: {
1178
+ readonly id: "entity-list/create-screen-unresolved";
1179
+ readonly summary: "createScreen resolves to a registered screen in the same feature.";
1180
+ readonly fix: "Point createScreen at a screen of this feature.";
1181
+ };
1182
+ readonly configEditFieldsEmpty: {
1183
+ readonly id: "config-edit/fields-empty";
1184
+ readonly summary: "A configEdit screen declares at least one field.";
1185
+ readonly fix: "Declare at least one field.";
1186
+ };
1187
+ readonly configEditFieldTypeMissing: {
1188
+ readonly id: "config-edit/field-type-missing";
1189
+ readonly summary: "Every configEdit field declares a type.";
1190
+ readonly fix: "Set type on the field.";
1191
+ };
1192
+ readonly configEditLayoutUnknownField: {
1193
+ readonly id: "config-edit/layout-unknown-field";
1194
+ readonly summary: "A configEdit layout names a declared field.";
1195
+ readonly fix: "Name a declared field.";
1196
+ };
1197
+ readonly configEditFieldWithoutConfigKey: {
1198
+ readonly id: "config-edit/field-without-config-key";
1199
+ readonly summary: "Every configEdit field maps to a config key in configKeys.";
1200
+ readonly fix: "Add the field to configKeys with a <feature>:config:<short> key.";
1201
+ };
1202
+ readonly configEditConfigKeyUnknown: {
1203
+ readonly id: "config-edit/config-key-unknown";
1204
+ readonly summary: "A configKeys entry names a config key declared in a feature.";
1205
+ readonly fix: "Use an existing <feature>:config:<short> key.";
1206
+ };
1207
+ readonly configEditWriteOnlyNotEncrypted: {
1208
+ readonly id: "config-edit/write-only-not-encrypted";
1209
+ readonly summary: "A writeOnly configEdit field maps to an encrypted config key.";
1210
+ readonly fix: 'Declare the key with encrypted: true or backing: "secrets".';
1211
+ };
1212
+ readonly configEditSecretKeyUnknownField: {
1213
+ readonly id: "config-edit/secret-key-unknown-field";
1214
+ readonly summary: "secretKeys names declared fields.";
1215
+ readonly fix: "Name a declared field.";
1216
+ };
1217
+ readonly secretMintRevealFieldsEmpty: {
1218
+ readonly id: "secret-mint/reveal-fields-empty";
1219
+ readonly summary: "A secretMint screen reveals at least one field.";
1220
+ readonly fix: "Declare at least one reveal field.";
1221
+ };
1222
+ readonly secretMintRevealFieldNameEmpty: {
1223
+ readonly id: "secret-mint/reveal-field-name-empty";
1224
+ readonly summary: "Every reveal.fields entry has a non-empty string field.";
1225
+ readonly fix: "Set field to a non-empty string.";
1226
+ };
1227
+ readonly secretMintRevealFieldDuplicate: {
1228
+ readonly id: "secret-mint/reveal-field-duplicate";
1229
+ readonly summary: "Each reveal field appears once.";
1230
+ readonly fix: "Remove the duplicate entry.";
1231
+ };
1232
+ readonly secretMintRevealFieldLabelEmpty: {
1233
+ readonly id: "secret-mint/reveal-field-label-empty";
1234
+ readonly summary: "Every reveal.fields entry has a non-empty string label.";
1235
+ readonly fix: "Set label to a non-empty string.";
1236
+ };
1237
+ readonly entityEditRecordTitleFieldUnknown: {
1238
+ readonly id: "entity-edit/record-title-field-unknown";
1239
+ readonly summary: "recordTitleField is a field of the screen's entity.";
1240
+ readonly fix: "Name an existing entity field.";
1241
+ };
1242
+ readonly entityEditReadOnlyFieldUnknown: {
1243
+ readonly id: "entity-edit/read-only-field-unknown";
1244
+ readonly summary: "The readOnly condition field is a field of the screen's entity.";
1245
+ readonly fix: "Name an existing entity field.";
1246
+ };
1247
+ }, {
1248
+ readonly singletonWithIdParam: {
1249
+ readonly id: "projection-detail/singleton-with-id-param";
1250
+ readonly summary: "A singleton projectionDetail sets no idParam.";
1251
+ readonly fix: "Remove idParam.";
1252
+ };
1253
+ readonly singletonWithDetailFor: {
1254
+ readonly id: "projection-detail/singleton-with-detail-for";
1255
+ readonly summary: "A singleton projectionDetail sets no detailFor.";
1256
+ readonly fix: "Remove detailFor, or declare an explicit edit action.";
1257
+ };
1258
+ readonly headerWithRecordTitleField: {
1259
+ readonly id: "projection-detail/header-with-record-title-field";
1260
+ readonly summary: "A projectionDetail with a header sets no recordTitleField.";
1261
+ readonly fix: "Drop recordTitleField; header.title names the record.";
1262
+ };
1263
+ readonly tabsSectionGroupsAndActions: {
1264
+ readonly id: "projection-detail/tabs-section-groups-and-actions";
1265
+ readonly summary: "A tabs-mode section declares groups or actions, not both.";
1266
+ readonly fix: "Move the actions onto one group's title, or drop groups.";
1267
+ };
1268
+ readonly metricNavigateTabUnknown: {
1269
+ readonly id: "projection-detail/metric-navigate-tab-unknown";
1270
+ readonly summary: "A metric navigate.tab names a section id of the screen.";
1271
+ readonly fix: "Navigate to an existing section id or remove navigate.tab.";
1272
+ };
1273
+ readonly metricLabelMissing: {
1274
+ readonly id: "projection-detail/metric-label-missing";
1275
+ readonly summary: "Every metric has an i18n label key.";
1276
+ readonly fix: "Set label on the metric.";
1277
+ };
1278
+ readonly statusToneInvalid: {
1279
+ readonly id: "projection-detail/status-tone-invalid";
1280
+ readonly summary: "header.statusTones values are known select option tones.";
1281
+ readonly fix: "Use one of SELECT_OPTION_TONES.";
1282
+ };
1283
+ readonly statusFormatWithoutStatus: {
1284
+ readonly id: "projection-detail/status-format-without-status";
1285
+ readonly summary: "header.statusFormat is only set together with header.status.";
1286
+ readonly fix: "Set header.status or remove statusFormat.";
1287
+ };
1288
+ readonly subtitleHrefWithMultiPart: {
1289
+ readonly id: "projection-detail/subtitle-href-with-multi-part";
1290
+ readonly summary: "header.subtitleHref is only set with the string form of header.subtitle.";
1291
+ readonly fix: "Use a single-field subtitle or remove subtitleHref.";
1292
+ };
1293
+ readonly subtitlePartDuplicate: {
1294
+ readonly id: "projection-detail/subtitle-part-duplicate";
1295
+ readonly summary: "Each field appears once in header.subtitle.";
1296
+ readonly fix: "List each field once.";
1297
+ };
1298
+ readonly subtitlePartNavigateTargetMissing: {
1299
+ readonly id: "projection-detail/subtitle-part-navigate-target-missing";
1300
+ readonly summary: "A header.subtitle part navigate names a screen or an entity.";
1301
+ readonly fix: "Set screen or entity on the part's navigate.";
1302
+ };
1303
+ readonly extensionContributesToFormSubmit: {
1304
+ readonly id: "projection-detail/extension-contributes-to-form-submit";
1305
+ readonly summary: "A projectionDetail extension section does not set contributesToFormSubmit.";
1306
+ readonly fix: "Omit contributesToFormSubmit and persist through the extension's own dispatcher writes.";
1307
+ };
1308
+ readonly extensionEntityNameMissing: {
1309
+ readonly id: "projection-detail/extension-entity-name-missing";
1310
+ readonly summary: "A projectionDetail extension section declares entityName.";
1311
+ readonly fix: "Set entityName to the domain entity the extension persists against.";
1312
+ };
1313
+ readonly wizardRelatedList: {
1314
+ readonly id: "projection-detail/wizard-related-list";
1315
+ readonly summary: "A wizard-mode layout has no relatedList section.";
1316
+ readonly fix: 'Remove mode: "wizard" or drop the relatedList section.';
1317
+ };
1318
+ readonly writeFormFieldDefsEmpty: {
1319
+ readonly id: "projection-detail/write-form-field-defs-empty";
1320
+ readonly summary: "A writeForm section declares at least one fieldDefs entry.";
1321
+ readonly fix: "Declare at least one field type.";
1322
+ };
1323
+ readonly writeFormFieldsEmpty: {
1324
+ readonly id: "projection-detail/write-form-fields-empty";
1325
+ readonly summary: "A writeForm section lists at least one field.";
1326
+ readonly fix: "Drop the section or add fields.";
1327
+ };
1328
+ readonly writeFormFieldWithoutDef: {
1329
+ readonly id: "projection-detail/write-form-field-without-def";
1330
+ readonly summary: "Every rendered writeForm field has a fieldDefs entry.";
1331
+ readonly fix: "Add the field to fieldDefs.";
1332
+ };
1333
+ readonly wizardWriteForm: {
1334
+ readonly id: "projection-detail/wizard-write-form";
1335
+ readonly summary: "A wizard-mode layout has no writeForm section.";
1336
+ readonly fix: 'Remove mode: "wizard" or drop the writeForm section.';
1337
+ };
1338
+ }, {
1339
+ readonly customNoComponent: {
1340
+ readonly id: "screen/custom-no-component";
1341
+ readonly summary: "A custom screen renderer declares a react or native component.";
1342
+ readonly fix: "Set react or native on the renderer.";
1343
+ };
1344
+ readonly unknownType: {
1345
+ readonly id: "screen/unknown-type";
1346
+ readonly summary: "A screen has a known type.";
1347
+ readonly fix: "Use a supported screen type.";
1348
+ };
1349
+ readonly urlPrefillFieldsSet: {
1350
+ readonly id: "screen/url-prefill-fields-set";
1351
+ readonly summary: "Screens do not set urlPrefillFields; buildAppSchema derives it.";
1352
+ readonly fix: "Declare params on the navigating action instead.";
1353
+ };
1354
+ readonly submitPrefilledUnsupported: {
1355
+ readonly id: "screen/submit-prefilled-unsupported";
1356
+ readonly summary: "Only actionForm and secretMint screens set submitPrefilled.";
1357
+ readonly fix: "Remove submitPrefilled.";
1358
+ };
1359
+ readonly submitPrefilledHiddenRequired: {
1360
+ readonly id: "screen/submit-prefilled-hidden-required";
1361
+ readonly summary: "With submitPrefilled, a hidden required field is passed in by a navigate action's params.";
1362
+ readonly fix: "Add the field to the params of a navigate action targeting the screen, make it visible, or drop required.";
1363
+ };
1364
+ readonly customWriteQnUnregistered: {
1365
+ readonly id: "screen/custom-write-qn-unregistered";
1366
+ readonly summary: "Every dispatcher.write QN in app source names a registered write handler.";
1367
+ readonly fix: "Check the spelling against registered write handlers (<feature>:write:<handler>).";
1368
+ };
1369
+ readonly detailForDuplicate: {
1370
+ readonly id: "screen/detail-for-duplicate";
1371
+ readonly summary: "At most one screen declares detailFor for an entity.";
1372
+ readonly fix: "Keep detailFor on one screen per entity.";
1373
+ };
1374
+ readonly detailForUnknownEntity: {
1375
+ readonly id: "screen/detail-for-unknown-entity";
1376
+ readonly summary: "detailFor names an entity a feature registers.";
1377
+ readonly fix: "Set detailFor to a registered entity name or remove it.";
1378
+ };
1379
+ readonly actionFieldFunction: {
1380
+ readonly id: "screen/action-field-function";
1381
+ readonly summary: "Action payload, params, entityId and visible are declarative values, not functions.";
1382
+ readonly fix: "Use the declarative DSL ({ pick }, { map }, field name, { field, eq }).";
1383
+ };
1384
+ readonly editFieldConditionFunction: {
1385
+ readonly id: "screen/edit-field-condition-function";
1386
+ readonly summary: "Edit field visible, readOnly and required are FieldConditions, not functions.";
1387
+ readonly fix: "Use a FieldCondition (boolean or { field, eq/ne/in/notIn }).";
1388
+ };
1389
+ readonly rendererFunction: {
1390
+ readonly id: "screen/renderer-function";
1391
+ readonly summary: "Field and column renderers are FormatSpecs, not functions.";
1392
+ readonly fix: 'Use a FormatSpec ({ format: "..." }).';
1393
+ };
1394
+ }, {
1395
+ readonly unknownField: {
1396
+ readonly id: "derived-field/unknown-field";
1397
+ readonly summary: "Every field a SQL derived field reads is a field of the entity.";
1398
+ readonly fix: "Name an existing field of the entity (or of the related entity).";
1399
+ };
1400
+ readonly unsupportedFieldType: {
1401
+ readonly id: "derived-field/unsupported-field-type";
1402
+ readonly summary: "A SQL derived field reads only scalar field types.";
1403
+ readonly fix: "Read a text, number, decimal, boolean, date or timestamp field; money only as the measure of a related first.";
1404
+ };
1405
+ readonly encryptedField: {
1406
+ readonly id: "derived-field/encrypted-field";
1407
+ readonly summary: "A SQL derived field does not read encrypted or secret fields.";
1408
+ readonly fix: "Read a field that is neither encrypted nor secret.";
1409
+ };
1410
+ readonly valueTypeMismatch: {
1411
+ readonly id: "derived-field/value-type-mismatch";
1412
+ readonly summary: "The derived field's valueType matches the type of the value it computes.";
1413
+ readonly fix: "Set valueType to the expected value type.";
1414
+ };
1415
+ readonly labelNeedsReference: {
1416
+ readonly id: "derived-field/label-needs-reference";
1417
+ readonly summary: "A measure with label: true reads a reference field (with a labelField).";
1418
+ readonly fix: "Measure a reference field that declares a labelField, or drop label: true.";
1419
+ };
1420
+ readonly activeOnNotDate: {
1421
+ readonly id: "derived-field/active-on-not-date";
1422
+ readonly summary: "The activeOn from/to fields are date fields.";
1423
+ readonly fix: "Use date fields for activeOn.from and activeOn.to.";
1424
+ };
1425
+ readonly inOperatorList: {
1426
+ readonly id: "derived-field/in-operator-list";
1427
+ readonly summary: 'A where condition with op "in" takes a list, and only "in" does.';
1428
+ readonly fix: 'Use a list value exactly with op "in".';
1429
+ };
1430
+ readonly nullOperator: {
1431
+ readonly id: "derived-field/null-operator";
1432
+ readonly summary: "A where condition with a null value uses op eq or ne.";
1433
+ readonly fix: "Use op eq or ne for null, or give a value.";
1434
+ };
1435
+ readonly relativeDateFieldType: {
1436
+ readonly id: "derived-field/relative-date-field-type";
1437
+ readonly summary: "A where condition with today needs a date field and with now a timestamp field.";
1438
+ readonly fix: "Compare today with a date field and now with a timestamp field.";
1439
+ };
1440
+ readonly sortableNeedsJoinIndex: {
1441
+ readonly id: "derived-field/sortable-needs-join-index";
1442
+ readonly summary: "A sortable related derived field has an index on the related table's join column.";
1443
+ readonly fix: 'Declare indexes: [{ columns: ["<field>"] }] on the related entity.';
1444
+ };
1445
+ readonly unknownRelatedEntity: {
1446
+ readonly id: "derived-field/unknown-related-entity";
1447
+ readonly summary: "The related entity of a derived field is registered.";
1448
+ readonly fix: "Register the entity or fix the entity name.";
1449
+ };
1450
+ readonly coalesceEmpty: {
1451
+ readonly id: "derived-field/coalesce-empty";
1452
+ readonly summary: "A coalesce derived field lists at least one field.";
1453
+ readonly fix: "Add fields to coalesce.";
1454
+ };
1455
+ readonly coalesceMixedTypes: {
1456
+ readonly id: "derived-field/coalesce-mixed-types";
1457
+ readonly summary: "All coalesce fields have the same type.";
1458
+ readonly fix: "Coalesce fields of one type.";
1459
+ };
1460
+ readonly moneyNeedsSql: {
1461
+ readonly id: "derived-field/money-needs-sql";
1462
+ readonly summary: 'A derived field with valueType "money" is a sql derived field.';
1463
+ readonly fix: "Use a sql related first measure on a money field.";
1464
+ };
1465
+ readonly sortableNeedsSql: {
1466
+ readonly id: "derived-field/sortable-needs-sql";
1467
+ readonly summary: "Only sql derived fields are sortable.";
1468
+ readonly fix: "Make the field a sql derived field or drop sortable.";
1469
+ };
1470
+ }, {
1471
+ readonly presaveWithoutMappedWrite: {
1472
+ readonly id: "extension/presave-without-mapped-write";
1473
+ readonly summary: "An extension with preSave is used only on entities that have an entity-mapped write handler.";
1474
+ readonly fix: 'Use create/update/delete on a matching entity or name the handler "entity:verb".';
1475
+ };
1476
+ readonly accessMissing: {
1477
+ readonly id: "handler/access-missing";
1478
+ readonly summary: "Every write, query and stream handler declares an access rule.";
1479
+ readonly fix: "Set access: { roles: [...] } or { openToAll: { reason } }.";
1480
+ };
1481
+ readonly additionalBucketsEmpty: {
1482
+ readonly id: "rate-limit/additional-buckets-empty";
1483
+ readonly summary: "additionalRateLimits lists at least one bucket.";
1484
+ readonly fix: "Declare a bucket or drop additionalRateLimits.";
1485
+ };
1486
+ readonly additionalPayloadFieldDuplicate: {
1487
+ readonly id: "rate-limit/additional-payload-field-duplicate";
1488
+ readonly summary: "additionalRateLimits has one entry per payloadField.";
1489
+ readonly fix: "Keep one entry per payloadField.";
1490
+ };
1491
+ readonly additionalWithoutIpBucket: {
1492
+ readonly id: "rate-limit/additional-without-ip-bucket";
1493
+ readonly summary: "An anonymous handler with additionalRateLimits also has an ip-keyed rateLimit.";
1494
+ readonly fix: 'Set rateLimit: { per: "ip", ... } on the handler.';
1495
+ };
1496
+ readonly payloadFieldUnknown: {
1497
+ readonly id: "rate-limit/payload-field-unknown";
1498
+ readonly summary: "Every additionalRateLimits payloadField is a field of the handler schema.";
1499
+ readonly fix: "Name a field of the handler Zod object schema.";
1500
+ };
1501
+ readonly payloadLimitInvalid: {
1502
+ readonly id: "rate-limit/payload-limit-invalid";
1503
+ readonly summary: "An additionalRateLimits limit is a positive integer.";
1504
+ readonly fix: "Set limit to a positive integer.";
1505
+ };
1506
+ readonly payloadWindowInvalid: {
1507
+ readonly id: "rate-limit/payload-window-invalid";
1508
+ readonly summary: "An additionalRateLimits windowSeconds is a positive integer.";
1509
+ readonly fix: "Set windowSeconds to a positive integer.";
1510
+ };
1511
+ readonly tenantlessAnonymousAccess: {
1512
+ readonly id: "handler/tenantless-anonymous-access";
1513
+ readonly summary: "A tenantlessAnonymous handler allows exactly the anonymous role.";
1514
+ readonly fix: 'Set access to { roles: ["anonymous"] } or remove tenantlessAnonymous.';
1515
+ };
1516
+ readonly tenantlessAnonymousWithoutRateLimit: {
1517
+ readonly id: "handler/tenantless-anonymous-without-rate-limit";
1518
+ readonly summary: "A tenantlessAnonymous handler declares an active rateLimit.";
1519
+ readonly fix: 'Set rateLimit: { per: "ip", ... }; disabled does not count.';
1520
+ };
1521
+ readonly tenantlessAnonymousRateLimitPer: {
1522
+ readonly id: "handler/tenantless-anonymous-rate-limit-per";
1523
+ readonly summary: "A tenantlessAnonymous handler rate-limits per ip or ip+handler.";
1524
+ readonly fix: 'Use per "ip" or "ip+handler".';
1525
+ };
1526
+ readonly costWithoutRateLimit: {
1527
+ readonly id: "rate-limit/cost-without-rate-limit";
1528
+ readonly summary: "rateLimitCost requires an active rateLimit.";
1529
+ readonly fix: "Declare rateLimit or drop rateLimitCost.";
1530
+ };
1531
+ readonly costOnAnonymousHandler: {
1532
+ readonly id: "rate-limit/cost-on-anonymous-handler";
1533
+ readonly summary: "rateLimitCost is declared only on authenticated handlers without an ip bucket.";
1534
+ readonly fix: 'Use a user/tenant bucket and drop "anonymous", or drop rateLimitCost.';
1535
+ };
1536
+ readonly disabledWithoutReason: {
1537
+ readonly id: "rate-limit/disabled-without-reason";
1538
+ readonly summary: "A disabled rateLimit carries a non-empty reason.";
1539
+ readonly fix: 'Provide { disabled: true, reason: "..." }.';
1540
+ };
1541
+ readonly bucketListEmpty: {
1542
+ readonly id: "rate-limit/bucket-list-empty";
1543
+ readonly summary: "A rateLimit array lists at least one bucket.";
1544
+ readonly fix: "Declare a bucket or drop the option.";
1545
+ };
1546
+ readonly bucketPerDuplicate: {
1547
+ readonly id: "rate-limit/bucket-per-duplicate";
1548
+ readonly summary: 'A rateLimit array has one entry per "per".';
1549
+ readonly fix: 'Keep one entry per "per".';
1550
+ };
1551
+ readonly accessAllRole: {
1552
+ readonly id: "handler/access-all-role";
1553
+ readonly summary: 'Handler access does not list the role "all".';
1554
+ readonly fix: 'Use roles: ["anonymous"] plus an ip rateLimit, or openToAll: { reason }.';
1555
+ };
1556
+ readonly anonymousWithoutRateLimit: {
1557
+ readonly id: "rate-limit/anonymous-without-rate-limit";
1558
+ readonly summary: "A handler that allows anonymous callers declares a rateLimit.";
1559
+ readonly fix: 'Set rateLimit: { per: "ip", ... } or { disabled: true, reason }.';
1560
+ };
1561
+ readonly anonymousUserBucket: {
1562
+ readonly id: "rate-limit/anonymous-user-bucket";
1563
+ readonly summary: "A handler that allows anonymous callers does not bucket per user.";
1564
+ readonly fix: 'Use rateLimit.per "ip" or "ip+handler".';
1565
+ };
1566
+ readonly perInstanceWithTable: {
1567
+ readonly id: "projection/per-instance-with-table";
1568
+ readonly summary: "A MultiStreamProjection with a table uses shared delivery.";
1569
+ readonly fix: 'Use delivery "shared", or drop the table for side-effect-only consumers.';
1570
+ };
1571
+ }, {
1572
+ readonly referenceUnknownFeature: {
1573
+ readonly id: "reference/unknown-feature";
1574
+ readonly summary: "A reference field targets a registered feature.";
1575
+ readonly fix: "Fix the feature prefix of the reference target.";
1576
+ };
1577
+ readonly referenceUnknownEntity: {
1578
+ readonly id: "reference/unknown-entity";
1579
+ readonly summary: "A reference field targets an entity of the target feature.";
1580
+ readonly fix: "Fix the entity name of the reference target.";
1581
+ };
1582
+ readonly referenceUnknownLabelField: {
1583
+ readonly id: "reference/unknown-label-field";
1584
+ readonly summary: "A reference labelField is a field of the referenced entity.";
1585
+ readonly fix: "Name an existing field of the referenced entity.";
1586
+ };
1587
+ readonly referenceTargetWithoutListHandler: {
1588
+ readonly id: "reference/target-without-list-handler";
1589
+ readonly summary: "The referenced entity has a registered list query handler.";
1590
+ readonly fix: "Register r.queryHandler(defineEntityListHandler(...)) in the target feature.";
1591
+ };
1592
+ readonly referenceOptionsQueryEmpty: {
1593
+ readonly id: "reference/options-query-empty";
1594
+ readonly summary: "A reference optionsQuery is not empty.";
1595
+ readonly fix: "Drop the property or name a query handler.";
1596
+ };
1597
+ readonly referenceOptionsQueryUnregistered: {
1598
+ readonly id: "reference/options-query-unregistered";
1599
+ readonly summary: "A reference optionsQuery names a registered query handler.";
1600
+ readonly fix: "Check the QN spelling and register the handler via r.queryHandler(...).";
1601
+ };
1602
+ readonly embeddedSchemaEmpty: {
1603
+ readonly id: "embedded-field/schema-empty";
1604
+ readonly summary: "An embedded field declares at least one sub-field.";
1605
+ readonly fix: "Declare a sub-field in the embedded schema.";
1606
+ };
1607
+ readonly embeddedSubFieldTypeInvalid: {
1608
+ readonly id: "embedded-field/sub-field-type-invalid";
1609
+ readonly summary: "An embedded sub-field uses an allowed sub-field type.";
1610
+ readonly fix: "Use one of the allowed embedded sub-field types.";
1611
+ };
1612
+ readonly embeddedDecimalScaleInvalid: {
1613
+ readonly id: "embedded-field/decimal-scale-invalid";
1614
+ readonly summary: "A decimal sub-field scale is an integer between 0 and 15.";
1615
+ readonly fix: "Set scale to an integer between 0 and 15.";
1616
+ };
1617
+ readonly embeddedSelectOptionsEmpty: {
1618
+ readonly id: "embedded-field/select-options-empty";
1619
+ readonly summary: "A select sub-field has at least one option.";
1620
+ readonly fix: "Add an option.";
1621
+ };
1622
+ readonly embeddedMinItemsNegative: {
1623
+ readonly id: "embedded-field/min-items-negative";
1624
+ readonly summary: "An embedded list minItems is at least 0.";
1625
+ readonly fix: "Set minItems to 0 or more.";
1626
+ };
1627
+ readonly embeddedMaxItemsTooSmall: {
1628
+ readonly id: "embedded-field/max-items-too-small";
1629
+ readonly summary: "An embedded list maxItems is at least 1.";
1630
+ readonly fix: "Set maxItems to 1 or more.";
1631
+ };
1632
+ readonly embeddedMinItemsAboveMax: {
1633
+ readonly id: "embedded-field/min-items-above-max";
1634
+ readonly summary: "An embedded list minItems is not greater than maxItems.";
1635
+ readonly fix: "Set minItems at or below maxItems.";
1636
+ };
1637
+ readonly embeddedRequiredMinItemsZero: {
1638
+ readonly id: "embedded-field/required-min-items-zero";
1639
+ readonly summary: "A required embedded list does not set minItems: 0.";
1640
+ readonly fix: "Drop minItems or set required: false.";
1641
+ };
1642
+ readonly embeddedDerivedCellNotInSchema: {
1643
+ readonly id: "embedded-field/derived-cell-not-in-schema";
1644
+ readonly summary: "Every derived cell is a sub-field in the embedded schema.";
1645
+ readonly fix: "Add the sub-field to the schema or remove the derived cell.";
1646
+ };
1647
+ readonly embeddedPercentNeedsTwoSources: {
1648
+ readonly id: "embedded-field/percent-needs-two-sources";
1649
+ readonly summary: 'A derived cell with op "percent" has exactly two sources (base, rate).';
1650
+ readonly fix: "List base and rate in from.";
1651
+ };
1652
+ readonly embeddedDerivedSourceUnknown: {
1653
+ readonly id: "embedded-field/derived-source-unknown";
1654
+ readonly summary: "A derived cell reads only sub-fields that exist in the schema.";
1655
+ readonly fix: "Read an existing sub-field.";
1656
+ };
1657
+ readonly embeddedDerivedSourceIsDerived: {
1658
+ readonly id: "embedded-field/derived-source-is-derived";
1659
+ readonly summary: "A derived cell reads stored sub-fields, not other derived cells.";
1660
+ readonly fix: "Read only stored sub-fields.";
1661
+ };
1662
+ readonly embeddedTotalsFromEmpty: {
1663
+ readonly id: "embedded-field/totals-from-empty";
1664
+ readonly summary: "A totals entry lists at least one source in from.";
1665
+ readonly fix: "List a number, money or decimal sub-field.";
1666
+ };
1667
+ readonly embeddedTotalsNotNumeric: {
1668
+ readonly id: "embedded-field/totals-not-numeric";
1669
+ readonly summary: "Totals list only number, money or decimal sub-fields.";
1670
+ readonly fix: "List only number, money or decimal sub-fields.";
1671
+ };
1672
+ readonly embeddedTotalsMatchKeyNotMoney: {
1673
+ readonly id: "embedded-field/totals-match-key-not-money";
1674
+ readonly summary: "A totalsMatch key is a money sub-field of the schema.";
1675
+ readonly fix: "Use a money sub-field as the totalsMatch key.";
1676
+ };
1677
+ readonly embeddedTotalsMatchSiblingNotMoney: {
1678
+ readonly id: "embedded-field/totals-match-sibling-not-money";
1679
+ readonly summary: "A totalsMatch value maps to a money field of the entity.";
1680
+ readonly fix: "Map it to a money field of the entity.";
1681
+ };
1682
+ readonly embeddedListOptionsOnNonList: {
1683
+ readonly id: "embedded-field/list-options-on-non-list";
1684
+ readonly summary: "minItems, maxItems, derived, totals and totalsMatch are set only on embedded lists.";
1685
+ readonly fix: "Set multiple: true or remove the options.";
1686
+ };
1687
+ }, {
1688
+ readonly multiSelectColumnsInvalid: {
1689
+ readonly id: "multi-select/columns-invalid";
1690
+ readonly summary: "Checkbox columns is 1, 2, 3 or 4.";
1691
+ readonly fix: "Use a supported columns value.";
1692
+ };
1693
+ readonly multiSelectMaxRowsInvalid: {
1694
+ readonly id: "multi-select/max-rows-invalid";
1695
+ readonly summary: "Checkbox maxRows is a positive integer.";
1696
+ readonly fix: "Set maxRows to a positive integer.";
1697
+ };
1698
+ readonly multiSelectColumnsWithoutCheckboxes: {
1699
+ readonly id: "multi-select/columns-without-checkboxes";
1700
+ readonly summary: 'columns is set only with display: "checkboxes".';
1701
+ readonly fix: 'Set display: "checkboxes" or drop columns.';
1702
+ };
1703
+ readonly multiSelectMaxRowsWithoutCheckboxes: {
1704
+ readonly id: "multi-select/max-rows-without-checkboxes";
1705
+ readonly summary: 'maxRows is set only with display: "checkboxes".';
1706
+ readonly fix: 'Set display: "checkboxes" or drop maxRows.';
1707
+ };
1708
+ readonly selectOptionToneInvalid: {
1709
+ readonly id: "select/option-tone-invalid";
1710
+ readonly summary: "Every select optionTones value is a known tone.";
1711
+ readonly fix: "Use one of the listed tones.";
1712
+ };
1713
+ readonly selectOptionsQueryUnsupported: {
1714
+ readonly id: "select/options-query-unsupported";
1715
+ readonly summary: "An entity select field has static options, no optionsQuery.";
1716
+ readonly fix: "Use static options, or a reference field.";
1717
+ };
1718
+ readonly selectAvailabilityQueryUnregistered: {
1719
+ readonly id: "select/availability-query-unregistered";
1720
+ readonly summary: "optionsAvailabilityQuery names a registered query handler.";
1721
+ readonly fix: "Check the QN spelling and register the handler via r.queryHandler(...).";
1722
+ };
1723
+ readonly conditionalOptionsWithOptionsQuery: {
1724
+ readonly id: "select/conditional-options-with-options-query";
1725
+ readonly summary: "A select field does not combine conditionalOptions with optionsQuery.";
1726
+ readonly fix: "Remove either conditionalOptions or optionsQuery.";
1727
+ };
1728
+ readonly conditionalOptionsRuleEmpty: {
1729
+ readonly id: "select/conditional-options-rule-empty";
1730
+ readonly summary: "Every conditionalOptions rule lists at least one option.";
1731
+ readonly fix: "Drop the rule or add options.";
1732
+ };
1733
+ readonly conditionalOptionUnknown: {
1734
+ readonly id: "select/conditional-option-unknown";
1735
+ readonly summary: "conditionalOptions list only options of the select field.";
1736
+ readonly fix: "List an option that exists in options.";
1737
+ };
1738
+ readonly conditionalOptionDuplicate: {
1739
+ readonly id: "select/conditional-option-duplicate";
1740
+ readonly summary: "An option belongs to one conditionalOptions rule only.";
1741
+ readonly fix: "Remove the option from one of the rules.";
1742
+ };
1743
+ readonly conditionalOptionDefault: {
1744
+ readonly id: "select/conditional-option-default";
1745
+ readonly summary: "The default option is not inside a conditionalOptions rule.";
1746
+ readonly fix: "Move the default out of the rule.";
1747
+ };
1748
+ readonly conditionalWhenOwnField: {
1749
+ readonly id: "select/conditional-when-own-field";
1750
+ readonly summary: "A conditionalOptions when depends on a different field.";
1751
+ readonly fix: "Make the condition depend on another field.";
1752
+ };
1753
+ readonly conditionalWhenUnknownField: {
1754
+ readonly id: "select/conditional-when-unknown-field";
1755
+ readonly summary: "A conditionalOptions when.field is a field of the entity.";
1756
+ readonly fix: "Use an existing field of the entity.";
1757
+ };
1758
+ readonly conditionalWhenValueNotOption: {
1759
+ readonly id: "select/conditional-when-value-not-option";
1760
+ readonly summary: "A conditionalOptions when compares only against options of the condition field.";
1761
+ readonly fix: "Compare against an option of the condition field.";
1762
+ };
1763
+ readonly multiSelectOptionsEmpty: {
1764
+ readonly id: "multi-select/options-empty";
1765
+ readonly summary: "A multiSelect field has at least one option.";
1766
+ readonly fix: "Add an option.";
1767
+ };
1768
+ readonly multiSelectDefaultNotOption: {
1769
+ readonly id: "multi-select/default-not-option";
1770
+ readonly summary: "Every multiSelect default value is one of its options.";
1771
+ readonly fix: "Use options only in default.";
1772
+ };
1773
+ readonly imageVariantName: {
1774
+ readonly id: "image-variant/name-invalid";
1775
+ readonly summary: "An image variant name matches the variant name pattern.";
1776
+ readonly fix: "Rename the variant.";
1777
+ };
1778
+ readonly imageVariantSizeAndMaxEdge: {
1779
+ readonly id: "image-variant/size-and-max-edge";
1780
+ readonly summary: "An image variant sets size or maxEdge, not both.";
1781
+ readonly fix: "Pick one.";
1782
+ };
1783
+ readonly imageVariantSizeInvalid: {
1784
+ readonly id: "image-variant/size-invalid";
1785
+ readonly summary: "An image variant size is a positive integer up to the edge limit.";
1786
+ readonly fix: "Fix width and height.";
1787
+ };
1788
+ readonly imageVariantMaxEdgeInvalid: {
1789
+ readonly id: "image-variant/max-edge-invalid";
1790
+ readonly summary: "An image variant maxEdge is a positive integer up to the edge limit.";
1791
+ readonly fix: "Fix maxEdge.";
1792
+ };
1793
+ readonly imageVariantQualityInvalid: {
1794
+ readonly id: "image-variant/quality-invalid";
1795
+ readonly summary: "An image variant quality is an integer in 1..100.";
1796
+ readonly fix: "Fix quality.";
1797
+ };
1798
+ readonly imageVariantBlurInvalid: {
1799
+ readonly id: "image-variant/blur-invalid";
1800
+ readonly summary: "An image variant blur is a finite number in (0, max].";
1801
+ readonly fix: "Fix blur.";
1802
+ };
1803
+ readonly imageVariantBlurRegionInvalid: {
1804
+ readonly id: "image-variant/blur-region-invalid";
1805
+ readonly summary: "Image variant blurRegions lie within the unit square.";
1806
+ readonly fix: "Keep x/y/width/height within 0..1.";
1807
+ };
1808
+ }, {
1809
+ readonly locatedByMissingField: {
1810
+ readonly id: "entity/located-by-missing-field";
1811
+ readonly summary: "A timestamp locatedBy names a field of the same entity.";
1812
+ readonly fix: "Declare the tz field or use createLocatedTimestampField().";
1813
+ };
1814
+ readonly locatedByNotTz: {
1815
+ readonly id: "entity/located-by-not-tz";
1816
+ readonly summary: "A timestamp locatedBy points at a tz field.";
1817
+ readonly fix: "Point locatedBy at a field of type tz.";
1818
+ };
1819
+ readonly indexColumnsEmpty: {
1820
+ readonly id: "entity-index/columns-empty";
1821
+ readonly summary: "An entity index lists at least one column.";
1822
+ readonly fix: "Add a column to the index.";
1823
+ };
1824
+ readonly indexUnknownColumn: {
1825
+ readonly id: "entity-index/unknown-column";
1826
+ readonly summary: "Every index column is a field of the entity or a base column.";
1827
+ readonly fix: "Fix the column name.";
1828
+ };
1829
+ readonly indexMultiValueColumn: {
1830
+ readonly id: "entity-index/multi-value-column";
1831
+ readonly summary: "An index does not cover a multi-value field.";
1832
+ readonly fix: "Use a single-value field or remove it from the index.";
1833
+ };
1834
+ readonly indexLongTextColumn: {
1835
+ readonly id: "entity-index/long-text-column";
1836
+ readonly summary: "An index does not cover a longText field.";
1837
+ readonly fix: "Use text if the column needs an index, or use the SearchAdapter.";
1838
+ };
1839
+ readonly indexTenantIdOnly: {
1840
+ readonly id: "entity-index/tenant-id-only";
1841
+ readonly summary: "A non-unique index is not on tenantId alone.";
1842
+ readonly fix: "Remove the entry; buildEntityTable creates it automatically.";
1843
+ };
1844
+ readonly indexUniqueEncryptedColumn: {
1845
+ readonly id: "entity-index/unique-encrypted-column";
1846
+ readonly summary: "A unique index does not cover an encrypted column.";
1847
+ readonly fix: "Remove unique or encrypted.";
1848
+ };
1849
+ readonly encryptedSearchable: {
1850
+ readonly id: "entity/encrypted-searchable";
1851
+ readonly summary: "An encrypted text field is not searchable.";
1852
+ readonly fix: "Drop searchable: true or remove the encryption.";
1853
+ };
1854
+ readonly encryptedSortable: {
1855
+ readonly id: "entity/encrypted-sortable";
1856
+ readonly summary: "An encrypted text field is not sortable.";
1857
+ readonly fix: "Drop sortable: true or remove the encryption.";
1858
+ };
1859
+ readonly encryptedFilterable: {
1860
+ readonly id: "entity/encrypted-filterable";
1861
+ readonly summary: "An encrypted text field is not filterable.";
1862
+ readonly fix: "Drop filterable: true or remove the encryption.";
1863
+ };
1864
+ readonly lockedWhenUnknownField: {
1865
+ readonly id: "locked-when/unknown-field";
1866
+ readonly summary: "The lockedWhen field is a field of the entity.";
1867
+ readonly fix: "Name an existing field.";
1868
+ };
1869
+ readonly lockedWhenCiphertextField: {
1870
+ readonly id: "locked-when/ciphertext-field";
1871
+ readonly summary: "The lockedWhen field is plaintext at rest.";
1872
+ readonly fix: "Use a plaintext field.";
1873
+ };
1874
+ readonly lockedWhenReadRestricted: {
1875
+ readonly id: "locked-when/read-restricted-field";
1876
+ readonly summary: "The lockedWhen field has no read restriction.";
1877
+ readonly fix: "Drop field access.read or use another field.";
1878
+ };
1879
+ readonly transitionUnknownField: {
1880
+ readonly id: "transition/unknown-field";
1881
+ readonly summary: "Transitions are declared for a field of the entity.";
1882
+ readonly fix: "Fix the field name.";
1883
+ };
1884
+ readonly transitionFieldNotSelect: {
1885
+ readonly id: "transition/field-not-select";
1886
+ readonly summary: "Transitions are declared for a select field.";
1887
+ readonly fix: "Declare transitions on a select field.";
1888
+ };
1889
+ readonly transitionStateNotOption: {
1890
+ readonly id: "transition/state-not-option";
1891
+ readonly summary: "Every transition source state is an option of the select field.";
1892
+ readonly fix: "Use an existing option.";
1893
+ };
1894
+ readonly transitionTargetNotOption: {
1895
+ readonly id: "transition/target-not-option";
1896
+ readonly summary: "Every transition target is an option of the select field.";
1897
+ readonly fix: "Use an existing option.";
1898
+ };
1899
+ readonly extendSchemaCollision: {
1900
+ readonly id: "entity/extend-schema-collision";
1901
+ readonly summary: "An extendSchema column does not collide with an entity field.";
1902
+ readonly fix: "Rename the extension column or the entity field.";
1903
+ };
1904
+ readonly derivedFieldCollision: {
1905
+ readonly id: "entity/derived-field-collision";
1906
+ readonly summary: "A derivedFields key does not match a stored field.";
1907
+ readonly fix: "Rename the derivedFields key or the stored field.";
1908
+ };
1909
+ readonly searchableRestrictedRead: {
1910
+ readonly id: "entity/searchable-restricted-read";
1911
+ readonly summary: "A searchable field has no restricted access.read.";
1912
+ readonly fix: 'Drop searchable/find: "fuzzy" or access.read.';
1913
+ };
1914
+ }, {
1915
+ readonly requiredWithRequiredWhen: {
1916
+ readonly id: "field-condition/required-with-required-when";
1917
+ readonly summary: "A field does not set required: true together with requiredWhen.";
1918
+ readonly fix: "Drop required; requiredWhen covers the conditional case.";
1919
+ };
1920
+ readonly requiredWithVisibleWhen: {
1921
+ readonly id: "field-condition/required-with-visible-when";
1922
+ readonly summary: "A field does not set required: true together with visibleWhen.";
1923
+ readonly fix: "Drop required and use requiredWhen with the same condition as visibleWhen.";
1924
+ };
1925
+ readonly comparisonValueNotOption: {
1926
+ readonly id: "field-condition/comparison-value-not-option";
1927
+ readonly summary: "A condition on a select field compares only against options of that field.";
1928
+ readonly fix: "Compare against one of the select field's options.";
1929
+ };
1930
+ readonly conditionOnOwnField: {
1931
+ readonly id: "field-condition/on-own-field";
1932
+ readonly summary: "A visibleWhen, requiredWhen or when condition depends on a different field or sibling.";
1933
+ readonly fix: "Point the condition's field at another field of the entity (or a sibling sub-field).";
1934
+ };
1935
+ readonly unknownConditionField: {
1936
+ readonly id: "field-condition/unknown-field";
1937
+ readonly summary: "A condition's field names a field of the entity or a sub-field of the same row.";
1938
+ readonly fix: "Use an existing field of the entity, or a sibling sub-field inside an embedded row.";
1939
+ };
1940
+ readonly conditionFieldTypeNotComparable: {
1941
+ readonly id: "field-condition/field-type-not-comparable";
1942
+ readonly summary: "A visibleWhen, requiredWhen or lockedWhen field stores a plain scalar the condition can compare.";
1943
+ readonly fix: "Use a text, select, boolean, number or reference field (more types for sub-fields).";
1944
+ };
1945
+ readonly fileSubFieldSearchable: {
1946
+ readonly id: "file-field/sub-field-searchable";
1947
+ readonly summary: "A file or image sub-field is not searchable.";
1948
+ readonly fix: "Remove searchable from the file sub-field.";
1949
+ };
1950
+ readonly fileMaxCountInvalid: {
1951
+ readonly id: "file-field/max-count-invalid";
1952
+ readonly summary: "A file sub-field maxCount is a positive integer.";
1953
+ readonly fix: "Set maxCount to a positive integer.";
1954
+ };
1955
+ readonly fileMaxSizeInvalid: {
1956
+ readonly id: "file-field/max-size-invalid";
1957
+ readonly summary: "A file sub-field maxSize is a parseable size string.";
1958
+ readonly fix: 'Use a size like "10mb" or "500kb".';
1959
+ };
1960
+ readonly acceptEntryEmpty: {
1961
+ readonly id: "file-field/accept-entry-empty";
1962
+ readonly summary: "The accept list has no empty entries.";
1963
+ readonly fix: 'List file extensions like "pdf".';
1964
+ };
1965
+ readonly acceptEntryNotBareExtension: {
1966
+ readonly id: "file-field/accept-entry-not-bare-extension";
1967
+ readonly summary: "Every accept entry is a bare lower-case file extension.";
1968
+ readonly fix: 'Use "pdf" instead of ".pdf", a MIME type or a wildcard.';
1969
+ };
1970
+ readonly optionToneNotAnOption: {
1971
+ readonly id: "embedded-field/option-tone-not-an-option";
1972
+ readonly summary: "Every optionTones key of a select sub-field is one of its options.";
1973
+ readonly fix: "Remove the tone or add the option.";
1974
+ };
1975
+ readonly derivedSourceNotNumeric: {
1976
+ readonly id: "embedded-field/derived-source-not-numeric";
1977
+ readonly summary: "A derived cell reads only number, decimal or money sub-fields.";
1978
+ readonly fix: "Point from at number, decimal or money sub-fields of the same row.";
1979
+ };
1980
+ readonly inRangeNeedsThreeSources: {
1981
+ readonly id: "embedded-field/in-range-needs-three-sources";
1982
+ readonly summary: 'A derived cell with op "inRange" has exactly three sources (value, min, max).';
1983
+ readonly fix: "List exactly value, min and max in from.";
1984
+ };
1985
+ readonly inRangeTargetNotSelect: {
1986
+ readonly id: "embedded-field/in-range-target-not-select";
1987
+ readonly summary: 'The target of an "inRange" derived cell is a select sub-field with the inside and outside options.';
1988
+ readonly fix: "Make the target a select sub-field that lists both the inside and the outside option.";
1989
+ };
1990
+ readonly derivedTargetNotNumeric: {
1991
+ readonly id: "embedded-field/derived-target-not-numeric";
1992
+ readonly summary: "The target of a derived cell is a number, decimal or money sub-field.";
1993
+ readonly fix: "Change the target sub-field's type to number, decimal or money.";
1994
+ };
1995
+ readonly derivedWhenReadsDerived: {
1996
+ readonly id: "embedded-field/derived-when-reads-derived";
1997
+ readonly summary: "A derived cell's when reads a stored sub-field, not another derived cell.";
1998
+ readonly fix: "Read a stored sub-field in when.";
1999
+ };
2000
+ readonly fileSubFieldInDerived: {
2001
+ readonly id: "embedded-field/file-sub-field-in-derived";
2002
+ readonly summary: "File sub-fields are not used in derived cells or totals.";
2003
+ readonly fix: "Remove the file sub-field from derived, totals and totalsMatch.";
2004
+ };
2005
+ }, {
2006
+ readonly sourcesMoneyMixed: {
2007
+ readonly id: "form-derive/sources-money-mixed";
2008
+ readonly summary: "The sources of a sum or subtract derivation are all money or all number/decimal.";
2009
+ readonly fix: "Use sources of one kind.";
2010
+ };
2011
+ readonly targetKindMismatch: {
2012
+ readonly id: "form-derive/target-kind-mismatch";
2013
+ readonly summary: "A derivation's target is money exactly when its sources are money.";
2014
+ readonly fix: "Change the target field type to match the sources.";
2015
+ };
2016
+ readonly tooManyMoneySources: {
2017
+ readonly id: "form-derive/too-many-money-sources";
2018
+ readonly summary: "A derivation other than sum/subtract takes at most one money source.";
2019
+ readonly fix: "Use at most one money source (for percent: the base, not the rate).";
2020
+ };
2021
+ readonly percentNeedsTwoSources: {
2022
+ readonly id: "form-derive/percent-needs-two-sources";
2023
+ readonly summary: 'A "percent" derivation has exactly two sources (base, rate).';
2024
+ readonly fix: "List base and rate in from.";
2025
+ };
2026
+ readonly unknownSourceField: {
2027
+ readonly id: "form-derive/unknown-source-field";
2028
+ readonly summary: "Every derivation source is a field of the screen.";
2029
+ readonly fix: "Name a field of this screen.";
2030
+ };
2031
+ readonly sourceNotNumeric: {
2032
+ readonly id: "form-derive/source-not-numeric";
2033
+ readonly summary: "Every derivation source is a money, number or decimal field.";
2034
+ readonly fix: "Use money, number or decimal source fields.";
2035
+ };
2036
+ readonly unknownListField: {
2037
+ readonly id: "form-derive/unknown-list-field";
2038
+ readonly summary: "The list of a listSum derivation is a field of the screen.";
2039
+ readonly fix: "Name a field of this screen.";
2040
+ };
2041
+ readonly listNotEmbeddedList: {
2042
+ readonly id: "form-derive/list-not-embedded-list";
2043
+ readonly summary: "The list of a listSum derivation is an embedded list field.";
2044
+ readonly fix: "Use an embedded field with multiple: true.";
2045
+ };
2046
+ readonly cellNotNumeric: {
2047
+ readonly id: "form-derive/cell-not-numeric";
2048
+ readonly summary: "The cell of a listSum derivation is a money, number or decimal sub-field.";
2049
+ readonly fix: "Name a numeric sub-field of the list.";
2050
+ };
2051
+ readonly listSumKindMismatch: {
2052
+ readonly id: "form-derive/list-sum-kind-mismatch";
2053
+ readonly summary: "A listSum target is money exactly when its cell is money.";
2054
+ readonly fix: "Change the target field type to match the cell.";
2055
+ };
2056
+ readonly whenEmptyListSum: {
2057
+ readonly id: "form-derive/when-empty-list-sum";
2058
+ readonly summary: "whenEmpty of a listSum is not itself a listSum.";
2059
+ readonly fix: "Use a from-based derivation as whenEmpty.";
2060
+ };
2061
+ readonly unknownTarget: {
2062
+ readonly id: "form-derive/unknown-target";
2063
+ readonly summary: "Every derive key is a field of the screen.";
2064
+ readonly fix: "Use a field name of this screen as key.";
2065
+ };
2066
+ readonly targetNotNumeric: {
2067
+ readonly id: "form-derive/target-not-numeric";
2068
+ readonly summary: "A derived field is a money, number or decimal field.";
2069
+ readonly fix: "Change the target field type to money, number or decimal.";
2070
+ };
2071
+ readonly invalidOrder: {
2072
+ readonly id: "form-derive/invalid-order";
2073
+ readonly summary: "Derivations have a valid evaluation order (no cycles).";
2074
+ readonly fix: "Remove the dependency cycle between derived fields.";
2075
+ };
2076
+ readonly handlerNotWrapped: {
2077
+ readonly id: "form-derive/handler-not-wrapped";
2078
+ readonly summary: "A screen that declares derive uses a handler wrapped with withFormDerivations.";
2079
+ readonly fix: "Wrap the handler schema: withFormDerivations(schema, screen) with this screen object.";
2080
+ };
2081
+ }, {
2082
+ readonly invalidReference: {
2083
+ readonly id: "handler-schema/invalid-references";
2084
+ readonly summary: "A references meta on an input field is an entity name, feature:entity or { entity, by? }.";
2085
+ readonly fix: 'Use "<entity>", "<feature>:<entity>" or { entity, by? }.';
2086
+ };
2087
+ readonly unknownReferenceEntity: {
2088
+ readonly id: "handler-schema/unknown-references-entity";
2089
+ readonly summary: "The entity a references meta names is registered.";
2090
+ readonly fix: 'Use "<entity>" for this feature or "<feature>:<entity>" for another one.';
2091
+ };
2092
+ readonly unknownReferenceBy: {
2093
+ readonly id: "handler-schema/unknown-references-by";
2094
+ readonly summary: "The by field of a references meta is a field of the referenced entity.";
2095
+ readonly fix: "Use an existing field of that entity for by.";
2096
+ };
2097
+ readonly zodWalkLimit: {
2098
+ readonly id: "handler-schema/zod-walk-limit";
2099
+ readonly summary: "A handler schema has a finite node count when walked.";
2100
+ readonly fix: "Hoist a z.lazy() getter that returns a new schema on every call into a constant.";
2101
+ };
2102
+ }, {
2103
+ readonly notObject: {
2104
+ readonly id: "list-table/not-object";
2105
+ readonly summary: "A list's table option is an object.";
2106
+ readonly fix: "Write table as an object such as { rememberState: true } using only the allowed keys.";
2107
+ };
2108
+ readonly unknownKeys: {
2109
+ readonly id: "list-table/unknown-keys";
2110
+ readonly summary: "A table option block uses only the keys its schema allows.";
2111
+ readonly fix: "Remove the unknown keys or rename them to one of the allowed keys.";
2112
+ };
2113
+ readonly optionNotBoolean: {
2114
+ readonly id: "list-table/option-not-boolean";
2115
+ readonly summary: "The boolean table switches (rememberState, columnPicker, pinning, ...) are booleans.";
2116
+ readonly fix: "Set the table option to true or false.";
2117
+ };
2118
+ readonly densityNotObject: {
2119
+ readonly id: "list-table/density-not-object";
2120
+ readonly summary: "table.density is an object.";
2121
+ readonly fix: 'Write table.density as { default: "compact", userChoice: true }.';
2122
+ };
2123
+ readonly densityEmpty: {
2124
+ readonly id: "list-table/density-empty";
2125
+ readonly summary: "table.density sets default and/or userChoice.";
2126
+ readonly fix: "Set default and/or userChoice, or remove table.density.";
2127
+ };
2128
+ readonly densityDefaultInvalid: {
2129
+ readonly id: "list-table/density-default-invalid";
2130
+ readonly summary: "table.density.default is one of the known densities.";
2131
+ readonly fix: "Use one of the listed density values.";
2132
+ };
2133
+ readonly densityUserChoiceNotBoolean: {
2134
+ readonly id: "list-table/density-user-choice-not-boolean";
2135
+ readonly summary: "table.density.userChoice is a boolean.";
2136
+ readonly fix: "Set userChoice to true or false.";
2137
+ };
2138
+ readonly hiddenNotBoolean: {
2139
+ readonly id: "list-table/hidden-not-boolean";
2140
+ readonly summary: "A column's hidden flag is a boolean.";
2141
+ readonly fix: "Set hidden to true or remove it.";
2142
+ };
2143
+ readonly hiddenWithoutColumnPicker: {
2144
+ readonly id: "list-table/hidden-without-column-picker";
2145
+ readonly summary: "Hidden columns need table.columnPicker, otherwise the user can never show them.";
2146
+ readonly fix: "Set table: { columnPicker: true } or remove hidden from the column.";
2147
+ };
2148
+ readonly hidesEveryColumn: {
2149
+ readonly id: "list-table/hides-every-column";
2150
+ readonly summary: "At least one list column starts visible.";
2151
+ readonly fix: "Remove hidden from one column.";
2152
+ };
2153
+ readonly exportNotAllowed: {
2154
+ readonly id: "list-table/export-not-allowed";
2155
+ readonly summary: "table.export is only declared on entityList and projectionList screens.";
2156
+ readonly fix: "Remove table.export from this screen or section.";
2157
+ };
2158
+ readonly exportNotObject: {
2159
+ readonly id: "list-table/export-not-object";
2160
+ readonly summary: "table.export is an object.";
2161
+ readonly fix: "Write table.export as { xlsx: true, maxRows: 5000 }.";
2162
+ };
2163
+ readonly exportXlsxNotTrue: {
2164
+ readonly id: "list-table/export-xlsx-not-true";
2165
+ readonly summary: "table.export.xlsx is true, the only export format.";
2166
+ readonly fix: "Set xlsx: true.";
2167
+ };
2168
+ readonly exportMaxRowsInvalid: {
2169
+ readonly id: "list-table/export-max-rows-invalid";
2170
+ readonly summary: "table.export.maxRows is an integer of at least 1.";
2171
+ readonly fix: "Set a positive integer row limit or remove maxRows to use the default.";
2172
+ };
2173
+ readonly exportMaxRowsTooLarge: {
2174
+ readonly id: "list-table/export-max-rows-too-large";
2175
+ readonly summary: "table.export.maxRows stays within the in-memory workbook limit.";
2176
+ readonly fix: "Lower maxRows to the allowed maximum.";
2177
+ };
2178
+ readonly columnPinnedInvalid: {
2179
+ readonly id: "list-table/column-pinned-invalid";
2180
+ readonly summary: "A column's pinned value is one of the known pin sides.";
2181
+ readonly fix: "Use one of the listed pin values.";
2182
+ };
2183
+ readonly columnPinnedWithoutPinning: {
2184
+ readonly id: "list-table/column-pinned-without-pinning";
2185
+ readonly summary: "A pinned column needs table.pinning, otherwise the pin has no effect.";
2186
+ readonly fix: "Set table: { pinning: true } or remove pinned from the column.";
2187
+ };
2188
+ readonly columnWidthInvalid: {
2189
+ readonly id: "list-table/column-width-invalid";
2190
+ readonly summary: "A column's width and minWidth are finite pixel counts greater than 0.";
2191
+ readonly fix: "Set a positive finite number or remove the option.";
2192
+ };
2193
+ readonly columnWidthWithoutResizing: {
2194
+ readonly id: "list-table/column-width-without-resizing";
2195
+ readonly summary: "A column's width or minWidth needs table.resizing, otherwise it has no effect.";
2196
+ readonly fix: "Set table: { resizing: true } or remove width and minWidth from the column.";
2197
+ };
2198
+ readonly columnMinWidthExceedsWidth: {
2199
+ readonly id: "list-table/column-min-width-exceeds-width";
2200
+ readonly summary: "A column's minWidth is not greater than its width.";
2201
+ readonly fix: "Lower minWidth or raise width.";
2202
+ };
2203
+ readonly bundledListsNotObject: {
2204
+ readonly id: "bundled-lists/not-object";
2205
+ readonly summary: "The bundledLists option is an object.";
2206
+ readonly fix: "Write bundledLists as an object such as { table: { columnPicker: true } }.";
2207
+ };
2208
+ readonly bundledListsUnknownKey: {
2209
+ readonly id: "bundled-lists/unknown-key";
2210
+ readonly summary: "bundledLists uses only the allowed keys.";
2211
+ readonly fix: "Remove the unknown keys or rename them to one of the allowed keys.";
2212
+ };
2213
+ readonly bundledListsTableNotObject: {
2214
+ readonly id: "bundled-lists/table-not-object";
2215
+ readonly summary: "bundledLists.table is an object.";
2216
+ readonly fix: "Write bundledLists.table as an object such as { columnPicker: true }.";
2217
+ };
2218
+ readonly bundledListsScreenOnlyKey: {
2219
+ readonly id: "bundled-lists/screen-only-table-key";
2220
+ readonly summary: "bundledLists.table leaves out grouping and totals, which depend on one list's fields.";
2221
+ readonly fix: "Set grouping and totals in the table block of the individual screen.";
2222
+ };
2223
+ readonly bundledListsPinFirstColumnNotBoolean: {
2224
+ readonly id: "bundled-lists/pin-first-column-not-boolean";
2225
+ readonly summary: "bundledLists.pinFirstColumn is a boolean.";
2226
+ readonly fix: "Set pinFirstColumn to true or false.";
2227
+ };
2228
+ readonly bundledListsPinFirstColumnWithoutPinning: {
2229
+ readonly id: "bundled-lists/pin-first-column-without-pinning";
2230
+ readonly summary: "bundledLists.pinFirstColumn needs bundledLists.table.pinning.";
2231
+ readonly fix: "Set bundledLists.table.pinning: true or remove pinFirstColumn.";
2232
+ };
2233
+ }, {
2234
+ readonly groupingNotObject: {
2235
+ readonly id: "list-table/grouping-not-object";
2236
+ readonly summary: "table.grouping is an object.";
2237
+ readonly fix: 'Write table.grouping as { field: "status" }.';
2238
+ };
2239
+ readonly groupingValueInvalid: {
2240
+ readonly id: "list-table/grouping-value-invalid";
2241
+ readonly summary: "Each table.grouping option has the value type its schema expects.";
2242
+ readonly fix: "Change the option to the type named in the message.";
2243
+ };
2244
+ readonly groupingNoField: {
2245
+ readonly id: "list-table/grouping-no-field";
2246
+ readonly summary: "table.grouping names a field, or offers fields with userChoice: true.";
2247
+ readonly fix: "Set field, or userChoice: true with at least one entry in fields.";
2248
+ };
2249
+ readonly groupingFieldsWithoutUserChoice: {
2250
+ readonly id: "list-table/grouping-fields-without-user-choice";
2251
+ readonly summary: "table.grouping.fields comes with userChoice: true, otherwise the user cannot pick them.";
2252
+ readonly fix: "Set userChoice: true or remove fields.";
2253
+ };
2254
+ readonly totalsNotArray: {
2255
+ readonly id: "list-table/totals-not-array";
2256
+ readonly summary: "table.totals is a non-empty array.";
2257
+ readonly fix: 'Write table.totals as [{ field: "amount", kind: "sum" }] or remove it.';
2258
+ };
2259
+ readonly totalEntryNotObject: {
2260
+ readonly id: "list-table/total-entry-not-object";
2261
+ readonly summary: "Every table.totals entry is an object.";
2262
+ readonly fix: "Write each entry as { field, kind }.";
2263
+ };
2264
+ readonly totalFieldNotString: {
2265
+ readonly id: "list-table/total-field-not-string";
2266
+ readonly summary: "A table.totals entry names its field as a string.";
2267
+ readonly fix: "Set field to a field name.";
2268
+ };
2269
+ readonly totalKindInvalid: {
2270
+ readonly id: "list-table/total-kind-invalid";
2271
+ readonly summary: "A table.totals entry uses a supported aggregate kind.";
2272
+ readonly fix: "Use one of the listed kinds.";
2273
+ };
2274
+ readonly aggregateFieldNotColumn: {
2275
+ readonly id: "list-table/aggregate-field-not-column";
2276
+ readonly summary: "Fields used by table.grouping and table.totals are columns of the screen.";
2277
+ readonly fix: "Add the field to the screen's columns or use a listed column.";
2278
+ };
2279
+ readonly aggregateFieldNotOnEntity: {
2280
+ readonly id: "list-table/aggregate-field-not-on-entity";
2281
+ readonly summary: "Fields used by table.grouping and table.totals exist on the entity behind the list.";
2282
+ readonly fix: "Use a field of the entity.";
2283
+ };
2284
+ readonly aggregateFieldSecret: {
2285
+ readonly id: "list-table/aggregate-field-secret";
2286
+ readonly summary: "table.grouping and table.totals skip encrypted, personal and secret fields.";
2287
+ readonly fix: "Pick a field that is not encrypted, personal or secret.";
2288
+ };
2289
+ readonly groupingFieldNotGroupable: {
2290
+ readonly id: "list-table/grouping-field-not-groupable";
2291
+ readonly summary: "table.grouping uses only field types that can be grouped by.";
2292
+ readonly fix: "Group by a groupable field.";
2293
+ };
2294
+ readonly totalKindUnsupported: {
2295
+ readonly id: "list-table/total-kind-unsupported";
2296
+ readonly summary: "A table.totals kind is supported on the type of its field.";
2297
+ readonly fix: "Use sum or avg on number, decimal, money or bigInt fields; min and max also take date and timestamp.";
2298
+ };
2299
+ readonly aggregateParamMissing: {
2300
+ readonly id: "list-table/aggregate-param-missing";
2301
+ readonly summary: "A list with table.grouping or table.totals binds a query that accepts aggregate.";
2302
+ readonly fix: "Reuse entityListSchema or listAggregatePayloadSchema, answer it with answerListAggregate, or remove grouping and totals.";
2303
+ };
2304
+ readonly rangeFacetFieldType: {
2305
+ readonly id: "list-table/range-facet-field-type";
2306
+ readonly summary: 'A facet with display "range" is on a number, decimal, money or bigInt field.';
2307
+ readonly fix: "Use another facet display or a numeric field.";
2308
+ };
2309
+ readonly rangeFacetNotFilterable: {
2310
+ readonly id: "list-table/range-facet-not-filterable";
2311
+ readonly summary: 'A facet with display "range" is on a filterable field that is not encrypted, personal or secret.';
2312
+ readonly fix: "Set filterable: true on the field or drop the range facet.";
2313
+ };
2314
+ }, {
2315
+ readonly derivedFlagHandAuthored: {
2316
+ readonly id: "list-query/derived-flag-hand-authored";
2317
+ readonly summary: "A projectionList sets neither sortable nor paginated, both come from the query's Zod schema.";
2318
+ readonly fix: "Remove sortable and paginated from the screen.";
2319
+ };
2320
+ readonly searchableWithoutSearchParam: {
2321
+ readonly id: "list-query/searchable-without-search-param";
2322
+ readonly summary: 'A searchable list binds a query whose Zod schema has a "search" parameter.';
2323
+ readonly fix: 'Add a "search" field to the query schema or remove searchable: true.';
2324
+ };
2325
+ readonly searchableWithoutSearchableField: {
2326
+ readonly id: "list-query/searchable-without-searchable-field";
2327
+ readonly summary: "A searchable projectionList does not list an entity that has no searchable field.";
2328
+ readonly fix: "Mark a field searchable: true on the entity or remove searchable: true.";
2329
+ };
2330
+ readonly searchableFalseDisablesSearch: {
2331
+ readonly id: "list-query/searchable-false-disables-search";
2332
+ readonly summary: 'A projectionList whose query accepts "search" is searchable unless it is on the searchable-false whitelist.';
2333
+ readonly fix: "Remove searchable: false or add the screen id to SEARCHABLE_FALSE_WHITELIST.";
2334
+ };
2335
+ readonly defaultSortRequired: {
2336
+ readonly id: "list-query/default-sort-required";
2337
+ readonly summary: "A projectionList with active search or sort declares a defaultSort.";
2338
+ readonly fix: "Set defaultSort: { field, direction } on the screen.";
2339
+ };
2340
+ readonly filterParamMissing: {
2341
+ readonly id: "list-query/filter-param-missing";
2342
+ readonly summary: 'A projectionList that declares filter binds a query with a "filter" parameter.';
2343
+ readonly fix: "Add a filter parameter to the handler's schema, or reuse entityListSchema's shape.";
2344
+ };
2345
+ readonly facetsWithoutFiltersParam: {
2346
+ readonly id: "list-query/facets-without-filters-param";
2347
+ readonly summary: 'A list that declares facets sent as filters binds a query with a "filters" parameter.';
2348
+ readonly fix: "Add a filters parameter to the handler's schema, or reuse entityListSchema's shape.";
2349
+ };
2350
+ readonly dateRangeSameParam: {
2351
+ readonly id: "list-query/date-range-same-param";
2352
+ readonly summary: "A dateRange facet names different params for its from and to bounds.";
2353
+ readonly fix: "Use two different param names for from and to.";
2354
+ };
2355
+ readonly dateRangeReservedParam: {
2356
+ readonly id: "list-query/date-range-reserved-param";
2357
+ readonly summary: "A dateRange facet bound does not use a reserved list-payload key.";
2358
+ readonly fix: "Pick the query's own time-bound param names.";
2359
+ };
2360
+ readonly dateRangeParamReused: {
2361
+ readonly id: "list-query/date-range-param-reused";
2362
+ readonly summary: "Each dateRange facet on a screen uses its own param names.";
2363
+ readonly fix: "Give each dateRange facet its own param names.";
2364
+ };
2365
+ readonly dateRangeParamMissing: {
2366
+ readonly id: "list-query/date-range-param-missing";
2367
+ readonly summary: "The query accepts every param a dateRange facet sends.";
2368
+ readonly fix: "Add the param to the handler's schema or point params at keys it already accepts.";
2369
+ };
2370
+ readonly countNeedsTabsLayout: {
2371
+ readonly id: "list-query/count-needs-tabs-layout";
2372
+ readonly summary: 'A relatedList section with count: true sits in a layout with mode "tabs".';
2373
+ readonly fix: 'Use mode "tabs" or remove count.';
2374
+ };
2375
+ readonly countAndCountField: {
2376
+ readonly id: "list-query/count-and-count-field";
2377
+ readonly summary: "A relatedList section declares either count or countField.";
2378
+ readonly fix: "Pick one badge source.";
2379
+ };
2380
+ readonly countParamMissing: {
2381
+ readonly id: "list-query/count-param-missing";
2382
+ readonly summary: "A relatedList section with count: true binds a query that accepts limit and totalCount.";
2383
+ readonly fix: "Add the missing parameter to the query's Zod schema.";
2384
+ };
2385
+ readonly parentFilterAndParentParam: {
2386
+ readonly id: "list-query/parent-filter-and-parent-param";
2387
+ readonly summary: "A relatedList section declares parentFilter or parentParam, not both.";
2388
+ readonly fix: "Remove parentParam or drop parentFilter.";
2389
+ };
2390
+ readonly parentFilterParamMissing: {
2391
+ readonly id: "list-query/parent-filter-param-missing";
2392
+ readonly summary: 'A relatedList section with parentFilter binds a query with a "filter" parameter.';
2393
+ readonly fix: "Add a filter parameter to the handler's schema, or reuse entityListSchema's shape.";
2394
+ };
2395
+ readonly parentFilterFieldUnknown: {
2396
+ readonly id: "list-query/parent-filter-field-unknown";
2397
+ readonly summary: "parentFilter.field is a declared field of the entity behind the section's query.";
2398
+ readonly fix: "Use one of the known fields named in the message.";
2399
+ };
2400
+ readonly groupByRemoved: {
2401
+ readonly id: "related-list/group-by-removed";
2402
+ readonly summary: "A relatedList section or expandableRow does not use the removed groupBy.";
2403
+ readonly fix: "Use table.grouping and make the bound query accept aggregate.";
2404
+ };
2405
+ readonly expandableRowTableKeys: {
2406
+ readonly id: "related-list/expandable-row-table-keys";
2407
+ readonly summary: "An entityList expandableRow sets only table.grouping.";
2408
+ readonly fix: "Put the other table options on the entityList screen itself.";
2409
+ };
2410
+ readonly expandableRowGroupingChoice: {
2411
+ readonly id: "related-list/expandable-row-grouping-choice";
2412
+ readonly summary: "An expandableRow sets no table.grouping.userChoice or fields, it has no view menu.";
2413
+ readonly fix: "Set a fixed table.grouping.field.";
2414
+ };
2415
+ readonly expandableRowBulkActions: {
2416
+ readonly id: "related-list/expandable-row-bulk-actions";
2417
+ readonly summary: "An entityList expandableRow declares no bulkActions.";
2418
+ readonly fix: "Put bulkActions on the entityList screen itself.";
2419
+ };
2420
+ }, {
2421
+ readonly notArray: {
2422
+ readonly id: "list-bulk/not-array";
2423
+ readonly summary: "bulkActions is a non-empty array.";
2424
+ readonly fix: 'Write bulkActions as [{ id: "archive", rowAction: "archive" }] or remove it.';
2425
+ };
2426
+ readonly entryNotObject: {
2427
+ readonly id: "list-bulk/entry-not-object";
2428
+ readonly summary: "Every bulkActions entry is an object with id and rowAction.";
2429
+ readonly fix: "Write each entry as { id, rowAction }.";
2430
+ };
2431
+ readonly idNotKebab: {
2432
+ readonly id: "list-bulk/id-not-kebab";
2433
+ readonly summary: "A bulk action id is a kebab-case string.";
2434
+ readonly fix: "Rename the id to kebab-case.";
2435
+ };
2436
+ readonly idDuplicate: {
2437
+ readonly id: "list-bulk/id-duplicate";
2438
+ readonly summary: "Bulk action ids are unique within a list.";
2439
+ readonly fix: "Rename or remove the duplicate bulk action.";
2440
+ };
2441
+ readonly unknownKey: {
2442
+ readonly id: "list-bulk/unknown-key";
2443
+ readonly summary: "A bulk action uses only the allowed keys.";
2444
+ readonly fix: "Remove the unknown keys.";
2445
+ };
2446
+ readonly rowActionMissing: {
2447
+ readonly id: "list-bulk/row-action-missing";
2448
+ readonly summary: "A bulk action names the id of a row action in rowAction.";
2449
+ readonly fix: "Set rowAction to the id of a declared row action.";
2450
+ };
2451
+ readonly rowActionUndeclared: {
2452
+ readonly id: "list-bulk/row-action-undeclared";
2453
+ readonly summary: "A bulk action's rowAction is declared in the list's rowActions.";
2454
+ readonly fix: "Declare the row action in rowActions or point rowAction at a declared one.";
2455
+ };
2456
+ readonly rowActionNotWriteHandler: {
2457
+ readonly id: "list-bulk/row-action-not-write-handler";
2458
+ readonly summary: "Bulk actions run one server write per row, so they point at writeHandler row actions.";
2459
+ readonly fix: "Point rowAction at a writeHandler row action.";
2460
+ };
2461
+ }, {
2462
+ readonly notRegistered: {
2463
+ readonly id: "query/not-registered";
2464
+ readonly summary: "A query reference on a screen names a registered query handler.";
2465
+ readonly fix: 'Check the QN spelling ("<feature>:query:<short>") and declare the handler via r.queryHandler(...).';
2466
+ };
2467
+ readonly visibleWhenRequiresInput: {
2468
+ readonly id: "query/visible-when-requires-input";
2469
+ readonly summary: "A visibleWhen query parses the payload the gate sends.";
2470
+ readonly fix: "Make the query's input fields optional, use a query without required input, or for projectionDetail set visibleWhen.idParam.";
2471
+ };
2472
+ readonly visibleWhenIdParamUnsupported: {
2473
+ readonly id: "query/visible-when-id-param-unsupported";
2474
+ readonly summary: "visibleWhen.idParam is used only on projectionDetail screens.";
2475
+ readonly fix: "Remove idParam or use a projectionDetail screen.";
2476
+ };
2477
+ readonly singletonLoadRequiresInput: {
2478
+ readonly id: "query/singleton-load-requires-input";
2479
+ readonly summary: "An actionForm singleton load binds a query that parses an empty payload.";
2480
+ readonly fix: "Make the query's input fields optional.";
2481
+ };
2482
+ readonly outputFieldMissing: {
2483
+ readonly id: "query/output-field-missing";
2484
+ readonly summary: "A field a screen reads from a query result exists in the query's outputSchema.";
2485
+ readonly fix: "Check the field name for a typo or add the field to the outputSchema.";
2486
+ };
2487
+ readonly pagedOutputWithoutRows: {
2488
+ readonly id: "query/paged-output-without-rows";
2489
+ readonly summary: "A paged query handler's outputSchema describes the paged envelope with a rows field.";
2490
+ readonly fix: "Wrap the row schema in the { rows, nextCursor, total? } envelope.";
2491
+ };
2492
+ readonly listSourceOutputWithoutRows: {
2493
+ readonly id: "query/list-source-output-without-rows";
2494
+ readonly summary: "A query used as a list source has an outputSchema describing the paged envelope with a rows field.";
2495
+ readonly fix: "Wrap the row schema in the { rows, nextCursor, total? } envelope.";
2496
+ };
2497
+ }, {
2498
+ readonly fileStorageProviderMissing: {
2499
+ readonly id: "file-storage/provider-env-missing";
2500
+ readonly summary: "An app with file or image fields sets the FILE_STORAGE_PROVIDER environment variable.";
2501
+ readonly fix: "Set FILE_STORAGE_PROVIDER in the environment.";
2502
+ };
2503
+ readonly duplicateExposedApi: {
2504
+ readonly id: "api/duplicate-exposed-name";
2505
+ readonly summary: "A cross-feature API name is exposed by exactly one feature.";
2506
+ readonly fix: "Rename the API in one of the exposing features.";
2507
+ };
2508
+ }, {
2509
+ readonly boundsNonNumber: {
2510
+ readonly id: "config-key/bounds-non-number";
2511
+ readonly summary: "A config key declares bounds only when its type is number.";
2512
+ readonly fix: 'Remove bounds or change the key type to "number".';
2513
+ };
2514
+ readonly boundsMinAboveMax: {
2515
+ readonly id: "config-key/bounds-min-above-max";
2516
+ readonly summary: "A config key's bounds.min is at or below its bounds.max.";
2517
+ readonly fix: "Set bounds.min to a value at or below bounds.max.";
2518
+ };
2519
+ readonly defaultBelowMin: {
2520
+ readonly id: "config-key/default-below-min";
2521
+ readonly summary: "A config key's default is not below its bounds.min.";
2522
+ readonly fix: "Raise the default or lower bounds.min.";
2523
+ };
2524
+ readonly defaultAboveMax: {
2525
+ readonly id: "config-key/default-above-max";
2526
+ readonly summary: "A config key's default is not above its bounds.max.";
2527
+ readonly fix: "Lower the default or raise bounds.max.";
2528
+ };
2529
+ readonly computedAndEncrypted: {
2530
+ readonly id: "config-key/computed-and-encrypted";
2531
+ readonly summary: 'A config key is either encrypted (encrypted or backing="secrets") or computed, never both.';
2532
+ readonly fix: 'Use either encrypted/backing="secrets" or a computed resolver on the key.';
2533
+ };
2534
+ readonly requiredWithComputed: {
2535
+ readonly id: "config-key/required-with-computed";
2536
+ readonly summary: "A computed config key is not marked required, because it can never be missing.";
2537
+ readonly fix: "Drop required or the computed resolver.";
2538
+ };
2539
+ readonly requiredWithDefault: {
2540
+ readonly id: "config-key/required-with-default";
2541
+ readonly summary: "A required config key has no non-empty default, otherwise it can never be unset and readiness never flags it.";
2542
+ readonly fix: 'Use default "" or drop required.';
2543
+ };
2544
+ readonly perRequestText: {
2545
+ readonly id: "config-key/per-request-text";
2546
+ readonly summary: 'A config key of type "text" does not set allowPerRequest (XSS/injection risk).';
2547
+ readonly fix: "Remove allowPerRequest or change the key type.";
2548
+ };
2549
+ readonly perRequestEncrypted: {
2550
+ readonly id: "config-key/per-request-encrypted";
2551
+ readonly summary: 'A config key with encrypted/backing="secrets" does not set allowPerRequest.';
2552
+ readonly fix: "Remove allowPerRequest or the secrets storage from the key.";
2553
+ };
2554
+ readonly conditionalOptions: {
2555
+ readonly id: "config-key/conditional-options";
2556
+ readonly summary: "A config key does not declare conditionalOptions, which only entity select fields support.";
2557
+ readonly fix: "Remove conditionalOptions from the config key.";
2558
+ };
2559
+ readonly optionsQueryPayloadWithoutQuery: {
2560
+ readonly id: "config-key/options-query-payload-without-query";
2561
+ readonly summary: "A config key that declares optionsQueryPayload also declares optionsQuery.";
2562
+ readonly fix: "Set optionsQuery or remove optionsQueryPayload.";
2563
+ };
2564
+ readonly optionsQueryEmpty: {
2565
+ readonly id: "config-key/options-query-empty";
2566
+ readonly summary: "A config key's optionsQuery is a non-empty query name when present.";
2567
+ readonly fix: "Set it to a query name or remove it.";
2568
+ };
2569
+ readonly optionsQueryNotSelect: {
2570
+ readonly id: "config-key/options-query-not-select";
2571
+ readonly summary: 'A config key declares optionsQuery only when its type is "select".';
2572
+ readonly fix: 'Change the key type to "select" or remove optionsQuery.';
2573
+ };
2574
+ readonly optionsAndOptionsQuery: {
2575
+ readonly id: "config-key/options-and-options-query";
2576
+ readonly summary: "A config key declares either static options or optionsQuery, not both.";
2577
+ readonly fix: "Remove options or optionsQuery.";
2578
+ };
2579
+ readonly optionsQueryPerRequest: {
2580
+ readonly id: "config-key/options-query-per-request";
2581
+ readonly summary: "A config key with optionsQuery does not set allowPerRequest, which would bypass the option set unchecked.";
2582
+ readonly fix: "Remove allowPerRequest or optionsQuery.";
2583
+ };
2584
+ readonly optionsQueryPayloadSelfReference: {
2585
+ readonly id: "config-key/options-query-payload-self-reference";
2586
+ readonly summary: "A config key's optionsQueryPayload does not reference the key itself.";
2587
+ readonly fix: "Reference a different config key.";
2588
+ };
2589
+ readonly optionsQueryPayloadUnknownKey: {
2590
+ readonly id: "config-key/options-query-payload-unknown-key";
2591
+ readonly summary: "A config key's optionsQueryPayload references only config keys of the same feature.";
2592
+ readonly fix: "Reference an existing config key of the feature or remove the entry.";
2593
+ };
2594
+ readonly secretsScopeNotSystem: {
2595
+ readonly id: "config-key/secrets-scope-not-system";
2596
+ readonly summary: 'A config key with backing="secrets" has scope "system", because secrets storage does not cascade.';
2597
+ readonly fix: 'Set scope to "system" or drop backing="secrets".';
2598
+ };
2599
+ readonly piiEncryptedNotText: {
2600
+ readonly id: "config-key/pii-encrypted-not-text";
2601
+ readonly summary: 'A config key with piiEncrypted has type "text".';
2602
+ readonly fix: 'Use type="text" or remove piiEncrypted.';
2603
+ };
2604
+ readonly piiEncryptedSystemScope: {
2605
+ readonly id: "config-key/pii-encrypted-system-scope";
2606
+ readonly summary: "A config key with piiEncrypted is not system-scoped, because system scope has no subject to encrypt under.";
2607
+ readonly fix: 'Use scope="tenant" or "user", or remove piiEncrypted.';
2608
+ };
2609
+ readonly piiEncryptedAndEncrypted: {
2610
+ readonly id: "config-key/pii-encrypted-and-encrypted";
2611
+ readonly summary: 'A config key uses piiEncrypted or encrypted/backing="secrets", never both.';
2612
+ readonly fix: "Pick one of piiEncrypted (subject-KMS) or encrypted (shared cipher).";
2613
+ };
2614
+ readonly unknownConfigRead: {
2615
+ readonly id: "config-key/unknown-config-read";
2616
+ readonly summary: "A feature reads only config keys that some feature defines.";
2617
+ readonly fix: "Declare the key via r.config(...) in a feature, or fix the key name.";
2618
+ };
2619
+ readonly circularDependency: {
2620
+ readonly id: "feature/circular-dependency";
2621
+ readonly summary: "Feature requires() links form no cycle.";
2622
+ readonly fix: "Break the cycle by removing one requires() link.";
2623
+ };
2624
+ }, {
2625
+ readonly parentRefTypeFieldUnknown: {
2626
+ readonly id: "parent-ref/entity-type-field-unknown";
2627
+ readonly summary: "parentRef.entityTypeField names a declared field of the entity.";
2628
+ readonly fix: "Point entityTypeField at a real field on the entity.";
2629
+ };
2630
+ readonly parentRefIdFieldUnknown: {
2631
+ readonly id: "parent-ref/entity-id-field-unknown";
2632
+ readonly summary: "parentRef.entityIdField names a declared field of the entity.";
2633
+ readonly fix: "Point entityIdField at a real field on the entity.";
2634
+ };
2635
+ readonly parentRefAllowedTypeUnregistered: {
2636
+ readonly id: "parent-ref/allowed-type-unregistered";
2637
+ readonly summary: "parentRef.allowedTypes names only registered entities.";
2638
+ readonly fix: "Remove the name from allowedTypes, or register the entity.";
2639
+ };
2640
+ readonly parentRefAllowedTypeHasParentRef: {
2641
+ readonly id: "parent-ref/allowed-type-has-parent-ref";
2642
+ readonly summary: "A parentRef host entity does not itself declare a parentRef (no recursive gating).";
2643
+ readonly fix: "Remove the host from allowedTypes, or drop its own parentRef.";
2644
+ };
2645
+ readonly parentRefHandWrittenQuery: {
2646
+ readonly id: "parent-ref/hand-written-query-handler";
2647
+ readonly summary: "Query handlers on an entity with parentRef carry the entity-convention brand, so the parent-ref read-gate applies.";
2648
+ readonly fix: "Register the handler via defineEntityListHandler/defineEntityDetailHandler, or pass parentVisibility to the executor.";
2649
+ };
2650
+ readonly readGateWithParentRef: {
2651
+ readonly id: "read-gate/with-parent-ref";
2652
+ readonly summary: "An entity with readGate does not also declare parentRef.";
2653
+ readonly fix: "Drop readGate or parentRef.";
2654
+ };
2655
+ readonly readGateAnyAndAllLinks: {
2656
+ readonly id: "read-gate/any-and-all-links";
2657
+ readonly summary: "A readGate declares anyLink or allLinks, not both.";
2658
+ readonly fix: "Pick one of anyLink and allLinks.";
2659
+ };
2660
+ readonly readGateLinkEntityUnregistered: {
2661
+ readonly id: "read-gate/link-entity-unregistered";
2662
+ readonly summary: "A readGate link names a registered entity.";
2663
+ readonly fix: "Register the entity or fix the readGate link entity name.";
2664
+ };
2665
+ readonly readGateLinkWithoutParentRef: {
2666
+ readonly id: "read-gate/link-entity-without-parent-ref";
2667
+ readonly summary: "A readGate link entity declares a parentRef, because its host visibility is what the gate checks.";
2668
+ readonly fix: "Declare a parentRef on the link entity or use another entity.";
2669
+ };
2670
+ readonly readGateLinkFieldUnknown: {
2671
+ readonly id: "read-gate/link-field-unknown";
2672
+ readonly summary: "A readGate link field is a field of the link entity.";
2673
+ readonly fix: "Point the link field at a real field of the link entity.";
2674
+ };
2675
+ readonly readGateFileOwnerFieldType: {
2676
+ readonly id: "read-gate/file-owner-field-type";
2677
+ readonly summary: "readGate.fileOwner.field is a single file or image field.";
2678
+ readonly fix: "Point fileOwner.field at a single file or image field.";
2679
+ };
2680
+ readonly readGateFileOwnerNeedsFiles: {
2681
+ readonly id: "read-gate/file-owner-needs-files-feature";
2682
+ readonly summary: "readGate.fileOwner requires the files feature to be mounted.";
2683
+ readonly fix: "Mount the files feature.";
2684
+ };
2685
+ readonly readGateHandWrittenReader: {
2686
+ readonly id: "read-gate/hand-written-reader";
2687
+ readonly summary: "A gated entity's list and detail query handlers are entity-convention handlers, so they cannot bypass the readGate.";
2688
+ readonly fix: "Register them via defineEntityListHandler/defineEntityDetailHandler.";
2689
+ };
2690
+ readonly transferMultipleReference: {
2691
+ readonly id: "transfer/multiple-reference-field";
2692
+ readonly summary: "A transferable entity declares no multiple reference field to another transferable entity, since the transfer graph cannot match jsonb array rows.";
2693
+ readonly fix: "Model the link as a single reference on the owning side, or drop transferable from the entity.";
2694
+ };
2695
+ readonly transferGraphTooDeep: {
2696
+ readonly id: "transfer/graph-too-deep";
2697
+ readonly summary: "The tenant-handover transfer graph is not deeper than the maximum depth.";
2698
+ readonly fix: 'Flatten the chain, or mark a reference field that should not move with its host `handover: "stay"`.';
2699
+ };
2700
+ readonly globalWithoutSystemStream: {
2701
+ readonly id: "entity/global-without-system-stream";
2702
+ readonly summary: 'An entity with tenancy "global" also declares systemStream: true.';
2703
+ readonly fix: "Declare systemStream: true on the entity.";
2704
+ };
2705
+ readonly globalWithoutSystemScope: {
2706
+ readonly id: "entity/global-without-system-scope";
2707
+ readonly summary: 'A feature that owns an entity with tenancy "global" declares r.systemScope().';
2708
+ readonly fix: "Declare r.systemScope() in the owning feature.";
2709
+ };
2710
+ readonly recordOwnedSerialId: {
2711
+ readonly id: "pii/record-owned-serial-id";
2712
+ readonly summary: 'A recordOwned (or whenAbsent: "self") field lives only on entities with idType "uuid", because forgetSubject validates the record id as a UUID.';
2713
+ readonly fix: 'Set idType: "uuid" on the entity, or give the field a different personal stance.';
2714
+ };
2715
+ }, {
2716
+ readonly openToAllReasonInvalid: {
2717
+ readonly id: "handler/open-to-all-reason-invalid";
2718
+ readonly summary: "An openToAll declaration is an object with a valid reason explaining why any authenticated user may call the handler.";
2719
+ readonly fix: 'Declare { openToAll: { reason: "<explanation>" } }.';
2720
+ };
2721
+ readonly escapeHatchGrantsInvalid: {
2722
+ readonly id: "handler/escape-hatch-grants-invalid";
2723
+ readonly summary: "An escapeHatch declares valid grants.";
2724
+ readonly fix: "Correct the escapeHatch grants as named in the error message.";
2725
+ };
2726
+ readonly escapeHatchReasonInvalid: {
2727
+ readonly id: "handler/escape-hatch-reason-invalid";
2728
+ readonly summary: "An escapeHatch carries a valid reason.";
2729
+ readonly fix: "Write an escapeHatch reason that explains the bypass.";
2730
+ };
2731
+ readonly personalDataUnsupportedForKind: {
2732
+ readonly id: "handler/personal-data-unsupported-for-kind";
2733
+ readonly summary: "A personalData declaration appears only on handler kinds whose input is checked for personal-data fields.";
2734
+ readonly fix: "Remove the personalData declaration from this handler.";
2735
+ };
2736
+ readonly openToAllPersonalDataUnknown: {
2737
+ readonly id: "handler/open-to-all-personal-data-unknown";
2738
+ readonly summary: 'openToAll.personalData is "tenant-members" when set.';
2739
+ readonly fix: 'Use personalData: "tenant-members" or remove it.';
2740
+ };
2741
+ readonly accessPersonalDataUnknown: {
2742
+ readonly id: "handler/access-personal-data-unknown";
2743
+ readonly summary: 'access.personalData is "public-intake" when set.';
2744
+ readonly fix: 'Use personalData: "public-intake" or remove it.';
2745
+ };
2746
+ readonly publicIntakeWithoutAnonymous: {
2747
+ readonly id: "handler/public-intake-without-anonymous";
2748
+ readonly summary: 'A handler with access.personalData "public-intake" allows the anonymous role.';
2749
+ readonly fix: "Add the anonymous role to access.roles or remove personalData.";
2750
+ };
2751
+ readonly publicIntakeRateLimitDisabled: {
2752
+ readonly id: "handler/public-intake-rate-limit-disabled";
2753
+ readonly summary: 'A handler with access.personalData "public-intake" keeps its rateLimit enabled, because it is the only protection for anonymous personal-data writes.';
2754
+ readonly fix: 'Declare rateLimit: { per: "ip" or "ip+handler", ... } instead of disabling it.';
2755
+ };
2756
+ readonly inputSchemaNotIntrospectable: {
2757
+ readonly id: "handler/input-schema-not-introspectable";
2758
+ readonly summary: "A write handler's input schema is a Zod shape whose keys boot can collect.";
2759
+ readonly fix: "Use an object schema the boot validator can walk, as named in the error message.";
2760
+ };
2761
+ readonly openToAllPersonalDataUnbound: {
2762
+ readonly id: "handler/open-to-all-personal-data-unbound";
2763
+ readonly summary: "An openToAll write handler accepts personal-data fields only when they are bound to the caller or explicitly declared tenant-members.";
2764
+ readonly fix: 'Bind rows to the caller, restrict access to roles, or declare openToAll: { reason, personalData: "tenant-members" }.';
2765
+ };
2766
+ readonly anonymousPersonalDataUndeclared: {
2767
+ readonly id: "handler/anonymous-personal-data-undeclared";
2768
+ readonly summary: 'A write handler that allows anonymous callers and accepts personal-data fields declares access.personalData "public-intake".';
2769
+ readonly fix: 'Declare access: { roles: [..., "anonymous"], personalData: "public-intake" }.';
2770
+ };
2771
+ readonly perCommandWithPhase: {
2772
+ readonly id: "handler/per-command-with-phase";
2773
+ readonly summary: 'A write handler with transaction "perCommand" declares neither beforeTransaction nor reserveBeforeTransaction.';
2774
+ readonly fix: "Move the phase into the commands the handler issues via ctx.dispatch.write.";
2775
+ };
2776
+ readonly nestedSkipWithoutPhase: {
2777
+ readonly id: "handler/nested-skip-without-before-transaction";
2778
+ readonly summary: "A write handler with beforeTransactionWhenNested also declares beforeTransaction.";
2779
+ readonly fix: "Declare beforeTransaction or remove beforeTransactionWhenNested.";
2780
+ };
2781
+ readonly nestedSkipWithReservation: {
2782
+ readonly id: "handler/nested-skip-with-reserve-before-transaction";
2783
+ readonly summary: "A write handler with beforeTransactionWhenNested does not declare reserveBeforeTransaction, because a nested run would run unreserved.";
2784
+ readonly fix: "Remove reserveBeforeTransaction or beforeTransactionWhenNested.";
2785
+ };
2786
+ }, {
2787
+ readonly screenUnregistered: {
2788
+ readonly id: "nav/screen-unregistered";
2789
+ readonly summary: "A nav entry's screen is a registered screen qualified name.";
2790
+ readonly fix: 'Use "<feature>:screen:<id>" pointing at an r.screen() declaration.';
2791
+ };
2792
+ readonly parentUnregistered: {
2793
+ readonly id: "nav/parent-unregistered";
2794
+ readonly summary: "A nav entry's parent is a registered nav entry qualified name.";
2795
+ readonly fix: 'Use "<feature>:nav:<id>" pointing at a registered nav entry.';
2796
+ };
2797
+ readonly workspaceUnregistered: {
2798
+ readonly id: "nav/workspace-unregistered";
2799
+ readonly summary: "A nav entry self-assigns only to registered workspaces.";
2800
+ readonly fix: 'Use "<feature>:workspace:<id>" pointing at an r.workspace() declaration.';
2801
+ };
2802
+ readonly createActionTargetCount: {
2803
+ readonly id: "nav/create-action-target-count";
2804
+ readonly summary: 'A nav createAction sets exactly one of "screen" and "target".';
2805
+ readonly fix: 'Set either "screen" or "target" on the action.';
2806
+ };
2807
+ readonly createActionScreenUnregistered: {
2808
+ readonly id: "nav/create-action-screen-unregistered";
2809
+ readonly summary: "A nav createAction screen is a registered screen qualified name.";
2810
+ readonly fix: 'Use "<feature>:screen:<id>" pointing at an r.screen() declaration.';
2811
+ };
2812
+ readonly parentCycle: {
2813
+ readonly id: "nav/parent-cycle";
2814
+ readonly summary: "Nav entry parents form no cycle.";
2815
+ readonly fix: "Change or remove the parent of one entry in the cycle.";
2816
+ };
2817
+ readonly workspaceNavUnregistered: {
2818
+ readonly id: "workspace/nav-unregistered";
2819
+ readonly summary: "A workspace references only registered nav entries.";
2820
+ readonly fix: 'Use "<feature>:nav:<id>" pointing at an r.nav() declaration.';
2821
+ };
2822
+ readonly multipleDefaultWorkspaces: {
2823
+ readonly id: "workspace/multiple-defaults";
2824
+ readonly summary: "At most one workspace per app declares default: true.";
2825
+ readonly fix: "Remove default: true from all but one workspace.";
2826
+ };
2827
+ }, {
2828
+ readonly unknownRole: {
2829
+ readonly id: "ownership/unknown-role";
2830
+ readonly summary: "An access map names only roles that some feature defines.";
2831
+ readonly fix: "Use a defined role name or declare the role.";
2832
+ };
2833
+ readonly whereOnWritePath: {
2834
+ readonly id: "ownership/where-on-write-path";
2835
+ readonly summary: "A write access map uses from(...) rules, not where(...), because where is read-only SQL.";
2836
+ readonly fix: "Replace the where rule with a from rule on the write path.";
2837
+ };
2838
+ readonly whereOnFieldRead: {
2839
+ readonly id: "ownership/where-on-field-read";
2840
+ readonly summary: "A field-level read access map uses from(...) rules, not where(...).";
2841
+ readonly fix: "Replace the where rule with a from rule on the field read path.";
2842
+ };
2843
+ readonly unknownClaim: {
2844
+ readonly id: "ownership/unknown-claim";
2845
+ readonly summary: "A from(...) ownership rule references only claims declared via r.claimKey.";
2846
+ readonly fix: 'Declare it via r.claimKey("...", { type: "..." }) in the owning feature.';
2847
+ };
2848
+ readonly unknownColumn: {
2849
+ readonly id: "ownership/unknown-column";
2850
+ readonly summary: "A from(...) ownership rule references only columns that exist on the entity.";
2851
+ readonly fix: "Use one of the entity's columns.";
2852
+ };
2853
+ }, {
2854
+ readonly effectOnWriteOnly: {
2855
+ readonly id: "agent-effect/write-only";
2856
+ readonly summary: "Only write handlers declare agent.effect; a query has nothing to approve.";
2857
+ readonly fix: "Drop agent.effect from the query handler.";
2858
+ };
2859
+ readonly proposalNeedsLowRisk: {
2860
+ readonly id: "agent-effect/proposal-needs-low-risk";
2861
+ readonly summary: 'A write handler with agent.effect "proposal" declares agent.risk "low".';
2862
+ readonly fix: 'Set agent.risk to "low", or drop agent.effect so the agent asks for approval.';
2863
+ };
245
2864
  }];
246
2865
  export declare const FRAMEWORK_BOOT_RULES: readonly BootRule[];