@jam-overture/loom 0.1.0 → 0.2.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 (290) 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/cli/templates.js +19 -0
  11. package/dist/data/plan.js +0 -0
  12. package/dist/data/resolution.d.ts +23 -1
  13. package/dist/data/resolve.d.ts +30 -3
  14. package/dist/data/resolve.js +11 -3
  15. package/dist/ids.d.ts +10 -0
  16. package/dist/ids.js +11 -1
  17. package/dist/index.d.ts +1 -0
  18. package/dist/index.js +1 -0
  19. package/dist/patch.d.ts +54 -0
  20. package/dist/patch.js +44 -0
  21. package/dist/project/closing.d.ts +51 -0
  22. package/dist/project/closing.js +53 -0
  23. package/dist/project/memory.d.ts +20 -0
  24. package/dist/project/memory.js +97 -0
  25. package/dist/project/project.d.ts +90 -0
  26. package/dist/project/project.js +91 -0
  27. package/dist/project/store.d.ts +135 -0
  28. package/dist/project/store.js +41 -0
  29. package/dist/registered.d.ts +64 -0
  30. package/dist/registered.js +118 -0
  31. package/dist/render/behaviour-adjust.d.ts +11 -19
  32. package/dist/render/behaviour-adjust.js +75 -21
  33. package/dist/render/behaviour-present.d.ts +8 -0
  34. package/dist/render/behaviour-present.js +57 -6
  35. package/dist/render/behaviour.d.ts +98 -17
  36. package/dist/render/behaviour.js +91 -26
  37. package/dist/render/control-name.d.ts +68 -0
  38. package/dist/render/control-name.js +37 -0
  39. package/dist/render/diagnostics.d.ts +72 -0
  40. package/dist/render/diagnostics.js +7 -0
  41. package/dist/render/index.d.ts +2 -0
  42. package/dist/render/index.js +2 -0
  43. package/dist/render/reads.d.ts +11 -0
  44. package/dist/render/reads.js +12 -1
  45. package/dist/render/render.js +102 -7
  46. package/dist/render/slots.d.ts +52 -0
  47. package/dist/render/slots.js +24 -0
  48. package/dist/render/theme.d.ts +54 -1
  49. package/dist/render/theme.js +23 -1
  50. package/dist/render/unshown.d.ts +152 -0
  51. package/dist/render/unshown.js +80 -0
  52. package/dist/runtime/analysis.d.ts +94 -9
  53. package/dist/runtime/analysis.js +54 -9
  54. package/dist/runtime/assessment.d.ts +36 -2
  55. package/dist/runtime/assessment.js +27 -2
  56. package/dist/runtime/checks.d.ts +148 -0
  57. package/dist/runtime/checks.js +112 -0
  58. package/dist/runtime/disposition.d.ts +96 -0
  59. package/dist/runtime/disposition.js +46 -0
  60. package/dist/runtime/gate.js +22 -0
  61. package/dist/runtime/index.d.ts +3 -0
  62. package/dist/runtime/index.js +3 -0
  63. package/dist/runtime/irreversibility.d.ts +64 -0
  64. package/dist/runtime/irreversibility.js +45 -0
  65. package/dist/runtime/pipeline.d.ts +43 -0
  66. package/dist/runtime/pipeline.js +10 -2
  67. package/dist/runtime/policy-change.d.ts +93 -0
  68. package/dist/runtime/policy-change.js +299 -0
  69. package/dist/runtime/policy-log.d.ts +406 -0
  70. package/dist/runtime/policy-log.js +285 -0
  71. package/dist/runtime/reversibility.d.ts +11 -9
  72. package/dist/runtime/stakes.d.ts +129 -1
  73. package/dist/runtime/stakes.js +240 -26
  74. package/dist/runtime/vocabulary.d.ts +164 -7
  75. package/dist/runtime/vocabulary.js +181 -8
  76. package/dist/sdk/audit.d.ts +174 -3
  77. package/dist/sdk/audit.js +176 -17
  78. package/dist/sdk/catalogue.d.ts +9 -1
  79. package/dist/sdk/conformance.d.ts +37 -3
  80. package/dist/sdk/conformance.js +25 -4
  81. package/dist/sdk/definition.d.ts +65 -0
  82. package/dist/sdk/definition.js +22 -0
  83. package/dist/sdk/registry.d.ts +29 -2
  84. package/dist/sdk/registry.js +63 -1
  85. package/dist/signals/action-change.d.ts +507 -0
  86. package/dist/signals/action-change.js +265 -0
  87. package/dist/signals/action.d.ts +331 -0
  88. package/dist/signals/action.js +182 -0
  89. package/dist/signals/applied-window.contract.d.ts +23 -0
  90. package/dist/signals/applied-window.contract.js +160 -0
  91. package/dist/signals/arriving.d.ts +210 -0
  92. package/dist/signals/arriving.js +133 -0
  93. package/dist/signals/audiences.d.ts +528 -0
  94. package/dist/signals/audiences.js +255 -0
  95. package/dist/signals/broadcast.d.ts +8 -2
  96. package/dist/signals/broadcast.js +58 -8
  97. package/dist/signals/change.d.ts +378 -0
  98. package/dist/signals/change.js +327 -0
  99. package/dist/signals/collect.d.ts +41 -0
  100. package/dist/signals/collect.js +88 -7
  101. package/dist/signals/copy-change.d.ts +553 -0
  102. package/dist/signals/copy-change.js +377 -0
  103. package/dist/signals/copy.d.ts +337 -0
  104. package/dist/signals/copy.js +211 -0
  105. package/dist/signals/counters.d.ts +46 -0
  106. package/dist/signals/counters.js +102 -0
  107. package/dist/signals/deliver.d.ts +23 -4
  108. package/dist/signals/deliver.js +34 -6
  109. package/dist/signals/deployment-change.d.ts +371 -0
  110. package/dist/signals/deployment-change.js +268 -0
  111. package/dist/signals/deployment.d.ts +265 -0
  112. package/dist/signals/deployment.js +152 -0
  113. package/dist/signals/door.d.ts +92 -0
  114. package/dist/signals/door.js +53 -0
  115. package/dist/signals/fold.d.ts +10 -0
  116. package/dist/signals/fold.js +5 -1
  117. package/dist/signals/form-action.d.ts +302 -0
  118. package/dist/signals/form-action.js +169 -0
  119. package/dist/signals/form-copy.d.ts +523 -0
  120. package/dist/signals/form-copy.js +346 -0
  121. package/dist/signals/forms.d.ts +247 -0
  122. package/dist/signals/forms.js +147 -0
  123. package/dist/signals/funnel-change.d.ts +548 -0
  124. package/dist/signals/funnel-change.js +361 -0
  125. package/dist/signals/funnel.d.ts +532 -0
  126. package/dist/signals/funnel.js +216 -0
  127. package/dist/signals/health.d.ts +497 -0
  128. package/dist/signals/health.js +361 -0
  129. package/dist/signals/index.d.ts +41 -0
  130. package/dist/signals/index.js +41 -0
  131. package/dist/signals/ingest.d.ts +56 -1
  132. package/dist/signals/ingest.js +91 -1
  133. package/dist/signals/journal.d.ts +11 -0
  134. package/dist/signals/kinds.d.ts +8 -6
  135. package/dist/signals/kinds.js +14 -6
  136. package/dist/signals/library-action.d.ts +430 -0
  137. package/dist/signals/library-action.js +336 -0
  138. package/dist/signals/library-change.d.ts +477 -0
  139. package/dist/signals/library-change.js +335 -0
  140. package/dist/signals/library-copy-change.d.ts +498 -0
  141. package/dist/signals/library-copy-change.js +476 -0
  142. package/dist/signals/library-pace.d.ts +319 -0
  143. package/dist/signals/library-pace.js +305 -0
  144. package/dist/signals/library-reach-change.d.ts +636 -0
  145. package/dist/signals/library-reach-change.js +534 -0
  146. package/dist/signals/library-reach.d.ts +377 -0
  147. package/dist/signals/library-reach.js +227 -0
  148. package/dist/signals/library-word-reach-change.d.ts +567 -0
  149. package/dist/signals/library-word-reach-change.js +568 -0
  150. package/dist/signals/library.d.ts +306 -0
  151. package/dist/signals/library.js +178 -0
  152. package/dist/signals/memory.d.ts +9 -0
  153. package/dist/signals/memory.js +105 -14
  154. package/dist/signals/migrate.d.ts +17 -2
  155. package/dist/signals/migrate.js +122 -5
  156. package/dist/signals/notice.d.ts +334 -0
  157. package/dist/signals/notice.js +228 -0
  158. package/dist/signals/pace-change.d.ts +501 -0
  159. package/dist/signals/pace-change.js +310 -0
  160. package/dist/signals/pace.d.ts +296 -0
  161. package/dist/signals/pace.js +291 -0
  162. package/dist/signals/page-views.d.ts +365 -0
  163. package/dist/signals/page-views.js +218 -0
  164. package/dist/signals/parts.d.ts +344 -0
  165. package/dist/signals/parts.js +273 -0
  166. package/dist/signals/postgres.d.ts +16 -2
  167. package/dist/signals/postgres.js +390 -87
  168. package/dist/signals/progress.d.ts +212 -0
  169. package/dist/signals/progress.js +150 -0
  170. package/dist/signals/ratios.d.ts +108 -0
  171. package/dist/signals/ratios.js +40 -0
  172. package/dist/signals/reach.d.ts +309 -0
  173. package/dist/signals/reach.js +93 -0
  174. package/dist/signals/readable.d.ts +34 -0
  175. package/dist/signals/readable.js +34 -0
  176. package/dist/signals/readership.d.ts +381 -0
  177. package/dist/signals/readership.js +308 -0
  178. package/dist/signals/region-pages.d.ts +173 -0
  179. package/dist/signals/region-pages.js +62 -0
  180. package/dist/signals/region.d.ts +287 -0
  181. package/dist/signals/region.js +198 -0
  182. package/dist/signals/retention.d.ts +141 -0
  183. package/dist/signals/retention.js +58 -0
  184. package/dist/signals/rollup.d.ts +67 -3
  185. package/dist/signals/rollup.js +0 -0
  186. package/dist/signals/schema.d.ts +432 -1
  187. package/dist/signals/schema.js +157 -3
  188. package/dist/signals/signal.d.ts +237 -11
  189. package/dist/signals/signal.js +70 -10
  190. package/dist/signals/silence-census.d.ts +205 -0
  191. package/dist/signals/silence-census.js +87 -0
  192. package/dist/signals/silences.d.ts +848 -0
  193. package/dist/signals/silences.js +753 -0
  194. package/dist/signals/tally.d.ts +140 -11
  195. package/dist/signals/window-figures.d.ts +148 -0
  196. package/dist/signals/window-figures.js +42 -0
  197. package/dist/signals/window.d.ts +866 -0
  198. package/dist/signals/window.js +693 -0
  199. package/dist/signals/words.d.ts +24 -0
  200. package/dist/signals/words.js +24 -0
  201. package/dist/store/index.d.ts +19 -0
  202. package/dist/store/index.js +19 -0
  203. package/dist/store/memory.d.ts +2 -1
  204. package/dist/store/memory.js +48 -12
  205. package/dist/store/migrate.d.ts +80 -0
  206. package/dist/store/migrate.js +259 -7
  207. package/dist/store/postgres-applications.d.ts +4 -0
  208. package/dist/store/postgres-applications.js +197 -0
  209. package/dist/store/postgres-holds.d.ts +10 -1
  210. package/dist/store/postgres-holds.js +116 -101
  211. package/dist/store/postgres-policy-log.d.ts +14 -0
  212. package/dist/store/postgres-policy-log.js +240 -0
  213. package/dist/store/postgres-projects.d.ts +4 -0
  214. package/dist/store/postgres-projects.js +217 -0
  215. package/dist/store/postgres.d.ts +16 -1
  216. package/dist/store/postgres.js +59 -9
  217. package/dist/store/replay.d.ts +102 -1
  218. package/dist/store/replay.js +190 -19
  219. package/dist/store/reseed.d.ts +238 -0
  220. package/dist/store/reseed.js +308 -0
  221. package/dist/store/schema.d.ts +450 -2
  222. package/dist/store/schema.js +141 -5
  223. package/dist/store/store.d.ts +29 -6
  224. package/dist/submit/resolve.js +2 -1
  225. package/dist/telemetry/calibration.d.ts +25 -0
  226. package/dist/telemetry/calibration.js +27 -1
  227. package/dist/telemetry/event.d.ts +391 -33
  228. package/dist/telemetry/event.js +84 -20
  229. package/dist/telemetry/index.d.ts +1 -0
  230. package/dist/telemetry/index.js +1 -0
  231. package/dist/telemetry/journal.d.ts +72 -3
  232. package/dist/telemetry/journal.js +9 -0
  233. package/dist/telemetry/lookup.d.ts +27 -0
  234. package/dist/telemetry/lookup.js +18 -0
  235. package/dist/telemetry/memory.js +23 -0
  236. package/dist/telemetry/migrate.js +22 -1
  237. package/dist/telemetry/postgres.d.ts +10 -1
  238. package/dist/telemetry/postgres.js +172 -90
  239. package/dist/telemetry/remeasure.d.ts +78 -0
  240. package/dist/telemetry/remeasure.js +83 -0
  241. package/dist/telemetry/retention.d.ts +2 -2
  242. package/dist/telemetry/schema.d.ts +17 -0
  243. package/dist/telemetry/schema.js +27 -1
  244. package/dist/telemetry/sink.d.ts +2 -2
  245. package/dist/testing/application-contract.d.ts +14 -0
  246. package/dist/testing/application-contract.js +270 -0
  247. package/dist/testing/contracts.d.ts +12 -7
  248. package/dist/testing/contracts.js +12 -7
  249. package/dist/testing/definitions.d.ts +78 -0
  250. package/dist/testing/definitions.js +134 -9
  251. package/dist/testing/doubles.d.ts +103 -0
  252. package/dist/testing/doubles.js +143 -0
  253. package/dist/testing/index.d.ts +2 -2
  254. package/dist/testing/index.js +2 -2
  255. package/dist/testing/journal-contract.js +140 -2
  256. package/dist/testing/model-contract.d.ts +110 -0
  257. package/dist/testing/model-contract.js +150 -0
  258. package/dist/testing/policy-log-contract.d.ts +26 -0
  259. package/dist/testing/policy-log-contract.js +344 -0
  260. package/dist/testing/project-contract.d.ts +14 -0
  261. package/dist/testing/project-contract.js +266 -0
  262. package/dist/testing/reader-signal-contract.d.ts +27 -2
  263. package/dist/testing/reader-signal-contract.js +475 -5
  264. package/dist/testing/store-contract.d.ts +7 -1
  265. package/dist/testing/store-contract.js +84 -3
  266. package/dist/theme/apply.d.ts +20 -1
  267. package/dist/theme/apply.js +5 -3
  268. package/dist/theme/derive.d.ts +22 -0
  269. package/dist/theme/derive.js +54 -1
  270. package/dist/theme/library.js +1 -1
  271. package/dist/theme/measure.d.ts +34 -0
  272. package/dist/theme/measure.js +30 -1
  273. package/dist/theme/palettes.js +7 -7
  274. package/dist/theme/ramp.d.ts +64 -0
  275. package/dist/theme/ramp.js +114 -0
  276. package/dist/theme/registry.d.ts +9 -0
  277. package/dist/theme/registry.js +11 -1
  278. package/dist/theme/separation.d.ts +97 -3
  279. package/dist/theme/separation.js +75 -0
  280. package/dist/tree/compare.d.ts +9 -0
  281. package/dist/tree/compare.js +18 -0
  282. package/dist/write/computed.d.ts +60 -0
  283. package/dist/write/computed.js +61 -0
  284. package/dist/write/held.d.ts +59 -0
  285. package/dist/write/index.d.ts +5 -2
  286. package/dist/write/index.js +5 -2
  287. package/dist/write/reseed.d.ts +151 -0
  288. package/dist/write/reseed.js +184 -0
  289. package/dist/write/revert.js +2 -16
  290. package/package.json +98 -19
@@ -0,0 +1,205 @@
1
+ import { type PageForm } from "./audiences.js";
2
+ import type { SilenceCondition, SilenceMeaning, SilenceSubject, SilenceVocabulary } from "./silences.js";
3
+ /**
4
+ * What a window could not answer, and what each reason cost it.
5
+ *
6
+ * [`silences.ts`](silences.ts) settled what a reading means when it says
7
+ * nothing: a hundred and fourteen names across twenty sets, each mapped to the
8
+ * condition it reports and the subject that condition is true of, so that two
9
+ * readings reporting one state report it once
10
+ * ([0240](../../decisions/0240-a-silence-is-a-condition-and-a-subject-and-the-two-names-for-one-state-were-not-synonyms.md)).
11
+ * It publishes `relateSilences`, which holds two reasons against each other,
12
+ * and `distinctSilences`, which collapses the readings of one card to the states
13
+ * they are actually in.
14
+ *
15
+ * **Nothing has ever called either of them.** Twenty sets, one relation and a
16
+ * dedup, and the only file in the repository that imports them is their own
17
+ * test — because the call they are shaped for is *one card*, and the thing an
18
+ * operator holds is a window of forty pages with nine readings over each. The
19
+ * vocabulary is finished and the question over it was unaskable, which is the
20
+ * one condition this lane treats as a counter that is not done.
21
+ *
22
+ * This is that question: hand over the silences as a surface holds them, one per
23
+ * reading, and get back the states the window is in, with **what each one
24
+ * cost**. It is one more thing taken out of what the subsystem already knows
25
+ * rather than collected: no payload, no browser change, no counter that does
26
+ * not exist, no column and no byte on any wire.
27
+ *
28
+ * ## A state is one condition about one subject, and that rule is not restated
29
+ *
30
+ * Two readings are in one state when `relateSilences` says `one-state`, which
31
+ * is the same condition about the same subject. Two that agree on the condition
32
+ * alone stay two, because *the window held no page views* said of a page and
33
+ * said of a comparison are not one sentence and the narrower is not evidence for
34
+ * the wider (0240).
35
+ *
36
+ * So the grouping key is that pair, which is the relation's own definition
37
+ * written as a string rather than a second opinion about it. A rule spelled
38
+ * twice is the thing this subsystem has been bitten by — two hand-written
39
+ * copies of the door's scaling rule, and two upsert keys that agreed until they
40
+ * did not — and the key cannot call `relateSilences` without turning a grouping
41
+ * into a scan per entry. So the two are **held together by a test** instead, as
42
+ * a DDL default and the constant it spells are: no two states of a census may
43
+ * be ones the relation would call `one-state`, over a window built to produce
44
+ * both of the ways that could go wrong.
45
+ *
46
+ * ## What a reason cost is readings and pages, and a page is counted once
47
+ *
48
+ * A state carries two counts and they answer different questions.
49
+ * {@link SilenceStanding.readings} is how many readings it took, which is the
50
+ * figure *how much of this window is dark* is asked of.
51
+ * {@link SilenceStanding.forms} names the pages, **each once however many of
52
+ * their readings report it** — the rule a fault in a deployment's collection
53
+ * already follows, where a page is counted once however many faults it has
54
+ * ([0271](../../decisions/0271-a-fault-in-a-deployments-collection-is-named-by-what-it-costs-and-a-pages-readers-are-counted-once.md)).
55
+ *
56
+ * The two are not each other. One page whose nine readings are all `unmeasured`
57
+ * is nine readings and one page; nine pages with one such reading each is nine
58
+ * and nine; and the remedies differ — the first is one door row and the second
59
+ * is a deployment.
60
+ *
61
+ * The page is a **form** and not a revision
62
+ * ([0263](../../decisions/0263-a-page-is-a-base-tree-and-the-deltas-an-audience-earns.md),
63
+ * [0290](../../decisions/0290-a-reading-is-of-one-audience-and-two-forms-of-a-page-are-two-readings-rather-than-one-handed-in-twice.md)),
64
+ * keyed by the published rule rather than by a tree id: two forms of one page
65
+ * are two readerships and a tree alone is not one page, which every comparison
66
+ * in this subsystem keys on and none of them spells out twice
67
+ * ([0293](../../decisions/0293-a-comparison-pairs-pages-by-form-and-the-pairing-rule-is-published-beside-the-reading-rule.md)).
68
+ *
69
+ * ## The other grouping is the same entries read the other way
70
+ *
71
+ * The states say *which reasons this window has*. A form row says *what this
72
+ * page answered*, which is the question after it and is the same entries
73
+ * transposed — the shape a region map took when it was asked which pages a
74
+ * place's readers read, and free for the same reason: nothing is collected, the
75
+ * rows are grouped the other way.
76
+ *
77
+ * It is the grouping that carries the sentence worth putting at the top of a
78
+ * screen, because it is the one with a denominator. *Nine of this page's nine
79
+ * readings are silent, for one reason* is a page to fix; one silence out of nine
80
+ * is a page that is working.
81
+ *
82
+ * ## What is deliberately not published
83
+ *
84
+ * **No ranking of the states.** They are not comparable in what they cost: a
85
+ * page's `no-view-reported` takes every reading of that page, and a library's
86
+ * `nothing-of-the-kind` takes one row of one census and means *you do not use
87
+ * this kind of part*, which is not a fault at all. The counts are published and
88
+ * the order is the order the readings were handed over, so a surface that means
89
+ * *most readings* or *most pages* sorts by the figure it means. That is the
90
+ * shape this lane settled for a verdict it could not take honestly: publish the
91
+ * figure and let the operator read it.
92
+ *
93
+ * **No total of pages across the states**, for
94
+ * [0158](../../decisions/0158-counting-a-window-of-reader-signals-and-forgetting-it-are-one-operation.md)'s
95
+ * reason one level up: one page is in as many states as it has reasons, so a
96
+ * sum over {@link SilenceStanding.forms} counts it once per reason. What is
97
+ * published instead partitions — every reading handed in is in exactly one
98
+ * state or in none, so {@link SilenceCensus.silent} is the sum of the states'
99
+ * readings, and that identity is published rather than described.
100
+ *
101
+ * **No sentence of its own.** A state is a condition and a subject, both of
102
+ * which `silences.ts` already prints a line for, and the only thing a third
103
+ * sentence would add is the counts — which is pluralisation, and belongs to
104
+ * whoever is drawing the screen in whatever language it is in.
105
+ *
106
+ * Pure, and linear in the readings handed over. It reaches no store, no clock
107
+ * and no DOM, and the arithmetic is addition — nothing here survives into a
108
+ * browser bundle.
109
+ */
110
+ /** One reading's silence, with the page it was a reading of. */
111
+ export type ReadingSilence = {
112
+ /**
113
+ * What the reading reported, as the matching `meaningOf…Silence` gives it, or
114
+ * `null` where it answered.
115
+ *
116
+ * Nullable rather than the whole entry being nullable, which is the one way
117
+ * this differs from `distinctSilences`' argument and the reason the form
118
+ * grouping has a denominator at all: a reading that answered is still a
119
+ * reading of that page, and dropping it before the call would make *nine of
120
+ * nine* and *one of one* the same row.
121
+ */
122
+ readonly meaning: SilenceMeaning | null;
123
+ /**
124
+ * The page in the form this reading was of, or absent where the reading is of
125
+ * no one page.
126
+ *
127
+ * A library census and an order over a deployment's pages are of something
128
+ * larger than a page, and their silences are about a kind and about a page
129
+ * respectively — a reading's subject is not its scope (0240). Those are
130
+ * counted in {@link SilenceCensus.wide} rather than attributed to a form that
131
+ * would be a guess.
132
+ */
133
+ readonly form?: PageForm | null;
134
+ };
135
+ /** One state the window is in, and what it cost. */
136
+ export type SilenceStanding = {
137
+ readonly condition: SilenceCondition;
138
+ readonly subject: SilenceSubject;
139
+ /**
140
+ * The vocabulary of the **first** reading that reported it, kept so that a
141
+ * surface can still print that reading's own sentence.
142
+ *
143
+ * `distinctSilences`' rule, unchanged: the names are right in their own set
144
+ * and collapsing a state does not make one of them wrong.
145
+ */
146
+ readonly vocabulary: SilenceVocabulary;
147
+ /** Every vocabulary that reported it, each once, in the order they arrived. */
148
+ readonly vocabularies: readonly SilenceVocabulary[];
149
+ /** How many readings reported it. */
150
+ readonly readings: number;
151
+ /** The pages it cost, each once however many of their readings reported it. */
152
+ readonly forms: readonly PageForm[];
153
+ /** How many of the readings that reported it were of no one page. */
154
+ readonly wide: number;
155
+ };
156
+ /** What one group of readings answered. */
157
+ export type SilenceGroup = {
158
+ /** Every reading handed over in this group, silent or not. */
159
+ readonly readings: number;
160
+ /** How many of them were silent. */
161
+ readonly silent: number;
162
+ /**
163
+ * The distinct states they are in, in the order they arrived, each keeping the
164
+ * first reading's vocabulary.
165
+ */
166
+ readonly states: readonly SilenceMeaning[];
167
+ };
168
+ /** What one page in one form answered. */
169
+ export type FormSilences = SilenceGroup & {
170
+ readonly form: PageForm;
171
+ };
172
+ /** The states a window is in, and what each of them cost. */
173
+ export type SilenceCensus = {
174
+ /**
175
+ * Every reading handed over, silent or not, which is the denominator the
176
+ * caller chose by choosing what to hand in.
177
+ */
178
+ readonly readings: number;
179
+ /** How many of them were silent. `readings = silent + answered`. */
180
+ readonly silent: number;
181
+ readonly answered: number;
182
+ /**
183
+ * The distinct states, in the order the readings were handed over.
184
+ *
185
+ * Their `readings` sum to {@link silent}, because every silent reading is in
186
+ * exactly one state. Their `forms` do **not** sum to anything.
187
+ */
188
+ readonly states: readonly SilenceStanding[];
189
+ /** The same readings by page, in form order rather than arrival order. */
190
+ readonly byForm: readonly FormSilences[];
191
+ /** The readings of no one page, which no form row holds. */
192
+ readonly wide: SilenceGroup;
193
+ };
194
+ /**
195
+ * The states a window is in, out of the silences its readings published.
196
+ *
197
+ * Takes one entry per reading rather than one per silence, so that a page's
198
+ * readings have a denominator, and groups them twice: by the state, which is a
199
+ * condition and a subject, and by the page.
200
+ *
201
+ * Linear in the entries. A page's forty readings and a deployment's forty pages
202
+ * are sixteen hundred entries, and each one touches two maps.
203
+ */
204
+ export declare const silenceCensusOf: (readings: readonly ReadingSilence[]) => SilenceCensus;
205
+ //# sourceMappingURL=silence-census.d.ts.map
@@ -0,0 +1,87 @@
1
+ import { formKeyOf, inFormOrder } from "./audiences.js";
2
+ /** What one state is, which is `relateSilences`' `one-state` written as a key. */
3
+ const stateKeyOf = (meaning) => `${meaning.condition}\u0000${meaning.subject}`;
4
+ const standing = (meaning) => ({
5
+ condition: meaning.condition,
6
+ subject: meaning.subject,
7
+ vocabulary: meaning.vocabulary,
8
+ vocabularies: [],
9
+ readings: 0,
10
+ forms: new Map(),
11
+ wide: 0,
12
+ });
13
+ const grouping = () => ({ readings: 0, silent: 0, states: new Map() });
14
+ const addTo = (into, meaning) => {
15
+ into.readings += 1;
16
+ if (meaning === null)
17
+ return;
18
+ into.silent += 1;
19
+ const key = stateKeyOf(meaning);
20
+ if (!into.states.has(key))
21
+ into.states.set(key, meaning);
22
+ };
23
+ const groupOf = (of) => ({
24
+ readings: of.readings,
25
+ silent: of.silent,
26
+ states: [...of.states.values()],
27
+ });
28
+ /**
29
+ * The states a window is in, out of the silences its readings published.
30
+ *
31
+ * Takes one entry per reading rather than one per silence, so that a page's
32
+ * readings have a denominator, and groups them twice: by the state, which is a
33
+ * condition and a subject, and by the page.
34
+ *
35
+ * Linear in the entries. A page's forty readings and a deployment's forty pages
36
+ * are sixteen hundred entries, and each one touches two maps.
37
+ */
38
+ export const silenceCensusOf = (readings) => {
39
+ const states = new Map();
40
+ const forms = new Map();
41
+ const wide = grouping();
42
+ for (const reading of readings) {
43
+ const form = reading.form ?? null;
44
+ if (form === null) {
45
+ addTo(wide, reading.meaning);
46
+ }
47
+ else {
48
+ const key = formKeyOf(form);
49
+ const held = forms.get(key) ?? { ...grouping(), form };
50
+ addTo(held, reading.meaning);
51
+ forms.set(key, held);
52
+ }
53
+ if (reading.meaning === null)
54
+ continue;
55
+ const key = stateKeyOf(reading.meaning);
56
+ const held = states.get(key) ?? standing(reading.meaning);
57
+ held.readings += 1;
58
+ if (!held.vocabularies.includes(reading.meaning.vocabulary)) {
59
+ held.vocabularies.push(reading.meaning.vocabulary);
60
+ }
61
+ if (form === null)
62
+ held.wide += 1;
63
+ else
64
+ held.forms.set(formKeyOf(form), form);
65
+ states.set(key, held);
66
+ }
67
+ const silent = [...states.values()].reduce((total, held) => total + held.readings, 0);
68
+ return {
69
+ readings: readings.length,
70
+ silent,
71
+ answered: readings.length - silent,
72
+ states: [...states.values()].map((held) => ({
73
+ condition: held.condition,
74
+ subject: held.subject,
75
+ vocabulary: held.vocabulary,
76
+ vocabularies: [...held.vocabularies],
77
+ readings: held.readings,
78
+ forms: [...held.forms.values()].sort(inFormOrder),
79
+ wide: held.wide,
80
+ })),
81
+ byForm: [...forms.values()]
82
+ .sort((one, other) => inFormOrder(one.form, other.form))
83
+ .map((held) => ({ form: held.form, ...groupOf(held) })),
84
+ wide: groupOf(wide),
85
+ };
86
+ };
87
+ //# sourceMappingURL=silence-census.js.map