@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
@@ -0,0 +1,255 @@
1
+ import { everyMemberOf } from "../closed-set.js";
2
+ /** Sorted so a split is in the same order whatever order the rows arrived in. */
3
+ const sorted = (audiences) => [...audiences].sort((one, other) => one.localeCompare(other));
4
+ /**
5
+ * The audiences a window names, deduplicated and in a stable order.
6
+ *
7
+ * Rows naming none are not an audience and are not counted as one. A window of
8
+ * them answers `[]`, which is *nothing here says* rather than *one audience* —
9
+ * the distinction `MaybeAudienceScoped` exists for.
10
+ */
11
+ export const audiencesIn = (rows) => {
12
+ const found = new Set();
13
+ for (const row of rows) {
14
+ if (row.audienceId !== undefined)
15
+ found.add(row.audienceId);
16
+ }
17
+ return sorted(found);
18
+ };
19
+ /**
20
+ * Which of the three a window and an asking come to.
21
+ *
22
+ * The census is deduplicated and sorted here, so a caller may hand in the rows
23
+ * of two windows concatenated — a reading of funnel rows is of the populations
24
+ * its own rows name **and** of the populations the page reading it was taken
25
+ * against named, and either alone can be the ambiguous one.
26
+ *
27
+ * An audience asked for always wins, including over a window that names it
28
+ * nowhere: a caller asking for one population and being handed none is holding
29
+ * an empty reading, which is what it asked for and not an ambiguity.
30
+ */
31
+ export const audienceScopeOf = (audiences, asked) => {
32
+ const named = sorted(new Set(audiences));
33
+ if (asked !== undefined)
34
+ return { reading: "one", audienceId: asked, audiences: named };
35
+ if (named.length === 1 && named[0] !== undefined)
36
+ return { reading: "one", audienceId: named[0], audiences: named };
37
+ if (named.length === 0)
38
+ return { reading: "unlabelled", audienceId: null, audiences: [] };
39
+ return { reading: "mixed", audienceId: null, audiences: named };
40
+ };
41
+ /**
42
+ * The scope a reading already recorded, read back off it.
43
+ *
44
+ * What a **second** reading needs: a comparison holding two sides against each
45
+ * other has to know that a side was read as neither population before it can
46
+ * say what moved between them, and a reading that published only its audience
47
+ * and its census leaves that as a subtraction for every caller to make the same
48
+ * way. One of them making it differently is this module's whole subject.
49
+ */
50
+ export const audienceScopeRead = (reading) => audienceScopeOf(reading.audiences, reading.audienceId ?? undefined);
51
+ /**
52
+ * The rows of one audience, and nothing else.
53
+ *
54
+ * A row naming no audience is not in any audience's window. A caller holding
55
+ * such rows is holding something no store produced, and silently folding them
56
+ * into whichever audience was asked for would be this module inventing the
57
+ * fact it exists to keep.
58
+ */
59
+ export const forAudience = (audience, rows) => rows.filter((row) => row.audienceId === audience);
60
+ /**
61
+ * A window a deployment read, split into the populations it actually holds.
62
+ *
63
+ * Exhaustive and lossless: every row is in exactly one window, each window's
64
+ * rows keep the order they arrived in, and the windows themselves are in a
65
+ * stable order so two reads of one store produce the same list. A deployment
66
+ * serving one form of every page gets one window, which is what it has always
67
+ * had.
68
+ */
69
+ export const byAudience = (rows) => {
70
+ const windows = new Map();
71
+ for (const row of rows) {
72
+ const held = windows.get(row.audienceId);
73
+ if (held === undefined)
74
+ windows.set(row.audienceId, [row]);
75
+ else
76
+ held.push(row);
77
+ }
78
+ return sorted(windows.keys()).map((audience) => ({
79
+ audience,
80
+ rows: windows.get(audience) ?? [],
81
+ }));
82
+ };
83
+ /**
84
+ * What makes two readings one page: the tree, the revision and the audience.
85
+ *
86
+ * The one place that decides what a duplicate is. Five readings refuse to count
87
+ * a page twice — the health of a collection, the order over a deployment's
88
+ * pages, and the three censuses of a library — and before this they refused on
89
+ * a tree and a revision, which two audiences of one page share. So a deployment
90
+ * that began serving a second form had that form's reading dropped as a repeat
91
+ * of the first, and the number it was dropped out of went on looking right
92
+ * (0158: a count that has been added cannot be unadded, and one that was never
93
+ * added cannot be noticed).
94
+ *
95
+ * A reading naming no audience keys as itself, so a window of rows that never
96
+ * carried the column behaves exactly as it did.
97
+ */
98
+ export const readingKeyOf = (reading) => `${reading.treeId}\u0000${reading.revision}\u0000${reading.audienceId ?? ""}`;
99
+ /** The form a reading is of, with an absent audience normalised to the `null` it means. */
100
+ export const formOf = (reading) => ({
101
+ treeId: reading.treeId,
102
+ audienceId: reading.audienceId ?? null,
103
+ });
104
+ /**
105
+ * What makes two readings one page in one form, which is what a comparison
106
+ * pairs on.
107
+ *
108
+ * The second of this module's two keys, published for the reason the first is:
109
+ * every comparison in this subsystem decides, in its own loop, whether two
110
+ * readings handed in are one page to be paired or one page handed in twice, and
111
+ * **a tree alone is not that page**. Two forms of it (0263) share a tree, so a
112
+ * comparison keyed by the tree drops the second form as a duplicate where the
113
+ * two sit at one revision and gates **both** out as ambiguous where they do
114
+ * not — which is 0158-permanent in the first case and silent in both.
115
+ */
116
+ export const formKeyOf = (form) => `${form.treeId}\u0000${form.audienceId ?? ""}`;
117
+ /** Sorted so a list of forms reads the same whatever order they arrived in. */
118
+ export const inFormOrder = (one, other) => formKeyOf(one).localeCompare(formKeyOf(other));
119
+ /**
120
+ * The two populations a comparison was handed, published once rather than
121
+ * spelled on each comparison.
122
+ *
123
+ * Carried whether or not the pair was refused, because a `null` on either side
124
+ * is the whole of why a mismatched pair can go unrefused: it is what a surface
125
+ * reads to say *this comparison spans a window that named no audience* rather
126
+ * than being told nothing at all.
127
+ */
128
+ export const comparedAudiencesOf = (was, now) => ({ was: was.audienceId ?? null, now: now.audienceId ?? null });
129
+ /**
130
+ * Whether two sides of a comparison prove they are of two populations.
131
+ *
132
+ * The one place that decides it, for the reason {@link readingKeyOf} is one
133
+ * place: ten comparisons here take their pair from a caller, nine of them
134
+ * refuse a pair of different trees, and a pair of different audiences is the
135
+ * same kind of error with none of the same visibility. Two trees are two pages and every figure comes back absurd; two
136
+ * forms of one page (0263) compare cleanly and the arithmetic is right. What is
137
+ * wrong is the sentence on top of it — *this is what your change did* — when
138
+ * the readership was varied by construction and the tree may not have changed
139
+ * at all.
140
+ *
141
+ * **False where either side names none, and that is not an oversight.** A row
142
+ * written before the column existed (0284) names no audience, so a pair of such
143
+ * a window and an `aud_pro` one is either an honest before-and-after across the
144
+ * migration or a cross-population comparison, and nothing in the counters tells
145
+ * them apart. Refusing both would withhold every comparison spanning the day a
146
+ * deployment upgraded, which is the comparison it most wants; refusing neither
147
+ * would publish a cross-population movement as a change. So the rule refuses
148
+ * what is provable and {@link comparedAudiencesOf} makes the rest visible.
149
+ */
150
+ export const crossesAudiences = (was, now) => {
151
+ const pair = comparedAudiencesOf(was, now);
152
+ return pair.was !== null && pair.now !== null && pair.was !== pair.now;
153
+ };
154
+ /**
155
+ * The audiences a set of forms names, deduplicated and in a stable order.
156
+ *
157
+ * The form-level counterpart of {@link audiencesIn}, which answers the same
158
+ * question over rows. A form whose `audienceId` is `null` is not an audience
159
+ * and is not counted as one, so a window of forms that never carried the
160
+ * column answers `[]` — *nothing here says* rather than *one audience*.
161
+ */
162
+ export const audiencesOf = (forms) => {
163
+ const found = new Set();
164
+ for (const form of forms) {
165
+ if (form.audienceId !== null)
166
+ found.add(form.audienceId);
167
+ }
168
+ return sorted(found);
169
+ };
170
+ /**
171
+ * The pages behind a set of forms, which two forms of one page share.
172
+ *
173
+ * A page is one base tree plus the deltas an audience earns (0263), so the
174
+ * tree is the page and the form is the page as one audience meets it. A window
175
+ * of four forms over three trees is three pages, one of them served twice.
176
+ */
177
+ export const pagesOf = (forms) => {
178
+ const pages = new Set();
179
+ for (const form of forms)
180
+ pages.add(form.treeId);
181
+ return pages;
182
+ };
183
+ /** The closed set, in the order {@link formPairOf} reaches them. */
184
+ export const FORM_PAIR_REFUSALS = everyMemberOf()([
185
+ "different-pages",
186
+ "unsplit",
187
+ "unattributed",
188
+ "one-population",
189
+ "different-revisions",
190
+ ]);
191
+ /** One line per refusal, for a surface saying why there is no pair. */
192
+ export const describeFormPairRefusal = (refusal) => {
193
+ switch (refusal) {
194
+ case "different-pages":
195
+ return "the two readings are of different pages";
196
+ case "unsplit":
197
+ return "one of the two windows holds two forms of the page and says which readers neither";
198
+ case "unattributed":
199
+ return "one of the two windows names no audience, so it is of no form in particular";
200
+ case "one-population":
201
+ return "both readings are of one audience, so there is no second form to compare";
202
+ case "different-revisions":
203
+ return "the two readings are of two revisions, so they are not two forms of one page";
204
+ }
205
+ };
206
+ /**
207
+ * Settle two readings into two forms of one page, or say why they are not.
208
+ *
209
+ * **Neither side is earlier, so the order of the arguments does not reach the
210
+ * answer.** `changeOf` takes `was` and `now` and does not check which is older:
211
+ * a caller holding them backwards gets every sign reversed, which is the
212
+ * bargain 0224 struck so that *this week against last week* comes out of the
213
+ * same function. Here that bargain would be a bug rather than a trade, because
214
+ * there is no fact of the matter about which of two populations comes first.
215
+ * Two deployments asking one question would get two answers, and a screen built
216
+ * on one of them would read the direction of every figure backwards without
217
+ * anything saying so.
218
+ *
219
+ * So the two sides are put in the order of their audience ids **before anything
220
+ * is read off either**, and `one` is the lower of the two names rather than the
221
+ * first argument. A pair with a name missing on either side has no order to
222
+ * take and keeps the arguments' own, which is all the two refusals that have no
223
+ * second population need.
224
+ */
225
+ export const formPairOf = (one, other) => {
226
+ const [first, second] = one.audienceId !== null &&
227
+ other.audienceId !== null &&
228
+ other.audienceId.localeCompare(one.audienceId) < 0
229
+ ? [other, one]
230
+ : [one, other];
231
+ const refusing = (refusal) => ({
232
+ pairing: "refused",
233
+ one: first,
234
+ other: second,
235
+ refusal,
236
+ });
237
+ if (first.treeId !== second.treeId)
238
+ return refusing("different-pages");
239
+ const scopes = { one: audienceScopeRead(first), other: audienceScopeRead(second) };
240
+ if (scopes.one.reading === "mixed" || scopes.other.reading === "mixed")
241
+ return refusing("unsplit");
242
+ if (scopes.one.audienceId === null || scopes.other.audienceId === null)
243
+ return refusing("unattributed");
244
+ if (scopes.one.audienceId === scopes.other.audienceId)
245
+ return refusing("one-population");
246
+ if (first.revision !== second.revision)
247
+ return refusing("different-revisions");
248
+ return {
249
+ pairing: "paired",
250
+ one: first,
251
+ other: second,
252
+ audiences: { one: scopes.one.audienceId, other: scopes.other.audienceId },
253
+ };
254
+ };
255
+ //# sourceMappingURL=audiences.js.map
@@ -28,16 +28,26 @@ import { type RandomBytes } from "./view.js";
28
28
  * the control rather than the band. The addressed elements above it go on the
29
29
  * signal as `within`, read off the walk this was already doing — because which
30
30
  * region a node sat in is a fact about the page at the moment of the press, and
31
- * nothing downstream can recover it afterwards.
31
+ * nothing downstream can recover it afterwards. A `completed` carries the same
32
+ * walk, for the same reason and more sharply: *which band converted* is the
33
+ * question a deployment opens the portal to ask.
34
+ *
35
+ * **A completion is a form the browser let go.** Nothing else on the page is a
36
+ * finish a reader can be said to have reached, and nothing else is observable
37
+ * without asking the network how it went (0211).
32
38
  *
33
39
  * **It keeps up with a page that changes.** Nodes that arrive after it started
34
40
  * are watched and nodes that leave stop counting, so a band behind a Suspense
35
41
  * boundary, a list that grows, and every region a proposal has just changed are
36
- * measured like the rest. What it does *not* follow is the page becoming a
37
- * different page: the tree and revision are read once, off the root, and every
38
- * batch is filed under them. **A new root, or a new revision in the same root,
39
- * is a new broadcast** — `stop()` the old one and start another, or a
40
- * client-side navigation files its signals under the revision it left.
42
+ * measured like the rest.
43
+ *
44
+ * **And with a page that becomes a different page, when it is handed the
45
+ * document.** The tree and revision are read once off a root element, so a
46
+ * broadcast pointed at an element goes on filing every batch under them — which
47
+ * is a client-side navigation's signals filed against the page it left. Pointed
48
+ * at a `Document` it follows the addressed page instead: a new identity ends one
49
+ * page view and opens another, with its own view key and its own arrival, and
50
+ * the same revision rendered again continues the one it was already observing.
41
51
  */
42
52
  /** The DOM event a batch is dispatched as, on the root element. It bubbles. */
43
53
  /**
@@ -49,7 +59,7 @@ import { type RandomBytes } from "./view.js";
49
59
  * a broadcaster in a browser bundle is exactly the host who needs a `send`. One
50
60
  * import line for the two things that are always used together.
51
61
  */
52
- export { DEFAULT_READER_SIGNAL_PATH, deliverReaderSignals, type DeliverOptions, type PostBatch, type SendBeacon, } from "./deliver.js";
62
+ export { BATCH_CONTENT_TYPE, DEFAULT_READER_SIGNAL_PATH, deliverReaderSignals, type DeliverOptions, type PostBatch, type SendBeacon, } from "./deliver.js";
53
63
  export declare const READER_SIGNALS_EVENT = "loom:signals";
54
64
  /** Something that reports elements coming into and out of view. The browser's `IntersectionObserver` unless a host passes its own. */
55
65
  export type VisibilityObserver = {
@@ -118,17 +128,23 @@ export type ReaderSignalBroadcastError = {
118
128
  readonly detail: string;
119
129
  };
120
130
  /**
121
- * Start broadcasting reader signals from the page under `root`.
131
+ * Start broadcasting reader signals from a rendered Loom page.
132
+ *
133
+ * Hand it the **root element** of the page and it broadcasts from that element:
134
+ * nodes arriving and leaving under it are followed, and the tree and revision
135
+ * are read once, so a page that becomes a different page needs `stop()` and
136
+ * another call or its signals are filed under the revision it left.
122
137
  *
123
- * Returns an error rather than broadcasting nothing when the page is not
124
- * addressed, because a silent broadcaster on an unaddressed page is exactly the
125
- * misconfiguration nobody would notice.
138
+ * Hand it the **document** and it finds the addressed page itself and follows
139
+ * it: a client-side navigation ends one page view and begins another, with its
140
+ * own view key and its own arrival, and the same revision rendered again
141
+ * continues the page view it was already observing
142
+ * ({@link followAddressedPage}). This is the argument to pass in an application
143
+ * that routes on the client, which is most of them.
126
144
  *
127
- * Nodes added under `root` afterwards are picked up and nodes removed stop
128
- * counting. The tree and revision are not: they are read once, here, and a page
129
- * that becomes a different page — a client-side navigation, a re-render at a new
130
- * revision into the same root — needs `stop()` and a new broadcast, or its
131
- * signals are filed under the revision it left.
145
+ * Either way it returns an error rather than broadcasting nothing when there is
146
+ * no addressed page to broadcast from, because a silent broadcaster is exactly
147
+ * the misconfiguration nobody would notice.
132
148
  */
133
- export declare const broadcastReaderSignals: (root: Element, options?: ReaderSignalOptions) => Result<ReaderSignalBroadcast, ReaderSignalBroadcastError>;
149
+ export declare const broadcastReaderSignals: (scope: Element | Document, options?: ReaderSignalOptions) => Result<ReaderSignalBroadcast, ReaderSignalBroadcastError>;
134
150
  //# sourceMappingURL=broadcast.d.ts.map