@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,292 @@
1
+ import type { AudienceId } from "../audience/audience.js";
2
+ import type { TreeId } from "../ids.js";
3
+ import { type PageFrontier, type UnreachedPart } from "./frontier.js";
4
+ /**
5
+ * **The places a deployment's readers stopped, by what one fix recovers.**
6
+ *
7
+ * [`frontier.ts`](frontier.ts) reads one page as the places its reading stopped
8
+ * ([0374](../../decisions/0374-a-pages-unread-parts-are-reported-as-the-places-its-reading-stopped-and-each-is-behind-exactly-one.md)):
9
+ * a part no view reported reaching whose containing part was reached, with every
10
+ * unreached part behind exactly one of them. This is that reading at the
11
+ * deployment's scale — **an order over the pages, and an order over the places
12
+ * across all of them** — so *where in this deployment should somebody go and
13
+ * look* is a question about a list rather than about nine screens opened one at
14
+ * a time.
15
+ *
16
+ * ## The count it exists instead of
17
+ *
18
+ * `PageReading.standings`' `skipped` counts a band, the rows inside it, the
19
+ * cells inside those and every heading among them: one band nobody reached,
20
+ * counted once per node underneath it. **Two pages with one unread band each are
21
+ * ordered by how deeply each band happens to nest**, which is a fact about the
22
+ * markup and not about the readers — and the figure looks right the whole way,
23
+ * which is what makes it the worst kind of wrong on a fix-list.
24
+ *
25
+ * So nothing here is ranked on it. The key is {@link PageUnread.costs}: the
26
+ * parts of the page that **one** place accounts for, which is what one fix
27
+ * recovers. A page whose pricing band went unseen is one row costing nineteen
28
+ * parts, and a page with nineteen unread footnotes at the top level is nineteen
29
+ * rows costing one each — and the first is the page to go and look at, which is
30
+ * the order the count of parts gets backwards.
31
+ *
32
+ * Both figures are published, side by side and never added: *this deployment has
33
+ * four hundred and twelve unread parts in nine places* is the sentence, and the
34
+ * second number is the one an operator's afternoon is spent on.
35
+ *
36
+ * ## Ranked by the sharpest place and not by the page's total
37
+ *
38
+ * A page's whole unread count is on its reading already
39
+ * ({@link PageFrontier.unseen}) and is deliberately not the key. The precedent
40
+ * is the order of falls, which ranks a page by its **steepest** fall and not by
41
+ * everything it loses
42
+ * ([0250](../../decisions/0250-a-deployment-is-ordered-by-readers-lost-at-the-doors-scale-and-a-page-the-door-cannot-scale-is-out-of-the-order.md)):
43
+ * a fix-list is a list of things somebody will do one of, so the figure it is
44
+ * ordered by has to be what doing one of them is worth. Ranking on the total
45
+ * would put a page with ten small scattered places above a page with one large
46
+ * one, and send an operator to the page where their afternoon buys least.
47
+ *
48
+ * ## It publishes no reader count, and that is the rule rather than an omission
49
+ *
50
+ * Every figure here is a count of **parts of pages** or of **pages**, and not one
51
+ * of readers. The orders beside this one are in readers — readers lost at a fall
52
+ * (0250), readers lost between two ends of a question (0333), the readers a
53
+ * fault costs (0271) — and a part is none of those things. So nothing here is
54
+ * ranked against them, summed with them, or carried into them: the refusal
55
+ * [0327](../../decisions/0327-the-figures-a-window-holds-about-itself-are-a-second-rung-and-a-region-row-set-is-deduplicated-once.md)
56
+ * makes about adding figures in different units, applied to a fourth unit.
57
+ *
58
+ * **The fix-list's own `first` is unchanged for the same reason.** This order
59
+ * stands beside `DeploymentAgenda.page` the way `DeploymentAgenda.converting`
60
+ * stands beside it, and which of them a screen opens with is the screen's
61
+ * judgement — not a comparison this file is in a position to make.
62
+ *
63
+ * ## The two states that must not read as *every part of this page was read*
64
+ *
65
+ * The reading of a page nobody opened is **empty**, and so is the reading of a
66
+ * page every part of which was reached. Those are opposite sentences with one
67
+ * shape, and a page read as neither of its two forms (0290, 0300) produces the
68
+ * same empty reading a third way. So a page is never in this order on the
69
+ * strength of an absence: {@link UnreadStanding} asks what the emptiness was,
70
+ * and `whole` is the only member that means what it looks like.
71
+ *
72
+ * The sharpest of the four is a reading whose rows name nodes the revision does
73
+ * not contain. That pair reads as *a page every reader stopped at the very top
74
+ * of*, which is the most plausible-looking output this reading has, so it is
75
+ * `mismatched`, it is out of the order, and its figures are withheld rather than
76
+ * drawn (0212's alarm, carried through {@link PageFrontier.orphaned}).
77
+ *
78
+ * ## A part that said nothing with a reader below it is a different sentence
79
+ *
80
+ * {@link DeploymentUnread.notReporting} is a **slice** of the rows and not a
81
+ * list beside them, so nothing here is counted twice (0158). It is separate
82
+ * because the instruction is: a part a reader was demonstrably below and which
83
+ * said nothing about itself is a primitive that does not spread the identity
84
+ * attributes a broadcaster reads — `sdk/conformance.ts`' failure — and so it is
85
+ * a fix in the library rather than a page to rewrite. No fault vocabulary gains
86
+ * a member for it here: a fault nobody has seen in the wild is a name invented
87
+ * ahead of its reader.
88
+ *
89
+ * Pure, linear in the readings handed in, and reaches no store, clock, registry
90
+ * or DOM. Nothing is added to any payload, any table or any browser: a place the
91
+ * reading stopped is derived from the tree the counters already name, which is
92
+ * what [0167](../../decisions/0167-a-delegated-signal-names-the-regions-it-happened-inside.md)
93
+ * refused to put on the wire for exactly these kinds.
94
+ */
95
+ /** Where one page stands in the order of places, or why it is not in it. */
96
+ export type UnreadStanding =
97
+ /** In the order, with at least one place the reading stopped and a sound pair behind it. */
98
+ "ranked"
99
+ /**
100
+ * Every part of the page was reached by somebody.
101
+ *
102
+ * The cheerful answer, and the only member that means what an empty reading
103
+ * looks like. A thin window reaches it honestly as well — a revision four
104
+ * readers saw the whole of has nothing unread — and `views` on the reading is
105
+ * what tells the two apart.
106
+ */
107
+ | "whole"
108
+ /**
109
+ * Nothing reported a view of this revision in the window, so nothing can be
110
+ * said about any part of it.
111
+ *
112
+ * Not `whole`. *Nobody opened this page* and *every part of this page was
113
+ * read* are opposite facts with one shape, and guessing the second is the
114
+ * comforting half of a pair this subsystem has been bitten by before.
115
+ */
116
+ | "unread"
117
+ /**
118
+ * One window holds two forms of the page and the asking named neither, so it
119
+ * is read as neither.
120
+ *
121
+ * Every part is `unknown` and the reading is empty while the counters behind
122
+ * it are full (0290, 0300). The remedy is `byAudience` and two reads, and the
123
+ * census on the reading says which two.
124
+ */
125
+ | "unsplit"
126
+ /**
127
+ * The reading names nodes this revision does not contain, so the tree and the
128
+ * window do not belong together.
129
+ *
130
+ * Out of the order and its figures withheld. This is the reading that looks
131
+ * most plausible when the pair is wrong — revision 7's counters against
132
+ * revision 6's tree leaves most parts reporting nothing, which reads as a page
133
+ * every reader stopped at the top of — so a surface should name it rather than
134
+ * draw it (0212).
135
+ */
136
+ | "mismatched";
137
+ export declare const UNREAD_STANDINGS: readonly UnreadStanding[];
138
+ /** One line per standing, for a surface naming why a page is where it is. */
139
+ export declare const describeUnreadStanding: (standing: UnreadStanding) => string;
140
+ /** One revision of one page, as the order of places has it. */
141
+ export type PageUnread = {
142
+ readonly treeId: TreeId;
143
+ readonly revision: number;
144
+ /**
145
+ * The audience this row is about, or `null` where the reading named none.
146
+ *
147
+ * Two forms of one page stand here as two rows, for the reason they do in
148
+ * every order in this subsystem: both are live, both have readers, and the
149
+ * parts one form's readers never reached are not the parts the other's never
150
+ * reached (0300).
151
+ */
152
+ readonly audienceId: AudienceId | null;
153
+ readonly standing: UnreadStanding;
154
+ /** The page's frontier reading, carried whole and unchanged. */
155
+ readonly reading: PageFrontier;
156
+ /**
157
+ * The place one fix recovers the most of this page at, or `null` where the
158
+ * order did not rank it.
159
+ *
160
+ * The head of {@link largestUnreachedIn} for this page, taken from that call
161
+ * rather than chosen again here — one rule for *which place is worst*, in the
162
+ * module that publishes the places.
163
+ */
164
+ readonly at: UnreachedPart | null;
165
+ /**
166
+ * Parts of the page that one place accounts for, which is the key the order is
167
+ * on.
168
+ *
169
+ * **Withheld on a page the order did not rank, and that is a claim rather than
170
+ * a default.** A `mismatched` page has places and a number for them, and the
171
+ * number is an artefact of the wrong pair; `0` would read as *nothing here
172
+ * went unread*, which is the opposite of what is known. The standing is where
173
+ * *there is no figure* is said.
174
+ */
175
+ readonly costs: number | null;
176
+ /**
177
+ * What share of the page's parts that one place accounts for, or `null` on the
178
+ * same terms as {@link PageUnread.costs}.
179
+ *
180
+ * The tie-break and the sentence a small page needs: forty parts behind one
181
+ * band is most of a fifty-part page and a corner of a four-hundred-part one.
182
+ */
183
+ readonly share: number | null;
184
+ };
185
+ /** One place the reading of a page stopped, with the page it is on. */
186
+ export type DeploymentPlace = {
187
+ readonly treeId: TreeId;
188
+ readonly revision: number;
189
+ readonly audienceId: AudienceId | null;
190
+ /** The place itself, carried whole off its page's reading. */
191
+ readonly at: UnreachedPart;
192
+ /** What share of that page's parts this one place accounts for. */
193
+ readonly share: number;
194
+ };
195
+ /** A deployment's pages, by what one fix to each would recover. */
196
+ export type DeploymentUnread = {
197
+ /**
198
+ * Every page with a place the reading stopped and a sound pair behind it,
199
+ * worst first.
200
+ *
201
+ * Most parts behind one place, then the larger share of the page, then by tree
202
+ * id and newest revision first — so two pages that cost the same do not
203
+ * reorder on a refresh.
204
+ */
205
+ readonly ranked: readonly PageUnread[];
206
+ /** Every other page, by tree id and newest revision first. */
207
+ readonly unranked: readonly PageUnread[];
208
+ /** The head of the order, which is the one place in this deployment to go to first. */
209
+ readonly worst: PageUnread | null;
210
+ /** How many pages stand in each state, over the ranked and the unranked alike. */
211
+ readonly standings: Readonly<Record<UnreadStanding, number>>;
212
+ /**
213
+ * Distinct trees across every page read, which is not the number of pages.
214
+ *
215
+ * Two revisions of one tree are two live versions of one page and both stand,
216
+ * as they do in every order under this (0250, 0271).
217
+ */
218
+ readonly trees: number;
219
+ /**
220
+ * Places the reading stopped, added across the **ranked** pages.
221
+ *
222
+ * The half of the headline that is the number of things to do. A `mismatched`
223
+ * page's places are not in it, because a figure taken off a wrong pair is not
224
+ * a thing to do — the row carries them, so nothing is lost by leaving them out
225
+ * of the sum (0301, 0326).
226
+ */
227
+ readonly places: number;
228
+ /**
229
+ * Parts nobody reached, added across the **ranked** pages.
230
+ *
231
+ * The other half, and the figure a screen would otherwise have printed on its
232
+ * own: *four hundred and twelve unread parts* is true and is nine things to
233
+ * fix. Addable because a part is a node of one revision counted once — a
234
+ * weight over the pages the caller read, and not a deployment total.
235
+ */
236
+ readonly unseen: number;
237
+ /**
238
+ * Pages whose reading names a part that said nothing while a part inside it
239
+ * reported reach — a **slice** of the rows and not a further list.
240
+ *
241
+ * A fix in the library rather than a page to rewrite: a reader was
242
+ * demonstrably below the part, so it was on screen and did not say so, which
243
+ * is a primitive not spreading its identity attributes. In the rows' own
244
+ * order, and every page here is in `ranked` or `unranked` as well and counted
245
+ * once in both this and {@link DeploymentUnread.standings}.
246
+ */
247
+ readonly notReporting: readonly PageUnread[];
248
+ /**
249
+ * Readings of a revision beyond the first, which were dropped.
250
+ *
251
+ * A caller that concatenated two reads holds one page twice, and a page twice
252
+ * in an order is the one way an order lies about how much there is to fix.
253
+ * Dropped rather than added, because a count that has been added cannot be
254
+ * unadded (0158).
255
+ */
256
+ readonly duplicated: number;
257
+ };
258
+ /**
259
+ * Read a deployment's pages as the places their readings stopped.
260
+ *
261
+ * ```ts
262
+ * const assembly = windowAssemblyOf(window, context)
263
+ * const unread = deploymentUnreadOf(assembly.readings.pages.map(pageFrontierOf))
264
+ * ```
265
+ *
266
+ * The frontiers are handed in rather than derived from a window here, for the
267
+ * reason every derived reading in this subsystem takes readings: each is
268
+ * separately useful and separately drawn, and deriving one twice is how two
269
+ * screens come to disagree about one page.
270
+ *
271
+ * @param pages One frontier per page the caller read. Two readings of one page
272
+ * are one page: they are keyed on a tree, a revision **and** an audience
273
+ * (`readingKeyOf`), the first of them stands, and the rest are counted in
274
+ * {@link DeploymentUnread.duplicated} rather than quietly doubling a figure.
275
+ */
276
+ export declare const deploymentUnreadOf: (pages: readonly PageFrontier[]) => DeploymentUnread;
277
+ /**
278
+ * Every place the reading stopped across the deployment, worst first.
279
+ *
280
+ * The question the per-page reading could not be asked: *where in this
281
+ * deployment is the one place worth going to*, over nine pages rather than one.
282
+ * By what each place accounts for, then by the share of its own page, then by
283
+ * the page order and the page's own reading order — so a refresh does not
284
+ * reshuffle two places of one size.
285
+ *
286
+ * **Only the ranked pages.** A `mismatched` page's places are artefacts of a
287
+ * wrong tree-and-window pair, and this is the list whose rows are furthest from
288
+ * the standing that says so, so they are left out rather than drawn with a flag
289
+ * nobody reads. They are on the row, in `unranked`, where the order put them.
290
+ */
291
+ export declare const worstPlacesIn: (unread: DeploymentUnread, limit?: number) => readonly DeploymentPlace[];
292
+ //# sourceMappingURL=unread.d.ts.map
@@ -0,0 +1,137 @@
1
+ import { everyMemberOf } from "../closed-set.js";
2
+ import { audienceScopeRead, readingKeyOf } from "./audiences.js";
3
+ import { largestUnreachedIn, } from "./frontier.js";
4
+ export const UNREAD_STANDINGS = everyMemberOf()([
5
+ "ranked",
6
+ "whole",
7
+ "unread",
8
+ "unsplit",
9
+ "mismatched",
10
+ ]);
11
+ /** One line per standing, for a surface naming why a page is where it is. */
12
+ export const describeUnreadStanding = (standing) => {
13
+ switch (standing) {
14
+ case "ranked":
15
+ return "in the order, by the parts of the page its largest unread place accounts for";
16
+ case "whole":
17
+ return "every part of this page was reached by somebody";
18
+ case "unread":
19
+ return "nothing reported a view of this version in the window";
20
+ case "unsplit":
21
+ return "one window holds two forms of the page and says which readers neither";
22
+ case "mismatched":
23
+ return "its counters name nodes this version does not contain, so nothing here is evidence";
24
+ }
25
+ };
26
+ const EMPTY_STANDINGS = Object.freeze(Object.fromEntries(UNREAD_STANDINGS.map((standing) => [standing, 0])));
27
+ /** Tree id, then newest revision first, then form — the order every reading here publishes. */
28
+ const byPage = (one, other) => one.treeId.localeCompare(other.treeId) ||
29
+ other.revision - one.revision ||
30
+ (one.audienceId ?? "").localeCompare(other.audienceId ?? "");
31
+ /**
32
+ * What one reading's emptiness was, asked in the order the wrong answers are
33
+ * comforting in.
34
+ *
35
+ * `mismatched` first, because a wrong pair produces places and figures and they
36
+ * are the most plausible-looking output this reading has. Then `unsplit` before
37
+ * `unread`, because a window read as neither of two forms has a view floor of
38
+ * nought while its counters are full, so *nobody opened this page* is the
39
+ * comforting half of that pair too. Only then is an empty frontier allowed to
40
+ * mean what it looks like.
41
+ */
42
+ const standingOf = (reading) => {
43
+ if (reading.orphaned > 0)
44
+ return "mismatched";
45
+ if (audienceScopeRead(reading).reading === "mixed")
46
+ return "unsplit";
47
+ if (reading.views === 0)
48
+ return "unread";
49
+ return reading.frontier.length > 0 ? "ranked" : "whole";
50
+ };
51
+ const rowOf = (reading) => {
52
+ const standing = standingOf(reading);
53
+ const at = standing === "ranked" ? (largestUnreachedIn(reading, 1)[0] ?? null) : null;
54
+ return {
55
+ treeId: reading.treeId,
56
+ revision: reading.revision,
57
+ audienceId: reading.audienceId,
58
+ standing,
59
+ reading,
60
+ at,
61
+ costs: at?.unseen ?? null,
62
+ share: at === null || reading.parts === 0 ? null : at.unseen / reading.parts,
63
+ };
64
+ };
65
+ /** Most parts behind one place, then the larger share, then the page order. */
66
+ const byCost = (one, other) => (other.costs ?? 0) - (one.costs ?? 0) ||
67
+ (other.share ?? 0) - (one.share ?? 0) ||
68
+ byPage(one, other);
69
+ /**
70
+ * Read a deployment's pages as the places their readings stopped.
71
+ *
72
+ * ```ts
73
+ * const assembly = windowAssemblyOf(window, context)
74
+ * const unread = deploymentUnreadOf(assembly.readings.pages.map(pageFrontierOf))
75
+ * ```
76
+ *
77
+ * The frontiers are handed in rather than derived from a window here, for the
78
+ * reason every derived reading in this subsystem takes readings: each is
79
+ * separately useful and separately drawn, and deriving one twice is how two
80
+ * screens come to disagree about one page.
81
+ *
82
+ * @param pages One frontier per page the caller read. Two readings of one page
83
+ * are one page: they are keyed on a tree, a revision **and** an audience
84
+ * (`readingKeyOf`), the first of them stands, and the rest are counted in
85
+ * {@link DeploymentUnread.duplicated} rather than quietly doubling a figure.
86
+ */
87
+ export const deploymentUnreadOf = (pages) => {
88
+ const first = new Map();
89
+ let duplicated = 0;
90
+ for (const reading of pages) {
91
+ const key = readingKeyOf(reading);
92
+ if (first.has(key))
93
+ duplicated += 1;
94
+ else
95
+ first.set(key, rowOf(reading));
96
+ }
97
+ const rows = [...first.values()].sort(byPage);
98
+ const ranked = rows.filter((row) => row.standing === "ranked").sort(byCost);
99
+ const standings = rows.reduce((counted, row) => ({ ...counted, [row.standing]: counted[row.standing] + 1 }), { ...EMPTY_STANDINGS });
100
+ return {
101
+ ranked,
102
+ unranked: rows.filter((row) => row.standing !== "ranked"),
103
+ worst: ranked[0] ?? null,
104
+ standings,
105
+ trees: new Set(rows.map((row) => row.treeId)).size,
106
+ places: ranked.reduce((total, row) => total + row.reading.frontier.length, 0),
107
+ unseen: ranked.reduce((total, row) => total + row.reading.unseen, 0),
108
+ notReporting: rows.filter((row) => row.reading.notReporting.length > 0),
109
+ duplicated,
110
+ };
111
+ };
112
+ /**
113
+ * Every place the reading stopped across the deployment, worst first.
114
+ *
115
+ * The question the per-page reading could not be asked: *where in this
116
+ * deployment is the one place worth going to*, over nine pages rather than one.
117
+ * By what each place accounts for, then by the share of its own page, then by
118
+ * the page order and the page's own reading order — so a refresh does not
119
+ * reshuffle two places of one size.
120
+ *
121
+ * **Only the ranked pages.** A `mismatched` page's places are artefacts of a
122
+ * wrong tree-and-window pair, and this is the list whose rows are furthest from
123
+ * the standing that says so, so they are left out rather than drawn with a flag
124
+ * nobody reads. They are on the row, in `unranked`, where the order put them.
125
+ */
126
+ export const worstPlacesIn = (unread, limit) => {
127
+ const places = unread.ranked.flatMap((row) => largestUnreachedIn(row.reading).map((at) => ({
128
+ treeId: row.treeId,
129
+ revision: row.revision,
130
+ audienceId: row.audienceId,
131
+ at,
132
+ share: row.reading.parts === 0 ? 0 : at.unseen / row.reading.parts,
133
+ })));
134
+ const ordered = places.sort((one, other) => other.at.unseen - one.at.unseen || other.share - one.share);
135
+ return limit === undefined ? ordered : ordered.slice(0, limit);
136
+ };
137
+ //# sourceMappingURL=unread.js.map