@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
@@ -12,17 +12,27 @@ import { createPrimitiveRegistry, describeRegistryError } from "../sdk/registry.
12
12
  * are legitimate choices a primitive author makes and the render seam has to
13
13
  * behave correctly for each.
14
14
  */
15
- const declared = (type, description, props, tag, slots) => {
15
+ /**
16
+ * The body every well-behaved primitive in this file has: it spreads
17
+ * `loom.editable` onto its own root, places every region it was handed in tree
18
+ * order, and adds no element of its own to carry either.
19
+ *
20
+ * Shared so that the stand-in below is well-behaved in the one way that matters
21
+ * to it — a fixture written to break a *declaration* must not also fail the §4
22
+ * probe, or a lane cannot tell which of the two it is looking at.
23
+ */
24
+ const hostComponent = (label, tag) => {
16
25
  const Primitive = ({ loom, props: bag, children }) => createElement(tag, { ...loom.editable, "data-props": JSON.stringify(bag) }, children, Object.keys(loom.slots).map((name) => loom.slots[name]));
17
- Primitive.displayName = `declared(${type})`;
18
- return definePrimitive({
19
- type,
20
- description,
21
- props,
22
- component: Primitive,
23
- ...(slots ? { slots } : {}),
24
- });
26
+ Primitive.displayName = label;
27
+ return Primitive;
25
28
  };
29
+ const declared = (type, description, props, tag, slots) => definePrimitive({
30
+ type,
31
+ description,
32
+ props,
33
+ component: hostComponent(`declared(${type})`, tag),
34
+ ...(slots ? { slots } : {}),
35
+ });
26
36
  export const pageDefinition = declared("loom.page", "The page shell; everything else lives inside it", z.object({ title: z.string(), subtitle: z.string().optional() }), "main", ["main"]);
27
37
  export const cardDefinition = declared("loom.card", "A bounded block of related content", z.object({ variant: z.enum(["outlined", "filled"]), elevation: z.number().optional() }).strict(), "article");
28
38
  export const headerDefinition = declared("loom.header", "The banner at the top of a page", z.object({}), "header");
@@ -45,4 +55,119 @@ export const registryOf = (entries) => {
45
55
  return built.value;
46
56
  };
47
57
  export const testRegistry = () => registryOf(testDefinitions);
58
+ /**
59
+ * The ways a primitive's declaration of what it could not show can fail to be
60
+ * believed, named for what the author's code did rather than for the sentence
61
+ * the runtime writes about it.
62
+ *
63
+ * `throws` is the fault `UnshownFault` calls `threw`. The other six are its
64
+ * `impossible` arm, which is one kind carrying six details — and the details
65
+ * are what a lane demonstrating the diagnostic needs, because the kind is the
66
+ * same word for a declaration that returned a number and one that said it
67
+ * showed thirteen of twelve rows.
68
+ */
69
+ const BREAKAGES = [
70
+ "throws",
71
+ "not-an-array",
72
+ "not-a-reading",
73
+ "unnamed",
74
+ "uncountable-given",
75
+ "uncountable-shown",
76
+ "more-shown-than-given",
77
+ ];
78
+ /**
79
+ * Every breakage, in the order `readUnshown` refuses them, so a lane showing
80
+ * the fault once per shape can iterate rather than keep its own list.
81
+ *
82
+ * The list is the type rather than a copy of it: `UnshownBreakage` is read off
83
+ * these entries and `BROKEN_DECLARATIONS` is keyed on the type, so a member
84
+ * added here without a declaration, or a declaration without a member, is a
85
+ * typecheck error rather than a gap.
86
+ *
87
+ * **What is maintained rather than proved is the other direction** — against the
88
+ * runtime. No construction here makes a refusal path added to `readUnshown`
89
+ * with nothing added to this list fail a test, so this door could fall one fault
90
+ * behind the walk it stands in for, silently. `definitions.test.ts` holds the
91
+ * next best thing: every member is refused, no two members produce the same
92
+ * fault, and each detail is pinned to the exact sentence the runtime writes — so
93
+ * a message that moves goes red here and somebody looks at the list.
94
+ */
95
+ export const UNSHOWN_BREAKAGES = BREAKAGES;
96
+ /** The binding name the broken readings claim to have read, so a caller
97
+ * answering under it meets a stand-in that looks like a real bound listing. */
98
+ const BROKEN_READING_BINDING = "entries";
99
+ /**
100
+ * A declaration returning what the type forbids, which is the point rather than
101
+ * a shortcut.
102
+ *
103
+ * `readUnshown` checks what its own types already promise — that the return is
104
+ * an array, that each member is an object — because the code on the other side
105
+ * of that guard belongs to another author and a host's JavaScript need not
106
+ * agree with this package's types (0206). A fixture written in TypeScript
107
+ * cannot stand in for one that was not without saying so once, here.
108
+ */
109
+ const returning = (value) => () => value;
110
+ const BROKEN_DECLARATIONS = {
111
+ throws: () => {
112
+ throw new Error("the reader of this answer is not written yet");
113
+ },
114
+ "not-an-array": returning(undefined),
115
+ "not-a-reading": returning([BROKEN_READING_BINDING]),
116
+ unnamed: () => [{ name: "", given: 1, shown: 0 }],
117
+ "uncountable-given": () => [{ name: BROKEN_READING_BINDING, given: Number.NaN, shown: 0 }],
118
+ "uncountable-shown": () => [{ name: BROKEN_READING_BINDING, given: 2, shown: 1.5 }],
119
+ "more-shown-than-given": () => [{ name: BROKEN_READING_BINDING, given: 1, shown: 2 }],
120
+ };
121
+ /**
122
+ * A primitive that breaks the one declaration no tree and no deployment can
123
+ * break for it, in whichever way the caller names.
124
+ *
125
+ * `unshown-unreadable` is the single member of `RenderDiagnostic` addressed to
126
+ * whoever wrote the component (0206): the declaration lives *inside* the
127
+ * primitive, so only a primitive can break it. Nothing in the starter library
128
+ * does — all five that declare `unshown` compute the figure from the answer
129
+ * they were handed, which is the whole point of declaring the function the
130
+ * component already calls — and neither `testPrimitives` nor
131
+ * `undecoratedPrimitive` stood in for one. So every lane wanting to demonstrate
132
+ * the code wrote its own broken component, and `Loom docs` wrote one for *What
133
+ * a render reports* before filing for this.
134
+ *
135
+ * **One parameterised stand-in rather than a catalogue of broken components**,
136
+ * which is what the filing asked for in those words: a catalogue in the testing
137
+ * door would be a second library to keep true.
138
+ *
139
+ * Well-behaved in every other respect, deliberately. It spreads
140
+ * `loom.editable`, places what it is handed, and declares its props — so the
141
+ * one thing wrong with it is the thing the caller asked to be wrong, and a
142
+ * render of it raises exactly one diagnostic.
143
+ *
144
+ * Its props are declared **open**, where `loom.card` next door is strict, and
145
+ * that is the one place this fixture prefers forgiveness to realism: props the
146
+ * schema refuses omit the node altogether, which would take the declaration
147
+ * with them and hand a lane an empty diagnostic list instead of the fault it
148
+ * asked for. A stand-in that can be silenced by an unrelated prop is a stand-in
149
+ * that will be.
150
+ *
151
+ * The type carries the breakage, so all seven can be registered together and
152
+ * rendered in one tree. Read it off the entry rather than writing it out:
153
+ *
154
+ * ```ts
155
+ * const definition = brokenUnshownDefinition("throws")
156
+ * const registry = registryOf([definition])
157
+ * // …then a node of `definition.type` carrying a `loom:data` declaration.
158
+ * ```
159
+ *
160
+ * It declares no `reads`, and that absence is load-bearing. A declared name the
161
+ * caller did not answer under would add `data-unread` to the render, so the
162
+ * list a lane asserts would depend on which name it chose to answer. Silent
163
+ * unless declared is the bargain `reads` makes, and taking it is what keeps the
164
+ * one-diagnostic promise above true whatever the caller does.
165
+ */
166
+ export const brokenUnshownDefinition = (breakage) => definePrimitive({
167
+ type: `test.unshown-${breakage}`,
168
+ description: `A bound listing whose declaration of what it could not show is broken (${breakage}). Written to be wrong.`,
169
+ props: z.object({}),
170
+ unshown: BROKEN_DECLARATIONS[breakage],
171
+ component: hostComponent(`brokenUnshown(${breakage})`, "ul"),
172
+ });
48
173
  //# sourceMappingURL=definitions.js.map
@@ -1,10 +1,17 @@
1
+ import { type SourceEntry } from "../data/adapter.js";
1
2
  import type { ModelClient, ModelClientError, ModelCompletion, ModelRequest } from "../interpretation/client.js";
2
3
  import type { IdFactory, IntentId, TreeId } from "../ids.js";
3
4
  import { type Result } from "../result.js";
5
+ import type { ChangeAnalysis } from "../runtime/analysis.js";
6
+ import type { ChangeAssessment } from "../runtime/assessment.js";
7
+ import { type WriteCheck } from "../runtime/checks.js";
4
8
  import type { Clock, EventSink, RuntimeEventEnvelope } from "../runtime/events.js";
5
9
  import type { EditIntent, IntentOrigin } from "../runtime/intent.js";
6
10
  import type { ChangeInterpreter, ChangeRepairer, InterpretationError, RepairRequest } from "../runtime/interpreter.js";
7
11
  import type { AuthorKind, ProposedChange } from "../runtime/proposal.js";
12
+ import type { IrreversibilityReason } from "../runtime/reversibility.js";
13
+ import type { StakeFactor } from "../runtime/stakes.js";
14
+ import { type EndpointEntry } from "../submit/endpoint.js";
8
15
  import type { TreeDelta } from "../tree/delta.js";
9
16
  /**
10
17
  * Test doubles for the impure seams this file owns — the interpreter and its
@@ -91,4 +98,100 @@ export type ProposalDraft = {
91
98
  readonly confidence?: number;
92
99
  };
93
100
  export declare const buildProposal: (idFactory: IdFactory, draft: ProposalDraft) => ProposedChange;
101
+ /**
102
+ * What a hanging seam double reports, beside the entry a registry takes.
103
+ *
104
+ * The `abortedWith` half is the reason these are published rather than written
105
+ * out per surface: reaching a ceiling is observable in the seam's own
106
+ * vocabulary, but the *abort* the runtime sends afterwards is not observable
107
+ * anywhere except from inside the adapter, and it is the half a hand-written
108
+ * double leaves out (0140).
109
+ */
110
+ export type HangingSeam<TEntry> = {
111
+ readonly entry: TEntry;
112
+ /** Whether the runtime's ceiling aborted the call, and what it said (0140). */
113
+ readonly abortedWith: () => string | undefined;
114
+ };
115
+ /**
116
+ * A source that never answers — the sibling of `hangingModelClient` at the data
117
+ * seam, published for the same reason.
118
+ *
119
+ * Every surface that renders a bound region has an "it did not come back" state
120
+ * to show, and a promise that is never resolved is the only honest imitation of
121
+ * an integration nobody is going to answer. Use it with a small `ceilingMs`;
122
+ * the default is ten seconds and a test that waits it out is a test nobody runs.
123
+ *
124
+ * Its params schema accepts anything, because a double whose whole job is to
125
+ * not answer must never be the thing that refuses first: a binding written
126
+ * against the real source it stands in for has to reach the adapter unchanged.
127
+ */
128
+ export declare const hangingSource: (id: string, description: string) => HangingSeam<SourceEntry>;
129
+ /**
130
+ * An endpoint that never says where a form posts — the same double at the
131
+ * submission seam.
132
+ *
133
+ * A form's target is resolved while the page is being served, so this is the
134
+ * state a token store having a very bad afternoon puts a page into, and the one
135
+ * a ceiling exists to bound (0140).
136
+ */
137
+ export declare const hangingEndpoint: (id: string, description: string) => HangingSeam<EndpointEntry>;
138
+ /**
139
+ * Every fact an analysis states, measuring nothing.
140
+ *
141
+ * The whole of why `buildAssessment` exists is in this one declaration: a field
142
+ * added to `ChangeAnalysis` stops it compiling, here, in the lane that added
143
+ * the field. A surface's fixture that spelled the record out itself would
144
+ * instead keep compiling and start lying — ten of nineteen fields, the gap cast
145
+ * away, and the failure arriving later in whichever test is the next to narrow
146
+ * one of the nine it left out.
147
+ */
148
+ export declare const NOTHING_MEASURED: ChangeAnalysis;
149
+ /**
150
+ * The facts a test wants to be true of a judged change. Everything else is
151
+ * absent, empty or zero.
152
+ *
153
+ * What is *not* here is the point. A level, a reversible flag, a retained count
154
+ * and an inverse delta are all computed below from what this draft says,
155
+ * because each of the four is something the runtime derives and none is
156
+ * something a caller may contradict. The Gate's level is the highest of its
157
+ * factors; a change is reversible exactly when nothing says otherwise; the
158
+ * inverse retains what a removal destroyed. A draft that could set them
159
+ * independently could describe an assessment no run of Loom will ever produce,
160
+ * which is the one thing a published double must not let a test assert against.
161
+ */
162
+ export type AssessmentDraft = {
163
+ /** The change being judged. Its delta decides what the inverse is written against. */
164
+ readonly proposal: ProposedChange;
165
+ /** What the delta does. The fields left out measure zero. */
166
+ readonly analysis?: Partial<ChangeAnalysis>;
167
+ /** The rules the Gate raised, in the order it raised them. */
168
+ readonly factors?: readonly StakeFactor[];
169
+ /** Why the change cannot be taken back. Empty means it can. */
170
+ readonly irreversibilityReasons?: readonly IrreversibilityReason[];
171
+ /**
172
+ * Which of the write path's optional checks were in place. Empty by default,
173
+ * which is what a double has wired: the real seams need a registry, and a
174
+ * fixture claiming a check it never performed would put a reader's confidence
175
+ * in the wrong place.
176
+ */
177
+ readonly wiredChecks?: readonly WriteCheck[];
178
+ };
179
+ /**
180
+ * A complete `ChangeAssessment` from the handful of facts a test cares about.
181
+ *
182
+ * The third double of its kind and the first that had to be asked for. A
183
+ * surface needing one of these had two options and both are bad: run
184
+ * `assessChange` against a real tree, which means owning a tree and a registry
185
+ * to get at a number; or write the record out as a literal and cast the gap
186
+ * away, which is what three fixtures across two lanes did until a field was
187
+ * added underneath them.
188
+ *
189
+ * It is not `assessChange` and does not pretend to be. The real one measures a
190
+ * delta against a tree, so reaching a particular factor through it means
191
+ * crafting a delta that raises exactly that rule — which is the right test for
192
+ * the Gate and the wrong one for a screen that only needs a critical change to
193
+ * draw. This builds the record directly and keeps the three invariants that
194
+ * make the record coherent.
195
+ */
196
+ export declare const buildAssessment: (idFactory: IdFactory, draft: AssessmentDraft) => ChangeAssessment;
94
197
  //# sourceMappingURL=doubles.d.ts.map
@@ -1,4 +1,9 @@
1
+ import { z } from "zod";
2
+ import { defineSource } from "../data/adapter.js";
1
3
  import { ok } from "../result.js";
4
+ import { canonicalChecksOf } from "../runtime/checks.js";
5
+ import { highestStake } from "../runtime/stake-level.js";
6
+ import { defineEndpoint } from "../submit/endpoint.js";
2
7
  /**
3
8
  * Test doubles for the impure seams this file owns — the interpreter and its
4
9
  * repairer, the clock, and the event sink. The runtime's other two seams are
@@ -138,4 +143,142 @@ export const buildProposal = (idFactory, draft) => ({
138
143
  interpretedAt: FIXED_INSTANT,
139
144
  },
140
145
  });
146
+ /**
147
+ * Records what an abort said, in the one shape all three seams hand it over in.
148
+ */
149
+ const abortRecorder = () => {
150
+ let aborted;
151
+ return {
152
+ read: () => aborted,
153
+ listen: (signal) => {
154
+ signal?.addEventListener("abort", () => {
155
+ const { reason } = signal;
156
+ aborted = reason instanceof Error ? reason.message : "unnamed";
157
+ });
158
+ },
159
+ };
160
+ };
161
+ /**
162
+ * A source that never answers — the sibling of `hangingModelClient` at the data
163
+ * seam, published for the same reason.
164
+ *
165
+ * Every surface that renders a bound region has an "it did not come back" state
166
+ * to show, and a promise that is never resolved is the only honest imitation of
167
+ * an integration nobody is going to answer. Use it with a small `ceilingMs`;
168
+ * the default is ten seconds and a test that waits it out is a test nobody runs.
169
+ *
170
+ * Its params schema accepts anything, because a double whose whole job is to
171
+ * not answer must never be the thing that refuses first: a binding written
172
+ * against the real source it stands in for has to reach the adapter unchanged.
173
+ */
174
+ export const hangingSource = (id, description) => {
175
+ const abort = abortRecorder();
176
+ return {
177
+ entry: defineSource({
178
+ id,
179
+ description,
180
+ params: z.object({}).passthrough(),
181
+ answers: z.custom(),
182
+ adapter: {
183
+ fetch: ({ signal }) => new Promise(() => {
184
+ abort.listen(signal);
185
+ }),
186
+ },
187
+ }),
188
+ abortedWith: abort.read,
189
+ };
190
+ };
191
+ /**
192
+ * An endpoint that never says where a form posts — the same double at the
193
+ * submission seam.
194
+ *
195
+ * A form's target is resolved while the page is being served, so this is the
196
+ * state a token store having a very bad afternoon puts a page into, and the one
197
+ * a ceiling exists to bound (0140).
198
+ */
199
+ export const hangingEndpoint = (id, description) => {
200
+ const abort = abortRecorder();
201
+ return {
202
+ entry: defineEndpoint({
203
+ id,
204
+ description,
205
+ endpoint: {
206
+ target: ({ signal }) => new Promise(() => {
207
+ abort.listen(signal);
208
+ }),
209
+ },
210
+ }),
211
+ abortedWith: abort.read,
212
+ };
213
+ };
214
+ /**
215
+ * Every fact an analysis states, measuring nothing.
216
+ *
217
+ * The whole of why `buildAssessment` exists is in this one declaration: a field
218
+ * added to `ChangeAnalysis` stops it compiling, here, in the lane that added
219
+ * the field. A surface's fixture that spelled the record out itself would
220
+ * instead keep compiling and start lying — ten of nineteen fields, the gap cast
221
+ * away, and the failure arriving later in whichever test is the next to narrow
222
+ * one of the nine it left out.
223
+ */
224
+ export const NOTHING_MEASURED = {
225
+ operationCount: 0,
226
+ insertedNodeCount: 0,
227
+ removedNodeCount: 0,
228
+ movedNodeCount: 0,
229
+ configuredNodeCount: 0,
230
+ relocatedNodeCount: 0,
231
+ affectedNodeIds: [],
232
+ touchedPrimitiveTypes: [],
233
+ relocatedPrimitiveTypes: [],
234
+ removedPrimitiveTypes: [],
235
+ configuredPropKeys: [],
236
+ nestedTargets: [],
237
+ unknownPrimitives: [],
238
+ invalidProps: [],
239
+ unreadBindings: [],
240
+ unplacedSlots: [],
241
+ redirectedSubmissions: [],
242
+ repointedBindings: [],
243
+ shallowestAffectedDepth: 0,
244
+ };
245
+ /**
246
+ * A complete `ChangeAssessment` from the handful of facts a test cares about.
247
+ *
248
+ * The third double of its kind and the first that had to be asked for. A
249
+ * surface needing one of these had two options and both are bad: run
250
+ * `assessChange` against a real tree, which means owning a tree and a registry
251
+ * to get at a number; or write the record out as a literal and cast the gap
252
+ * away, which is what three fixtures across two lanes did until a field was
253
+ * added underneath them.
254
+ *
255
+ * It is not `assessChange` and does not pretend to be. The real one measures a
256
+ * delta against a tree, so reaching a particular factor through it means
257
+ * crafting a delta that raises exactly that rule — which is the right test for
258
+ * the Gate and the wrong one for a screen that only needs a critical change to
259
+ * draw. This builds the record directly and keeps the three invariants that
260
+ * make the record coherent.
261
+ */
262
+ export const buildAssessment = (idFactory, draft) => {
263
+ const analysis = { ...NOTHING_MEASURED, ...draft.analysis };
264
+ const factors = draft.factors ?? [];
265
+ const reasons = draft.irreversibilityReasons ?? [];
266
+ return {
267
+ proposal: draft.proposal,
268
+ analysis,
269
+ stakes: { level: highestStake(factors.map((factor) => factor.level)), factors },
270
+ reversibility: {
271
+ reversible: reasons.length === 0,
272
+ inverse: {
273
+ deltaId: idFactory.deltaId(),
274
+ treeId: draft.proposal.delta.treeId,
275
+ baseRevision: draft.proposal.delta.baseRevision + 1,
276
+ operations: [],
277
+ },
278
+ retainedNodeCount: analysis.removedNodeCount,
279
+ reasons,
280
+ },
281
+ wiredChecks: canonicalChecksOf(draft.wiredChecks ?? []),
282
+ };
283
+ };
141
284
  //# sourceMappingURL=doubles.js.map
@@ -31,8 +31,8 @@
31
31
  * a browser, which is the property the course's in-page runner needs and the
32
32
  * one `surface.test.ts` holds.
33
33
  */
34
- export { cardDefinition, footerDefinition, headerDefinition, pageDefinition, registryOf, testDefinitions, testRegistry, } from "./definitions.js";
35
- export { buildIntent, buildProposal, collectingEventSink, failingEventSink, fixedClock, FIXED_INSTANT, hangingModelClient, scriptedInterpreter, scriptedModelClient, scriptedRepairer, type CollectingEventSink, type HangingModelClient, type IntentDraft, type ProposalDraft, type RecordingInterpreter, type RecordingModelClient, type RecordingRepairer, } from "./doubles.js";
34
+ export { brokenUnshownDefinition, cardDefinition, footerDefinition, headerDefinition, pageDefinition, registryOf, testDefinitions, testRegistry, UNSHOWN_BREAKAGES, type UnshownBreakage, } from "./definitions.js";
35
+ export { buildAssessment, buildIntent, buildProposal, collectingEventSink, failingEventSink, fixedClock, FIXED_INSTANT, hangingEndpoint, hangingModelClient, hangingSource, NOTHING_MEASURED, scriptedInterpreter, scriptedModelClient, scriptedRepairer, type AssessmentDraft, type CollectingEventSink, type HangingModelClient, type HangingSeam, type IntentDraft, type ProposalDraft, type RecordingInterpreter, type RecordingModelClient, type RecordingRepairer, } from "./doubles.js";
36
36
  export { harnessWith, proposalScript, removalDelta, type EpisodeHarness, } from "./episode-harness.js";
37
37
  export { memoryFileSystem, type MemoryFileSystem, type MemoryFileSystemOptions, } from "./filesystem.js";
38
38
  export { formTree, sampleTree, type FormTree, type SampleTree } from "./fixtures.js";
@@ -31,8 +31,8 @@
31
31
  * a browser, which is the property the course's in-page runner needs and the
32
32
  * one `surface.test.ts` holds.
33
33
  */
34
- export { cardDefinition, footerDefinition, headerDefinition, pageDefinition, registryOf, testDefinitions, testRegistry, } from "./definitions.js";
35
- export { buildIntent, buildProposal, collectingEventSink, failingEventSink, fixedClock, FIXED_INSTANT, hangingModelClient, scriptedInterpreter, scriptedModelClient, scriptedRepairer, } from "./doubles.js";
34
+ export { brokenUnshownDefinition, cardDefinition, footerDefinition, headerDefinition, pageDefinition, registryOf, testDefinitions, testRegistry, UNSHOWN_BREAKAGES, } from "./definitions.js";
35
+ export { buildAssessment, buildIntent, buildProposal, collectingEventSink, failingEventSink, fixedClock, FIXED_INSTANT, hangingEndpoint, hangingModelClient, hangingSource, NOTHING_MEASURED, scriptedInterpreter, scriptedModelClient, scriptedRepairer, } from "./doubles.js";
36
36
  export { harnessWith, proposalScript, removalDelta, } from "./episode-harness.js";
37
37
  export { memoryFileSystem, } from "./filesystem.js";
38
38
  export { formTree, sampleTree } from "./fixtures.js";