@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,542 @@
1
+ import { everyMemberOf } from "../closed-set.js";
2
+ import { PRIMITIVE_ROLES } from "../role.js";
3
+ import { inFormOrder } from "./audiences.js";
4
+ import { atDoorScale, doorOf } from "./door.js";
5
+ import { kindKeyOf } from "./library.js";
6
+ import { pairedWindowOf, partsByNodeIn } from "./library-change.js";
7
+ import { pageViewsFor } from "./page-views.js";
8
+ import { spokenFor } from "./parts.js";
9
+ export const READING_SIDES = everyMemberOf()(["was", "now"]);
10
+ /** One line per side, for a surface naming the window a page's reason came from. */
11
+ export const describeReadingSide = (side) => side === "was" ? "the earlier window" : "the later window";
12
+ export const KIND_REACH_CHANGE_SILENCES = everyMemberOf()([
13
+ "unplaced",
14
+ "unpaired",
15
+ "unread",
16
+ "unscaled",
17
+ "unopened",
18
+ "uncounted",
19
+ ]);
20
+ /** One line per silence, for a surface saying why a kind has no before and after. */
21
+ export const describeKindReachChangeSilence = (silence) => {
22
+ switch (silence) {
23
+ case "unplaced":
24
+ return "nothing in the pages read, in either window, is of this kind";
25
+ case "unpaired":
26
+ return "no place this kind of part stands is in both windows";
27
+ case "unread":
28
+ return "no place it stands in both windows can be spoken for in both";
29
+ case "unscaled":
30
+ return "a page it stands on has no page views counted at the door in one of the two windows";
31
+ case "unopened":
32
+ return "a page it stands on has a row and nothing has said a page view began";
33
+ case "uncounted":
34
+ return "a page it stands on has readers in one window whose reading has not been counted yet";
35
+ }
36
+ };
37
+ export const KIND_REACH_MOVEMENTS = everyMemberOf()([
38
+ "taken-up",
39
+ "abandoned",
40
+ "held",
41
+ "still-unread",
42
+ "unknown",
43
+ ]);
44
+ /** One line per movement, for a surface putting a kind's before and after in front of a person. */
45
+ export const describeKindReachMovement = (movement) => {
46
+ switch (movement) {
47
+ case "taken-up":
48
+ return "a larger share of the readers who met it read it now";
49
+ case "abandoned":
50
+ return "a smaller share of the readers who met it read it now";
51
+ case "held":
52
+ return "the same share of the readers who met it reads it now";
53
+ case "still-unread":
54
+ return "no reader reached any place it stands, in either window";
55
+ case "unknown":
56
+ return "nothing can be said about what changed";
57
+ }
58
+ };
59
+ export const READER_SHARE_CAUSES = everyMemberOf()(["readers", "pages", "either", "together"]);
60
+ /** One line per cause, for a surface saying what moved a share of readers. */
61
+ export const describeReaderShareCause = (cause) => {
62
+ switch (cause) {
63
+ case "readers":
64
+ return "the way readers read it would have moved it on its own";
65
+ case "pages":
66
+ return "the traffic the pages it stands on had would have moved it on its own";
67
+ case "either":
68
+ return "either would have moved it on its own";
69
+ case "together":
70
+ return "neither would have moved it alone and the two together did";
71
+ }
72
+ };
73
+ const tallying = (kind) => ({
74
+ kind,
75
+ role: null,
76
+ places: 0,
77
+ gained: 0,
78
+ lost: 0,
79
+ comparable: 0,
80
+ pages: new Set(),
81
+ countedWas: 0,
82
+ countedNow: 0,
83
+ metWas: 0,
84
+ metNow: 0,
85
+ heldTraffic: 0,
86
+ heldReading: 0,
87
+ weights: [],
88
+ driftWas: 0,
89
+ driftNow: 0,
90
+ pendingWas: 0,
91
+ pendingNow: 0,
92
+ unreconciled: 0,
93
+ blocked: null,
94
+ });
95
+ /** The two keys one placement is counted under, which is the pair of questions this answers. */
96
+ const keysOf = (part) => [
97
+ { by: "type", type: part.type },
98
+ { by: "role", role: part.role },
99
+ ];
100
+ const rowFor = (rows, kind) => {
101
+ const key = kindKeyOf(kind);
102
+ const row = rows.get(key) ?? tallying(kind);
103
+ rows.set(key, row);
104
+ return row;
105
+ };
106
+ /** The kind-level reason a page's reason causes, which is the same state at the other subject. */
107
+ const KIND_REACH_CHANGE_OF_REACH = Object.freeze({
108
+ unmeasured: "unscaled",
109
+ unopened: "unopened",
110
+ uncounted: "uncounted",
111
+ });
112
+ /**
113
+ * The silence, with the reasons tried in the order they have to be tried in.
114
+ *
115
+ * Nothing of the kind first, because *there is no such part in this library* is
116
+ * a better answer than anything said about its places. Then nothing held still,
117
+ * because a kind whose places all moved is a fact about the library and would
118
+ * otherwise be reported as nobody having been seen reading it. Then nothing
119
+ * spoken for, because a kind no window can speak for has no share whether or not
120
+ * its pages could be scaled.
121
+ */
122
+ const silenceOf = (of) => {
123
+ if (of.places + of.gained + of.lost === 0)
124
+ return "unplaced";
125
+ if (of.places === 0)
126
+ return "unpaired";
127
+ if (of.comparable === 0)
128
+ return "unread";
129
+ return of.blocked === null ? null : KIND_REACH_CHANGE_OF_REACH[of.blocked];
130
+ };
131
+ /**
132
+ * The verdict, off the two shares and never off the two counts.
133
+ *
134
+ * The opposite of 0266's rule, and for the opposite reason: there the
135
+ * denominator is the same count of places on both sides, so the sign of a
136
+ * subtraction of two whole numbers is the whole answer. Here the two
137
+ * denominators are two windows' traffic, so the shares are the only comparable
138
+ * pair and the subtraction has to be done on them.
139
+ */
140
+ const movementOf = (of, silence, shareWas, shareNow) => {
141
+ if (silence !== null)
142
+ return "unknown";
143
+ if (of.metWas === 0 && of.metNow === 0)
144
+ return "still-unread";
145
+ if (shareNow > shareWas)
146
+ return "taken-up";
147
+ if (shareNow < shareWas)
148
+ return "abandoned";
149
+ return "held";
150
+ };
151
+ /**
152
+ * Which side was sufficient, by the direction each counterfactual carries.
153
+ *
154
+ * `null` where nothing moved: a verdict that did not move has nothing to
155
+ * attribute, which is `PaceCause`'s rule (0244).
156
+ */
157
+ export const readerShareCauseOf = (shareWas, shareNow, ifTrafficHeld, ifReadingHeld) => {
158
+ const direction = Math.sign(shareNow - shareWas);
159
+ if (direction === 0)
160
+ return null;
161
+ const readers = Math.sign(ifTrafficHeld - shareWas) === direction;
162
+ const pages = Math.sign(ifReadingHeld - shareWas) === direction;
163
+ if (readers && pages)
164
+ return "either";
165
+ if (readers)
166
+ return "readers";
167
+ if (pages)
168
+ return "pages";
169
+ return "together";
170
+ };
171
+ /**
172
+ * Half the sum of the absolute movements in each place's share of its side's
173
+ * weight, which is the figure a comparison of two readerships publishes
174
+ * (0247), over places rather than regions.
175
+ *
176
+ * **`null` where either side has no weight at all**, because there is no
177
+ * distance between a mix and nothing to have one
178
+ * ([0307](../../decisions/0307-a-distance-between-a-mix-and-nothing-is-withheld-and-the-invariant-both-rolls-rest-on-is-asserted.md)).
179
+ * A nought here is the one value a surface reads as *the weights did not move*,
180
+ * which is the opposite sentence; 0247's own reading withholds `moved` in the
181
+ * same state for the same reason.
182
+ *
183
+ * **Neither roll can reach it**, and that is asserted rather than described:
184
+ * both compute this only where their silence is `null`, and a door that can
185
+ * scale a page has counted at least one page view at it ([`door.ts`](door.ts)),
186
+ * so a measured row has a weight behind it. The guard is here because the
187
+ * helper is exported and a caller outside the two rolls would otherwise divide
188
+ * by nought.
189
+ */
190
+ export const weightMovedOver = (weights, totals) => {
191
+ if (totals.was === 0 || totals.now === 0)
192
+ return null;
193
+ return (weights.reduce((sum, weight) => sum + Math.abs(weight.now / totals.now - weight.was / totals.was), 0) / 2);
194
+ };
195
+ const rowOf = (of) => {
196
+ const silence = silenceOf(of);
197
+ const measured = silence === null;
198
+ const shareWas = of.metWas / of.countedWas;
199
+ const shareNow = of.metNow / of.countedNow;
200
+ const ifTrafficHeld = of.heldTraffic / of.countedWas;
201
+ const ifReadingHeld = of.heldReading / of.countedNow;
202
+ return {
203
+ kind: of.kind,
204
+ role: of.kind.by === "type" ? of.role : null,
205
+ places: of.places,
206
+ gained: of.gained,
207
+ lost: of.lost,
208
+ comparable: of.comparable,
209
+ pages: of.pages.size,
210
+ countedWas: measured ? of.countedWas : null,
211
+ countedNow: measured ? of.countedNow : null,
212
+ metWas: measured ? of.metWas : null,
213
+ metNow: measured ? of.metNow : null,
214
+ shareWas: measured ? shareWas : null,
215
+ shareNow: measured ? shareNow : null,
216
+ shift: measured ? shareNow - shareWas : null,
217
+ readersMoved: measured ? (shareNow - shareWas) * of.countedNow : null,
218
+ ifTrafficHeld: measured ? ifTrafficHeld : null,
219
+ ifReadingHeld: measured ? ifReadingHeld : null,
220
+ movement: movementOf(of, silence, shareWas, shareNow),
221
+ cause: measured ? readerShareCauseOf(shareWas, shareNow, ifTrafficHeld, ifReadingHeld) : null,
222
+ weightMoved: measured
223
+ ? weightMovedOver(of.weights, { was: of.countedWas, now: of.countedNow })
224
+ : null,
225
+ driftWas: of.driftWas,
226
+ driftNow: of.driftNow,
227
+ pendingWas: of.pendingWas,
228
+ pendingNow: of.pendingNow,
229
+ unreconciled: of.unreconciled,
230
+ exact: measured &&
231
+ of.driftWas === 0 &&
232
+ of.driftNow === 0 &&
233
+ of.pendingWas === 0 &&
234
+ of.pendingNow === 0 &&
235
+ of.unreconciled === 0,
236
+ silence,
237
+ };
238
+ };
239
+ /** The name a row is ordered by, which is the key's own and never the row's position. */
240
+ const nameOf = (kind) => (kind.by === "type" ? kind.type : (kind.role ?? ""));
241
+ /**
242
+ * The worse of two, which is the ranking rule spelled once.
243
+ *
244
+ * Most readers lost, then the lower share now, then by name. A kind with no
245
+ * figures at all sorts after every kind that has them — infinity rather than a
246
+ * nought, because `null` is *nothing can be said* and a nought would rank a
247
+ * withheld row among the kinds that merely held.
248
+ */
249
+ const worseOf = (one, other) => (one.readersMoved ?? Number.POSITIVE_INFINITY) -
250
+ (other.readersMoved ?? Number.POSITIVE_INFINITY) ||
251
+ (one.shareNow ?? 2) - (other.shareNow ?? 2) ||
252
+ nameOf(one.kind).localeCompare(nameOf(other.kind));
253
+ /**
254
+ * Tree id, then newest revision first, then the side, which is the order the
255
+ * page-view rows are read in.
256
+ *
257
+ * Published because a second comparison lists the same type for the same
258
+ * reason — what a change did to a library's silent senders among the readings
259
+ * that got inside them — and two spellings of one order that agree today is
260
+ * what this subsystem keeps being bitten by.
261
+ */
262
+ export const inUnscaledSideOrder = (one, other) => one.treeId.localeCompare(other.treeId) ||
263
+ other.revision - one.revision ||
264
+ one.side.localeCompare(other.side);
265
+ /** One page with its door, picked out of the window's rows by the published matching rule. */
266
+ export const scaledPageOf = (reading, rows) => {
267
+ const found = pageViewsFor(reading, rows);
268
+ return { reading, door: doorOf(found.measured), duplicatedRows: found.duplicated };
269
+ };
270
+ /**
271
+ * One placement's contribution to one kind, which is nothing at all unless both
272
+ * windows can speak for it.
273
+ *
274
+ * The door's reason is taken only from a page bearing a placement both sides
275
+ * have a verdict on: a kind nobody read in either window is `unread` and not
276
+ * `unscaled`, because *no window can speak for it* is the better answer and the
277
+ * door has nothing to scale either way.
278
+ */
279
+ const add = (into, places, doors, form) => {
280
+ into.places += 1;
281
+ if (places.was.standing === "unknown" || places.now.standing === "unknown")
282
+ return;
283
+ into.comparable += 1;
284
+ /**
285
+ * The form and not the tree, because the pairing is per form: counting two
286
+ * forms of a page as one page would understate the places a kind stands in
287
+ * by exactly the pages a deployment serves twice.
288
+ */
289
+ into.pages.add(form);
290
+ if (doors.was.silence !== null || doors.now.silence !== null) {
291
+ into.blocked ??= doors.was.silence ?? doors.now.silence;
292
+ return;
293
+ }
294
+ const reachedWas = places.was.counters?.reached ?? 0;
295
+ const reachedNow = places.now.counters?.reached ?? 0;
296
+ into.countedWas += doors.was.counted;
297
+ into.countedNow += doors.now.counted;
298
+ /**
299
+ * `reached × counted ÷ appearances`, in that order, because it is the
300
+ * published order (0256): a surface drawing one window's share beside this
301
+ * one's `shareNow` is drawing the same number, and three floats multiplied
302
+ * and divided in two orders agree to fifteen places and not to sixteen.
303
+ */
304
+ into.metWas += atDoorScale(reachedWas, doors.was);
305
+ into.metNow += atDoorScale(reachedNow, doors.now);
306
+ /** The same term with the other side's weight, which is the whole of a counterfactual. */
307
+ into.heldTraffic += atDoorScale(reachedNow, doors.now, doors.was);
308
+ into.heldReading += atDoorScale(reachedWas, doors.was, doors.now);
309
+ into.weights.push({ was: doors.was.counted, now: doors.now.counted });
310
+ into.driftWas += doors.was.drift;
311
+ into.driftNow += doors.now.drift;
312
+ into.pendingWas += doors.was.pending;
313
+ into.pendingNow += doors.now.pending;
314
+ into.unreconciled +=
315
+ reachedWas > doors.was.appearances || reachedNow > doors.now.appearances ? 1 : 0;
316
+ };
317
+ /** The pages of one window, keyed by form, with each page's door already worked out. */
318
+ export const librarySideOf = (window) => {
319
+ const pages = pairedWindowOf(window.readings);
320
+ const scaled = new Map([...pages.byForm].map(([form, reading]) => [
321
+ form,
322
+ scaledPageOf(reading, window.rows),
323
+ ]));
324
+ return {
325
+ pages,
326
+ scaled,
327
+ duplicatedRows: [...scaled.values()].reduce((sum, of) => sum + of.duplicatedRows, 0),
328
+ };
329
+ };
330
+ /**
331
+ * Of the readers who met a kind of part, the share that read it — before and
332
+ * after.
333
+ *
334
+ * Takes each window as its readings and the whole window of door rows a
335
+ * deployment holds for it, because the figure needs the door on both sides: the
336
+ * pages are paired by 0266's rule and each side's terms are put on its own
337
+ * door's scale by 0256's.
338
+ *
339
+ * The labels are the caller's. Two readings of one window and one library come
340
+ * back as every place held, every share identical and nothing gained or lost; a
341
+ * caller who holds the two sides backwards gets a comparison with every movement
342
+ * reversed rather than a refusal, exactly as a before-and-after reading of one
343
+ * page does.
344
+ *
345
+ * Linear in the parts of the readings times the rows, with one pass per window
346
+ * that fills both groupings.
347
+ */
348
+ export const libraryReachChangeOf = (was, now) => {
349
+ const earlier = librarySideOf(was);
350
+ const later = librarySideOf(now);
351
+ const rows = new Map();
352
+ const roleWas = new Map();
353
+ const roleNow = new Map();
354
+ const ambiguous = new Map([...earlier.pages.ambiguous, ...later.pages.ambiguous]);
355
+ const unscaled = [];
356
+ let pages = 0;
357
+ let pagesGained = 0;
358
+ let pagesLost = 0;
359
+ let formsGained = 0;
360
+ let formsLost = 0;
361
+ let republished = 0;
362
+ let placements = 0;
363
+ let gained = 0;
364
+ let lost = 0;
365
+ let recast = 0;
366
+ let arrivalsWas = 0;
367
+ let arrivalsNow = 0;
368
+ let scaled = 0;
369
+ /**
370
+ * Every role in the vocabulary gets a row whether or not anything plays it, as
371
+ * a census's role rows do: a role nothing in the library plays is a fact about
372
+ * the library, and a surface that had to tell a missing row from an empty one
373
+ * would be reading the vocabulary itself.
374
+ */
375
+ for (const role of [...PRIMITIVE_ROLES, null])
376
+ rowFor(rows, { by: "role", role });
377
+ for (const [form, reading] of earlier.pages.byForm) {
378
+ if (ambiguous.has(form))
379
+ continue;
380
+ for (const part of reading.parts) {
381
+ roleWas.set(part.type, part.role);
382
+ rowFor(rows, { by: "type", type: part.type }).role = part.role;
383
+ }
384
+ if (later.pages.byForm.has(form))
385
+ continue;
386
+ pagesLost += 1;
387
+ /** The page is still served, in the other form: a form left the library and the page did not (0295). */
388
+ if (later.pages.pagesHeld.has(reading.treeId))
389
+ formsLost += 1;
390
+ for (const part of reading.parts) {
391
+ lost += 1;
392
+ for (const kind of keysOf(part))
393
+ rowFor(rows, kind).lost += 1;
394
+ }
395
+ }
396
+ for (const [form, reading] of later.pages.byForm) {
397
+ if (ambiguous.has(form))
398
+ continue;
399
+ for (const part of reading.parts) {
400
+ roleNow.set(part.type, part.role);
401
+ rowFor(rows, { by: "type", type: part.type }).role = part.role;
402
+ }
403
+ if (earlier.pages.byForm.has(form))
404
+ continue;
405
+ pagesGained += 1;
406
+ /** The page was already served, in the other form: a second form began rather than a page being published. */
407
+ if (earlier.pages.pagesHeld.has(reading.treeId))
408
+ formsGained += 1;
409
+ for (const part of reading.parts) {
410
+ gained += 1;
411
+ for (const kind of keysOf(part))
412
+ rowFor(rows, kind).gained += 1;
413
+ }
414
+ }
415
+ for (const [form, before] of earlier.pages.byForm) {
416
+ const after = later.pages.byForm.get(form);
417
+ const doorWas = earlier.scaled.get(form);
418
+ const doorNow = later.scaled.get(form);
419
+ if (after === undefined || doorWas === undefined || doorNow === undefined)
420
+ continue;
421
+ if (ambiguous.has(form))
422
+ continue;
423
+ const beforeParts = partsByNodeIn(before);
424
+ const afterParts = partsByNodeIn(after);
425
+ const doors = { was: doorWas.door, now: doorNow.door };
426
+ pages += 1;
427
+ republished += before.revision === after.revision ? 0 : 1;
428
+ arrivalsWas += doors.was.opened;
429
+ arrivalsNow += doors.now.opened;
430
+ if (doors.was.silence === null && doors.now.silence === null)
431
+ scaled += 1;
432
+ /**
433
+ * A page the door cannot scale is listed once per side it is unscalable on,
434
+ * and only where a window could speak for something on it: a page nobody
435
+ * read in either window is not a page whose readers could not be counted,
436
+ * and listing it would put the commonest healthy state on the one list here
437
+ * that is meant to be empty.
438
+ */
439
+ const spoken = before.parts.some((part) => {
440
+ const counterpart = afterParts.get(part.nodeId);
441
+ return (spokenFor(part.standing) && counterpart !== undefined && spokenFor(counterpart.standing));
442
+ });
443
+ if (spoken) {
444
+ if (doors.was.silence !== null) {
445
+ unscaled.push({
446
+ treeId: before.treeId,
447
+ revision: before.revision,
448
+ audienceId: before.audienceId,
449
+ against: after.revision,
450
+ side: "was",
451
+ silence: doors.was.silence,
452
+ });
453
+ }
454
+ if (doors.now.silence !== null) {
455
+ unscaled.push({
456
+ treeId: after.treeId,
457
+ revision: after.revision,
458
+ audienceId: after.audienceId,
459
+ against: before.revision,
460
+ side: "now",
461
+ silence: doors.now.silence,
462
+ });
463
+ }
464
+ }
465
+ for (const part of before.parts) {
466
+ const counterpart = afterParts.get(part.nodeId);
467
+ if (counterpart === undefined) {
468
+ lost += 1;
469
+ for (const kind of keysOf(part))
470
+ rowFor(rows, kind).lost += 1;
471
+ continue;
472
+ }
473
+ if (part.type === counterpart.type) {
474
+ placements += 1;
475
+ }
476
+ else {
477
+ recast += 1;
478
+ lost += 1;
479
+ gained += 1;
480
+ rowFor(rows, { by: "type", type: part.type }).lost += 1;
481
+ rowFor(rows, { by: "type", type: counterpart.type }).gained += 1;
482
+ }
483
+ if (part.role !== counterpart.role) {
484
+ rowFor(rows, { by: "role", role: part.role }).lost += 1;
485
+ rowFor(rows, { by: "role", role: counterpart.role }).gained += 1;
486
+ }
487
+ /**
488
+ * A placement is paired under a key only where it is of that kind on both
489
+ * sides, which is the places comparison's rule (0266) and where the two
490
+ * keys answer differently: a node recast into another type is a place one
491
+ * type left and another took, while the role rows hold it still wherever
492
+ * the two types play the same part.
493
+ */
494
+ const sameType = part.type === counterpart.type ? [{ by: "type", type: part.type }] : [];
495
+ const sameRole = part.role === counterpart.role ? [{ by: "role", role: part.role }] : [];
496
+ for (const kind of [...sameType, ...sameRole]) {
497
+ add(rowFor(rows, kind), { was: part, now: counterpart }, doors, form);
498
+ }
499
+ }
500
+ for (const part of after.parts) {
501
+ if (beforeParts.has(part.nodeId))
502
+ continue;
503
+ gained += 1;
504
+ for (const kind of keysOf(part))
505
+ rowFor(rows, kind).gained += 1;
506
+ }
507
+ }
508
+ const built = [...rows.values()].map(rowOf);
509
+ const byType = built.filter((row) => row.kind.by === "type").sort(worseOf);
510
+ const disagreed = [...roleNow.keys()]
511
+ .filter((type) => roleWas.has(type) && roleWas.get(type) !== roleNow.get(type))
512
+ .sort((one, other) => one.localeCompare(other));
513
+ return {
514
+ byType,
515
+ byRole: built.filter((row) => row.kind.by === "role").sort(worseOf),
516
+ pages,
517
+ pagesGained,
518
+ formsGained,
519
+ pagesLost,
520
+ formsLost,
521
+ audiences: { was: earlier.pages.audiences, now: later.pages.audiences },
522
+ republished,
523
+ placements,
524
+ gained,
525
+ lost,
526
+ recast,
527
+ arrivalsWas,
528
+ arrivalsNow,
529
+ scaled,
530
+ unscaled: [...unscaled].sort(inUnscaledSideOrder),
531
+ mostAbandoned: byType.find((row) => (row.readersMoved ?? 0) < 0) ?? null,
532
+ mostTakenUp: byType
533
+ .filter((row) => (row.readersMoved ?? 0) > 0)
534
+ .sort((one, other) => (other.readersMoved ?? 0) - (one.readersMoved ?? 0) ||
535
+ nameOf(one.kind).localeCompare(nameOf(other.kind)))[0] ?? null,
536
+ ambiguous: [...ambiguous.values()].sort(inFormOrder),
537
+ duplicated: earlier.pages.duplicated + later.pages.duplicated,
538
+ duplicatedRows: earlier.duplicatedRows + later.duplicatedRows,
539
+ roleDisagreed: disagreed,
540
+ };
541
+ };
542
+ //# sourceMappingURL=library-reach-change.js.map