@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.
Files changed (290) hide show
  1. package/README.md +3 -1
  2. package/dist/application/application.d.ts +109 -0
  3. package/dist/application/application.js +97 -0
  4. package/dist/application/memory.d.ts +20 -0
  5. package/dist/application/memory.js +79 -0
  6. package/dist/application/store.d.ts +101 -0
  7. package/dist/application/store.js +25 -0
  8. package/dist/audience/audience.d.ts +36 -0
  9. package/dist/audience/audience.js +41 -0
  10. package/dist/cli/templates.js +19 -0
  11. package/dist/data/plan.js +0 -0
  12. package/dist/data/resolution.d.ts +23 -1
  13. package/dist/data/resolve.d.ts +30 -3
  14. package/dist/data/resolve.js +11 -3
  15. package/dist/ids.d.ts +10 -0
  16. package/dist/ids.js +11 -1
  17. package/dist/index.d.ts +1 -0
  18. package/dist/index.js +1 -0
  19. package/dist/patch.d.ts +54 -0
  20. package/dist/patch.js +44 -0
  21. package/dist/project/closing.d.ts +51 -0
  22. package/dist/project/closing.js +53 -0
  23. package/dist/project/memory.d.ts +20 -0
  24. package/dist/project/memory.js +97 -0
  25. package/dist/project/project.d.ts +90 -0
  26. package/dist/project/project.js +91 -0
  27. package/dist/project/store.d.ts +135 -0
  28. package/dist/project/store.js +41 -0
  29. package/dist/registered.d.ts +64 -0
  30. package/dist/registered.js +118 -0
  31. package/dist/render/behaviour-adjust.d.ts +11 -19
  32. package/dist/render/behaviour-adjust.js +75 -21
  33. package/dist/render/behaviour-present.d.ts +8 -0
  34. package/dist/render/behaviour-present.js +57 -6
  35. package/dist/render/behaviour.d.ts +98 -17
  36. package/dist/render/behaviour.js +91 -26
  37. package/dist/render/control-name.d.ts +68 -0
  38. package/dist/render/control-name.js +37 -0
  39. package/dist/render/diagnostics.d.ts +72 -0
  40. package/dist/render/diagnostics.js +7 -0
  41. package/dist/render/index.d.ts +2 -0
  42. package/dist/render/index.js +2 -0
  43. package/dist/render/reads.d.ts +11 -0
  44. package/dist/render/reads.js +12 -1
  45. package/dist/render/render.js +102 -7
  46. package/dist/render/slots.d.ts +52 -0
  47. package/dist/render/slots.js +24 -0
  48. package/dist/render/theme.d.ts +54 -1
  49. package/dist/render/theme.js +23 -1
  50. package/dist/render/unshown.d.ts +152 -0
  51. package/dist/render/unshown.js +80 -0
  52. package/dist/runtime/analysis.d.ts +94 -9
  53. package/dist/runtime/analysis.js +54 -9
  54. package/dist/runtime/assessment.d.ts +36 -2
  55. package/dist/runtime/assessment.js +27 -2
  56. package/dist/runtime/checks.d.ts +148 -0
  57. package/dist/runtime/checks.js +112 -0
  58. package/dist/runtime/disposition.d.ts +96 -0
  59. package/dist/runtime/disposition.js +46 -0
  60. package/dist/runtime/gate.js +22 -0
  61. package/dist/runtime/index.d.ts +3 -0
  62. package/dist/runtime/index.js +3 -0
  63. package/dist/runtime/irreversibility.d.ts +64 -0
  64. package/dist/runtime/irreversibility.js +45 -0
  65. package/dist/runtime/pipeline.d.ts +43 -0
  66. package/dist/runtime/pipeline.js +10 -2
  67. package/dist/runtime/policy-change.d.ts +93 -0
  68. package/dist/runtime/policy-change.js +299 -0
  69. package/dist/runtime/policy-log.d.ts +406 -0
  70. package/dist/runtime/policy-log.js +285 -0
  71. package/dist/runtime/reversibility.d.ts +11 -9
  72. package/dist/runtime/stakes.d.ts +129 -1
  73. package/dist/runtime/stakes.js +240 -26
  74. package/dist/runtime/vocabulary.d.ts +164 -7
  75. package/dist/runtime/vocabulary.js +181 -8
  76. package/dist/sdk/audit.d.ts +174 -3
  77. package/dist/sdk/audit.js +176 -17
  78. package/dist/sdk/catalogue.d.ts +9 -1
  79. package/dist/sdk/conformance.d.ts +37 -3
  80. package/dist/sdk/conformance.js +25 -4
  81. package/dist/sdk/definition.d.ts +65 -0
  82. package/dist/sdk/definition.js +22 -0
  83. package/dist/sdk/registry.d.ts +29 -2
  84. package/dist/sdk/registry.js +63 -1
  85. package/dist/signals/action-change.d.ts +507 -0
  86. package/dist/signals/action-change.js +265 -0
  87. package/dist/signals/action.d.ts +331 -0
  88. package/dist/signals/action.js +182 -0
  89. package/dist/signals/applied-window.contract.d.ts +23 -0
  90. package/dist/signals/applied-window.contract.js +160 -0
  91. package/dist/signals/arriving.d.ts +210 -0
  92. package/dist/signals/arriving.js +133 -0
  93. package/dist/signals/audiences.d.ts +528 -0
  94. package/dist/signals/audiences.js +255 -0
  95. package/dist/signals/broadcast.d.ts +8 -2
  96. package/dist/signals/broadcast.js +58 -8
  97. package/dist/signals/change.d.ts +378 -0
  98. package/dist/signals/change.js +327 -0
  99. package/dist/signals/collect.d.ts +41 -0
  100. package/dist/signals/collect.js +88 -7
  101. package/dist/signals/copy-change.d.ts +553 -0
  102. package/dist/signals/copy-change.js +377 -0
  103. package/dist/signals/copy.d.ts +337 -0
  104. package/dist/signals/copy.js +211 -0
  105. package/dist/signals/counters.d.ts +46 -0
  106. package/dist/signals/counters.js +102 -0
  107. package/dist/signals/deliver.d.ts +23 -4
  108. package/dist/signals/deliver.js +34 -6
  109. package/dist/signals/deployment-change.d.ts +371 -0
  110. package/dist/signals/deployment-change.js +268 -0
  111. package/dist/signals/deployment.d.ts +265 -0
  112. package/dist/signals/deployment.js +152 -0
  113. package/dist/signals/door.d.ts +92 -0
  114. package/dist/signals/door.js +53 -0
  115. package/dist/signals/fold.d.ts +10 -0
  116. package/dist/signals/fold.js +5 -1
  117. package/dist/signals/form-action.d.ts +302 -0
  118. package/dist/signals/form-action.js +169 -0
  119. package/dist/signals/form-copy.d.ts +523 -0
  120. package/dist/signals/form-copy.js +346 -0
  121. package/dist/signals/forms.d.ts +247 -0
  122. package/dist/signals/forms.js +147 -0
  123. package/dist/signals/funnel-change.d.ts +548 -0
  124. package/dist/signals/funnel-change.js +361 -0
  125. package/dist/signals/funnel.d.ts +532 -0
  126. package/dist/signals/funnel.js +216 -0
  127. package/dist/signals/health.d.ts +497 -0
  128. package/dist/signals/health.js +361 -0
  129. package/dist/signals/index.d.ts +41 -0
  130. package/dist/signals/index.js +41 -0
  131. package/dist/signals/ingest.d.ts +56 -1
  132. package/dist/signals/ingest.js +91 -1
  133. package/dist/signals/journal.d.ts +11 -0
  134. package/dist/signals/kinds.d.ts +8 -6
  135. package/dist/signals/kinds.js +14 -6
  136. package/dist/signals/library-action.d.ts +430 -0
  137. package/dist/signals/library-action.js +336 -0
  138. package/dist/signals/library-change.d.ts +477 -0
  139. package/dist/signals/library-change.js +335 -0
  140. package/dist/signals/library-copy-change.d.ts +498 -0
  141. package/dist/signals/library-copy-change.js +476 -0
  142. package/dist/signals/library-pace.d.ts +319 -0
  143. package/dist/signals/library-pace.js +305 -0
  144. package/dist/signals/library-reach-change.d.ts +636 -0
  145. package/dist/signals/library-reach-change.js +534 -0
  146. package/dist/signals/library-reach.d.ts +377 -0
  147. package/dist/signals/library-reach.js +227 -0
  148. package/dist/signals/library-word-reach-change.d.ts +567 -0
  149. package/dist/signals/library-word-reach-change.js +568 -0
  150. package/dist/signals/library.d.ts +306 -0
  151. package/dist/signals/library.js +178 -0
  152. package/dist/signals/memory.d.ts +9 -0
  153. package/dist/signals/memory.js +105 -14
  154. package/dist/signals/migrate.d.ts +17 -2
  155. package/dist/signals/migrate.js +122 -5
  156. package/dist/signals/notice.d.ts +334 -0
  157. package/dist/signals/notice.js +228 -0
  158. package/dist/signals/pace-change.d.ts +501 -0
  159. package/dist/signals/pace-change.js +310 -0
  160. package/dist/signals/pace.d.ts +296 -0
  161. package/dist/signals/pace.js +291 -0
  162. package/dist/signals/page-views.d.ts +365 -0
  163. package/dist/signals/page-views.js +218 -0
  164. package/dist/signals/parts.d.ts +344 -0
  165. package/dist/signals/parts.js +273 -0
  166. package/dist/signals/postgres.d.ts +16 -2
  167. package/dist/signals/postgres.js +390 -87
  168. package/dist/signals/progress.d.ts +212 -0
  169. package/dist/signals/progress.js +150 -0
  170. package/dist/signals/ratios.d.ts +108 -0
  171. package/dist/signals/ratios.js +40 -0
  172. package/dist/signals/reach.d.ts +309 -0
  173. package/dist/signals/reach.js +93 -0
  174. package/dist/signals/readable.d.ts +34 -0
  175. package/dist/signals/readable.js +34 -0
  176. package/dist/signals/readership.d.ts +381 -0
  177. package/dist/signals/readership.js +308 -0
  178. package/dist/signals/region-pages.d.ts +173 -0
  179. package/dist/signals/region-pages.js +62 -0
  180. package/dist/signals/region.d.ts +287 -0
  181. package/dist/signals/region.js +198 -0
  182. package/dist/signals/retention.d.ts +141 -0
  183. package/dist/signals/retention.js +58 -0
  184. package/dist/signals/rollup.d.ts +67 -3
  185. package/dist/signals/rollup.js +0 -0
  186. package/dist/signals/schema.d.ts +432 -1
  187. package/dist/signals/schema.js +157 -3
  188. package/dist/signals/signal.d.ts +237 -11
  189. package/dist/signals/signal.js +70 -10
  190. package/dist/signals/silence-census.d.ts +205 -0
  191. package/dist/signals/silence-census.js +87 -0
  192. package/dist/signals/silences.d.ts +848 -0
  193. package/dist/signals/silences.js +753 -0
  194. package/dist/signals/tally.d.ts +140 -11
  195. package/dist/signals/window-figures.d.ts +148 -0
  196. package/dist/signals/window-figures.js +42 -0
  197. package/dist/signals/window.d.ts +866 -0
  198. package/dist/signals/window.js +693 -0
  199. package/dist/signals/words.d.ts +24 -0
  200. package/dist/signals/words.js +24 -0
  201. package/dist/store/index.d.ts +19 -0
  202. package/dist/store/index.js +19 -0
  203. package/dist/store/memory.d.ts +2 -1
  204. package/dist/store/memory.js +48 -12
  205. package/dist/store/migrate.d.ts +80 -0
  206. package/dist/store/migrate.js +259 -7
  207. package/dist/store/postgres-applications.d.ts +4 -0
  208. package/dist/store/postgres-applications.js +197 -0
  209. package/dist/store/postgres-holds.d.ts +10 -1
  210. package/dist/store/postgres-holds.js +116 -101
  211. package/dist/store/postgres-policy-log.d.ts +14 -0
  212. package/dist/store/postgres-policy-log.js +240 -0
  213. package/dist/store/postgres-projects.d.ts +4 -0
  214. package/dist/store/postgres-projects.js +217 -0
  215. package/dist/store/postgres.d.ts +16 -1
  216. package/dist/store/postgres.js +59 -9
  217. package/dist/store/replay.d.ts +102 -1
  218. package/dist/store/replay.js +190 -19
  219. package/dist/store/reseed.d.ts +238 -0
  220. package/dist/store/reseed.js +308 -0
  221. package/dist/store/schema.d.ts +450 -2
  222. package/dist/store/schema.js +141 -5
  223. package/dist/store/store.d.ts +29 -6
  224. package/dist/submit/resolve.js +2 -1
  225. package/dist/telemetry/calibration.d.ts +25 -0
  226. package/dist/telemetry/calibration.js +27 -1
  227. package/dist/telemetry/event.d.ts +391 -33
  228. package/dist/telemetry/event.js +84 -20
  229. package/dist/telemetry/index.d.ts +1 -0
  230. package/dist/telemetry/index.js +1 -0
  231. package/dist/telemetry/journal.d.ts +72 -3
  232. package/dist/telemetry/journal.js +9 -0
  233. package/dist/telemetry/lookup.d.ts +27 -0
  234. package/dist/telemetry/lookup.js +18 -0
  235. package/dist/telemetry/memory.js +23 -0
  236. package/dist/telemetry/migrate.js +22 -1
  237. package/dist/telemetry/postgres.d.ts +10 -1
  238. package/dist/telemetry/postgres.js +172 -90
  239. package/dist/telemetry/remeasure.d.ts +78 -0
  240. package/dist/telemetry/remeasure.js +83 -0
  241. package/dist/telemetry/retention.d.ts +2 -2
  242. package/dist/telemetry/schema.d.ts +17 -0
  243. package/dist/telemetry/schema.js +27 -1
  244. package/dist/telemetry/sink.d.ts +2 -2
  245. package/dist/testing/application-contract.d.ts +14 -0
  246. package/dist/testing/application-contract.js +270 -0
  247. package/dist/testing/contracts.d.ts +12 -7
  248. package/dist/testing/contracts.js +12 -7
  249. package/dist/testing/definitions.d.ts +78 -0
  250. package/dist/testing/definitions.js +134 -9
  251. package/dist/testing/doubles.d.ts +103 -0
  252. package/dist/testing/doubles.js +143 -0
  253. package/dist/testing/index.d.ts +2 -2
  254. package/dist/testing/index.js +2 -2
  255. package/dist/testing/journal-contract.js +140 -2
  256. package/dist/testing/model-contract.d.ts +110 -0
  257. package/dist/testing/model-contract.js +150 -0
  258. package/dist/testing/policy-log-contract.d.ts +26 -0
  259. package/dist/testing/policy-log-contract.js +344 -0
  260. package/dist/testing/project-contract.d.ts +14 -0
  261. package/dist/testing/project-contract.js +266 -0
  262. package/dist/testing/reader-signal-contract.d.ts +27 -2
  263. package/dist/testing/reader-signal-contract.js +475 -5
  264. package/dist/testing/store-contract.d.ts +7 -1
  265. package/dist/testing/store-contract.js +84 -3
  266. package/dist/theme/apply.d.ts +20 -1
  267. package/dist/theme/apply.js +5 -3
  268. package/dist/theme/derive.d.ts +22 -0
  269. package/dist/theme/derive.js +54 -1
  270. package/dist/theme/library.js +1 -1
  271. package/dist/theme/measure.d.ts +34 -0
  272. package/dist/theme/measure.js +30 -1
  273. package/dist/theme/palettes.js +7 -7
  274. package/dist/theme/ramp.d.ts +64 -0
  275. package/dist/theme/ramp.js +114 -0
  276. package/dist/theme/registry.d.ts +9 -0
  277. package/dist/theme/registry.js +11 -1
  278. package/dist/theme/separation.d.ts +97 -3
  279. package/dist/theme/separation.js +75 -0
  280. package/dist/tree/compare.d.ts +9 -0
  281. package/dist/tree/compare.js +18 -0
  282. package/dist/write/computed.d.ts +60 -0
  283. package/dist/write/computed.js +61 -0
  284. package/dist/write/held.d.ts +59 -0
  285. package/dist/write/index.d.ts +5 -2
  286. package/dist/write/index.js +5 -2
  287. package/dist/write/reseed.d.ts +151 -0
  288. package/dist/write/reseed.js +184 -0
  289. package/dist/write/revert.js +2 -16
  290. package/package.json +98 -19
@@ -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.available.join(", ") || "none"}.`;
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. What is asserted for
73
- * these is the weaker and still real claim — the mark itself has to be visible
74
- * against both.
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;
@@ -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.
@@ -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
  {
@@ -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
@@ -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;
@@ -1,11 +1,14 @@
1
1
  /**
2
2
  * Committing a judged change, and taking one back.
3
3
  *
4
- * The three operations that move a tree forward or backward in the store once the
5
- * gate has had its say.
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
@@ -1,11 +1,14 @@
1
1
  /**
2
2
  * Committing a judged change, and taking one back.
3
3
  *
4
- * The three operations that move a tree forward or backward in the store once the
5
- * gate has had its say.
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