@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
package/dist/theme/registry.js
CHANGED
|
@@ -1,9 +1,19 @@
|
|
|
1
|
+
import { describeRegistered } from "../registered.js";
|
|
1
2
|
import { err, ok } from "../result.js";
|
|
2
3
|
import { STARTER_FONT_PACKS, STARTER_PALETTES, STARTER_STYLE_PRESETS, } from "./library.js";
|
|
3
4
|
import { themeSelectionSchema, } from "./theme.js";
|
|
5
|
+
/**
|
|
6
|
+
* Why a theme did not resolve, and what could have.
|
|
7
|
+
*
|
|
8
|
+
* `available` holds every registered id and this prints the few nearest the one
|
|
9
|
+
* that was asked for, because the sentence lands in a log line whose length is
|
|
10
|
+
* not the deployment's to set. A caller that wants the whole list has it on the
|
|
11
|
+
* error, and a caller that wants it with names and descriptions has
|
|
12
|
+
* `catalogue()`.
|
|
13
|
+
*/
|
|
4
14
|
export const describeThemeError = (error) => error.code === "malformed-selection"
|
|
5
15
|
? `Theme selection is malformed: ${error.detail}`
|
|
6
|
-
: `No ${error.code.replace("unknown-", "").replace("-", " ")} "${error.id}". Registered: ${error.
|
|
16
|
+
: `No ${error.code.replace("unknown-", "").replace("-", " ")} "${error.id}". Registered: ${describeRegistered(error.id, error.available)}.`;
|
|
7
17
|
const entryOf = (item) => ({
|
|
8
18
|
id: item.id,
|
|
9
19
|
name: item.name,
|
|
@@ -30,6 +30,19 @@ import type { Palette, PaletteSlot, ThemeId } from "./theme.js";
|
|
|
30
30
|
* the just-noticeable difference is a published property of human vision, not a
|
|
31
31
|
* number chosen to fit these palettes.
|
|
32
32
|
*
|
|
33
|
+
* ## The two questions in here
|
|
34
|
+
*
|
|
35
|
+
* **`auditSeparation`** asks whether two slots a reader is meant to tell apart
|
|
36
|
+
* can be told apart, and lets either the fills or a mark between them answer.
|
|
37
|
+
*
|
|
38
|
+
* **`auditMarkGroundings`** asks whether a line the library declares is a line a
|
|
39
|
+
* reader can find, against every ground it is drawn on. It was added on
|
|
40
|
+
* 29 September, five weeks after the module, because the first question cannot
|
|
41
|
+
* reach it: a mark is only measured there when the pair it separates has
|
|
42
|
+
* collapsed, so eight starter palettes were drawing a `border-subtle` edge
|
|
43
|
+
* within a just-noticeable difference of the fill it contained — one of them at
|
|
44
|
+
* ΔE 0.00 — with every test in this file green.
|
|
45
|
+
*
|
|
33
46
|
* It reports; it does not decide — the bargain `auditPalette` and
|
|
34
47
|
* `auditRegistry` both make, for the same reason (0076).
|
|
35
48
|
*/
|
|
@@ -69,9 +82,15 @@ export declare const colourDifference: (a: string, b: string) => number | undefi
|
|
|
69
82
|
* **`also-marked`** — a rule, a border or an outline separates them as well, so
|
|
70
83
|
* the two colours are free to be equal. `minimal` is the argument for this
|
|
71
84
|
* basis existing: its `bg-surface` *is* its `bg-canvas`, deliberately, because
|
|
72
|
-
* every card in that palette is defined by its border.
|
|
73
|
-
*
|
|
74
|
-
*
|
|
85
|
+
* every card in that palette is defined by its border.
|
|
86
|
+
*
|
|
87
|
+
* What an `also-marked` row asserts is that **one** of the two signals works:
|
|
88
|
+
* the fills differ, or the mark between them does. That is the right question
|
|
89
|
+
* for *can a reader tell these two regions apart*, and it is weaker than it
|
|
90
|
+
* reads — a palette whose fills differ is never asked about its mark at all, so
|
|
91
|
+
* a border that draws nothing passes here. Whether each line the library
|
|
92
|
+
* declares can be seen at all is `auditMarkGroundings`, which asks it of every
|
|
93
|
+
* ground the slot lands on and does not take a fill difference as an answer.
|
|
75
94
|
*/
|
|
76
95
|
export type PeerBasis = "colour-only" | "also-marked";
|
|
77
96
|
type PeerBase = {
|
|
@@ -122,6 +141,81 @@ export type PeerPairing = (PeerBase & {
|
|
|
122
141
|
* pair anybody is being asked to tell apart.
|
|
123
142
|
*/
|
|
124
143
|
export declare const PALETTE_PEER_PAIRINGS: readonly PeerPairing[];
|
|
144
|
+
/**
|
|
145
|
+
* A slot the library draws as a line, and the grounds it is drawn against.
|
|
146
|
+
*
|
|
147
|
+
* The question a `PeerPairing` cannot ask. A pairing names two things a reader
|
|
148
|
+
* tells apart and treats a mark as a *defence* — something that may carry the
|
|
149
|
+
* pair when the two colours will not. So a mark is only ever measured when the
|
|
150
|
+
* colours it separates have collapsed, and a mark that draws nothing on a
|
|
151
|
+
* palette whose two fills happen to differ is never looked at.
|
|
152
|
+
*
|
|
153
|
+
* That is not a second way of asking the same thing. A border is a promise in
|
|
154
|
+
* its own right: the library declares an edge, and a palette that puts the edge
|
|
155
|
+
* within a just-noticeable difference of the fill behind it has erased a line
|
|
156
|
+
* the component says is there. Nothing else in the repository would say so —
|
|
157
|
+
* the region is still distinguishable, so `auditSeparation` passes, and every
|
|
158
|
+
* test that asks whether the token is real passes too, because the token is
|
|
159
|
+
* real. It is the module's own lesson at one turn further out: **a token is a
|
|
160
|
+
* promise about provenance, not about difference**, and a border tier is a
|
|
161
|
+
* promise about difference from whatever it lands on.
|
|
162
|
+
*
|
|
163
|
+
* `grounds` is every ground the library draws this slot against, not the one it
|
|
164
|
+
* was designed for. A line is judged against its nearest ground, because a rule
|
|
165
|
+
* that disappears into one of the three fills it is used on has disappeared.
|
|
166
|
+
*/
|
|
167
|
+
export type MarkGrounding = {
|
|
168
|
+
readonly mark: PaletteSlot;
|
|
169
|
+
readonly grounds: readonly PaletteSlot[];
|
|
170
|
+
/** Where the library draws it, so a failure names a primitive. */
|
|
171
|
+
readonly where: string;
|
|
172
|
+
};
|
|
173
|
+
/**
|
|
174
|
+
* Every slot the library draws as a line, with the grounds it lands on.
|
|
175
|
+
*
|
|
176
|
+
* Declared for the reason `PALETTE_PEER_PAIRINGS` is: a probe can see that
|
|
177
|
+
* `.loom-card` sets `border-color`, and nothing in the rule says the border is
|
|
178
|
+
* *meant to be seen* rather than to be the far side of a fill.
|
|
179
|
+
*
|
|
180
|
+
* The three tiers and what each is for is
|
|
181
|
+
* [0204](../../decisions/0204-a-rule-with-no-fill-beside-it-is-measured-in-delta-e.md)'s
|
|
182
|
+
* split, and the grounds are the three fills every one of them is drawn on:
|
|
183
|
+
* a page, a card, and a muted well. `border-accent` is not here — it is a ring
|
|
184
|
+
* a component draws to mean *this one*, and what it answers to is being
|
|
185
|
+
* different from the other tiers rather than from the ground.
|
|
186
|
+
*/
|
|
187
|
+
export declare const PALETTE_MARK_GROUNDINGS: readonly MarkGrounding[];
|
|
188
|
+
/** One slot against one of the grounds it is drawn on. */
|
|
189
|
+
export type MeasuredMark = {
|
|
190
|
+
readonly grounding: MarkGrounding;
|
|
191
|
+
readonly ground: PaletteSlot;
|
|
192
|
+
/** `undefined` when either colour is a form `channelsOf` declines to guess at. */
|
|
193
|
+
readonly difference: number | undefined;
|
|
194
|
+
/** False for a difference this could not measure: an undefended line is not a defended one. */
|
|
195
|
+
readonly visible: boolean;
|
|
196
|
+
};
|
|
197
|
+
/** What one palette does with the lines the library draws in it. */
|
|
198
|
+
export type MarkAudit = {
|
|
199
|
+
readonly palette: ThemeId;
|
|
200
|
+
readonly measured: readonly MeasuredMark[];
|
|
201
|
+
/**
|
|
202
|
+
* The lines a reader cannot find. A border the library declares and the
|
|
203
|
+
* palette does not draw — the list a host asserts empty.
|
|
204
|
+
*/
|
|
205
|
+
readonly invisible: readonly MeasuredMark[];
|
|
206
|
+
};
|
|
207
|
+
/**
|
|
208
|
+
* Measures every declared mark against every ground it is drawn on. Refuses
|
|
209
|
+
* nothing, decides nothing — the same bargain `auditSeparation` makes.
|
|
210
|
+
*
|
|
211
|
+
* Separate from `auditSeparation` rather than a fourth bucket inside it,
|
|
212
|
+
* because the two ask different questions of different shapes of declaration
|
|
213
|
+
* and a host may reasonably assert one and not the other: a palette may want
|
|
214
|
+
* two fills to be equal, and no palette wants a line it cannot see.
|
|
215
|
+
*/
|
|
216
|
+
export declare const auditMarkGroundings: (palette: Palette, groundings?: readonly MarkGrounding[]) => MarkAudit;
|
|
217
|
+
/** One line per invisible mark, for a CLI or a failing test's message. Empty when clean. */
|
|
218
|
+
export declare const describeMarkAudit: (audit: MarkAudit) => string;
|
|
125
219
|
/** A peer that was measured, whether or not it came apart. */
|
|
126
220
|
export type MeasuredPeer = {
|
|
127
221
|
readonly pairing: PeerPairing;
|
package/dist/theme/separation.js
CHANGED
|
@@ -30,6 +30,19 @@ import { labOf } from "./lab.js";
|
|
|
30
30
|
* the just-noticeable difference is a published property of human vision, not a
|
|
31
31
|
* number chosen to fit these palettes.
|
|
32
32
|
*
|
|
33
|
+
* ## The two questions in here
|
|
34
|
+
*
|
|
35
|
+
* **`auditSeparation`** asks whether two slots a reader is meant to tell apart
|
|
36
|
+
* can be told apart, and lets either the fills or a mark between them answer.
|
|
37
|
+
*
|
|
38
|
+
* **`auditMarkGroundings`** asks whether a line the library declares is a line a
|
|
39
|
+
* reader can find, against every ground it is drawn on. It was added on
|
|
40
|
+
* 29 September, five weeks after the module, because the first question cannot
|
|
41
|
+
* reach it: a mark is only measured there when the pair it separates has
|
|
42
|
+
* collapsed, so eight starter palettes were drawing a `border-subtle` edge
|
|
43
|
+
* within a just-noticeable difference of the fill it contained — one of them at
|
|
44
|
+
* ΔE 0.00 — with every test in this file green.
|
|
45
|
+
*
|
|
33
46
|
* It reports; it does not decide — the bargain `auditPalette` and
|
|
34
47
|
* `auditRegistry` both make, for the same reason (0076).
|
|
35
48
|
*/
|
|
@@ -145,6 +158,68 @@ export const PALETTE_PEER_PAIRINGS = [
|
|
|
145
158
|
where: "loom.code panel on a page; loom.callout marks the same pair harder",
|
|
146
159
|
},
|
|
147
160
|
];
|
|
161
|
+
/**
|
|
162
|
+
* Every slot the library draws as a line, with the grounds it lands on.
|
|
163
|
+
*
|
|
164
|
+
* Declared for the reason `PALETTE_PEER_PAIRINGS` is: a probe can see that
|
|
165
|
+
* `.loom-card` sets `border-color`, and nothing in the rule says the border is
|
|
166
|
+
* *meant to be seen* rather than to be the far side of a fill.
|
|
167
|
+
*
|
|
168
|
+
* The three tiers and what each is for is
|
|
169
|
+
* [0204](../../decisions/0204-a-rule-with-no-fill-beside-it-is-measured-in-delta-e.md)'s
|
|
170
|
+
* split, and the grounds are the three fills every one of them is drawn on:
|
|
171
|
+
* a page, a card, and a muted well. `border-accent` is not here — it is a ring
|
|
172
|
+
* a component draws to mean *this one*, and what it answers to is being
|
|
173
|
+
* different from the other tiers rather than from the ground.
|
|
174
|
+
*/
|
|
175
|
+
export const PALETTE_MARK_GROUNDINGS = [
|
|
176
|
+
{
|
|
177
|
+
mark: "border-subtle",
|
|
178
|
+
grounds: ["bg-canvas", "bg-surface", "bg-surface-muted"],
|
|
179
|
+
where: "the four-sided edge of a box: loom.card, loom.badge, loom.tier, loom.code's well",
|
|
180
|
+
},
|
|
181
|
+
{
|
|
182
|
+
mark: "border-default",
|
|
183
|
+
grounds: ["bg-canvas", "bg-surface", "bg-surface-muted"],
|
|
184
|
+
where: "hairline(): a rule between table rows, a timeline rail, the line under a nav",
|
|
185
|
+
},
|
|
186
|
+
{
|
|
187
|
+
mark: "border-strong",
|
|
188
|
+
grounds: ["bg-canvas", "bg-surface"],
|
|
189
|
+
where: "loom.table and loom.comparison-table, the one rule under a header",
|
|
190
|
+
},
|
|
191
|
+
];
|
|
192
|
+
/**
|
|
193
|
+
* Measures every declared mark against every ground it is drawn on. Refuses
|
|
194
|
+
* nothing, decides nothing — the same bargain `auditSeparation` makes.
|
|
195
|
+
*
|
|
196
|
+
* Separate from `auditSeparation` rather than a fourth bucket inside it,
|
|
197
|
+
* because the two ask different questions of different shapes of declaration
|
|
198
|
+
* and a host may reasonably assert one and not the other: a palette may want
|
|
199
|
+
* two fills to be equal, and no palette wants a line it cannot see.
|
|
200
|
+
*/
|
|
201
|
+
export const auditMarkGroundings = (palette, groundings = PALETTE_MARK_GROUNDINGS) => {
|
|
202
|
+
const measured = groundings.flatMap((grounding) => grounding.grounds.map((ground) => {
|
|
203
|
+
const difference = colourDifference(palette.slots[grounding.mark] ?? "", palette.slots[ground] ?? "");
|
|
204
|
+
return {
|
|
205
|
+
grounding,
|
|
206
|
+
ground,
|
|
207
|
+
difference,
|
|
208
|
+
visible: difference !== undefined && difference >= JUST_NOTICEABLE_DIFFERENCE,
|
|
209
|
+
};
|
|
210
|
+
}));
|
|
211
|
+
return {
|
|
212
|
+
palette: palette.id,
|
|
213
|
+
measured,
|
|
214
|
+
invisible: measured.filter((entry) => !entry.visible),
|
|
215
|
+
};
|
|
216
|
+
};
|
|
217
|
+
/** One line per invisible mark, for a CLI or a failing test's message. Empty when clean. */
|
|
218
|
+
export const describeMarkAudit = (audit) => audit.invisible
|
|
219
|
+
.map((entry) => entry.difference === undefined
|
|
220
|
+
? `${audit.palette}: ${entry.grounding.mark} on ${entry.ground} could not be measured (${entry.grounding.where})`
|
|
221
|
+
: `${audit.palette}: ${entry.grounding.mark} differs from ${entry.ground} by ${entry.difference.toFixed(2)}, under ${JUST_NOTICEABLE_DIFFERENCE} — the line is not there (${entry.grounding.where})`)
|
|
222
|
+
.join("\n");
|
|
148
223
|
const markOf = (pairing) => pairing.basis === "also-marked" ? pairing.mark : undefined;
|
|
149
224
|
/**
|
|
150
225
|
* How far a mark is from the *nearer* of the two it separates.
|
package/dist/tree/compare.d.ts
CHANGED
|
@@ -33,6 +33,15 @@ import type { LoomTree } from "./tree.js";
|
|
|
33
33
|
* primitive.
|
|
34
34
|
*/
|
|
35
35
|
export type NodeFacet = "kind" | "type" | "name" | "props" | "text" | "parent" | "position";
|
|
36
|
+
/**
|
|
37
|
+
* Every facet, for the things that have to walk them rather than react to one.
|
|
38
|
+
*
|
|
39
|
+
* `reseed.ts` is the caller that needs it: which facets a `configure` can close
|
|
40
|
+
* decides whether a page can be put back to its authored shape at all, and that
|
|
41
|
+
* list is only trustworthy if a facet added here cannot be left out of it. With
|
|
42
|
+
* this, it cannot — the subset is checked against this list where it is written.
|
|
43
|
+
*/
|
|
44
|
+
export declare const NODE_FACETS: readonly NodeFacet[];
|
|
36
45
|
export type TreeDifference =
|
|
37
46
|
/** Present in the base tree, absent from the compared one. */
|
|
38
47
|
{
|
package/dist/tree/compare.js
CHANGED
|
@@ -1,5 +1,23 @@
|
|
|
1
|
+
import { everyMemberOf } from "../closed-set.js";
|
|
1
2
|
import { nodeLabel } from "./node.js";
|
|
2
3
|
import { outlineTree } from "./outline.js";
|
|
4
|
+
/**
|
|
5
|
+
* Every facet, for the things that have to walk them rather than react to one.
|
|
6
|
+
*
|
|
7
|
+
* `reseed.ts` is the caller that needs it: which facets a `configure` can close
|
|
8
|
+
* decides whether a page can be put back to its authored shape at all, and that
|
|
9
|
+
* list is only trustworthy if a facet added here cannot be left out of it. With
|
|
10
|
+
* this, it cannot — the subset is checked against this list where it is written.
|
|
11
|
+
*/
|
|
12
|
+
export const NODE_FACETS = everyMemberOf()([
|
|
13
|
+
"kind",
|
|
14
|
+
"type",
|
|
15
|
+
"name",
|
|
16
|
+
"props",
|
|
17
|
+
"text",
|
|
18
|
+
"parent",
|
|
19
|
+
"position",
|
|
20
|
+
]);
|
|
3
21
|
/**
|
|
4
22
|
* Props are compared by their serialisation rather than key by key.
|
|
5
23
|
*
|
|
@@ -0,0 +1,60 @@
|
|
|
1
|
+
import type { ChangeInterpreter } from "../runtime/interpreter.js";
|
|
2
|
+
import type { CompositionRuntime } from "../runtime/pipeline.js";
|
|
3
|
+
/**
|
|
4
|
+
* The runtime a change the runtime computed is judged under.
|
|
5
|
+
*
|
|
6
|
+
* An undo and a reseed are both changes nothing interpreted: the operations are
|
|
7
|
+
* derived, and what reaches the Gate is a proposal wearing a deterministic
|
|
8
|
+
* interpreter instead of a model (`inverseInterpreter`). Both therefore want the
|
|
9
|
+
* same thing from the host's runtime — every seam that *judges* a change, and
|
|
10
|
+
* not the one that would offer a smaller version of it.
|
|
11
|
+
*
|
|
12
|
+
* ## Why this is a function and not two object literals
|
|
13
|
+
*
|
|
14
|
+
* `revertRevision` built its runtime field by field, and the comment above it
|
|
15
|
+
* said why: dropping the repairer should be a statement rather than an omission.
|
|
16
|
+
* That reasoning was right about the repairer and wrong about the method, and the
|
|
17
|
+
* difference only showed when `CompositionRuntime` grew. `propsVocabulary` and
|
|
18
|
+
* `bindingReader` arrived afterwards (0179, 0208), and a literal that names five
|
|
19
|
+
* fields does not fail to compile when a sixth appears — it silently stops
|
|
20
|
+
* passing it.
|
|
21
|
+
*
|
|
22
|
+
* So every undo was judged as though the host had wired neither check. Two
|
|
23
|
+
* consequences, and the second is worse than the first:
|
|
24
|
+
*
|
|
25
|
+
* - a deployment that refuses AI-authored props its own schemas reject did not
|
|
26
|
+
* refuse them on the undo path, which is a real hole in a real check;
|
|
27
|
+
* - `Disposition.wiredChecks` recorded the undo as judged with both seams
|
|
28
|
+
* absent, which is **0248's point inverted**. That field exists because the
|
|
29
|
+
* policy fingerprint cannot see a seam, so wiring one has to leave a record of
|
|
30
|
+
* the day it was wired. A record saying a wired check was not wired is worse
|
|
31
|
+
* than no record, because a later reading of the log cannot tell it from the
|
|
32
|
+
* truth.
|
|
33
|
+
*
|
|
34
|
+
* Nothing was failing. Nothing was going to start failing on its own, either:
|
|
35
|
+
* the drop is invisible to every test that does not wire a vocabulary *and* then
|
|
36
|
+
* undo something, and it would have been copied into the reseed path by anybody
|
|
37
|
+
* reading the revert path as the pattern — which is exactly what this run set
|
|
38
|
+
* out to do.
|
|
39
|
+
*
|
|
40
|
+
* ## How the drop is made impossible rather than remembered
|
|
41
|
+
*
|
|
42
|
+
* The repairer is removed by name and everything else is carried by the rest
|
|
43
|
+
* element, so the statement is still a statement — `repairer` is written down,
|
|
44
|
+
* right here, as the one field a computed change does not get — while a seventh
|
|
45
|
+
* seam on `CompositionRuntime` reaches the Gate on the day it lands without
|
|
46
|
+
* anybody editing this file.
|
|
47
|
+
*
|
|
48
|
+
* Repair (0006) exists to let a model try a smaller version of what the Gate
|
|
49
|
+
* refused, and there is no smaller version of putting something back. A computed
|
|
50
|
+
* change the Gate refuses is refused.
|
|
51
|
+
*/
|
|
52
|
+
/**
|
|
53
|
+
* The host's runtime, with every judging seam carried and the repairer dropped.
|
|
54
|
+
*
|
|
55
|
+
* `repairer` is removed by name and the rest is spread, so the omission is still
|
|
56
|
+
* written down while a seam added to `CompositionRuntime` tomorrow reaches the
|
|
57
|
+
* Gate without anybody editing this file.
|
|
58
|
+
*/
|
|
59
|
+
export declare const computedChangeRuntime: (runtime: CompositionRuntime, interpreter: ChangeInterpreter) => CompositionRuntime;
|
|
60
|
+
//# sourceMappingURL=computed.d.ts.map
|
|
@@ -0,0 +1,61 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The runtime a change the runtime computed is judged under.
|
|
3
|
+
*
|
|
4
|
+
* An undo and a reseed are both changes nothing interpreted: the operations are
|
|
5
|
+
* derived, and what reaches the Gate is a proposal wearing a deterministic
|
|
6
|
+
* interpreter instead of a model (`inverseInterpreter`). Both therefore want the
|
|
7
|
+
* same thing from the host's runtime — every seam that *judges* a change, and
|
|
8
|
+
* not the one that would offer a smaller version of it.
|
|
9
|
+
*
|
|
10
|
+
* ## Why this is a function and not two object literals
|
|
11
|
+
*
|
|
12
|
+
* `revertRevision` built its runtime field by field, and the comment above it
|
|
13
|
+
* said why: dropping the repairer should be a statement rather than an omission.
|
|
14
|
+
* That reasoning was right about the repairer and wrong about the method, and the
|
|
15
|
+
* difference only showed when `CompositionRuntime` grew. `propsVocabulary` and
|
|
16
|
+
* `bindingReader` arrived afterwards (0179, 0208), and a literal that names five
|
|
17
|
+
* fields does not fail to compile when a sixth appears — it silently stops
|
|
18
|
+
* passing it.
|
|
19
|
+
*
|
|
20
|
+
* So every undo was judged as though the host had wired neither check. Two
|
|
21
|
+
* consequences, and the second is worse than the first:
|
|
22
|
+
*
|
|
23
|
+
* - a deployment that refuses AI-authored props its own schemas reject did not
|
|
24
|
+
* refuse them on the undo path, which is a real hole in a real check;
|
|
25
|
+
* - `Disposition.wiredChecks` recorded the undo as judged with both seams
|
|
26
|
+
* absent, which is **0248's point inverted**. That field exists because the
|
|
27
|
+
* policy fingerprint cannot see a seam, so wiring one has to leave a record of
|
|
28
|
+
* the day it was wired. A record saying a wired check was not wired is worse
|
|
29
|
+
* than no record, because a later reading of the log cannot tell it from the
|
|
30
|
+
* truth.
|
|
31
|
+
*
|
|
32
|
+
* Nothing was failing. Nothing was going to start failing on its own, either:
|
|
33
|
+
* the drop is invisible to every test that does not wire a vocabulary *and* then
|
|
34
|
+
* undo something, and it would have been copied into the reseed path by anybody
|
|
35
|
+
* reading the revert path as the pattern — which is exactly what this run set
|
|
36
|
+
* out to do.
|
|
37
|
+
*
|
|
38
|
+
* ## How the drop is made impossible rather than remembered
|
|
39
|
+
*
|
|
40
|
+
* The repairer is removed by name and everything else is carried by the rest
|
|
41
|
+
* element, so the statement is still a statement — `repairer` is written down,
|
|
42
|
+
* right here, as the one field a computed change does not get — while a seventh
|
|
43
|
+
* seam on `CompositionRuntime` reaches the Gate on the day it lands without
|
|
44
|
+
* anybody editing this file.
|
|
45
|
+
*
|
|
46
|
+
* Repair (0006) exists to let a model try a smaller version of what the Gate
|
|
47
|
+
* refused, and there is no smaller version of putting something back. A computed
|
|
48
|
+
* change the Gate refuses is refused.
|
|
49
|
+
*/
|
|
50
|
+
/**
|
|
51
|
+
* The host's runtime, with every judging seam carried and the repairer dropped.
|
|
52
|
+
*
|
|
53
|
+
* `repairer` is removed by name and the rest is spread, so the omission is still
|
|
54
|
+
* written down while a seam added to `CompositionRuntime` tomorrow reaches the
|
|
55
|
+
* Gate without anybody editing this file.
|
|
56
|
+
*/
|
|
57
|
+
export const computedChangeRuntime = (runtime, interpreter) => {
|
|
58
|
+
const { repairer: _norepair, ...judging } = runtime;
|
|
59
|
+
return { ...judging, interpreter };
|
|
60
|
+
};
|
|
61
|
+
//# sourceMappingURL=computed.js.map
|
package/dist/write/held.d.ts
CHANGED
|
@@ -319,6 +319,29 @@ export declare const heldProposalSchema: z.ZodObject<{
|
|
|
319
319
|
confidence: z.ZodNumber;
|
|
320
320
|
policyId: z.ZodDefault<z.ZodString>;
|
|
321
321
|
policyFingerprint: z.ZodOptional<z.ZodString>;
|
|
322
|
+
wiredChecks: z.ZodOptional<z.ZodArray<z.ZodEnum<["props", "bindings", "regions"]>, "many">>;
|
|
323
|
+
irreversibilityReasons: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<"code", [z.ZodObject<{
|
|
324
|
+
code: z.ZodLiteral<"out-of-tree-effect">;
|
|
325
|
+
primitiveTypes: z.ZodArray<z.ZodBranded<z.ZodString, "PrimitiveType">, "many">;
|
|
326
|
+
}, "strip", z.ZodTypeAny, {
|
|
327
|
+
code: "out-of-tree-effect";
|
|
328
|
+
primitiveTypes: (string & z.BRAND<"PrimitiveType">)[];
|
|
329
|
+
}, {
|
|
330
|
+
code: "out-of-tree-effect";
|
|
331
|
+
primitiveTypes: string[];
|
|
332
|
+
}>, z.ZodObject<{
|
|
333
|
+
code: z.ZodLiteral<"retention-budget-exceeded">;
|
|
334
|
+
retainedNodeCount: z.ZodNumber;
|
|
335
|
+
budget: z.ZodNumber;
|
|
336
|
+
}, "strip", z.ZodTypeAny, {
|
|
337
|
+
code: "retention-budget-exceeded";
|
|
338
|
+
retainedNodeCount: number;
|
|
339
|
+
budget: number;
|
|
340
|
+
}, {
|
|
341
|
+
code: "retention-budget-exceeded";
|
|
342
|
+
retainedNodeCount: number;
|
|
343
|
+
budget: number;
|
|
344
|
+
}>]>, "many">>;
|
|
322
345
|
}, "strip", z.ZodTypeAny, {
|
|
323
346
|
kind: "rejected" | "accepted" | "requires-confirmation";
|
|
324
347
|
confidence: number;
|
|
@@ -330,6 +353,15 @@ export declare const heldProposalSchema: z.ZodObject<{
|
|
|
330
353
|
stakes: "low" | "medium" | "high" | "critical";
|
|
331
354
|
reversible: boolean;
|
|
332
355
|
policyFingerprint?: string | undefined;
|
|
356
|
+
wiredChecks?: ("props" | "bindings" | "regions")[] | undefined;
|
|
357
|
+
irreversibilityReasons?: ({
|
|
358
|
+
code: "out-of-tree-effect";
|
|
359
|
+
primitiveTypes: (string & z.BRAND<"PrimitiveType">)[];
|
|
360
|
+
} | {
|
|
361
|
+
code: "retention-budget-exceeded";
|
|
362
|
+
retainedNodeCount: number;
|
|
363
|
+
budget: number;
|
|
364
|
+
})[] | undefined;
|
|
333
365
|
}, {
|
|
334
366
|
kind: "rejected" | "accepted" | "requires-confirmation";
|
|
335
367
|
confidence: number;
|
|
@@ -341,6 +373,15 @@ export declare const heldProposalSchema: z.ZodObject<{
|
|
|
341
373
|
reversible: boolean;
|
|
342
374
|
policyId?: string | undefined;
|
|
343
375
|
policyFingerprint?: string | undefined;
|
|
376
|
+
wiredChecks?: ("props" | "bindings" | "regions")[] | undefined;
|
|
377
|
+
irreversibilityReasons?: ({
|
|
378
|
+
code: "out-of-tree-effect";
|
|
379
|
+
primitiveTypes: string[];
|
|
380
|
+
} | {
|
|
381
|
+
code: "retention-budget-exceeded";
|
|
382
|
+
retainedNodeCount: number;
|
|
383
|
+
budget: number;
|
|
384
|
+
})[] | undefined;
|
|
344
385
|
}>;
|
|
345
386
|
heldAt: z.ZodString;
|
|
346
387
|
}, "strip", z.ZodTypeAny, {
|
|
@@ -402,6 +443,15 @@ export declare const heldProposalSchema: z.ZodObject<{
|
|
|
402
443
|
stakes: "low" | "medium" | "high" | "critical";
|
|
403
444
|
reversible: boolean;
|
|
404
445
|
policyFingerprint?: string | undefined;
|
|
446
|
+
wiredChecks?: ("props" | "bindings" | "regions")[] | undefined;
|
|
447
|
+
irreversibilityReasons?: ({
|
|
448
|
+
code: "out-of-tree-effect";
|
|
449
|
+
primitiveTypes: (string & z.BRAND<"PrimitiveType">)[];
|
|
450
|
+
} | {
|
|
451
|
+
code: "retention-budget-exceeded";
|
|
452
|
+
retainedNodeCount: number;
|
|
453
|
+
budget: number;
|
|
454
|
+
})[] | undefined;
|
|
405
455
|
};
|
|
406
456
|
intent: {
|
|
407
457
|
treeId: string & z.BRAND<"TreeId">;
|
|
@@ -473,6 +523,15 @@ export declare const heldProposalSchema: z.ZodObject<{
|
|
|
473
523
|
reversible: boolean;
|
|
474
524
|
policyId?: string | undefined;
|
|
475
525
|
policyFingerprint?: string | undefined;
|
|
526
|
+
wiredChecks?: ("props" | "bindings" | "regions")[] | undefined;
|
|
527
|
+
irreversibilityReasons?: ({
|
|
528
|
+
code: "out-of-tree-effect";
|
|
529
|
+
primitiveTypes: string[];
|
|
530
|
+
} | {
|
|
531
|
+
code: "retention-budget-exceeded";
|
|
532
|
+
retainedNodeCount: number;
|
|
533
|
+
budget: number;
|
|
534
|
+
})[] | undefined;
|
|
476
535
|
};
|
|
477
536
|
intent: {
|
|
478
537
|
treeId: string;
|
package/dist/write/index.d.ts
CHANGED
|
@@ -1,11 +1,14 @@
|
|
|
1
1
|
/**
|
|
2
2
|
* Committing a judged change, and taking one back.
|
|
3
3
|
*
|
|
4
|
-
* The
|
|
5
|
-
*
|
|
4
|
+
* The operations that move a tree forward or backward in the store once the gate
|
|
5
|
+
* has had its say — including the two it computes itself, which take the same
|
|
6
|
+
* path as the ones a model proposes.
|
|
6
7
|
*/
|
|
7
8
|
export * from "./commit.js";
|
|
9
|
+
export * from "./computed.js";
|
|
8
10
|
export * from "./held.js";
|
|
9
11
|
export * from "./liveness.js";
|
|
12
|
+
export * from "./reseed.js";
|
|
10
13
|
export * from "./revert.js";
|
|
11
14
|
//# sourceMappingURL=index.d.ts.map
|
package/dist/write/index.js
CHANGED
|
@@ -1,11 +1,14 @@
|
|
|
1
1
|
/**
|
|
2
2
|
* Committing a judged change, and taking one back.
|
|
3
3
|
*
|
|
4
|
-
* The
|
|
5
|
-
*
|
|
4
|
+
* The operations that move a tree forward or backward in the store once the gate
|
|
5
|
+
* has had its say — including the two it computes itself, which take the same
|
|
6
|
+
* path as the ones a model proposes.
|
|
6
7
|
*/
|
|
7
8
|
export * from "./commit.js";
|
|
9
|
+
export * from "./computed.js";
|
|
8
10
|
export * from "./held.js";
|
|
9
11
|
export * from "./liveness.js";
|
|
12
|
+
export * from "./reseed.js";
|
|
10
13
|
export * from "./revert.js";
|
|
11
14
|
//# sourceMappingURL=index.js.map
|