@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,305 @@
1
+ import { compareCeilings } from "./auto-apply-ceiling.js";
2
+ import { policyFingerprintOf } from "./policy-fingerprint.js";
3
+ import { compareStakes } from "./stake-level.js";
4
+ const compareStrings = (left, right) => left < right ? -1 : left > right ? 1 : 0;
5
+ const sorted = (values) => Array.from(new Set(values)).sort(compareStrings);
6
+ const missingFrom = (members, other) => {
7
+ const held = new Set(other);
8
+ return members.filter((member) => !held.has(member));
9
+ };
10
+ const list = (members) => members.join(", ");
11
+ /**
12
+ * The direction a gained-and-lost pair points in, given what gaining means.
13
+ *
14
+ * Written once because every set and map field in a policy is one of these two
15
+ * shapes and the fold is identical; what differs between fields is only whether
16
+ * a longer list is a tighter gate, which is the `gaining` argument.
17
+ */
18
+ const directionOf = (gained, lost, gaining) => {
19
+ if (gained && lost)
20
+ return "mixed";
21
+ /**
22
+ * Total on purpose, as `policyShapeOf` is. No caller reaches it — each returns
23
+ * early when nothing moved — and a helper that answered `undefined` for the
24
+ * one case it cannot order would push the question to three call sites that
25
+ * have already decided it.
26
+ */
27
+ if (!gained && !lost)
28
+ return "incomparable";
29
+ const losing = gaining === "stricter" ? "looser" : "stricter";
30
+ return gained ? gaining : losing;
31
+ };
32
+ /**
33
+ * A set field, compared.
34
+ *
35
+ * `gaining` is the field's own semantics and the only thing that varies: adding
36
+ * a protected primitive type elevates more changes, so the list getting longer
37
+ * is a tighter gate — while adding a registered primitive type permits an insert
38
+ * that was refused, so there it is a looser one.
39
+ */
40
+ const setChange = (field, was, now, gaining) => {
41
+ const before = sorted(was);
42
+ const after = sorted(now);
43
+ const added = missingFrom(after, before);
44
+ const removed = missingFrom(before, after);
45
+ if (added.length === 0 && removed.length === 0)
46
+ return undefined;
47
+ const parts = [
48
+ ...(added.length > 0 ? [`added ${list(added)}`] : []),
49
+ ...(removed.length > 0 ? [`removed ${list(removed)}`] : []),
50
+ ];
51
+ return {
52
+ field,
53
+ direction: directionOf(added.length > 0, removed.length > 0, gaining),
54
+ detail: parts.join("; "),
55
+ };
56
+ };
57
+ /**
58
+ * A number field, compared. `raising` is the field's semantics, as `gaining` is
59
+ * for a set: a higher `minimumConfidence` holds more changes back, while a
60
+ * higher `breadthThreshold` lets a broader change stay unremarkable.
61
+ */
62
+ const numberChange = (field, was, now, raising) => {
63
+ if (was === now)
64
+ return undefined;
65
+ const lowering = raising === "stricter" ? "looser" : "stricter";
66
+ return {
67
+ field,
68
+ direction: now > was ? raising : lowering,
69
+ detail: `${was} became ${now}`,
70
+ };
71
+ };
72
+ /**
73
+ * The interactive-types vocabulary, compared as a map of conditions.
74
+ *
75
+ * An entry whose condition changed is counted as both a gain and a loss, so it
76
+ * reports `mixed` rather than picking a side: `always` becoming
77
+ * `when: ["href"]` narrows which nodes are treated as targets, and widening the
78
+ * prop list widens it back, and the two are not comparable through one entry's
79
+ * `whenProps` without claiming to know the host's tree.
80
+ */
81
+ const interactiveChange = (was, now) => {
82
+ /**
83
+ * `Object.hasOwn` before the read, which is not belt-and-braces: these keys
84
+ * are primitive types a host wrote, and `interactivity.ts` records the trap —
85
+ * a type named `constructor` or `toString` reads a function off
86
+ * `Object.prototype` instead of answering "absent". Here that would be a
87
+ * comparison crashing on a policy the Gate judges perfectly well.
88
+ */
89
+ const describe = (types, type) => {
90
+ const when = Object.hasOwn(types, type)
91
+ ? types[type]
92
+ : undefined;
93
+ return when === undefined
94
+ ? undefined
95
+ : when === "always"
96
+ ? "always"
97
+ : `when ${list(sorted(when.whenProps))}`;
98
+ };
99
+ const types = sorted([...Object.keys(was), ...Object.keys(now)]);
100
+ const added = [];
101
+ const removed = [];
102
+ const altered = [];
103
+ for (const type of types) {
104
+ const before = describe(was, type);
105
+ const after = describe(now, type);
106
+ if (before === after)
107
+ continue;
108
+ if (before === undefined)
109
+ added.push(`${type} (${after})`);
110
+ else if (after === undefined)
111
+ removed.push(type);
112
+ else
113
+ altered.push(`${type} (${before} became ${after})`);
114
+ }
115
+ if (added.length === 0 && removed.length === 0 && altered.length === 0)
116
+ return undefined;
117
+ const parts = [
118
+ ...(added.length > 0 ? [`added ${list(added)}`] : []),
119
+ ...(removed.length > 0 ? [`removed ${list(removed)}`] : []),
120
+ ...(altered.length > 0 ? [`changed ${list(altered)}`] : []),
121
+ ];
122
+ return {
123
+ field: "interactiveTypes",
124
+ direction: directionOf(added.length > 0 || altered.length > 0, removed.length > 0 || altered.length > 0, "stricter"),
125
+ detail: parts.join("; "),
126
+ };
127
+ };
128
+ /**
129
+ * The per-origin ceilings, compared on the ceiling scale rather than as
130
+ * strings.
131
+ *
132
+ * `autoApplyCeiling` is the one map field with an ordered value, so an entry
133
+ * that moved has a direction of its own: raising a ceiling applies more without
134
+ * asking. An origin that gained an entry is read against `ceilingFor`'s own
135
+ * fallback of `low` rather than against nothing, because that is what the Gate
136
+ * does with an absent one — so writing `low` where there was no entry is not a
137
+ * change, and the comparison says so instead of reporting an edit that changed
138
+ * no decision.
139
+ *
140
+ * `nothing` is the bottom rung of that scale and not a value outside it
141
+ * (0405), so an origin switched off reads as a ceiling lowered, which is what
142
+ * it is: stricter, in the same column as every other tightening.
143
+ */
144
+ const ceilingChange = (was, now) => {
145
+ const origins = sorted([...Object.keys(was), ...Object.keys(now)]);
146
+ const moved = [];
147
+ let raised = false;
148
+ let lowered = false;
149
+ /** The same own-property rule as above, for the same reason. */
150
+ const ceiling = (ceilings, origin) => (Object.hasOwn(ceilings, origin) ? ceilings[origin] ?? "low" : "low");
151
+ for (const origin of origins) {
152
+ const before = ceiling(was, origin);
153
+ const after = ceiling(now, origin);
154
+ if (before === after)
155
+ continue;
156
+ moved.push(`${origin} ${before} became ${after}`);
157
+ if (compareCeilings(after, before) > 0)
158
+ raised = true;
159
+ else
160
+ lowered = true;
161
+ }
162
+ if (moved.length === 0)
163
+ return undefined;
164
+ return {
165
+ field: "autoApplyCeiling",
166
+ direction: directionOf(raised, lowered, "looser"),
167
+ detail: list(moved),
168
+ };
169
+ };
170
+ /** The refusal floor, compared as a stake level. A higher floor refuses less. */
171
+ const floorChange = (was, now) => {
172
+ if (was === now)
173
+ return undefined;
174
+ return {
175
+ field: "refusalFloor",
176
+ direction: compareStakes(now, was) > 0 ? "looser" : "stricter",
177
+ detail: `${was} became ${now}`,
178
+ };
179
+ };
180
+ /**
181
+ * The direction of a run of field changes, folded over the ones that have a
182
+ * direction at all.
183
+ *
184
+ * `incomparable` is the identity: an edit with nothing ordered in it is
185
+ * incomparable, and a field with no order never drags an ordered one toward
186
+ * `mixed`. That is what makes a rename beside a raised threshold read as strict
187
+ * as the threshold made it.
188
+ *
189
+ * Used twice — over a whole edit, and over the two halves of
190
+ * `removalThresholds`, which is a pair of orderings under one field name.
191
+ */
192
+ const foldDirection = (changes) => changes.reduce((folded, change) => {
193
+ if (change.direction === "incomparable")
194
+ return folded;
195
+ if (folded === "incomparable")
196
+ return change.direction;
197
+ if (folded === "mixed" || change.direction === "mixed")
198
+ return "mixed";
199
+ return folded === change.direction ? folded : "mixed";
200
+ }, "incomparable");
201
+ const COMPARISON = {
202
+ policyId: (was, now) => was.policyId === now.policyId
203
+ ? undefined
204
+ : {
205
+ field: "policyId",
206
+ direction: "incomparable",
207
+ detail: `${was.policyId} became ${now.policyId}`,
208
+ },
209
+ /** A longer list elevates more changes. */
210
+ protectedPrimitiveTypes: (was, now) => setChange("protectedPrimitiveTypes", was.protectedPrimitiveTypes, now.protectedPrimitiveTypes, "stricter"),
211
+ /** A longer list treats more changes as irreversible. */
212
+ outOfTreeEffectTypes: (was, now) => setChange("outOfTreeEffectTypes", was.outOfTreeEffectTypes, now.outOfTreeEffectTypes, "stricter"),
213
+ protectedPropKeys: (was, now) => setChange("protectedPropKeys", was.protectedPropKeys, now.protectedPropKeys, "stricter"),
214
+ interactiveTypes: (was, now) => interactiveChange(was.interactiveTypes, now.interactiveTypes),
215
+ /**
216
+ * The one list where longer is looser, and the one where emptiness is not the
217
+ * zero of the ordering.
218
+ *
219
+ * `gatePolicySchema` documents it: an empty `registeredPrimitiveTypes` is
220
+ * *undeclared*, not a library of nothing, so an unrenderable insert is
221
+ * appended and reported at render. A list arriving where there was none is
222
+ * therefore a limit arriving where there was no limit — the strictest move
223
+ * this field can make — while every edit within a declared list reads the
224
+ * ordinary way round, and emptying it removes the check altogether.
225
+ */
226
+ registeredPrimitiveTypes: (was, now) => {
227
+ const change = setChange("registeredPrimitiveTypes", was.registeredPrimitiveTypes, now.registeredPrimitiveTypes, "looser");
228
+ if (change === undefined)
229
+ return undefined;
230
+ const declared = (policy) => policy.registeredPrimitiveTypes.length > 0;
231
+ if (!declared(was) && declared(now)) {
232
+ return { ...change, direction: "stricter", detail: `${change.detail} (undeclared before)` };
233
+ }
234
+ if (declared(was) && !declared(now)) {
235
+ return { ...change, direction: "looser", detail: `${change.detail} (undeclared now)` };
236
+ }
237
+ return change;
238
+ },
239
+ /** A higher threshold lets a larger removal stay at lower stakes. */
240
+ removalThresholds: (was, now) => {
241
+ const medium = numberChange("removalThresholds", was.removalThresholds.medium, now.removalThresholds.medium, "looser");
242
+ const high = numberChange("removalThresholds", was.removalThresholds.high, now.removalThresholds.high, "looser");
243
+ const moved = [medium, high].flatMap((change) => (change === undefined ? [] : [change]));
244
+ if (moved.length === 0)
245
+ return undefined;
246
+ const parts = [
247
+ ...(medium === undefined ? [] : [`medium ${medium.detail}`]),
248
+ ...(high === undefined ? [] : [`high ${high.detail}`]),
249
+ ];
250
+ return {
251
+ field: "removalThresholds",
252
+ direction: foldDirection(moved),
253
+ detail: list(parts),
254
+ };
255
+ },
256
+ breadthThreshold: (was, now) => numberChange("breadthThreshold", was.breadthThreshold, now.breadthThreshold, "looser"),
257
+ /**
258
+ * A deeper threshold means a change has to be nearer the root before it counts
259
+ * as restructuring, so raising it elevates fewer changes.
260
+ */
261
+ shallowDepthThreshold: (was, now) => numberChange("shallowDepthThreshold", was.shallowDepthThreshold, now.shallowDepthThreshold, "looser"),
262
+ /** A bigger budget keeps more changes undoable, so raising it refuses fewer. */
263
+ inverseRetentionBudget: (was, now) => numberChange("inverseRetentionBudget", was.inverseRetentionBudget, now.inverseRetentionBudget, "looser"),
264
+ /** A higher bar holds more changes back for a person. */
265
+ minimumConfidence: (was, now) => numberChange("minimumConfidence", was.minimumConfidence, now.minimumConfidence, "stricter"),
266
+ /** A higher floor refuses more outright. */
267
+ confidenceFloor: (was, now) => numberChange("confidenceFloor", was.confidenceFloor, now.confidenceFloor, "stricter"),
268
+ autoApplyCeiling: (was, now) => ceilingChange(was.autoApplyCeiling, now.autoApplyCeiling),
269
+ refusalFloor: (was, now) => floorChange(was.refusalFloor, now.refusalFloor),
270
+ };
271
+ /**
272
+ * The order fields are reported in: the order `GatePolicy` declares them.
273
+ *
274
+ * Taken off the comparison table rather than sorted, because the schema's order
275
+ * is already the one a reader of the policy file knows — name, then the host
276
+ * vocabulary, then the structural thresholds, then the confidence bars, then the
277
+ * two stake knobs. Sorting alphabetically would scatter the pairs that belong
278
+ * side by side.
279
+ */
280
+ const FIELDS = Object.keys(COMPARISON);
281
+ /**
282
+ * What changed between two policies, and which way it moved the Gate.
283
+ *
284
+ * Takes two whole policies rather than two fingerprints, because a digest is
285
+ * one-way: the pair is the only thing that can answer this, and a log that kept
286
+ * diffs instead of policies could not answer it about a pair it had not
287
+ * anticipated.
288
+ */
289
+ export const policyChangeOf = (was, now) => {
290
+ const fields = FIELDS.flatMap((field) => {
291
+ const change = COMPARISON[field](was, now);
292
+ return change === undefined ? [] : [change];
293
+ });
294
+ return {
295
+ changed: fields.length > 0,
296
+ renamed: was.policyId !== now.policyId,
297
+ fields,
298
+ direction: foldDirection(fields),
299
+ fingerprints: {
300
+ was: policyFingerprintOf(was),
301
+ now: policyFingerprintOf(now),
302
+ },
303
+ };
304
+ };
305
+ //# sourceMappingURL=policy-change.js.map