@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.
- package/README.md +3 -1
- package/dist/application/application.d.ts +109 -0
- package/dist/application/application.js +97 -0
- package/dist/application/memory.d.ts +20 -0
- package/dist/application/memory.js +79 -0
- package/dist/application/store.d.ts +101 -0
- package/dist/application/store.js +25 -0
- package/dist/audience/audience.d.ts +36 -0
- package/dist/audience/audience.js +41 -0
- package/dist/cli/templates.js +19 -0
- package/dist/data/plan.js +0 -0
- package/dist/data/resolution.d.ts +23 -1
- package/dist/data/resolve.d.ts +30 -3
- package/dist/data/resolve.js +11 -3
- package/dist/ids.d.ts +10 -0
- package/dist/ids.js +11 -1
- package/dist/index.d.ts +1 -0
- package/dist/index.js +1 -0
- package/dist/patch.d.ts +54 -0
- package/dist/patch.js +44 -0
- package/dist/project/closing.d.ts +51 -0
- package/dist/project/closing.js +53 -0
- package/dist/project/memory.d.ts +20 -0
- package/dist/project/memory.js +97 -0
- package/dist/project/project.d.ts +90 -0
- package/dist/project/project.js +91 -0
- package/dist/project/store.d.ts +135 -0
- package/dist/project/store.js +41 -0
- package/dist/registered.d.ts +64 -0
- package/dist/registered.js +118 -0
- package/dist/render/behaviour-adjust.d.ts +11 -19
- package/dist/render/behaviour-adjust.js +75 -21
- package/dist/render/behaviour-present.d.ts +8 -0
- package/dist/render/behaviour-present.js +57 -6
- package/dist/render/behaviour.d.ts +98 -17
- package/dist/render/behaviour.js +91 -26
- package/dist/render/control-name.d.ts +68 -0
- package/dist/render/control-name.js +37 -0
- package/dist/render/diagnostics.d.ts +72 -0
- package/dist/render/diagnostics.js +7 -0
- package/dist/render/index.d.ts +2 -0
- package/dist/render/index.js +2 -0
- package/dist/render/reads.d.ts +11 -0
- package/dist/render/reads.js +12 -1
- package/dist/render/render.js +102 -7
- package/dist/render/slots.d.ts +52 -0
- package/dist/render/slots.js +24 -0
- package/dist/render/theme.d.ts +54 -1
- package/dist/render/theme.js +23 -1
- package/dist/render/unshown.d.ts +152 -0
- package/dist/render/unshown.js +80 -0
- package/dist/runtime/analysis.d.ts +94 -9
- package/dist/runtime/analysis.js +54 -9
- package/dist/runtime/assessment.d.ts +36 -2
- package/dist/runtime/assessment.js +27 -2
- package/dist/runtime/checks.d.ts +148 -0
- package/dist/runtime/checks.js +112 -0
- package/dist/runtime/disposition.d.ts +96 -0
- package/dist/runtime/disposition.js +46 -0
- package/dist/runtime/gate.js +22 -0
- package/dist/runtime/index.d.ts +3 -0
- package/dist/runtime/index.js +3 -0
- package/dist/runtime/irreversibility.d.ts +64 -0
- package/dist/runtime/irreversibility.js +45 -0
- package/dist/runtime/pipeline.d.ts +43 -0
- package/dist/runtime/pipeline.js +10 -2
- package/dist/runtime/policy-change.d.ts +93 -0
- package/dist/runtime/policy-change.js +299 -0
- package/dist/runtime/policy-log.d.ts +406 -0
- package/dist/runtime/policy-log.js +285 -0
- package/dist/runtime/reversibility.d.ts +11 -9
- package/dist/runtime/stakes.d.ts +129 -1
- package/dist/runtime/stakes.js +240 -26
- package/dist/runtime/vocabulary.d.ts +164 -7
- package/dist/runtime/vocabulary.js +181 -8
- package/dist/sdk/audit.d.ts +174 -3
- package/dist/sdk/audit.js +176 -17
- package/dist/sdk/catalogue.d.ts +9 -1
- package/dist/sdk/conformance.d.ts +37 -3
- package/dist/sdk/conformance.js +25 -4
- package/dist/sdk/definition.d.ts +65 -0
- package/dist/sdk/definition.js +22 -0
- package/dist/sdk/registry.d.ts +29 -2
- package/dist/sdk/registry.js +63 -1
- package/dist/signals/action-change.d.ts +507 -0
- package/dist/signals/action-change.js +265 -0
- package/dist/signals/action.d.ts +331 -0
- package/dist/signals/action.js +182 -0
- package/dist/signals/applied-window.contract.d.ts +23 -0
- package/dist/signals/applied-window.contract.js +160 -0
- package/dist/signals/arriving.d.ts +210 -0
- package/dist/signals/arriving.js +133 -0
- package/dist/signals/audiences.d.ts +528 -0
- package/dist/signals/audiences.js +255 -0
- package/dist/signals/broadcast.d.ts +8 -2
- package/dist/signals/broadcast.js +58 -8
- package/dist/signals/change.d.ts +378 -0
- package/dist/signals/change.js +327 -0
- package/dist/signals/collect.d.ts +41 -0
- package/dist/signals/collect.js +88 -7
- package/dist/signals/copy-change.d.ts +553 -0
- package/dist/signals/copy-change.js +377 -0
- package/dist/signals/copy.d.ts +337 -0
- package/dist/signals/copy.js +211 -0
- package/dist/signals/counters.d.ts +46 -0
- package/dist/signals/counters.js +102 -0
- package/dist/signals/deliver.d.ts +23 -4
- package/dist/signals/deliver.js +34 -6
- package/dist/signals/deployment-change.d.ts +371 -0
- package/dist/signals/deployment-change.js +268 -0
- package/dist/signals/deployment.d.ts +265 -0
- package/dist/signals/deployment.js +152 -0
- package/dist/signals/door.d.ts +92 -0
- package/dist/signals/door.js +53 -0
- package/dist/signals/fold.d.ts +10 -0
- package/dist/signals/fold.js +5 -1
- package/dist/signals/form-action.d.ts +302 -0
- package/dist/signals/form-action.js +169 -0
- package/dist/signals/form-copy.d.ts +523 -0
- package/dist/signals/form-copy.js +346 -0
- package/dist/signals/forms.d.ts +247 -0
- package/dist/signals/forms.js +147 -0
- package/dist/signals/funnel-change.d.ts +548 -0
- package/dist/signals/funnel-change.js +361 -0
- package/dist/signals/funnel.d.ts +532 -0
- package/dist/signals/funnel.js +216 -0
- package/dist/signals/health.d.ts +497 -0
- package/dist/signals/health.js +361 -0
- package/dist/signals/index.d.ts +41 -0
- package/dist/signals/index.js +41 -0
- package/dist/signals/ingest.d.ts +56 -1
- package/dist/signals/ingest.js +91 -1
- package/dist/signals/journal.d.ts +11 -0
- package/dist/signals/kinds.d.ts +8 -6
- package/dist/signals/kinds.js +14 -6
- package/dist/signals/library-action.d.ts +430 -0
- package/dist/signals/library-action.js +336 -0
- package/dist/signals/library-change.d.ts +477 -0
- package/dist/signals/library-change.js +335 -0
- package/dist/signals/library-copy-change.d.ts +498 -0
- package/dist/signals/library-copy-change.js +476 -0
- package/dist/signals/library-pace.d.ts +319 -0
- package/dist/signals/library-pace.js +305 -0
- package/dist/signals/library-reach-change.d.ts +636 -0
- package/dist/signals/library-reach-change.js +534 -0
- package/dist/signals/library-reach.d.ts +377 -0
- package/dist/signals/library-reach.js +227 -0
- package/dist/signals/library-word-reach-change.d.ts +567 -0
- package/dist/signals/library-word-reach-change.js +568 -0
- package/dist/signals/library.d.ts +306 -0
- package/dist/signals/library.js +178 -0
- package/dist/signals/memory.d.ts +9 -0
- package/dist/signals/memory.js +105 -14
- package/dist/signals/migrate.d.ts +17 -2
- package/dist/signals/migrate.js +122 -5
- package/dist/signals/notice.d.ts +334 -0
- package/dist/signals/notice.js +228 -0
- package/dist/signals/pace-change.d.ts +501 -0
- package/dist/signals/pace-change.js +310 -0
- package/dist/signals/pace.d.ts +296 -0
- package/dist/signals/pace.js +291 -0
- package/dist/signals/page-views.d.ts +365 -0
- package/dist/signals/page-views.js +218 -0
- package/dist/signals/parts.d.ts +344 -0
- package/dist/signals/parts.js +273 -0
- package/dist/signals/postgres.d.ts +16 -2
- package/dist/signals/postgres.js +390 -87
- package/dist/signals/progress.d.ts +212 -0
- package/dist/signals/progress.js +150 -0
- package/dist/signals/ratios.d.ts +108 -0
- package/dist/signals/ratios.js +40 -0
- package/dist/signals/reach.d.ts +309 -0
- package/dist/signals/reach.js +93 -0
- package/dist/signals/readable.d.ts +34 -0
- package/dist/signals/readable.js +34 -0
- package/dist/signals/readership.d.ts +381 -0
- package/dist/signals/readership.js +308 -0
- package/dist/signals/region-pages.d.ts +173 -0
- package/dist/signals/region-pages.js +62 -0
- package/dist/signals/region.d.ts +287 -0
- package/dist/signals/region.js +198 -0
- package/dist/signals/retention.d.ts +141 -0
- package/dist/signals/retention.js +58 -0
- package/dist/signals/rollup.d.ts +67 -3
- package/dist/signals/rollup.js +0 -0
- package/dist/signals/schema.d.ts +432 -1
- package/dist/signals/schema.js +157 -3
- package/dist/signals/signal.d.ts +237 -11
- package/dist/signals/signal.js +70 -10
- package/dist/signals/silence-census.d.ts +205 -0
- package/dist/signals/silence-census.js +87 -0
- package/dist/signals/silences.d.ts +848 -0
- package/dist/signals/silences.js +753 -0
- package/dist/signals/tally.d.ts +140 -11
- package/dist/signals/window-figures.d.ts +148 -0
- package/dist/signals/window-figures.js +42 -0
- package/dist/signals/window.d.ts +866 -0
- package/dist/signals/window.js +693 -0
- package/dist/signals/words.d.ts +24 -0
- package/dist/signals/words.js +24 -0
- package/dist/store/index.d.ts +19 -0
- package/dist/store/index.js +19 -0
- package/dist/store/memory.d.ts +2 -1
- package/dist/store/memory.js +48 -12
- package/dist/store/migrate.d.ts +80 -0
- package/dist/store/migrate.js +259 -7
- package/dist/store/postgres-applications.d.ts +4 -0
- package/dist/store/postgres-applications.js +197 -0
- package/dist/store/postgres-holds.d.ts +10 -1
- package/dist/store/postgres-holds.js +116 -101
- package/dist/store/postgres-policy-log.d.ts +14 -0
- package/dist/store/postgres-policy-log.js +240 -0
- package/dist/store/postgres-projects.d.ts +4 -0
- package/dist/store/postgres-projects.js +217 -0
- package/dist/store/postgres.d.ts +16 -1
- package/dist/store/postgres.js +59 -9
- package/dist/store/replay.d.ts +102 -1
- package/dist/store/replay.js +190 -19
- package/dist/store/reseed.d.ts +238 -0
- package/dist/store/reseed.js +308 -0
- package/dist/store/schema.d.ts +450 -2
- package/dist/store/schema.js +141 -5
- package/dist/store/store.d.ts +29 -6
- package/dist/submit/resolve.js +2 -1
- package/dist/telemetry/calibration.d.ts +25 -0
- package/dist/telemetry/calibration.js +27 -1
- package/dist/telemetry/event.d.ts +391 -33
- package/dist/telemetry/event.js +84 -20
- package/dist/telemetry/index.d.ts +1 -0
- package/dist/telemetry/index.js +1 -0
- package/dist/telemetry/journal.d.ts +72 -3
- package/dist/telemetry/journal.js +9 -0
- package/dist/telemetry/lookup.d.ts +27 -0
- package/dist/telemetry/lookup.js +18 -0
- package/dist/telemetry/memory.js +23 -0
- package/dist/telemetry/migrate.js +22 -1
- package/dist/telemetry/postgres.d.ts +10 -1
- package/dist/telemetry/postgres.js +172 -90
- package/dist/telemetry/remeasure.d.ts +78 -0
- package/dist/telemetry/remeasure.js +83 -0
- package/dist/telemetry/retention.d.ts +2 -2
- package/dist/telemetry/schema.d.ts +17 -0
- package/dist/telemetry/schema.js +27 -1
- package/dist/telemetry/sink.d.ts +2 -2
- package/dist/testing/application-contract.d.ts +14 -0
- package/dist/testing/application-contract.js +270 -0
- package/dist/testing/contracts.d.ts +12 -7
- package/dist/testing/contracts.js +12 -7
- package/dist/testing/definitions.d.ts +78 -0
- package/dist/testing/definitions.js +134 -9
- package/dist/testing/doubles.d.ts +103 -0
- package/dist/testing/doubles.js +143 -0
- package/dist/testing/index.d.ts +2 -2
- package/dist/testing/index.js +2 -2
- package/dist/testing/journal-contract.js +140 -2
- package/dist/testing/model-contract.d.ts +110 -0
- package/dist/testing/model-contract.js +150 -0
- package/dist/testing/policy-log-contract.d.ts +26 -0
- package/dist/testing/policy-log-contract.js +344 -0
- package/dist/testing/project-contract.d.ts +14 -0
- package/dist/testing/project-contract.js +266 -0
- package/dist/testing/reader-signal-contract.d.ts +27 -2
- package/dist/testing/reader-signal-contract.js +475 -5
- package/dist/testing/store-contract.d.ts +7 -1
- package/dist/testing/store-contract.js +84 -3
- package/dist/theme/apply.d.ts +20 -1
- package/dist/theme/apply.js +5 -3
- package/dist/theme/derive.d.ts +22 -0
- package/dist/theme/derive.js +54 -1
- package/dist/theme/library.js +1 -1
- package/dist/theme/measure.d.ts +34 -0
- package/dist/theme/measure.js +30 -1
- package/dist/theme/palettes.js +7 -7
- package/dist/theme/ramp.d.ts +64 -0
- package/dist/theme/ramp.js +114 -0
- package/dist/theme/registry.d.ts +9 -0
- package/dist/theme/registry.js +11 -1
- package/dist/theme/separation.d.ts +97 -3
- package/dist/theme/separation.js +75 -0
- package/dist/tree/compare.d.ts +9 -0
- package/dist/tree/compare.js +18 -0
- package/dist/write/computed.d.ts +60 -0
- package/dist/write/computed.js +61 -0
- package/dist/write/held.d.ts +59 -0
- package/dist/write/index.d.ts +5 -2
- package/dist/write/index.js +5 -2
- package/dist/write/reseed.d.ts +151 -0
- package/dist/write/reseed.js +184 -0
- package/dist/write/revert.js +2 -16
- package/package.json +98 -19
|
@@ -0,0 +1,534 @@
|
|
|
1
|
+
import { everyMemberOf } from "../closed-set.js";
|
|
2
|
+
import { PRIMITIVE_ROLES } from "../role.js";
|
|
3
|
+
import { inFormOrder } from "./audiences.js";
|
|
4
|
+
import { atDoorScale, doorOf } from "./door.js";
|
|
5
|
+
import { kindKeyOf } from "./library.js";
|
|
6
|
+
import { pairedWindowOf, partsByNodeIn } from "./library-change.js";
|
|
7
|
+
import { pageViewsFor } from "./page-views.js";
|
|
8
|
+
import { spokenFor } from "./parts.js";
|
|
9
|
+
export const READING_SIDES = everyMemberOf()(["was", "now"]);
|
|
10
|
+
/** One line per side, for a surface naming the window a page's reason came from. */
|
|
11
|
+
export const describeReadingSide = (side) => side === "was" ? "the earlier window" : "the later window";
|
|
12
|
+
export const KIND_REACH_CHANGE_SILENCES = everyMemberOf()([
|
|
13
|
+
"unplaced",
|
|
14
|
+
"unpaired",
|
|
15
|
+
"unread",
|
|
16
|
+
"unscaled",
|
|
17
|
+
"unopened",
|
|
18
|
+
"uncounted",
|
|
19
|
+
]);
|
|
20
|
+
/** One line per silence, for a surface saying why a kind has no before and after. */
|
|
21
|
+
export const describeKindReachChangeSilence = (silence) => {
|
|
22
|
+
switch (silence) {
|
|
23
|
+
case "unplaced":
|
|
24
|
+
return "nothing in the pages read, in either window, is of this kind";
|
|
25
|
+
case "unpaired":
|
|
26
|
+
return "no place this kind of part stands is in both windows";
|
|
27
|
+
case "unread":
|
|
28
|
+
return "no place it stands in both windows can be spoken for in both";
|
|
29
|
+
case "unscaled":
|
|
30
|
+
return "a page it stands on has no page views counted at the door in one of the two windows";
|
|
31
|
+
case "unopened":
|
|
32
|
+
return "a page it stands on has a row and nothing has said a page view began";
|
|
33
|
+
case "uncounted":
|
|
34
|
+
return "a page it stands on has readers in one window whose reading has not been counted yet";
|
|
35
|
+
}
|
|
36
|
+
};
|
|
37
|
+
export const KIND_REACH_MOVEMENTS = everyMemberOf()([
|
|
38
|
+
"taken-up",
|
|
39
|
+
"abandoned",
|
|
40
|
+
"held",
|
|
41
|
+
"still-unread",
|
|
42
|
+
"unknown",
|
|
43
|
+
]);
|
|
44
|
+
/** One line per movement, for a surface putting a kind's before and after in front of a person. */
|
|
45
|
+
export const describeKindReachMovement = (movement) => {
|
|
46
|
+
switch (movement) {
|
|
47
|
+
case "taken-up":
|
|
48
|
+
return "a larger share of the readers who met it read it now";
|
|
49
|
+
case "abandoned":
|
|
50
|
+
return "a smaller share of the readers who met it read it now";
|
|
51
|
+
case "held":
|
|
52
|
+
return "the same share of the readers who met it reads it now";
|
|
53
|
+
case "still-unread":
|
|
54
|
+
return "no reader reached any place it stands, in either window";
|
|
55
|
+
case "unknown":
|
|
56
|
+
return "nothing can be said about what changed";
|
|
57
|
+
}
|
|
58
|
+
};
|
|
59
|
+
export const READER_SHARE_CAUSES = everyMemberOf()(["readers", "pages", "either", "together"]);
|
|
60
|
+
/** One line per cause, for a surface saying what moved a share of readers. */
|
|
61
|
+
export const describeReaderShareCause = (cause) => {
|
|
62
|
+
switch (cause) {
|
|
63
|
+
case "readers":
|
|
64
|
+
return "the way readers read it would have moved it on its own";
|
|
65
|
+
case "pages":
|
|
66
|
+
return "the traffic the pages it stands on had would have moved it on its own";
|
|
67
|
+
case "either":
|
|
68
|
+
return "either would have moved it on its own";
|
|
69
|
+
case "together":
|
|
70
|
+
return "neither would have moved it alone and the two together did";
|
|
71
|
+
}
|
|
72
|
+
};
|
|
73
|
+
const tallying = (kind) => ({
|
|
74
|
+
kind,
|
|
75
|
+
role: null,
|
|
76
|
+
places: 0,
|
|
77
|
+
gained: 0,
|
|
78
|
+
lost: 0,
|
|
79
|
+
comparable: 0,
|
|
80
|
+
pages: new Set(),
|
|
81
|
+
countedWas: 0,
|
|
82
|
+
countedNow: 0,
|
|
83
|
+
metWas: 0,
|
|
84
|
+
metNow: 0,
|
|
85
|
+
heldTraffic: 0,
|
|
86
|
+
heldReading: 0,
|
|
87
|
+
weights: [],
|
|
88
|
+
driftWas: 0,
|
|
89
|
+
driftNow: 0,
|
|
90
|
+
pendingWas: 0,
|
|
91
|
+
pendingNow: 0,
|
|
92
|
+
unreconciled: 0,
|
|
93
|
+
blocked: null,
|
|
94
|
+
});
|
|
95
|
+
/** The two keys one placement is counted under, which is the pair of questions this answers. */
|
|
96
|
+
const keysOf = (part) => [
|
|
97
|
+
{ by: "type", type: part.type },
|
|
98
|
+
{ by: "role", role: part.role },
|
|
99
|
+
];
|
|
100
|
+
const rowFor = (rows, kind) => {
|
|
101
|
+
const key = kindKeyOf(kind);
|
|
102
|
+
const row = rows.get(key) ?? tallying(kind);
|
|
103
|
+
rows.set(key, row);
|
|
104
|
+
return row;
|
|
105
|
+
};
|
|
106
|
+
/** The kind-level reason a page's reason causes, which is the same state at the other subject. */
|
|
107
|
+
const KIND_REACH_CHANGE_OF_REACH = Object.freeze({
|
|
108
|
+
unmeasured: "unscaled",
|
|
109
|
+
unopened: "unopened",
|
|
110
|
+
uncounted: "uncounted",
|
|
111
|
+
});
|
|
112
|
+
/**
|
|
113
|
+
* The silence, with the reasons tried in the order they have to be tried in.
|
|
114
|
+
*
|
|
115
|
+
* Nothing of the kind first, because *there is no such part in this library* is
|
|
116
|
+
* a better answer than anything said about its places. Then nothing held still,
|
|
117
|
+
* because a kind whose places all moved is a fact about the library and would
|
|
118
|
+
* otherwise be reported as nobody having been seen reading it. Then nothing
|
|
119
|
+
* spoken for, because a kind no window can speak for has no share whether or not
|
|
120
|
+
* its pages could be scaled.
|
|
121
|
+
*/
|
|
122
|
+
const silenceOf = (of) => {
|
|
123
|
+
if (of.places + of.gained + of.lost === 0)
|
|
124
|
+
return "unplaced";
|
|
125
|
+
if (of.places === 0)
|
|
126
|
+
return "unpaired";
|
|
127
|
+
if (of.comparable === 0)
|
|
128
|
+
return "unread";
|
|
129
|
+
return of.blocked === null ? null : KIND_REACH_CHANGE_OF_REACH[of.blocked];
|
|
130
|
+
};
|
|
131
|
+
/**
|
|
132
|
+
* The verdict, off the two shares and never off the two counts.
|
|
133
|
+
*
|
|
134
|
+
* The opposite of 0266's rule, and for the opposite reason: there the
|
|
135
|
+
* denominator is the same count of places on both sides, so the sign of a
|
|
136
|
+
* subtraction of two whole numbers is the whole answer. Here the two
|
|
137
|
+
* denominators are two windows' traffic, so the shares are the only comparable
|
|
138
|
+
* pair and the subtraction has to be done on them.
|
|
139
|
+
*/
|
|
140
|
+
const movementOf = (of, silence, shareWas, shareNow) => {
|
|
141
|
+
if (silence !== null)
|
|
142
|
+
return "unknown";
|
|
143
|
+
if (of.metWas === 0 && of.metNow === 0)
|
|
144
|
+
return "still-unread";
|
|
145
|
+
if (shareNow > shareWas)
|
|
146
|
+
return "taken-up";
|
|
147
|
+
if (shareNow < shareWas)
|
|
148
|
+
return "abandoned";
|
|
149
|
+
return "held";
|
|
150
|
+
};
|
|
151
|
+
/**
|
|
152
|
+
* Which side was sufficient, by the direction each counterfactual carries.
|
|
153
|
+
*
|
|
154
|
+
* `null` where nothing moved: a verdict that did not move has nothing to
|
|
155
|
+
* attribute, which is `PaceCause`'s rule (0244).
|
|
156
|
+
*/
|
|
157
|
+
export const readerShareCauseOf = (shareWas, shareNow, ifTrafficHeld, ifReadingHeld) => {
|
|
158
|
+
const direction = Math.sign(shareNow - shareWas);
|
|
159
|
+
if (direction === 0)
|
|
160
|
+
return null;
|
|
161
|
+
const readers = Math.sign(ifTrafficHeld - shareWas) === direction;
|
|
162
|
+
const pages = Math.sign(ifReadingHeld - shareWas) === direction;
|
|
163
|
+
if (readers && pages)
|
|
164
|
+
return "either";
|
|
165
|
+
if (readers)
|
|
166
|
+
return "readers";
|
|
167
|
+
if (pages)
|
|
168
|
+
return "pages";
|
|
169
|
+
return "together";
|
|
170
|
+
};
|
|
171
|
+
/**
|
|
172
|
+
* Half the sum of the absolute movements in each place's share of its side's
|
|
173
|
+
* weight, which is the figure a comparison of two readerships publishes
|
|
174
|
+
* (0247), over places rather than regions.
|
|
175
|
+
*
|
|
176
|
+
* **`null` where either side has no weight at all**, because there is no
|
|
177
|
+
* distance between a mix and nothing to have one
|
|
178
|
+
* ([0307](../../decisions/0307-a-distance-between-a-mix-and-nothing-is-withheld-and-the-invariant-both-rolls-rest-on-is-asserted.md)).
|
|
179
|
+
* A nought here is the one value a surface reads as *the weights did not move*,
|
|
180
|
+
* which is the opposite sentence; 0247's own reading withholds `moved` in the
|
|
181
|
+
* same state for the same reason.
|
|
182
|
+
*
|
|
183
|
+
* **Neither roll can reach it**, and that is asserted rather than described:
|
|
184
|
+
* both compute this only where their silence is `null`, and a door that can
|
|
185
|
+
* scale a page has counted at least one page view at it ([`door.ts`](door.ts)),
|
|
186
|
+
* so a measured row has a weight behind it. The guard is here because the
|
|
187
|
+
* helper is exported and a caller outside the two rolls would otherwise divide
|
|
188
|
+
* by nought.
|
|
189
|
+
*/
|
|
190
|
+
export const weightMovedOver = (weights, totals) => {
|
|
191
|
+
if (totals.was === 0 || totals.now === 0)
|
|
192
|
+
return null;
|
|
193
|
+
return (weights.reduce((sum, weight) => sum + Math.abs(weight.now / totals.now - weight.was / totals.was), 0) / 2);
|
|
194
|
+
};
|
|
195
|
+
const rowOf = (of) => {
|
|
196
|
+
const silence = silenceOf(of);
|
|
197
|
+
const measured = silence === null;
|
|
198
|
+
const shareWas = of.metWas / of.countedWas;
|
|
199
|
+
const shareNow = of.metNow / of.countedNow;
|
|
200
|
+
const ifTrafficHeld = of.heldTraffic / of.countedWas;
|
|
201
|
+
const ifReadingHeld = of.heldReading / of.countedNow;
|
|
202
|
+
return {
|
|
203
|
+
kind: of.kind,
|
|
204
|
+
role: of.kind.by === "type" ? of.role : null,
|
|
205
|
+
places: of.places,
|
|
206
|
+
gained: of.gained,
|
|
207
|
+
lost: of.lost,
|
|
208
|
+
comparable: of.comparable,
|
|
209
|
+
pages: of.pages.size,
|
|
210
|
+
countedWas: measured ? of.countedWas : null,
|
|
211
|
+
countedNow: measured ? of.countedNow : null,
|
|
212
|
+
metWas: measured ? of.metWas : null,
|
|
213
|
+
metNow: measured ? of.metNow : null,
|
|
214
|
+
shareWas: measured ? shareWas : null,
|
|
215
|
+
shareNow: measured ? shareNow : null,
|
|
216
|
+
shift: measured ? shareNow - shareWas : null,
|
|
217
|
+
readersMoved: measured ? (shareNow - shareWas) * of.countedNow : null,
|
|
218
|
+
ifTrafficHeld: measured ? ifTrafficHeld : null,
|
|
219
|
+
ifReadingHeld: measured ? ifReadingHeld : null,
|
|
220
|
+
movement: movementOf(of, silence, shareWas, shareNow),
|
|
221
|
+
cause: measured ? readerShareCauseOf(shareWas, shareNow, ifTrafficHeld, ifReadingHeld) : null,
|
|
222
|
+
weightMoved: measured
|
|
223
|
+
? weightMovedOver(of.weights, { was: of.countedWas, now: of.countedNow })
|
|
224
|
+
: null,
|
|
225
|
+
driftWas: of.driftWas,
|
|
226
|
+
driftNow: of.driftNow,
|
|
227
|
+
pendingWas: of.pendingWas,
|
|
228
|
+
pendingNow: of.pendingNow,
|
|
229
|
+
unreconciled: of.unreconciled,
|
|
230
|
+
exact: measured &&
|
|
231
|
+
of.driftWas === 0 &&
|
|
232
|
+
of.driftNow === 0 &&
|
|
233
|
+
of.pendingWas === 0 &&
|
|
234
|
+
of.pendingNow === 0 &&
|
|
235
|
+
of.unreconciled === 0,
|
|
236
|
+
silence,
|
|
237
|
+
};
|
|
238
|
+
};
|
|
239
|
+
/** The name a row is ordered by, which is the key's own and never the row's position. */
|
|
240
|
+
const nameOf = (kind) => (kind.by === "type" ? kind.type : (kind.role ?? ""));
|
|
241
|
+
/**
|
|
242
|
+
* The worse of two, which is the ranking rule spelled once.
|
|
243
|
+
*
|
|
244
|
+
* Most readers lost, then the lower share now, then by name. A kind with no
|
|
245
|
+
* figures at all sorts after every kind that has them — infinity rather than a
|
|
246
|
+
* nought, because `null` is *nothing can be said* and a nought would rank a
|
|
247
|
+
* withheld row among the kinds that merely held.
|
|
248
|
+
*/
|
|
249
|
+
const worseOf = (one, other) => (one.readersMoved ?? Number.POSITIVE_INFINITY) -
|
|
250
|
+
(other.readersMoved ?? Number.POSITIVE_INFINITY) ||
|
|
251
|
+
(one.shareNow ?? 2) - (other.shareNow ?? 2) ||
|
|
252
|
+
nameOf(one.kind).localeCompare(nameOf(other.kind));
|
|
253
|
+
/** Tree id, then newest revision first, which is the order the page-view rows are read in. */
|
|
254
|
+
const bySide = (one, other) => one.treeId.localeCompare(other.treeId) ||
|
|
255
|
+
other.revision - one.revision ||
|
|
256
|
+
one.side.localeCompare(other.side);
|
|
257
|
+
/** One page with its door, picked out of the window's rows by the published matching rule. */
|
|
258
|
+
export const scaledPageOf = (reading, rows) => {
|
|
259
|
+
const found = pageViewsFor(reading, rows);
|
|
260
|
+
return { reading, door: doorOf(found.measured), duplicatedRows: found.duplicated };
|
|
261
|
+
};
|
|
262
|
+
/**
|
|
263
|
+
* One placement's contribution to one kind, which is nothing at all unless both
|
|
264
|
+
* windows can speak for it.
|
|
265
|
+
*
|
|
266
|
+
* The door's reason is taken only from a page bearing a placement both sides
|
|
267
|
+
* have a verdict on: a kind nobody read in either window is `unread` and not
|
|
268
|
+
* `unscaled`, because *no window can speak for it* is the better answer and the
|
|
269
|
+
* door has nothing to scale either way.
|
|
270
|
+
*/
|
|
271
|
+
const add = (into, places, doors, form) => {
|
|
272
|
+
into.places += 1;
|
|
273
|
+
if (places.was.standing === "unknown" || places.now.standing === "unknown")
|
|
274
|
+
return;
|
|
275
|
+
into.comparable += 1;
|
|
276
|
+
/**
|
|
277
|
+
* The form and not the tree, because the pairing is per form: counting two
|
|
278
|
+
* forms of a page as one page would understate the places a kind stands in
|
|
279
|
+
* by exactly the pages a deployment serves twice.
|
|
280
|
+
*/
|
|
281
|
+
into.pages.add(form);
|
|
282
|
+
if (doors.was.silence !== null || doors.now.silence !== null) {
|
|
283
|
+
into.blocked ??= doors.was.silence ?? doors.now.silence;
|
|
284
|
+
return;
|
|
285
|
+
}
|
|
286
|
+
const reachedWas = places.was.counters?.reached ?? 0;
|
|
287
|
+
const reachedNow = places.now.counters?.reached ?? 0;
|
|
288
|
+
into.countedWas += doors.was.counted;
|
|
289
|
+
into.countedNow += doors.now.counted;
|
|
290
|
+
/**
|
|
291
|
+
* `reached × counted ÷ appearances`, in that order, because it is the
|
|
292
|
+
* published order (0256): a surface drawing one window's share beside this
|
|
293
|
+
* one's `shareNow` is drawing the same number, and three floats multiplied
|
|
294
|
+
* and divided in two orders agree to fifteen places and not to sixteen.
|
|
295
|
+
*/
|
|
296
|
+
into.metWas += atDoorScale(reachedWas, doors.was);
|
|
297
|
+
into.metNow += atDoorScale(reachedNow, doors.now);
|
|
298
|
+
/** The same term with the other side's weight, which is the whole of a counterfactual. */
|
|
299
|
+
into.heldTraffic += atDoorScale(reachedNow, doors.now, doors.was);
|
|
300
|
+
into.heldReading += atDoorScale(reachedWas, doors.was, doors.now);
|
|
301
|
+
into.weights.push({ was: doors.was.counted, now: doors.now.counted });
|
|
302
|
+
into.driftWas += doors.was.drift;
|
|
303
|
+
into.driftNow += doors.now.drift;
|
|
304
|
+
into.pendingWas += doors.was.pending;
|
|
305
|
+
into.pendingNow += doors.now.pending;
|
|
306
|
+
into.unreconciled +=
|
|
307
|
+
reachedWas > doors.was.appearances || reachedNow > doors.now.appearances ? 1 : 0;
|
|
308
|
+
};
|
|
309
|
+
/** The pages of one window, keyed by form, with each page's door already worked out. */
|
|
310
|
+
export const librarySideOf = (window) => {
|
|
311
|
+
const pages = pairedWindowOf(window.readings);
|
|
312
|
+
const scaled = new Map([...pages.byForm].map(([form, reading]) => [
|
|
313
|
+
form,
|
|
314
|
+
scaledPageOf(reading, window.rows),
|
|
315
|
+
]));
|
|
316
|
+
return {
|
|
317
|
+
pages,
|
|
318
|
+
scaled,
|
|
319
|
+
duplicatedRows: [...scaled.values()].reduce((sum, of) => sum + of.duplicatedRows, 0),
|
|
320
|
+
};
|
|
321
|
+
};
|
|
322
|
+
/**
|
|
323
|
+
* Of the readers who met a kind of part, the share that read it — before and
|
|
324
|
+
* after.
|
|
325
|
+
*
|
|
326
|
+
* Takes each window as its readings and the whole window of door rows a
|
|
327
|
+
* deployment holds for it, because the figure needs the door on both sides: the
|
|
328
|
+
* pages are paired by 0266's rule and each side's terms are put on its own
|
|
329
|
+
* door's scale by 0256's.
|
|
330
|
+
*
|
|
331
|
+
* The labels are the caller's. Two readings of one window and one library come
|
|
332
|
+
* back as every place held, every share identical and nothing gained or lost; a
|
|
333
|
+
* caller who holds the two sides backwards gets a comparison with every movement
|
|
334
|
+
* reversed rather than a refusal, exactly as a before-and-after reading of one
|
|
335
|
+
* page does.
|
|
336
|
+
*
|
|
337
|
+
* Linear in the parts of the readings times the rows, with one pass per window
|
|
338
|
+
* that fills both groupings.
|
|
339
|
+
*/
|
|
340
|
+
export const libraryReachChangeOf = (was, now) => {
|
|
341
|
+
const earlier = librarySideOf(was);
|
|
342
|
+
const later = librarySideOf(now);
|
|
343
|
+
const rows = new Map();
|
|
344
|
+
const roleWas = new Map();
|
|
345
|
+
const roleNow = new Map();
|
|
346
|
+
const ambiguous = new Map([...earlier.pages.ambiguous, ...later.pages.ambiguous]);
|
|
347
|
+
const unscaled = [];
|
|
348
|
+
let pages = 0;
|
|
349
|
+
let pagesGained = 0;
|
|
350
|
+
let pagesLost = 0;
|
|
351
|
+
let formsGained = 0;
|
|
352
|
+
let formsLost = 0;
|
|
353
|
+
let republished = 0;
|
|
354
|
+
let placements = 0;
|
|
355
|
+
let gained = 0;
|
|
356
|
+
let lost = 0;
|
|
357
|
+
let recast = 0;
|
|
358
|
+
let arrivalsWas = 0;
|
|
359
|
+
let arrivalsNow = 0;
|
|
360
|
+
let scaled = 0;
|
|
361
|
+
/**
|
|
362
|
+
* Every role in the vocabulary gets a row whether or not anything plays it, as
|
|
363
|
+
* a census's role rows do: a role nothing in the library plays is a fact about
|
|
364
|
+
* the library, and a surface that had to tell a missing row from an empty one
|
|
365
|
+
* would be reading the vocabulary itself.
|
|
366
|
+
*/
|
|
367
|
+
for (const role of [...PRIMITIVE_ROLES, null])
|
|
368
|
+
rowFor(rows, { by: "role", role });
|
|
369
|
+
for (const [form, reading] of earlier.pages.byForm) {
|
|
370
|
+
if (ambiguous.has(form))
|
|
371
|
+
continue;
|
|
372
|
+
for (const part of reading.parts) {
|
|
373
|
+
roleWas.set(part.type, part.role);
|
|
374
|
+
rowFor(rows, { by: "type", type: part.type }).role = part.role;
|
|
375
|
+
}
|
|
376
|
+
if (later.pages.byForm.has(form))
|
|
377
|
+
continue;
|
|
378
|
+
pagesLost += 1;
|
|
379
|
+
/** The page is still served, in the other form: a form left the library and the page did not (0295). */
|
|
380
|
+
if (later.pages.pagesHeld.has(reading.treeId))
|
|
381
|
+
formsLost += 1;
|
|
382
|
+
for (const part of reading.parts) {
|
|
383
|
+
lost += 1;
|
|
384
|
+
for (const kind of keysOf(part))
|
|
385
|
+
rowFor(rows, kind).lost += 1;
|
|
386
|
+
}
|
|
387
|
+
}
|
|
388
|
+
for (const [form, reading] of later.pages.byForm) {
|
|
389
|
+
if (ambiguous.has(form))
|
|
390
|
+
continue;
|
|
391
|
+
for (const part of reading.parts) {
|
|
392
|
+
roleNow.set(part.type, part.role);
|
|
393
|
+
rowFor(rows, { by: "type", type: part.type }).role = part.role;
|
|
394
|
+
}
|
|
395
|
+
if (earlier.pages.byForm.has(form))
|
|
396
|
+
continue;
|
|
397
|
+
pagesGained += 1;
|
|
398
|
+
/** The page was already served, in the other form: a second form began rather than a page being published. */
|
|
399
|
+
if (earlier.pages.pagesHeld.has(reading.treeId))
|
|
400
|
+
formsGained += 1;
|
|
401
|
+
for (const part of reading.parts) {
|
|
402
|
+
gained += 1;
|
|
403
|
+
for (const kind of keysOf(part))
|
|
404
|
+
rowFor(rows, kind).gained += 1;
|
|
405
|
+
}
|
|
406
|
+
}
|
|
407
|
+
for (const [form, before] of earlier.pages.byForm) {
|
|
408
|
+
const after = later.pages.byForm.get(form);
|
|
409
|
+
const doorWas = earlier.scaled.get(form);
|
|
410
|
+
const doorNow = later.scaled.get(form);
|
|
411
|
+
if (after === undefined || doorWas === undefined || doorNow === undefined)
|
|
412
|
+
continue;
|
|
413
|
+
if (ambiguous.has(form))
|
|
414
|
+
continue;
|
|
415
|
+
const beforeParts = partsByNodeIn(before);
|
|
416
|
+
const afterParts = partsByNodeIn(after);
|
|
417
|
+
const doors = { was: doorWas.door, now: doorNow.door };
|
|
418
|
+
pages += 1;
|
|
419
|
+
republished += before.revision === after.revision ? 0 : 1;
|
|
420
|
+
arrivalsWas += doors.was.opened;
|
|
421
|
+
arrivalsNow += doors.now.opened;
|
|
422
|
+
if (doors.was.silence === null && doors.now.silence === null)
|
|
423
|
+
scaled += 1;
|
|
424
|
+
/**
|
|
425
|
+
* A page the door cannot scale is listed once per side it is unscalable on,
|
|
426
|
+
* and only where a window could speak for something on it: a page nobody
|
|
427
|
+
* read in either window is not a page whose readers could not be counted,
|
|
428
|
+
* and listing it would put the commonest healthy state on the one list here
|
|
429
|
+
* that is meant to be empty.
|
|
430
|
+
*/
|
|
431
|
+
const spoken = before.parts.some((part) => {
|
|
432
|
+
const counterpart = afterParts.get(part.nodeId);
|
|
433
|
+
return (spokenFor(part.standing) && counterpart !== undefined && spokenFor(counterpart.standing));
|
|
434
|
+
});
|
|
435
|
+
if (spoken) {
|
|
436
|
+
if (doors.was.silence !== null) {
|
|
437
|
+
unscaled.push({
|
|
438
|
+
treeId: before.treeId,
|
|
439
|
+
revision: before.revision,
|
|
440
|
+
audienceId: before.audienceId,
|
|
441
|
+
against: after.revision,
|
|
442
|
+
side: "was",
|
|
443
|
+
silence: doors.was.silence,
|
|
444
|
+
});
|
|
445
|
+
}
|
|
446
|
+
if (doors.now.silence !== null) {
|
|
447
|
+
unscaled.push({
|
|
448
|
+
treeId: after.treeId,
|
|
449
|
+
revision: after.revision,
|
|
450
|
+
audienceId: after.audienceId,
|
|
451
|
+
against: before.revision,
|
|
452
|
+
side: "now",
|
|
453
|
+
silence: doors.now.silence,
|
|
454
|
+
});
|
|
455
|
+
}
|
|
456
|
+
}
|
|
457
|
+
for (const part of before.parts) {
|
|
458
|
+
const counterpart = afterParts.get(part.nodeId);
|
|
459
|
+
if (counterpart === undefined) {
|
|
460
|
+
lost += 1;
|
|
461
|
+
for (const kind of keysOf(part))
|
|
462
|
+
rowFor(rows, kind).lost += 1;
|
|
463
|
+
continue;
|
|
464
|
+
}
|
|
465
|
+
if (part.type === counterpart.type) {
|
|
466
|
+
placements += 1;
|
|
467
|
+
}
|
|
468
|
+
else {
|
|
469
|
+
recast += 1;
|
|
470
|
+
lost += 1;
|
|
471
|
+
gained += 1;
|
|
472
|
+
rowFor(rows, { by: "type", type: part.type }).lost += 1;
|
|
473
|
+
rowFor(rows, { by: "type", type: counterpart.type }).gained += 1;
|
|
474
|
+
}
|
|
475
|
+
if (part.role !== counterpart.role) {
|
|
476
|
+
rowFor(rows, { by: "role", role: part.role }).lost += 1;
|
|
477
|
+
rowFor(rows, { by: "role", role: counterpart.role }).gained += 1;
|
|
478
|
+
}
|
|
479
|
+
/**
|
|
480
|
+
* A placement is paired under a key only where it is of that kind on both
|
|
481
|
+
* sides, which is the places comparison's rule (0266) and where the two
|
|
482
|
+
* keys answer differently: a node recast into another type is a place one
|
|
483
|
+
* type left and another took, while the role rows hold it still wherever
|
|
484
|
+
* the two types play the same part.
|
|
485
|
+
*/
|
|
486
|
+
const sameType = part.type === counterpart.type ? [{ by: "type", type: part.type }] : [];
|
|
487
|
+
const sameRole = part.role === counterpart.role ? [{ by: "role", role: part.role }] : [];
|
|
488
|
+
for (const kind of [...sameType, ...sameRole]) {
|
|
489
|
+
add(rowFor(rows, kind), { was: part, now: counterpart }, doors, form);
|
|
490
|
+
}
|
|
491
|
+
}
|
|
492
|
+
for (const part of after.parts) {
|
|
493
|
+
if (beforeParts.has(part.nodeId))
|
|
494
|
+
continue;
|
|
495
|
+
gained += 1;
|
|
496
|
+
for (const kind of keysOf(part))
|
|
497
|
+
rowFor(rows, kind).gained += 1;
|
|
498
|
+
}
|
|
499
|
+
}
|
|
500
|
+
const built = [...rows.values()].map(rowOf);
|
|
501
|
+
const byType = built.filter((row) => row.kind.by === "type").sort(worseOf);
|
|
502
|
+
const disagreed = [...roleNow.keys()]
|
|
503
|
+
.filter((type) => roleWas.has(type) && roleWas.get(type) !== roleNow.get(type))
|
|
504
|
+
.sort((one, other) => one.localeCompare(other));
|
|
505
|
+
return {
|
|
506
|
+
byType,
|
|
507
|
+
byRole: built.filter((row) => row.kind.by === "role").sort(worseOf),
|
|
508
|
+
pages,
|
|
509
|
+
pagesGained,
|
|
510
|
+
formsGained,
|
|
511
|
+
pagesLost,
|
|
512
|
+
formsLost,
|
|
513
|
+
audiences: { was: earlier.pages.audiences, now: later.pages.audiences },
|
|
514
|
+
republished,
|
|
515
|
+
placements,
|
|
516
|
+
gained,
|
|
517
|
+
lost,
|
|
518
|
+
recast,
|
|
519
|
+
arrivalsWas,
|
|
520
|
+
arrivalsNow,
|
|
521
|
+
scaled,
|
|
522
|
+
unscaled: [...unscaled].sort(bySide),
|
|
523
|
+
mostAbandoned: byType.find((row) => (row.readersMoved ?? 0) < 0) ?? null,
|
|
524
|
+
mostTakenUp: byType
|
|
525
|
+
.filter((row) => (row.readersMoved ?? 0) > 0)
|
|
526
|
+
.sort((one, other) => (other.readersMoved ?? 0) - (one.readersMoved ?? 0) ||
|
|
527
|
+
nameOf(one.kind).localeCompare(nameOf(other.kind)))[0] ?? null,
|
|
528
|
+
ambiguous: [...ambiguous.values()].sort(inFormOrder),
|
|
529
|
+
duplicated: earlier.pages.duplicated + later.pages.duplicated,
|
|
530
|
+
duplicatedRows: earlier.duplicatedRows + later.duplicatedRows,
|
|
531
|
+
roleDisagreed: disagreed,
|
|
532
|
+
};
|
|
533
|
+
};
|
|
534
|
+
//# sourceMappingURL=library-reach-change.js.map
|