@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,346 @@
|
|
|
1
|
+
import { everyMemberOf } from "../closed-set.js";
|
|
2
|
+
import { describeFormPairRefusal, formPairOf, FORM_PAIR_REFUSALS, } from "./audiences.js";
|
|
3
|
+
import { passageSideOf } from "./copy-change.js";
|
|
4
|
+
import { copyReadingOf, passageOf } from "./copy.js";
|
|
5
|
+
import { spokenFor } from "./parts.js";
|
|
6
|
+
/** The closed set, for a surface that has to account for every absent figure. */
|
|
7
|
+
export const FORM_COPY_SILENCES = everyMemberOf()([
|
|
8
|
+
...FORM_PAIR_REFUSALS,
|
|
9
|
+
"wordless",
|
|
10
|
+
"nothing-measured",
|
|
11
|
+
"inconsistent",
|
|
12
|
+
"unshared",
|
|
13
|
+
"unspoken",
|
|
14
|
+
"floored",
|
|
15
|
+
]);
|
|
16
|
+
/** One line per silence, for a surface saying why a figure is not there. */
|
|
17
|
+
export const describeFormCopySilence = (silence) => {
|
|
18
|
+
switch (silence) {
|
|
19
|
+
case "wordless":
|
|
20
|
+
return "neither form says anything that could be read";
|
|
21
|
+
case "nothing-measured":
|
|
22
|
+
return "one of the two windows held no page views";
|
|
23
|
+
case "inconsistent":
|
|
24
|
+
return "a passage reports more readers than its form has views, which no rollup produces";
|
|
25
|
+
case "unshared":
|
|
26
|
+
return "the two forms say no passage the same way, so there is no shared text to compare";
|
|
27
|
+
case "unspoken":
|
|
28
|
+
return "no shared word of the page can be spoken for in both windows";
|
|
29
|
+
case "floored":
|
|
30
|
+
return "some shared passage declares no copy, so a page-wide mean of its words would not be a ceiling";
|
|
31
|
+
default:
|
|
32
|
+
return describeFormPairRefusal(silence);
|
|
33
|
+
}
|
|
34
|
+
};
|
|
35
|
+
const ZERO_BY_STANDING = Object.freeze({
|
|
36
|
+
read: 0,
|
|
37
|
+
skipped: 0,
|
|
38
|
+
unknown: 0,
|
|
39
|
+
});
|
|
40
|
+
const NOTHING_COUNTED = Object.freeze({
|
|
41
|
+
one: 0,
|
|
42
|
+
other: 0,
|
|
43
|
+
alike: 0,
|
|
44
|
+
unknown: 0,
|
|
45
|
+
});
|
|
46
|
+
const NOTHING_SAID = Object.freeze({
|
|
47
|
+
shared: 0,
|
|
48
|
+
only: Object.freeze({ one: 0, other: 0 }),
|
|
49
|
+
onlyByStanding: Object.freeze({ one: ZERO_BY_STANDING, other: ZERO_BY_STANDING }),
|
|
50
|
+
reworded: Object.freeze({ one: 0, other: 0 }),
|
|
51
|
+
});
|
|
52
|
+
const sideOf = (reading, audienceId) => ({
|
|
53
|
+
treeId: reading.treeId,
|
|
54
|
+
revision: reading.revision,
|
|
55
|
+
audienceId,
|
|
56
|
+
views: reading.views,
|
|
57
|
+
words: reading.words,
|
|
58
|
+
passages: reading.passages.length,
|
|
59
|
+
spoken: reading.spoken,
|
|
60
|
+
});
|
|
61
|
+
/**
|
|
62
|
+
* Whether two passages say the same thing, in order.
|
|
63
|
+
*
|
|
64
|
+
* The visible words, which is what every figure here divides by. A part may be
|
|
65
|
+
* floored in one form and not the other while these agree — a prop no type
|
|
66
|
+
* declares holding something for one audience and nothing for the next — and
|
|
67
|
+
* that is what {@link ComparedFormPassage.floored} carries rather than a third
|
|
68
|
+
* category.
|
|
69
|
+
*/
|
|
70
|
+
const sameText = (one, other) => one.length === other.length && one.every((value, at) => value === other[at]);
|
|
71
|
+
/**
|
|
72
|
+
* Whether a passage is worth a row at all.
|
|
73
|
+
*
|
|
74
|
+
* The rule `copyReadingOf` applies to one side, applied to the pair: a part
|
|
75
|
+
* that says nothing in either form and is hiding nothing in either form has no
|
|
76
|
+
* words for this module to be about. A floored part is kept because *this may
|
|
77
|
+
* say something nothing here can see* is not *this says nothing* (0122).
|
|
78
|
+
*/
|
|
79
|
+
const saysSomething = (sides) => sides.some((passage) => passage.words > 0 || passage.floored);
|
|
80
|
+
/**
|
|
81
|
+
* The gap, and the rule that withholds it.
|
|
82
|
+
*
|
|
83
|
+
* Both sides have to be spoken for before a difference between them is a
|
|
84
|
+
* difference between two populations rather than between a measurement and a
|
|
85
|
+
* missing row (0282) — which is `formComparisonOf`'s own check, needed here for
|
|
86
|
+
* the same reason it is needed there: a passage's standing and its reach are two
|
|
87
|
+
* fields, where `PartAction.share` is absent in exactly the states its standing
|
|
88
|
+
* calls unknown and so needs one check (0303, 0304).
|
|
89
|
+
*/
|
|
90
|
+
const gapOf = (words, one, other) => one.reach === null ||
|
|
91
|
+
other.reach === null ||
|
|
92
|
+
!spokenFor(one.standing) ||
|
|
93
|
+
!spokenFor(other.standing)
|
|
94
|
+
? null
|
|
95
|
+
: words * Math.abs(one.reach - other.reach);
|
|
96
|
+
/**
|
|
97
|
+
* The form with the larger of two figures, or `null` where the two are equal.
|
|
98
|
+
*
|
|
99
|
+
* Spelled once because this reading points at a form four times — a passage's
|
|
100
|
+
* readers, a passage's words, the page's readers and the page's own census —
|
|
101
|
+
* and four spellings of *larger* is four chances to read the pair backwards.
|
|
102
|
+
*/
|
|
103
|
+
const favouring = (one, other, forms) => {
|
|
104
|
+
if (one === other)
|
|
105
|
+
return null;
|
|
106
|
+
return one > other ? forms.one : forms.other;
|
|
107
|
+
};
|
|
108
|
+
/**
|
|
109
|
+
* The form whose readers reached a passage more often.
|
|
110
|
+
*
|
|
111
|
+
* Off the two reaches and not off the gap, for the reason
|
|
112
|
+
* {@link ComparedFormPassage.favours} gives: a floored passage of no visible
|
|
113
|
+
* words has a gap of nought and a direction that is still a measurement.
|
|
114
|
+
*/
|
|
115
|
+
const favouredBy = (gap, one, other, forms) => gap === null ? null : favouring(one.reach ?? 0, other.reach ?? 0, forms);
|
|
116
|
+
/**
|
|
117
|
+
* Which column of the census a shared passage falls in, spelled once because it
|
|
118
|
+
* is counted twice — over passages and over the words they say.
|
|
119
|
+
*/
|
|
120
|
+
const fallOf = (gap, favours, forms) => {
|
|
121
|
+
if (gap === null)
|
|
122
|
+
return "unknown";
|
|
123
|
+
if (favours === null)
|
|
124
|
+
return "alike";
|
|
125
|
+
return favours === forms.one ? "one" : "other";
|
|
126
|
+
};
|
|
127
|
+
/**
|
|
128
|
+
* Every part of a reading as a passage, keyed by node.
|
|
129
|
+
*
|
|
130
|
+
* Over **every** part rather than over the reading's own passages, because a
|
|
131
|
+
* part one form's deltas emptied is a node both forms have and word a form
|
|
132
|
+
* stopped saying — and a filtered map would call it a part only one form has.
|
|
133
|
+
*/
|
|
134
|
+
const passagesOf = (reading) => new Map(reading.parts.map((part) => [part.nodeId, passageOf(part)]));
|
|
135
|
+
/** A word total over anything carrying one, which is a passage or a row about one. */
|
|
136
|
+
const wordsOf = (counted) => counted.reduce((total, each) => total + each.words, 0);
|
|
137
|
+
const wordsByStandingOf = (passages) => passages.reduce((counted, passage) => ({
|
|
138
|
+
...counted,
|
|
139
|
+
[passage.standing]: counted[passage.standing] + passage.words,
|
|
140
|
+
}), { ...ZERO_BY_STANDING });
|
|
141
|
+
/** Descending by words, strictly, so equal passages keep the order they arrived in. */
|
|
142
|
+
const byWordsUnseen = (one, other) => other.words - one.words;
|
|
143
|
+
/**
|
|
144
|
+
* Why there is no reader figure, in the order a pair is in more than one of
|
|
145
|
+
* these.
|
|
146
|
+
*
|
|
147
|
+
* Four of the five orderings are reachable by a single pair and each has a
|
|
148
|
+
* fixture: a wordless page in an empty window, an empty window whose standings
|
|
149
|
+
* are all unknown, an unshared pair with no spoken-for shared word, and a
|
|
150
|
+
* floored passage nothing can speak for. The rule throughout is the one 0282
|
|
151
|
+
* settled: the state with a remedy a deployment holds is named before the state
|
|
152
|
+
* that is a consequence of it.
|
|
153
|
+
*/
|
|
154
|
+
const silenceOf = (words, readings, shared, spoken, floored) => {
|
|
155
|
+
if (words.one === 0 && words.other === 0)
|
|
156
|
+
return "wordless";
|
|
157
|
+
if (readings.one.views === 0 || readings.other.views === 0)
|
|
158
|
+
return "nothing-measured";
|
|
159
|
+
if (readings.one.silence === "inconsistent" || readings.other.silence === "inconsistent") {
|
|
160
|
+
return "inconsistent";
|
|
161
|
+
}
|
|
162
|
+
if (shared === 0)
|
|
163
|
+
return "unshared";
|
|
164
|
+
if (spoken === 0)
|
|
165
|
+
return "unspoken";
|
|
166
|
+
return floored > 0 ? "floored" : null;
|
|
167
|
+
};
|
|
168
|
+
/**
|
|
169
|
+
* Hold what two forms of one page say, and the reading of what they share,
|
|
170
|
+
* against each other.
|
|
171
|
+
*
|
|
172
|
+
* Takes two page readings, each of one audience, of one tree at one revision,
|
|
173
|
+
* and derives a copy reading of each — handed two readings rather than two
|
|
174
|
+
* finished `CopyReading`s for the reason `copyChangeOf` is: one input per side
|
|
175
|
+
* cannot be a mismatched pair, the census needs the parts a copy reading leaves
|
|
176
|
+
* out, and the two it derives travel on the comparison so nothing downstream
|
|
177
|
+
* pays for them twice.
|
|
178
|
+
*
|
|
179
|
+
* The labels are not `was` and `now` and the order of the arguments does not
|
|
180
|
+
* reach the answer: see `formPairOf`, and {@link FormCopySilence} for the eleven
|
|
181
|
+
* states in which there is no figure.
|
|
182
|
+
*/
|
|
183
|
+
export const formCopyComparisonOf = (one, other) => {
|
|
184
|
+
const pair = formPairOf(one, other);
|
|
185
|
+
const readings = { one: copyReadingOf(pair.one), other: copyReadingOf(pair.other) };
|
|
186
|
+
if (pair.pairing === "refused")
|
|
187
|
+
return {
|
|
188
|
+
one: sideOf(readings.one, pair.one.audienceId),
|
|
189
|
+
other: sideOf(readings.other, pair.other.audienceId),
|
|
190
|
+
readings,
|
|
191
|
+
says: NOTHING_SAID,
|
|
192
|
+
compared: [],
|
|
193
|
+
reworded: [],
|
|
194
|
+
onlyIn: [],
|
|
195
|
+
disagreed: [],
|
|
196
|
+
counted: NOTHING_COUNTED,
|
|
197
|
+
wordsCounted: NOTHING_COUNTED,
|
|
198
|
+
floored: 0,
|
|
199
|
+
unseenByEither: [],
|
|
200
|
+
typical: null,
|
|
201
|
+
sharpest: null,
|
|
202
|
+
silence: pair.refusal,
|
|
203
|
+
};
|
|
204
|
+
const audiences = pair.audiences;
|
|
205
|
+
const held = { one: passagesOf(pair.one), other: passagesOf(pair.other) };
|
|
206
|
+
const views = { one: pair.one.views, other: pair.other.views };
|
|
207
|
+
const compared = [];
|
|
208
|
+
const reworded = [];
|
|
209
|
+
const onlyIn = [];
|
|
210
|
+
const disagreed = [];
|
|
211
|
+
const only = { one: [], other: [] };
|
|
212
|
+
const counted = { ...NOTHING_COUNTED };
|
|
213
|
+
const wordsCounted = { ...NOTHING_COUNTED };
|
|
214
|
+
for (const [nodeId, passage] of held.one) {
|
|
215
|
+
const across = held.other.get(nodeId);
|
|
216
|
+
if (across === undefined) {
|
|
217
|
+
if (!saysSomething([passage]))
|
|
218
|
+
continue;
|
|
219
|
+
only.one.push(passage);
|
|
220
|
+
onlyIn.push({
|
|
221
|
+
nodeId,
|
|
222
|
+
type: passage.type,
|
|
223
|
+
role: passage.role,
|
|
224
|
+
audienceId: audiences.one,
|
|
225
|
+
passage,
|
|
226
|
+
side: passageSideOf(passage, views.one),
|
|
227
|
+
});
|
|
228
|
+
continue;
|
|
229
|
+
}
|
|
230
|
+
if (!saysSomething([passage, across]))
|
|
231
|
+
continue;
|
|
232
|
+
if (across.type !== passage.type)
|
|
233
|
+
disagreed.push(nodeId);
|
|
234
|
+
const shared = {
|
|
235
|
+
nodeId,
|
|
236
|
+
type: passage.type,
|
|
237
|
+
role: passage.role,
|
|
238
|
+
floored: passage.floored || across.floored,
|
|
239
|
+
one: passageSideOf(passage, views.one),
|
|
240
|
+
other: passageSideOf(across, views.other),
|
|
241
|
+
};
|
|
242
|
+
if (!sameText(passage.text, across.text)) {
|
|
243
|
+
const words = { one: passage.words, other: across.words };
|
|
244
|
+
reworded.push({
|
|
245
|
+
...shared,
|
|
246
|
+
words,
|
|
247
|
+
wordier: favouring(words.one, words.other, audiences),
|
|
248
|
+
});
|
|
249
|
+
continue;
|
|
250
|
+
}
|
|
251
|
+
const gap = gapOf(passage.words, shared.one, shared.other);
|
|
252
|
+
const favours = favouredBy(gap, shared.one, shared.other, audiences);
|
|
253
|
+
const fall = fallOf(gap, favours, audiences);
|
|
254
|
+
counted[fall] += 1;
|
|
255
|
+
wordsCounted[fall] += passage.words;
|
|
256
|
+
compared.push({ ...shared, words: passage.words, text: passage.text, favours, gap });
|
|
257
|
+
}
|
|
258
|
+
for (const [nodeId, passage] of held.other) {
|
|
259
|
+
if (held.one.has(nodeId))
|
|
260
|
+
continue;
|
|
261
|
+
if (!saysSomething([passage]))
|
|
262
|
+
continue;
|
|
263
|
+
only.other.push(passage);
|
|
264
|
+
onlyIn.push({
|
|
265
|
+
nodeId,
|
|
266
|
+
type: passage.type,
|
|
267
|
+
role: passage.role,
|
|
268
|
+
audienceId: audiences.other,
|
|
269
|
+
passage,
|
|
270
|
+
side: passageSideOf(passage, views.other),
|
|
271
|
+
});
|
|
272
|
+
}
|
|
273
|
+
const says = {
|
|
274
|
+
shared: wordsOf(compared),
|
|
275
|
+
only: { one: wordsOf(only.one), other: wordsOf(only.other) },
|
|
276
|
+
onlyByStanding: {
|
|
277
|
+
one: wordsByStandingOf(only.one),
|
|
278
|
+
other: wordsByStandingOf(only.other),
|
|
279
|
+
},
|
|
280
|
+
reworded: {
|
|
281
|
+
one: reworded.reduce((total, passage) => total + passage.words.one, 0),
|
|
282
|
+
other: reworded.reduce((total, passage) => total + passage.words.other, 0),
|
|
283
|
+
},
|
|
284
|
+
};
|
|
285
|
+
/**
|
|
286
|
+
* The shared passages both windows can speak for, which the page figures are
|
|
287
|
+
* taken over.
|
|
288
|
+
*
|
|
289
|
+
* One set and therefore the same set on both sides, which is the property
|
|
290
|
+
* that makes the two means comparable: a passage counted for one form and
|
|
291
|
+
* dropped for the other would read as a difference between two populations
|
|
292
|
+
* that is a difference between two sets of words.
|
|
293
|
+
*/
|
|
294
|
+
const spoken = compared.filter((passage) => passage.gap !== null);
|
|
295
|
+
const floored = compared.filter((passage) => passage.floored).length;
|
|
296
|
+
const silence = silenceOf({ one: readings.one.words, other: readings.other.words }, readings, says.shared, wordsOf(spoken), floored);
|
|
297
|
+
/**
|
|
298
|
+
* Each form's own mean over the shared spoken-for passages, guarded by the
|
|
299
|
+
* silence rather than clamped: a figure held back with a stated cause is one
|
|
300
|
+
* somebody can act on, and one quietly cut to fit its own ceiling is not
|
|
301
|
+
* (0235).
|
|
302
|
+
*/
|
|
303
|
+
const typicalOf = () => {
|
|
304
|
+
const words = {
|
|
305
|
+
one: spoken.reduce((total, passage) => total + passage.one.readers * passage.words, 0) /
|
|
306
|
+
views.one,
|
|
307
|
+
other: spoken.reduce((total, passage) => total + passage.other.readers * passage.words, 0) /
|
|
308
|
+
views.other,
|
|
309
|
+
};
|
|
310
|
+
return {
|
|
311
|
+
...words,
|
|
312
|
+
gap: Math.abs(words.one - words.other),
|
|
313
|
+
favours: favouring(words.one, words.other, audiences),
|
|
314
|
+
};
|
|
315
|
+
};
|
|
316
|
+
return {
|
|
317
|
+
one: sideOf(readings.one, audiences.one),
|
|
318
|
+
other: sideOf(readings.other, audiences.other),
|
|
319
|
+
readings,
|
|
320
|
+
says,
|
|
321
|
+
compared,
|
|
322
|
+
reworded,
|
|
323
|
+
onlyIn: [...onlyIn].sort((a, b) => a.audienceId.localeCompare(b.audienceId) || a.nodeId.localeCompare(b.nodeId)),
|
|
324
|
+
disagreed: [...disagreed].sort((a, b) => a.localeCompare(b)),
|
|
325
|
+
counted,
|
|
326
|
+
wordsCounted,
|
|
327
|
+
floored,
|
|
328
|
+
unseenByEither: compared
|
|
329
|
+
.filter((passage) => passage.one.standing === "skipped" && passage.other.standing === "skipped")
|
|
330
|
+
.sort(byWordsUnseen),
|
|
331
|
+
typical: silence === null ? typicalOf() : null,
|
|
332
|
+
sharpest: compared.reduce((widest, passage) => {
|
|
333
|
+
if (passage.gap === null)
|
|
334
|
+
return widest;
|
|
335
|
+
if (widest === null || widest.gap === null)
|
|
336
|
+
return passage;
|
|
337
|
+
if (passage.gap > widest.gap)
|
|
338
|
+
return passage;
|
|
339
|
+
return passage.gap === widest.gap && passage.nodeId.localeCompare(widest.nodeId) < 0
|
|
340
|
+
? passage
|
|
341
|
+
: widest;
|
|
342
|
+
}, null),
|
|
343
|
+
silence,
|
|
344
|
+
};
|
|
345
|
+
};
|
|
346
|
+
//# sourceMappingURL=form-copy.js.map
|
|
@@ -0,0 +1,247 @@
|
|
|
1
|
+
import type { AudienceId } from "../audience/audience.js";
|
|
2
|
+
import type { NodeId, TreeId } from "../ids.js";
|
|
3
|
+
import type { PrimitiveType } from "../primitive-type.js";
|
|
4
|
+
import type { PrimitiveRole } from "../role.js";
|
|
5
|
+
import { type FormPairRefusal } from "./audiences.js";
|
|
6
|
+
import { type PageReading, type PartStanding } from "./parts.js";
|
|
7
|
+
/**
|
|
8
|
+
* Two forms of one page, side by side.
|
|
9
|
+
*
|
|
10
|
+
* A page is one base tree plus the deltas an audience earns
|
|
11
|
+
* ([0263](../../decisions/0263-a-page-is-a-base-tree-and-the-deltas-an-audience-earns.md)),
|
|
12
|
+
* so a deployment serving two audiences serves two forms of one tree at one
|
|
13
|
+
* revision, told apart by a column and nothing else
|
|
14
|
+
* ([0284](../../decisions/0284-a-signal-names-the-audience-it-was-collected-under-and-the-predicate-stays-in-the-control-plane.md)).
|
|
15
|
+
* Every comparison in this subsystem until now varies the **tree** and holds the
|
|
16
|
+
* readership still. This one does the opposite: it holds the tree and the
|
|
17
|
+
* revision still and varies the readership, which is the question a deployment
|
|
18
|
+
* that earned a second form actually has. *Do the riders read this page the way
|
|
19
|
+
* the skiers do, and does each of them get the same page at all?*
|
|
20
|
+
*
|
|
21
|
+
* `docs/signals.md` §36 named it and did not build it, with the instruction
|
|
22
|
+
* that matters most here: **it must not borrow `changeOf`.** That reading's
|
|
23
|
+
* arithmetic would run and its sentence — *this is what your change did* —
|
|
24
|
+
* would be false of every figure, because nothing changed. The two readings
|
|
25
|
+
* are of one revision.
|
|
26
|
+
*
|
|
27
|
+
* Nothing is collected for it. Two readings go in and a comparison comes out,
|
|
28
|
+
* which makes it the thirty-third thing taken out of the server-side join
|
|
29
|
+
* rather than added to a payload, a browser, a column or the vocabulary of
|
|
30
|
+
* kinds.
|
|
31
|
+
*
|
|
32
|
+
* ## Neither side is earlier, so the order is not the caller's to set
|
|
33
|
+
*
|
|
34
|
+
* `formPairOf` settles which side is {@link FormComparison.one} and refuses the
|
|
35
|
+
* five pairs that are not two forms of one page. The rule and its reasons are
|
|
36
|
+
* published there, with the five refusals, because they are facts about the
|
|
37
|
+
* **pair** rather than about the counter this reading compares — and a second
|
|
38
|
+
* comparison of two forms (0303) wants every one of them with no clause
|
|
39
|
+
* changed. What stays here is the consequence: the answer is the same whichever
|
|
40
|
+
* way round it is asked, which is asserted rather than described.
|
|
41
|
+
*
|
|
42
|
+
* ## The figure that is comparable across two populations
|
|
43
|
+
*
|
|
44
|
+
* A `reached` count is not: two forms are served to two sets of people, so one
|
|
45
|
+
* form reporting more readers is very often one form having more readers.
|
|
46
|
+
* **A share of a side's own views is**, by the argument 0221 gives for a stop
|
|
47
|
+
* and 0224 for two revisions, applied here to a part across two populations:
|
|
48
|
+
* {@link FormPartSide.reach} is `readers ÷ views` off one side's own rows, so
|
|
49
|
+
* each side's straddle over-count
|
|
50
|
+
* ([0147](../../decisions/0147-a-rollup-is-added-to-what-is-stored-and-a-distinct-view-count-is-therefore-approximate.md))
|
|
51
|
+
* has very nearly divided out before the two sides meet.
|
|
52
|
+
*
|
|
53
|
+
* ## What a difference here cannot be attributed to, and the census that says so
|
|
54
|
+
*
|
|
55
|
+
* **A difference between two forms has two causes and nothing in the counters
|
|
56
|
+
* separates them.** The deltas changed what is on the page *and* the people
|
|
57
|
+
* reading it are different, both by construction. §20 exists so that a
|
|
58
|
+
* before-and-after can report when its readership moved; here that confounder
|
|
59
|
+
* is permanently true and is not a fault to be detected. It is the shape of the
|
|
60
|
+
* question.
|
|
61
|
+
*
|
|
62
|
+
* So this reading states the content half rather than estimating it.
|
|
63
|
+
* {@link FormComparison.onlyIn} is every part exactly one of the two forms has,
|
|
64
|
+
* which is what the deltas did made visible, and
|
|
65
|
+
* {@link FormComparison.disagreed} is every shared node the two forms give
|
|
66
|
+
* different primitive types — the sharper version of the same fact. What is
|
|
67
|
+
* left after both of those is a part both forms really have, where the only
|
|
68
|
+
* remaining difference is the readers. That is the comparison, and the honest
|
|
69
|
+
* sentence over it is *the skiers reach this band more often than the riders
|
|
70
|
+
* do* and never *this band reads better*.
|
|
71
|
+
*
|
|
72
|
+
* ## What it refuses to add up
|
|
73
|
+
*
|
|
74
|
+
* There is no page-level figure for *which form reads better*, and the absence
|
|
75
|
+
* is deliberate for two reasons that both have to be answered and neither is.
|
|
76
|
+
* A reader who reached the second band and the third is in both parts' figures,
|
|
77
|
+
* so a mean over parts counts one reader as many times as they got through —
|
|
78
|
+
* the distinctness trap 0147 wrote down for views and
|
|
79
|
+
* [0167](../../decisions/0167-a-delegated-signal-names-the-regions-it-happened-inside.md)
|
|
80
|
+
* for presses. And the two forms do not have the same parts, so a mean over
|
|
81
|
+
* each side's own parts has two denominators that are not the same page.
|
|
82
|
+
* {@link FormComparison.counted} is the count of parts falling each way, which
|
|
83
|
+
* is a figure over one shared set and needs no mean, and
|
|
84
|
+
* {@link FormComparison.sharpest} is the one row somebody would act on.
|
|
85
|
+
*
|
|
86
|
+
* Pure, linear in the parts of the two readings, and reaches no store, clock or
|
|
87
|
+
* DOM. A caller checks {@link PageReading.orphaned} on both readings before
|
|
88
|
+
* trusting either, exactly as it must before trusting either on its own.
|
|
89
|
+
*/
|
|
90
|
+
/** Why a comparison of two forms answered nothing, or answered less than all of it. */
|
|
91
|
+
export type FormComparisonSilence =
|
|
92
|
+
/**
|
|
93
|
+
* The five states in which two readings are not two forms of one page, taken
|
|
94
|
+
* whole from {@link FormPairRefusal}.
|
|
95
|
+
*
|
|
96
|
+
* They were written here first and moved once a second comparison of two
|
|
97
|
+
* forms wanted every one of them unchanged: each is a fact about the pair
|
|
98
|
+
* rather than about the counter being compared, so the rule belongs where
|
|
99
|
+
* both readings can import it instead of where one of them can be copied
|
|
100
|
+
* from.
|
|
101
|
+
*/
|
|
102
|
+
FormPairRefusal
|
|
103
|
+
/**
|
|
104
|
+
* One of the two windows held no page views.
|
|
105
|
+
*
|
|
106
|
+
* **The one member here that is not a refusal**, and it is spelled as
|
|
107
|
+
* `CopyChangeSilence.nothing-measured` is for the same reason: the parts
|
|
108
|
+
* census is a fact about the two composed trees and stays true of a window
|
|
109
|
+
* nobody read. *The pro form of this page has three bands the free form does
|
|
110
|
+
* not, and nothing has been measured on either* is a sentence worth printing.
|
|
111
|
+
* Every per-part reach on that side is `null`, so every
|
|
112
|
+
* {@link ComparedForm.gap} is withheld and nothing falls either way.
|
|
113
|
+
*/
|
|
114
|
+
| "nothing-measured";
|
|
115
|
+
/** The closed set, for a surface that has to account for every absent figure. */
|
|
116
|
+
export declare const FORM_COMPARISON_SILENCES: readonly FormComparisonSilence[];
|
|
117
|
+
/** One line per silence, for a surface saying why a figure is not there. */
|
|
118
|
+
export declare const describeFormComparisonSilence: (silence: FormComparisonSilence) => string;
|
|
119
|
+
/** One side of the comparison, as the window it was read from leaves it. */
|
|
120
|
+
export type FormSide = {
|
|
121
|
+
readonly treeId: TreeId;
|
|
122
|
+
readonly revision: number;
|
|
123
|
+
/** `null` where the window named none, or named two with neither asked for. */
|
|
124
|
+
readonly audienceId: AudienceId | null;
|
|
125
|
+
/**
|
|
126
|
+
* That side's page-view floor, which is the denominator of every reach below.
|
|
127
|
+
*
|
|
128
|
+
* A floor rather than a count, for the reason `parts.ts` gives: distinct view
|
|
129
|
+
* counts cannot be added across rows (0147), so the largest row is the most
|
|
130
|
+
* that can be said from counters alone.
|
|
131
|
+
*/
|
|
132
|
+
readonly views: number;
|
|
133
|
+
/** Element nodes this form has, which two forms of one page need not share. */
|
|
134
|
+
readonly parts: number;
|
|
135
|
+
};
|
|
136
|
+
/** What one side's window says about one part of it. */
|
|
137
|
+
export type FormPartSide = {
|
|
138
|
+
readonly standing: PartStanding;
|
|
139
|
+
/** Distinct page views of this form that reported the part coming into view. */
|
|
140
|
+
readonly readers: number;
|
|
141
|
+
/** That side's own view floor, carried so the share below can be checked. */
|
|
142
|
+
readonly views: number;
|
|
143
|
+
/**
|
|
144
|
+
* {@link FormPartSide.readers} over {@link FormPartSide.views}, or `null`
|
|
145
|
+
* where that window held none.
|
|
146
|
+
*
|
|
147
|
+
* A ceiling on the share of that form's readers who reached the part:
|
|
148
|
+
* `reached` leans up by the views that straddled a rollup window (0147) and
|
|
149
|
+
* `views` leans down by being a floor, and the same lean is in both terms of
|
|
150
|
+
* each side. Above 1 is not clamped — a figure cut to fit its own ceiling is a
|
|
151
|
+
* fault made undrawable rather than visible.
|
|
152
|
+
*/
|
|
153
|
+
readonly reach: number | null;
|
|
154
|
+
};
|
|
155
|
+
/** A part exactly one of the two forms has, with the form that has it named. */
|
|
156
|
+
export type PartOfForm = {
|
|
157
|
+
readonly nodeId: NodeId;
|
|
158
|
+
readonly type: PrimitiveType;
|
|
159
|
+
readonly role: PrimitiveRole | null;
|
|
160
|
+
/** The form this part is in. The other form does not have this node at all. */
|
|
161
|
+
readonly audienceId: AudienceId;
|
|
162
|
+
readonly side: FormPartSide;
|
|
163
|
+
};
|
|
164
|
+
/** A part both forms have, read by each form's own readers. */
|
|
165
|
+
export type ComparedForm = {
|
|
166
|
+
readonly nodeId: NodeId;
|
|
167
|
+
/** The type {@link FormComparison.one} gives it; `disagreed` names the pair if the other differs. */
|
|
168
|
+
readonly type: PrimitiveType;
|
|
169
|
+
readonly role: PrimitiveRole | null;
|
|
170
|
+
readonly one: FormPartSide;
|
|
171
|
+
readonly other: FormPartSide;
|
|
172
|
+
/**
|
|
173
|
+
* The form whose readers reached it more often, or `null` where no claim
|
|
174
|
+
* stands.
|
|
175
|
+
*
|
|
176
|
+
* `null` with a {@link ComparedForm.gap} of nought is the two forms reaching
|
|
177
|
+
* it alike; `null` with a `gap` of `null` is nothing being sayable. The two
|
|
178
|
+
* are a long way apart and are deliberately not one value.
|
|
179
|
+
*/
|
|
180
|
+
readonly favours: AudienceId | null;
|
|
181
|
+
/**
|
|
182
|
+
* The distance between the two reaches, which is never signed.
|
|
183
|
+
*
|
|
184
|
+
* `|one.reach − other.reach|`, with the direction in
|
|
185
|
+
* {@link ComparedForm.favours} rather than in the sign — because a sign is
|
|
186
|
+
* read against an order, and the order here is the alphabet of two audience
|
|
187
|
+
* names and means nothing.
|
|
188
|
+
*
|
|
189
|
+
* `null` where either side held no views **or** either side's standing is
|
|
190
|
+
* `unknown` (0282): a reach of nought that is a missing counter is not a
|
|
191
|
+
* reader who did not arrive, and subtracting against it would publish the
|
|
192
|
+
* other side's whole reach as a difference between two populations.
|
|
193
|
+
*/
|
|
194
|
+
readonly gap: number | null;
|
|
195
|
+
};
|
|
196
|
+
/** How the shared parts fell, as a count over one set and never a mean. */
|
|
197
|
+
export type FormsCounted = {
|
|
198
|
+
/** Parts {@link FormComparison.one}'s readers reached more often. */
|
|
199
|
+
readonly one: number;
|
|
200
|
+
/** Parts {@link FormComparison.other}'s readers reached more often. */
|
|
201
|
+
readonly other: number;
|
|
202
|
+
/** Parts the two forms reached alike. */
|
|
203
|
+
readonly alike: number;
|
|
204
|
+
/** Parts where one side or the other cannot say. */
|
|
205
|
+
readonly unknown: number;
|
|
206
|
+
};
|
|
207
|
+
/**
|
|
208
|
+
* Two forms of one page held against each other.
|
|
209
|
+
*
|
|
210
|
+
* There is no `treeId` or `revision` at the top of this reading, where every
|
|
211
|
+
* other reading in this subsystem has one, and the absence is the point: this
|
|
212
|
+
* is a reading of two sides rather than of one page, and the two refusals that
|
|
213
|
+
* matter most are exactly the two where picking one side's would be picking one
|
|
214
|
+
* of two different answers.
|
|
215
|
+
*/
|
|
216
|
+
export type FormComparison = {
|
|
217
|
+
/** The side whose audience id sorts lower, or the first argument where no pair of names stands. */
|
|
218
|
+
readonly one: FormSide;
|
|
219
|
+
readonly other: FormSide;
|
|
220
|
+
/** Parts both forms have, in the reading order of {@link FormComparison.one}. */
|
|
221
|
+
readonly compared: readonly ComparedForm[];
|
|
222
|
+
/** Parts exactly one form has, by audience and then by node. */
|
|
223
|
+
readonly onlyIn: readonly PartOfForm[];
|
|
224
|
+
/**
|
|
225
|
+
* Shared nodes the two forms give different primitive types.
|
|
226
|
+
*
|
|
227
|
+
* Reported and not dropped, the way `LibraryReading.roleDisagreed` is: the
|
|
228
|
+
* two reaches are each their own form's and stay comparable, while a pair that
|
|
229
|
+
* is a band on one side and a card on the other is a fact about the deltas
|
|
230
|
+
* nobody would otherwise see.
|
|
231
|
+
*/
|
|
232
|
+
readonly disagreed: readonly NodeId[];
|
|
233
|
+
readonly counted: FormsCounted;
|
|
234
|
+
/** The shared part with the widest gap, by node id where two tie; `null` where none can say. */
|
|
235
|
+
readonly sharpest: ComparedForm | null;
|
|
236
|
+
readonly silence: FormComparisonSilence | null;
|
|
237
|
+
};
|
|
238
|
+
/**
|
|
239
|
+
* Hold two forms of one page against each other.
|
|
240
|
+
*
|
|
241
|
+
* Takes two page readings, each of one audience, of one tree at one revision.
|
|
242
|
+
* The labels are not `was` and `now` and the order of the arguments does not
|
|
243
|
+
* reach the answer: see the module documentation, and
|
|
244
|
+
* {@link FormComparisonSilence} for the five states in which there is no pair.
|
|
245
|
+
*/
|
|
246
|
+
export declare const formComparisonOf: (one: PageReading, other: PageReading) => FormComparison;
|
|
247
|
+
//# sourceMappingURL=forms.d.ts.map
|