@cosmicdrift/kumiko-framework 0.413.1 → 0.414.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (463) hide show
  1. package/AGENTS.md +5 -2
  2. package/agents/api/framework-db.md +14 -3
  3. package/agents/api/framework-engine.md +63 -13
  4. package/agents/api/framework-event-store.md +14 -0
  5. package/agents/api/framework-ui-types.md +149 -21
  6. package/agents/api/renderer-web.md +93 -9
  7. package/agents/api/testing-helpers.md +3 -2
  8. package/agents/api/testing-stack.md +3 -0
  9. package/agents/api/types.md +205 -14
  10. package/agents/api.md +7 -7
  11. package/agents/boot-rules.md +63 -9
  12. package/agents/examples/api-docs.md +2 -6
  13. package/agents/examples/auth-mfa.md +57 -10
  14. package/agents/examples/chat-channels.md +2 -0
  15. package/agents/examples/currencies-global.md +1 -0
  16. package/agents/examples/env-composition.md +7 -11
  17. package/agents/examples/managed-pages.md +90 -1
  18. package/agents/examples/pwa-shell.md +210 -0
  19. package/agents/examples/rate-limiting.md +3 -3
  20. package/agents/examples/record-detail-layout.md +1537 -67
  21. package/agents/examples/workflow-engine.md +16 -12
  22. package/agents/examples.md +1 -0
  23. package/agents/features-index.md +4 -2
  24. package/agents/features.md +22 -7
  25. package/agents/widgets.md +19 -1
  26. package/dist/api/api-constants.d.ts +1 -0
  27. package/dist/api/api-constants.js +4 -0
  28. package/dist/api/auth-middleware.js +4 -3
  29. package/dist/api/auth-routes-shared.js +2 -1
  30. package/dist/api/entity-read-access.d.ts +1 -0
  31. package/dist/api/entity-read-access.js +18 -0
  32. package/dist/api/export/export-route.d.ts +6 -1
  33. package/dist/api/export/export-route.js +27 -1
  34. package/dist/api/export/export-rows.js +19 -3
  35. package/dist/api/routes.d.ts +2 -0
  36. package/dist/api/routes.js +9 -1
  37. package/dist/api/server-extra-routes.js +2 -1
  38. package/dist/api/server-feature-http-routes.d.ts +9 -0
  39. package/dist/api/server-feature-http-routes.js +109 -0
  40. package/dist/api/server-middleware.js +2 -19
  41. package/dist/api/server-pat-rate-limit-guard.d.ts +3 -0
  42. package/dist/api/server-pat-rate-limit-guard.js +19 -0
  43. package/dist/api/server-rate-limit-wiring.d.ts +10 -0
  44. package/dist/api/server-rate-limit-wiring.js +37 -0
  45. package/dist/api/server-routes.d.ts +4 -12
  46. package/dist/api/server-routes.js +12 -171
  47. package/dist/api/server-schema-route.d.ts +3 -0
  48. package/dist/api/server-schema-route.js +58 -0
  49. package/dist/api/server-wiring.js +2 -37
  50. package/dist/api/server.js +3 -1
  51. package/dist/compliance/override-schema.js +5 -5
  52. package/dist/compliance/sub-processors.js +10 -1
  53. package/dist/crypto/index.d.ts +1 -1
  54. package/dist/crypto/index.js +1 -1
  55. package/dist/crypto/pii-field-encryption.d.ts +2 -0
  56. package/dist/crypto/pii-field-encryption.js +16 -1
  57. package/dist/db/apply-entity-event.js +4 -0
  58. package/dist/db/bun-sql-connection-codes.d.ts +1 -0
  59. package/dist/db/bun-sql-connection-codes.js +7 -0
  60. package/dist/db/collect-table-metas.js +4 -1
  61. package/dist/db/config-seed.js +1 -1
  62. package/dist/db/derived-field-sql.js +15 -13
  63. package/dist/db/derived-related-sql.d.ts +2 -2
  64. package/dist/db/derived-related-sql.js +4 -2
  65. package/dist/db/dialect.d.ts +3 -0
  66. package/dist/db/dialect.js +1 -3
  67. package/dist/db/driver-row-coercion.js +2 -2
  68. package/dist/db/driver-value-preparation.js +1 -1
  69. package/dist/db/eagerload.js +15 -12
  70. package/dist/db/entity-table-meta.d.ts +2 -0
  71. package/dist/db/entity-table-meta.js +7 -0
  72. package/dist/db/event-store-executor-context.js +13 -8
  73. package/dist/db/event-store-executor-read-aggregate-currencies.js +2 -2
  74. package/dist/db/event-store-executor-read-aggregate.js +2 -2
  75. package/dist/db/event-store-executor-read-filter.d.ts +4 -0
  76. package/dist/db/event-store-executor-read-filter.js +28 -11
  77. package/dist/db/event-store-executor-read-search.d.ts +1 -0
  78. package/dist/db/event-store-executor-read-search.js +6 -6
  79. package/dist/db/event-store-executor-read-sort.js +3 -3
  80. package/dist/db/event-store-executor-read-where.js +14 -5
  81. package/dist/db/event-store-executor-read.js +7 -7
  82. package/dist/db/event-store-executor-write.js +50 -95
  83. package/dist/db/executor-managed-tables.js +4 -1
  84. package/dist/db/index.d.ts +4 -2
  85. package/dist/db/index.js +4 -2
  86. package/dist/db/known-table-names.d.ts +1 -0
  87. package/dist/db/known-table-names.js +7 -5
  88. package/dist/db/list-aggregate-labels.d.ts +1 -0
  89. package/dist/db/list-aggregate-labels.js +9 -1
  90. package/dist/db/migrate-generator.js +23 -4
  91. package/dist/db/migrate-rls-diff.d.ts +1 -0
  92. package/dist/db/migrate-rls-diff.js +15 -1
  93. package/dist/db/migrate-runner.js +2 -2
  94. package/dist/db/money.d.ts +1 -1
  95. package/dist/db/money.js +1 -4
  96. package/dist/db/parent-ref-clause.d.ts +6 -2
  97. package/dist/db/parent-ref-clause.js +76 -23
  98. package/dist/db/parent-ref-global-hosts.d.ts +20 -0
  99. package/dist/db/parent-ref-global-hosts.js +47 -0
  100. package/dist/db/production-schema-command-hint.d.ts +1 -0
  101. package/dist/db/production-schema-command-hint.js +3 -0
  102. package/dist/db/queries/backfill-pii.js +55 -29
  103. package/dist/db/queries/ddl.js +13 -2
  104. package/dist/db/queries/event-store-open-streams.d.ts +15 -0
  105. package/dist/db/queries/event-store-open-streams.js +33 -0
  106. package/dist/db/queries/event-store-payload-scrub.d.ts +5 -0
  107. package/dist/db/queries/event-store-payload-scrub.js +11 -0
  108. package/dist/db/queries/event-store.js +0 -1
  109. package/dist/db/queries/raw-sql.js +0 -1
  110. package/dist/db/queries/rebuild-rls-guard.d.ts +2 -1
  111. package/dist/db/queries/rebuild-rls-guard.js +24 -11
  112. package/dist/db/queries/rls-boot-catalog.d.ts +1 -0
  113. package/dist/db/queries/rls-boot-catalog.js +13 -8
  114. package/dist/db/queries/rls-shape.d.ts +2 -1
  115. package/dist/db/queries/rls-shape.js +10 -0
  116. package/dist/db/queries/session-advisory-lock.js +2 -1
  117. package/dist/db/queries/test-stack.js +7 -7
  118. package/dist/db/query.js +16 -11
  119. package/dist/db/rebuild-marker.js +11 -2
  120. package/dist/db/render-rls-ddl.d.ts +2 -0
  121. package/dist/db/render-rls-ddl.js +16 -11
  122. package/dist/db/replay-migration-sql.js +1 -1
  123. package/dist/db/row-level-security-boot-check.js +18 -5
  124. package/dist/db/row-level-security-connection.js +25 -12
  125. package/dist/db/row-level-security-scope.d.ts +2 -1
  126. package/dist/db/row-level-security-scope.js +9 -5
  127. package/dist/db/sql-identifier.d.ts +1 -0
  128. package/dist/db/sql-identifier.js +3 -0
  129. package/dist/db/system-tenant-read-db.d.ts +5 -0
  130. package/dist/db/system-tenant-read-db.js +28 -0
  131. package/dist/db/table-builder.d.ts +3 -1
  132. package/dist/db/table-builder.js +18 -8
  133. package/dist/db/table-info.d.ts +1 -2
  134. package/dist/db/table-introspection.d.ts +3 -0
  135. package/dist/db/table-introspection.js +6 -0
  136. package/dist/db/table-push.d.ts +1 -0
  137. package/dist/db/table-push.js +7 -1
  138. package/dist/db/tenant-db-runner.d.ts +3 -0
  139. package/dist/db/tenant-db-runner.js +19 -1
  140. package/dist/db/transaction-serialization.d.ts +1 -0
  141. package/dist/db/transaction-serialization.js +20 -3
  142. package/dist/db/where-clause.js +11 -2
  143. package/dist/db/write-ownership-failures.d.ts +25 -0
  144. package/dist/db/write-ownership-failures.js +82 -0
  145. package/dist/engine/boot-validator/boot-check.js +7 -1
  146. package/dist/engine/boot-validator/boot-phases-app.js +5 -5
  147. package/dist/engine/boot-validator/boot-phases.js +3 -2
  148. package/dist/engine/boot-validator/boot-rules.d.ts +293 -26
  149. package/dist/engine/boot-validator/boot-rules.js +4 -0
  150. package/dist/engine/boot-validator/bundled-lists-table.js +2 -2
  151. package/dist/engine/boot-validator/card-meta-overflow.js +1 -0
  152. package/dist/engine/boot-validator/config-deps.d.ts +0 -1
  153. package/dist/engine/boot-validator/config-deps.js +0 -28
  154. package/dist/engine/boot-validator/config-key-rules.d.ts +0 -15
  155. package/dist/engine/boot-validator/config-key-rules.js +0 -15
  156. package/dist/engine/boot-validator/dashboard-screen-target.d.ts +22 -0
  157. package/dist/engine/boot-validator/dashboard-screen-target.js +20 -0
  158. package/dist/engine/boot-validator/dashboard-stat-navigate.d.ts +1 -0
  159. package/dist/engine/boot-validator/dashboard-stat-navigate.js +25 -17
  160. package/dist/engine/boot-validator/definition-webhook-events-rules.d.ts +5 -0
  161. package/dist/engine/boot-validator/definition-webhook-events-rules.js +5 -0
  162. package/dist/engine/boot-validator/derived-sql-fields.js +1 -2
  163. package/dist/engine/boot-validator/entity-declaration-rules.d.ts +5 -0
  164. package/dist/engine/boot-validator/entity-declaration-rules.js +5 -0
  165. package/dist/engine/boot-validator/entity-list-screens.d.ts +1 -0
  166. package/dist/engine/boot-validator/entity-list-screens.js +33 -6
  167. package/dist/engine/boot-validator/entity-structure-rules.d.ts +5 -0
  168. package/dist/engine/boot-validator/entity-structure-rules.js +5 -0
  169. package/dist/engine/boot-validator/list-column-layout.js +10 -6
  170. package/dist/engine/boot-validator/list-row-guidance-rules.d.ts +67 -0
  171. package/dist/engine/boot-validator/list-row-guidance-rules.js +67 -0
  172. package/dist/engine/boot-validator/list-row-guidance.d.ts +20 -0
  173. package/dist/engine/boot-validator/list-row-guidance.js +129 -0
  174. package/dist/engine/boot-validator/list-sort-summary-rules.d.ts +42 -0
  175. package/dist/engine/boot-validator/list-sort-summary-rules.js +42 -0
  176. package/dist/engine/boot-validator/list-sort-summary.d.ts +5 -0
  177. package/dist/engine/boot-validator/list-sort-summary.js +149 -0
  178. package/dist/engine/boot-validator/list-table-options.js +15 -1
  179. package/dist/engine/boot-validator/list-table-rules.d.ts +10 -5
  180. package/dist/engine/boot-validator/list-table-rules.js +10 -5
  181. package/dist/engine/boot-validator/list-toolbar-options.d.ts +10 -0
  182. package/dist/engine/boot-validator/list-toolbar-options.js +31 -0
  183. package/dist/engine/boot-validator/named-filter-rules.d.ts +32 -2
  184. package/dist/engine/boot-validator/named-filter-rules.js +32 -2
  185. package/dist/engine/boot-validator/ownership.js +10 -1
  186. package/dist/engine/boot-validator/parent-ref.js +87 -50
  187. package/dist/engine/boot-validator/projection-list-screens.d.ts +1 -0
  188. package/dist/engine/boot-validator/projection-list-screens.js +31 -1
  189. package/dist/engine/boot-validator/query-output-columns.js +62 -9
  190. package/dist/engine/boot-validator/query-output-guidance.d.ts +7 -0
  191. package/dist/engine/boot-validator/query-output-guidance.js +39 -0
  192. package/dist/engine/boot-validator/query-refs.js +24 -1
  193. package/dist/engine/boot-validator/row-decoration.d.ts +11 -0
  194. package/dist/engine/boot-validator/row-decoration.js +16 -0
  195. package/dist/engine/boot-validator/screens-dashboard-links.d.ts +10 -0
  196. package/dist/engine/boot-validator/screens-dashboard-links.js +36 -0
  197. package/dist/engine/boot-validator/screens-dashboard-narrow.d.ts +4 -0
  198. package/dist/engine/boot-validator/screens-dashboard-narrow.js +211 -0
  199. package/dist/engine/boot-validator/screens-dashboard-rules.d.ts +84 -4
  200. package/dist/engine/boot-validator/screens-dashboard-rules.js +84 -4
  201. package/dist/engine/boot-validator/screens-dashboard.js +29 -7
  202. package/dist/engine/boot-validator/screens-kind-entity-list.js +32 -27
  203. package/dist/engine/boot-validator/screens-kind-projection-detail-guidance.d.ts +3 -0
  204. package/dist/engine/boot-validator/screens-kind-projection-detail-guidance.js +46 -0
  205. package/dist/engine/boot-validator/screens-kind-projection-detail-rules.d.ts +20 -0
  206. package/dist/engine/boot-validator/screens-kind-projection-detail-rules.js +20 -0
  207. package/dist/engine/boot-validator/screens-kind-projection-detail.js +2 -0
  208. package/dist/engine/boot-validator/screens-kind-projection-list.js +4 -0
  209. package/dist/engine/boot-validator/screens-kind-rules.d.ts +25 -0
  210. package/dist/engine/boot-validator/screens-kind-rules.js +25 -0
  211. package/dist/engine/boot-validator/screens-lists.d.ts +8 -2
  212. package/dist/engine/boot-validator/screens-lists.js +19 -3
  213. package/dist/engine/boot-validator/screens.js +1 -1
  214. package/dist/engine/boot-validator/sort-nulls.d.ts +2 -0
  215. package/dist/engine/boot-validator/sort-nulls.js +15 -0
  216. package/dist/engine/boot-validator/zod-shape.d.ts +2 -1
  217. package/dist/engine/boot-validator/zod-shape.js +19 -1
  218. package/dist/engine/build-app-schema.js +4 -0
  219. package/dist/engine/config-helpers.d.ts +1 -2
  220. package/dist/engine/config-helpers.js +6 -7
  221. package/dist/engine/define-feature.js +1 -0
  222. package/dist/engine/define-handler.d.ts +1 -0
  223. package/dist/engine/define-handler.js +4 -2
  224. package/dist/engine/definition-violations.js +2 -2
  225. package/dist/engine/entity-handlers.js +3 -8
  226. package/dist/engine/entity-list-runtime-options.js +9 -8
  227. package/dist/engine/factories.d.ts +2 -0
  228. package/dist/engine/feature-config-events-jobs.js +1 -0
  229. package/dist/engine/feature-entity-handlers.js +5 -2
  230. package/dist/engine/field-access.d.ts +1 -1
  231. package/dist/engine/field-access.js +7 -10
  232. package/dist/engine/find-entity.js +3 -3
  233. package/dist/engine/form-derivations.js +3 -3
  234. package/dist/engine/index.d.ts +3 -3
  235. package/dist/engine/index.js +2 -2
  236. package/dist/engine/named-filter-roles.d.ts +3 -0
  237. package/dist/engine/named-filter-roles.js +23 -0
  238. package/dist/engine/pipeline.js +0 -1
  239. package/dist/engine/project-app-schema-for-roles.js +17 -2
  240. package/dist/engine/qualified-name.js +0 -1
  241. package/dist/engine/registry-facade.js +1 -2
  242. package/dist/engine/registry-state.d.ts +1 -1
  243. package/dist/engine/registry-state.js +5 -2
  244. package/dist/engine/registry-validate.js +2 -1
  245. package/dist/engine/resolve-named-list-filters.js +5 -2
  246. package/dist/engine/schema-builder.js +6 -10
  247. package/dist/engine/screen-helpers.d.ts +12 -0
  248. package/dist/engine/screen-helpers.js +17 -1
  249. package/dist/engine/soft-delete-cleanup.js +1 -5
  250. package/dist/engine/state-machine.js +0 -1
  251. package/dist/engine/steps/_database-clock.d.ts +2 -0
  252. package/dist/engine/steps/_database-clock.js +6 -0
  253. package/dist/engine/steps/compute.js +1 -1
  254. package/dist/engine/steps/retry.js +5 -1
  255. package/dist/engine/steps/return.js +0 -1
  256. package/dist/engine/steps/wait-for-event.js +2 -1
  257. package/dist/engine/steps/wait.js +2 -1
  258. package/dist/engine/system-user.d.ts +2 -2
  259. package/dist/engine/system-user.js +2 -2
  260. package/dist/engine/types/handlers.d.ts +1 -1
  261. package/dist/engine/types/handlers.js +1 -1
  262. package/dist/engine/types/screen.d.ts +1 -1
  263. package/dist/engine/types/screen.js +1 -1
  264. package/dist/engine/webhook-contracts.d.ts +2 -3
  265. package/dist/engine/webhook-contracts.js +2 -25
  266. package/dist/engine/webhook-events.js +48 -29
  267. package/dist/engine/webhook-payload-strictness.d.ts +7 -0
  268. package/dist/engine/webhook-payload-strictness.js +53 -0
  269. package/dist/env/_zod-introspect.d.ts +1 -0
  270. package/dist/env/dry-run.d.ts +1 -1
  271. package/dist/env/dry-run.js +1 -1
  272. package/dist/env/field-meta.d.ts +4 -0
  273. package/dist/env/field-meta.js +67 -0
  274. package/dist/env/field-rules.d.ts +9 -0
  275. package/dist/env/field-rules.js +46 -0
  276. package/dist/env/index.d.ts +3 -3
  277. package/dist/env/index.js +16 -71
  278. package/dist/env/internals.d.ts +3 -0
  279. package/dist/env/internals.js +1 -2
  280. package/dist/env/required-env.d.ts +3 -1
  281. package/dist/env/required-env.js +5 -2
  282. package/dist/errors/serialize.js +2 -2
  283. package/dist/errors/write-error-info.js +0 -2
  284. package/dist/es-ops/operations-schema.js +18 -7
  285. package/dist/event-store/admin-api.js +3 -3
  286. package/dist/event-store/event-store.js +0 -3
  287. package/dist/event-store/index.d.ts +1 -0
  288. package/dist/event-store/index.js +1 -0
  289. package/dist/event-store/transfer.js +1 -1
  290. package/dist/files/assert-file-refs-belong-to-tenant.d.ts +2 -1
  291. package/dist/files/assert-file-refs-belong-to-tenant.js +15 -13
  292. package/dist/files/bind-pending-file-refs.d.ts +3 -1
  293. package/dist/files/bind-pending-file-refs.js +54 -27
  294. package/dist/files/copy-pending-file-refs-to-tenant.js +7 -3
  295. package/dist/files/create-file-ref.d.ts +4 -1
  296. package/dist/files/create-file-ref.js +14 -3
  297. package/dist/files/default-file-guard.js +4 -1
  298. package/dist/files/file-claim.d.ts +6 -0
  299. package/dist/files/file-claim.js +17 -0
  300. package/dist/files/file-field-slots.d.ts +2 -0
  301. package/dist/files/file-field-slots.js +28 -0
  302. package/dist/files/file-ref-entity.d.ts +3 -0
  303. package/dist/files/file-ref-entity.js +2 -0
  304. package/dist/files/file-ref-table.d.ts +3 -0
  305. package/dist/files/file-routes.d.ts +4 -1
  306. package/dist/files/file-routes.js +80 -16
  307. package/dist/files/in-memory-provider.d.ts +1 -1
  308. package/dist/files/in-memory-provider.js +2 -1
  309. package/dist/files/index.d.ts +1 -1
  310. package/dist/files/index.js +1 -1
  311. package/dist/files/invalid-file-ref-error.d.ts +2 -0
  312. package/dist/files/invalid-file-ref-error.js +15 -0
  313. package/dist/files/local-provider.js +9 -2
  314. package/dist/files/provider-resolver.js +1 -1
  315. package/dist/files/rebind-file-ref.d.ts +3 -2
  316. package/dist/files/rebind-file-ref.js +24 -18
  317. package/dist/files/resolve-file-handles.d.ts +13 -0
  318. package/dist/files/resolve-file-handles.js +57 -0
  319. package/dist/files/storage-tracking.d.ts +1 -1
  320. package/dist/files/storage-tracking.js +5 -2
  321. package/dist/files/sweep-stale-pending-file-refs.js +10 -4
  322. package/dist/files/types.d.ts +4 -0
  323. package/dist/files/types.js +10 -0
  324. package/dist/files/upload-field-resolution.d.ts +1 -0
  325. package/dist/files/upload-field-resolution.js +16 -2
  326. package/dist/files/upload-ledger.js +1 -1
  327. package/dist/i18n/required-surface-guidance-keys.d.ts +3 -0
  328. package/dist/i18n/required-surface-guidance-keys.js +9 -0
  329. package/dist/i18n/required-surface-keys.js +19 -4
  330. package/dist/internal/boot-rule-table-expectations.d.ts +2 -0
  331. package/dist/internal/boot-rule-table-expectations.js +29 -0
  332. package/dist/internal/row-level-security.d.ts +1 -0
  333. package/dist/internal/row-level-security.js +1 -0
  334. package/dist/internal/testing.d.ts +1 -0
  335. package/dist/internal/testing.js +1 -0
  336. package/dist/jobs/index.d.ts +1 -0
  337. package/dist/jobs/index.js +1 -0
  338. package/dist/jobs/job-load-events.d.ts +10 -0
  339. package/dist/jobs/job-load-events.js +12 -0
  340. package/dist/jobs/job-runner-context.js +6 -158
  341. package/dist/jobs/job-runner-dispatch.d.ts +7 -0
  342. package/dist/jobs/job-runner-dispatch.js +57 -0
  343. package/dist/jobs/job-runner-event-triggers.js +18 -9
  344. package/dist/jobs/job-runner-execution.js +2 -2
  345. package/dist/jobs/job-runner-facets.d.ts +48 -0
  346. package/dist/jobs/job-runner-facets.js +156 -0
  347. package/dist/jobs/job-runner-gates.js +19 -11
  348. package/dist/jobs/job-runner-helpers.d.ts +5 -1
  349. package/dist/jobs/job-runner-helpers.js +18 -3
  350. package/dist/jobs/job-runner-scope.d.ts +1 -0
  351. package/dist/jobs/job-runner-scope.js +2 -0
  352. package/dist/jobs/job-runner-tenant-cap-lock.d.ts +2 -0
  353. package/dist/jobs/job-runner-tenant-cap-lock.js +30 -0
  354. package/dist/jobs/job-runner.js +31 -70
  355. package/dist/jobs/obliterate-job-queues.d.ts +6 -0
  356. package/dist/jobs/obliterate-job-queues.js +23 -0
  357. package/dist/lifecycle/lifecycle.js +1 -1
  358. package/dist/migrations/event-header-scrub.d.ts +11 -0
  359. package/dist/migrations/event-header-scrub.js +33 -0
  360. package/dist/migrations/event-payload-scrub.d.ts +1 -1
  361. package/dist/migrations/event-payload-scrub.js +36 -4
  362. package/dist/migrations/index.d.ts +1 -0
  363. package/dist/migrations/index.js +2 -0
  364. package/dist/migrations/kumiko-drift.d.ts +5 -2
  365. package/dist/migrations/kumiko-drift.js +51 -14
  366. package/dist/migrations/pending-rebuilds.js +4 -5
  367. package/dist/observability/sensitive-filter.js +0 -12
  368. package/dist/pipeline/aggregate-type-removal.js +17 -4
  369. package/dist/pipeline/context-services.d.ts +2 -0
  370. package/dist/pipeline/context-services.js +5 -2
  371. package/dist/pipeline/dispatch-batch.js +4 -3
  372. package/dist/pipeline/dispatch-context-helpers.d.ts +11 -0
  373. package/dist/pipeline/dispatch-context-helpers.js +58 -0
  374. package/dist/pipeline/dispatch-nested-write.d.ts +7 -0
  375. package/dist/pipeline/dispatch-nested-write.js +119 -0
  376. package/dist/pipeline/dispatch-query.js +10 -3
  377. package/dist/pipeline/dispatch-scope.js +4 -3
  378. package/dist/pipeline/dispatch-shared.d.ts +2 -6
  379. package/dist/pipeline/dispatch-shared.js +6 -38
  380. package/dist/pipeline/dispatch-write.d.ts +0 -1
  381. package/dist/pipeline/dispatch-write.js +3 -302
  382. package/dist/pipeline/dispatcher-utils.js +6 -0
  383. package/dist/pipeline/effective-system-scope.d.ts +3 -0
  384. package/dist/pipeline/effective-system-scope.js +22 -0
  385. package/dist/pipeline/event-dispatcher-delivery.d.ts +1 -0
  386. package/dist/pipeline/event-dispatcher-delivery.js +17 -9
  387. package/dist/pipeline/event-dispatcher.d.ts +4 -1
  388. package/dist/pipeline/event-dispatcher.js +6 -7
  389. package/dist/pipeline/handler-context-auth.d.ts +3 -2
  390. package/dist/pipeline/handler-context-auth.js +3 -4
  391. package/dist/pipeline/handler-context-db.js +11 -4
  392. package/dist/pipeline/handler-context-dispatch.js +2 -2
  393. package/dist/pipeline/handler-context-events.d.ts +8 -3
  394. package/dist/pipeline/handler-context-events.js +20 -65
  395. package/dist/pipeline/handler-context-member-resolution.js +16 -8
  396. package/dist/pipeline/handler-context-notify.d.ts +1 -0
  397. package/dist/pipeline/handler-context-notify.js +2 -0
  398. package/dist/pipeline/handler-context-phase-denials.js +3 -2
  399. package/dist/pipeline/handler-context-projection.d.ts +3 -0
  400. package/dist/pipeline/handler-context-projection.js +39 -0
  401. package/dist/pipeline/handler-context-scope.d.ts +1 -1
  402. package/dist/pipeline/handler-context-scope.js +14 -2
  403. package/dist/pipeline/index.d.ts +1 -1
  404. package/dist/pipeline/index.js +1 -1
  405. package/dist/pipeline/lifecycle-pipeline.d.ts +1 -0
  406. package/dist/pipeline/lifecycle-pipeline.js +7 -4
  407. package/dist/pipeline/member-reader.js +4 -2
  408. package/dist/pipeline/msp-rebuild.js +1 -1
  409. package/dist/pipeline/nested-write-parent-guard.d.ts +5 -0
  410. package/dist/pipeline/nested-write-parent-guard.js +81 -0
  411. package/dist/pipeline/projection-rebuild.d.ts +2 -0
  412. package/dist/pipeline/projection-rebuild.js +16 -7
  413. package/dist/pipeline/projection-state.js +4 -6
  414. package/dist/pipeline/system-hooks.js +36 -6
  415. package/dist/pipeline/write-result-masking.js +31 -3
  416. package/dist/pipeline/write-transition-guard.d.ts +7 -0
  417. package/dist/pipeline/write-transition-guard.js +95 -0
  418. package/dist/schema-cli/shared.d.ts +2 -0
  419. package/dist/schema-cli/shared.js +4 -2
  420. package/dist/schema-cli/validate-command.js +43 -28
  421. package/dist/search/meilisearch-adapter.js +14 -9
  422. package/dist/search/reindex-entity.d.ts +2 -0
  423. package/dist/search/reindex-entity.js +32 -4
  424. package/dist/search/reindex-tenants-search.js +20 -4
  425. package/dist/time/tz-context.js +1 -1
  426. package/dist/ui-types/card-column-roles.d.ts +4 -0
  427. package/dist/ui-types/card-column-roles.js +6 -3
  428. package/dist/ui-types/index.d.ts +2 -2
  429. package/dist/ui-types/index.js +1 -1
  430. package/dist/utils/ids.js +0 -1
  431. package/dist/utils/index.d.ts +1 -0
  432. package/dist/utils/index.js +1 -0
  433. package/dist/utils/return-path-limit.d.ts +1 -0
  434. package/dist/utils/return-path-limit.js +1 -0
  435. package/package.json +5 -3
  436. package/presets/biome-app.json +39 -21
  437. package/presets/biome-plugins/admin-api.grit +10 -0
  438. package/presets/biome-plugins/error-reasons.grit +53 -0
  439. package/presets/biome-plugins/es-literal-writes-tests.grit +18 -0
  440. package/presets/biome-plugins/es-literal-writes.grit +22 -0
  441. package/presets/biome-plugins/i18n-locale-terminology-de.grit +15 -0
  442. package/presets/biome-plugins/i18n-locale-terminology-romance.grit +10 -0
  443. package/presets/biome-plugins/no-create-test-dispatcher.grit +5 -0
  444. package/presets/biome-plugins/no-css-properties-type.grit +7 -0
  445. package/presets/biome-plugins/no-date-api.grit +9 -0
  446. package/presets/biome-plugins/no-direct-fetch.grit +16 -0
  447. package/presets/biome-plugins/no-direct-fs.grit +16 -0
  448. package/presets/biome-plugins/no-external-font-cdn-css.grit +9 -0
  449. package/presets/biome-plugins/no-external-font-cdn.grit +12 -0
  450. package/presets/biome-plugins/no-raw-hooks.grit +10 -0
  451. package/presets/biome-plugins/no-same-folder-barrel-import.grit +11 -0
  452. package/presets/biome-plugins/no-screen-container-classes.grit +7 -0
  453. package/presets/biome-plugins/no-skipped-or-retried-tests.grit +34 -0
  454. package/presets/biome-plugins/no-temporal-polyfill-require.grit +10 -0
  455. package/presets/biome-plugins/raw-html-in-web.grit +40 -0
  456. package/presets/biome-plugins/raw-ui-in-app.grit +142 -0
  457. package/presets/biome-plugins/restricted-event-store-symbols.grit +18 -0
  458. package/presets/biome-plugins/test-title.grit +20 -0
  459. package/presets/biome-plugins/unsafe-json-parse.grit +6 -0
  460. package/presets/biome-rules.json +465 -0
  461. package/src/changes.json +309 -0
  462. package/dist/engine/minor-units.d.ts +0 -2
  463. package/dist/engine/minor-units.js +0 -8
@@ -5,5 +5,6 @@ export { generateDeterministicId, generateId } from "./ids.ts";
5
5
  export { isPlainObject } from "./is-plain-object.ts";
6
6
  export { createLruCache, type LruCache, type LruCacheOptions } from "./lru-cache.ts";
7
7
  export { parseStringArrayJson } from "./parse-string-array-json.ts";
8
+ export { MAX_RETURN_PATH_LENGTH } from "./return-path-limit.ts";
8
9
  export { parseJsonOrThrow, parseJsonSafe } from "./safe-json.ts";
9
10
  export { parseRoles } from "./serialization.ts";
@@ -5,5 +5,6 @@ export { generateDeterministicId, generateId } from "./ids.js";
5
5
  export { isPlainObject } from "./is-plain-object.js";
6
6
  export { createLruCache } from "./lru-cache.js";
7
7
  export { parseStringArrayJson } from "./parse-string-array-json.js";
8
+ export { MAX_RETURN_PATH_LENGTH } from "./return-path-limit.js";
8
9
  export { parseJsonOrThrow, parseJsonSafe } from "./safe-json.js";
9
10
  export { parseRoles } from "./serialization.js";
@@ -0,0 +1 @@
1
+ export declare const MAX_RETURN_PATH_LENGTH = 2048;
@@ -0,0 +1 @@
1
+ export const MAX_RETURN_PATH_LENGTH = 2048;
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@cosmicdrift/kumiko-framework",
3
- "version": "0.413.1",
3
+ "version": "0.414.0",
4
4
  "description": "Framework core — engine, pipeline, API, DB, and every other bit that makes Kumiko go.",
5
5
  "license": "MIT",
6
6
  "author": "Marc Frost <marc@cosmicdriftgamestudio.com>",
@@ -39,6 +39,7 @@
39
39
  "default": "./dist/config/index.js"
40
40
  },
41
41
  "./biome": "./presets/biome-app.json",
42
+ "./biome-rules": "./presets/biome-rules.json",
42
43
  "./tsconfig.app.json": "./presets/tsconfig.app.json",
43
44
  "./es-ops": {
44
45
  "types": "./dist/es-ops/index.d.ts",
@@ -203,7 +204,7 @@
203
204
  "./package.json": "./package.json"
204
205
  },
205
206
  "dependencies": {
206
- "@cosmicdrift/kumiko-types": "0.413.1",
207
+ "@cosmicdrift/kumiko-types": "0.414.0",
207
208
  "bullmq": "^5.81.5",
208
209
  "hono": "^4.13.14",
209
210
  "i18next": "^26.5.12",
@@ -225,7 +226,7 @@
225
226
  }
226
227
  },
227
228
  "devDependencies": {
228
- "@cosmicdrift/kumiko-testing": "0.413.1",
229
+ "@cosmicdrift/kumiko-testing": "0.414.0",
229
230
  "bun-types": "^1.4.4",
230
231
  "fflate": "^0.8.3",
231
232
  "meilisearch": "^0.62.0",
@@ -244,6 +245,7 @@
244
245
  "default": "./dist/config/index.js"
245
246
  },
246
247
  "./biome": "./presets/biome-app.json",
248
+ "./biome-rules": "./presets/biome-rules.json",
247
249
  "./tsconfig.app.json": "./presets/tsconfig.app.json",
248
250
  "./es-ops": {
249
251
  "types": "./dist/es-ops/index.d.ts",
@@ -1,5 +1,6 @@
1
1
  {
2
2
  "$schema": "https://biomejs.dev/schemas/2.6.4/schema.json",
3
+ "extends": ["./biome-rules.json"],
3
4
  "vcs": {
4
5
  "enabled": true,
5
6
  "clientKind": "git",
@@ -31,7 +32,10 @@
31
32
  "lineEnding": "lf"
32
33
  },
33
34
  "css": {
34
- "parser": { "cssModules": false, "tailwindDirectives": true }
35
+ "parser": {
36
+ "cssModules": false,
37
+ "tailwindDirectives": true
38
+ }
35
39
  },
36
40
  "javascript": {
37
41
  "formatter": {
@@ -42,23 +46,10 @@
42
46
  "arrowParentheses": "always"
43
47
  }
44
48
  },
45
- "json": { "formatter": { "indentWidth": 2, "lineWidth": 80 } },
46
- "linter": {
47
- "enabled": true,
48
- "rules": {
49
- "preset": "recommended",
50
- "correctness": {
51
- "noUnusedVariables": "error",
52
- "noUnusedImports": "error"
53
- },
54
- "suspicious": {
55
- "noExplicitAny": "error",
56
- "noDebugger": "error",
57
- "noConsole": "warn"
58
- },
59
- "complexity": { "useLiteralKeys": "off" },
60
- "style": { "useConst": "error" },
61
- "nursery": { "noFloatingPromises": "error" }
49
+ "json": {
50
+ "formatter": {
51
+ "indentWidth": 2,
52
+ "lineWidth": 80
62
53
  }
63
54
  },
64
55
  "overrides": [
@@ -66,7 +57,9 @@
66
57
  "includes": ["bin/**", "scripts/**", "**/bin/**", "**/scripts/**"],
67
58
  "linter": {
68
59
  "rules": {
69
- "suspicious": { "noConsole": "off" }
60
+ "suspicious": {
61
+ "noConsole": "off"
62
+ }
70
63
  }
71
64
  }
72
65
  },
@@ -79,8 +72,33 @@
79
72
  ],
80
73
  "linter": {
81
74
  "rules": {
82
- "suspicious": { "noConsole": "off" },
83
- "style": { "noNonNullAssertion": "off" }
75
+ "suspicious": {
76
+ "noConsole": "off"
77
+ },
78
+ "style": {
79
+ "noNonNullAssertion": "off"
80
+ }
81
+ }
82
+ }
83
+ },
84
+ {
85
+ "includes": [
86
+ "**/bin/**/*.ts",
87
+ "**/src/**/*.ts",
88
+ "!**/bin/env.ts",
89
+ "!**/bin/server.ts",
90
+ "!**/bin/kumiko.ts",
91
+ "!**/__tests__/**",
92
+ "!**/*.test.ts",
93
+ "!**/*.integration.ts",
94
+ "!**/*.d.ts",
95
+ "!**/node_modules/**"
96
+ ],
97
+ "linter": {
98
+ "rules": {
99
+ "style": {
100
+ "noProcessEnv": "error"
101
+ }
84
102
  }
85
103
  }
86
104
  }
@@ -0,0 +1,10 @@
1
+ language js
2
+
3
+ or {
4
+ `$target.appendRaw($...)`,
5
+ `$target.appendRawBatch($...)`,
6
+ `appendRaw($...)`,
7
+ `appendRawBatch($...)`
8
+ } as $call where {
9
+ register_diagnostic(span=$call, message="Admin API (appendRaw/appendRawBatch) bypasses the pipeline and is only allowed in samples/*/migration/, scripts/migrations/ and the event-store admin-api itself. For domain events use ctx.events.append or a write handler.", severity="error")
10
+ }
@@ -0,0 +1,53 @@
1
+ language js
2
+
3
+ or {
4
+ `$callee($reason, $...)` where {
5
+ $callee <: or {
6
+ `UnprocessableError`,
7
+ `failUnprocessable`,
8
+ `$_.failUnprocessable`
9
+ },
10
+ $reason <: or {
11
+ JsStringLiteralExpression(),
12
+ JsTemplateExpression()
13
+ },
14
+ $reason <: r"^[\"'`][^$]*[\"'`]$",
15
+ not $reason <: r"^[\"'`][a-z][a-z0-9_]*(?:\.[a-z][a-z0-9_]*)*[\"'`]$",
16
+ register_diagnostic(span=$reason, message="Error reason must be snake_case ASCII with optional dot namespaces (^[a-z][a-z0-9_]*(\\.[a-z][a-z0-9_]*)*$): clients key off it across wire, logs and i18n. Reusable? Add a const to FrameworkReasons/<Feature>Reasons.", severity="error")
17
+ },
18
+ `new UnprocessableError($reason, $...)` where {
19
+ $reason <: or {
20
+ JsStringLiteralExpression(),
21
+ JsTemplateExpression()
22
+ },
23
+ $reason <: r"^[\"'`][^$]*[\"'`]$",
24
+ not $reason <: r"^[\"'`][a-z][a-z0-9_]*(?:\.[a-z][a-z0-9_]*)*[\"'`]$",
25
+ register_diagnostic(span=$reason, message="Error reason must be snake_case ASCII with optional dot namespaces (^[a-z][a-z0-9_]*(\\.[a-z][a-z0-9_]*)*$): clients key off it across wire, logs and i18n. Reusable? Add a const to FrameworkReasons/<Feature>Reasons.", severity="error")
26
+ },
27
+ JsPropertyObjectMember(name=`reason`, value=$reason) as $member where {
28
+ $reason <: or {
29
+ JsStringLiteralExpression(),
30
+ JsTemplateExpression()
31
+ },
32
+ $reason <: r"^[\"'`][^$]*[\"'`]$",
33
+ not $reason <: r"^[\"'`][a-z][a-z0-9_]*(?:\.[a-z][a-z0-9_]*)*[\"'`]$",
34
+ not $member <: within JsPropertyObjectMember(name=or {
35
+ `openToAll`,
36
+ `escapeHatch`,
37
+ `unsafeAllTenants`,
38
+ `systemIdentity`,
39
+ `globalWrites`,
40
+ `unsafeRaw`,
41
+ `crossTenantReads`
42
+ }),
43
+ not $member <: within `$callee($...)` where {
44
+ $callee <: or {
45
+ `declareEscapeHatch`,
46
+ `withUnsafeRawGrant`,
47
+ `createTenantDb`,
48
+ `subjectForgetAfterDeleteHook`
49
+ }
50
+ },
51
+ register_diagnostic(span=$reason, message="Error reason must be snake_case ASCII with optional dot namespaces (^[a-z][a-z0-9_]*(\\.[a-z][a-z0-9_]*)*$): clients key off it across wire, logs and i18n. Reusable? Add a const to FrameworkReasons/<Feature>Reasons.", severity="error")
52
+ }
53
+ }
@@ -0,0 +1,18 @@
1
+ language js
2
+
3
+ or {
4
+ JsStringLiteralExpression(),
5
+ JsTemplateExpression()
6
+ } as $literal where {
7
+ $literal <: includes or {
8
+ "kumiko_events",
9
+ "read_tenant_memberships",
10
+ "KUMIKO_EVENTS",
11
+ "READ_TENANT_MEMBERSHIPS"
12
+ },
13
+ or {
14
+ $literal <: r"(?is).*(?:(?-u:\b)(?:INSERT[ \t\n\r]+INTO|UPDATE)[ \t\n\r]+.{0,2}kumiko_events(?-u:\b)).*",
15
+ $literal <: r"(?is).*(?:(?-u:\b)CREATE[ \t\n\r]+TABLE(?-u:\b)[^;]*?(?-u:\b)read_tenant_memberships(?-u:\b)).*"
16
+ },
17
+ register_diagnostic(span=$literal, message="Raw INSERT/UPDATE on kumiko_events or hand-written read_tenant_memberships DDL in a test. Seed events with append() (runSeedWritesAt for backdating) and membership rows with unsafeCreateEntityTable(db, tenantMembershipEntity) plus seedRow.", severity="error")
18
+ }
@@ -0,0 +1,22 @@
1
+ language js
2
+
3
+ or {
4
+ JsStringLiteralExpression(),
5
+ JsTemplateExpression()
6
+ } as $literal where {
7
+ $literal <: includes or {
8
+ "kumiko_events",
9
+ "kumiko_snapshots",
10
+ "kumiko_archived_streams",
11
+ "read_tenant_memberships",
12
+ "KUMIKO_EVENTS",
13
+ "KUMIKO_SNAPSHOTS",
14
+ "KUMIKO_ARCHIVED_STREAMS",
15
+ "READ_TENANT_MEMBERSHIPS"
16
+ },
17
+ or {
18
+ $literal <: r"(?is).*(?:(?-u:\b)(?:UPDATE|DELETE[ \t\n\r]+FROM|INSERT[ \t\n\r]+INTO)(?-u:\b).*?[\"'`]?(?:kumiko_events|kumiko_snapshots|kumiko_archived_streams)).*",
19
+ $literal <: r"(?is).*(?:(?-u:\b)CREATE[ \t\n\r]+TABLE(?-u:\b)[^;]*?(?-u:\b)read_tenant_memberships(?-u:\b)).*"
20
+ },
21
+ register_diagnostic(span=$literal, message="Raw SQL write on an event-store table (kumiko_events, kumiko_snapshots, kumiko_archived_streams) or hand-written read_tenant_memberships DDL. Only packages/framework/src/event-store/** may write these tables; use transferAggregateStreams for a tenant move or add an event-store primitive. In tests seed with append() (runSeedWritesAt for backdating) and unsafeCreateEntityTable(db, tenantMembershipEntity).", severity="error")
22
+ }
@@ -0,0 +1,15 @@
1
+ language js
2
+
3
+ JsPropertyObjectMember(value=$text) as $member where {
4
+ $text <: includes or {
5
+ "enant",
6
+ "ENANT",
7
+ "rganisation",
8
+ "RGANISATION"
9
+ },
10
+ $text <: or {
11
+ r"(?i)(?s).*(?:(?-u:\b)Tenants?(?-u:\b)).*",
12
+ r"(?i)(?s).*(?:(?-u:\b)organisation(?:en|s)?).*"
13
+ },
14
+ register_diagnostic(span=$member, message="German locale terminology: use Mandant instead of Tenant/Organisation (fw#2200). Role names like TenantAdmin are fine.", severity="error")
15
+ }
@@ -0,0 +1,10 @@
1
+ language js
2
+
3
+ JsPropertyObjectMember(value=$text) as $member where {
4
+ $text <: includes or {
5
+ "enant",
6
+ "ENANT"
7
+ },
8
+ $text <: r"(?i)(?s).*(?:(?-u:\b)tenants?(?-u:\b)).*",
9
+ register_diagnostic(span=$member, message="Locale terminology: use Organización (es), organisation (fr) or organizzazione (it) instead of the tenant loanword (fw#2200). Role names like TenantAdmin are fine.", severity="error")
10
+ }
@@ -0,0 +1,5 @@
1
+ language js
2
+
3
+ `createTestDispatcher($...)` as $call where {
4
+ register_diagnostic(span=$call, message="Integration tests run through the real stack: use setupTestStack from @cosmicdrift/kumiko-testing/stack and stack.http.writeOk/queryOk, never createTestDispatcher.", severity="error")
5
+ }
@@ -0,0 +1,7 @@
1
+ language js
2
+
3
+ TsReferenceType() as $reference where {
4
+ $reference <: includes "CSSProperties",
5
+ $reference <: r"^(?:React\.)?CSSProperties\b.*",
6
+ register_diagnostic(span=$reference, message="CSSProperties style objects bypass theme tokens and dark mode. Use widgets and theme tokens.", severity="error")
7
+ }
@@ -0,0 +1,9 @@
1
+ language js
2
+
3
+ or {
4
+ `new Date($...)` as $hit,
5
+ `$target.toISOString($...)` as $hit,
6
+ `$target.getTime($...)` as $hit
7
+ } where {
8
+ register_diagnostic(span=$hit, message="JS Date API in production code: use Temporal.Now.instant(), Temporal.Instant.from(...), .toString() or .epochMilliseconds (ctx.tz for wall-clock + IANA zone). Date.now() and Date.parse() stay allowed. See docs/plans/architecture/timezones.md.", severity="error")
9
+ }
@@ -0,0 +1,16 @@
1
+ language js
2
+
3
+ or {
4
+ `fetch($url, $...)`,
5
+ `globalThis.fetch($url, $...)`,
6
+ `window.fetch($url, $...)`
7
+ } as $call where {
8
+ not {
9
+ $url <: or {
10
+ JsStringLiteralExpression(),
11
+ JsTemplateExpression()
12
+ },
13
+ $url <: r"(?s)^[\"'`]/[^/$\\].*"
14
+ },
15
+ register_diagnostic(span=$call, message="Raw fetch() skips the SSRF policy in server code: use egress(policy)(...) from @cosmicdrift/kumiko-framework/http. In web screens use useQuery/useMutation or an API client (*.ts). A same-origin path literal (\"/api/...\") is allowed; any other exception needs a biome-ignore with a specific reason.", severity="error")
16
+ }
@@ -0,0 +1,16 @@
1
+ language js
2
+
3
+ or {
4
+ `import $_ from $source`,
5
+ `import $source`,
6
+ `export { $_ } from $source`,
7
+ `export { $_, $... } from $source`,
8
+ `export * as $_ from $source`,
9
+ `import $_ = require($source)`,
10
+ `export * from $source`,
11
+ `require($source)`,
12
+ `import($source)`
13
+ } as $hit where {
14
+ $source <: r"^[\"'`](?:node:)?fs(?:/promises)?[\"'`]$",
15
+ register_diagnostic(span=$hit, message="Direct fs import: request-derived paths passed straight to fs caused path-traversal bugs. Use FileStorageProvider (resolveContainedPath) or readBundledAsset; build/CLI/script tooling belongs under scripts/, bin/, tools/ or e2e/.", severity="error")
16
+ }
@@ -0,0 +1,9 @@
1
+ language css
2
+
3
+ CssString() as $literal where {
4
+ $literal <: includes or {
5
+ "fonts.googleapis.com",
6
+ "fonts.gstatic.com"
7
+ },
8
+ register_diagnostic(span=$literal, message="No external font CDNs (fonts.googleapis.com, fonts.gstatic.com): self-host fonts so no visitor data leaves for a third party.", severity="error")
9
+ }
@@ -0,0 +1,12 @@
1
+ language js
2
+
3
+ or {
4
+ JsStringLiteralExpression(),
5
+ JsTemplateExpression()
6
+ } as $literal where {
7
+ $literal <: includes or {
8
+ "fonts.googleapis.com",
9
+ "fonts.gstatic.com"
10
+ },
11
+ register_diagnostic(span=$literal, message="No external font CDNs (fonts.googleapis.com, fonts.gstatic.com): self-host fonts so no visitor data leaves for a third party.", severity="error")
12
+ }
@@ -0,0 +1,10 @@
1
+ language js
2
+
3
+ or {
4
+ `useEffect($...)`,
5
+ `useLayoutEffect($...)`,
6
+ `$namespace.useEffect($...)`,
7
+ `$namespace.useLayoutEffect($...)`
8
+ } as $hit where {
9
+ register_diagnostic(span=$hit, message="Raw useEffect/useLayoutEffect in web screens is the source of endless-rerender bugs and bypasses the framework hooks. Use useQuery (live: true for SSE), useMutation, useDisclosure or useReportStepComplete; a real DOM-integration case needs a biome-ignore with a reason.", severity="error")
10
+ }
@@ -0,0 +1,11 @@
1
+ language js
2
+
3
+ or {
4
+ `import $_ from "./index"`,
5
+ `import $_ from "./index.ts"`,
6
+ `import $_ from "."`,
7
+ `import $_ from "./"`
8
+ } as $import where {
9
+ not $import <: r"(?s)^import[ \t\n\r]+type[ \t\n\r].*",
10
+ register_diagnostic(span=$import, message="Import siblings directly (./Component), not through the folder's own barrel: barrel-importing from inside the same folder creates require cycles.", severity="error")
11
+ }
@@ -0,0 +1,7 @@
1
+ language js
2
+
3
+ JsxAttribute(name=`className`, initializer=$classes) where {
4
+ $classes <: includes "mx-auto",
5
+ $classes <: r"(?s).*(?:(?:^|[ \t\n\r\"'`:])mx-auto[ \t\n\r\"'`}](?:.*[ \t\n\r\"'`:])?max-w-|(?:^|[ \t\n\r\"'`:])max-w-.*[ \t\n\r\"'`:]mx-auto(?:$|[ \t\n\r\"'`}])).*",
6
+ register_diagnostic(span=$classes, message="Screen container classes (mx-auto + max-w-*) belong in <PageSection maxWidth> (3xl/4xl/full), not in screen code.", severity="error")
7
+ }
@@ -0,0 +1,34 @@
1
+ language js
2
+
3
+ or {
4
+ `$callee.skip($title, $...)` where {
5
+ $callee <: or {
6
+ `test`,
7
+ `it`,
8
+ `describe`
9
+ },
10
+ $title <: or {
11
+ JsStringLiteralExpression(),
12
+ JsTemplateExpression()
13
+ },
14
+ register_diagnostic(span=$callee, message="Unconditionally skipped test. Fix or delete it; an environment gate belongs in skipIf(condition) with the reason in the title.", severity="error")
15
+ },
16
+ `$callee($title, $fn, { $..., retry: $count, $... })` where {
17
+ $callee <: or {
18
+ `test`,
19
+ `it`,
20
+ `describe`
21
+ },
22
+ $count <: not `0`,
23
+ register_diagnostic(span=$count, message="A retry count hides a flaky test. Find the shared state or missing wait behind the flake instead.", severity="error")
24
+ },
25
+ `$callee($title, { $..., retry: $count, $... }, $fn)` where {
26
+ $callee <: or {
27
+ `test`,
28
+ `it`,
29
+ `describe`
30
+ },
31
+ $count <: not `0`,
32
+ register_diagnostic(span=$count, message="A retry count hides a flaky test. Find the shared state or missing wait behind the flake instead.", severity="error")
33
+ }
34
+ }
@@ -0,0 +1,10 @@
1
+ language js
2
+
3
+ or {
4
+ `require($source)`,
5
+ `import($source)`
6
+ } as $call where {
7
+ $source <: includes "temporal-polyfill",
8
+ $source <: r"^[\"'`]temporal-polyfill(?:/[^\"'`]*)?[\"'`]$",
9
+ register_diagnostic(span=$call, message="temporal-polyfill loaded by require()/import(): import { Temporal } from \"@cosmicdrift/kumiko-types/temporal\" instead — it prefers the native global, so framework and consumer share one set of Temporal classes.", severity="error")
10
+ }
@@ -0,0 +1,40 @@
1
+ language js
2
+
3
+ or {
4
+ JsxOpeningElement(name=$tag) as $element where {
5
+ $tag <: or {
6
+ `table`,
7
+ `thead`,
8
+ `tbody`,
9
+ `tr`,
10
+ `td`,
11
+ `th`,
12
+ `form`,
13
+ `button`,
14
+ `dialog`
15
+ },
16
+ register_diagnostic(span=$tag, message="Raw HTML element in web code: use the framework primitives (usePrimitives(): DataTable, Form, Button, DefaultDialog) instead of table/form/button/dialog.", severity="error")
17
+ },
18
+ JsxSelfClosingElement(name=$tag) as $element where {
19
+ $tag <: or {
20
+ `table`,
21
+ `thead`,
22
+ `tbody`,
23
+ `tr`,
24
+ `td`,
25
+ `th`,
26
+ `form`,
27
+ `button`,
28
+ `dialog`
29
+ },
30
+ register_diagnostic(span=$tag, message="Raw HTML element in web code: use the framework primitives (usePrimitives(): DataTable, Form, Button, DefaultDialog) instead of table/form/button/dialog.", severity="error")
31
+ },
32
+ JsxAttribute(name=`className`, initializer=$classes) where {
33
+ $classes <: includes "bg-card",
34
+ $classes <: r"(?s).*(?:(?:^|[ \t\n\r\"'`:])bg-card(?:$|[ \t\n\r\"'`}])).*",
35
+ register_diagnostic(span=$classes, message="bg-card in a className is a hand-rolled card: use <Card> from the framework primitives (slots/options).", severity="error")
36
+ },
37
+ `alert($...)` as $call where {
38
+ register_diagnostic(span=$call, message="alert() in web code: use <DefaultDialog> from @cosmicdrift/kumiko-renderer/web.", severity="error")
39
+ }
40
+ }
@@ -0,0 +1,142 @@
1
+ language js
2
+
3
+ or {
4
+ JsxOpeningElement(name=$tag) as $element where {
5
+ $tag <: or {
6
+ `input`,
7
+ `select`,
8
+ `textarea`,
9
+ `label`
10
+ },
11
+ register_diagnostic(span=$tag, message="Raw form element in app code: use the framework primitives (usePrimitives(): Input via Field, ComboboxInput) instead of input/select/textarea/label.", severity="error")
12
+ },
13
+ JsxSelfClosingElement(name=$tag) as $element where {
14
+ $tag <: or {
15
+ `input`,
16
+ `select`,
17
+ `textarea`,
18
+ `label`
19
+ },
20
+ register_diagnostic(span=$tag, message="Raw form element in app code: use the framework primitives (usePrimitives(): Input via Field, ComboboxInput) instead of input/select/textarea/label.", severity="error")
21
+ },
22
+ JsxOpeningElement(name=$tag) as $element where {
23
+ $tag <: or {
24
+ `a`,
25
+ `details`,
26
+ `summary`
27
+ },
28
+ $element <: within JsModule() as $module,
29
+ $module <: contains or {
30
+ `import $_ from "@cosmicdrift/kumiko-renderer/web"`,
31
+ `import $_ from "@cosmicdrift/kumiko-renderer-web"`,
32
+ `usePrimitives`
33
+ },
34
+ register_diagnostic(span=$tag, message="Raw interactive element in a file that has the primitives: use usePrimitives().Link for a, CollapsibleSection (@cosmicdrift/kumiko-renderer/web) for details/summary.", severity="warn")
35
+ },
36
+ JsxSelfClosingElement(name=$tag) as $element where {
37
+ $tag <: or {
38
+ `a`,
39
+ `details`,
40
+ `summary`
41
+ },
42
+ $element <: within JsModule() as $module,
43
+ $module <: contains or {
44
+ `import $_ from "@cosmicdrift/kumiko-renderer/web"`,
45
+ `import $_ from "@cosmicdrift/kumiko-renderer-web"`,
46
+ `usePrimitives`
47
+ },
48
+ register_diagnostic(span=$tag, message="Raw interactive element in a file that has the primitives: use usePrimitives().Link for a, CollapsibleSection (@cosmicdrift/kumiko-renderer/web) for details/summary.", severity="warn")
49
+ },
50
+ JsxAttribute(name=`className`, initializer=$classes) where {
51
+ $classes <: includes or {
52
+ "bg-",
53
+ "text-",
54
+ "border-",
55
+ "ring-",
56
+ "fill-",
57
+ "stroke-",
58
+ "from-",
59
+ "via-",
60
+ "to-",
61
+ "outline-",
62
+ "decoration-",
63
+ "divide-",
64
+ "accent-",
65
+ "caret-",
66
+ "shadow"
67
+ },
68
+ $classes <: r"(?s).*(?:(?:^|[ \t\n\r\"'`:])(?:(?:bg|text|border|ring|fill|stroke|from|via|to|outline|decoration|divide|accent|caret)-(?:red|orange|amber|yellow|lime|green|emerald|teal|cyan|sky|blue|indigo|violet|purple|fuchsia|pink|rose|slate|gray|zinc|neutral|stone)-[0-9]+(?:/[0-9]+)?|(?:bg|text|border|ring|fill|stroke|from|via|to|outline|decoration|divide|accent|caret)-\[(?:#|rgb|hsl|oklch|color-mix)[^ \t\n\r\"'`}]*|shadow(?:-[^ \t\n\r\"'`}]+)?)(?:$|[ \t\n\r\"'`}])).*",
69
+ register_diagnostic(span=$classes, message="Design-bearing Tailwind classes (palette colours, arbitrary colours, shadow) belong in widgets and theme tokens (--color-status-*), not in screen code.", severity="error")
70
+ },
71
+ JsFunctionDeclaration(id=$name) where {
72
+ $name <: includes or {
73
+ "Card",
74
+ "Table",
75
+ "Badge",
76
+ "Button",
77
+ "Chart",
78
+ "Modal",
79
+ "Dialog",
80
+ "Tooltip",
81
+ "Spinner",
82
+ "Sparkline",
83
+ "ProgressBar",
84
+ "MiniStat",
85
+ "EmptyState",
86
+ "LoadingState",
87
+ "ErrorState",
88
+ "ModeSwitch",
89
+ "Collapsible",
90
+ "DetailList",
91
+ "MessageThread",
92
+ "MessageReader",
93
+ "StepList",
94
+ "MobileTopBar",
95
+ "ClampedText",
96
+ "AttachmentChip",
97
+ "AttachmentCard",
98
+ "HtmlMailFrame",
99
+ "SenderSheet",
100
+ "SenderFrame",
101
+ "AiSurface"
102
+ },
103
+ $name <: r"^[A-Z][A-Za-z0-9_]*(?:Card|Table|Badge|Button|Chart|Modal|Dialog|Tooltip|Spinner|Sparkline)$|^(?:ProgressBar|MiniStat|StatCard|EmptyState|LoadingState|ErrorState|ModeSwitch|Collapsible[A-Za-z0-9_]*|DetailList|MessageThread|MessageReader|StepList|MobileTopBar|ClampedText|AttachmentChip|AttachmentCard|HtmlMailFrame|SenderSheet|SenderFrame|AiSurface)$",
104
+ register_diagnostic(span=$name, message="App-local UI primitive: use a framework widget or primitive (@cosmicdrift/kumiko-renderer/web: StatCard, SectionCard, StatusBadge, QueryTable, Charts, ...) or usePrimitives().", severity="error")
105
+ },
106
+ JsVariableDeclarator(id=$name, initializer=$init) where {
107
+ $name <: includes or {
108
+ "Card",
109
+ "Table",
110
+ "Badge",
111
+ "Button",
112
+ "Chart",
113
+ "Modal",
114
+ "Dialog",
115
+ "Tooltip",
116
+ "Spinner",
117
+ "Sparkline",
118
+ "ProgressBar",
119
+ "MiniStat",
120
+ "EmptyState",
121
+ "LoadingState",
122
+ "ErrorState",
123
+ "ModeSwitch",
124
+ "Collapsible",
125
+ "DetailList",
126
+ "MessageThread",
127
+ "MessageReader",
128
+ "StepList",
129
+ "MobileTopBar",
130
+ "ClampedText",
131
+ "AttachmentChip",
132
+ "AttachmentCard",
133
+ "HtmlMailFrame",
134
+ "SenderSheet",
135
+ "SenderFrame",
136
+ "AiSurface"
137
+ },
138
+ $init <: contains JsArrowFunctionExpression(),
139
+ $name <: r"^[A-Z][A-Za-z0-9_]*(?:Card|Table|Badge|Button|Chart|Modal|Dialog|Tooltip|Spinner|Sparkline)$|^(?:ProgressBar|MiniStat|StatCard|EmptyState|LoadingState|ErrorState|ModeSwitch|Collapsible[A-Za-z0-9_]*|DetailList|MessageThread|MessageReader|StepList|MobileTopBar|ClampedText|AttachmentChip|AttachmentCard|HtmlMailFrame|SenderSheet|SenderFrame|AiSurface)$",
140
+ register_diagnostic(span=$name, message="App-local UI primitive: use a framework widget or primitive (@cosmicdrift/kumiko-renderer/web: StatCard, SectionCard, StatusBadge, QueryTable, Charts, ...) or usePrimitives().", severity="error")
141
+ }
142
+ }