@dxos/echo 0.8.4-main.40e3dcdf1b → 0.8.4-main.43cb759274

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 (428) hide show
  1. package/LICENSE +102 -5
  2. package/README.md +7 -7
  3. package/dist/lib/neutral/Annotation.mjs +29 -6
  4. package/dist/lib/neutral/Database.mjs +8 -9
  5. package/dist/lib/neutral/Entity.mjs +29 -18
  6. package/dist/lib/neutral/Err.mjs +3 -3
  7. package/dist/lib/neutral/Feed.mjs +27 -19
  8. package/dist/lib/neutral/Filter.mjs +25 -15
  9. package/dist/lib/neutral/Format.mjs +23 -3
  10. package/dist/lib/neutral/JsonSchema.mjs +7 -8
  11. package/dist/lib/neutral/Key.mjs +9 -5
  12. package/dist/lib/neutral/Migration.mjs +18 -0
  13. package/dist/lib/neutral/Obj.mjs +25 -19
  14. package/dist/lib/neutral/Order.mjs +1 -1
  15. package/dist/lib/neutral/Query.mjs +19 -16
  16. package/dist/lib/neutral/QueryResult.mjs +1 -1
  17. package/dist/lib/neutral/Ref.mjs +10 -9
  18. package/dist/lib/neutral/Registry.mjs +14 -0
  19. package/dist/lib/neutral/Registry.mjs.map +7 -0
  20. package/dist/lib/neutral/Relation.mjs +26 -24
  21. package/dist/lib/neutral/Scope.mjs +12 -0
  22. package/dist/lib/neutral/Scope.mjs.map +7 -0
  23. package/dist/lib/neutral/Tag.mjs +17 -13
  24. package/dist/lib/neutral/Type.mjs +52 -26
  25. package/dist/lib/neutral/chunk-3DKP2EIN.mjs +31 -0
  26. package/dist/lib/neutral/chunk-3DKP2EIN.mjs.map +7 -0
  27. package/dist/lib/neutral/chunk-4BB4MFCN.mjs +154 -0
  28. package/dist/lib/neutral/chunk-4BB4MFCN.mjs.map +7 -0
  29. package/dist/lib/neutral/{chunk-CIRHIEMW.mjs → chunk-4SFPZJVA.mjs} +92 -112
  30. package/dist/lib/neutral/chunk-4SFPZJVA.mjs.map +7 -0
  31. package/dist/lib/neutral/{chunk-YWXWXIE5.mjs → chunk-4Z6GET2X.mjs} +3 -3
  32. package/dist/lib/neutral/chunk-4Z6GET2X.mjs.map +7 -0
  33. package/dist/lib/neutral/{chunk-ANHVGJI4.mjs → chunk-7LOUAPYZ.mjs} +9 -5
  34. package/dist/lib/neutral/chunk-7LOUAPYZ.mjs.map +7 -0
  35. package/dist/lib/neutral/{chunk-43Y5DOS6.mjs → chunk-7OAFN3OX.mjs} +75 -112
  36. package/dist/lib/neutral/chunk-7OAFN3OX.mjs.map +7 -0
  37. package/dist/lib/neutral/{chunk-BOZZPUXE.mjs → chunk-7PRCIDHH.mjs} +41 -81
  38. package/dist/lib/neutral/chunk-7PRCIDHH.mjs.map +7 -0
  39. package/dist/lib/neutral/{chunk-UBEZSGXY.mjs → chunk-BBFJWWAV.mjs} +6 -6
  40. package/dist/lib/neutral/chunk-BBFJWWAV.mjs.map +7 -0
  41. package/dist/lib/neutral/chunk-BDQGMDIX.mjs +132 -0
  42. package/dist/lib/neutral/chunk-BDQGMDIX.mjs.map +7 -0
  43. package/dist/lib/neutral/chunk-CGTI5MXO.mjs +36 -0
  44. package/dist/lib/neutral/chunk-CGTI5MXO.mjs.map +7 -0
  45. package/dist/lib/neutral/{chunk-OMUPQMLR.mjs → chunk-DKLUHO4T.mjs} +1 -1
  46. package/dist/lib/neutral/chunk-DKLUHO4T.mjs.map +7 -0
  47. package/dist/lib/neutral/chunk-DMN2CKPX.mjs +93 -0
  48. package/dist/lib/neutral/chunk-DMN2CKPX.mjs.map +7 -0
  49. package/dist/lib/neutral/{chunk-UTBRYVQC.mjs → chunk-G6CFWUYH.mjs} +2 -2
  50. package/dist/lib/neutral/chunk-H26LSXVJ.mjs +653 -0
  51. package/dist/lib/neutral/chunk-H26LSXVJ.mjs.map +7 -0
  52. package/dist/lib/neutral/{chunk-FXEG7EOK.mjs → chunk-J3MNM65T.mjs} +9 -6
  53. package/dist/lib/neutral/chunk-J3MNM65T.mjs.map +7 -0
  54. package/dist/lib/neutral/chunk-JE7AOSWF.mjs +247 -0
  55. package/dist/lib/neutral/chunk-JE7AOSWF.mjs.map +7 -0
  56. package/dist/lib/neutral/chunk-LAF3LSWI.mjs +379 -0
  57. package/dist/lib/neutral/chunk-LAF3LSWI.mjs.map +7 -0
  58. package/dist/lib/neutral/chunk-LMNRFOVB.mjs +108 -0
  59. package/dist/lib/neutral/chunk-LMNRFOVB.mjs.map +7 -0
  60. package/dist/lib/neutral/{chunk-WYOKA6AE.mjs → chunk-O6BH7EPN.mjs} +31 -4
  61. package/dist/lib/neutral/chunk-O6BH7EPN.mjs.map +7 -0
  62. package/dist/lib/neutral/{chunk-KTAWP7GI.mjs → chunk-OIYW7R2G.mjs} +99 -46
  63. package/dist/lib/neutral/chunk-OIYW7R2G.mjs.map +7 -0
  64. package/dist/lib/neutral/{chunk-TQQZLKB7.mjs → chunk-OYUG4FHF.mjs} +648 -1228
  65. package/dist/lib/neutral/chunk-OYUG4FHF.mjs.map +7 -0
  66. package/dist/lib/neutral/{chunk-NQRLRYJM.mjs → chunk-Q5FKCVBC.mjs} +173 -60
  67. package/dist/lib/neutral/chunk-Q5FKCVBC.mjs.map +7 -0
  68. package/dist/lib/neutral/chunk-Q62IHV2N.mjs +41 -0
  69. package/dist/lib/neutral/chunk-Q62IHV2N.mjs.map +7 -0
  70. package/dist/lib/neutral/{chunk-UFDK26FO.mjs → chunk-QVJDDG44.mjs} +69 -34
  71. package/dist/lib/neutral/chunk-QVJDDG44.mjs.map +7 -0
  72. package/dist/lib/neutral/{chunk-B5OXLWZL.mjs → chunk-TFEWTY5A.mjs} +155 -129
  73. package/dist/lib/neutral/chunk-TFEWTY5A.mjs.map +7 -0
  74. package/dist/lib/neutral/{chunk-UI6MWK5W.mjs → chunk-TTCSATUD.mjs} +1 -1
  75. package/dist/lib/neutral/{chunk-FZO7LQO7.mjs → chunk-VKWOFXT2.mjs} +22 -2
  76. package/dist/lib/neutral/{chunk-FZO7LQO7.mjs.map → chunk-VKWOFXT2.mjs.map} +1 -1
  77. package/dist/lib/neutral/{chunk-NXMFBIT5.mjs → chunk-ZACMEAYV.mjs} +89 -23
  78. package/dist/lib/neutral/chunk-ZACMEAYV.mjs.map +7 -0
  79. package/dist/lib/neutral/index.mjs +58 -38
  80. package/dist/lib/neutral/internal/index.mjs +131 -64
  81. package/dist/lib/neutral/meta.json +1 -1
  82. package/dist/lib/neutral/testing/index.mjs +222 -177
  83. package/dist/lib/neutral/testing/index.mjs.map +3 -3
  84. package/dist/types/src/Annotation.d.ts +108 -4
  85. package/dist/types/src/Annotation.d.ts.map +1 -1
  86. package/dist/types/src/Annotation.test.d.ts +2 -0
  87. package/dist/types/src/Annotation.test.d.ts.map +1 -0
  88. package/dist/types/src/Collection.d.ts +2 -3
  89. package/dist/types/src/Collection.d.ts.map +1 -1
  90. package/dist/types/src/Database.d.ts +56 -24
  91. package/dist/types/src/Database.d.ts.map +1 -1
  92. package/dist/types/src/Dataset.d.ts +17 -6
  93. package/dist/types/src/Dataset.d.ts.map +1 -1
  94. package/dist/types/src/Entity.d.ts +102 -26
  95. package/dist/types/src/Entity.d.ts.map +1 -1
  96. package/dist/types/src/Err.d.ts +27 -27
  97. package/dist/types/src/Err.d.ts.map +1 -1
  98. package/dist/types/src/Feed.d.ts +89 -25
  99. package/dist/types/src/Feed.d.ts.map +1 -1
  100. package/dist/types/src/Filter.d.ts +74 -11
  101. package/dist/types/src/Filter.d.ts.map +1 -1
  102. package/dist/types/src/Filter.test.d.ts +2 -0
  103. package/dist/types/src/Filter.test.d.ts.map +1 -0
  104. package/dist/types/src/Hypergraph.d.ts +14 -9
  105. package/dist/types/src/Hypergraph.d.ts.map +1 -1
  106. package/dist/types/src/Json.d.ts +33 -0
  107. package/dist/types/src/Json.d.ts.map +1 -0
  108. package/dist/types/src/Json.test.d.ts +2 -0
  109. package/dist/types/src/Json.test.d.ts.map +1 -0
  110. package/dist/types/src/JsonSchema.d.ts +2 -2
  111. package/dist/types/src/JsonSchema.d.ts.map +1 -1
  112. package/dist/types/src/Key.d.ts +1 -1
  113. package/dist/types/src/Key.d.ts.map +1 -1
  114. package/dist/types/src/Migration.d.ts +72 -0
  115. package/dist/types/src/Migration.d.ts.map +1 -0
  116. package/dist/types/src/Obj.d.ts +108 -65
  117. package/dist/types/src/Obj.d.ts.map +1 -1
  118. package/dist/types/src/Order.d.ts.map +1 -1
  119. package/dist/types/src/Query.d.ts +35 -10
  120. package/dist/types/src/Query.d.ts.map +1 -1
  121. package/dist/types/src/QueryResult.d.ts +9 -0
  122. package/dist/types/src/QueryResult.d.ts.map +1 -1
  123. package/dist/types/src/Ref.d.ts +15 -7
  124. package/dist/types/src/Ref.d.ts.map +1 -1
  125. package/dist/types/src/Registry.d.ts +131 -0
  126. package/dist/types/src/Registry.d.ts.map +1 -0
  127. package/dist/types/src/Relation.d.ts +72 -44
  128. package/dist/types/src/Relation.d.ts.map +1 -1
  129. package/dist/types/src/Scope.d.ts +34 -0
  130. package/dist/types/src/Scope.d.ts.map +1 -0
  131. package/dist/types/src/StateMap.d.ts +32 -0
  132. package/dist/types/src/StateMap.d.ts.map +1 -0
  133. package/dist/types/src/StateMap.test.d.ts +2 -0
  134. package/dist/types/src/StateMap.test.d.ts.map +1 -0
  135. package/dist/types/src/Tag.d.ts +21 -5
  136. package/dist/types/src/Tag.d.ts.map +1 -1
  137. package/dist/types/src/TagIndex.d.ts +36 -0
  138. package/dist/types/src/TagIndex.d.ts.map +1 -0
  139. package/dist/types/src/TagIndex.test.d.ts +2 -0
  140. package/dist/types/src/TagIndex.test.d.ts.map +1 -0
  141. package/dist/types/src/Tagging.d.ts +31 -0
  142. package/dist/types/src/Tagging.d.ts.map +1 -0
  143. package/dist/types/src/Type.d.ts +357 -96
  144. package/dist/types/src/Type.d.ts.map +1 -1
  145. package/dist/types/src/View.d.ts +2 -5
  146. package/dist/types/src/View.d.ts.map +1 -1
  147. package/dist/types/src/exemplars.test.d.ts +2 -0
  148. package/dist/types/src/exemplars.test.d.ts.map +1 -0
  149. package/dist/types/src/index.d.ts +8 -2
  150. package/dist/types/src/index.d.ts.map +1 -1
  151. package/dist/types/src/internal/Annotation/annotations.d.ts +79 -37
  152. package/dist/types/src/internal/Annotation/annotations.d.ts.map +1 -1
  153. package/dist/types/src/internal/Annotation/dictionary.d.ts +24 -0
  154. package/dist/types/src/internal/Annotation/dictionary.d.ts.map +1 -0
  155. package/dist/types/src/internal/Annotation/entity-dictionary.d.ts +14 -0
  156. package/dist/types/src/internal/Annotation/entity-dictionary.d.ts.map +1 -0
  157. package/dist/types/src/internal/Annotation/index.d.ts +4 -2
  158. package/dist/types/src/internal/Annotation/index.d.ts.map +1 -1
  159. package/dist/types/src/internal/Annotation/sorting.d.ts.map +1 -1
  160. package/dist/types/src/internal/Annotation/util.d.ts +14 -5
  161. package/dist/types/src/internal/Annotation/util.d.ts.map +1 -1
  162. package/dist/types/src/internal/Entity/api.d.ts +3 -3
  163. package/dist/types/src/internal/Entity/api.d.ts.map +1 -1
  164. package/dist/types/src/internal/Entity/entity.d.ts +72 -8
  165. package/dist/types/src/internal/Entity/entity.d.ts.map +1 -1
  166. package/dist/types/src/internal/Entity/guard.d.ts +10 -0
  167. package/dist/types/src/internal/Entity/guard.d.ts.map +1 -0
  168. package/dist/types/src/internal/Entity/index.d.ts +2 -0
  169. package/dist/types/src/internal/Entity/index.d.ts.map +1 -1
  170. package/dist/types/src/internal/Entity/model.d.ts +20 -17
  171. package/dist/types/src/internal/Entity/model.d.ts.map +1 -1
  172. package/dist/types/src/internal/Entity/object.d.ts +3 -3
  173. package/dist/types/src/internal/Entity/object.d.ts.map +1 -1
  174. package/dist/types/src/internal/Entity/relation.d.ts +30 -7
  175. package/dist/types/src/internal/Entity/relation.d.ts.map +1 -1
  176. package/dist/types/src/internal/Entity/type-kind.d.ts +24 -0
  177. package/dist/types/src/internal/Entity/type-kind.d.ts.map +1 -0
  178. package/dist/types/src/internal/Entity/type-uri.d.ts +25 -0
  179. package/dist/types/src/internal/Entity/type-uri.d.ts.map +1 -0
  180. package/dist/types/src/internal/Entity/version.d.ts.map +1 -1
  181. package/dist/types/src/internal/Format/date.d.ts.map +1 -1
  182. package/dist/types/src/internal/Format/format.d.ts +3 -2
  183. package/dist/types/src/internal/Format/format.d.ts.map +1 -1
  184. package/dist/types/src/internal/Format/index.d.ts +2 -2
  185. package/dist/types/src/internal/Format/index.d.ts.map +1 -1
  186. package/dist/types/src/internal/Format/number.d.ts.map +1 -1
  187. package/dist/types/src/internal/Format/object.d.ts +3 -1
  188. package/dist/types/src/internal/Format/object.d.ts.map +1 -1
  189. package/dist/types/src/internal/Format/types.d.ts.map +1 -1
  190. package/dist/types/src/internal/JsonSchema/json-schema-normalize.d.ts.map +1 -1
  191. package/dist/types/src/internal/JsonSchema/json-schema-type.d.ts +28 -28
  192. package/dist/types/src/internal/JsonSchema/json-schema-type.d.ts.map +1 -1
  193. package/dist/types/src/internal/JsonSchema/json-schema.d.ts +3 -2
  194. package/dist/types/src/internal/JsonSchema/json-schema.d.ts.map +1 -1
  195. package/dist/types/src/internal/Obj/clone.d.ts.map +1 -1
  196. package/dist/types/src/internal/Obj/common.d.ts.map +1 -1
  197. package/dist/types/src/internal/Obj/create-object.d.ts +11 -12
  198. package/dist/types/src/internal/Obj/create-object.d.ts.map +1 -1
  199. package/dist/types/src/internal/Obj/deleted.d.ts.map +1 -1
  200. package/dist/types/src/internal/Obj/index.d.ts +0 -1
  201. package/dist/types/src/internal/Obj/index.d.ts.map +1 -1
  202. package/dist/types/src/internal/Obj/json-serializer.d.ts +11 -10
  203. package/dist/types/src/internal/Obj/json-serializer.d.ts.map +1 -1
  204. package/dist/types/src/internal/Obj/set-value.d.ts +1 -1
  205. package/dist/types/src/internal/Obj/set-value.d.ts.map +1 -1
  206. package/dist/types/src/internal/Obj/snapshot.d.ts.map +1 -1
  207. package/dist/types/src/internal/Obj/typed-object.d.ts +1 -1
  208. package/dist/types/src/internal/Query.d.ts +10 -0
  209. package/dist/types/src/internal/Query.d.ts.map +1 -0
  210. package/dist/types/src/internal/Ref/ref-array.d.ts +2 -2
  211. package/dist/types/src/internal/Ref/ref-array.d.ts.map +1 -1
  212. package/dist/types/src/internal/Ref/ref.d.ts +42 -19
  213. package/dist/types/src/internal/Ref/ref.d.ts.map +1 -1
  214. package/dist/types/src/internal/Type/compose.d.ts.map +1 -1
  215. package/dist/types/src/internal/Type/index.d.ts +1 -2
  216. package/dist/types/src/internal/Type/index.d.ts.map +1 -1
  217. package/dist/types/src/internal/Type/manipulation.d.ts +0 -1
  218. package/dist/types/src/internal/Type/manipulation.d.ts.map +1 -1
  219. package/dist/types/src/internal/Type/type-schema.d.ts +52 -0
  220. package/dist/types/src/internal/Type/type-schema.d.ts.map +1 -0
  221. package/dist/types/src/internal/common/api/meta.d.ts +14 -11
  222. package/dist/types/src/internal/common/api/meta.d.ts.map +1 -1
  223. package/dist/types/src/internal/common/proxy/change-context.d.ts +1 -1
  224. package/dist/types/src/internal/common/proxy/change-context.d.ts.map +1 -1
  225. package/dist/types/src/internal/common/proxy/define-hidden-property.d.ts.map +1 -1
  226. package/dist/types/src/internal/common/proxy/errors.d.ts +1 -1
  227. package/dist/types/src/internal/common/proxy/errors.d.ts.map +1 -1
  228. package/dist/types/src/internal/common/proxy/event-batch.d.ts.map +1 -1
  229. package/dist/types/src/internal/common/proxy/json-serializer.d.ts.map +1 -1
  230. package/dist/types/src/internal/common/proxy/make-object.d.ts +11 -5
  231. package/dist/types/src/internal/common/proxy/make-object.d.ts.map +1 -1
  232. package/dist/types/src/internal/common/proxy/ownership.d.ts.map +1 -1
  233. package/dist/types/src/internal/common/proxy/proxy-utils.d.ts.map +1 -1
  234. package/dist/types/src/internal/common/proxy/reactive-array.d.ts +1 -1
  235. package/dist/types/src/internal/common/proxy/reactive.d.ts +1 -1
  236. package/dist/types/src/internal/common/proxy/reactive.d.ts.map +1 -1
  237. package/dist/types/src/internal/common/proxy/reactive.test.d.ts +2 -0
  238. package/dist/types/src/internal/common/proxy/reactive.test.d.ts.map +1 -0
  239. package/dist/types/src/internal/common/proxy/schema-validator.d.ts.map +1 -1
  240. package/dist/types/src/internal/common/proxy/typed-handler.d.ts +18 -2
  241. package/dist/types/src/internal/common/proxy/typed-handler.d.ts.map +1 -1
  242. package/dist/types/src/internal/common/types/base.d.ts +4 -4
  243. package/dist/types/src/internal/common/types/base.d.ts.map +1 -1
  244. package/dist/types/src/internal/common/types/entity.d.ts +63 -6
  245. package/dist/types/src/internal/common/types/entity.d.ts.map +1 -1
  246. package/dist/types/src/internal/common/types/index.d.ts +1 -1
  247. package/dist/types/src/internal/common/types/index.d.ts.map +1 -1
  248. package/dist/types/src/internal/common/types/meta.d.ts +23 -7
  249. package/dist/types/src/internal/common/types/meta.d.ts.map +1 -1
  250. package/dist/types/src/internal/common/types/model-symbols.d.ts +8 -4
  251. package/dist/types/src/internal/common/types/model-symbols.d.ts.map +1 -1
  252. package/dist/types/src/internal/common/types/typename.d.ts +7 -0
  253. package/dist/types/src/internal/common/types/typename.d.ts.map +1 -1
  254. package/dist/types/src/internal/common/types/version.d.ts +1 -1
  255. package/dist/types/src/internal/common/types/well-known-types.d.ts +11 -0
  256. package/dist/types/src/internal/common/types/well-known-types.d.ts.map +1 -0
  257. package/dist/types/src/internal/index.d.ts +2 -0
  258. package/dist/types/src/internal/index.d.ts.map +1 -1
  259. package/dist/types/src/testing/test-data.d.ts +8 -8
  260. package/dist/types/src/testing/test-data.d.ts.map +1 -1
  261. package/dist/types/src/testing/test-schema.d.ts +83 -89
  262. package/dist/types/src/testing/test-schema.d.ts.map +1 -1
  263. package/dist/types/src/testing/util.d.ts +5 -3
  264. package/dist/types/src/testing/util.d.ts.map +1 -1
  265. package/dist/types/tsconfig.tsbuildinfo +1 -1
  266. package/package.json +27 -19
  267. package/src/Annotation.test.ts +439 -0
  268. package/src/Annotation.ts +152 -4
  269. package/src/Collection.ts +6 -5
  270. package/src/Database.ts +117 -57
  271. package/src/Dataset.ts +10 -2
  272. package/src/Entity.test.ts +116 -6
  273. package/src/Entity.ts +130 -31
  274. package/src/Err.ts +4 -4
  275. package/src/Feed.ts +138 -43
  276. package/src/Filter.test.ts +90 -0
  277. package/src/Filter.ts +143 -27
  278. package/src/Hypergraph.ts +14 -9
  279. package/src/Json.test.ts +175 -0
  280. package/src/Json.ts +103 -0
  281. package/src/Key.ts +1 -1
  282. package/src/Migration.ts +114 -0
  283. package/src/Obj.test.ts +122 -19
  284. package/src/Obj.ts +279 -97
  285. package/src/Query.test.ts +317 -131
  286. package/src/Query.ts +181 -73
  287. package/src/QueryResult.ts +11 -0
  288. package/src/Ref.ts +22 -4
  289. package/src/Registry.ts +155 -0
  290. package/src/Relation.test.ts +10 -10
  291. package/src/Relation.ts +112 -71
  292. package/src/Scope.ts +50 -0
  293. package/src/StateMap.test.ts +56 -0
  294. package/src/StateMap.ts +99 -0
  295. package/src/Tag.md +88 -0
  296. package/src/Tag.ts +49 -6
  297. package/src/TagIndex.test.ts +57 -0
  298. package/src/TagIndex.ts +110 -0
  299. package/src/Tagging.ts +83 -0
  300. package/src/Type.test.ts +223 -18
  301. package/src/Type.ts +602 -132
  302. package/src/View.ts +11 -15
  303. package/src/exemplars.test.ts +21 -0
  304. package/src/index.ts +9 -3
  305. package/src/internal/Annotation/annotations.test.ts +82 -13
  306. package/src/internal/Annotation/annotations.ts +153 -115
  307. package/src/internal/Annotation/dictionary.ts +47 -0
  308. package/src/internal/Annotation/entity-dictionary.ts +40 -0
  309. package/src/internal/Annotation/index.ts +4 -2
  310. package/src/internal/Annotation/sorting.ts +0 -1
  311. package/src/internal/Annotation/util.ts +17 -8
  312. package/src/internal/Entity/api.ts +7 -8
  313. package/src/internal/Entity/entity.ts +196 -47
  314. package/src/internal/Entity/guard.ts +26 -0
  315. package/src/internal/Entity/index.ts +2 -0
  316. package/src/internal/Entity/model.ts +37 -28
  317. package/src/internal/Entity/object.ts +21 -6
  318. package/src/internal/Entity/relation.ts +68 -34
  319. package/src/internal/Entity/type-kind.ts +75 -0
  320. package/src/internal/Entity/type-uri.ts +87 -0
  321. package/src/internal/Entity/util.ts +10 -9
  322. package/src/internal/Entity/version.ts +0 -1
  323. package/src/internal/Format/date.test.ts +0 -1
  324. package/src/internal/Format/date.ts +0 -4
  325. package/src/internal/Format/format.test.ts +21 -1
  326. package/src/internal/Format/index.ts +2 -3
  327. package/src/internal/Format/object.ts +21 -4
  328. package/src/internal/Format/types.ts +1 -1
  329. package/src/internal/JsonSchema/annotations.ts +1 -1
  330. package/src/internal/JsonSchema/json-schema-type.ts +1 -1
  331. package/src/internal/JsonSchema/json-schema.test.ts +55 -142
  332. package/src/internal/JsonSchema/json-schema.ts +44 -31
  333. package/src/internal/Obj/clone.ts +9 -4
  334. package/src/internal/Obj/create-object.test.ts +13 -13
  335. package/src/internal/Obj/create-object.ts +68 -24
  336. package/src/internal/Obj/deleted.ts +1 -1
  337. package/src/internal/Obj/index.ts +0 -1
  338. package/src/internal/Obj/inspect.ts +4 -3
  339. package/src/internal/Obj/json-serializer.test.ts +102 -24
  340. package/src/internal/Obj/json-serializer.ts +105 -43
  341. package/src/internal/Obj/set-value.test.ts +31 -54
  342. package/src/internal/Obj/set-value.ts +1 -1
  343. package/src/internal/Obj/snapshot.ts +11 -4
  344. package/src/internal/Obj/typed-object.test.ts +9 -11
  345. package/src/internal/Obj/typed-object.ts +1 -1
  346. package/src/internal/Query.ts +159 -0
  347. package/src/internal/Ref/ref-array.ts +3 -4
  348. package/src/internal/Ref/ref.test.ts +17 -27
  349. package/src/internal/Ref/ref.ts +124 -59
  350. package/src/internal/Type/compose.test.ts +3 -2
  351. package/src/internal/Type/index.ts +1 -2
  352. package/src/internal/Type/manipulation.ts +0 -25
  353. package/src/internal/Type/type-schema.ts +60 -0
  354. package/src/internal/common/README.md +2 -2
  355. package/src/internal/common/api/meta.ts +19 -17
  356. package/src/internal/common/proxy/change-context.ts +1 -1
  357. package/src/internal/common/proxy/change.test.ts +118 -110
  358. package/src/internal/common/proxy/errors.ts +2 -2
  359. package/src/internal/common/proxy/handler.test.ts +1 -3
  360. package/src/internal/common/proxy/json-serializer.ts +26 -16
  361. package/src/internal/common/proxy/make-object.ts +43 -21
  362. package/src/internal/common/proxy/ownership.ts +2 -3
  363. package/src/internal/common/proxy/reactive-array.ts +1 -1
  364. package/src/internal/common/proxy/reactive.test.ts +54 -0
  365. package/src/internal/common/proxy/reactive.ts +11 -3
  366. package/src/internal/common/proxy/schema.test.ts +48 -86
  367. package/src/internal/common/proxy/typed-handler.test.ts +12 -12
  368. package/src/internal/common/proxy/typed-handler.ts +79 -19
  369. package/src/internal/common/proxy/typed-object.test.ts +16 -29
  370. package/src/internal/common/types/base.ts +4 -4
  371. package/src/internal/common/types/entity.ts +81 -2
  372. package/src/internal/common/types/index.ts +6 -1
  373. package/src/internal/common/types/meta.ts +49 -15
  374. package/src/internal/common/types/model-symbols.ts +16 -4
  375. package/src/internal/common/types/typename.ts +39 -3
  376. package/src/internal/common/types/well-known-types.ts +15 -0
  377. package/src/internal/index.ts +6 -0
  378. package/src/testing/api.test.ts +15 -10
  379. package/src/testing/test-data.ts +159 -100
  380. package/src/testing/test-schema.ts +22 -58
  381. package/src/testing/util.ts +14 -11
  382. package/dist/lib/neutral/SchemaRegistry.mjs +0 -2
  383. package/dist/lib/neutral/chunk-43Y5DOS6.mjs.map +0 -7
  384. package/dist/lib/neutral/chunk-724GQYEN.mjs +0 -56
  385. package/dist/lib/neutral/chunk-724GQYEN.mjs.map +0 -7
  386. package/dist/lib/neutral/chunk-ANHVGJI4.mjs.map +0 -7
  387. package/dist/lib/neutral/chunk-B5OXLWZL.mjs.map +0 -7
  388. package/dist/lib/neutral/chunk-BNCCGLJN.mjs +0 -7
  389. package/dist/lib/neutral/chunk-BNCCGLJN.mjs.map +0 -7
  390. package/dist/lib/neutral/chunk-BOZZPUXE.mjs.map +0 -7
  391. package/dist/lib/neutral/chunk-CIRHIEMW.mjs.map +0 -7
  392. package/dist/lib/neutral/chunk-DYDJBZEG.mjs +0 -102
  393. package/dist/lib/neutral/chunk-DYDJBZEG.mjs.map +0 -7
  394. package/dist/lib/neutral/chunk-FXEG7EOK.mjs.map +0 -7
  395. package/dist/lib/neutral/chunk-KTAWP7GI.mjs.map +0 -7
  396. package/dist/lib/neutral/chunk-NEGC54NE.mjs +0 -130
  397. package/dist/lib/neutral/chunk-NEGC54NE.mjs.map +0 -7
  398. package/dist/lib/neutral/chunk-NQRLRYJM.mjs.map +0 -7
  399. package/dist/lib/neutral/chunk-NXMFBIT5.mjs.map +0 -7
  400. package/dist/lib/neutral/chunk-OENWMTE6.mjs +0 -45
  401. package/dist/lib/neutral/chunk-OENWMTE6.mjs.map +0 -7
  402. package/dist/lib/neutral/chunk-OMUPQMLR.mjs.map +0 -7
  403. package/dist/lib/neutral/chunk-RMLF7JOZ.mjs +0 -97
  404. package/dist/lib/neutral/chunk-RMLF7JOZ.mjs.map +0 -7
  405. package/dist/lib/neutral/chunk-SEMVAGBM.mjs +0 -355
  406. package/dist/lib/neutral/chunk-SEMVAGBM.mjs.map +0 -7
  407. package/dist/lib/neutral/chunk-TQQZLKB7.mjs.map +0 -7
  408. package/dist/lib/neutral/chunk-UBEZSGXY.mjs.map +0 -7
  409. package/dist/lib/neutral/chunk-UFDK26FO.mjs.map +0 -7
  410. package/dist/lib/neutral/chunk-VA2F47ZC.mjs +0 -152
  411. package/dist/lib/neutral/chunk-VA2F47ZC.mjs.map +0 -7
  412. package/dist/lib/neutral/chunk-WYOKA6AE.mjs.map +0 -7
  413. package/dist/lib/neutral/chunk-YWXWXIE5.mjs.map +0 -7
  414. package/dist/types/src/SchemaRegistry.d.ts +0 -84
  415. package/dist/types/src/SchemaRegistry.d.ts.map +0 -1
  416. package/dist/types/src/internal/Obj/ids.d.ts +0 -6
  417. package/dist/types/src/internal/Obj/ids.d.ts.map +0 -1
  418. package/dist/types/src/internal/Type/echo-schema.d.ts +0 -181
  419. package/dist/types/src/internal/Type/echo-schema.d.ts.map +0 -1
  420. package/dist/types/src/internal/Type/persistent-schema.d.ts +0 -20
  421. package/dist/types/src/internal/Type/persistent-schema.d.ts.map +0 -1
  422. package/src/SchemaRegistry.ts +0 -106
  423. package/src/internal/Obj/ids.ts +0 -12
  424. package/src/internal/Type/echo-schema.ts +0 -424
  425. package/src/internal/Type/persistent-schema.ts +0 -33
  426. /package/dist/lib/neutral/{SchemaRegistry.mjs.map → Migration.mjs.map} +0 -0
  427. /package/dist/lib/neutral/{chunk-UTBRYVQC.mjs.map → chunk-G6CFWUYH.mjs.map} +0 -0
  428. /package/dist/lib/neutral/{chunk-UI6MWK5W.mjs.map → chunk-TTCSATUD.mjs.map} +0 -0
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@dxos/echo",
3
- "version": "0.8.4-main.40e3dcdf1b",
3
+ "version": "0.8.4-main.43cb759274",
4
4
  "description": "ECHO API",
5
5
  "homepage": "https://dxos.org",
6
6
  "bugs": "https://github.com/dxos/dxos/issues",
@@ -8,7 +8,7 @@
8
8
  "type": "git",
9
9
  "url": "https://github.com/dxos/dxos"
10
10
  },
11
- "license": "MIT",
11
+ "license": "FSL-1.1-Apache-2.0",
12
12
  "author": "info@dxos.org",
13
13
  "sideEffects": false,
14
14
  "type": "module",
@@ -73,6 +73,11 @@
73
73
  "types": "./dist/types/src/Key.d.ts",
74
74
  "default": "./dist/lib/neutral/Key.mjs"
75
75
  },
76
+ "./Migration": {
77
+ "source": "./src/Migration.ts",
78
+ "types": "./dist/types/src/Migration.d.ts",
79
+ "default": "./dist/lib/neutral/Migration.mjs"
80
+ },
76
81
  "./Obj": {
77
82
  "source": "./src/Obj.ts",
78
83
  "types": "./dist/types/src/Obj.d.ts",
@@ -98,15 +103,20 @@
98
103
  "types": "./dist/types/src/Ref.d.ts",
99
104
  "default": "./dist/lib/neutral/Ref.mjs"
100
105
  },
106
+ "./Registry": {
107
+ "source": "./src/Registry.ts",
108
+ "types": "./dist/types/src/Registry.d.ts",
109
+ "default": "./dist/lib/neutral/Registry.mjs"
110
+ },
101
111
  "./Relation": {
102
112
  "source": "./src/Relation.ts",
103
113
  "types": "./dist/types/src/Relation.d.ts",
104
114
  "default": "./dist/lib/neutral/Relation.mjs"
105
115
  },
106
- "./SchemaRegistry": {
107
- "source": "./src/SchemaRegistry.ts",
108
- "types": "./dist/types/src/SchemaRegistry.d.ts",
109
- "default": "./dist/lib/neutral/SchemaRegistry.mjs"
116
+ "./Scope": {
117
+ "source": "./src/Scope.ts",
118
+ "types": "./dist/types/src/Scope.d.ts",
119
+ "default": "./dist/lib/neutral/Scope.mjs"
110
120
  },
111
121
  "./Tag": {
112
122
  "source": "./src/Tag.ts",
@@ -124,19 +134,17 @@
124
134
  "src"
125
135
  ],
126
136
  "dependencies": {
127
- "effect": "3.19.16",
128
- "@dxos/async": "0.8.4-main.40e3dcdf1b",
129
- "@dxos/debug": "0.8.4-main.40e3dcdf1b",
130
- "@dxos/context": "0.8.4-main.40e3dcdf1b",
131
- "@dxos/effect": "0.8.4-main.40e3dcdf1b",
132
- "@dxos/errors": "0.8.4-main.40e3dcdf1b",
133
- "@dxos/invariant": "0.8.4-main.40e3dcdf1b",
134
- "@dxos/keys": "0.8.4-main.40e3dcdf1b",
135
- "@dxos/node-std": "0.8.4-main.40e3dcdf1b",
136
- "@dxos/protocols": "0.8.4-main.40e3dcdf1b",
137
- "@dxos/log": "0.8.4-main.40e3dcdf1b",
138
- "@dxos/echo-protocol": "0.8.4-main.40e3dcdf1b",
139
- "@dxos/util": "0.8.4-main.40e3dcdf1b"
137
+ "effect": "3.21.2",
138
+ "@dxos/debug": "0.8.4-main.43cb759274",
139
+ "@dxos/async": "0.8.4-main.43cb759274",
140
+ "@dxos/echo-protocol": "0.8.4-main.43cb759274",
141
+ "@dxos/effect": "0.8.4-main.43cb759274",
142
+ "@dxos/errors": "0.8.4-main.43cb759274",
143
+ "@dxos/invariant": "0.8.4-main.43cb759274",
144
+ "@dxos/keys": "0.8.4-main.43cb759274",
145
+ "@dxos/util": "0.8.4-main.43cb759274",
146
+ "@dxos/log": "0.8.4-main.43cb759274",
147
+ "@dxos/node-std": "0.8.4-main.43cb759274"
140
148
  },
141
149
  "publishConfig": {
142
150
  "access": "public"
@@ -0,0 +1,439 @@
1
+ //
2
+ // Copyright 2026 DXOS.org
3
+ //
4
+
5
+ import * as Option from 'effect/Option';
6
+ import * as Schema from 'effect/Schema';
7
+ import * as SchemaAST from 'effect/SchemaAST';
8
+ import { describe, test } from 'vitest';
9
+
10
+ import { DXN } from '@dxos/keys';
11
+
12
+ import * as Annotation from './Annotation';
13
+ import * as Obj from './Obj';
14
+ import * as Type from './Type';
15
+
16
+ describe('Annotation', () => {
17
+ describe('make', () => {
18
+ test('creates an annotation with a string schema', ({ expect }) => {
19
+ const ColorAnnotation = Annotation.make({
20
+ id: 'org.dxos.annotation.color',
21
+ schema: Schema.String,
22
+ });
23
+
24
+ expect(ColorAnnotation.key).toBe('org.dxos.annotation.color');
25
+ expect(ColorAnnotation.schema).toBe(Schema.String);
26
+ expect(ColorAnnotation[Annotation.TypeId]).toBeDefined();
27
+ });
28
+
29
+ test('creates an annotation with a number schema', ({ expect }) => {
30
+ const PriorityAnnotation = Annotation.make({
31
+ id: 'org.dxos.annotation.priority',
32
+ schema: Schema.Number,
33
+ });
34
+
35
+ expect(PriorityAnnotation.key).toBe('org.dxos.annotation.priority');
36
+ expect(PriorityAnnotation.schema).toBe(Schema.Number);
37
+ });
38
+
39
+ test('creates an annotation with a complex schema', ({ expect }) => {
40
+ const MetadataSchema = Schema.Struct({
41
+ author: Schema.String,
42
+ version: Schema.Number,
43
+ tags: Schema.Array(Schema.String),
44
+ });
45
+ const MetadataAnnotation = Annotation.make({
46
+ id: 'org.dxos.annotation.metadata',
47
+ schema: MetadataSchema,
48
+ });
49
+
50
+ expect(MetadataAnnotation.key).toBe('org.dxos.annotation.metadata');
51
+ expect(MetadataAnnotation.schema).toBe(MetadataSchema);
52
+ });
53
+ });
54
+
55
+ describe('getDictionary and setDictionary', () => {
56
+ test('set and get a string value', ({ expect }) => {
57
+ const ColorAnnotation = Annotation.make({
58
+ id: 'org.dxos.annotation.color',
59
+ schema: Schema.String,
60
+ });
61
+ const values: Annotation.Dictionary = {};
62
+
63
+ Annotation.setDictionary(values, ColorAnnotation, 'red');
64
+ const result = Annotation.getDictionary(values, ColorAnnotation);
65
+
66
+ expect(Option.isSome(result)).toBe(true);
67
+ expect(Option.getOrThrow(result)).toBe('red');
68
+ });
69
+
70
+ test('set and get a number value', ({ expect }) => {
71
+ const PriorityAnnotation = Annotation.make({
72
+ id: 'org.dxos.annotation.priority',
73
+ schema: Schema.Number,
74
+ });
75
+ const values: Annotation.Dictionary = {};
76
+
77
+ Annotation.setDictionary(values, PriorityAnnotation, 42);
78
+ const result = Annotation.getDictionary(values, PriorityAnnotation);
79
+
80
+ expect(Option.isSome(result)).toBe(true);
81
+ expect(Option.getOrThrow(result)).toBe(42);
82
+ });
83
+
84
+ test('set and get a boolean value', ({ expect }) => {
85
+ const EnabledAnnotation = Annotation.make({
86
+ id: 'org.dxos.annotation.enabled',
87
+ schema: Schema.Boolean,
88
+ });
89
+ const values: Annotation.Dictionary = {};
90
+
91
+ Annotation.setDictionary(values, EnabledAnnotation, true);
92
+ const result = Annotation.getDictionary(values, EnabledAnnotation);
93
+
94
+ expect(Option.isSome(result)).toBe(true);
95
+ expect(Option.getOrThrow(result)).toBe(true);
96
+ });
97
+
98
+ test('set and get a complex object value', ({ expect }) => {
99
+ const ConfigSchema = Schema.Struct({
100
+ theme: Schema.String,
101
+ fontSize: Schema.Number,
102
+ darkMode: Schema.Boolean,
103
+ });
104
+ const ConfigAnnotation = Annotation.make({
105
+ id: 'org.dxos.annotation.config',
106
+ schema: ConfigSchema,
107
+ });
108
+ const values: Annotation.Dictionary = {};
109
+
110
+ const config = { theme: 'modern', fontSize: 14, darkMode: true };
111
+ Annotation.setDictionary(values, ConfigAnnotation, config);
112
+ const result = Annotation.getDictionary(values, ConfigAnnotation);
113
+
114
+ expect(Option.isSome(result)).toBe(true);
115
+ expect(Option.getOrThrow(result)).toEqual(config);
116
+ });
117
+
118
+ test('set and get an array value', ({ expect }) => {
119
+ const TagsAnnotation = Annotation.make({
120
+ id: 'org.dxos.annotation.tags',
121
+ schema: Schema.Array(Schema.String),
122
+ });
123
+ const values: Annotation.Dictionary = {};
124
+
125
+ const tags = ['important', 'urgent', 'review'];
126
+ Annotation.setDictionary(values, TagsAnnotation, tags);
127
+ const result = Annotation.getDictionary(values, TagsAnnotation);
128
+
129
+ expect(Option.isSome(result)).toBe(true);
130
+ expect(Option.getOrThrow(result)).toEqual(tags);
131
+ });
132
+
133
+ test('get returns None for missing annotation', ({ expect }) => {
134
+ const ColorAnnotation = Annotation.make({
135
+ id: 'org.dxos.annotation.color',
136
+ schema: Schema.String,
137
+ });
138
+ const values: Annotation.Dictionary = {};
139
+
140
+ const result = Annotation.getDictionary(values, ColorAnnotation);
141
+
142
+ expect(Option.isNone(result)).toBe(true);
143
+ });
144
+
145
+ test('overwriting an annotation value', ({ expect }) => {
146
+ const ColorAnnotation = Annotation.make({
147
+ id: 'org.dxos.annotation.color',
148
+ schema: Schema.String,
149
+ });
150
+ const values: Annotation.Dictionary = {};
151
+
152
+ Annotation.setDictionary(values, ColorAnnotation, 'red');
153
+ Annotation.setDictionary(values, ColorAnnotation, 'blue');
154
+ const result = Annotation.getDictionary(values, ColorAnnotation);
155
+
156
+ expect(Option.isSome(result)).toBe(true);
157
+ expect(Option.getOrThrow(result)).toBe('blue');
158
+ });
159
+
160
+ test('multiple annotations on the same dictionary', ({ expect }) => {
161
+ const ColorAnnotation = Annotation.make({
162
+ id: 'org.dxos.annotation.color',
163
+ schema: Schema.String,
164
+ });
165
+ const PriorityAnnotation = Annotation.make({
166
+ id: 'org.dxos.annotation.priority',
167
+ schema: Schema.Number,
168
+ });
169
+ const EnabledAnnotation = Annotation.make({
170
+ id: 'org.dxos.annotation.enabled',
171
+ schema: Schema.Boolean,
172
+ });
173
+ const values: Annotation.Dictionary = {};
174
+
175
+ Annotation.setDictionary(values, ColorAnnotation, 'green');
176
+ Annotation.setDictionary(values, PriorityAnnotation, 5);
177
+ Annotation.setDictionary(values, EnabledAnnotation, false);
178
+
179
+ expect(Option.getOrThrow(Annotation.getDictionary(values, ColorAnnotation))).toBe('green');
180
+ expect(Option.getOrThrow(Annotation.getDictionary(values, PriorityAnnotation))).toBe(5);
181
+ expect(Option.getOrThrow(Annotation.getDictionary(values, EnabledAnnotation))).toBe(false);
182
+ });
183
+ });
184
+
185
+ describe('curried forms', () => {
186
+ test('getDictionary curried form', ({ expect }) => {
187
+ const ColorAnnotation = Annotation.make({
188
+ id: 'org.dxos.annotation.color',
189
+ schema: Schema.String,
190
+ });
191
+ const values: Annotation.Dictionary = {};
192
+ Annotation.setDictionary(values, ColorAnnotation, 'purple');
193
+
194
+ const getColor = Annotation.getDictionary(ColorAnnotation);
195
+ const result = getColor(values);
196
+
197
+ expect(Option.isSome(result)).toBe(true);
198
+ expect(Option.getOrThrow(result)).toBe('purple');
199
+ });
200
+
201
+ test('setDictionary curried form', ({ expect }) => {
202
+ const ColorAnnotation = Annotation.make({
203
+ id: 'org.dxos.annotation.color',
204
+ schema: Schema.String,
205
+ });
206
+ const values: Annotation.Dictionary = {};
207
+
208
+ const setOrange = Annotation.setDictionary(ColorAnnotation, 'orange');
209
+ setOrange(values);
210
+ const result = Annotation.getDictionary(values, ColorAnnotation);
211
+
212
+ expect(Option.isSome(result)).toBe(true);
213
+ expect(Option.getOrThrow(result)).toBe('orange');
214
+ });
215
+
216
+ test('curried forms work in pipelines', ({ expect }) => {
217
+ const ColorAnnotation = Annotation.make({
218
+ id: 'org.dxos.annotation.color',
219
+ schema: Schema.String,
220
+ });
221
+ const values: Annotation.Dictionary = {};
222
+
223
+ Annotation.setDictionary(ColorAnnotation, 'cyan')(values);
224
+ const result = Annotation.getDictionary(ColorAnnotation)(values);
225
+
226
+ expect(Option.isSome(result)).toBe(true);
227
+ expect(Option.getOrThrow(result)).toBe('cyan');
228
+ });
229
+ });
230
+
231
+ describe('Key', () => {
232
+ test('Key.make creates a branded key', ({ expect }) => {
233
+ const key = Annotation.Key.make('org.dxos.annotation.my-annotation');
234
+
235
+ expect(key).toBe('org.dxos.annotation.my-annotation');
236
+ expect(typeof key).toBe('string');
237
+ });
238
+ });
239
+
240
+ describe('Dictionary schema', () => {
241
+ test('Dictionary can be used as a schema', ({ expect }) => {
242
+ const PersonWithAnnotations = Schema.Struct({
243
+ name: Schema.String,
244
+ extensions: Annotation.Dictionary,
245
+ });
246
+
247
+ const person = Schema.decodeUnknownSync(PersonWithAnnotations)({
248
+ name: 'Alice',
249
+ extensions: {},
250
+ });
251
+
252
+ expect(person.name).toBe('Alice');
253
+ expect(person.extensions).toEqual({});
254
+ });
255
+
256
+ test('Dictionary schema accepts annotation data', ({ expect }) => {
257
+ const ColorAnnotation = Annotation.make({
258
+ id: 'org.dxos.annotation.color',
259
+ schema: Schema.String,
260
+ });
261
+ const values: Annotation.Dictionary = {};
262
+ Annotation.setDictionary(values, ColorAnnotation, 'red');
263
+
264
+ const PersonWithAnnotations = Schema.Struct({
265
+ name: Schema.String,
266
+ extensions: Annotation.Dictionary,
267
+ });
268
+
269
+ const person = Schema.decodeUnknownSync(PersonWithAnnotations)({
270
+ name: 'Bob',
271
+ extensions: values,
272
+ });
273
+
274
+ expect(person.name).toBe('Bob');
275
+ const color = Annotation.getDictionary(person.extensions, ColorAnnotation);
276
+ expect(Option.getOrThrow(color)).toBe('red');
277
+ });
278
+ });
279
+
280
+ describe('TypeId', () => {
281
+ test('TypeId is a unique symbol-like string', ({ expect }) => {
282
+ expect(Annotation.TypeId).toBe('~@dxos/echo/Annotation');
283
+ });
284
+
285
+ test('annotations have TypeId property', ({ expect }) => {
286
+ const ColorAnnotation = Annotation.make({
287
+ id: 'org.dxos.annotation.color',
288
+ schema: Schema.String,
289
+ });
290
+
291
+ expect(Annotation.TypeId in ColorAnnotation).toBe(true);
292
+ });
293
+ });
294
+
295
+ describe('schema', () => {
296
+ test('set and get on a struct schema', ({ expect }) => {
297
+ const ColorAnnotation = Annotation.make({
298
+ id: 'org.dxos.annotation.color',
299
+ schema: Schema.String,
300
+ });
301
+
302
+ const PersonSchema = Schema.Struct({
303
+ name: Schema.String,
304
+ }).pipe(ColorAnnotation.set('crimson'));
305
+
306
+ const result = ColorAnnotation.get(PersonSchema);
307
+
308
+ expect(Option.isSome(result)).toBe(true);
309
+ expect(Option.getOrThrow(result)).toBe('crimson');
310
+ });
311
+
312
+ test('get returns None when annotation is not on schema', ({ expect }) => {
313
+ const ColorAnnotation = Annotation.make({
314
+ id: 'org.dxos.annotation.color',
315
+ schema: Schema.String,
316
+ });
317
+
318
+ const PersonSchema = Schema.Struct({
319
+ name: Schema.String,
320
+ });
321
+
322
+ expect(Option.isNone(ColorAnnotation.get(PersonSchema))).toBe(true);
323
+ });
324
+
325
+ test('set and get on a property schema', ({ expect }) => {
326
+ const ColorAnnotation = Annotation.make({
327
+ id: 'org.dxos.annotation.color',
328
+ schema: Schema.String,
329
+ });
330
+
331
+ const PersonSchema = Schema.Struct({
332
+ name: Schema.String.pipe(ColorAnnotation.set('navy')),
333
+ });
334
+
335
+ const nameProperty = SchemaAST.getPropertySignatures(PersonSchema.ast).find((prop) => prop.name === 'name');
336
+ expect(nameProperty).toBeDefined();
337
+
338
+ const result = ColorAnnotation.getFromAst(nameProperty!.type);
339
+
340
+ expect(Option.isSome(result)).toBe(true);
341
+ expect(Option.getOrThrow(result)).toBe('navy');
342
+ });
343
+
344
+ test('annotation survives Type.makeObject and is readable from Type.getSchema', ({ expect }) => {
345
+ const ColorAnnotation = Annotation.make({
346
+ id: 'org.dxos.annotation.color',
347
+ schema: Schema.String,
348
+ });
349
+
350
+ const TaggedPerson = Schema.Struct({
351
+ name: Schema.String,
352
+ })
353
+ .pipe(ColorAnnotation.set('teal'))
354
+ .pipe(Type.makeObject(DXN.make('com.example.type.taggedperson', '0.1.0')));
355
+
356
+ const schema = Type.getSchema(TaggedPerson);
357
+ const result = ColorAnnotation.get(schema);
358
+
359
+ expect(Option.isSome(result)).toBe(true);
360
+ expect(Option.getOrThrow(result)).toBe('teal');
361
+ });
362
+ });
363
+
364
+ describe('object', () => {
365
+ const ColorAnnotation = Annotation.make({
366
+ id: 'org.dxos.annotation.color',
367
+ schema: Schema.String,
368
+ });
369
+ const Person = Schema.Struct({
370
+ name: Schema.String,
371
+ })
372
+ .pipe(ColorAnnotation.set('schema-teal'))
373
+ .pipe(Type.makeObject(DXN.make('com.example.type.taggedperson', '0.1.0')));
374
+
375
+ test('set and get on Obj.make instance', ({ expect }) => {
376
+ const person = Obj.make(Person, { name: 'Alice' });
377
+
378
+ Obj.update(person, (person) => {
379
+ Annotation.set(person, ColorAnnotation, 'instance-red');
380
+ });
381
+ const result = Annotation.get(person, ColorAnnotation);
382
+
383
+ expect(Option.isSome(result)).toBe(true);
384
+ expect(Option.getOrThrow(result)).toBe('instance-red');
385
+ });
386
+
387
+ test('get returns None when instance has no annotation value', ({ expect }) => {
388
+ const person = Obj.make(Person, { name: 'Bob' });
389
+
390
+ expect(Option.isNone(Annotation.get(person, ColorAnnotation))).toBe(true);
391
+ });
392
+
393
+ test('instance annotation is independent of schema default', ({ expect }) => {
394
+ const person = Obj.make(Person, { name: 'Carol' });
395
+
396
+ expect(Option.getOrThrow(ColorAnnotation.get(Type.getSchema(Person)))).toBe('schema-teal');
397
+ expect(Option.isNone(Annotation.get(person, ColorAnnotation))).toBe(true);
398
+
399
+ Obj.update(person, (person) => {
400
+ Annotation.set(person, ColorAnnotation, 'instance-blue');
401
+ });
402
+
403
+ expect(Option.getOrThrow(Annotation.get(person, ColorAnnotation))).toBe('instance-blue');
404
+ expect(Option.getOrThrow(ColorAnnotation.get(Type.getSchema(Person)))).toBe('schema-teal');
405
+ });
406
+
407
+ test('set and get inside Obj.update', ({ expect }) => {
408
+ const person = Obj.make(Person, { name: 'Dana' });
409
+
410
+ Obj.update(person, (person) => {
411
+ Annotation.set(person, ColorAnnotation, 'updated');
412
+ });
413
+
414
+ expect(Option.getOrThrow(Annotation.get(person, ColorAnnotation))).toBe('updated');
415
+ });
416
+
417
+ test('curried get and set on instances', ({ expect }) => {
418
+ const person = Obj.make(Person, { name: 'Eve' });
419
+
420
+ Obj.update(person, (person) => {
421
+ Annotation.set(ColorAnnotation, 'curried')(person);
422
+ });
423
+ const result = Annotation.get(ColorAnnotation)(person);
424
+
425
+ expect(Option.isSome(result)).toBe(true);
426
+ expect(Option.getOrThrow(result)).toBe('curried');
427
+ });
428
+
429
+ test('get reads annotation from a snapshot', ({ expect }) => {
430
+ const person = Obj.make(Person, { name: 'Frank' });
431
+ Obj.update(person, (person) => {
432
+ Annotation.set(person, ColorAnnotation, 'snapshot-color');
433
+ });
434
+
435
+ const snapshot = Obj.getSnapshot(person);
436
+ expect(Option.getOrThrow(Annotation.get(snapshot, ColorAnnotation))).toBe('snapshot-color');
437
+ });
438
+ });
439
+ });