@jam-overture/loom 0.2.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 (194) hide show
  1. package/dist/audience/compose.d.ts +112 -0
  2. package/dist/audience/compose.js +134 -0
  3. package/dist/audience/memory.d.ts +14 -0
  4. package/dist/audience/memory.js +71 -0
  5. package/dist/audience/overlay-store.d.ts +343 -0
  6. package/dist/audience/overlay-store.js +217 -0
  7. package/dist/audience/rule.d.ts +121 -0
  8. package/dist/audience/rule.js +78 -0
  9. package/dist/cli/index.d.ts +3 -4
  10. package/dist/cli/index.js +3 -4
  11. package/dist/data/adapter.d.ts +9 -1
  12. package/dist/data/adapter.js +2 -0
  13. package/dist/data/resolve.d.ts +1 -1
  14. package/dist/interpretation/anthropic.d.ts +1 -1
  15. package/dist/interpretation/anthropic.js +2 -22
  16. package/dist/interpretation/client.d.ts +1 -1
  17. package/dist/interpretation/materialize.js +67 -22
  18. package/dist/interpretation/openai-compatible.d.ts +36 -0
  19. package/dist/interpretation/openai-compatible.js +79 -0
  20. package/dist/interpretation/status.d.ts +19 -0
  21. package/dist/interpretation/status.js +26 -0
  22. package/dist/live/index.d.ts +73 -0
  23. package/dist/live/index.js +73 -0
  24. package/dist/live/pages.d.ts +187 -0
  25. package/dist/live/pages.js +161 -0
  26. package/dist/live/pull.d.ts +147 -0
  27. package/dist/live/pull.js +398 -0
  28. package/dist/live/pulling.d.ts +79 -0
  29. package/dist/live/pulling.js +117 -0
  30. package/dist/live/window.d.ts +129 -0
  31. package/dist/live/window.js +132 -0
  32. package/dist/render/addressed.d.ts +35 -0
  33. package/dist/render/addressed.js +79 -0
  34. package/dist/render/document-theme.d.ts +70 -0
  35. package/dist/render/document-theme.js +139 -0
  36. package/dist/render/editable.d.ts +15 -1
  37. package/dist/render/editable.js +13 -1
  38. package/dist/render/expected.d.ts +98 -0
  39. package/dist/render/expected.js +88 -0
  40. package/dist/render/index.d.ts +2 -0
  41. package/dist/render/index.js +2 -0
  42. package/dist/render/render.d.ts +11 -0
  43. package/dist/render/render.js +192 -46
  44. package/dist/render/request.d.ts +8 -1
  45. package/dist/render/request.js +1 -0
  46. package/dist/runtime/auto-apply-ceiling.d.ts +54 -0
  47. package/dist/runtime/auto-apply-ceiling.js +66 -0
  48. package/dist/runtime/gate.js +69 -10
  49. package/dist/runtime/index.d.ts +1 -0
  50. package/dist/runtime/index.js +1 -0
  51. package/dist/runtime/nesting.d.ts +13 -1
  52. package/dist/runtime/nesting.js +41 -24
  53. package/dist/runtime/policy-change.js +8 -2
  54. package/dist/runtime/policy-log.d.ts +5 -5
  55. package/dist/runtime/policy.d.ts +8 -6
  56. package/dist/runtime/policy.js +5 -2
  57. package/dist/runtime/repointing.js +0 -0
  58. package/dist/sdk/definition.d.ts +65 -6
  59. package/dist/sdk/definition.js +44 -0
  60. package/dist/sdk/registry.d.ts +17 -1
  61. package/dist/sdk/registry.js +39 -0
  62. package/dist/signals/acted.contract.d.ts +21 -0
  63. package/dist/signals/acted.contract.js +236 -0
  64. package/dist/signals/acted.d.ts +359 -0
  65. package/dist/signals/acted.js +135 -0
  66. package/dist/signals/agenda.d.ts +585 -0
  67. package/dist/signals/agenda.js +295 -0
  68. package/dist/signals/arrivals.contract.d.ts +21 -0
  69. package/dist/signals/arrivals.contract.js +180 -0
  70. package/dist/signals/arrivals.d.ts +375 -0
  71. package/dist/signals/arrivals.js +254 -0
  72. package/dist/signals/broadcast.d.ts +25 -15
  73. package/dist/signals/broadcast.js +209 -36
  74. package/dist/signals/collect.d.ts +137 -43
  75. package/dist/signals/collect.js +103 -36
  76. package/dist/signals/conversion.d.ts +348 -0
  77. package/dist/signals/conversion.js +235 -0
  78. package/dist/signals/correlated.contract.d.ts +24 -0
  79. package/dist/signals/correlated.contract.js +94 -0
  80. package/dist/signals/counters.d.ts +51 -0
  81. package/dist/signals/counters.js +58 -0
  82. package/dist/signals/deployment-change.d.ts +28 -4
  83. package/dist/signals/deployment-change.js +57 -16
  84. package/dist/signals/deployment.d.ts +18 -5
  85. package/dist/signals/deployment.js +37 -11
  86. package/dist/signals/door.d.ts +34 -12
  87. package/dist/signals/door.js +37 -13
  88. package/dist/signals/expire.d.ts +192 -0
  89. package/dist/signals/expire.js +213 -0
  90. package/dist/signals/frontier.d.ts +268 -0
  91. package/dist/signals/frontier.js +145 -0
  92. package/dist/signals/funnel-hours.contract.d.ts +21 -0
  93. package/dist/signals/funnel-hours.contract.js +221 -0
  94. package/dist/signals/funnel-hours.d.ts +293 -0
  95. package/dist/signals/funnel-hours.js +99 -0
  96. package/dist/signals/funnel.d.ts +60 -0
  97. package/dist/signals/funnel.js +35 -20
  98. package/dist/signals/health.d.ts +201 -4
  99. package/dist/signals/health.js +214 -2
  100. package/dist/signals/index.d.ts +19 -0
  101. package/dist/signals/index.js +19 -0
  102. package/dist/signals/inside.d.ts +190 -0
  103. package/dist/signals/inside.js +263 -0
  104. package/dist/signals/join.d.ts +56 -0
  105. package/dist/signals/join.js +60 -0
  106. package/dist/signals/journal.d.ts +112 -9
  107. package/dist/signals/kept.contract.d.ts +22 -0
  108. package/dist/signals/kept.contract.js +111 -0
  109. package/dist/signals/library-agenda-change.d.ts +324 -0
  110. package/dist/signals/library-agenda-change.js +199 -0
  111. package/dist/signals/library-agenda.d.ts +258 -0
  112. package/dist/signals/library-agenda.js +167 -0
  113. package/dist/signals/library-reach-change.d.ts +10 -0
  114. package/dist/signals/library-reach-change.js +11 -3
  115. package/dist/signals/library-senders-change.d.ts +457 -0
  116. package/dist/signals/library-senders-change.js +367 -0
  117. package/dist/signals/library-senders-reach-change.d.ts +486 -0
  118. package/dist/signals/library-senders-reach-change.js +538 -0
  119. package/dist/signals/library-senders-reach.d.ts +340 -0
  120. package/dist/signals/library-senders-reach.js +252 -0
  121. package/dist/signals/library-senders.d.ts +271 -0
  122. package/dist/signals/library-senders.js +180 -0
  123. package/dist/signals/library-word-reach-change.js +2 -6
  124. package/dist/signals/memory.js +142 -1
  125. package/dist/signals/migrate.d.ts +6 -5
  126. package/dist/signals/migrate.js +150 -6
  127. package/dist/signals/notice.d.ts +88 -33
  128. package/dist/signals/notice.js +38 -16
  129. package/dist/signals/part-pace.d.ts +378 -0
  130. package/dist/signals/part-pace.js +333 -0
  131. package/dist/signals/parts.d.ts +25 -15
  132. package/dist/signals/parts.js +32 -73
  133. package/dist/signals/postgres.js +400 -26
  134. package/dist/signals/region.d.ts +1 -1
  135. package/dist/signals/retention.d.ts +43 -21
  136. package/dist/signals/retention.js +25 -8
  137. package/dist/signals/rhythm.d.ts +302 -0
  138. package/dist/signals/rhythm.js +262 -0
  139. package/dist/signals/rollup.d.ts +127 -1
  140. package/dist/signals/rollup.js +211 -24
  141. package/dist/signals/schema.d.ts +640 -3
  142. package/dist/signals/schema.js +239 -3
  143. package/dist/signals/silences.d.ts +310 -11
  144. package/dist/signals/silences.js +243 -0
  145. package/dist/signals/subtrees.d.ts +123 -0
  146. package/dist/signals/subtrees.js +102 -0
  147. package/dist/signals/tally.d.ts +125 -4
  148. package/dist/signals/unread.d.ts +292 -0
  149. package/dist/signals/unread.js +137 -0
  150. package/dist/signals/window-agenda.d.ts +276 -0
  151. package/dist/signals/window-agenda.js +83 -0
  152. package/dist/signals/window-funnels.d.ts +88 -0
  153. package/dist/signals/window-funnels.js +47 -0
  154. package/dist/store/cache.d.ts +101 -0
  155. package/dist/store/cache.js +149 -0
  156. package/dist/store/history.d.ts +82 -0
  157. package/dist/store/history.js +36 -0
  158. package/dist/store/index.d.ts +11 -0
  159. package/dist/store/index.js +11 -0
  160. package/dist/store/migrate.d.ts +26 -0
  161. package/dist/store/migrate.js +64 -0
  162. package/dist/store/postgres-audience.d.ts +14 -0
  163. package/dist/store/postgres-audience.js +272 -0
  164. package/dist/store/postgres.d.ts +1 -0
  165. package/dist/store/postgres.js +1 -0
  166. package/dist/store/schema.d.ts +312 -0
  167. package/dist/store/schema.js +77 -0
  168. package/dist/store/source.d.ts +57 -1
  169. package/dist/store/source.js +65 -1
  170. package/dist/submit/resolve.d.ts +1 -1
  171. package/dist/telemetry/index.d.ts +1 -0
  172. package/dist/telemetry/index.js +1 -0
  173. package/dist/telemetry/journal.d.ts +32 -0
  174. package/dist/telemetry/memory.js +10 -1
  175. package/dist/telemetry/postgres.js +18 -2
  176. package/dist/telemetry/window.d.ts +135 -0
  177. package/dist/telemetry/window.js +101 -0
  178. package/dist/testing/audience-overlay-contract.d.ts +31 -0
  179. package/dist/testing/audience-overlay-contract.js +354 -0
  180. package/dist/testing/contracts.d.ts +1 -0
  181. package/dist/testing/contracts.js +1 -0
  182. package/dist/testing/journal-contract.js +158 -5
  183. package/dist/theme/contrast.d.ts +19 -14
  184. package/dist/theme/contrast.js +181 -17
  185. package/dist/tree/apply.js +13 -0
  186. package/dist/tree/mutation.d.ts +18 -0
  187. package/dist/tree/mutation.js +24 -12
  188. package/dist/tree/navigation.d.ts +5 -0
  189. package/dist/tree/navigation.js +32 -10
  190. package/dist/tree/outline.d.ts +7 -0
  191. package/dist/tree/outline.js +9 -5
  192. package/package.json +39 -96
  193. package/dist/runtime/inverse-interpreter.d.ts +0 -90
  194. package/dist/runtime/inverse-interpreter.js +0 -56
@@ -0,0 +1,457 @@
1
+ import type { NodeId } from "../ids.js";
2
+ import type { PrimitiveType } from "../primitive-type.js";
3
+ import { type PrimitiveRole } from "../role.js";
4
+ import { type ComparedPopulations, type PageForm } from "./audiences.js";
5
+ import { type KindKey } from "./library.js";
6
+ import type { PageReading } from "./parts.js";
7
+ /**
8
+ * **What fixing a silent component was worth.**
9
+ *
10
+ * The record is
11
+ * [0394](../../decisions/0394-what-a-fix-to-a-silent-component-was-worth-is-read-over-the-places-both-windows-could-check.md),
12
+ * and it begins where
13
+ * [0393](../../decisions/0393-a-silent-component-is-a-census-over-the-placements-the-defect-could-be-seen-on-and-the-share-is-bracketed.md)
14
+ * gathered 0382's defect by kind of part, so a deployment can say *`loom.accordion`
15
+ * is silent in thirty-one of the thirty-four places it stands*. That is the
16
+ * component to fix. The question it leaves is the one an author has the moment
17
+ * they have fixed it: **did it work, and how much of the library did it
18
+ * recover?**
19
+ *
20
+ * Two censuses cannot answer it, for the reason two censuses of anything in this
21
+ * subsystem cannot be subtracted ([`library-change.ts`](library-change.ts)):
22
+ * they are taken over **different sets of places**. A page published in between
23
+ * adds placements, a page that expired takes some away, and a share of places
24
+ * moves with both while no sender has changed. So this pairs the places first
25
+ * and reads the movement over the ones that stand in both windows, exactly as a
26
+ * change to a library's reading is read.
27
+ *
28
+ * It is the **twenty-fifth** reading taken out of the server-side join of 0212
29
+ * rather than collected: **no payload field, no counter, no column, no table, no
30
+ * byte on any wire, and nothing in a reader's browser.** A browser could not
31
+ * send this if it wanted to — whether a part is silent is a statement about
32
+ * *what else was on the page*, which only the tree and the registry know.
33
+ *
34
+ * ## The population is the places the defect could be seen on in **both** windows
35
+ *
36
+ * This is the whole of the design and the only place a surface can read a row
37
+ * wrong.
38
+ *
39
+ * 0393's census divides by {@link KindSenderChange.checkable}'s one-window
40
+ * cousin — the placements something below reported reach at — because a leaf can
41
+ * never be seen to be silent and a placement nobody has been under cannot be
42
+ * seen to be silent *yet*. A comparison has to hold that still on **both**
43
+ * sides, and the two obvious cheaper denominators are both wrong in a direction
44
+ * that matters:
45
+ *
46
+ * - Over **every paired place**, the figure falls as a library gains leaves and
47
+ * as either window loses readers. That is 0393's argument unchanged.
48
+ * - Over the places checkable **in the later window only**, a placement nobody
49
+ * was under before and is under now arrives with no *before* state to have
50
+ * been silent in — so it joins the population at whatever it is today, and a
51
+ * window that merely got busier publishes a repair. This is the one that would
52
+ * have been easy to ship and impossible to notice: a release that fixed
53
+ * nothing, in a week with more readers, reads as a fix.
54
+ *
55
+ * So {@link KindSenderChange.checkable} is the paired placements witnessed in
56
+ * both windows, and the four transitions partition it. {@link
57
+ * KindSenderChange.checkableWas} and {@link KindSenderChange.checkableNow} are
58
+ * published beside it so that a surface can see how much of the library each
59
+ * window could speak for at all — the coverage moving is not a finding about
60
+ * senders and must not be read as one.
61
+ *
62
+ * ## An unclaimed side makes the transition unclaimable, not the share wider
63
+ *
64
+ * The census brackets: a witnessed placement whose standing is `unknown`
65
+ * reported something that was not a view with a reader below it, which is
66
+ * plausibly the same defect, so `share` excludes it and `atMost` includes it.
67
+ *
68
+ * A comparison cannot bracket, and should not. *Indeterminate, then reporting*
69
+ * is not a repair that might be smaller than it looks; it is **no claim at all**
70
+ * about what moved, because the earlier side never said anything to move from.
71
+ * Counting it as a repair would manufacture the finding this reading exists to
72
+ * publish, and counting it as `held` would hide one. So a paired checkable place
73
+ * that is `unknown` on either side is counted in
74
+ * {@link KindSenderChange.indeterminate}, kept out of
75
+ * {@link KindSenderChange.comparable}, and the row says so with the silence
76
+ * `unclaimable` where there is nothing else left.
77
+ *
78
+ * ## The verdict is a subtraction of two whole numbers
79
+ *
80
+ * `repaired − wentSilent`, over one population with one denominator — no
81
+ * threshold, no share compared with a share, and no reader anywhere in it. That
82
+ * is what 0239's rule buys at this unit, and it is why this reading can say
83
+ * *fixed* rather than *probably fixed*.
84
+ *
85
+ * The confound is still named rather than corrected: a placement stands as
86
+ * witnessed when **at least one** reader was below it, so a quieter window
87
+ * checks fewer places. {@link LibrarySendersChange.viewsWas} and {@link
88
+ * LibrarySendersChange.viewsNow} travel on the reading as floors (0147), with
89
+ * the two `checkable` counts, for exactly that reason.
90
+ *
91
+ * ## What it refuses
92
+ *
93
+ * **A deployment-wide share.** There is none here and there is none in the
94
+ * census, for the reason 0257 gives: a figure over every kind at once counts a
95
+ * page once per element node, so it measures how finely the pages were written
96
+ * as much as how they report themselves. The totals are counts.
97
+ *
98
+ * **Anything about a page.** The errand is the primitive — that is the whole of
99
+ * why 0393 exists — so the rows are kinds and the examples are examples. A
100
+ * surface that printed the recovered nodes as *the work* would be printing the
101
+ * wrong unit again, one window later.
102
+ *
103
+ * Pure, and linear in the parts handed in: one pass per window for the states,
104
+ * one for the pairing. It reaches no store, no clock and no DOM, and nothing in
105
+ * it survives into a browser bundle.
106
+ */
107
+ /** Why a kind of part has no before and after for its senders. */
108
+ export type SenderFixSilence =
109
+ /**
110
+ * Nothing in the pages read, on either side, is of this kind.
111
+ *
112
+ * Only ever a role row, for the reason a role row exists for every member of
113
+ * the vocabulary: *nothing in this library is a landmark* is a fact about the
114
+ * library rather than a missing row.
115
+ */
116
+ "unplaced"
117
+ /**
118
+ * It stands in both windows and in no place that is in both.
119
+ *
120
+ * Every placement was gained or lost — the pages it stood on are gone, or the
121
+ * nodes were rewritten. A fact about the **library** and not about its
122
+ * senders, and {@link KindSenderChange.gained} and
123
+ * {@link KindSenderChange.lost} are its size.
124
+ */
125
+ | "unpaired"
126
+ /**
127
+ * No place it holds still has an element part inside it on both sides.
128
+ *
129
+ * Leaves, which can never be checked, whichever window is read and however
130
+ * many readers arrive — so this is a fact about the **library**, as `unplaced`
131
+ * and `unpaired` are, and the one statement here that no week of readers will
132
+ * change. The instruction is *nothing stands inside it to witness it*.
133
+ *
134
+ * Said of the **intersection** and not of a window, which is the whole of why
135
+ * it is kept apart from the census's `unwitnessable` in meaning while keeping
136
+ * its word (0393): a place holding parts in one window and emptied by the
137
+ * release is in this state, because no reading of either window could have
138
+ * checked it in both. {@link KindSenderChange.inhabited} is nought exactly
139
+ * here.
140
+ */
141
+ | "unwitnessable"
142
+ /**
143
+ * Its places stand in both windows, something stands inside at least one of
144
+ * them on both sides, and none of them could be checked in both.
145
+ *
146
+ * Places nothing reported reach below in one of the two windows. The
147
+ * instruction is *come back with readers on both sides* — the one thing a
148
+ * deployment can answer by waiting — and it is kept apart from `unpaired`,
149
+ * which says the places moved, and from `unwitnessable`, which says there is
150
+ * nothing inside them to report.
151
+ */
152
+ | "uncheckable"
153
+ /**
154
+ * Every place checkable in both windows is `unknown` in one of them.
155
+ *
156
+ * Nothing is claimed, by the rule in the module documentation. The places are
157
+ * counted in {@link KindSenderChange.checkable} and in
158
+ * {@link KindSenderChange.indeterminate}; it is the comparison that is
159
+ * withheld, which is how this subsystem publishes a standing beside a withheld
160
+ * share (0212).
161
+ */
162
+ | "unclaimable";
163
+ export declare const SENDER_FIX_SILENCES: readonly SenderFixSilence[];
164
+ /** One line per silence, for a surface saying why a kind has no before and after. */
165
+ export declare const describeSenderFixSilence: (silence: SenderFixSilence) => string;
166
+ /**
167
+ * What happened to a kind of part's senders between the two windows.
168
+ *
169
+ * The sign of `repaired − wentSilent`, which is a subtraction of two counts of
170
+ * places over one population. See the module documentation: no threshold decides
171
+ * any of these.
172
+ */
173
+ export type SenderMovement =
174
+ /** More of the places it stands report themselves now, which is what a fix to a primitive looks like. */
175
+ "repaired"
176
+ /** Fewer do, which is what a release that broke a sender looks like. */
177
+ | "regressed"
178
+ /**
179
+ * Exactly as many do, which includes places trading places: two repaired and
180
+ * two gone silent is `held`, and both counts are published so a surface can
181
+ * say so.
182
+ */
183
+ | "held"
184
+ /**
185
+ * No place of it reported itself in either window.
186
+ *
187
+ * Kept apart from `held` because it is the one state here that is an
188
+ * instruction: the component is still silent everywhere it could be checked,
189
+ * and whatever was done between the windows did not reach it. There is
190
+ * deliberately no sibling for *reporting everywhere and still reporting* —
191
+ * that is `held` with nothing silent, and it asks nobody to do anything.
192
+ */
193
+ | "still-silent"
194
+ /** {@link KindSenderChange.silence} says why nothing can be said. */
195
+ | "unknown";
196
+ export declare const SENDER_MOVEMENTS: readonly SenderMovement[];
197
+ /** One line per movement, for a surface putting a component's before and after in front of a person. */
198
+ export declare const describeSenderMovement: (movement: SenderMovement) => string;
199
+ /** One kind of part's senders, held against themselves across two windows. */
200
+ export type KindSenderChange = {
201
+ readonly kind: KindKey;
202
+ /**
203
+ * What part a type plays (0114), or `null`. Always `null` on a role row, which
204
+ * carries it as its key.
205
+ *
206
+ * The later window's answer where it stands there, so that a surface reading a
207
+ * row and the role beside it is reading today's library.
208
+ */
209
+ readonly role: PrimitiveRole | null;
210
+ /** Places of this kind that stand in both windows: the same node of the same page, of this kind on both sides. */
211
+ readonly places: number;
212
+ /** Places of it in the later window with no counterpart in the earlier one. */
213
+ readonly gained: number;
214
+ /** Places of it in the earlier window with no counterpart in the later one. */
215
+ readonly lost: number;
216
+ /**
217
+ * Of {@link places}, those something below reported reach at in the **earlier**
218
+ * window.
219
+ *
220
+ * Published so that a surface can see the coverage move. A window with fewer
221
+ * readers checks fewer places, and that is not a finding about senders.
222
+ */
223
+ readonly checkableWas: number;
224
+ /** The same for the later window. */
225
+ readonly checkableNow: number;
226
+ /**
227
+ * Of {@link places}, those with an element part inside them on **both** sides
228
+ * — the places readers could ever check.
229
+ *
230
+ * The figure that says which of the two empty-population silences a row is in,
231
+ * and the one the census's `leaves` could not give a comparison: a place is
232
+ * out of this count where either side holds nothing below it, because a
233
+ * comparison needs it checkable in both. `places − inhabited` is the
234
+ * structural remainder, and a row with {@link checkable} nought and this
235
+ * nought is `unwitnessable` rather than short of readers (0414).
236
+ */
237
+ readonly inhabited: number;
238
+ /**
239
+ * Of {@link places}, those checkable in **both** windows — the population this
240
+ * row is about.
241
+ *
242
+ * Never the later window's alone: see the module documentation, where the
243
+ * cheaper denominator publishes a repair for a week that merely got busier.
244
+ */
245
+ readonly checkable: number;
246
+ /**
247
+ * Checkable places that reported something other than a view in one of the two
248
+ * windows, which are in no transition.
249
+ *
250
+ * Not a bracket on the figure, as the census publishes: across two windows an
251
+ * unclaimed side makes the transition unclaimable rather than the share wider.
252
+ */
253
+ readonly indeterminate: number;
254
+ /**
255
+ * `checkable − indeterminate`: the places with a verdict on both sides, which
256
+ * is the denominator of both shares and the sum of the four transitions.
257
+ */
258
+ readonly comparable: number;
259
+ /** Comparable places silent in the earlier window and reporting in the later one. */
260
+ readonly repaired: number;
261
+ /** Comparable places reporting in the earlier window and silent in the later one. */
262
+ readonly wentSilent: number;
263
+ /** Comparable places silent in both. */
264
+ readonly keptSilent: number;
265
+ /** Comparable places reporting in both. */
266
+ readonly keptReporting: number;
267
+ /**
268
+ * The share of {@link comparable} places that was silent in the earlier
269
+ * window; `null` where {@link silence} says why not.
270
+ *
271
+ * The same figure `KindSenders.share` takes of one window, over a population
272
+ * held still — so this one and {@link silentShareNow} are the two ends of a
273
+ * movement and the census's two are not.
274
+ */
275
+ readonly silentShareWas: number | null;
276
+ /** The same share in the later window, over the same places. */
277
+ readonly silentShareNow: number | null;
278
+ readonly movement: SenderMovement;
279
+ /**
280
+ * Why the two shares are not there, and `null` where they are.
281
+ *
282
+ * About the comparison and not about the row: {@link places}, {@link gained}
283
+ * and {@link lost} are counts of parts of trees and are true whatever any
284
+ * window measured.
285
+ */
286
+ readonly silence: SenderFixSilence | null;
287
+ /**
288
+ * Distinct trees with at least one place of this kind repaired.
289
+ *
290
+ * The figure a page-by-page reading cannot give, one window on from the
291
+ * census's `silentTrees`: *that fix recovered this component across nineteen
292
+ * of your pages*.
293
+ */
294
+ readonly repairedTrees: number;
295
+ /** Distinct trees with at least one place of this kind gone silent, by the same rule. */
296
+ readonly silencedTrees: number;
297
+ /**
298
+ * Nodes of this kind that went silent, in the order the pages were paired,
299
+ * capped at {@link SILENCED_EXAMPLES}.
300
+ *
301
+ * Examples and never a list to act on — the errand is the primitive. The
302
+ * repaired side has no examples for the same reason it needs none: nobody opens
303
+ * a page to look at something that is working.
304
+ */
305
+ readonly silencedExamples: readonly NodeId[];
306
+ };
307
+ /** How many newly silent nodes a row carries as examples. */
308
+ export declare const SILENCED_EXAMPLES = 5;
309
+ /** What a change did to a deployment's senders, by kind of part. */
310
+ export type LibrarySendersChange = {
311
+ /**
312
+ * Every type that stands in either window, most places gone silent first.
313
+ *
314
+ * Then the higher silent share in the later window, then by type, so two kinds
315
+ * that silenced the same number of places do not reorder on a refresh.
316
+ */
317
+ readonly byType: readonly KindSenderChange[];
318
+ /**
319
+ * Every role in the vocabulary that stands in either window, then the row for
320
+ * parts whose type declared none, in the same order as {@link byType}.
321
+ */
322
+ readonly byRole: readonly KindSenderChange[];
323
+ /** Forms read in both windows: a page in one of its forms, never a revision. */
324
+ readonly pages: number;
325
+ /** Forms read in the later window only, which is not pages published. */
326
+ readonly pagesGained: number;
327
+ /** Forms read in the earlier window only, which is not pages withdrawn. */
328
+ readonly pagesLost: number;
329
+ /** The audiences each window's forms named, published and never refused. */
330
+ readonly audiences: ComparedPopulations;
331
+ /**
332
+ * Paired pages whose revision moved between the windows.
333
+ *
334
+ * **The number this reading is usually read beside.** A fix to a primitive
335
+ * reaches a page by republishing it, so a repair with `republished` at nought
336
+ * is a repair nothing in the library can explain — a window that got busier, or
337
+ * a sender switched on outside the tree.
338
+ */
339
+ readonly republished: number;
340
+ /** Places that stand in both windows, which is the sum of every type row's {@link KindSenderChange.places}. */
341
+ readonly placements: number;
342
+ /** Places in the later window only. */
343
+ readonly gained: number;
344
+ /** Places in the earlier window only. */
345
+ readonly lost: number;
346
+ /**
347
+ * Paired nodes whose primitive type changed.
348
+ *
349
+ * A place one kind left and another took, counted in the first's {@link
350
+ * KindSenderChange.lost} and the second's {@link KindSenderChange.gained} —
351
+ * and held still in the role rows where the two types play the same part.
352
+ */
353
+ readonly recast: number;
354
+ /**
355
+ * Places checkable in both windows, over the whole library, which is the sum
356
+ * of every type row's {@link KindSenderChange.checkable}.
357
+ *
358
+ * A node whose type changed is in no type row's population, exactly as it is
359
+ * in no type row's {@link KindSenderChange.places}: there is no kind whose
360
+ * senders can be held still at a place one kind left and another took. The
361
+ * role rows hold it where the two types play the same part.
362
+ */
363
+ readonly checkable: number;
364
+ /**
365
+ * Paired places with something inside them on both sides, over the whole
366
+ * library, which is the sum of every type row's
367
+ * {@link KindSenderChange.inhabited}.
368
+ *
369
+ * Published beside {@link checkable} so that a deployment-wide reading of a
370
+ * comparison with no population can say which half it is in without walking
371
+ * the rows: nought here is a library of leaves, and anything above
372
+ * {@link checkable} is a library short of readers (0414).
373
+ */
374
+ readonly inhabited: number;
375
+ /** Of them, those with a verdict on both sides. */
376
+ readonly comparable: number;
377
+ /** Comparable places that went from silent to reporting, over the whole library. */
378
+ readonly repaired: number;
379
+ /** Comparable places that went from reporting to silent. */
380
+ readonly wentSilent: number;
381
+ /** Comparable places silent in both windows, which is what a fix has not reached yet. */
382
+ readonly keptSilent: number;
383
+ /** Comparable places reporting in both. */
384
+ readonly keptReporting: number;
385
+ /** Checkable places unclaimed on one of the two sides, over the whole library. */
386
+ readonly indeterminate: number;
387
+ /**
388
+ * A floor on the page views of the earlier window, added over the paired
389
+ * pages (0147).
390
+ *
391
+ * Published because every transition here is confounded by it: a quieter
392
+ * window checks fewer places with no sender behaving differently. Not a count
393
+ * of readers and not addable into one.
394
+ */
395
+ readonly viewsWas: number;
396
+ /** The same floor for the later window, over the same pages. */
397
+ readonly viewsNow: number;
398
+ /**
399
+ * The type that recovered its reporting in the most places, which is what the
400
+ * fix was worth.
401
+ *
402
+ * By the **count** of places and not by the share, for the reason the census
403
+ * ranks by the places a kind is silent in (0393): a kind repaired in its one
404
+ * and only place is a perfect rate and a smaller result than one repaired in
405
+ * thirty-one of thirty-four. `null` where nothing anywhere was repaired.
406
+ *
407
+ * A type and never a role, because a type is the thing an author replaces.
408
+ */
409
+ readonly mostRepaired: KindSenderChange | null;
410
+ /**
411
+ * The type that went silent in the most places, by the same rule.
412
+ *
413
+ * The alarm rather than the result, and the reason this reading is worth
414
+ * taking when nobody has fixed anything: a release that silences a component
415
+ * is invisible to a census, which sees only that it is silent now.
416
+ */
417
+ readonly mostSilenced: KindSenderChange | null;
418
+ /**
419
+ * Forms read at two revisions in one window, which are in nothing above.
420
+ *
421
+ * A page that is two live revisions in one window has no single counterpart in
422
+ * the other, and the comparison pairs by page in its form: excluded and named
423
+ * rather than picked between.
424
+ */
425
+ readonly ambiguous: readonly PageForm[];
426
+ /**
427
+ * Readings of a revision beyond the first, on either side, which were dropped.
428
+ *
429
+ * A page twice is the one way a census — or a comparison of two — can lie
430
+ * about how much of a library there is (0158).
431
+ */
432
+ readonly duplicated: number;
433
+ /**
434
+ * Types the two windows disagree about the role of, where the later window's
435
+ * answer stands.
436
+ *
437
+ * A type plays one part (0114), so a disagreement is two readings joined
438
+ * against two different registries. Every role row above is then about neither.
439
+ */
440
+ readonly roleDisagreed: readonly PrimitiveType[];
441
+ };
442
+ /**
443
+ * What a change did to a deployment's senders, across every page a kind of part
444
+ * stands on.
445
+ *
446
+ * Takes the two windows' readings rather than two `LibrarySenders`, and the
447
+ * reason is the method: a census publishes a kind's places added up, and the
448
+ * places have to be **paired** before anything can be held still.
449
+ *
450
+ * The labels are the caller's. Two readings of one window come back as every
451
+ * place held and nothing repaired or silenced — which is asserted against the
452
+ * census term for term — and a caller holding the two sides backwards gets a
453
+ * comparison with every movement reversed rather than a refusal, exactly as
454
+ * every other before-and-after reading here does.
455
+ */
456
+ export declare const librarySendersChangeOf: (was: readonly PageReading[], now: readonly PageReading[]) => LibrarySendersChange;
457
+ //# sourceMappingURL=library-senders-change.d.ts.map