@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,336 @@
1
+ import { everyMemberOf } from "../closed-set.js";
2
+ import { PRIMITIVE_ROLES } from "../role.js";
3
+ import { pageActionOf, } from "./action.js";
4
+ import { readingKeyOf } from "./audiences.js";
5
+ import { atDoorScale, doorOf } from "./door.js";
6
+ import { kindKeyOf } from "./library.js";
7
+ import { pageViewsFor, } from "./page-views.js";
8
+ export const KIND_ACTION_SILENCES = everyMemberOf()([
9
+ "unread",
10
+ "unplaced",
11
+ "unscaled",
12
+ "unopened",
13
+ "uncounted",
14
+ "unenterable",
15
+ "unwalked",
16
+ ]);
17
+ /** One line per silence, for a surface saying why a kind has no share of its readers' actions. */
18
+ export const describeKindActionSilence = (silence) => {
19
+ switch (silence) {
20
+ case "unread":
21
+ return "nothing reported a reader reaching any place this kind of part stands that has an inside";
22
+ case "unplaced":
23
+ return "nothing in the pages read is of this kind";
24
+ case "unenterable":
25
+ return "no place this kind of part stands has anything inside it, so there is nothing a reader could act in";
26
+ case "unwalked":
27
+ return "a page behind the figure holds actions and credits none of them to a reader";
28
+ case "unscaled":
29
+ return "two or more pages are behind the figure and one of them has no page views counted at the door, so they cannot be weighed against each other";
30
+ case "unopened":
31
+ return "a page behind the figure has a row and nothing has said a page view began";
32
+ case "uncounted":
33
+ return "a page behind the figure has readers and no window of their reading has been counted yet";
34
+ }
35
+ };
36
+ /** The kind-level reason a page's reason causes, which is the same state at the other subject. */
37
+ const KIND_ACTION_OF_REACH = Object.freeze({
38
+ unmeasured: "unscaled",
39
+ unopened: "unopened",
40
+ uncounted: "uncounted",
41
+ });
42
+ const NO_STANDINGS = Object.freeze({
43
+ acted: 0,
44
+ untouched: 0,
45
+ unknown: 0,
46
+ });
47
+ const tallying = (kind) => ({
48
+ kind,
49
+ role: null,
50
+ placements: 0,
51
+ insides: 0,
52
+ leaves: 0,
53
+ verdicts: 0,
54
+ unknown: 0,
55
+ unmet: 0,
56
+ roots: 0,
57
+ unreconciled: 0,
58
+ standings: { ...NO_STANDINGS },
59
+ terms: new Map(),
60
+ });
61
+ /**
62
+ * One placement's contribution, which is nothing at all unless it has an inside
63
+ * and a window could speak for it.
64
+ *
65
+ * The order is the order the claims have to be ruled out in: a leaf is excluded
66
+ * before any row is read, because its nought is a filing rule whatever the
67
+ * window said, and an absent row is excluded before a reach of nought, because
68
+ * *nothing was reported* and *nobody got there* are the two states 0242 exists
69
+ * to keep apart.
70
+ */
71
+ const add = (into, part, page) => {
72
+ into.placements += 1;
73
+ into.standings[part.standing] += 1;
74
+ if (part.depth === 0)
75
+ into.roots += 1;
76
+ if (!part.bearsParts) {
77
+ into.leaves += 1;
78
+ return;
79
+ }
80
+ into.insides += 1;
81
+ const { reached, within } = part;
82
+ if (reached === undefined || within === undefined) {
83
+ into.unknown += 1;
84
+ return;
85
+ }
86
+ into.verdicts += 1;
87
+ const standing = into.terms.get(page.revision);
88
+ const terms = standing ?? {
89
+ reached: 0,
90
+ within: 0,
91
+ door: page.door,
92
+ unwalked: page.unwalked,
93
+ };
94
+ if (standing === undefined)
95
+ into.terms.set(page.revision, terms);
96
+ if (within > reached)
97
+ into.unreconciled += 1;
98
+ if (reached === 0) {
99
+ into.unmet += 1;
100
+ return;
101
+ }
102
+ terms.reached += reached;
103
+ terms.within += within;
104
+ };
105
+ /**
106
+ * The figures, or the reason there are none, with the reasons tried in the order
107
+ * they have to be tried in.
108
+ *
109
+ * Nothing of the kind first, because *there is no such part in this library* is
110
+ * a better answer than every reason below it and they are all true of it by
111
+ * accident. Then the structural reason, because a kind with no inside anywhere
112
+ * is answered by the census and not by waiting for readers. Then the window:
113
+ * no row, then no reader, because a kind nobody reached has no denominator
114
+ * whether or not its pages could be scaled. Then the sender, before the door,
115
+ * because a page crediting nobody is the sharper diagnosis and the one that
116
+ * does not resolve itself. The door last, and only where two pages have to be
117
+ * weighed against each other.
118
+ */
119
+ const figuresOf = (of, weighing) => {
120
+ const none = {
121
+ met: null,
122
+ acted: null,
123
+ ignored: null,
124
+ share: null,
125
+ onDoorScale: false,
126
+ drift: 0,
127
+ pending: 0,
128
+ };
129
+ if (of.placements === 0)
130
+ return { ...none, silence: "unplaced" };
131
+ if (of.insides === 0)
132
+ return { ...none, silence: "unenterable" };
133
+ if (of.verdicts === 0)
134
+ return { ...none, silence: "unread" };
135
+ const first = weighing[0];
136
+ if (first === undefined)
137
+ return { ...none, silence: "unread" };
138
+ const drift = weighing.reduce((sum, terms) => sum + terms.door.drift, 0);
139
+ const pending = weighing.reduce((sum, terms) => sum + terms.door.pending, 0);
140
+ if (weighing.some((terms) => terms.unwalked)) {
141
+ return { ...none, drift, pending, silence: "unwalked" };
142
+ }
143
+ /** The first page the door could not scale, as that page's own reason. */
144
+ const blocked = weighing.reduce((found, terms) => found ?? terms.door.silence, null);
145
+ /**
146
+ * One page's own figure, with no scale in it at all.
147
+ *
148
+ * Reported with `onDoorScale: false` rather than with the door's numbers,
149
+ * because this page has none: its share is sound and its counts are on the
150
+ * counters' own scale, which is not a scale any other row's counts could be
151
+ * added to.
152
+ */
153
+ if (blocked !== null && weighing.length === 1) {
154
+ return {
155
+ met: null,
156
+ acted: null,
157
+ ignored: null,
158
+ share: first.within / first.reached,
159
+ onDoorScale: false,
160
+ drift,
161
+ pending,
162
+ silence: null,
163
+ };
164
+ }
165
+ if (blocked !== null) {
166
+ return { ...none, drift, pending, silence: KIND_ACTION_OF_REACH[blocked] };
167
+ }
168
+ const met = weighing.reduce((sum, terms) => sum + atDoorScale(terms.reached, terms.door), 0);
169
+ const acted = weighing.reduce((sum, terms) => sum + atDoorScale(terms.within, terms.door), 0);
170
+ return {
171
+ met,
172
+ acted,
173
+ ignored: met - acted,
174
+ share: acted / met,
175
+ onDoorScale: true,
176
+ drift,
177
+ pending,
178
+ silence: null,
179
+ };
180
+ };
181
+ const rowOf = (of) => {
182
+ const weighing = [...of.terms.values()].filter((terms) => terms.reached > 0);
183
+ const figures = figuresOf(of, weighing);
184
+ return {
185
+ kind: of.kind,
186
+ role: of.kind.by === "type" ? of.role : null,
187
+ placements: of.placements,
188
+ insides: of.insides,
189
+ leaves: of.leaves,
190
+ verdicts: of.verdicts,
191
+ unknown: of.unknown,
192
+ unmet: of.unmet,
193
+ roots: of.roots,
194
+ standings: of.standings,
195
+ pages: of.terms.size,
196
+ weighed: weighing.length,
197
+ ...figures,
198
+ settled: figures.silence === null &&
199
+ figures.pending === 0 &&
200
+ of.unreconciled === 0,
201
+ unreconciled: of.unreconciled,
202
+ };
203
+ };
204
+ /** The name a row is ordered by, which is the key's own and never the row's position. */
205
+ const nameOf = (kind) => kind.by === "type" ? kind.type : (kind.role ?? "");
206
+ /**
207
+ * The worse of two, which is the ranking rule spelled once.
208
+ *
209
+ * Most readers ignored, then the lower share, then by name — so a kind with no
210
+ * share at all sorts after one with a share of nought rather than above it, and
211
+ * a scale-free row sorts on its share rather than on a count it does not have.
212
+ */
213
+ const worseOf = (one, other) => (other.ignored ?? -1) - (one.ignored ?? -1) ||
214
+ (one.share ?? 2) - (other.share ?? 2) ||
215
+ nameOf(one.kind).localeCompare(nameOf(other.kind));
216
+ /** Tree id, then newest revision first, which is the order the page-view rows are read in. */
217
+ const byPage = (one, other) => one.treeId.localeCompare(other.treeId) || other.revision - one.revision;
218
+ /**
219
+ * What a deployment's library gets its readers to do, by kind of part.
220
+ *
221
+ * Takes the readings and the whole window of page-view rows a deployment holds —
222
+ * each page's own row is picked out of them by the published matching rule
223
+ * (`pageViewsFor`) rather than by a fourth hand-written copy of it, because the
224
+ * pairing is the part of every join here that fails quietly when it is got
225
+ * wrong.
226
+ *
227
+ * Linear in the parts of the readings times the rows, with one pass that fills
228
+ * both groupings.
229
+ */
230
+ export const libraryActionOf = (readings, rows) => {
231
+ const tallies = new Map();
232
+ const seen = new Set();
233
+ const trees = new Set();
234
+ const unscaled = [];
235
+ const unwalked = [];
236
+ const disagreed = new Set();
237
+ const standings = { ...NO_STANDINGS };
238
+ let pages = 0;
239
+ let placements = 0;
240
+ let insides = 0;
241
+ let leaves = 0;
242
+ let arrivals = 0;
243
+ let scaled = 0;
244
+ let duplicated = 0;
245
+ let duplicatedRows = 0;
246
+ /**
247
+ * Every role in the vocabulary gets a row whether or not anything plays it,
248
+ * the way the other two library readings' role rows do: a role nothing plays
249
+ * is a fact about the library worth having, and a surface that had to tell a
250
+ * missing row from an empty one would be reading the vocabulary itself.
251
+ */
252
+ for (const role of [...PRIMITIVE_ROLES, null]) {
253
+ const kind = { by: "role", role };
254
+ tallies.set(kindKeyOf(kind), tallying(kind));
255
+ }
256
+ for (const reading of readings) {
257
+ const revision = readingKeyOf(reading);
258
+ if (seen.has(revision)) {
259
+ duplicated += 1;
260
+ continue;
261
+ }
262
+ seen.add(revision);
263
+ trees.add(reading.treeId);
264
+ pages += 1;
265
+ const found = pageViewsFor(reading, rows);
266
+ const door = doorOf(found.measured);
267
+ const action = pageActionOf(reading);
268
+ duplicatedRows += found.duplicated;
269
+ arrivals += door.opened;
270
+ if (door.silence === null)
271
+ scaled += 1;
272
+ if (action.unwalked)
273
+ unwalked.push({ treeId: reading.treeId, revision: reading.revision });
274
+ /**
275
+ * A page the door cannot scale is listed only where a window could speak for
276
+ * something on it: a page nobody read is not a page whose readers could not
277
+ * be counted, and listing it would put the commonest healthy state on a list
278
+ * that is meant to be empty.
279
+ */
280
+ if (door.silence !== null &&
281
+ reading.standings.unknown < reading.parts.length) {
282
+ unscaled.push({
283
+ treeId: reading.treeId,
284
+ revision: reading.revision,
285
+ silence: door.silence,
286
+ });
287
+ }
288
+ const page = { revision, door, unwalked: action.unwalked };
289
+ for (const part of action.parts) {
290
+ const keys = [
291
+ { by: "type", type: part.type },
292
+ { by: "role", role: part.role },
293
+ ];
294
+ placements += 1;
295
+ standings[part.standing] += 1;
296
+ if (part.bearsParts)
297
+ insides += 1;
298
+ else
299
+ leaves += 1;
300
+ for (const kind of keys) {
301
+ const key = kindKeyOf(kind);
302
+ const tally = tallies.get(key) ?? tallying(kind);
303
+ if (kind.by === "type") {
304
+ if (tally.placements === 0)
305
+ tally.role = part.role;
306
+ else if (tally.role !== part.role)
307
+ disagreed.add(part.type);
308
+ }
309
+ add(tally, part, page);
310
+ tallies.set(key, tally);
311
+ }
312
+ }
313
+ }
314
+ const built = [...tallies.values()].map(rowOf);
315
+ const byType = built.filter((row) => row.kind.by === "type").sort(worseOf);
316
+ return {
317
+ byType,
318
+ byRole: built.filter((row) => row.kind.by === "role").sort(worseOf),
319
+ pages,
320
+ trees: trees.size,
321
+ placements,
322
+ insides,
323
+ leaves,
324
+ arrivals,
325
+ standings,
326
+ mostIgnored: byType.find((row) => (row.ignored ?? 0) > 0 && row.roots < row.placements) ?? null,
327
+ unranked: byType.filter((row) => row.share !== null && row.ignored === null && row.roots < row.placements).length,
328
+ scaled,
329
+ unscaled: [...unscaled].sort(byPage),
330
+ unwalked: [...unwalked].sort(byPage),
331
+ duplicated,
332
+ duplicatedRows,
333
+ roleDisagreed: [...disagreed].sort((one, other) => one.localeCompare(other)),
334
+ };
335
+ };
336
+ //# sourceMappingURL=library-action.js.map
@@ -0,0 +1,324 @@
1
+ import type { PrimitiveRole } from "../role.js";
2
+ import { type KindKey } from "./library.js";
3
+ import type { KindReachSilence } from "./library-reach.js";
4
+ import type { LibraryAgenda, LibraryAgendaRow, LibraryWork } from "./library-agenda.js";
5
+ /**
6
+ * **Whether a deployment's component fix-list moved, and which of its errands a
7
+ * release can be said to have finished.**
8
+ *
9
+ * [`library-agenda.ts`](library-agenda.ts) joins the order of readers a
10
+ * library's components miss to the order of what their silence costs and
11
+ * publishes one errand per component: rewrite it, repair its sender, both, or
12
+ * nothing
13
+ * ([0413](../../decisions/0413-the-component-to-fix-first-is-withdrawn-from-the-order-of-readers-missed-when-its-own-silence-made-the-figure.md)).
14
+ * It is read of **one** window, and a fix-list read once says what to do. It
15
+ * never says whether doing it worked.
16
+ *
17
+ * Every other reading over a deployment's library has a comparison beside it —
18
+ * reach, senders, silence, words, pace — and the fix-list is the one that does
19
+ * not, which is the reading an operator opens twice. *I repaired the accordion's
20
+ * sender last week; has it left the list?* is not answerable by eye from two
21
+ * agendas, because the thing to compare is a **word** rather than a figure and
22
+ * two of its four members mean different things in two windows.
23
+ *
24
+ * ## The one direction it is dangerous in, and it is a new one
25
+ *
26
+ * `LibraryWork` `none` is two states and says so: *neither reading asks for
27
+ * anything about this component*, and *nothing could be said about it*. One
28
+ * row, two sentences, and the agenda publishes the silences that distinguish
29
+ * them. Held against itself across two windows, that conflation becomes a
30
+ * statement about progress, in the direction that flatters the deployment:
31
+ *
32
+ * > The accordion asked to be rewritten last week. This week the rollup is
33
+ * > behind on the page it stands on, so the order of readers missed can say
34
+ * > nothing about it, so its errand is `none`.
35
+ *
36
+ * Read as a shift, that is **done**. Nothing was done. A fix-list that reports
37
+ * its own blindness as progress is 0330's defect one reading along: the figure
38
+ * is not merely wrong, it is wrong in the direction nobody checks.
39
+ *
40
+ * So the rule, and it is the whole of this file: **a shift is read only where
41
+ * the order of readers missed spoke about the component in both windows.**
42
+ * Everywhere else the shift is `unknown`, and
43
+ * {@link LibraryAgendaChangeRow.silenced} says which window could not say while
44
+ * {@link LibraryAgendaChangeRow.silence} says why, in that reading's own
45
+ * vocabulary.
46
+ *
47
+ * **It withholds the ambiguity exactly, and that is provable rather than
48
+ * hoped for.** An errand is the answer to two questions — *do readers miss it*
49
+ * and *are its senders faulted* — and a reach silence is one of the two
50
+ * unasked. `library` and `both` each require a rank, a rank requires `missed`,
51
+ * and `missed` is `null` under every reason the reach reading has for saying
52
+ * nothing; so a silent side's errand is always `none` or `collection`, the two
53
+ * that are read off an absence. The rule therefore fires on every row whose
54
+ * errand rests on a question nobody asked and on no other row, which is
55
+ * asserted in the test file rather than argued here.
56
+ *
57
+ * The case worth reading twice is the one where the withheld errand is **true**.
58
+ * A component whose only copy is unclaimed has a real sender errand and no rank
59
+ * at all: `collection` is the right word for that window, and the shift is
60
+ * still withheld, because `turned` would say the rewrite errand ended and
61
+ * nothing in either window knows whether it did.
62
+ *
63
+ * ## Why the other half of the agenda needs no silence of its own
64
+ *
65
+ * The errand is decided off three questions — was it ranked, are its senders
66
+ * faulted, and is the rank evidence — and only the first of the three can be
67
+ * withheld. `ranked` is `missed > 0`, and `missed` is `null` under every reason
68
+ * a kind's reach reading has for saying nothing. `faulted` and `spoiled` are
69
+ * read off `silent` and `indeterminate`, which are **counts of placements**: a
70
+ * census of the senders answers them whether or not a door could be scaled or a
71
+ * window folded, and `librarySendersReachOf` publishes them beside a `silence`
72
+ * that is about its share and not about them.
73
+ *
74
+ * A kind nobody stood inside has `silent: 0` and so is not faulted, which is
75
+ * the right answer rather than a withheld one: no sender defect is demonstrable
76
+ * where nothing was there to demonstrate it. That asymmetry is the reason this
77
+ * reading publishes **no silence set of its own**: there is one reading that can
78
+ * be silent about an errand, its vocabulary is already asked of a kind, and a
79
+ * member of this file's own would be a second name for one state. What is
80
+ * published beside it is the one fact that is this reading's — *which of the two
81
+ * windows* — as {@link LibraryAgendaSide}.
82
+ *
83
+ * ## A contested row is carried, and it is not a withholding
84
+ *
85
+ * 0413 withdraws a component from the order of readers missed when its own
86
+ * silent copies made the rank. **There is no rank here to withdraw**: a shift is
87
+ * a word about an errand, and a spoiled component's errand — repair its sender —
88
+ * is the correct errand on the strength of the silence itself. So
89
+ * {@link LibraryAgendaChange.contested} is a **slice** of the rows and never a
90
+ * withholding, and a component repaired between two windows reports `done`
91
+ * exactly as it should.
92
+ *
93
+ * What it is for is the sentence on the card: *this component was contested last
94
+ * week*, which is what tells an operator why its errand changed hands rather
95
+ * than finished.
96
+ *
97
+ * ## It publishes no figure of its own
98
+ *
99
+ * Every number on a row is a source agenda's own, on that agenda's own row
100
+ * (0265, 0327), and both rows are carried whole. Three things a comparison of
101
+ * two orders might have published, and did not:
102
+ *
103
+ * - **No movement in rank.** The two orders are over two windows' populations,
104
+ * so a component can rise five places because four others stopped being
105
+ * placed. A position in two differently-populated orders is not a comparison
106
+ * of anything, and subtracting the two would publish a figure whose commonest
107
+ * cause is a release.
108
+ * - **No corrected loss**, which is the figure the 16 November finding asks
109
+ * about and is still neither agenda's.
110
+ * - **No count of what the deployment collected.** `DeploymentAgenda.subject`
111
+ * is the one word about that (0326), and a second copy of it computed here is
112
+ * how two screens come to disagree about one deployment.
113
+ *
114
+ * ## A component is counted once, however many lists name it
115
+ *
116
+ * The permanent mistake available to a comparison of two joins is a row counted
117
+ * twice (0158). Both inputs publish one row per kind; a duplicate arrives only
118
+ * from a hand-built agenda, and it is deduplicated on `kindKeyOf` with the first
119
+ * appearance kept and counted in {@link LibraryAgendaChange.duplicated}. The
120
+ * published lists walk their source agendas' own orders and take each key at
121
+ * most once, so a component twice in an input is not a component twice in a
122
+ * list.
123
+ *
124
+ * Pure, linear in the two agendas, and reaches no store, clock or DOM.
125
+ */
126
+ /**
127
+ * Which of the two windows could not speak about a component.
128
+ *
129
+ * Published beside the reason rather than folded into it, because the reason is
130
+ * the reach reading's own vocabulary and the **window** is this reading's own
131
+ * fact. A card saying *the rollup is behind on a page it stands on* has to say
132
+ * which week, or it sends a deployment to wait for a window that has already
133
+ * caught up.
134
+ */
135
+ export type LibraryAgendaSide = "earlier" | "later" | "both";
136
+ export declare const LIBRARY_AGENDA_SIDES: readonly LibraryAgendaSide[];
137
+ /** One line per side, for a surface saying which window is missing. */
138
+ export declare const describeLibraryAgendaSide: (side: LibraryAgendaSide) => string;
139
+ /**
140
+ * What became of one component's errand between two windows.
141
+ *
142
+ * The axis is the **errand** and not a figure, which is what makes the set
143
+ * small and the words plain: an operator reads a fix-list to find work, and
144
+ * reads it again to find out whether the work is still there.
145
+ */
146
+ export type LibraryAgendaShift =
147
+ /**
148
+ * It asked for work in the earlier window and asks for none now.
149
+ *
150
+ * The only member that says a release finished something, and the reason the
151
+ * silence above is withheld rather than guessed: `none` is also what a window
152
+ * that cannot speak about a component publishes.
153
+ */
154
+ "done"
155
+ /** It asked for nothing in the earlier window and asks for work now. */
156
+ | "arrived"
157
+ /**
158
+ * It asks for work in both windows and it is different work.
159
+ *
160
+ * *Readers were skipping it; now its sender is broken* and its opposite are
161
+ * both this, and the two rows carry which. An errand that changed hands is
162
+ * not an errand finished, which is the distinction a single *still open*
163
+ * member would lose.
164
+ */
165
+ | "turned"
166
+ /** It asks for the same work in both windows. */
167
+ | "standing"
168
+ /** Neither window asked for anything about it, and both windows could speak. */
169
+ | "clear"
170
+ /**
171
+ * One of the two windows could not speak about it, so there is no before and
172
+ * after to read.
173
+ *
174
+ * {@link LibraryAgendaChangeRow.silence} says which reason, and the two
175
+ * windows' own errands stand on the row either way: withheld here means *this
176
+ * reading will not call it progress*, never *the agendas said nothing*.
177
+ */
178
+ | "unknown";
179
+ export declare const LIBRARY_AGENDA_SHIFTS: readonly LibraryAgendaShift[];
180
+ /** One line per member, for a surface saying what became of a component's errand. */
181
+ export declare const describeLibraryAgendaShift: (shift: LibraryAgendaShift) => string;
182
+ /** One kind of part's errand, held against itself across two windows. */
183
+ export type LibraryAgendaChangeRow = {
184
+ readonly kind: KindKey;
185
+ /**
186
+ * What part the type plays (0114), or `null`.
187
+ *
188
+ * The later window's answer, so a surface reading a row is reading today's
189
+ * library. Always a type key here, never a role.
190
+ */
191
+ readonly role: PrimitiveRole | null;
192
+ readonly shift: LibraryAgendaShift;
193
+ /** The errand the earlier window published, whatever this reading says about progress. */
194
+ readonly was: LibraryWork;
195
+ /** The errand the later window publishes. */
196
+ readonly now: LibraryWork;
197
+ /** True where either window's rank was made by the component's own silent copies (0413). */
198
+ readonly contested: boolean;
199
+ readonly spoiledWas: boolean;
200
+ readonly spoiledNow: boolean;
201
+ /**
202
+ * Why there is no before and after, in **the reach reading's own vocabulary**
203
+ * rather than a second spelling of it.
204
+ *
205
+ * Reused outright, not respelled, the way a funnel answer reuses a page's
206
+ * reach silence: the subject is a kind in both readings and the state of the
207
+ * world is the same one — the order of readers missed had nothing to say
208
+ * about this kind of part. A member of its own here would be a second name
209
+ * for one state, which is the thing this subsystem spends the most care not
210
+ * to publish.
211
+ *
212
+ * **The later window's reason where both windows have one**, because that is
213
+ * the reason a deployment still has a remedy for; {@link silenced} says which
214
+ * window, and the earlier window's own reason stands whole on
215
+ * {@link earlier}.
216
+ */
217
+ readonly silence: KindReachSilence | null;
218
+ /** Which window could not speak, or `null` where both could. */
219
+ readonly silenced: LibraryAgendaSide | null;
220
+ /** The earlier agenda's whole row, so a surface never holds two lists side by side. */
221
+ readonly earlier: LibraryAgendaRow;
222
+ /** The later agenda's whole row. */
223
+ readonly later: LibraryAgendaRow;
224
+ };
225
+ /** Where the one thing to do first stood in each window. */
226
+ export type LibraryAgendaHead = {
227
+ /** The component at the head of the earlier agenda, or `null` where it asked for nothing. */
228
+ readonly earlier: KindKey | null;
229
+ readonly later: KindKey | null;
230
+ /**
231
+ * Whether it is the same component, two `null`s included.
232
+ *
233
+ * Read off each agenda's own `first` rather than recomputed, so a surface
234
+ * saying *the top of your list has not moved in a week* is saying what those
235
+ * two screens said.
236
+ */
237
+ readonly same: boolean;
238
+ };
239
+ /** What two windows of a deployment's component fix-list say about each other. */
240
+ export type LibraryAgendaChange = {
241
+ /** Every component on both agendas, by type, in the later agenda's own row order. */
242
+ readonly rows: readonly LibraryAgendaChangeRow[];
243
+ /**
244
+ * Components that asked for work and ask for none now, in the **earlier**
245
+ * agenda's own orders — readers missed first, then readings lost — each
246
+ * component once.
247
+ *
248
+ * The earlier agenda's order because the later one no longer ranks them: a
249
+ * component with no errand is in neither of its lists.
250
+ */
251
+ readonly done: readonly LibraryAgendaChangeRow[];
252
+ /** Components that ask for work now and asked for none, in the **later** agenda's own orders. */
253
+ readonly arrived: readonly LibraryAgendaChangeRow[];
254
+ /**
255
+ * Components asking for work in both windows, in the later agenda's own
256
+ * orders.
257
+ *
258
+ * The shifts `standing` and `turned` together, because *still on the list* is
259
+ * one question and an errand that changed hands is still on the list. Which
260
+ * of the two a row is, and what it turned from, is on the row.
261
+ */
262
+ readonly outstanding: readonly LibraryAgendaChangeRow[];
263
+ /**
264
+ * Rows whose shift this reading will not call progress, carrying both
265
+ * windows' errands.
266
+ *
267
+ * A **slice** of {@link rows} and never a list beside it, so the counts in
268
+ * {@link shifts} add to the rows there are (0158), and never dropped quietly:
269
+ * a component this reading has nothing to say about is findable with the
270
+ * reason it has nothing to say (0301, 0326).
271
+ */
272
+ readonly withheld: readonly LibraryAgendaChangeRow[];
273
+ /**
274
+ * Rows where either window's rank was its own silence's doing.
275
+ *
276
+ * A slice of {@link rows}, and **not** a withholding: an errand is not a
277
+ * rank, so a contested component's shift is read like any other's. It is the
278
+ * sentence that says why an errand changed hands rather than finished.
279
+ */
280
+ readonly contested: readonly LibraryAgendaChangeRow[];
281
+ /** How many components each shift covers, over {@link rows}. */
282
+ readonly shifts: Readonly<Record<LibraryAgendaShift, number>>;
283
+ /** Where the one thing to do first stood in each window. */
284
+ readonly head: LibraryAgendaHead;
285
+ /**
286
+ * Components one agenda named and the other did not, which is nought for a
287
+ * caller that read two windows of the same deployment.
288
+ *
289
+ * Both agendas are over *the pages their caller read*, so a caller holding
290
+ * agendas of two different sets of pages gets a comparison silently of the
291
+ * intersection.
292
+ */
293
+ readonly unpaired: {
294
+ readonly earlier: number;
295
+ readonly later: number;
296
+ };
297
+ /** Rows for a component beyond the first, on either side, which were dropped (0158). */
298
+ readonly duplicated: number;
299
+ };
300
+ /**
301
+ * Hold a deployment's component fix-list against an earlier reading of it, and
302
+ * publish what became of each errand.
303
+ *
304
+ * ```ts
305
+ * const moved = libraryAgendaChangeOf(
306
+ * libraryAgendaOf(lastWeek.reach, lastWeek.senders),
307
+ * libraryAgendaOf(thisWeek.reach, thisWeek.senders)
308
+ * )
309
+ * ```
310
+ *
311
+ * The two agendas are handed in rather than derived here, on the terms every
312
+ * derived reading in this subsystem takes readings: each is separately useful
313
+ * and separately drawn, and deriving either a second time is how two screens
314
+ * come to disagree about one deployment (0330).
315
+ *
316
+ * @param earlier The agenda of the earlier window, as `libraryAgendaOf`
317
+ * answered it.
318
+ * @param later The agenda of the later window. **Both are required**, on the
319
+ * terms every input of a fix-list is required (0322, 0343): an argument a caller
320
+ * may omit is a comparison that type-checks, runs, and calls a deployment's
321
+ * whole library finished.
322
+ */
323
+ export declare const libraryAgendaChangeOf: (earlier: LibraryAgenda, later: LibraryAgenda) => LibraryAgendaChange;
324
+ //# sourceMappingURL=library-agenda-change.d.ts.map