@jam-overture/loom 0.1.0 → 0.3.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- 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/audience/compose.d.ts +112 -0
- package/dist/audience/compose.js +134 -0
- package/dist/audience/memory.d.ts +14 -0
- package/dist/audience/memory.js +71 -0
- package/dist/audience/overlay-store.d.ts +343 -0
- package/dist/audience/overlay-store.js +217 -0
- package/dist/audience/rule.d.ts +121 -0
- package/dist/audience/rule.js +78 -0
- package/dist/cli/index.d.ts +3 -4
- package/dist/cli/index.js +3 -4
- package/dist/cli/templates.js +19 -0
- package/dist/data/adapter.d.ts +9 -1
- package/dist/data/adapter.js +2 -0
- package/dist/data/plan.js +0 -0
- package/dist/data/resolution.d.ts +23 -1
- package/dist/data/resolve.d.ts +31 -4
- 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/interpretation/anthropic.d.ts +1 -1
- package/dist/interpretation/anthropic.js +2 -22
- package/dist/interpretation/client.d.ts +1 -1
- package/dist/interpretation/materialize.js +67 -22
- package/dist/interpretation/openai-compatible.d.ts +36 -0
- package/dist/interpretation/openai-compatible.js +79 -0
- package/dist/interpretation/status.d.ts +19 -0
- package/dist/interpretation/status.js +26 -0
- package/dist/live/index.d.ts +73 -0
- package/dist/live/index.js +73 -0
- package/dist/live/pages.d.ts +187 -0
- package/dist/live/pages.js +161 -0
- package/dist/live/pull.d.ts +147 -0
- package/dist/live/pull.js +398 -0
- package/dist/live/pulling.d.ts +79 -0
- package/dist/live/pulling.js +117 -0
- package/dist/live/window.d.ts +129 -0
- package/dist/live/window.js +132 -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/addressed.d.ts +35 -0
- package/dist/render/addressed.js +79 -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/document-theme.d.ts +70 -0
- package/dist/render/document-theme.js +139 -0
- package/dist/render/editable.d.ts +15 -1
- package/dist/render/editable.js +13 -1
- package/dist/render/expected.d.ts +98 -0
- package/dist/render/expected.js +88 -0
- package/dist/render/index.d.ts +4 -0
- package/dist/render/index.js +4 -0
- package/dist/render/reads.d.ts +11 -0
- package/dist/render/reads.js +12 -1
- package/dist/render/render.d.ts +11 -0
- package/dist/render/render.js +294 -53
- package/dist/render/request.d.ts +8 -1
- package/dist/render/request.js +1 -0
- 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/auto-apply-ceiling.d.ts +54 -0
- package/dist/runtime/auto-apply-ceiling.js +66 -0
- 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 +91 -10
- package/dist/runtime/index.d.ts +4 -0
- package/dist/runtime/index.js +4 -0
- package/dist/runtime/irreversibility.d.ts +64 -0
- package/dist/runtime/irreversibility.js +45 -0
- package/dist/runtime/nesting.d.ts +13 -1
- package/dist/runtime/nesting.js +41 -24
- 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 +305 -0
- package/dist/runtime/policy-log.d.ts +406 -0
- package/dist/runtime/policy-log.js +285 -0
- package/dist/runtime/policy.d.ts +8 -6
- package/dist/runtime/policy.js +5 -2
- package/dist/runtime/repointing.js +0 -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 +129 -5
- package/dist/sdk/definition.js +66 -0
- package/dist/sdk/registry.d.ts +45 -2
- package/dist/sdk/registry.js +102 -1
- package/dist/signals/acted.contract.d.ts +21 -0
- package/dist/signals/acted.contract.js +236 -0
- package/dist/signals/acted.d.ts +359 -0
- package/dist/signals/acted.js +135 -0
- 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/agenda.d.ts +585 -0
- package/dist/signals/agenda.js +295 -0
- package/dist/signals/applied-window.contract.d.ts +23 -0
- package/dist/signals/applied-window.contract.js +160 -0
- package/dist/signals/arrivals.contract.d.ts +21 -0
- package/dist/signals/arrivals.contract.js +180 -0
- package/dist/signals/arrivals.d.ts +375 -0
- package/dist/signals/arrivals.js +254 -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 +33 -17
- package/dist/signals/broadcast.js +255 -32
- package/dist/signals/change.d.ts +378 -0
- package/dist/signals/change.js +327 -0
- package/dist/signals/collect.d.ts +169 -34
- package/dist/signals/collect.js +186 -38
- package/dist/signals/conversion.d.ts +348 -0
- package/dist/signals/conversion.js +235 -0
- 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/correlated.contract.d.ts +24 -0
- package/dist/signals/correlated.contract.js +94 -0
- package/dist/signals/counters.d.ts +97 -0
- package/dist/signals/counters.js +160 -0
- package/dist/signals/deliver.d.ts +23 -4
- package/dist/signals/deliver.js +34 -6
- package/dist/signals/deployment-change.d.ts +395 -0
- package/dist/signals/deployment-change.js +309 -0
- package/dist/signals/deployment.d.ts +278 -0
- package/dist/signals/deployment.js +178 -0
- package/dist/signals/door.d.ts +114 -0
- package/dist/signals/door.js +77 -0
- package/dist/signals/expire.d.ts +192 -0
- package/dist/signals/expire.js +213 -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/frontier.d.ts +268 -0
- package/dist/signals/frontier.js +145 -0
- package/dist/signals/funnel-change.d.ts +548 -0
- package/dist/signals/funnel-change.js +361 -0
- package/dist/signals/funnel-hours.contract.d.ts +21 -0
- package/dist/signals/funnel-hours.contract.js +221 -0
- package/dist/signals/funnel-hours.d.ts +293 -0
- package/dist/signals/funnel-hours.js +99 -0
- package/dist/signals/funnel.d.ts +592 -0
- package/dist/signals/funnel.js +231 -0
- package/dist/signals/health.d.ts +694 -0
- package/dist/signals/health.js +573 -0
- package/dist/signals/index.d.ts +60 -0
- package/dist/signals/index.js +60 -0
- package/dist/signals/ingest.d.ts +56 -1
- package/dist/signals/ingest.js +91 -1
- package/dist/signals/inside.d.ts +190 -0
- package/dist/signals/inside.js +263 -0
- package/dist/signals/join.d.ts +56 -0
- package/dist/signals/join.js +60 -0
- package/dist/signals/journal.d.ts +123 -9
- package/dist/signals/kept.contract.d.ts +22 -0
- package/dist/signals/kept.contract.js +111 -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-agenda-change.d.ts +324 -0
- package/dist/signals/library-agenda-change.js +199 -0
- package/dist/signals/library-agenda.d.ts +258 -0
- package/dist/signals/library-agenda.js +167 -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 +646 -0
- package/dist/signals/library-reach-change.js +542 -0
- package/dist/signals/library-reach.d.ts +377 -0
- package/dist/signals/library-reach.js +227 -0
- package/dist/signals/library-senders-change.d.ts +457 -0
- package/dist/signals/library-senders-change.js +367 -0
- package/dist/signals/library-senders-reach-change.d.ts +486 -0
- package/dist/signals/library-senders-reach-change.js +538 -0
- package/dist/signals/library-senders-reach.d.ts +340 -0
- package/dist/signals/library-senders-reach.js +252 -0
- package/dist/signals/library-senders.d.ts +271 -0
- package/dist/signals/library-senders.js +180 -0
- package/dist/signals/library-word-reach-change.d.ts +567 -0
- package/dist/signals/library-word-reach-change.js +564 -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 +246 -14
- package/dist/signals/migrate.d.ts +20 -4
- package/dist/signals/migrate.js +269 -8
- package/dist/signals/notice.d.ts +389 -0
- package/dist/signals/notice.js +250 -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/part-pace.d.ts +378 -0
- package/dist/signals/part-pace.js +333 -0
- package/dist/signals/parts.d.ts +354 -0
- package/dist/signals/parts.js +232 -0
- package/dist/signals/postgres.d.ts +16 -2
- package/dist/signals/postgres.js +753 -76
- 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 +163 -0
- package/dist/signals/retention.js +75 -0
- package/dist/signals/rhythm.d.ts +302 -0
- package/dist/signals/rhythm.js +262 -0
- package/dist/signals/rollup.d.ts +194 -4
- package/dist/signals/rollup.js +0 -0
- package/dist/signals/schema.d.ts +1069 -1
- package/dist/signals/schema.js +393 -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 +1147 -0
- package/dist/signals/silences.js +996 -0
- package/dist/signals/subtrees.d.ts +123 -0
- package/dist/signals/subtrees.js +102 -0
- package/dist/signals/tally.d.ts +262 -12
- package/dist/signals/unread.d.ts +292 -0
- package/dist/signals/unread.js +137 -0
- package/dist/signals/window-agenda.d.ts +276 -0
- package/dist/signals/window-agenda.js +83 -0
- package/dist/signals/window-figures.d.ts +148 -0
- package/dist/signals/window-figures.js +42 -0
- package/dist/signals/window-funnels.d.ts +88 -0
- package/dist/signals/window-funnels.js +47 -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/cache.d.ts +101 -0
- package/dist/store/cache.js +149 -0
- package/dist/store/history.d.ts +82 -0
- package/dist/store/history.js +36 -0
- package/dist/store/index.d.ts +30 -0
- package/dist/store/index.js +30 -0
- package/dist/store/memory.d.ts +2 -1
- package/dist/store/memory.js +48 -12
- package/dist/store/migrate.d.ts +106 -0
- package/dist/store/migrate.js +323 -7
- package/dist/store/postgres-applications.d.ts +4 -0
- package/dist/store/postgres-applications.js +197 -0
- package/dist/store/postgres-audience.d.ts +14 -0
- package/dist/store/postgres-audience.js +272 -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 +17 -1
- package/dist/store/postgres.js +60 -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 +762 -2
- package/dist/store/schema.js +218 -5
- package/dist/store/source.d.ts +57 -1
- package/dist/store/source.js +65 -1
- package/dist/store/store.d.ts +29 -6
- package/dist/submit/resolve.d.ts +1 -1
- 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 +2 -0
- package/dist/telemetry/index.js +2 -0
- package/dist/telemetry/journal.d.ts +104 -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 +33 -1
- package/dist/telemetry/migrate.js +22 -1
- package/dist/telemetry/postgres.d.ts +10 -1
- package/dist/telemetry/postgres.js +188 -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/telemetry/window.d.ts +135 -0
- package/dist/telemetry/window.js +101 -0
- package/dist/testing/application-contract.d.ts +14 -0
- package/dist/testing/application-contract.js +270 -0
- package/dist/testing/audience-overlay-contract.d.ts +31 -0
- package/dist/testing/audience-overlay-contract.js +354 -0
- package/dist/testing/contracts.d.ts +13 -7
- package/dist/testing/contracts.js +13 -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 +297 -6
- 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/contrast.d.ts +19 -14
- package/dist/theme/contrast.js +181 -17
- 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/apply.js +13 -0
- package/dist/tree/compare.d.ts +9 -0
- package/dist/tree/compare.js +18 -0
- package/dist/tree/mutation.d.ts +18 -0
- package/dist/tree/mutation.js +24 -12
- package/dist/tree/navigation.d.ts +5 -0
- package/dist/tree/navigation.js +32 -10
- package/dist/tree/outline.d.ts +7 -0
- package/dist/tree/outline.js +9 -5
- 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 +25 -3
- package/dist/runtime/inverse-interpreter.d.ts +0 -90
- package/dist/runtime/inverse-interpreter.js +0 -56
|
@@ -0,0 +1,255 @@
|
|
|
1
|
+
import { everyMemberOf } from "../closed-set.js";
|
|
2
|
+
/** Sorted so a split is in the same order whatever order the rows arrived in. */
|
|
3
|
+
const sorted = (audiences) => [...audiences].sort((one, other) => one.localeCompare(other));
|
|
4
|
+
/**
|
|
5
|
+
* The audiences a window names, deduplicated and in a stable order.
|
|
6
|
+
*
|
|
7
|
+
* Rows naming none are not an audience and are not counted as one. A window of
|
|
8
|
+
* them answers `[]`, which is *nothing here says* rather than *one audience* —
|
|
9
|
+
* the distinction `MaybeAudienceScoped` exists for.
|
|
10
|
+
*/
|
|
11
|
+
export const audiencesIn = (rows) => {
|
|
12
|
+
const found = new Set();
|
|
13
|
+
for (const row of rows) {
|
|
14
|
+
if (row.audienceId !== undefined)
|
|
15
|
+
found.add(row.audienceId);
|
|
16
|
+
}
|
|
17
|
+
return sorted(found);
|
|
18
|
+
};
|
|
19
|
+
/**
|
|
20
|
+
* Which of the three a window and an asking come to.
|
|
21
|
+
*
|
|
22
|
+
* The census is deduplicated and sorted here, so a caller may hand in the rows
|
|
23
|
+
* of two windows concatenated — a reading of funnel rows is of the populations
|
|
24
|
+
* its own rows name **and** of the populations the page reading it was taken
|
|
25
|
+
* against named, and either alone can be the ambiguous one.
|
|
26
|
+
*
|
|
27
|
+
* An audience asked for always wins, including over a window that names it
|
|
28
|
+
* nowhere: a caller asking for one population and being handed none is holding
|
|
29
|
+
* an empty reading, which is what it asked for and not an ambiguity.
|
|
30
|
+
*/
|
|
31
|
+
export const audienceScopeOf = (audiences, asked) => {
|
|
32
|
+
const named = sorted(new Set(audiences));
|
|
33
|
+
if (asked !== undefined)
|
|
34
|
+
return { reading: "one", audienceId: asked, audiences: named };
|
|
35
|
+
if (named.length === 1 && named[0] !== undefined)
|
|
36
|
+
return { reading: "one", audienceId: named[0], audiences: named };
|
|
37
|
+
if (named.length === 0)
|
|
38
|
+
return { reading: "unlabelled", audienceId: null, audiences: [] };
|
|
39
|
+
return { reading: "mixed", audienceId: null, audiences: named };
|
|
40
|
+
};
|
|
41
|
+
/**
|
|
42
|
+
* The scope a reading already recorded, read back off it.
|
|
43
|
+
*
|
|
44
|
+
* What a **second** reading needs: a comparison holding two sides against each
|
|
45
|
+
* other has to know that a side was read as neither population before it can
|
|
46
|
+
* say what moved between them, and a reading that published only its audience
|
|
47
|
+
* and its census leaves that as a subtraction for every caller to make the same
|
|
48
|
+
* way. One of them making it differently is this module's whole subject.
|
|
49
|
+
*/
|
|
50
|
+
export const audienceScopeRead = (reading) => audienceScopeOf(reading.audiences, reading.audienceId ?? undefined);
|
|
51
|
+
/**
|
|
52
|
+
* The rows of one audience, and nothing else.
|
|
53
|
+
*
|
|
54
|
+
* A row naming no audience is not in any audience's window. A caller holding
|
|
55
|
+
* such rows is holding something no store produced, and silently folding them
|
|
56
|
+
* into whichever audience was asked for would be this module inventing the
|
|
57
|
+
* fact it exists to keep.
|
|
58
|
+
*/
|
|
59
|
+
export const forAudience = (audience, rows) => rows.filter((row) => row.audienceId === audience);
|
|
60
|
+
/**
|
|
61
|
+
* A window a deployment read, split into the populations it actually holds.
|
|
62
|
+
*
|
|
63
|
+
* Exhaustive and lossless: every row is in exactly one window, each window's
|
|
64
|
+
* rows keep the order they arrived in, and the windows themselves are in a
|
|
65
|
+
* stable order so two reads of one store produce the same list. A deployment
|
|
66
|
+
* serving one form of every page gets one window, which is what it has always
|
|
67
|
+
* had.
|
|
68
|
+
*/
|
|
69
|
+
export const byAudience = (rows) => {
|
|
70
|
+
const windows = new Map();
|
|
71
|
+
for (const row of rows) {
|
|
72
|
+
const held = windows.get(row.audienceId);
|
|
73
|
+
if (held === undefined)
|
|
74
|
+
windows.set(row.audienceId, [row]);
|
|
75
|
+
else
|
|
76
|
+
held.push(row);
|
|
77
|
+
}
|
|
78
|
+
return sorted(windows.keys()).map((audience) => ({
|
|
79
|
+
audience,
|
|
80
|
+
rows: windows.get(audience) ?? [],
|
|
81
|
+
}));
|
|
82
|
+
};
|
|
83
|
+
/**
|
|
84
|
+
* What makes two readings one page: the tree, the revision and the audience.
|
|
85
|
+
*
|
|
86
|
+
* The one place that decides what a duplicate is. Five readings refuse to count
|
|
87
|
+
* a page twice — the health of a collection, the order over a deployment's
|
|
88
|
+
* pages, and the three censuses of a library — and before this they refused on
|
|
89
|
+
* a tree and a revision, which two audiences of one page share. So a deployment
|
|
90
|
+
* that began serving a second form had that form's reading dropped as a repeat
|
|
91
|
+
* of the first, and the number it was dropped out of went on looking right
|
|
92
|
+
* (0158: a count that has been added cannot be unadded, and one that was never
|
|
93
|
+
* added cannot be noticed).
|
|
94
|
+
*
|
|
95
|
+
* A reading naming no audience keys as itself, so a window of rows that never
|
|
96
|
+
* carried the column behaves exactly as it did.
|
|
97
|
+
*/
|
|
98
|
+
export const readingKeyOf = (reading) => `${reading.treeId}\u0000${reading.revision}\u0000${reading.audienceId ?? ""}`;
|
|
99
|
+
/** The form a reading is of, with an absent audience normalised to the `null` it means. */
|
|
100
|
+
export const formOf = (reading) => ({
|
|
101
|
+
treeId: reading.treeId,
|
|
102
|
+
audienceId: reading.audienceId ?? null,
|
|
103
|
+
});
|
|
104
|
+
/**
|
|
105
|
+
* What makes two readings one page in one form, which is what a comparison
|
|
106
|
+
* pairs on.
|
|
107
|
+
*
|
|
108
|
+
* The second of this module's two keys, published for the reason the first is:
|
|
109
|
+
* every comparison in this subsystem decides, in its own loop, whether two
|
|
110
|
+
* readings handed in are one page to be paired or one page handed in twice, and
|
|
111
|
+
* **a tree alone is not that page**. Two forms of it (0263) share a tree, so a
|
|
112
|
+
* comparison keyed by the tree drops the second form as a duplicate where the
|
|
113
|
+
* two sit at one revision and gates **both** out as ambiguous where they do
|
|
114
|
+
* not — which is 0158-permanent in the first case and silent in both.
|
|
115
|
+
*/
|
|
116
|
+
export const formKeyOf = (form) => `${form.treeId}\u0000${form.audienceId ?? ""}`;
|
|
117
|
+
/** Sorted so a list of forms reads the same whatever order they arrived in. */
|
|
118
|
+
export const inFormOrder = (one, other) => formKeyOf(one).localeCompare(formKeyOf(other));
|
|
119
|
+
/**
|
|
120
|
+
* The two populations a comparison was handed, published once rather than
|
|
121
|
+
* spelled on each comparison.
|
|
122
|
+
*
|
|
123
|
+
* Carried whether or not the pair was refused, because a `null` on either side
|
|
124
|
+
* is the whole of why a mismatched pair can go unrefused: it is what a surface
|
|
125
|
+
* reads to say *this comparison spans a window that named no audience* rather
|
|
126
|
+
* than being told nothing at all.
|
|
127
|
+
*/
|
|
128
|
+
export const comparedAudiencesOf = (was, now) => ({ was: was.audienceId ?? null, now: now.audienceId ?? null });
|
|
129
|
+
/**
|
|
130
|
+
* Whether two sides of a comparison prove they are of two populations.
|
|
131
|
+
*
|
|
132
|
+
* The one place that decides it, for the reason {@link readingKeyOf} is one
|
|
133
|
+
* place: ten comparisons here take their pair from a caller, nine of them
|
|
134
|
+
* refuse a pair of different trees, and a pair of different audiences is the
|
|
135
|
+
* same kind of error with none of the same visibility. Two trees are two pages and every figure comes back absurd; two
|
|
136
|
+
* forms of one page (0263) compare cleanly and the arithmetic is right. What is
|
|
137
|
+
* wrong is the sentence on top of it — *this is what your change did* — when
|
|
138
|
+
* the readership was varied by construction and the tree may not have changed
|
|
139
|
+
* at all.
|
|
140
|
+
*
|
|
141
|
+
* **False where either side names none, and that is not an oversight.** A row
|
|
142
|
+
* written before the column existed (0284) names no audience, so a pair of such
|
|
143
|
+
* a window and an `aud_pro` one is either an honest before-and-after across the
|
|
144
|
+
* migration or a cross-population comparison, and nothing in the counters tells
|
|
145
|
+
* them apart. Refusing both would withhold every comparison spanning the day a
|
|
146
|
+
* deployment upgraded, which is the comparison it most wants; refusing neither
|
|
147
|
+
* would publish a cross-population movement as a change. So the rule refuses
|
|
148
|
+
* what is provable and {@link comparedAudiencesOf} makes the rest visible.
|
|
149
|
+
*/
|
|
150
|
+
export const crossesAudiences = (was, now) => {
|
|
151
|
+
const pair = comparedAudiencesOf(was, now);
|
|
152
|
+
return pair.was !== null && pair.now !== null && pair.was !== pair.now;
|
|
153
|
+
};
|
|
154
|
+
/**
|
|
155
|
+
* The audiences a set of forms names, deduplicated and in a stable order.
|
|
156
|
+
*
|
|
157
|
+
* The form-level counterpart of {@link audiencesIn}, which answers the same
|
|
158
|
+
* question over rows. A form whose `audienceId` is `null` is not an audience
|
|
159
|
+
* and is not counted as one, so a window of forms that never carried the
|
|
160
|
+
* column answers `[]` — *nothing here says* rather than *one audience*.
|
|
161
|
+
*/
|
|
162
|
+
export const audiencesOf = (forms) => {
|
|
163
|
+
const found = new Set();
|
|
164
|
+
for (const form of forms) {
|
|
165
|
+
if (form.audienceId !== null)
|
|
166
|
+
found.add(form.audienceId);
|
|
167
|
+
}
|
|
168
|
+
return sorted(found);
|
|
169
|
+
};
|
|
170
|
+
/**
|
|
171
|
+
* The pages behind a set of forms, which two forms of one page share.
|
|
172
|
+
*
|
|
173
|
+
* A page is one base tree plus the deltas an audience earns (0263), so the
|
|
174
|
+
* tree is the page and the form is the page as one audience meets it. A window
|
|
175
|
+
* of four forms over three trees is three pages, one of them served twice.
|
|
176
|
+
*/
|
|
177
|
+
export const pagesOf = (forms) => {
|
|
178
|
+
const pages = new Set();
|
|
179
|
+
for (const form of forms)
|
|
180
|
+
pages.add(form.treeId);
|
|
181
|
+
return pages;
|
|
182
|
+
};
|
|
183
|
+
/** The closed set, in the order {@link formPairOf} reaches them. */
|
|
184
|
+
export const FORM_PAIR_REFUSALS = everyMemberOf()([
|
|
185
|
+
"different-pages",
|
|
186
|
+
"unsplit",
|
|
187
|
+
"unattributed",
|
|
188
|
+
"one-population",
|
|
189
|
+
"different-revisions",
|
|
190
|
+
]);
|
|
191
|
+
/** One line per refusal, for a surface saying why there is no pair. */
|
|
192
|
+
export const describeFormPairRefusal = (refusal) => {
|
|
193
|
+
switch (refusal) {
|
|
194
|
+
case "different-pages":
|
|
195
|
+
return "the two readings are of different pages";
|
|
196
|
+
case "unsplit":
|
|
197
|
+
return "one of the two windows holds two forms of the page and says which readers neither";
|
|
198
|
+
case "unattributed":
|
|
199
|
+
return "one of the two windows names no audience, so it is of no form in particular";
|
|
200
|
+
case "one-population":
|
|
201
|
+
return "both readings are of one audience, so there is no second form to compare";
|
|
202
|
+
case "different-revisions":
|
|
203
|
+
return "the two readings are of two revisions, so they are not two forms of one page";
|
|
204
|
+
}
|
|
205
|
+
};
|
|
206
|
+
/**
|
|
207
|
+
* Settle two readings into two forms of one page, or say why they are not.
|
|
208
|
+
*
|
|
209
|
+
* **Neither side is earlier, so the order of the arguments does not reach the
|
|
210
|
+
* answer.** `changeOf` takes `was` and `now` and does not check which is older:
|
|
211
|
+
* a caller holding them backwards gets every sign reversed, which is the
|
|
212
|
+
* bargain 0224 struck so that *this week against last week* comes out of the
|
|
213
|
+
* same function. Here that bargain would be a bug rather than a trade, because
|
|
214
|
+
* there is no fact of the matter about which of two populations comes first.
|
|
215
|
+
* Two deployments asking one question would get two answers, and a screen built
|
|
216
|
+
* on one of them would read the direction of every figure backwards without
|
|
217
|
+
* anything saying so.
|
|
218
|
+
*
|
|
219
|
+
* So the two sides are put in the order of their audience ids **before anything
|
|
220
|
+
* is read off either**, and `one` is the lower of the two names rather than the
|
|
221
|
+
* first argument. A pair with a name missing on either side has no order to
|
|
222
|
+
* take and keeps the arguments' own, which is all the two refusals that have no
|
|
223
|
+
* second population need.
|
|
224
|
+
*/
|
|
225
|
+
export const formPairOf = (one, other) => {
|
|
226
|
+
const [first, second] = one.audienceId !== null &&
|
|
227
|
+
other.audienceId !== null &&
|
|
228
|
+
other.audienceId.localeCompare(one.audienceId) < 0
|
|
229
|
+
? [other, one]
|
|
230
|
+
: [one, other];
|
|
231
|
+
const refusing = (refusal) => ({
|
|
232
|
+
pairing: "refused",
|
|
233
|
+
one: first,
|
|
234
|
+
other: second,
|
|
235
|
+
refusal,
|
|
236
|
+
});
|
|
237
|
+
if (first.treeId !== second.treeId)
|
|
238
|
+
return refusing("different-pages");
|
|
239
|
+
const scopes = { one: audienceScopeRead(first), other: audienceScopeRead(second) };
|
|
240
|
+
if (scopes.one.reading === "mixed" || scopes.other.reading === "mixed")
|
|
241
|
+
return refusing("unsplit");
|
|
242
|
+
if (scopes.one.audienceId === null || scopes.other.audienceId === null)
|
|
243
|
+
return refusing("unattributed");
|
|
244
|
+
if (scopes.one.audienceId === scopes.other.audienceId)
|
|
245
|
+
return refusing("one-population");
|
|
246
|
+
if (first.revision !== second.revision)
|
|
247
|
+
return refusing("different-revisions");
|
|
248
|
+
return {
|
|
249
|
+
pairing: "paired",
|
|
250
|
+
one: first,
|
|
251
|
+
other: second,
|
|
252
|
+
audiences: { one: scopes.one.audienceId, other: scopes.other.audienceId },
|
|
253
|
+
};
|
|
254
|
+
};
|
|
255
|
+
//# sourceMappingURL=audiences.js.map
|
|
@@ -28,16 +28,26 @@ import { type RandomBytes } from "./view.js";
|
|
|
28
28
|
* the control rather than the band. The addressed elements above it go on the
|
|
29
29
|
* signal as `within`, read off the walk this was already doing — because which
|
|
30
30
|
* region a node sat in is a fact about the page at the moment of the press, and
|
|
31
|
-
* nothing downstream can recover it afterwards.
|
|
31
|
+
* nothing downstream can recover it afterwards. A `completed` carries the same
|
|
32
|
+
* walk, for the same reason and more sharply: *which band converted* is the
|
|
33
|
+
* question a deployment opens the portal to ask.
|
|
34
|
+
*
|
|
35
|
+
* **A completion is a form the browser let go.** Nothing else on the page is a
|
|
36
|
+
* finish a reader can be said to have reached, and nothing else is observable
|
|
37
|
+
* without asking the network how it went (0211).
|
|
32
38
|
*
|
|
33
39
|
* **It keeps up with a page that changes.** Nodes that arrive after it started
|
|
34
40
|
* are watched and nodes that leave stop counting, so a band behind a Suspense
|
|
35
41
|
* boundary, a list that grows, and every region a proposal has just changed are
|
|
36
|
-
* measured like the rest.
|
|
37
|
-
*
|
|
38
|
-
*
|
|
39
|
-
*
|
|
40
|
-
*
|
|
42
|
+
* measured like the rest.
|
|
43
|
+
*
|
|
44
|
+
* **And with a page that becomes a different page, when it is handed the
|
|
45
|
+
* document.** The tree and revision are read once off a root element, so a
|
|
46
|
+
* broadcast pointed at an element goes on filing every batch under them — which
|
|
47
|
+
* is a client-side navigation's signals filed against the page it left. Pointed
|
|
48
|
+
* at a `Document` it follows the addressed page instead: a new identity ends one
|
|
49
|
+
* page view and opens another, with its own view key and its own arrival, and
|
|
50
|
+
* the same revision rendered again continues the one it was already observing.
|
|
41
51
|
*/
|
|
42
52
|
/** The DOM event a batch is dispatched as, on the root element. It bubbles. */
|
|
43
53
|
/**
|
|
@@ -49,7 +59,7 @@ import { type RandomBytes } from "./view.js";
|
|
|
49
59
|
* a broadcaster in a browser bundle is exactly the host who needs a `send`. One
|
|
50
60
|
* import line for the two things that are always used together.
|
|
51
61
|
*/
|
|
52
|
-
export { DEFAULT_READER_SIGNAL_PATH, deliverReaderSignals, type DeliverOptions, type PostBatch, type SendBeacon, } from "./deliver.js";
|
|
62
|
+
export { BATCH_CONTENT_TYPE, DEFAULT_READER_SIGNAL_PATH, deliverReaderSignals, type DeliverOptions, type PostBatch, type SendBeacon, } from "./deliver.js";
|
|
53
63
|
export declare const READER_SIGNALS_EVENT = "loom:signals";
|
|
54
64
|
/** Something that reports elements coming into and out of view. The browser's `IntersectionObserver` unless a host passes its own. */
|
|
55
65
|
export type VisibilityObserver = {
|
|
@@ -118,17 +128,23 @@ export type ReaderSignalBroadcastError = {
|
|
|
118
128
|
readonly detail: string;
|
|
119
129
|
};
|
|
120
130
|
/**
|
|
121
|
-
* Start broadcasting reader signals from
|
|
131
|
+
* Start broadcasting reader signals from a rendered Loom page.
|
|
132
|
+
*
|
|
133
|
+
* Hand it the **root element** of the page and it broadcasts from that element:
|
|
134
|
+
* nodes arriving and leaving under it are followed, and the tree and revision
|
|
135
|
+
* are read once, so a page that becomes a different page needs `stop()` and
|
|
136
|
+
* another call or its signals are filed under the revision it left.
|
|
122
137
|
*
|
|
123
|
-
*
|
|
124
|
-
*
|
|
125
|
-
*
|
|
138
|
+
* Hand it the **document** and it finds the addressed page itself and follows
|
|
139
|
+
* it: a client-side navigation ends one page view and begins another, with its
|
|
140
|
+
* own view key and its own arrival, and the same revision rendered again
|
|
141
|
+
* continues the page view it was already observing
|
|
142
|
+
* ({@link followAddressedPage}). This is the argument to pass in an application
|
|
143
|
+
* that routes on the client, which is most of them.
|
|
126
144
|
*
|
|
127
|
-
*
|
|
128
|
-
*
|
|
129
|
-
*
|
|
130
|
-
* revision into the same root — needs `stop()` and a new broadcast, or its
|
|
131
|
-
* signals are filed under the revision it left.
|
|
145
|
+
* Either way it returns an error rather than broadcasting nothing when there is
|
|
146
|
+
* no addressed page to broadcast from, because a silent broadcaster is exactly
|
|
147
|
+
* the misconfiguration nobody would notice.
|
|
132
148
|
*/
|
|
133
|
-
export declare const broadcastReaderSignals: (
|
|
149
|
+
export declare const broadcastReaderSignals: (scope: Element | Document, options?: ReaderSignalOptions) => Result<ReaderSignalBroadcast, ReaderSignalBroadcastError>;
|
|
134
150
|
//# sourceMappingURL=broadcast.d.ts.map
|