@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
@@ -4,4 +4,189 @@ export declare const SCREEN_ACTION_RULES: {
4
4
  readonly summary: "Every screen action resolves to a registered icon.";
5
5
  readonly fix: "Set icon to a registered NAV_ICONS key or use an action id that resolves one via the default icon map.";
6
6
  };
7
+ readonly rowClickAtMostOne: {
8
+ readonly id: "screen/row-click-at-most-one";
9
+ readonly summary: "At most one row-body click target (rowClick) is declared per list.";
10
+ readonly fix: "Mark at most one rowAction with rowClick: true.";
11
+ };
12
+ readonly navigateParamsDashboardNoReader: {
13
+ readonly id: "screen/navigate-params-dashboard-no-reader";
14
+ readonly summary: "A navigate action with params targets a dashboard that declares a filter, time range or record binding.";
15
+ readonly fix: "Remove the params extractor, or add a filter (or record binding) to the target dashboard.";
16
+ };
17
+ readonly navigateParamsDashboardKeyMismatch: {
18
+ readonly id: "screen/navigate-params-dashboard-key-mismatch";
19
+ readonly summary: "Navigate params extract at least one key the target dashboard reads (filter id, time range id or record param).";
20
+ readonly fix: "Fix the params extractor to produce one of the dashboard's read keys, or remove it.";
21
+ };
22
+ readonly navigateParamsTargetIgnoresParams: {
23
+ readonly id: "screen/navigate-params-target-ignores-params";
24
+ readonly summary: "Navigate params only target screens that read URL search params as initial values (actionForm, secretMint, entityEdit-create).";
25
+ readonly fix: "Remove the params extractor or retarget to an actionForm, secretMint or cross-entity entityEdit-create screen.";
26
+ };
27
+ readonly actionUnknownFieldRef: {
28
+ readonly id: "screen/action-unknown-field-ref";
29
+ readonly summary: "Action payload and params extractors reference existing entity fields.";
30
+ readonly fix: "Name a known field in the pick/map extractor.";
31
+ };
32
+ readonly actionVisibleUnknownField: {
33
+ readonly id: "screen/action-visible-unknown-field";
34
+ readonly summary: "An action's visible.field references an existing entity field.";
35
+ readonly fix: "Point visible.field at a known field.";
36
+ };
37
+ readonly actionEntityIdUnknownField: {
38
+ readonly id: "screen/action-entity-id-unknown-field";
39
+ readonly summary: "An action's entityId references an existing entity field or the id column.";
40
+ readonly fix: "Point entityId at a known field.";
41
+ };
42
+ readonly screenShortIdCollision: {
43
+ readonly id: "screen/short-id-collision";
44
+ readonly summary: "A screen short id is registered by at most one feature.";
45
+ readonly fix: "Give each screen a distinct id.";
46
+ };
47
+ readonly navTargetUnresolved: {
48
+ readonly id: "screen/nav-target-unresolved";
49
+ readonly summary: "A redirect, cancelTarget, success link or fallback resolves to a registered screen.";
50
+ readonly fix: "Use the id of a screen in this feature or a fully-qualified <feature>:screen:<id>.";
51
+ };
52
+ readonly drawerTargetUnresolved: {
53
+ readonly id: "screen/drawer-target-unresolved";
54
+ readonly summary: "A drawer action targets a registered screen of the same feature.";
55
+ readonly fix: "Point screen at a screen declared in the same feature.";
56
+ };
57
+ readonly drawerTargetNotActionForm: {
58
+ readonly id: "screen/drawer-target-not-action-form";
59
+ readonly summary: "A drawer action targets an actionForm screen.";
60
+ readonly fix: "Point screen at an actionForm screen, or use kind: navigate for a full-page target.";
61
+ };
62
+ readonly prefillParamUnknownField: {
63
+ readonly id: "screen/prefill-param-unknown-field";
64
+ readonly summary: "Prefill params only name fields the target form declares.";
65
+ readonly fix: "Name a field the target form declares, or remove the param.";
66
+ };
67
+ readonly prefillParamSensitiveField: {
68
+ readonly id: "screen/prefill-param-sensitive-field";
69
+ readonly summary: "Prefill params never name sensitive or password fields of the target form.";
70
+ readonly fix: "Remove the param or prefill a non-sensitive field.";
71
+ };
72
+ readonly prefillParamNotRendered: {
73
+ readonly id: "screen/prefill-param-not-rendered";
74
+ readonly summary: "Prefill params only name fields the target form renders in its layout.";
75
+ readonly fix: "Add the field to the target layout or remove the param.";
76
+ };
77
+ readonly navigateTabTargetUnresolved: {
78
+ readonly id: "screen/navigate-tab-target-unresolved";
79
+ readonly summary: "A navigate action with tab has a navigate-target that resolves to a screen.";
80
+ readonly fix: "Point the navigate-target at a registered screen.";
81
+ };
82
+ readonly navigateTabTargetNotTabbed: {
83
+ readonly id: "screen/navigate-tab-target-not-tabbed";
84
+ readonly summary: "A navigate tab targets a projectionDetail screen with layout.mode tabs.";
85
+ readonly fix: "Remove the tab or navigate to a projectionDetail screen with layout.mode tabs.";
86
+ };
87
+ readonly navigateTabUnknownSection: {
88
+ readonly id: "screen/navigate-tab-unknown-section";
89
+ readonly summary: "A navigate tab names a section id of the target screen.";
90
+ readonly fix: "Use one of the target screen's section ids.";
91
+ };
92
+ readonly navigateTargetScreenAndEntity: {
93
+ readonly id: "screen/navigate-target-screen-and-entity";
94
+ readonly summary: "A navigate action sets either screen or entity, not both.";
95
+ readonly fix: "Remove one of screen and entity.";
96
+ };
97
+ readonly navigateEntityTargetNeedsEntityId: {
98
+ readonly id: "screen/navigate-entity-target-needs-entity-id";
99
+ readonly summary: "An entity navigate-target on a non-entityList screen sets an explicit entityId.";
100
+ readonly fix: "Set entityId on the navigate action.";
101
+ };
102
+ readonly navigateEntityTargetNoDetail: {
103
+ readonly id: "screen/navigate-entity-target-no-detail";
104
+ readonly summary: "An entity navigate-target has a screen declaring detailFor for that entity.";
105
+ readonly fix: "Add detailFor to a screen of the entity or navigate to a screen directly.";
106
+ };
107
+ readonly navigateTargetNeitherScreenNorEntity: {
108
+ readonly id: "screen/navigate-target-neither-screen-nor-entity";
109
+ readonly summary: "A navigate action sets exactly one of screen and entity.";
110
+ readonly fix: "Set screen or entity on the navigate action.";
111
+ };
112
+ readonly navigateTargetUnresolved: {
113
+ readonly id: "screen/navigate-target-unresolved";
114
+ readonly summary: "A navigate screen target resolves to a registered screen in any feature.";
115
+ readonly fix: 'Use "<feature>:screen:<id>" of an existing screen.';
116
+ };
117
+ readonly redirectIdFromEmpty: {
118
+ readonly id: "screen/redirect-id-from-empty";
119
+ readonly summary: "A redirect object's idFrom is a non-empty string.";
120
+ readonly fix: "Name the success-payload field carrying the navigation id, or use the plain string redirect.";
121
+ };
122
+ readonly redirectIdFromWhitespace: {
123
+ readonly id: "screen/redirect-id-from-whitespace";
124
+ readonly summary: "A redirect idFrom has no leading or trailing whitespace.";
125
+ readonly fix: "Remove the whitespace from idFrom.";
126
+ };
127
+ readonly redirectIdFromOnIdlessTarget: {
128
+ readonly id: "screen/redirect-id-from-on-idless-target";
129
+ readonly summary: "A redirect idFrom only targets entityEdit or projectionDetail screens.";
130
+ readonly fix: "Use the plain string redirect form.";
131
+ };
132
+ readonly successLinkTargetsRecordScreen: {
133
+ readonly id: "screen/success-link-targets-record-screen";
134
+ readonly summary: "A success link without idFrom does not target a record screen.";
135
+ readonly fix: "Set idFrom to the success-payload field carrying the record id.";
136
+ };
137
+ readonly clientActionName: {
138
+ readonly id: "screen/client-action-name";
139
+ readonly summary: "A clientAction names its handler as <feature>:<kebab-name>.";
140
+ readonly fix: 'Use a name like "auth-email-password:request-password-reset".';
141
+ };
142
+ readonly redirectOnListRowAction: {
143
+ readonly id: "screen/redirect-on-list-row-action";
144
+ readonly summary: "List and related-list row actions do not set redirect.";
145
+ readonly fix: "Remove redirect; it is only honored on record actions.";
146
+ };
147
+ readonly primaryActionUnknown: {
148
+ readonly id: "screen/primary-action-unknown";
149
+ readonly summary: "primaryAction and inlineActions name a declared action id or the default edit.";
150
+ readonly fix: 'Use a declared action id, or "edit" when the screen sets detailFor.';
151
+ };
152
+ readonly fallbackWithoutVisibleWhen: {
153
+ readonly id: "screen/fallback-without-visible-when";
154
+ readonly summary: "A screen with a fallback also declares visibleWhen.";
155
+ readonly fix: "Add visibleWhen or remove fallback.";
156
+ };
157
+ readonly visibleWhenEmpty: {
158
+ readonly id: "screen/visible-when-empty";
159
+ readonly summary: "visibleWhen has a non-empty query and field.";
160
+ readonly fix: "Set both visibleWhen.query and visibleWhen.field.";
161
+ };
162
+ readonly fallbackMapEmpty: {
163
+ readonly id: "screen/fallback-map-empty";
164
+ readonly summary: "A fallback map names at least one reason.";
165
+ readonly fix: "Set at least one fallback reason or use a screen id string.";
166
+ };
167
+ readonly fallbackUnknownReason: {
168
+ readonly id: "screen/fallback-unknown-reason";
169
+ readonly summary: "Fallback map keys are known fallback reasons.";
170
+ readonly fix: "Use only the documented fallback reasons.";
171
+ };
172
+ readonly fallbackSelf: {
173
+ readonly id: "screen/fallback-self";
174
+ readonly summary: "A screen's fallback points at a different screen.";
175
+ readonly fix: "Point fallback at a different screen.";
176
+ };
177
+ readonly fallbackHasVisibleWhen: {
178
+ readonly id: "screen/fallback-has-visible-when";
179
+ readonly summary: "A fallback target has no visibleWhen of its own.";
180
+ readonly fix: "Point fallback at a screen without visibleWhen.";
181
+ };
182
+ readonly writeHandlerUnregistered: {
183
+ readonly id: "screen/write-handler-unregistered";
184
+ readonly summary: "A handler reference resolves to a registered write handler.";
185
+ readonly fix: 'Check the QN spelling ("<feature>:write:<short>") and that r.writeHandler(...) declares it.';
186
+ };
187
+ readonly actionFormSuccessItemsRedirect: {
188
+ readonly id: "screen/action-form-success-items-redirect";
189
+ readonly summary: "An actionForm shows successItems or redirects after submit, not both.";
190
+ readonly fix: "Drop redirect to show the successItems on the screen, or drop successItems to leave it.";
191
+ };
7
192
  };
@@ -4,4 +4,189 @@ export const SCREEN_ACTION_RULES = {
4
4
  summary: "Every screen action resolves to a registered icon.",
5
5
  fix: "Set icon to a registered NAV_ICONS key or use an action id that resolves one via the default icon map.",
6
6
  },
7
+ rowClickAtMostOne: {
8
+ id: "screen/row-click-at-most-one",
9
+ summary: "At most one row-body click target (rowClick) is declared per list.",
10
+ fix: "Mark at most one rowAction with rowClick: true.",
11
+ },
12
+ navigateParamsDashboardNoReader: {
13
+ id: "screen/navigate-params-dashboard-no-reader",
14
+ summary: "A navigate action with params targets a dashboard that declares a filter, time range or record binding.",
15
+ fix: "Remove the params extractor, or add a filter (or record binding) to the target dashboard.",
16
+ },
17
+ navigateParamsDashboardKeyMismatch: {
18
+ id: "screen/navigate-params-dashboard-key-mismatch",
19
+ summary: "Navigate params extract at least one key the target dashboard reads (filter id, time range id or record param).",
20
+ fix: "Fix the params extractor to produce one of the dashboard's read keys, or remove it.",
21
+ },
22
+ navigateParamsTargetIgnoresParams: {
23
+ id: "screen/navigate-params-target-ignores-params",
24
+ summary: "Navigate params only target screens that read URL search params as initial values (actionForm, secretMint, entityEdit-create).",
25
+ fix: "Remove the params extractor or retarget to an actionForm, secretMint or cross-entity entityEdit-create screen.",
26
+ },
27
+ actionUnknownFieldRef: {
28
+ id: "screen/action-unknown-field-ref",
29
+ summary: "Action payload and params extractors reference existing entity fields.",
30
+ fix: "Name a known field in the pick/map extractor.",
31
+ },
32
+ actionVisibleUnknownField: {
33
+ id: "screen/action-visible-unknown-field",
34
+ summary: "An action's visible.field references an existing entity field.",
35
+ fix: "Point visible.field at a known field.",
36
+ },
37
+ actionEntityIdUnknownField: {
38
+ id: "screen/action-entity-id-unknown-field",
39
+ summary: "An action's entityId references an existing entity field or the id column.",
40
+ fix: "Point entityId at a known field.",
41
+ },
42
+ screenShortIdCollision: {
43
+ id: "screen/short-id-collision",
44
+ summary: "A screen short id is registered by at most one feature.",
45
+ fix: "Give each screen a distinct id.",
46
+ },
47
+ navTargetUnresolved: {
48
+ id: "screen/nav-target-unresolved",
49
+ summary: "A redirect, cancelTarget, success link or fallback resolves to a registered screen.",
50
+ fix: "Use the id of a screen in this feature or a fully-qualified <feature>:screen:<id>.",
51
+ },
52
+ drawerTargetUnresolved: {
53
+ id: "screen/drawer-target-unresolved",
54
+ summary: "A drawer action targets a registered screen of the same feature.",
55
+ fix: "Point screen at a screen declared in the same feature.",
56
+ },
57
+ drawerTargetNotActionForm: {
58
+ id: "screen/drawer-target-not-action-form",
59
+ summary: "A drawer action targets an actionForm screen.",
60
+ fix: "Point screen at an actionForm screen, or use kind: navigate for a full-page target.",
61
+ },
62
+ prefillParamUnknownField: {
63
+ id: "screen/prefill-param-unknown-field",
64
+ summary: "Prefill params only name fields the target form declares.",
65
+ fix: "Name a field the target form declares, or remove the param.",
66
+ },
67
+ prefillParamSensitiveField: {
68
+ id: "screen/prefill-param-sensitive-field",
69
+ summary: "Prefill params never name sensitive or password fields of the target form.",
70
+ fix: "Remove the param or prefill a non-sensitive field.",
71
+ },
72
+ prefillParamNotRendered: {
73
+ id: "screen/prefill-param-not-rendered",
74
+ summary: "Prefill params only name fields the target form renders in its layout.",
75
+ fix: "Add the field to the target layout or remove the param.",
76
+ },
77
+ navigateTabTargetUnresolved: {
78
+ id: "screen/navigate-tab-target-unresolved",
79
+ summary: "A navigate action with tab has a navigate-target that resolves to a screen.",
80
+ fix: "Point the navigate-target at a registered screen.",
81
+ },
82
+ navigateTabTargetNotTabbed: {
83
+ id: "screen/navigate-tab-target-not-tabbed",
84
+ summary: "A navigate tab targets a projectionDetail screen with layout.mode tabs.",
85
+ fix: "Remove the tab or navigate to a projectionDetail screen with layout.mode tabs.",
86
+ },
87
+ navigateTabUnknownSection: {
88
+ id: "screen/navigate-tab-unknown-section",
89
+ summary: "A navigate tab names a section id of the target screen.",
90
+ fix: "Use one of the target screen's section ids.",
91
+ },
92
+ navigateTargetScreenAndEntity: {
93
+ id: "screen/navigate-target-screen-and-entity",
94
+ summary: "A navigate action sets either screen or entity, not both.",
95
+ fix: "Remove one of screen and entity.",
96
+ },
97
+ navigateEntityTargetNeedsEntityId: {
98
+ id: "screen/navigate-entity-target-needs-entity-id",
99
+ summary: "An entity navigate-target on a non-entityList screen sets an explicit entityId.",
100
+ fix: "Set entityId on the navigate action.",
101
+ },
102
+ navigateEntityTargetNoDetail: {
103
+ id: "screen/navigate-entity-target-no-detail",
104
+ summary: "An entity navigate-target has a screen declaring detailFor for that entity.",
105
+ fix: "Add detailFor to a screen of the entity or navigate to a screen directly.",
106
+ },
107
+ navigateTargetNeitherScreenNorEntity: {
108
+ id: "screen/navigate-target-neither-screen-nor-entity",
109
+ summary: "A navigate action sets exactly one of screen and entity.",
110
+ fix: "Set screen or entity on the navigate action.",
111
+ },
112
+ navigateTargetUnresolved: {
113
+ id: "screen/navigate-target-unresolved",
114
+ summary: "A navigate screen target resolves to a registered screen in any feature.",
115
+ fix: 'Use "<feature>:screen:<id>" of an existing screen.',
116
+ },
117
+ redirectIdFromEmpty: {
118
+ id: "screen/redirect-id-from-empty",
119
+ summary: "A redirect object's idFrom is a non-empty string.",
120
+ fix: "Name the success-payload field carrying the navigation id, or use the plain string redirect.",
121
+ },
122
+ redirectIdFromWhitespace: {
123
+ id: "screen/redirect-id-from-whitespace",
124
+ summary: "A redirect idFrom has no leading or trailing whitespace.",
125
+ fix: "Remove the whitespace from idFrom.",
126
+ },
127
+ redirectIdFromOnIdlessTarget: {
128
+ id: "screen/redirect-id-from-on-idless-target",
129
+ summary: "A redirect idFrom only targets entityEdit or projectionDetail screens.",
130
+ fix: "Use the plain string redirect form.",
131
+ },
132
+ successLinkTargetsRecordScreen: {
133
+ id: "screen/success-link-targets-record-screen",
134
+ summary: "A success link without idFrom does not target a record screen.",
135
+ fix: "Set idFrom to the success-payload field carrying the record id.",
136
+ },
137
+ clientActionName: {
138
+ id: "screen/client-action-name",
139
+ summary: "A clientAction names its handler as <feature>:<kebab-name>.",
140
+ fix: 'Use a name like "auth-email-password:request-password-reset".',
141
+ },
142
+ redirectOnListRowAction: {
143
+ id: "screen/redirect-on-list-row-action",
144
+ summary: "List and related-list row actions do not set redirect.",
145
+ fix: "Remove redirect; it is only honored on record actions.",
146
+ },
147
+ primaryActionUnknown: {
148
+ id: "screen/primary-action-unknown",
149
+ summary: "primaryAction and inlineActions name a declared action id or the default edit.",
150
+ fix: 'Use a declared action id, or "edit" when the screen sets detailFor.',
151
+ },
152
+ fallbackWithoutVisibleWhen: {
153
+ id: "screen/fallback-without-visible-when",
154
+ summary: "A screen with a fallback also declares visibleWhen.",
155
+ fix: "Add visibleWhen or remove fallback.",
156
+ },
157
+ visibleWhenEmpty: {
158
+ id: "screen/visible-when-empty",
159
+ summary: "visibleWhen has a non-empty query and field.",
160
+ fix: "Set both visibleWhen.query and visibleWhen.field.",
161
+ },
162
+ fallbackMapEmpty: {
163
+ id: "screen/fallback-map-empty",
164
+ summary: "A fallback map names at least one reason.",
165
+ fix: "Set at least one fallback reason or use a screen id string.",
166
+ },
167
+ fallbackUnknownReason: {
168
+ id: "screen/fallback-unknown-reason",
169
+ summary: "Fallback map keys are known fallback reasons.",
170
+ fix: "Use only the documented fallback reasons.",
171
+ },
172
+ fallbackSelf: {
173
+ id: "screen/fallback-self",
174
+ summary: "A screen's fallback points at a different screen.",
175
+ fix: "Point fallback at a different screen.",
176
+ },
177
+ fallbackHasVisibleWhen: {
178
+ id: "screen/fallback-has-visible-when",
179
+ summary: "A fallback target has no visibleWhen of its own.",
180
+ fix: "Point fallback at a screen without visibleWhen.",
181
+ },
182
+ writeHandlerUnregistered: {
183
+ id: "screen/write-handler-unregistered",
184
+ summary: "A handler reference resolves to a registered write handler.",
185
+ fix: 'Check the QN spelling ("<feature>:write:<short>") and that r.writeHandler(...) declares it.',
186
+ },
187
+ actionFormSuccessItemsRedirect: {
188
+ id: "screen/action-form-success-items-redirect",
189
+ summary: "An actionForm shows successItems or redirects after submit, not both.",
190
+ fix: "Drop redirect to show the successItems on the screen, or drop successItems to leave it.",
191
+ },
7
192
  };