@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,232 @@
1
+ import { everyMemberOf } from "../closed-set.js";
2
+ import { PRIMITIVE_ROLES } from "../role.js";
3
+ import { outlineTree } from "../tree/outline.js";
4
+ import { audienceScopeOf, audiencesIn } from "./audiences.js";
5
+ import { ownCopy, rolesByType } from "./join.js";
6
+ export const PART_STANDINGS = everyMemberOf()([
7
+ "read",
8
+ "skipped",
9
+ "unknown",
10
+ ]);
11
+ /**
12
+ * Whether the window can say either way, which is the one question every
13
+ * figure over a page's words is restricted by.
14
+ *
15
+ * `read` and `skipped` are claims about readers; `unknown` is the absence of
16
+ * one (0282). A passage nothing can be said about is in no mass, out of every
17
+ * list a person acts on, and outside the denominator of every share
18
+ * ([0287](../../decisions/0287-a-share-of-a-pages-words-is-a-share-of-the-words-the-window-can-speak-for-and-spoken-for-is-one-predicate.md)).
19
+ *
20
+ * **Published here rather than spelled where it is asked.** Three modules
21
+ * enumerated the standing by hand and a fourth was about to, and the way that
22
+ * breaks is a sixth `PartStanding`: one spelling has to be revisited and the
23
+ * others go on agreeing with the version of the vocabulary they were written
24
+ * against. Two spellings of a projection that agree today are what the counter
25
+ * keys were before they were published once.
26
+ *
27
+ * **It is not `anchors`.** `change.ts` and `progress.ts` ask the same question
28
+ * of a part under a different name, because what 0221 needs is *can this part
29
+ * anchor a stop* and the answer coincides. A predicate shared because two
30
+ * rules agree is the thing this is fixing.
31
+ */
32
+ export const spokenFor = (standing) => standing !== "unknown";
33
+ /** One line per standing, for a surface putting the reading in front of a person. */
34
+ export const describePartStanding = (standing) => {
35
+ switch (standing) {
36
+ case "read":
37
+ return "came into view in at least one page view";
38
+ case "skipped":
39
+ return "was on the page and in nobody's viewport";
40
+ case "unknown":
41
+ return "nothing was reported that could say either way";
42
+ }
43
+ };
44
+ const NO_STANDINGS = Object.freeze({
45
+ read: 0,
46
+ skipped: 0,
47
+ unknown: 0,
48
+ });
49
+ const standingOf = (counters, views) => {
50
+ if (counters !== undefined && counters.reached > 0)
51
+ return "read";
52
+ if (views === 0)
53
+ return "unknown";
54
+ if (counters === undefined)
55
+ return "skipped";
56
+ return "unknown";
57
+ };
58
+ const countedStandings = (parts) => {
59
+ const counts = { ...NO_STANDINGS };
60
+ for (const part of parts)
61
+ counts[part.standing] += 1;
62
+ return counts;
63
+ };
64
+ /**
65
+ * Every row, in one pass over the parts.
66
+ *
67
+ * A pass per row would be a scan of the page per member of the vocabulary, and
68
+ * the vocabulary grows while the page is what it is. One pass keeps this linear
69
+ * in the parts, which is the standard rule 4 holds the ledger to — it was
70
+ * quadratic once, and a 6,000-node page took 314 ms.
71
+ */
72
+ const roleReadingsOf = (parts) => {
73
+ const rows = new Map([...PRIMITIVE_ROLES, null].map((role) => [
74
+ role,
75
+ {
76
+ role,
77
+ parts: 0,
78
+ standings: { ...NO_STANDINGS },
79
+ dwellMs: 0,
80
+ activations: 0,
81
+ opens: 0,
82
+ closes: 0,
83
+ completions: 0,
84
+ },
85
+ ]));
86
+ for (const part of parts) {
87
+ const row = rows.get(part.role);
88
+ /**
89
+ * A role this runtime does not know cannot reach here — `rolesByType` only
90
+ * ever yields members of `PRIMITIVE_ROLES` — so a missing row would be this
91
+ * module disagreeing with itself rather than a host doing something. Skipped
92
+ * rather than thrown: a reading is not worth failing over, and a row that
93
+ * does not exist cannot be drawn.
94
+ */
95
+ if (row === undefined)
96
+ continue;
97
+ rows.set(part.role, {
98
+ ...row,
99
+ parts: row.parts + 1,
100
+ standings: { ...row.standings, [part.standing]: row.standings[part.standing] + 1 },
101
+ dwellMs: row.dwellMs + (part.counters?.dwellMs ?? 0),
102
+ activations: row.activations + (part.counters?.activations ?? 0),
103
+ opens: row.opens + (part.counters?.opens ?? 0),
104
+ closes: row.closes + (part.counters?.closes ?? 0),
105
+ completions: row.completions + (part.counters?.completions ?? 0),
106
+ });
107
+ }
108
+ return [...rows.values()];
109
+ };
110
+ /**
111
+ * Join a window's counters to the tree and registry they were filed against.
112
+ *
113
+ * The tree carries the pair the counters are keyed by, so there is no way to ask
114
+ * this question about a revision without holding the revision — which is the
115
+ * property that makes the answer trustworthy. Rows filed under anything else are
116
+ * dropped and counted.
117
+ *
118
+ * **A reading is of one audience.** A page is one base tree and the deltas an
119
+ * audience earns (0263), so two forms of it are two sets of counters over one
120
+ * tree at one revision, told apart by a column and nothing else (0284). Name
121
+ * the audience and the rest of the window is `otherAudience`; name none and a
122
+ * window holding one audience, or none at all, is read whole. A window holding
123
+ * two with none named is read as neither, because the only other answers are
124
+ * summing two populations and picking one of them by row order.
125
+ */
126
+ export const pageReadingOf = (tree, tallies, declarations, audience) => {
127
+ const byNode = new Map();
128
+ const duplicated = [];
129
+ let foreign = 0;
130
+ let otherAudience = 0;
131
+ const here = tallies.filter((tally) => tally.treeId === tree.treeId && tally.revision === tree.revision);
132
+ const audiences = audiencesIn(here);
133
+ /**
134
+ * One member is the window's own audience and needs no caller to say so; none
135
+ * is a window that never carried the column. Two with nothing asked for is
136
+ * the refusal, and it is spelled as *no audience to read* rather than as a
137
+ * throw, because a reading is not worth failing over and a surface can draw
138
+ * `audiences` — a reading that names why its answer is absent (0240).
139
+ *
140
+ * Taken from `audienceScopeOf` rather than spelled here. The rule is the same
141
+ * one it was, and it is now the published one: two other readings pick a
142
+ * page's rows out of a window and both had to be corrected for treating the
143
+ * two kinds of *no audience* alike (0297, 0299).
144
+ */
145
+ const scope = audienceScopeOf(audiences, audience);
146
+ const reading = scope.audienceId;
147
+ const mixed = scope.reading === "mixed";
148
+ for (const tally of tallies) {
149
+ if (tally.treeId !== tree.treeId || tally.revision !== tree.revision) {
150
+ foreign += 1;
151
+ continue;
152
+ }
153
+ if (mixed || (reading !== null && tally.audienceId !== reading)) {
154
+ otherAudience += 1;
155
+ continue;
156
+ }
157
+ if (byNode.has(tally.nodeId)) {
158
+ duplicated.push(tally.nodeId);
159
+ continue;
160
+ }
161
+ byNode.set(tally.nodeId, tally);
162
+ }
163
+ const views = [...byNode.values()].reduce((most, tally) => Math.max(most, tally.views), 0);
164
+ const roles = rolesByType(declarations);
165
+ /**
166
+ * The stack of elements still open at this point in the pre-order walk, whose
167
+ * top is the part the current node sits inside. Carried down the walk rather
168
+ * than looked up per part: a part's own ancestors are never re-walked, so the
169
+ * pass stays linear in the nodes whatever the shape of the page (rule 4). An
170
+ * entry whose depth is not below the top has closed it, which is the only
171
+ * comparison this needs.
172
+ */
173
+ const open = [];
174
+ const parts = [];
175
+ for (const entry of outlineTree(tree.root)) {
176
+ while (open.length > 0 && (open.at(-1)?.depth ?? 0) >= entry.depth)
177
+ open.pop();
178
+ const { node } = entry;
179
+ /**
180
+ * Elements only, and that is the whole universe rather than a narrowing: a
181
+ * text or slot node carries no identity attributes, so no signal can ever
182
+ * name one. A text node's words are read as its parent's (`ownCopy`), so
183
+ * nothing in the tree goes unaccounted for.
184
+ *
185
+ * A slot is passed over here and never pushed, which is what makes
186
+ * {@link PartReading.withinId} the nearest *addressed* ancestor rather than
187
+ * the tree parent.
188
+ */
189
+ if (node.kind !== "element")
190
+ continue;
191
+ const counters = byNode.get(node.id);
192
+ parts.push({
193
+ nodeId: node.id,
194
+ type: node.type,
195
+ role: roles.get(node.type) ?? null,
196
+ depth: entry.depth,
197
+ parentId: entry.parentId,
198
+ withinId: open.at(-1)?.nodeId ?? null,
199
+ standing: standingOf(counters, views),
200
+ counters,
201
+ copy: ownCopy(node, declarations),
202
+ });
203
+ open.push({ nodeId: node.id, depth: entry.depth });
204
+ }
205
+ const addressed = new Set(parts.map((part) => part.nodeId));
206
+ return {
207
+ treeId: tree.treeId,
208
+ revision: tree.revision,
209
+ audienceId: reading,
210
+ audiences,
211
+ otherAudience,
212
+ views,
213
+ parts,
214
+ roles: roleReadingsOf(parts),
215
+ standings: countedStandings(parts),
216
+ foreign,
217
+ orphaned: [...byNode.keys()].filter((nodeId) => !addressed.has(nodeId)),
218
+ duplicated,
219
+ };
220
+ };
221
+ /**
222
+ * The words readers actually reached, in reading order.
223
+ *
224
+ * The third question step 6 names, and it is a filter rather than a build: a
225
+ * part's words are its own, so concatenating the read ones double-counts
226
+ * nothing. What it cannot include is a word whose part declared no `copy` —
227
+ * those are in each part's `copy.unread`, named, because a reading that returned
228
+ * them would be guessing and one that dropped them silently would be the failure
229
+ * 0122 exists to prevent.
230
+ */
231
+ export const wordsReadIn = (reading) => reading.parts.filter((part) => part.standing === "read").flatMap((part) => [...part.copy.words]);
232
+ //# sourceMappingURL=parts.js.map
@@ -1,7 +1,21 @@
1
+ import { type StoreScope } from "../application/application.js";
1
2
  import type { LoomDatabase } from "../store/database.js";
2
3
  import { type ReaderSignalJournal } from "./journal.js";
4
+ import { type ReaderRegionStore } from "./region.js";
3
5
  import type { ReaderTallyStore } from "./tally.js";
4
6
  export * from "./migrate.js";
5
- export declare const postgresReaderSignalJournal: (db: LoomDatabase) => ReaderSignalJournal;
6
- export declare const postgresReaderTallyStore: (db: LoomDatabase) => ReaderTallyStore;
7
+ /**
8
+ * Every read is filtered by the application this handle speaks for (0269), and
9
+ * every write sets it.
10
+ *
11
+ * A reader is filed against the application whose page they read. Folding two
12
+ * would add two customers' counts together, and the addition is not
13
+ * recoverable from the rows afterwards — which is why this landed before
14
+ * anything could construct a second application rather than after.
15
+ */
16
+ export declare const postgresReaderSignalJournal: (db: LoomDatabase, scope?: StoreScope) => ReaderSignalJournal;
17
+ /** Scoped on the same terms as the journal — see its note. */
18
+ export declare const postgresReaderTallyStore: (db: LoomDatabase, scope?: StoreScope) => ReaderTallyStore;
19
+ /** Scoped on the same terms as the journal — see its note. */
20
+ export declare const postgresReaderRegionStore: (db: LoomDatabase, scope?: StoreScope) => ReaderRegionStore;
7
21
  //# sourceMappingURL=postgres.d.ts.map