@jam-overture/loom 0.1.0 → 0.3.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 (414) hide show
  1. package/README.md +3 -1
  2. package/dist/application/application.d.ts +109 -0
  3. package/dist/application/application.js +97 -0
  4. package/dist/application/memory.d.ts +20 -0
  5. package/dist/application/memory.js +79 -0
  6. package/dist/application/store.d.ts +101 -0
  7. package/dist/application/store.js +25 -0
  8. package/dist/audience/audience.d.ts +36 -0
  9. package/dist/audience/audience.js +41 -0
  10. package/dist/audience/compose.d.ts +112 -0
  11. package/dist/audience/compose.js +134 -0
  12. package/dist/audience/memory.d.ts +14 -0
  13. package/dist/audience/memory.js +71 -0
  14. package/dist/audience/overlay-store.d.ts +343 -0
  15. package/dist/audience/overlay-store.js +217 -0
  16. package/dist/audience/rule.d.ts +121 -0
  17. package/dist/audience/rule.js +78 -0
  18. package/dist/cli/index.d.ts +3 -4
  19. package/dist/cli/index.js +3 -4
  20. package/dist/cli/templates.js +19 -0
  21. package/dist/data/adapter.d.ts +9 -1
  22. package/dist/data/adapter.js +2 -0
  23. package/dist/data/plan.js +0 -0
  24. package/dist/data/resolution.d.ts +23 -1
  25. package/dist/data/resolve.d.ts +31 -4
  26. package/dist/data/resolve.js +11 -3
  27. package/dist/ids.d.ts +10 -0
  28. package/dist/ids.js +11 -1
  29. package/dist/index.d.ts +1 -0
  30. package/dist/index.js +1 -0
  31. package/dist/interpretation/anthropic.d.ts +1 -1
  32. package/dist/interpretation/anthropic.js +2 -22
  33. package/dist/interpretation/client.d.ts +1 -1
  34. package/dist/interpretation/materialize.js +67 -22
  35. package/dist/interpretation/openai-compatible.d.ts +36 -0
  36. package/dist/interpretation/openai-compatible.js +79 -0
  37. package/dist/interpretation/status.d.ts +19 -0
  38. package/dist/interpretation/status.js +26 -0
  39. package/dist/live/index.d.ts +73 -0
  40. package/dist/live/index.js +73 -0
  41. package/dist/live/pages.d.ts +187 -0
  42. package/dist/live/pages.js +161 -0
  43. package/dist/live/pull.d.ts +147 -0
  44. package/dist/live/pull.js +398 -0
  45. package/dist/live/pulling.d.ts +79 -0
  46. package/dist/live/pulling.js +117 -0
  47. package/dist/live/window.d.ts +129 -0
  48. package/dist/live/window.js +132 -0
  49. package/dist/patch.d.ts +54 -0
  50. package/dist/patch.js +44 -0
  51. package/dist/project/closing.d.ts +51 -0
  52. package/dist/project/closing.js +53 -0
  53. package/dist/project/memory.d.ts +20 -0
  54. package/dist/project/memory.js +97 -0
  55. package/dist/project/project.d.ts +90 -0
  56. package/dist/project/project.js +91 -0
  57. package/dist/project/store.d.ts +135 -0
  58. package/dist/project/store.js +41 -0
  59. package/dist/registered.d.ts +64 -0
  60. package/dist/registered.js +118 -0
  61. package/dist/render/addressed.d.ts +35 -0
  62. package/dist/render/addressed.js +79 -0
  63. package/dist/render/behaviour-adjust.d.ts +11 -19
  64. package/dist/render/behaviour-adjust.js +75 -21
  65. package/dist/render/behaviour-present.d.ts +8 -0
  66. package/dist/render/behaviour-present.js +57 -6
  67. package/dist/render/behaviour.d.ts +98 -17
  68. package/dist/render/behaviour.js +91 -26
  69. package/dist/render/control-name.d.ts +68 -0
  70. package/dist/render/control-name.js +37 -0
  71. package/dist/render/diagnostics.d.ts +72 -0
  72. package/dist/render/diagnostics.js +7 -0
  73. package/dist/render/document-theme.d.ts +70 -0
  74. package/dist/render/document-theme.js +139 -0
  75. package/dist/render/editable.d.ts +15 -1
  76. package/dist/render/editable.js +13 -1
  77. package/dist/render/expected.d.ts +98 -0
  78. package/dist/render/expected.js +88 -0
  79. package/dist/render/index.d.ts +4 -0
  80. package/dist/render/index.js +4 -0
  81. package/dist/render/reads.d.ts +11 -0
  82. package/dist/render/reads.js +12 -1
  83. package/dist/render/render.d.ts +11 -0
  84. package/dist/render/render.js +294 -53
  85. package/dist/render/request.d.ts +8 -1
  86. package/dist/render/request.js +1 -0
  87. package/dist/render/slots.d.ts +52 -0
  88. package/dist/render/slots.js +24 -0
  89. package/dist/render/theme.d.ts +54 -1
  90. package/dist/render/theme.js +23 -1
  91. package/dist/render/unshown.d.ts +152 -0
  92. package/dist/render/unshown.js +80 -0
  93. package/dist/runtime/analysis.d.ts +94 -9
  94. package/dist/runtime/analysis.js +54 -9
  95. package/dist/runtime/assessment.d.ts +36 -2
  96. package/dist/runtime/assessment.js +27 -2
  97. package/dist/runtime/auto-apply-ceiling.d.ts +54 -0
  98. package/dist/runtime/auto-apply-ceiling.js +66 -0
  99. package/dist/runtime/checks.d.ts +148 -0
  100. package/dist/runtime/checks.js +112 -0
  101. package/dist/runtime/disposition.d.ts +96 -0
  102. package/dist/runtime/disposition.js +46 -0
  103. package/dist/runtime/gate.js +91 -10
  104. package/dist/runtime/index.d.ts +4 -0
  105. package/dist/runtime/index.js +4 -0
  106. package/dist/runtime/irreversibility.d.ts +64 -0
  107. package/dist/runtime/irreversibility.js +45 -0
  108. package/dist/runtime/nesting.d.ts +13 -1
  109. package/dist/runtime/nesting.js +41 -24
  110. package/dist/runtime/pipeline.d.ts +43 -0
  111. package/dist/runtime/pipeline.js +10 -2
  112. package/dist/runtime/policy-change.d.ts +93 -0
  113. package/dist/runtime/policy-change.js +305 -0
  114. package/dist/runtime/policy-log.d.ts +406 -0
  115. package/dist/runtime/policy-log.js +285 -0
  116. package/dist/runtime/policy.d.ts +8 -6
  117. package/dist/runtime/policy.js +5 -2
  118. package/dist/runtime/repointing.js +0 -0
  119. package/dist/runtime/reversibility.d.ts +11 -9
  120. package/dist/runtime/stakes.d.ts +129 -1
  121. package/dist/runtime/stakes.js +240 -26
  122. package/dist/runtime/vocabulary.d.ts +164 -7
  123. package/dist/runtime/vocabulary.js +181 -8
  124. package/dist/sdk/audit.d.ts +174 -3
  125. package/dist/sdk/audit.js +176 -17
  126. package/dist/sdk/catalogue.d.ts +9 -1
  127. package/dist/sdk/conformance.d.ts +37 -3
  128. package/dist/sdk/conformance.js +25 -4
  129. package/dist/sdk/definition.d.ts +129 -5
  130. package/dist/sdk/definition.js +66 -0
  131. package/dist/sdk/registry.d.ts +45 -2
  132. package/dist/sdk/registry.js +102 -1
  133. package/dist/signals/acted.contract.d.ts +21 -0
  134. package/dist/signals/acted.contract.js +236 -0
  135. package/dist/signals/acted.d.ts +359 -0
  136. package/dist/signals/acted.js +135 -0
  137. package/dist/signals/action-change.d.ts +507 -0
  138. package/dist/signals/action-change.js +265 -0
  139. package/dist/signals/action.d.ts +331 -0
  140. package/dist/signals/action.js +182 -0
  141. package/dist/signals/agenda.d.ts +585 -0
  142. package/dist/signals/agenda.js +295 -0
  143. package/dist/signals/applied-window.contract.d.ts +23 -0
  144. package/dist/signals/applied-window.contract.js +160 -0
  145. package/dist/signals/arrivals.contract.d.ts +21 -0
  146. package/dist/signals/arrivals.contract.js +180 -0
  147. package/dist/signals/arrivals.d.ts +375 -0
  148. package/dist/signals/arrivals.js +254 -0
  149. package/dist/signals/arriving.d.ts +210 -0
  150. package/dist/signals/arriving.js +133 -0
  151. package/dist/signals/audiences.d.ts +528 -0
  152. package/dist/signals/audiences.js +255 -0
  153. package/dist/signals/broadcast.d.ts +33 -17
  154. package/dist/signals/broadcast.js +255 -32
  155. package/dist/signals/change.d.ts +378 -0
  156. package/dist/signals/change.js +327 -0
  157. package/dist/signals/collect.d.ts +169 -34
  158. package/dist/signals/collect.js +186 -38
  159. package/dist/signals/conversion.d.ts +348 -0
  160. package/dist/signals/conversion.js +235 -0
  161. package/dist/signals/copy-change.d.ts +553 -0
  162. package/dist/signals/copy-change.js +377 -0
  163. package/dist/signals/copy.d.ts +337 -0
  164. package/dist/signals/copy.js +211 -0
  165. package/dist/signals/correlated.contract.d.ts +24 -0
  166. package/dist/signals/correlated.contract.js +94 -0
  167. package/dist/signals/counters.d.ts +97 -0
  168. package/dist/signals/counters.js +160 -0
  169. package/dist/signals/deliver.d.ts +23 -4
  170. package/dist/signals/deliver.js +34 -6
  171. package/dist/signals/deployment-change.d.ts +395 -0
  172. package/dist/signals/deployment-change.js +309 -0
  173. package/dist/signals/deployment.d.ts +278 -0
  174. package/dist/signals/deployment.js +178 -0
  175. package/dist/signals/door.d.ts +114 -0
  176. package/dist/signals/door.js +77 -0
  177. package/dist/signals/expire.d.ts +192 -0
  178. package/dist/signals/expire.js +213 -0
  179. package/dist/signals/fold.d.ts +10 -0
  180. package/dist/signals/fold.js +5 -1
  181. package/dist/signals/form-action.d.ts +302 -0
  182. package/dist/signals/form-action.js +169 -0
  183. package/dist/signals/form-copy.d.ts +523 -0
  184. package/dist/signals/form-copy.js +346 -0
  185. package/dist/signals/forms.d.ts +247 -0
  186. package/dist/signals/forms.js +147 -0
  187. package/dist/signals/frontier.d.ts +268 -0
  188. package/dist/signals/frontier.js +145 -0
  189. package/dist/signals/funnel-change.d.ts +548 -0
  190. package/dist/signals/funnel-change.js +361 -0
  191. package/dist/signals/funnel-hours.contract.d.ts +21 -0
  192. package/dist/signals/funnel-hours.contract.js +221 -0
  193. package/dist/signals/funnel-hours.d.ts +293 -0
  194. package/dist/signals/funnel-hours.js +99 -0
  195. package/dist/signals/funnel.d.ts +592 -0
  196. package/dist/signals/funnel.js +231 -0
  197. package/dist/signals/health.d.ts +694 -0
  198. package/dist/signals/health.js +573 -0
  199. package/dist/signals/index.d.ts +60 -0
  200. package/dist/signals/index.js +60 -0
  201. package/dist/signals/ingest.d.ts +56 -1
  202. package/dist/signals/ingest.js +91 -1
  203. package/dist/signals/inside.d.ts +190 -0
  204. package/dist/signals/inside.js +263 -0
  205. package/dist/signals/join.d.ts +56 -0
  206. package/dist/signals/join.js +60 -0
  207. package/dist/signals/journal.d.ts +123 -9
  208. package/dist/signals/kept.contract.d.ts +22 -0
  209. package/dist/signals/kept.contract.js +111 -0
  210. package/dist/signals/kinds.d.ts +8 -6
  211. package/dist/signals/kinds.js +14 -6
  212. package/dist/signals/library-action.d.ts +430 -0
  213. package/dist/signals/library-action.js +336 -0
  214. package/dist/signals/library-agenda-change.d.ts +324 -0
  215. package/dist/signals/library-agenda-change.js +199 -0
  216. package/dist/signals/library-agenda.d.ts +258 -0
  217. package/dist/signals/library-agenda.js +167 -0
  218. package/dist/signals/library-change.d.ts +477 -0
  219. package/dist/signals/library-change.js +335 -0
  220. package/dist/signals/library-copy-change.d.ts +498 -0
  221. package/dist/signals/library-copy-change.js +476 -0
  222. package/dist/signals/library-pace.d.ts +319 -0
  223. package/dist/signals/library-pace.js +305 -0
  224. package/dist/signals/library-reach-change.d.ts +646 -0
  225. package/dist/signals/library-reach-change.js +542 -0
  226. package/dist/signals/library-reach.d.ts +377 -0
  227. package/dist/signals/library-reach.js +227 -0
  228. package/dist/signals/library-senders-change.d.ts +457 -0
  229. package/dist/signals/library-senders-change.js +367 -0
  230. package/dist/signals/library-senders-reach-change.d.ts +486 -0
  231. package/dist/signals/library-senders-reach-change.js +538 -0
  232. package/dist/signals/library-senders-reach.d.ts +340 -0
  233. package/dist/signals/library-senders-reach.js +252 -0
  234. package/dist/signals/library-senders.d.ts +271 -0
  235. package/dist/signals/library-senders.js +180 -0
  236. package/dist/signals/library-word-reach-change.d.ts +567 -0
  237. package/dist/signals/library-word-reach-change.js +564 -0
  238. package/dist/signals/library.d.ts +306 -0
  239. package/dist/signals/library.js +178 -0
  240. package/dist/signals/memory.d.ts +9 -0
  241. package/dist/signals/memory.js +246 -14
  242. package/dist/signals/migrate.d.ts +20 -4
  243. package/dist/signals/migrate.js +269 -8
  244. package/dist/signals/notice.d.ts +389 -0
  245. package/dist/signals/notice.js +250 -0
  246. package/dist/signals/pace-change.d.ts +501 -0
  247. package/dist/signals/pace-change.js +310 -0
  248. package/dist/signals/pace.d.ts +296 -0
  249. package/dist/signals/pace.js +291 -0
  250. package/dist/signals/page-views.d.ts +365 -0
  251. package/dist/signals/page-views.js +218 -0
  252. package/dist/signals/part-pace.d.ts +378 -0
  253. package/dist/signals/part-pace.js +333 -0
  254. package/dist/signals/parts.d.ts +354 -0
  255. package/dist/signals/parts.js +232 -0
  256. package/dist/signals/postgres.d.ts +16 -2
  257. package/dist/signals/postgres.js +753 -76
  258. package/dist/signals/progress.d.ts +212 -0
  259. package/dist/signals/progress.js +150 -0
  260. package/dist/signals/ratios.d.ts +108 -0
  261. package/dist/signals/ratios.js +40 -0
  262. package/dist/signals/reach.d.ts +309 -0
  263. package/dist/signals/reach.js +93 -0
  264. package/dist/signals/readable.d.ts +34 -0
  265. package/dist/signals/readable.js +34 -0
  266. package/dist/signals/readership.d.ts +381 -0
  267. package/dist/signals/readership.js +308 -0
  268. package/dist/signals/region-pages.d.ts +173 -0
  269. package/dist/signals/region-pages.js +62 -0
  270. package/dist/signals/region.d.ts +287 -0
  271. package/dist/signals/region.js +198 -0
  272. package/dist/signals/retention.d.ts +163 -0
  273. package/dist/signals/retention.js +75 -0
  274. package/dist/signals/rhythm.d.ts +302 -0
  275. package/dist/signals/rhythm.js +262 -0
  276. package/dist/signals/rollup.d.ts +194 -4
  277. package/dist/signals/rollup.js +0 -0
  278. package/dist/signals/schema.d.ts +1069 -1
  279. package/dist/signals/schema.js +393 -3
  280. package/dist/signals/signal.d.ts +237 -11
  281. package/dist/signals/signal.js +70 -10
  282. package/dist/signals/silence-census.d.ts +205 -0
  283. package/dist/signals/silence-census.js +87 -0
  284. package/dist/signals/silences.d.ts +1147 -0
  285. package/dist/signals/silences.js +996 -0
  286. package/dist/signals/subtrees.d.ts +123 -0
  287. package/dist/signals/subtrees.js +102 -0
  288. package/dist/signals/tally.d.ts +262 -12
  289. package/dist/signals/unread.d.ts +292 -0
  290. package/dist/signals/unread.js +137 -0
  291. package/dist/signals/window-agenda.d.ts +276 -0
  292. package/dist/signals/window-agenda.js +83 -0
  293. package/dist/signals/window-figures.d.ts +148 -0
  294. package/dist/signals/window-figures.js +42 -0
  295. package/dist/signals/window-funnels.d.ts +88 -0
  296. package/dist/signals/window-funnels.js +47 -0
  297. package/dist/signals/window.d.ts +866 -0
  298. package/dist/signals/window.js +693 -0
  299. package/dist/signals/words.d.ts +24 -0
  300. package/dist/signals/words.js +24 -0
  301. package/dist/store/cache.d.ts +101 -0
  302. package/dist/store/cache.js +149 -0
  303. package/dist/store/history.d.ts +82 -0
  304. package/dist/store/history.js +36 -0
  305. package/dist/store/index.d.ts +30 -0
  306. package/dist/store/index.js +30 -0
  307. package/dist/store/memory.d.ts +2 -1
  308. package/dist/store/memory.js +48 -12
  309. package/dist/store/migrate.d.ts +106 -0
  310. package/dist/store/migrate.js +323 -7
  311. package/dist/store/postgres-applications.d.ts +4 -0
  312. package/dist/store/postgres-applications.js +197 -0
  313. package/dist/store/postgres-audience.d.ts +14 -0
  314. package/dist/store/postgres-audience.js +272 -0
  315. package/dist/store/postgres-holds.d.ts +10 -1
  316. package/dist/store/postgres-holds.js +116 -101
  317. package/dist/store/postgres-policy-log.d.ts +14 -0
  318. package/dist/store/postgres-policy-log.js +240 -0
  319. package/dist/store/postgres-projects.d.ts +4 -0
  320. package/dist/store/postgres-projects.js +217 -0
  321. package/dist/store/postgres.d.ts +17 -1
  322. package/dist/store/postgres.js +60 -9
  323. package/dist/store/replay.d.ts +102 -1
  324. package/dist/store/replay.js +190 -19
  325. package/dist/store/reseed.d.ts +238 -0
  326. package/dist/store/reseed.js +308 -0
  327. package/dist/store/schema.d.ts +762 -2
  328. package/dist/store/schema.js +218 -5
  329. package/dist/store/source.d.ts +57 -1
  330. package/dist/store/source.js +65 -1
  331. package/dist/store/store.d.ts +29 -6
  332. package/dist/submit/resolve.d.ts +1 -1
  333. package/dist/submit/resolve.js +2 -1
  334. package/dist/telemetry/calibration.d.ts +25 -0
  335. package/dist/telemetry/calibration.js +27 -1
  336. package/dist/telemetry/event.d.ts +391 -33
  337. package/dist/telemetry/event.js +84 -20
  338. package/dist/telemetry/index.d.ts +2 -0
  339. package/dist/telemetry/index.js +2 -0
  340. package/dist/telemetry/journal.d.ts +104 -3
  341. package/dist/telemetry/journal.js +9 -0
  342. package/dist/telemetry/lookup.d.ts +27 -0
  343. package/dist/telemetry/lookup.js +18 -0
  344. package/dist/telemetry/memory.js +33 -1
  345. package/dist/telemetry/migrate.js +22 -1
  346. package/dist/telemetry/postgres.d.ts +10 -1
  347. package/dist/telemetry/postgres.js +188 -90
  348. package/dist/telemetry/remeasure.d.ts +78 -0
  349. package/dist/telemetry/remeasure.js +83 -0
  350. package/dist/telemetry/retention.d.ts +2 -2
  351. package/dist/telemetry/schema.d.ts +17 -0
  352. package/dist/telemetry/schema.js +27 -1
  353. package/dist/telemetry/sink.d.ts +2 -2
  354. package/dist/telemetry/window.d.ts +135 -0
  355. package/dist/telemetry/window.js +101 -0
  356. package/dist/testing/application-contract.d.ts +14 -0
  357. package/dist/testing/application-contract.js +270 -0
  358. package/dist/testing/audience-overlay-contract.d.ts +31 -0
  359. package/dist/testing/audience-overlay-contract.js +354 -0
  360. package/dist/testing/contracts.d.ts +13 -7
  361. package/dist/testing/contracts.js +13 -7
  362. package/dist/testing/definitions.d.ts +78 -0
  363. package/dist/testing/definitions.js +134 -9
  364. package/dist/testing/doubles.d.ts +103 -0
  365. package/dist/testing/doubles.js +143 -0
  366. package/dist/testing/index.d.ts +2 -2
  367. package/dist/testing/index.js +2 -2
  368. package/dist/testing/journal-contract.js +297 -6
  369. package/dist/testing/model-contract.d.ts +110 -0
  370. package/dist/testing/model-contract.js +150 -0
  371. package/dist/testing/policy-log-contract.d.ts +26 -0
  372. package/dist/testing/policy-log-contract.js +344 -0
  373. package/dist/testing/project-contract.d.ts +14 -0
  374. package/dist/testing/project-contract.js +266 -0
  375. package/dist/testing/reader-signal-contract.d.ts +27 -2
  376. package/dist/testing/reader-signal-contract.js +475 -5
  377. package/dist/testing/store-contract.d.ts +7 -1
  378. package/dist/testing/store-contract.js +84 -3
  379. package/dist/theme/apply.d.ts +20 -1
  380. package/dist/theme/apply.js +5 -3
  381. package/dist/theme/contrast.d.ts +19 -14
  382. package/dist/theme/contrast.js +181 -17
  383. package/dist/theme/derive.d.ts +22 -0
  384. package/dist/theme/derive.js +54 -1
  385. package/dist/theme/library.js +1 -1
  386. package/dist/theme/measure.d.ts +34 -0
  387. package/dist/theme/measure.js +30 -1
  388. package/dist/theme/palettes.js +7 -7
  389. package/dist/theme/ramp.d.ts +64 -0
  390. package/dist/theme/ramp.js +114 -0
  391. package/dist/theme/registry.d.ts +9 -0
  392. package/dist/theme/registry.js +11 -1
  393. package/dist/theme/separation.d.ts +97 -3
  394. package/dist/theme/separation.js +75 -0
  395. package/dist/tree/apply.js +13 -0
  396. package/dist/tree/compare.d.ts +9 -0
  397. package/dist/tree/compare.js +18 -0
  398. package/dist/tree/mutation.d.ts +18 -0
  399. package/dist/tree/mutation.js +24 -12
  400. package/dist/tree/navigation.d.ts +5 -0
  401. package/dist/tree/navigation.js +32 -10
  402. package/dist/tree/outline.d.ts +7 -0
  403. package/dist/tree/outline.js +9 -5
  404. package/dist/write/computed.d.ts +60 -0
  405. package/dist/write/computed.js +61 -0
  406. package/dist/write/held.d.ts +59 -0
  407. package/dist/write/index.d.ts +5 -2
  408. package/dist/write/index.js +5 -2
  409. package/dist/write/reseed.d.ts +151 -0
  410. package/dist/write/reseed.js +184 -0
  411. package/dist/write/revert.js +2 -16
  412. package/package.json +25 -3
  413. package/dist/runtime/inverse-interpreter.d.ts +0 -90
  414. package/dist/runtime/inverse-interpreter.js +0 -56
@@ -3,12 +3,15 @@ import type { InteractiveWhen } from "../interactivity.js";
3
3
  import type { JsonObject } from "../json.js";
4
4
  import { type PrimitiveType, type SlotName } from "../primitive-type.js";
5
5
  import { type Result } from "../result.js";
6
- import { type BehaviourName, type BehaviourResolver } from "../render/behaviour.js";
6
+ import { type BehaviourName, type BehaviourResolver, type ControlNameProps } from "../render/behaviour.js";
7
7
  import type { FrameResolver } from "../render/frame.js";
8
+ import { type AnswerExpectation, type AnswerReader } from "../render/expected.js";
8
9
  import type { BindingDeclaration, BindingReader } from "../render/reads.js";
10
+ import type { UnshownDeclaration, UnshownReader } from "../render/unshown.js";
9
11
  import type { LoomPrimitive, PrimitiveResolver } from "../render/primitive.js";
10
12
  import type { PropsValidator, PropsVerdict } from "../render/props.js";
11
13
  import { type PrimitiveText, type TextResolver } from "../render/text.js";
14
+ import type { SlotPlacer } from "../render/slots.js";
12
15
  import { type PrimitiveRole } from "../role.js";
13
16
  import type { CopyDeclarations } from "./copy.js";
14
17
  import type { PrimitiveEntry } from "./definition.js";
@@ -53,6 +56,13 @@ export type RegisteredPrimitive = {
53
56
  readonly frames: readonly string[];
54
57
  /** The controls it takes from the runtime's vocabulary. Empty for most. */
55
58
  readonly behaviours: readonly BehaviourName[];
59
+ /**
60
+ * The prop each of those controls is named by, where its author said so
61
+ * (0234). Empty for almost every primitive that takes a control at all: a
62
+ * control's name is normally a string the primitive declared, and this is the
63
+ * exception for the trigger whose words are the page's.
64
+ */
65
+ readonly names: ControlNameProps;
56
66
  /** What part it plays (0114). `undefined` for most, which play none. */
57
67
  readonly role: PrimitiveRole | undefined;
58
68
  /**
@@ -68,6 +78,25 @@ export type RegisteredPrimitive = {
68
78
  * walk reports under the first and stays quiet under the second.
69
79
  */
70
80
  readonly reads: readonly BindingDeclaration<BindingName>[] | undefined;
81
+ /**
82
+ * The shape of answer it can read under each of those names (0357), erased to
83
+ * a validator. `undefined` where the primitive has declared none, which here
84
+ * is the same answer as declaring an empty map — unlike `reads` and `copy`,
85
+ * because there is no claim in the absence to tell apart: a name with no
86
+ * expectation is handed its answer unchecked either way.
87
+ *
88
+ * Keyed by the name as declared, so a prop-named declaration's expectation is
89
+ * found under its `default` and not under whatever a node renamed it to.
90
+ */
91
+ readonly expects: Readonly<Record<string, AnswerExpectation>> | undefined;
92
+ /**
93
+ * Its own reading of the answers it was given (0206). `undefined` where the
94
+ * author has not said, which here is the same answer as declaring one that
95
+ * reports nothing — unlike `copy` and `reads`, because there is no emptiness
96
+ * to distinguish: a reading is made per answer at render time, and a primitive
97
+ * that has said nothing about its answers is reported on by nothing.
98
+ */
99
+ readonly unshown: UnshownDeclaration | undefined;
71
100
  readonly validate: (props: JsonObject) => PropsVerdict;
72
101
  };
73
102
  export type RegistryError = {
@@ -115,6 +144,16 @@ export type RegistryError = {
115
144
  readonly type: string;
116
145
  readonly behaviour: string;
117
146
  readonly requires: string;
147
+ } | {
148
+ readonly code: "undeclared-named-behaviour";
149
+ readonly type: string;
150
+ readonly behaviour: string;
151
+ readonly prop: string;
152
+ } | {
153
+ readonly code: "undeclared-control-name-prop";
154
+ readonly type: string;
155
+ readonly behaviour: string;
156
+ readonly prop: string;
118
157
  } | {
119
158
  readonly code: "unknown-role";
120
159
  readonly type: string;
@@ -127,11 +166,15 @@ export type RegistryError = {
127
166
  readonly code: "undeclared-reads-prop";
128
167
  readonly type: string;
129
168
  readonly prop: string;
169
+ } | {
170
+ readonly code: "unread-expects-binding";
171
+ readonly type: string;
172
+ readonly name: string;
130
173
  } | {
131
174
  readonly code: "duplicate-primitive-type";
132
175
  readonly type: string;
133
176
  };
134
- export type PrimitiveRegistry = PrimitiveResolver & PropsValidator & TextResolver & BehaviourResolver & FrameResolver & BindingReader & CopyDeclarations & {
177
+ export type PrimitiveRegistry = PrimitiveResolver & PropsValidator & TextResolver & BehaviourResolver & FrameResolver & BindingReader & AnswerReader & SlotPlacer & UnshownReader & CopyDeclarations & {
135
178
  /** In registration order, so a catalogue and an audit read predictably. */
136
179
  readonly primitives: readonly RegisteredPrimitive[];
137
180
  /**
@@ -1,7 +1,8 @@
1
1
  import { BINDING_NAME_EXPECTATION, bindingNameSchema, } from "../data/source.js";
2
2
  import { primitiveTypeSchema, slotNameSchema, textKeySchema, } from "../primitive-type.js";
3
3
  import { err, ok } from "../result.js";
4
- import { BEHAVIOURS, isBehaviourName, } from "../render/behaviour.js";
4
+ import { BEHAVIOURS, isBehaviourName, NO_CONTROL_NAME_PROPS, } from "../render/behaviour.js";
5
+ import { declaredName } from "../render/expected.js";
5
6
  import { NO_TEXT } from "../render/text.js";
6
7
  import { isPrimitiveRole, PRIMITIVE_ROLES } from "../role.js";
7
8
  const NO_BEHAVIOUR_NAMES = Object.freeze([]);
@@ -33,8 +34,14 @@ export const describeRegistryError = (error) => {
33
34
  return `"${error.type}" says it reads a binding called "${error.name}", which is not a binding name — ${BINDING_NAME_EXPECTATION}; a tree cannot ask under a name it cannot write, so this primitive would report every binding it was ever given`;
34
35
  case "unpaired-behaviour":
35
36
  return `"${error.type}" takes the "${error.behaviour}" behaviour and not "${error.requires}", which it does nothing without; it would render a control that asks a region nothing opens to close`;
37
+ case "unread-expects-binding":
38
+ return `"${error.type}" says what shape it expects under "${error.name}", which is not a binding name it declares that it reads; the expectation would then be checked against nothing, and would go on being checked against nothing after the name it was written for was renamed`;
36
39
  case "undeclared-reads-prop":
37
40
  return `"${error.type}" says it reads a binding under whichever name its "${error.prop}" prop gives, which its props schema does not declare; that prop can never arrive, so the primitive would read its default for ever and go on doing so after the prop it names was renamed`;
41
+ case "undeclared-named-behaviour":
42
+ return `"${error.type}" says its "${error.behaviour}" control is named by "${error.prop}" and does not take that behaviour; there is no control for the prop to name, so the declaration would sit there reading as something this primitive does`;
43
+ case "undeclared-control-name-prop":
44
+ return `"${error.type}" says its "${error.behaviour}" control is named by "${error.prop}", which its props schema does not declare; that prop can never arrive, so every one of these controls would quietly fall back to the declared string and go on doing so after the prop it names was renamed`;
38
45
  case "unknown-role":
39
46
  return `"${error.type}" declares the role "${error.role}", which the runtime has none of; the vocabulary is closed and its members are ${PRIMITIVE_ROLES.map((role) => `"${role}"`).join(", ")} — and a misspelling accepted here would read to every consumer as a primitive that declares no role at all`;
40
47
  case "duplicate-primitive-type":
@@ -139,6 +146,41 @@ const registeredBehaviours = (entry) => {
139
146
  }
140
147
  return ok(names);
141
148
  };
149
+ /**
150
+ * Which prop names which control, checked against the two lists it refers to.
151
+ *
152
+ * Both halves fail the way `undeclaredFrameProp` fails and in the quieter
153
+ * direction. A behaviour this primitive does not take is a declaration about a
154
+ * control that is never built, which reads to anyone auditing the registry as
155
+ * something this primitive does. A prop its schema does not declare can never
156
+ * arrive, so every one of those controls falls back to the declared string — a
157
+ * page that is correct, announced by a word its author stopped intending, with
158
+ * nothing anywhere saying so.
159
+ *
160
+ * A schema whose fields cannot be enumerated answers nothing about its props and
161
+ * is left alone on that half, for the reason the other two prop checks give:
162
+ * "I cannot tell you" is not "there are none". The behaviour half is still
163
+ * checked, because the entry's own list is in hand either way.
164
+ */
165
+ const registeredNames = (entry) => {
166
+ const pairs = Object.entries(entry.names);
167
+ if (pairs.length === 0)
168
+ return ok(NO_CONTROL_NAME_PROPS);
169
+ const declaredProps = entry.declaredProps
170
+ ? new Set(entry.declaredProps.map((prop) => prop.name))
171
+ : undefined;
172
+ const names = Object.create(null);
173
+ for (const [behaviour, prop] of pairs) {
174
+ if (!entry.behaviours.includes(behaviour)) {
175
+ return err({ code: "undeclared-named-behaviour", type: entry.type, behaviour, prop });
176
+ }
177
+ if (declaredProps && !declaredProps.has(prop)) {
178
+ return err({ code: "undeclared-control-name-prop", type: entry.type, behaviour, prop });
179
+ }
180
+ names[behaviour] = prop;
181
+ }
182
+ return ok(Object.freeze(names));
183
+ };
142
184
  /**
143
185
  * The declared role, checked — `undefined` for the primitive that declared none,
144
186
  * which is most of them.
@@ -204,6 +246,29 @@ const registeredReads = (entry) => {
204
246
  * with the mistaken.
205
247
  */
206
248
  const declaresProp = (entry, prop) => !entry.declaredProps || entry.declaredProps.some((declared) => declared.name === prop);
249
+ /**
250
+ * An expectation written for a name this primitive does not read, if there is
251
+ * one.
252
+ *
253
+ * The drift `frames` and `copy` are checked for, one seam over: a declaration
254
+ * naming something the thing it describes does not have, left pointing at
255
+ * nothing by a rename. It is checked against `reads` rather than against the
256
+ * props schema because a binding name is not a prop name, and against the name
257
+ * as **declared** — a prop-named declaration's `default` — because that is what
258
+ * an expectation is keyed by (0184, 0357).
259
+ *
260
+ * A primitive that declared expectations and no `reads` at all fails here on its
261
+ * first expectation, which is right: it has said what shape it expects of an
262
+ * answer without ever saying it reads one, so there is no name any of it could
263
+ * be about.
264
+ */
265
+ const unreadExpectsBinding = (entry) => {
266
+ const { expects, reads } = entry;
267
+ if (!expects)
268
+ return undefined;
269
+ const names = new Set((reads ?? []).map(declaredName));
270
+ return Object.keys(expects).find((name) => !names.has(name));
271
+ };
207
272
  const registerEntry = (entry) => {
208
273
  const type = primitiveTypeSchema.safeParse(entry.type);
209
274
  if (!type.success)
@@ -234,9 +299,17 @@ const registerEntry = (entry) => {
234
299
  if (unreadable !== undefined) {
235
300
  return err({ code: "undeclared-copy-prop", type: entry.type, prop: unreadable });
236
301
  }
302
+ const unexpected = unreadExpectsBinding(entry);
303
+ if (unexpected !== undefined) {
304
+ return err({ code: "unread-expects-binding", type: entry.type, name: unexpected });
305
+ }
237
306
  const behaviours = registeredBehaviours(entry);
238
307
  if (!behaviours.ok)
239
308
  return behaviours;
309
+ /** After the behaviours, so an unknown name is refused as one rather than as a pair. */
310
+ const names = registeredNames(entry);
311
+ if (!names.ok)
312
+ return names;
240
313
  const role = registeredRole(entry);
241
314
  if (!role.ok)
242
315
  return role;
@@ -255,9 +328,12 @@ const registerEntry = (entry) => {
255
328
  submits: entry.submits,
256
329
  frames: entry.frames,
257
330
  behaviours: behaviours.value,
331
+ names: names.value,
258
332
  role: role.value,
259
333
  copy: entry.copy ? Object.freeze([...entry.copy]) : undefined,
260
334
  reads: reads.value,
335
+ expects: entry.expects,
336
+ unshown: entry.unshown,
261
337
  validate: entry.validate,
262
338
  });
263
339
  };
@@ -307,6 +383,7 @@ export const createPrimitiveRegistry = (entries) => {
307
383
  validateProps: (type, props) => byType.get(type)?.validate(props) ?? { outcome: "undeclared" },
308
384
  textFor: (type) => byType.get(type)?.text ?? NO_TEXT,
309
385
  behavioursFor: (type) => byType.get(type)?.behaviours ?? NO_BEHAVIOUR_NAMES,
386
+ controlNamePropsFor: (type) => byType.get(type)?.names ?? NO_CONTROL_NAME_PROPS,
310
387
  framePropsFor: (type) => byType.get(type)?.frames ?? NO_FRAME_PROPS,
311
388
  /**
312
389
  * `undefined` both for a primitive that declared nothing and for a type
@@ -316,6 +393,14 @@ export const createPrimitiveRegistry = (entries) => {
316
393
  * primitive reads.
317
394
  */
318
395
  bindingsReadBy: (type) => byType.get(type)?.reads,
396
+ /**
397
+ * `undefined` for a primitive that declared no expectation and for a type
398
+ * this registry does not hold, and the two collapsing is correct for
399
+ * `bindingsReadBy`'s reason: a walk that could not find the primitive has
400
+ * said so as `unknown-primitive` and has no standing to say what shape that
401
+ * primitive can read.
402
+ */
403
+ answersExpectedBy: (type) => byType.get(type)?.expects,
319
404
  /**
320
405
  * `undefined` for a type nobody registered as well as for one that declared
321
406
  * nothing, and the two collapsing here is correct: neither has said what a
@@ -323,6 +408,22 @@ export const createPrimitiveRegistry = (entries) => {
323
408
  * words would under-report the same way this exists to stop.
324
409
  */
325
410
  copyFor: (type) => byType.get(type)?.copy,
411
+ /**
412
+ * `undefined` for a type nobody registered as well as for one that declared
413
+ * nothing, and here the two mean the same thing: a walk that could not find
414
+ * the primitive has said so as `unknown-primitive` and rendered nothing, so
415
+ * there is no node whose answers anybody could have a reading of.
416
+ */
417
+ /**
418
+ * `undefined` only for a type nobody registered, and here that is the whole
419
+ * of the absence: `slots` is the declaration where leaving it out and
420
+ * declaring it empty are the same claim, so a registered primitive that
421
+ * said nothing answers `[]` — it places no regions, which is what a
422
+ * declared slot was given to mean (0051). A walk that could not find the
423
+ * primitive has already said so as `unknown-primitive`.
424
+ */
425
+ slotsPlacedBy: (type) => byType.get(type)?.slots,
426
+ unshownBy: (type) => byType.get(type)?.unshown,
326
427
  typesWithRole: (role) => byRole.get(role) ?? NO_TYPES,
327
428
  });
328
429
  };
@@ -0,0 +1,21 @@
1
+ /**
2
+ * The seventh contract suite both reader-signal tally stores are run against:
3
+ * **what readers did to a part, filed under the hour they did it in, and the
4
+ * hours of a part summing to the part's own counters** (`acted.ts`).
5
+ *
6
+ * Here rather than beside the three in `src/testing/reader-signal-contract.ts`
7
+ * for the reason `arrivals.contract.ts` is: that directory is another lane's
8
+ * and this is reader-signal work.
9
+ *
10
+ * **Every property here needs two implementations to be worth asserting**, and
11
+ * they are the same three hazards the arrivals suite names, one table deeper.
12
+ * The hour is a `timestamptz` in one store and a number in the other; a part's
13
+ * row is written in the same transaction as the tally it slices in one and
14
+ * through two maps in the other; and two rows naming one part-hour inside a
15
+ * single call are an `ON CONFLICT` Postgres **raises** on and a `Map` silently
16
+ * overwrites. Each is a way for a goal's chart to stop summing to the goal's
17
+ * own figure, which is permanent (0158).
18
+ */
19
+ import type { ReaderTallyStore } from "./tally.js";
20
+ export declare const describeActedHourContract: (name: string, make: () => Promise<ReaderTallyStore> | ReaderTallyStore) => void;
21
+ //# sourceMappingURL=acted.contract.d.ts.map
@@ -0,0 +1,236 @@
1
+ /**
2
+ * The seventh contract suite both reader-signal tally stores are run against:
3
+ * **what readers did to a part, filed under the hour they did it in, and the
4
+ * hours of a part summing to the part's own counters** (`acted.ts`).
5
+ *
6
+ * Here rather than beside the three in `src/testing/reader-signal-contract.ts`
7
+ * for the reason `arrivals.contract.ts` is: that directory is another lane's
8
+ * and this is reader-signal work.
9
+ *
10
+ * **Every property here needs two implementations to be worth asserting**, and
11
+ * they are the same three hazards the arrivals suite names, one table deeper.
12
+ * The hour is a `timestamptz` in one store and a number in the other; a part's
13
+ * row is written in the same transaction as the tally it slices in one and
14
+ * through two maps in the other; and two rows naming one part-hour inside a
15
+ * single call are an `ON CONFLICT` Postgres **raises** on and a `Map` silently
16
+ * overwrites. Each is a way for a goal's chart to stop summing to the goal's
17
+ * own figure, which is permanent (0158).
18
+ */
19
+ import { describe, expect, it } from "vitest";
20
+ import { nodeId, OTHER_TREE, primitiveType, RIDERS, SKIERS, TREE } from "../testing/reader-signal-contract.js";
21
+ import { ARRIVAL_HOUR_MS } from "./arrivals.js";
22
+ const HOUR = ARRIVAL_HOUR_MS;
23
+ const MIDNIGHT = Date.parse("2026-11-06T00:00:00.000Z");
24
+ const at = (hour, minutes = 0) => new Date(MIDNIGHT + hour * HOUR + minutes * 60_000).toISOString();
25
+ const hourOf = (hour) => MIDNIGHT + hour * HOUR;
26
+ const pressed = (hour, overrides = {}) => ({
27
+ treeId: TREE,
28
+ revision: 1,
29
+ nodeId: nodeId("buy"),
30
+ type: primitiveType("loom.button"),
31
+ hour: hourOf(hour),
32
+ activations: 1,
33
+ opens: 0,
34
+ closes: 0,
35
+ completions: 0,
36
+ ...overrides,
37
+ });
38
+ const unwrap = (result) => {
39
+ if (!result.ok)
40
+ throw new Error(result.error.detail);
41
+ return result.value;
42
+ };
43
+ export const describeActedHourContract = (name, make) => {
44
+ describe(`${name} — what readers did, by the hour they did it in`, () => {
45
+ const counted = async () => {
46
+ const store = await make();
47
+ unwrap(await store.apply({ tallies: [], funnels: [], acted: [pressed(9, { activations: 2 })] }, at(9, 30), SKIERS));
48
+ return store;
49
+ };
50
+ it("files what readers did under the hour it was folded with", async () => {
51
+ const store = await counted();
52
+ const { hours } = unwrap(await store.acted());
53
+ expect(hours).toEqual([
54
+ {
55
+ audienceId: SKIERS,
56
+ treeId: TREE,
57
+ revision: 1,
58
+ nodeId: nodeId("buy"),
59
+ type: primitiveType("loom.button"),
60
+ hour: hourOf(9),
61
+ activations: 2,
62
+ opens: 0,
63
+ closes: 0,
64
+ completions: 0,
65
+ updatedAt: at(9, 30),
66
+ },
67
+ ]);
68
+ });
69
+ it("adds a second window's rows to the same part-hour", async () => {
70
+ const store = await counted();
71
+ unwrap(await store.apply({ tallies: [], funnels: [], acted: [pressed(9)] }, at(9, 55), SKIERS));
72
+ const { hours } = unwrap(await store.acted());
73
+ expect(hours).toHaveLength(1);
74
+ expect(hours[0]?.activations).toBe(3);
75
+ });
76
+ it("keeps the next hour's presses in their own row", async () => {
77
+ const store = await counted();
78
+ unwrap(await store.apply({ tallies: [], funnels: [], acted: [pressed(10)] }, at(10), SKIERS));
79
+ const { hours } = unwrap(await store.acted());
80
+ expect(hours.map((row) => [row.hour, row.activations])).toEqual(expect.arrayContaining([
81
+ [hourOf(9), 2],
82
+ [hourOf(10), 1],
83
+ ]));
84
+ });
85
+ /**
86
+ * Two rows naming one part-hour inside a single call are added, which is
87
+ * the guarantee `counters.ts` gives in front of the driver: Postgres
88
+ * refuses to affect one row twice in one command and a `Map` would keep
89
+ * the last.
90
+ */
91
+ it("adds two rows of one part-hour handed over together", async () => {
92
+ const store = await make();
93
+ unwrap(await store.apply({ tallies: [], funnels: [], acted: [pressed(9), pressed(9, { activations: 4 })] }, at(9), SKIERS));
94
+ const { hours } = unwrap(await store.acted());
95
+ expect(hours).toHaveLength(1);
96
+ expect(hours[0]?.activations).toBe(5);
97
+ });
98
+ it("counts the four kinds of doing apart", async () => {
99
+ const store = await make();
100
+ unwrap(await store.apply({
101
+ tallies: [],
102
+ funnels: [],
103
+ acted: [pressed(9, { activations: 0, opens: 3, closes: 2, completions: 1 })],
104
+ }, at(9), SKIERS));
105
+ expect(unwrap(await store.acted()).hours[0]).toMatchObject({
106
+ activations: 0,
107
+ opens: 3,
108
+ closes: 2,
109
+ completions: 1,
110
+ });
111
+ });
112
+ it("takes the later window's word for what a part is", async () => {
113
+ const store = await counted();
114
+ unwrap(await store.apply({ tallies: [], funnels: [], acted: [pressed(9, { type: primitiveType("loom.link") })] }, at(9, 40), SKIERS));
115
+ expect(unwrap(await store.acted()).hours[0]?.type).toBe(primitiveType("loom.link"));
116
+ });
117
+ it("keeps two parts of one hour apart, and sums them when neither is named", async () => {
118
+ const store = await counted();
119
+ unwrap(await store.apply({ tallies: [], funnels: [], acted: [pressed(9, { nodeId: nodeId("signup") })] }, at(9, 45), SKIERS));
120
+ expect(unwrap(await store.acted()).hours).toHaveLength(2);
121
+ expect(unwrap(await store.acted({ nodeId: nodeId("buy") })).hours).toHaveLength(1);
122
+ expect(unwrap(await store.acted({ nodeId: nodeId("buy") })).hours[0]?.activations).toBe(2);
123
+ });
124
+ it("keeps an hour of two audiences apart (0284)", async () => {
125
+ const store = await counted();
126
+ unwrap(await store.apply({ tallies: [], funnels: [], acted: [pressed(9)] }, at(9), RIDERS));
127
+ expect(unwrap(await store.acted()).hours).toHaveLength(2);
128
+ expect(unwrap(await store.acted({ audience: RIDERS })).hours[0]?.activations).toBe(1);
129
+ });
130
+ it("keeps an hour of two trees apart", async () => {
131
+ const store = await counted();
132
+ unwrap(await store.apply({ tallies: [], funnels: [], acted: [pressed(9, { treeId: OTHER_TREE })] }, at(9), SKIERS));
133
+ expect(unwrap(await store.acted()).hours).toHaveLength(2);
134
+ expect(unwrap(await store.acted({ treeId: TREE })).hours).toHaveLength(1);
135
+ });
136
+ it("keeps an hour of two revisions apart, so a change can be read across one", async () => {
137
+ const store = await counted();
138
+ unwrap(await store.apply({ tallies: [], funnels: [], acted: [pressed(9, { revision: 2 })] }, at(9), SKIERS));
139
+ expect(unwrap(await store.acted()).hours).toHaveLength(2);
140
+ expect(unwrap(await store.acted({ revision: 2 })).hours[0]?.activations).toBe(1);
141
+ });
142
+ it("writes nothing for a window in which readers did nothing", async () => {
143
+ const store = await make();
144
+ unwrap(await store.apply({ tallies: [], funnels: [], acted: [] }, at(9), SKIERS));
145
+ expect(unwrap(await store.acted()).hours).toEqual([]);
146
+ expect(unwrap(await store.acted()).begins).toBeUndefined();
147
+ });
148
+ describe("over a range", () => {
149
+ const spread = async () => {
150
+ const store = await make();
151
+ for (const hour of [1, 5, 9]) {
152
+ unwrap(await store.apply({ tallies: [], funnels: [], acted: [pressed(hour, { activations: hour })] }, at(hour), SKIERS));
153
+ }
154
+ return store;
155
+ };
156
+ it("holds the hours from the start of the range to the end, and not the ends' neighbours", async () => {
157
+ const store = await spread();
158
+ const { hours } = unwrap(await store.acted({ from: hourOf(5), to: hourOf(9) }));
159
+ expect(hours.map((row) => row.activations)).toEqual([5]);
160
+ });
161
+ it("is unbounded on a side the request leaves out", async () => {
162
+ const store = await spread();
163
+ expect(unwrap(await store.acted({ to: hourOf(9) })).hours).toHaveLength(2);
164
+ expect(unwrap(await store.acted({ from: hourOf(5) })).hours).toHaveLength(2);
165
+ });
166
+ it("answers an empty range with no hours and the beginning still named", async () => {
167
+ const store = await spread();
168
+ const read = unwrap(await store.acted({ from: hourOf(20), to: hourOf(21) }));
169
+ expect(read.hours).toEqual([]);
170
+ expect(read.begins).toBe(hourOf(1));
171
+ });
172
+ });
173
+ describe("the hour counting began", () => {
174
+ it("is the earliest hour the scope has, whatever range was asked for", async () => {
175
+ const store = await make();
176
+ unwrap(await store.apply({ tallies: [], funnels: [], acted: [pressed(9)] }, at(9), SKIERS));
177
+ unwrap(await store.apply({ tallies: [], funnels: [], acted: [pressed(2)] }, at(2), SKIERS));
178
+ expect(unwrap(await store.acted({ from: hourOf(9), to: hourOf(10) })).begins).toBe(hourOf(2));
179
+ });
180
+ /**
181
+ * The clause a goal depends on: a goal made this afternoon on a part
182
+ * nobody pressed until this afternoon has been measurable since this
183
+ * afternoon, and a beginning taken over the deployment would draw a year
184
+ * of noughts behind it.
185
+ */
186
+ it("narrows to the part, so a goal says when its own part was first acted in", async () => {
187
+ const store = await make();
188
+ unwrap(await store.apply({ tallies: [], funnels: [], acted: [pressed(2)] }, at(2), SKIERS));
189
+ unwrap(await store.apply({ tallies: [], funnels: [], acted: [pressed(9, { nodeId: nodeId("signup") })] }, at(9), SKIERS));
190
+ expect(unwrap(await store.acted({ nodeId: nodeId("signup") })).begins).toBe(hourOf(9));
191
+ });
192
+ it("is absent where nothing has ever been counted", async () => {
193
+ const store = await make();
194
+ expect(unwrap(await store.acted()).begins).toBeUndefined();
195
+ });
196
+ });
197
+ /**
198
+ * The invariant the whole design rests on: the hourly rows are a slice of
199
+ * the tallies, so a window's hours add up to the same occurrences its
200
+ * tallies carry. Both are written here by one call, which is what the fold
201
+ * does.
202
+ */
203
+ it("holds the same occurrences as the tally it slices", async () => {
204
+ const store = await make();
205
+ unwrap(await store.apply({
206
+ tallies: [
207
+ {
208
+ treeId: TREE,
209
+ revision: 1,
210
+ nodeId: nodeId("buy"),
211
+ type: primitiveType("loom.button"),
212
+ views: 4,
213
+ reached: 4,
214
+ engaged: 0,
215
+ dwellMs: 9_000,
216
+ activations: 5,
217
+ opens: 0,
218
+ closes: 0,
219
+ completions: 0,
220
+ },
221
+ ],
222
+ funnels: [],
223
+ acted: [pressed(9, { activations: 2 }), pressed(10, { activations: 3 })],
224
+ }, at(10), SKIERS));
225
+ const { hours } = unwrap(await store.acted());
226
+ const [tally] = unwrap(await store.tallies());
227
+ expect(hours.reduce((sum, row) => sum + row.activations, 0)).toBe(tally?.activations);
228
+ });
229
+ it("is not changed by being read", async () => {
230
+ const store = await counted();
231
+ expect(unwrap(await store.acted()).hours[0]?.activations).toBe(2);
232
+ expect(unwrap(await store.acted()).hours[0]?.activations).toBe(2);
233
+ });
234
+ });
235
+ };
236
+ //# sourceMappingURL=acted.contract.js.map