@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,377 @@
1
+ import { everyMemberOf } from "../closed-set.js";
2
+ import { audienceScopeRead, comparedAudiencesOf, crossesAudiences, } from "./audiences.js";
3
+ import { copyReadingOf, passageOf } from "./copy.js";
4
+ import { spokenFor } from "./parts.js";
5
+ /** The closed set, for a surface that has to account for every reason a figure is absent. */
6
+ export const COPY_CHANGE_SILENCES = everyMemberOf()([
7
+ "different-trees",
8
+ "different-audiences",
9
+ "wordless",
10
+ "audiences-mixed",
11
+ "nothing-measured",
12
+ "inconsistent",
13
+ "dissolved",
14
+ "floored",
15
+ "unspoken",
16
+ ]);
17
+ /** One line per silence, for a surface saying why a figure is not there. */
18
+ export const describeCopyChangeSilence = (silence) => {
19
+ switch (silence) {
20
+ case "different-trees":
21
+ return "the two readings are of different pages";
22
+ case "different-audiences":
23
+ return "the two readings are of different audiences, and so of different readers";
24
+ case "wordless":
25
+ return "neither revision says anything that could be read";
26
+ case "audiences-mixed":
27
+ return "one window holds two forms of the page and says which readers neither";
28
+ case "nothing-measured":
29
+ return "one of the two windows held no page views";
30
+ case "inconsistent":
31
+ return "a passage reports more readers than its page has views, which no rollup produces";
32
+ case "dissolved":
33
+ return "the change left no word of the page as it was, so there is nothing to compare";
34
+ case "floored":
35
+ return "some carried passage declares no copy, so a page-wide mean of its words would not be a ceiling";
36
+ case "unspoken":
37
+ return "no carried word of the page can be spoken for in both windows";
38
+ }
39
+ };
40
+ /** The closed set, for a surface accounting for every passage it was handed. */
41
+ export const PASSAGE_MOVEMENTS = everyMemberOf()([
42
+ "held",
43
+ "gained",
44
+ "lost",
45
+ "unread",
46
+ "unknown",
47
+ ]);
48
+ /** One line per movement, for a surface putting a passage in front of a person. */
49
+ export const describePassageMovement = (movement) => {
50
+ switch (movement) {
51
+ case "held":
52
+ return "readers reached it before and reach it now";
53
+ case "gained":
54
+ return "nobody reached it before and somebody does now";
55
+ case "lost":
56
+ return "somebody reached it before and nobody does now";
57
+ case "unread":
58
+ return "nobody reached it before or now";
59
+ case "unknown":
60
+ return "one of the two windows cannot say whether it was reached";
61
+ }
62
+ };
63
+ const ZERO_BY_STANDING = Object.freeze({
64
+ read: 0,
65
+ skipped: 0,
66
+ unknown: 0,
67
+ });
68
+ const ZERO_BY_MOVEMENT = Object.freeze({
69
+ held: 0,
70
+ gained: 0,
71
+ lost: 0,
72
+ unread: 0,
73
+ unknown: 0,
74
+ });
75
+ const NO_WORDS_WRITTEN = Object.freeze({
76
+ carried: 0,
77
+ added: 0,
78
+ addedByStanding: ZERO_BY_STANDING,
79
+ removed: 0,
80
+ removedByStanding: ZERO_BY_STANDING,
81
+ reworded: Object.freeze({ was: 0, now: 0 }),
82
+ });
83
+ /**
84
+ * Whether two passages say the same thing, in order.
85
+ *
86
+ * The visible words, which is what every figure here divides by. A part may be
87
+ * floored on one side and not the other while these agree — a prop nobody
88
+ * declared holding something on one revision and nothing on the next — and that
89
+ * is what {@link ComparedPassage.floored} carries rather than a third category.
90
+ */
91
+ const sameText = (one, other) => one.length === other.length && one.every((value, at) => value === other[at]);
92
+ /**
93
+ * What one window said about one passage, as a side of a comparison.
94
+ *
95
+ * **Published rather than kept private**, for the reason `passageOf` itself is
96
+ * (0235): a comparison of two **forms** of one page asks the same question of
97
+ * the same passages as this comparison of two windows, and one projection with
98
+ * two spellings is two things to disagree about once a third reading arrives.
99
+ * The rule it carries is the whole of it — a window with no views has no reach
100
+ * at all, and a reach is never clamped to its own ceiling.
101
+ */
102
+ export const passageSideOf = (passage, views) => ({
103
+ standing: passage.standing,
104
+ readers: passage.readers,
105
+ views,
106
+ reach: views === 0 ? null : passage.readers / views,
107
+ });
108
+ /**
109
+ * What happened between two standings.
110
+ *
111
+ * `unknown` first and on either side, because it is the one answer that is not
112
+ * about the passage: a window with no views, or a part that reported something
113
+ * other than coming into view, cannot be read as nobody having reached it
114
+ * (0212).
115
+ */
116
+ const movementOf = (was, now) => {
117
+ if (!spokenFor(was) || !spokenFor(now))
118
+ return "unknown";
119
+ if (was === "read")
120
+ return now === "read" ? "held" : "lost";
121
+ return now === "read" ? "gained" : "unread";
122
+ };
123
+ /**
124
+ * Whether a passage is worth a row at all.
125
+ *
126
+ * The rule `copyReadingOf` applies to one side, applied to the pair: a part
127
+ * that says nothing on either side and is hiding nothing on either side has no
128
+ * words for this module to be about. A floored part is kept because *this may
129
+ * say something nothing here can see* is not *this says nothing* (0122).
130
+ */
131
+ const saysSomething = (sides) => sides.some((passage) => passage.words > 0 || passage.floored);
132
+ /**
133
+ * The words a passage newly put in front of the average reader, and `null`
134
+ * where one of the two sides is not a measurement.
135
+ *
136
+ * Two refusals, and the second is 0282's. A side with no views has no `reach`
137
+ * at all. A side whose standing is `unknown` has a `reach` of nought that is a
138
+ * missing counter rather than a reader who did not arrive — so a subtraction
139
+ * against it is the other side's whole reach, signed as though the change had
140
+ * caused it, which is the one direction a reading of a quiet window must not be
141
+ * wrong in (0212).
142
+ *
143
+ * It is what keeps the sum of the gains equal to {@link CopyChange.typical}'s
144
+ * `change`: the total is over the same spoken-for passages this is published
145
+ * for, so a passage in no term of one is in no term of the other.
146
+ */
147
+ const gainOf = (words, movement, was, now) => movement === "unknown" || was.reach === null || now.reach === null
148
+ ? null
149
+ : words * (now.reach - was.reach);
150
+ /**
151
+ * Whether both windows can say whether this passage was reached.
152
+ *
153
+ * The one test every signed figure here is taken over. A passage `unknown` on
154
+ * either side is in the census, in `wordsByMovement` and in no mass (0282).
155
+ *
156
+ * **Published, because a reading of a library asks the same question of the
157
+ * same passages** (0280) and spelled it a second way until 0287. It is read
158
+ * off the movement, which `movementOf` derives from the same `spokenFor` the
159
+ * page-scale figures use — so the two are one rule rather than two that agree.
160
+ */
161
+ export const spokenForOnBothSides = (passage) => passage.movement !== "unknown";
162
+ /** Descending by words, strictly, so equal passages keep the order they arrived in. */
163
+ const byWordsUnread = (one, other) => other.words - one.words;
164
+ /** The larger gain of two, `>` keeping the first in reading order on a tie. */
165
+ const moreGainedOf = (standing, next) => standing === null || (next.gain ?? 0) > (standing.gain ?? 0) ? next : standing;
166
+ const moreLostOf = (standing, next) => standing === null || (next.gain ?? 0) < (standing.gain ?? 0) ? next : standing;
167
+ const wordsAdded = (passages) => passages.reduce((total, passage) => total + passage.words, 0);
168
+ const wordsByStandingOf = (passages) => passages.reduce((counted, passage) => ({
169
+ ...counted,
170
+ [passage.standing]: counted[passage.standing] + passage.words,
171
+ }), { ...ZERO_BY_STANDING });
172
+ /**
173
+ * Every part of a reading as a passage, keyed by node.
174
+ *
175
+ * Over **every** part rather than over the reading's own passages, because a
176
+ * part that said nothing before and says something now is a word the change
177
+ * wrote and not a part the change added — and a filtered map could not tell the
178
+ * two apart.
179
+ */
180
+ const passagesOf = (reading) => {
181
+ const byNode = new Map();
182
+ for (const part of reading.parts)
183
+ byNode.set(part.nodeId, passageOf(part));
184
+ return byNode;
185
+ };
186
+ /**
187
+ * Why there is no reader comparison, in the order a pair is in more than one of
188
+ * these.
189
+ *
190
+ * `dissolved` before `unspoken`, because *the change left no word as it was* is
191
+ * a fact about the change and the stronger thing to say; and `unspoken` before
192
+ * `floored`, for the reason a copy reading orders its own two that way (0282):
193
+ * a floor is a declaration a library has not made and a page where nothing
194
+ * reports reach would still have no mean once every `copy` prop was declared.
195
+ */
196
+ /**
197
+ * Whether either side was read as neither of two forms.
198
+ *
199
+ * Taken off the two readings' own published scope rather than recomputed, which
200
+ * is what `audienceScopeRead` is for: five comparisons now ask this one question
201
+ * and a sixth spelling of it is how the rule comes to be agreed with by some of
202
+ * them (0293).
203
+ */
204
+ const unsplit = (was, now) => audienceScopeRead(was).reading === "mixed" || audienceScopeRead(now).reading === "mixed";
205
+ const silenceOf = (words, readings, views, unsplit, carried, spoken, floored) => {
206
+ if (words.was === 0 && words.now === 0)
207
+ return "wordless";
208
+ if (unsplit)
209
+ return "audiences-mixed";
210
+ if (views.was === 0 || views.now === 0)
211
+ return "nothing-measured";
212
+ if (readings.was.silence === "inconsistent" || readings.now.silence === "inconsistent") {
213
+ return "inconsistent";
214
+ }
215
+ if (carried === 0)
216
+ return "dissolved";
217
+ if (spoken === 0)
218
+ return "unspoken";
219
+ return floored > 0 ? "floored" : null;
220
+ };
221
+ /**
222
+ * What a change did to the words of a page and to the reading of them.
223
+ *
224
+ * Handed two `PageReading`s rather than two `CopyReading`s, for the reason
225
+ * `readingChangeOf` is handed two: one input per side cannot be a mismatched
226
+ * pair, and the census needs the parts a copy reading leaves out — a part that
227
+ * says nothing on one side is a word the change wrote on the other, and reading
228
+ * it off a filtered list would call the part new. The two copy readings it
229
+ * derives are returned.
230
+ *
231
+ * The labels `was` and `now` are the caller's. Nothing here checks which
232
+ * reading is older, so a caller holding them backwards gets a comparison with
233
+ * every sign reversed rather than a refusal — the same bargain 0224 struck, for
234
+ * the same reason: *this week against last week* is the same question with the
235
+ * tree held still, and refusing one order would refuse that too.
236
+ */
237
+ export const copyChangeOf = (was, now) => {
238
+ const readings = { was: copyReadingOf(was), now: copyReadingOf(now) };
239
+ const words = {
240
+ was: readings.was.words,
241
+ now: readings.now.words,
242
+ change: readings.now.words - readings.was.words,
243
+ };
244
+ const head = {
245
+ treeId: was.treeId,
246
+ revisions: { was: was.revision, now: now.revision },
247
+ audiences: comparedAudiencesOf(was, now),
248
+ readings,
249
+ words,
250
+ };
251
+ /** The two states in which neither half of the comparison stands. */
252
+ const refusing = (silence) => ({
253
+ ...head,
254
+ wrote: NO_WORDS_WRITTEN,
255
+ compared: [],
256
+ reworded: [],
257
+ added: [],
258
+ removed: [],
259
+ wordsByMovement: ZERO_BY_MOVEMENT,
260
+ passagesByMovement: ZERO_BY_MOVEMENT,
261
+ floored: 0,
262
+ stillUnseen: [],
263
+ typical: null,
264
+ mostGained: null,
265
+ mostLost: null,
266
+ silence,
267
+ });
268
+ if (was.treeId !== now.treeId)
269
+ return refusing("different-trees");
270
+ if (crossesAudiences(was, now))
271
+ return refusing("different-audiences");
272
+ const earlier = passagesOf(was);
273
+ const later = passagesOf(now);
274
+ const compared = [];
275
+ const reworded = [];
276
+ const added = [];
277
+ const removed = [];
278
+ for (const [nodeId, passage] of later) {
279
+ const before = earlier.get(nodeId);
280
+ if (before === undefined) {
281
+ if (saysSomething([passage]))
282
+ added.push(passage);
283
+ continue;
284
+ }
285
+ if (!saysSomething([before, passage]))
286
+ continue;
287
+ const shared = {
288
+ nodeId,
289
+ type: passage.type,
290
+ role: passage.role,
291
+ floored: before.floored || passage.floored,
292
+ was: passageSideOf(before, was.views),
293
+ now: passageSideOf(passage, now.views),
294
+ movement: movementOf(before.standing, passage.standing),
295
+ };
296
+ if (sameText(before.text, passage.text)) {
297
+ compared.push({
298
+ ...shared,
299
+ words: passage.words,
300
+ text: passage.text,
301
+ gain: gainOf(passage.words, shared.movement, shared.was, shared.now),
302
+ });
303
+ continue;
304
+ }
305
+ reworded.push({ ...shared, words: { was: before.words, now: passage.words } });
306
+ }
307
+ for (const [nodeId, passage] of earlier) {
308
+ if (later.has(nodeId))
309
+ continue;
310
+ if (saysSomething([passage]))
311
+ removed.push(passage);
312
+ }
313
+ const carried = compared.reduce((total, passage) => total + passage.words, 0);
314
+ /**
315
+ * The carried passages both windows can speak for, which every signed figure
316
+ * below is taken over.
317
+ *
318
+ * One set and therefore the same set on both sides, which is the property
319
+ * that makes the two levels comparable at all: a passage dropped from the
320
+ * later mass and kept in the earlier one would read as a loss of words
321
+ * nobody wrote.
322
+ */
323
+ const spoken = compared.filter(spokenForOnBothSides);
324
+ const carriedSpoken = spoken.reduce((total, passage) => total + passage.words, 0);
325
+ const wrote = {
326
+ carried,
327
+ added: wordsAdded(added),
328
+ addedByStanding: wordsByStandingOf(added),
329
+ removed: wordsAdded(removed),
330
+ removedByStanding: wordsByStandingOf(removed),
331
+ reworded: {
332
+ was: reworded.reduce((total, passage) => total + passage.words.was, 0),
333
+ now: reworded.reduce((total, passage) => total + passage.words.now, 0),
334
+ },
335
+ };
336
+ const wordsByMovement = compared.reduce((counted, passage) => ({
337
+ ...counted,
338
+ [passage.movement]: counted[passage.movement] + passage.words,
339
+ }), { ...ZERO_BY_MOVEMENT });
340
+ const passagesByMovement = compared.reduce((counted, passage) => ({
341
+ ...counted,
342
+ [passage.movement]: counted[passage.movement] + 1,
343
+ }), { ...ZERO_BY_MOVEMENT });
344
+ const floored = compared.filter((passage) => passage.floored).length;
345
+ const silence = silenceOf(words, readings, { was: was.views, now: now.views }, unsplit(was, now), carried, carriedSpoken, floored);
346
+ /**
347
+ * Over the carried passages both windows can speak for, so neither the page
348
+ * having grown or shrunk nor a part that stopped reporting is in it (0282).
349
+ * Guarded by the silence rather than clamped, for the reason a copy reading
350
+ * guards its own mean (0235): a figure held back with a stated cause is one
351
+ * somebody can act on.
352
+ */
353
+ const typicalOf = () => {
354
+ const wasWords = spoken.reduce((total, passage) => total + passage.was.readers * passage.words, 0) / was.views;
355
+ const nowWords = spoken.reduce((total, passage) => total + passage.now.readers * passage.words, 0) / now.views;
356
+ return { was: wasWords, now: nowWords, change: nowWords - wasWords };
357
+ };
358
+ return {
359
+ ...head,
360
+ wrote,
361
+ compared,
362
+ reworded,
363
+ added,
364
+ removed,
365
+ wordsByMovement,
366
+ passagesByMovement,
367
+ floored,
368
+ stillUnseen: compared
369
+ .filter((passage) => passage.movement === "unread")
370
+ .sort(byWordsUnread),
371
+ typical: silence === null ? typicalOf() : null,
372
+ mostGained: compared.reduce((standing, passage) => (passage.gain ?? 0) > 0 ? moreGainedOf(standing, passage) : standing, null),
373
+ mostLost: compared.reduce((standing, passage) => ((passage.gain ?? 0) < 0 ? moreLostOf(standing, passage) : standing), null),
374
+ silence,
375
+ };
376
+ };
377
+ //# sourceMappingURL=copy-change.js.map