@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,205 @@
|
|
|
1
|
+
import { type PageForm } from "./audiences.js";
|
|
2
|
+
import type { SilenceCondition, SilenceMeaning, SilenceSubject, SilenceVocabulary } from "./silences.js";
|
|
3
|
+
/**
|
|
4
|
+
* What a window could not answer, and what each reason cost it.
|
|
5
|
+
*
|
|
6
|
+
* [`silences.ts`](silences.ts) settled what a reading means when it says
|
|
7
|
+
* nothing: a hundred and fourteen names across twenty sets, each mapped to the
|
|
8
|
+
* condition it reports and the subject that condition is true of, so that two
|
|
9
|
+
* readings reporting one state report it once
|
|
10
|
+
* ([0240](../../decisions/0240-a-silence-is-a-condition-and-a-subject-and-the-two-names-for-one-state-were-not-synonyms.md)).
|
|
11
|
+
* It publishes `relateSilences`, which holds two reasons against each other,
|
|
12
|
+
* and `distinctSilences`, which collapses the readings of one card to the states
|
|
13
|
+
* they are actually in.
|
|
14
|
+
*
|
|
15
|
+
* **Nothing has ever called either of them.** Twenty sets, one relation and a
|
|
16
|
+
* dedup, and the only file in the repository that imports them is their own
|
|
17
|
+
* test — because the call they are shaped for is *one card*, and the thing an
|
|
18
|
+
* operator holds is a window of forty pages with nine readings over each. The
|
|
19
|
+
* vocabulary is finished and the question over it was unaskable, which is the
|
|
20
|
+
* one condition this lane treats as a counter that is not done.
|
|
21
|
+
*
|
|
22
|
+
* This is that question: hand over the silences as a surface holds them, one per
|
|
23
|
+
* reading, and get back the states the window is in, with **what each one
|
|
24
|
+
* cost**. It is one more thing taken out of what the subsystem already knows
|
|
25
|
+
* rather than collected: no payload, no browser change, no counter that does
|
|
26
|
+
* not exist, no column and no byte on any wire.
|
|
27
|
+
*
|
|
28
|
+
* ## A state is one condition about one subject, and that rule is not restated
|
|
29
|
+
*
|
|
30
|
+
* Two readings are in one state when `relateSilences` says `one-state`, which
|
|
31
|
+
* is the same condition about the same subject. Two that agree on the condition
|
|
32
|
+
* alone stay two, because *the window held no page views* said of a page and
|
|
33
|
+
* said of a comparison are not one sentence and the narrower is not evidence for
|
|
34
|
+
* the wider (0240).
|
|
35
|
+
*
|
|
36
|
+
* So the grouping key is that pair, which is the relation's own definition
|
|
37
|
+
* written as a string rather than a second opinion about it. A rule spelled
|
|
38
|
+
* twice is the thing this subsystem has been bitten by — two hand-written
|
|
39
|
+
* copies of the door's scaling rule, and two upsert keys that agreed until they
|
|
40
|
+
* did not — and the key cannot call `relateSilences` without turning a grouping
|
|
41
|
+
* into a scan per entry. So the two are **held together by a test** instead, as
|
|
42
|
+
* a DDL default and the constant it spells are: no two states of a census may
|
|
43
|
+
* be ones the relation would call `one-state`, over a window built to produce
|
|
44
|
+
* both of the ways that could go wrong.
|
|
45
|
+
*
|
|
46
|
+
* ## What a reason cost is readings and pages, and a page is counted once
|
|
47
|
+
*
|
|
48
|
+
* A state carries two counts and they answer different questions.
|
|
49
|
+
* {@link SilenceStanding.readings} is how many readings it took, which is the
|
|
50
|
+
* figure *how much of this window is dark* is asked of.
|
|
51
|
+
* {@link SilenceStanding.forms} names the pages, **each once however many of
|
|
52
|
+
* their readings report it** — the rule a fault in a deployment's collection
|
|
53
|
+
* already follows, where a page is counted once however many faults it has
|
|
54
|
+
* ([0271](../../decisions/0271-a-fault-in-a-deployments-collection-is-named-by-what-it-costs-and-a-pages-readers-are-counted-once.md)).
|
|
55
|
+
*
|
|
56
|
+
* The two are not each other. One page whose nine readings are all `unmeasured`
|
|
57
|
+
* is nine readings and one page; nine pages with one such reading each is nine
|
|
58
|
+
* and nine; and the remedies differ — the first is one door row and the second
|
|
59
|
+
* is a deployment.
|
|
60
|
+
*
|
|
61
|
+
* The page is a **form** and not a revision
|
|
62
|
+
* ([0263](../../decisions/0263-a-page-is-a-base-tree-and-the-deltas-an-audience-earns.md),
|
|
63
|
+
* [0290](../../decisions/0290-a-reading-is-of-one-audience-and-two-forms-of-a-page-are-two-readings-rather-than-one-handed-in-twice.md)),
|
|
64
|
+
* keyed by the published rule rather than by a tree id: two forms of one page
|
|
65
|
+
* are two readerships and a tree alone is not one page, which every comparison
|
|
66
|
+
* in this subsystem keys on and none of them spells out twice
|
|
67
|
+
* ([0293](../../decisions/0293-a-comparison-pairs-pages-by-form-and-the-pairing-rule-is-published-beside-the-reading-rule.md)).
|
|
68
|
+
*
|
|
69
|
+
* ## The other grouping is the same entries read the other way
|
|
70
|
+
*
|
|
71
|
+
* The states say *which reasons this window has*. A form row says *what this
|
|
72
|
+
* page answered*, which is the question after it and is the same entries
|
|
73
|
+
* transposed — the shape a region map took when it was asked which pages a
|
|
74
|
+
* place's readers read, and free for the same reason: nothing is collected, the
|
|
75
|
+
* rows are grouped the other way.
|
|
76
|
+
*
|
|
77
|
+
* It is the grouping that carries the sentence worth putting at the top of a
|
|
78
|
+
* screen, because it is the one with a denominator. *Nine of this page's nine
|
|
79
|
+
* readings are silent, for one reason* is a page to fix; one silence out of nine
|
|
80
|
+
* is a page that is working.
|
|
81
|
+
*
|
|
82
|
+
* ## What is deliberately not published
|
|
83
|
+
*
|
|
84
|
+
* **No ranking of the states.** They are not comparable in what they cost: a
|
|
85
|
+
* page's `no-view-reported` takes every reading of that page, and a library's
|
|
86
|
+
* `nothing-of-the-kind` takes one row of one census and means *you do not use
|
|
87
|
+
* this kind of part*, which is not a fault at all. The counts are published and
|
|
88
|
+
* the order is the order the readings were handed over, so a surface that means
|
|
89
|
+
* *most readings* or *most pages* sorts by the figure it means. That is the
|
|
90
|
+
* shape this lane settled for a verdict it could not take honestly: publish the
|
|
91
|
+
* figure and let the operator read it.
|
|
92
|
+
*
|
|
93
|
+
* **No total of pages across the states**, for
|
|
94
|
+
* [0158](../../decisions/0158-counting-a-window-of-reader-signals-and-forgetting-it-are-one-operation.md)'s
|
|
95
|
+
* reason one level up: one page is in as many states as it has reasons, so a
|
|
96
|
+
* sum over {@link SilenceStanding.forms} counts it once per reason. What is
|
|
97
|
+
* published instead partitions — every reading handed in is in exactly one
|
|
98
|
+
* state or in none, so {@link SilenceCensus.silent} is the sum of the states'
|
|
99
|
+
* readings, and that identity is published rather than described.
|
|
100
|
+
*
|
|
101
|
+
* **No sentence of its own.** A state is a condition and a subject, both of
|
|
102
|
+
* which `silences.ts` already prints a line for, and the only thing a third
|
|
103
|
+
* sentence would add is the counts — which is pluralisation, and belongs to
|
|
104
|
+
* whoever is drawing the screen in whatever language it is in.
|
|
105
|
+
*
|
|
106
|
+
* Pure, and linear in the readings handed over. It reaches no store, no clock
|
|
107
|
+
* and no DOM, and the arithmetic is addition — nothing here survives into a
|
|
108
|
+
* browser bundle.
|
|
109
|
+
*/
|
|
110
|
+
/** One reading's silence, with the page it was a reading of. */
|
|
111
|
+
export type ReadingSilence = {
|
|
112
|
+
/**
|
|
113
|
+
* What the reading reported, as the matching `meaningOf…Silence` gives it, or
|
|
114
|
+
* `null` where it answered.
|
|
115
|
+
*
|
|
116
|
+
* Nullable rather than the whole entry being nullable, which is the one way
|
|
117
|
+
* this differs from `distinctSilences`' argument and the reason the form
|
|
118
|
+
* grouping has a denominator at all: a reading that answered is still a
|
|
119
|
+
* reading of that page, and dropping it before the call would make *nine of
|
|
120
|
+
* nine* and *one of one* the same row.
|
|
121
|
+
*/
|
|
122
|
+
readonly meaning: SilenceMeaning | null;
|
|
123
|
+
/**
|
|
124
|
+
* The page in the form this reading was of, or absent where the reading is of
|
|
125
|
+
* no one page.
|
|
126
|
+
*
|
|
127
|
+
* A library census and an order over a deployment's pages are of something
|
|
128
|
+
* larger than a page, and their silences are about a kind and about a page
|
|
129
|
+
* respectively — a reading's subject is not its scope (0240). Those are
|
|
130
|
+
* counted in {@link SilenceCensus.wide} rather than attributed to a form that
|
|
131
|
+
* would be a guess.
|
|
132
|
+
*/
|
|
133
|
+
readonly form?: PageForm | null;
|
|
134
|
+
};
|
|
135
|
+
/** One state the window is in, and what it cost. */
|
|
136
|
+
export type SilenceStanding = {
|
|
137
|
+
readonly condition: SilenceCondition;
|
|
138
|
+
readonly subject: SilenceSubject;
|
|
139
|
+
/**
|
|
140
|
+
* The vocabulary of the **first** reading that reported it, kept so that a
|
|
141
|
+
* surface can still print that reading's own sentence.
|
|
142
|
+
*
|
|
143
|
+
* `distinctSilences`' rule, unchanged: the names are right in their own set
|
|
144
|
+
* and collapsing a state does not make one of them wrong.
|
|
145
|
+
*/
|
|
146
|
+
readonly vocabulary: SilenceVocabulary;
|
|
147
|
+
/** Every vocabulary that reported it, each once, in the order they arrived. */
|
|
148
|
+
readonly vocabularies: readonly SilenceVocabulary[];
|
|
149
|
+
/** How many readings reported it. */
|
|
150
|
+
readonly readings: number;
|
|
151
|
+
/** The pages it cost, each once however many of their readings reported it. */
|
|
152
|
+
readonly forms: readonly PageForm[];
|
|
153
|
+
/** How many of the readings that reported it were of no one page. */
|
|
154
|
+
readonly wide: number;
|
|
155
|
+
};
|
|
156
|
+
/** What one group of readings answered. */
|
|
157
|
+
export type SilenceGroup = {
|
|
158
|
+
/** Every reading handed over in this group, silent or not. */
|
|
159
|
+
readonly readings: number;
|
|
160
|
+
/** How many of them were silent. */
|
|
161
|
+
readonly silent: number;
|
|
162
|
+
/**
|
|
163
|
+
* The distinct states they are in, in the order they arrived, each keeping the
|
|
164
|
+
* first reading's vocabulary.
|
|
165
|
+
*/
|
|
166
|
+
readonly states: readonly SilenceMeaning[];
|
|
167
|
+
};
|
|
168
|
+
/** What one page in one form answered. */
|
|
169
|
+
export type FormSilences = SilenceGroup & {
|
|
170
|
+
readonly form: PageForm;
|
|
171
|
+
};
|
|
172
|
+
/** The states a window is in, and what each of them cost. */
|
|
173
|
+
export type SilenceCensus = {
|
|
174
|
+
/**
|
|
175
|
+
* Every reading handed over, silent or not, which is the denominator the
|
|
176
|
+
* caller chose by choosing what to hand in.
|
|
177
|
+
*/
|
|
178
|
+
readonly readings: number;
|
|
179
|
+
/** How many of them were silent. `readings = silent + answered`. */
|
|
180
|
+
readonly silent: number;
|
|
181
|
+
readonly answered: number;
|
|
182
|
+
/**
|
|
183
|
+
* The distinct states, in the order the readings were handed over.
|
|
184
|
+
*
|
|
185
|
+
* Their `readings` sum to {@link silent}, because every silent reading is in
|
|
186
|
+
* exactly one state. Their `forms` do **not** sum to anything.
|
|
187
|
+
*/
|
|
188
|
+
readonly states: readonly SilenceStanding[];
|
|
189
|
+
/** The same readings by page, in form order rather than arrival order. */
|
|
190
|
+
readonly byForm: readonly FormSilences[];
|
|
191
|
+
/** The readings of no one page, which no form row holds. */
|
|
192
|
+
readonly wide: SilenceGroup;
|
|
193
|
+
};
|
|
194
|
+
/**
|
|
195
|
+
* The states a window is in, out of the silences its readings published.
|
|
196
|
+
*
|
|
197
|
+
* Takes one entry per reading rather than one per silence, so that a page's
|
|
198
|
+
* readings have a denominator, and groups them twice: by the state, which is a
|
|
199
|
+
* condition and a subject, and by the page.
|
|
200
|
+
*
|
|
201
|
+
* Linear in the entries. A page's forty readings and a deployment's forty pages
|
|
202
|
+
* are sixteen hundred entries, and each one touches two maps.
|
|
203
|
+
*/
|
|
204
|
+
export declare const silenceCensusOf: (readings: readonly ReadingSilence[]) => SilenceCensus;
|
|
205
|
+
//# sourceMappingURL=silence-census.d.ts.map
|
|
@@ -0,0 +1,87 @@
|
|
|
1
|
+
import { formKeyOf, inFormOrder } from "./audiences.js";
|
|
2
|
+
/** What one state is, which is `relateSilences`' `one-state` written as a key. */
|
|
3
|
+
const stateKeyOf = (meaning) => `${meaning.condition}\u0000${meaning.subject}`;
|
|
4
|
+
const standing = (meaning) => ({
|
|
5
|
+
condition: meaning.condition,
|
|
6
|
+
subject: meaning.subject,
|
|
7
|
+
vocabulary: meaning.vocabulary,
|
|
8
|
+
vocabularies: [],
|
|
9
|
+
readings: 0,
|
|
10
|
+
forms: new Map(),
|
|
11
|
+
wide: 0,
|
|
12
|
+
});
|
|
13
|
+
const grouping = () => ({ readings: 0, silent: 0, states: new Map() });
|
|
14
|
+
const addTo = (into, meaning) => {
|
|
15
|
+
into.readings += 1;
|
|
16
|
+
if (meaning === null)
|
|
17
|
+
return;
|
|
18
|
+
into.silent += 1;
|
|
19
|
+
const key = stateKeyOf(meaning);
|
|
20
|
+
if (!into.states.has(key))
|
|
21
|
+
into.states.set(key, meaning);
|
|
22
|
+
};
|
|
23
|
+
const groupOf = (of) => ({
|
|
24
|
+
readings: of.readings,
|
|
25
|
+
silent: of.silent,
|
|
26
|
+
states: [...of.states.values()],
|
|
27
|
+
});
|
|
28
|
+
/**
|
|
29
|
+
* The states a window is in, out of the silences its readings published.
|
|
30
|
+
*
|
|
31
|
+
* Takes one entry per reading rather than one per silence, so that a page's
|
|
32
|
+
* readings have a denominator, and groups them twice: by the state, which is a
|
|
33
|
+
* condition and a subject, and by the page.
|
|
34
|
+
*
|
|
35
|
+
* Linear in the entries. A page's forty readings and a deployment's forty pages
|
|
36
|
+
* are sixteen hundred entries, and each one touches two maps.
|
|
37
|
+
*/
|
|
38
|
+
export const silenceCensusOf = (readings) => {
|
|
39
|
+
const states = new Map();
|
|
40
|
+
const forms = new Map();
|
|
41
|
+
const wide = grouping();
|
|
42
|
+
for (const reading of readings) {
|
|
43
|
+
const form = reading.form ?? null;
|
|
44
|
+
if (form === null) {
|
|
45
|
+
addTo(wide, reading.meaning);
|
|
46
|
+
}
|
|
47
|
+
else {
|
|
48
|
+
const key = formKeyOf(form);
|
|
49
|
+
const held = forms.get(key) ?? { ...grouping(), form };
|
|
50
|
+
addTo(held, reading.meaning);
|
|
51
|
+
forms.set(key, held);
|
|
52
|
+
}
|
|
53
|
+
if (reading.meaning === null)
|
|
54
|
+
continue;
|
|
55
|
+
const key = stateKeyOf(reading.meaning);
|
|
56
|
+
const held = states.get(key) ?? standing(reading.meaning);
|
|
57
|
+
held.readings += 1;
|
|
58
|
+
if (!held.vocabularies.includes(reading.meaning.vocabulary)) {
|
|
59
|
+
held.vocabularies.push(reading.meaning.vocabulary);
|
|
60
|
+
}
|
|
61
|
+
if (form === null)
|
|
62
|
+
held.wide += 1;
|
|
63
|
+
else
|
|
64
|
+
held.forms.set(formKeyOf(form), form);
|
|
65
|
+
states.set(key, held);
|
|
66
|
+
}
|
|
67
|
+
const silent = [...states.values()].reduce((total, held) => total + held.readings, 0);
|
|
68
|
+
return {
|
|
69
|
+
readings: readings.length,
|
|
70
|
+
silent,
|
|
71
|
+
answered: readings.length - silent,
|
|
72
|
+
states: [...states.values()].map((held) => ({
|
|
73
|
+
condition: held.condition,
|
|
74
|
+
subject: held.subject,
|
|
75
|
+
vocabulary: held.vocabulary,
|
|
76
|
+
vocabularies: [...held.vocabularies],
|
|
77
|
+
readings: held.readings,
|
|
78
|
+
forms: [...held.forms.values()].sort(inFormOrder),
|
|
79
|
+
wide: held.wide,
|
|
80
|
+
})),
|
|
81
|
+
byForm: [...forms.values()]
|
|
82
|
+
.sort((one, other) => inFormOrder(one.form, other.form))
|
|
83
|
+
.map((held) => ({ form: held.form, ...groupOf(held) })),
|
|
84
|
+
wide: groupOf(wide),
|
|
85
|
+
};
|
|
86
|
+
};
|
|
87
|
+
//# sourceMappingURL=silence-census.js.map
|