@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,336 @@
1
+ import { everyMemberOf } from "../closed-set.js";
2
+ import { PRIMITIVE_ROLES } from "../role.js";
3
+ import { pageActionOf, } from "./action.js";
4
+ import { readingKeyOf } from "./audiences.js";
5
+ import { atDoorScale, doorOf } from "./door.js";
6
+ import { kindKeyOf } from "./library.js";
7
+ import { pageViewsFor, } from "./page-views.js";
8
+ export const KIND_ACTION_SILENCES = everyMemberOf()([
9
+ "unread",
10
+ "unplaced",
11
+ "unscaled",
12
+ "unopened",
13
+ "uncounted",
14
+ "unenterable",
15
+ "unwalked",
16
+ ]);
17
+ /** One line per silence, for a surface saying why a kind has no share of its readers' actions. */
18
+ export const describeKindActionSilence = (silence) => {
19
+ switch (silence) {
20
+ case "unread":
21
+ return "nothing reported a reader reaching any place this kind of part stands that has an inside";
22
+ case "unplaced":
23
+ return "nothing in the pages read is of this kind";
24
+ case "unenterable":
25
+ return "no place this kind of part stands has anything inside it, so there is nothing a reader could act in";
26
+ case "unwalked":
27
+ return "a page behind the figure holds actions and credits none of them to a reader";
28
+ case "unscaled":
29
+ return "two or more pages are behind the figure and one of them has no page views counted at the door, so they cannot be weighed against each other";
30
+ case "unopened":
31
+ return "a page behind the figure has a row and nothing has said a page view began";
32
+ case "uncounted":
33
+ return "a page behind the figure has readers and no window of their reading has been counted yet";
34
+ }
35
+ };
36
+ /** The kind-level reason a page's reason causes, which is the same state at the other subject. */
37
+ const KIND_ACTION_OF_REACH = Object.freeze({
38
+ unmeasured: "unscaled",
39
+ unopened: "unopened",
40
+ uncounted: "uncounted",
41
+ });
42
+ const NO_STANDINGS = Object.freeze({
43
+ acted: 0,
44
+ untouched: 0,
45
+ unknown: 0,
46
+ });
47
+ const tallying = (kind) => ({
48
+ kind,
49
+ role: null,
50
+ placements: 0,
51
+ insides: 0,
52
+ leaves: 0,
53
+ verdicts: 0,
54
+ unknown: 0,
55
+ unmet: 0,
56
+ roots: 0,
57
+ unreconciled: 0,
58
+ standings: { ...NO_STANDINGS },
59
+ terms: new Map(),
60
+ });
61
+ /**
62
+ * One placement's contribution, which is nothing at all unless it has an inside
63
+ * and a window could speak for it.
64
+ *
65
+ * The order is the order the claims have to be ruled out in: a leaf is excluded
66
+ * before any row is read, because its nought is a filing rule whatever the
67
+ * window said, and an absent row is excluded before a reach of nought, because
68
+ * *nothing was reported* and *nobody got there* are the two states 0242 exists
69
+ * to keep apart.
70
+ */
71
+ const add = (into, part, page) => {
72
+ into.placements += 1;
73
+ into.standings[part.standing] += 1;
74
+ if (part.depth === 0)
75
+ into.roots += 1;
76
+ if (!part.bearsParts) {
77
+ into.leaves += 1;
78
+ return;
79
+ }
80
+ into.insides += 1;
81
+ const { reached, within } = part;
82
+ if (reached === undefined || within === undefined) {
83
+ into.unknown += 1;
84
+ return;
85
+ }
86
+ into.verdicts += 1;
87
+ const standing = into.terms.get(page.revision);
88
+ const terms = standing ?? {
89
+ reached: 0,
90
+ within: 0,
91
+ door: page.door,
92
+ unwalked: page.unwalked,
93
+ };
94
+ if (standing === undefined)
95
+ into.terms.set(page.revision, terms);
96
+ if (within > reached)
97
+ into.unreconciled += 1;
98
+ if (reached === 0) {
99
+ into.unmet += 1;
100
+ return;
101
+ }
102
+ terms.reached += reached;
103
+ terms.within += within;
104
+ };
105
+ /**
106
+ * The figures, or the reason there are none, with the reasons tried in the order
107
+ * they have to be tried in.
108
+ *
109
+ * Nothing of the kind first, because *there is no such part in this library* is
110
+ * a better answer than every reason below it and they are all true of it by
111
+ * accident. Then the structural reason, because a kind with no inside anywhere
112
+ * is answered by the census and not by waiting for readers. Then the window:
113
+ * no row, then no reader, because a kind nobody reached has no denominator
114
+ * whether or not its pages could be scaled. Then the sender, before the door,
115
+ * because a page crediting nobody is the sharper diagnosis and the one that
116
+ * does not resolve itself. The door last, and only where two pages have to be
117
+ * weighed against each other.
118
+ */
119
+ const figuresOf = (of, weighing) => {
120
+ const none = {
121
+ met: null,
122
+ acted: null,
123
+ ignored: null,
124
+ share: null,
125
+ onDoorScale: false,
126
+ drift: 0,
127
+ pending: 0,
128
+ };
129
+ if (of.placements === 0)
130
+ return { ...none, silence: "unplaced" };
131
+ if (of.insides === 0)
132
+ return { ...none, silence: "unenterable" };
133
+ if (of.verdicts === 0)
134
+ return { ...none, silence: "unread" };
135
+ const first = weighing[0];
136
+ if (first === undefined)
137
+ return { ...none, silence: "unread" };
138
+ const drift = weighing.reduce((sum, terms) => sum + terms.door.drift, 0);
139
+ const pending = weighing.reduce((sum, terms) => sum + terms.door.pending, 0);
140
+ if (weighing.some((terms) => terms.unwalked)) {
141
+ return { ...none, drift, pending, silence: "unwalked" };
142
+ }
143
+ /** The first page the door could not scale, as that page's own reason. */
144
+ const blocked = weighing.reduce((found, terms) => found ?? terms.door.silence, null);
145
+ /**
146
+ * One page's own figure, with no scale in it at all.
147
+ *
148
+ * Reported with `onDoorScale: false` rather than with the door's numbers,
149
+ * because this page has none: its share is sound and its counts are on the
150
+ * counters' own scale, which is not a scale any other row's counts could be
151
+ * added to.
152
+ */
153
+ if (blocked !== null && weighing.length === 1) {
154
+ return {
155
+ met: null,
156
+ acted: null,
157
+ ignored: null,
158
+ share: first.within / first.reached,
159
+ onDoorScale: false,
160
+ drift,
161
+ pending,
162
+ silence: null,
163
+ };
164
+ }
165
+ if (blocked !== null) {
166
+ return { ...none, drift, pending, silence: KIND_ACTION_OF_REACH[blocked] };
167
+ }
168
+ const met = weighing.reduce((sum, terms) => sum + atDoorScale(terms.reached, terms.door), 0);
169
+ const acted = weighing.reduce((sum, terms) => sum + atDoorScale(terms.within, terms.door), 0);
170
+ return {
171
+ met,
172
+ acted,
173
+ ignored: met - acted,
174
+ share: acted / met,
175
+ onDoorScale: true,
176
+ drift,
177
+ pending,
178
+ silence: null,
179
+ };
180
+ };
181
+ const rowOf = (of) => {
182
+ const weighing = [...of.terms.values()].filter((terms) => terms.reached > 0);
183
+ const figures = figuresOf(of, weighing);
184
+ return {
185
+ kind: of.kind,
186
+ role: of.kind.by === "type" ? of.role : null,
187
+ placements: of.placements,
188
+ insides: of.insides,
189
+ leaves: of.leaves,
190
+ verdicts: of.verdicts,
191
+ unknown: of.unknown,
192
+ unmet: of.unmet,
193
+ roots: of.roots,
194
+ standings: of.standings,
195
+ pages: of.terms.size,
196
+ weighed: weighing.length,
197
+ ...figures,
198
+ settled: figures.silence === null &&
199
+ figures.pending === 0 &&
200
+ of.unreconciled === 0,
201
+ unreconciled: of.unreconciled,
202
+ };
203
+ };
204
+ /** The name a row is ordered by, which is the key's own and never the row's position. */
205
+ const nameOf = (kind) => kind.by === "type" ? kind.type : (kind.role ?? "");
206
+ /**
207
+ * The worse of two, which is the ranking rule spelled once.
208
+ *
209
+ * Most readers ignored, then the lower share, then by name — so a kind with no
210
+ * share at all sorts after one with a share of nought rather than above it, and
211
+ * a scale-free row sorts on its share rather than on a count it does not have.
212
+ */
213
+ const worseOf = (one, other) => (other.ignored ?? -1) - (one.ignored ?? -1) ||
214
+ (one.share ?? 2) - (other.share ?? 2) ||
215
+ nameOf(one.kind).localeCompare(nameOf(other.kind));
216
+ /** Tree id, then newest revision first, which is the order the page-view rows are read in. */
217
+ const byPage = (one, other) => one.treeId.localeCompare(other.treeId) || other.revision - one.revision;
218
+ /**
219
+ * What a deployment's library gets its readers to do, by kind of part.
220
+ *
221
+ * Takes the readings and the whole window of page-view rows a deployment holds —
222
+ * each page's own row is picked out of them by the published matching rule
223
+ * (`pageViewsFor`) rather than by a fourth hand-written copy of it, because the
224
+ * pairing is the part of every join here that fails quietly when it is got
225
+ * wrong.
226
+ *
227
+ * Linear in the parts of the readings times the rows, with one pass that fills
228
+ * both groupings.
229
+ */
230
+ export const libraryActionOf = (readings, rows) => {
231
+ const tallies = new Map();
232
+ const seen = new Set();
233
+ const trees = new Set();
234
+ const unscaled = [];
235
+ const unwalked = [];
236
+ const disagreed = new Set();
237
+ const standings = { ...NO_STANDINGS };
238
+ let pages = 0;
239
+ let placements = 0;
240
+ let insides = 0;
241
+ let leaves = 0;
242
+ let arrivals = 0;
243
+ let scaled = 0;
244
+ let duplicated = 0;
245
+ let duplicatedRows = 0;
246
+ /**
247
+ * Every role in the vocabulary gets a row whether or not anything plays it,
248
+ * the way the other two library readings' role rows do: a role nothing plays
249
+ * is a fact about the library worth having, and a surface that had to tell a
250
+ * missing row from an empty one would be reading the vocabulary itself.
251
+ */
252
+ for (const role of [...PRIMITIVE_ROLES, null]) {
253
+ const kind = { by: "role", role };
254
+ tallies.set(kindKeyOf(kind), tallying(kind));
255
+ }
256
+ for (const reading of readings) {
257
+ const revision = readingKeyOf(reading);
258
+ if (seen.has(revision)) {
259
+ duplicated += 1;
260
+ continue;
261
+ }
262
+ seen.add(revision);
263
+ trees.add(reading.treeId);
264
+ pages += 1;
265
+ const found = pageViewsFor(reading, rows);
266
+ const door = doorOf(found.measured);
267
+ const action = pageActionOf(reading);
268
+ duplicatedRows += found.duplicated;
269
+ arrivals += door.opened;
270
+ if (door.silence === null)
271
+ scaled += 1;
272
+ if (action.unwalked)
273
+ unwalked.push({ treeId: reading.treeId, revision: reading.revision });
274
+ /**
275
+ * A page the door cannot scale is listed only where a window could speak for
276
+ * something on it: a page nobody read is not a page whose readers could not
277
+ * be counted, and listing it would put the commonest healthy state on a list
278
+ * that is meant to be empty.
279
+ */
280
+ if (door.silence !== null &&
281
+ reading.standings.unknown < reading.parts.length) {
282
+ unscaled.push({
283
+ treeId: reading.treeId,
284
+ revision: reading.revision,
285
+ silence: door.silence,
286
+ });
287
+ }
288
+ const page = { revision, door, unwalked: action.unwalked };
289
+ for (const part of action.parts) {
290
+ const keys = [
291
+ { by: "type", type: part.type },
292
+ { by: "role", role: part.role },
293
+ ];
294
+ placements += 1;
295
+ standings[part.standing] += 1;
296
+ if (part.bearsParts)
297
+ insides += 1;
298
+ else
299
+ leaves += 1;
300
+ for (const kind of keys) {
301
+ const key = kindKeyOf(kind);
302
+ const tally = tallies.get(key) ?? tallying(kind);
303
+ if (kind.by === "type") {
304
+ if (tally.placements === 0)
305
+ tally.role = part.role;
306
+ else if (tally.role !== part.role)
307
+ disagreed.add(part.type);
308
+ }
309
+ add(tally, part, page);
310
+ tallies.set(key, tally);
311
+ }
312
+ }
313
+ }
314
+ const built = [...tallies.values()].map(rowOf);
315
+ const byType = built.filter((row) => row.kind.by === "type").sort(worseOf);
316
+ return {
317
+ byType,
318
+ byRole: built.filter((row) => row.kind.by === "role").sort(worseOf),
319
+ pages,
320
+ trees: trees.size,
321
+ placements,
322
+ insides,
323
+ leaves,
324
+ arrivals,
325
+ standings,
326
+ mostIgnored: byType.find((row) => (row.ignored ?? 0) > 0 && row.roots < row.placements) ?? null,
327
+ unranked: byType.filter((row) => row.share !== null && row.ignored === null && row.roots < row.placements).length,
328
+ scaled,
329
+ unscaled: [...unscaled].sort(byPage),
330
+ unwalked: [...unwalked].sort(byPage),
331
+ duplicated,
332
+ duplicatedRows,
333
+ roleDisagreed: [...disagreed].sort((one, other) => one.localeCompare(other)),
334
+ };
335
+ };
336
+ //# sourceMappingURL=library-action.js.map