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