@hyperscale0/hsx 1.0.0 → 1.0.124

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 (316) hide show
  1. package/CHANGELOG.md +5 -256
  2. package/LICENSE.md +356 -0
  3. package/NOTICE.md +8 -0
  4. package/README.md +44 -44
  5. package/bin/hsx.ts +0 -7
  6. package/dist/bin/hsx.d.ts +0 -4
  7. package/dist/bin/hsx.d.ts.map +1 -1
  8. package/dist/bin/hsx.js +0 -6
  9. package/dist/bin/hsx.js.map +1 -1
  10. package/dist/src/ast.d.ts +113 -308
  11. package/dist/src/ast.d.ts.map +1 -1
  12. package/dist/src/ast.js +7 -71
  13. package/dist/src/ast.js.map +1 -1
  14. package/dist/src/attachment-economics.d.ts +5 -0
  15. package/dist/src/attachment-economics.d.ts.map +1 -0
  16. package/dist/src/attachment-economics.js +55 -0
  17. package/dist/src/attachment-economics.js.map +1 -0
  18. package/dist/src/binding-contract.d.ts +22 -0
  19. package/dist/src/binding-contract.d.ts.map +1 -0
  20. package/dist/src/binding-contract.js +74 -0
  21. package/dist/src/binding-contract.js.map +1 -0
  22. package/dist/src/cli.d.ts +4 -19
  23. package/dist/src/cli.d.ts.map +1 -1
  24. package/dist/src/cli.js +89 -276
  25. package/dist/src/cli.js.map +1 -1
  26. package/dist/src/compile.d.ts +34 -66
  27. package/dist/src/compile.d.ts.map +1 -1
  28. package/dist/src/compile.js +2949 -117
  29. package/dist/src/compile.js.map +1 -1
  30. package/dist/src/cost.d.ts +8 -75
  31. package/dist/src/cost.d.ts.map +1 -1
  32. package/dist/src/cost.js +54 -364
  33. package/dist/src/cost.js.map +1 -1
  34. package/dist/src/diagnostics.d.ts +14 -9
  35. package/dist/src/diagnostics.d.ts.map +1 -1
  36. package/dist/src/diagnostics.js +39 -416
  37. package/dist/src/diagnostics.js.map +1 -1
  38. package/dist/src/examples-bundle.d.ts +3 -0
  39. package/dist/src/examples-bundle.d.ts.map +1 -0
  40. package/dist/src/examples-bundle.js +18 -0
  41. package/dist/src/examples-bundle.js.map +1 -0
  42. package/dist/src/examples.d.ts +10 -0
  43. package/dist/src/examples.d.ts.map +1 -0
  44. package/dist/src/examples.js +2 -0
  45. package/dist/src/examples.js.map +1 -0
  46. package/dist/src/format.d.ts +8 -7
  47. package/dist/src/format.d.ts.map +1 -1
  48. package/dist/src/format.js +9 -175
  49. package/dist/src/format.js.map +1 -1
  50. package/dist/src/header-source.d.ts +3 -0
  51. package/dist/src/header-source.d.ts.map +1 -0
  52. package/dist/src/header-source.js +41 -0
  53. package/dist/src/header-source.js.map +1 -0
  54. package/dist/src/headers.d.ts +64 -0
  55. package/dist/src/headers.d.ts.map +1 -0
  56. package/dist/src/headers.js +167 -0
  57. package/dist/src/headers.js.map +1 -0
  58. package/dist/src/index.d.ts +7 -11
  59. package/dist/src/index.d.ts.map +1 -1
  60. package/dist/src/index.js +4 -9
  61. package/dist/src/index.js.map +1 -1
  62. package/dist/src/keywords.d.ts +56 -0
  63. package/dist/src/keywords.d.ts.map +1 -0
  64. package/dist/src/keywords.js +133 -0
  65. package/dist/src/keywords.js.map +1 -0
  66. package/dist/src/language.d.ts +26 -0
  67. package/dist/src/language.d.ts.map +1 -0
  68. package/dist/src/language.js +440 -0
  69. package/dist/src/language.js.map +1 -0
  70. package/dist/src/lex.d.ts +13 -28
  71. package/dist/src/lex.d.ts.map +1 -1
  72. package/dist/src/lex.js +119 -145
  73. package/dist/src/lex.js.map +1 -1
  74. package/dist/src/parse.d.ts +4 -17
  75. package/dist/src/parse.d.ts.map +1 -1
  76. package/dist/src/parse.js +484 -1036
  77. package/dist/src/parse.js.map +1 -1
  78. package/dist/src/std-bundle.d.ts.map +1 -1
  79. package/dist/src/std-bundle.js +11 -84
  80. package/dist/src/std-bundle.js.map +1 -1
  81. package/dist/src/std-library.d.ts +1 -1
  82. package/dist/src/std-library.d.ts.map +1 -1
  83. package/dist/src/std-library.js +1 -5
  84. package/dist/src/std-library.js.map +1 -1
  85. package/dist/src/tunables.d.ts +7 -0
  86. package/dist/src/tunables.d.ts.map +1 -0
  87. package/dist/src/tunables.js +27 -0
  88. package/dist/src/tunables.js.map +1 -0
  89. package/docs/README.md +528 -26
  90. package/docs/assets/brand/hsx-horizontal-white.svg +1 -0
  91. package/docs/assets/brand/hsx-horizontal.svg +1 -0
  92. package/docs/assets/brand/hsx-stacked-white.svg +1 -0
  93. package/docs/assets/brand/hsx-stacked.svg +1 -0
  94. package/docs/assets/brand/manifest.json +30 -0
  95. package/docs/assets/hsx.svg +11 -0
  96. package/examples/cards.hsx +34 -0
  97. package/examples/collections.hsx +37 -0
  98. package/examples/cost-table.json +633 -385
  99. package/examples/escrow.hsx +24 -0
  100. package/examples/financing.hsx +32 -0
  101. package/examples/insurance.hsx +30 -0
  102. package/examples/lending.hsx +57 -0
  103. package/examples/library.hsx +15 -0
  104. package/examples/marketplace.hsx +32 -0
  105. package/examples/money.hsx +19 -0
  106. package/examples/rental-deposit.hsx +60 -0
  107. package/examples/repair-approval.hsx +44 -0
  108. package/examples/reporting.hsx +28 -0
  109. package/examples/savings.hsx +21 -0
  110. package/examples/serviced.hsx +25 -0
  111. package/examples/wallet.hsx +24 -0
  112. package/package.json +25 -23
  113. package/src/ast.ts +83 -440
  114. package/src/attachment-economics.ts +103 -0
  115. package/src/binding-contract.ts +104 -0
  116. package/src/cli.ts +95 -325
  117. package/src/compile.ts +4063 -209
  118. package/src/cost.ts +71 -574
  119. package/src/diagnostics.ts +57 -437
  120. package/src/examples-bundle.ts +19 -0
  121. package/src/examples.ts +9 -0
  122. package/src/format.ts +12 -256
  123. package/src/header-source.ts +54 -0
  124. package/src/headers.ts +195 -0
  125. package/src/index.ts +18 -33
  126. package/src/keywords.ts +134 -0
  127. package/src/language.ts +629 -0
  128. package/src/lex.ts +131 -192
  129. package/src/parse.ts +489 -1195
  130. package/src/std-bundle.ts +12 -88
  131. package/src/std-library.ts +2 -7
  132. package/src/tunables.ts +36 -0
  133. package/std/cards.hsx +85 -0
  134. package/std/collections.hsx +90 -0
  135. package/std/escrow.hsx +73 -0
  136. package/std/financing.hsx +683 -0
  137. package/std/insurance.hsx +89 -0
  138. package/std/lending.hsx +138 -0
  139. package/std/marketplace.hsx +123 -0
  140. package/std/money.hsx +173 -0
  141. package/std/reporting.hsx +753 -0
  142. package/std/savings.hsx +68 -0
  143. package/std/wallet.hsx +57 -0
  144. package/LICENSE +0 -661
  145. package/LICENSING.md +0 -52
  146. package/TRADEMARKS.md +0 -35
  147. package/dist/src/emit.d.ts +0 -34
  148. package/dist/src/emit.d.ts.map +0 -1
  149. package/dist/src/emit.js +0 -137
  150. package/dist/src/emit.js.map +0 -1
  151. package/dist/src/entry-overrides.d.ts +0 -58
  152. package/dist/src/entry-overrides.d.ts.map +0 -1
  153. package/dist/src/entry-overrides.js +0 -284
  154. package/dist/src/entry-overrides.js.map +0 -1
  155. package/dist/src/ir.d.ts +0 -66
  156. package/dist/src/ir.d.ts.map +0 -1
  157. package/dist/src/ir.js +0 -15
  158. package/dist/src/ir.js.map +0 -1
  159. package/dist/src/limits.d.ts +0 -21
  160. package/dist/src/limits.d.ts.map +0 -1
  161. package/dist/src/limits.js +0 -21
  162. package/dist/src/limits.js.map +0 -1
  163. package/dist/src/lsp/server.d.ts +0 -32
  164. package/dist/src/lsp/server.d.ts.map +0 -1
  165. package/dist/src/lsp/server.js +0 -391
  166. package/dist/src/lsp/server.js.map +0 -1
  167. package/dist/src/modules.d.ts +0 -38
  168. package/dist/src/modules.d.ts.map +0 -1
  169. package/dist/src/modules.js +0 -368
  170. package/dist/src/modules.js.map +0 -1
  171. package/dist/src/typecheck.d.ts +0 -8
  172. package/dist/src/typecheck.d.ts.map +0 -1
  173. package/dist/src/typecheck.js +0 -2958
  174. package/dist/src/typecheck.js.map +0 -1
  175. package/dist/src/version.d.ts +0 -5
  176. package/dist/src/version.d.ts.map +0 -1
  177. package/dist/src/version.js +0 -5
  178. package/dist/src/version.js.map +0 -1
  179. package/docs/guide/01-first-program.md +0 -24
  180. package/docs/guide/02-money.md +0 -25
  181. package/docs/guide/03-instruments.md +0 -22
  182. package/docs/guide/04-lifecycles.md +0 -25
  183. package/docs/guide/05-fees-and-splits.md +0 -45
  184. package/docs/guide/06-schedules.md +0 -22
  185. package/docs/guide/07-composition.md +0 -46
  186. package/docs/guide/08-writing-a-module.md +0 -26
  187. package/docs/guide/09-cost.md +0 -24
  188. package/docs/guide/10-diagnostics.md +0 -27
  189. package/docs/llms-full.txt +0 -1739
  190. package/docs/llms.txt +0 -45
  191. package/docs/playground.md +0 -54
  192. package/docs/reference/cli.md +0 -35
  193. package/docs/reference/diagnostics.md +0 -619
  194. package/docs/reference/grammar.md +0 -39
  195. package/docs/reference/std/advance.md +0 -35
  196. package/docs/reference/std/cancellable_booking.md +0 -35
  197. package/docs/reference/std/captured_payment.md +0 -43
  198. package/docs/reference/std/conditional_disbursement.md +0 -33
  199. package/docs/reference/std/credit_facility.md +0 -35
  200. package/docs/reference/std/held_payment.md +0 -64
  201. package/docs/reference/std/instant_transfer.md +0 -30
  202. package/docs/reference/std/metered.md +0 -27
  203. package/docs/reference/std/pooled_split.md +0 -26
  204. package/docs/reference/std/premium_forward.md +0 -39
  205. package/docs/reference/std/reconciled_payout.md +0 -33
  206. package/docs/reference/std/recurring_collection.md +0 -25
  207. package/docs/reference/std/rotating_pool.md +0 -42
  208. package/docs/reference/std/scheduled.md +0 -51
  209. package/docs/reference/std/security_deposit.md +0 -46
  210. package/docs/reference/std/settlement_batch.md +0 -42
  211. package/docs/reference/std/swap.md +0 -46
  212. package/docs/reference/std/threshold_pool.md +0 -47
  213. package/docs/reference/std/weighted_distribution.md +0 -39
  214. package/docs/reference/types.md +0 -20
  215. package/docs/reference/udl-output.md +0 -13
  216. package/docs/sessions/2026-09-02-two-instruments.hsx +0 -21
  217. package/docs/sessions/2026-09-02-two-instruments.md +0 -41
  218. package/examples/01-first-program/README.md +0 -45
  219. package/examples/01-first-program/tip-jar.hsx +0 -17
  220. package/examples/02-imports-and-archetypes/README.md +0 -96
  221. package/examples/02-imports-and-archetypes/photo-booth.hsx +0 -37
  222. package/examples/03-diagnostics/README.md +0 -68
  223. package/examples/03-diagnostics/corner-shop-fixed.hsx +0 -22
  224. package/examples/03-diagnostics/corner-shop.hsx +0 -19
  225. package/examples/04-complete-product/README.md +0 -84
  226. package/examples/04-complete-product/study-hall.hsx +0 -67
  227. package/examples/05-watch-club/README.md +0 -9
  228. package/examples/05-watch-club/watch-club.hsx +0 -124
  229. package/examples/README.md +0 -18
  230. package/examples/advance/README.md +0 -3
  231. package/examples/advance/advance.hsx +0 -13
  232. package/examples/advance/advance.udl +0 -339
  233. package/examples/cancellable_booking/README.md +0 -3
  234. package/examples/cancellable_booking/cancellable_booking.hsx +0 -14
  235. package/examples/cancellable_booking/cancellable_booking.udl +0 -391
  236. package/examples/captured_payment/README.md +0 -3
  237. package/examples/captured_payment/captured_payment.hsx +0 -21
  238. package/examples/captured_payment/captured_payment.udl +0 -677
  239. package/examples/conditional_disbursement/README.md +0 -3
  240. package/examples/conditional_disbursement/conditional_disbursement.hsx +0 -17
  241. package/examples/conditional_disbursement/conditional_disbursement.udl +0 -412
  242. package/examples/credit_facility/README.md +0 -3
  243. package/examples/credit_facility/credit_facility.hsx +0 -27
  244. package/examples/credit_facility/credit_facility.udl +0 -1373
  245. package/examples/held_payment/README.md +0 -3
  246. package/examples/held_payment/held_payment.hsx +0 -13
  247. package/examples/held_payment/held_payment.udl +0 -507
  248. package/examples/instant_transfer/README.md +0 -3
  249. package/examples/instant_transfer/instant_transfer.hsx +0 -16
  250. package/examples/instant_transfer/instant_transfer.udl +0 -364
  251. package/examples/metered/README.md +0 -3
  252. package/examples/metered/metered.hsx +0 -13
  253. package/examples/metered/metered.udl +0 -247
  254. package/examples/pooled_split/README.md +0 -3
  255. package/examples/pooled_split/pooled_split.hsx +0 -15
  256. package/examples/pooled_split/pooled_split.udl +0 -425
  257. package/examples/premium_forward/README.md +0 -3
  258. package/examples/premium_forward/premium_forward.hsx +0 -19
  259. package/examples/premium_forward/premium_forward.udl +0 -594
  260. package/examples/reconciled_payout/README.md +0 -3
  261. package/examples/reconciled_payout/reconciled_payout.hsx +0 -13
  262. package/examples/reconciled_payout/reconciled_payout.udl +0 -303
  263. package/examples/recurring_collection/README.md +0 -3
  264. package/examples/recurring_collection/recurring_collection.hsx +0 -21
  265. package/examples/recurring_collection/recurring_collection.udl +0 -1130
  266. package/examples/rotating_pool/README.md +0 -3
  267. package/examples/rotating_pool/rotating_pool.hsx +0 -18
  268. package/examples/rotating_pool/rotating_pool.udl +0 -4352
  269. package/examples/scheduled/README.md +0 -3
  270. package/examples/scheduled/scheduled.hsx +0 -12
  271. package/examples/scheduled/scheduled.udl +0 -335
  272. package/examples/security_deposit/README.md +0 -3
  273. package/examples/security_deposit/security_deposit.hsx +0 -21
  274. package/examples/security_deposit/security_deposit.udl +0 -293
  275. package/examples/settlement_batch/README.md +0 -3
  276. package/examples/settlement_batch/settlement_batch.hsx +0 -19
  277. package/examples/settlement_batch/settlement_batch.udl +0 -753
  278. package/examples/swap/README.md +0 -3
  279. package/examples/swap/swap.hsx +0 -19
  280. package/examples/swap/swap.udl +0 -876
  281. package/examples/threshold_pool/README.md +0 -3
  282. package/examples/threshold_pool/threshold_pool.hsx +0 -16
  283. package/examples/threshold_pool/threshold_pool.udl +0 -667
  284. package/examples/weighted_distribution/README.md +0 -3
  285. package/examples/weighted_distribution/weighted_distribution.hsx +0 -20
  286. package/examples/weighted_distribution/weighted_distribution.udl +0 -337
  287. package/skills/hsx/SKILL.md +0 -483
  288. package/src/emit.ts +0 -201
  289. package/src/entry-overrides.ts +0 -428
  290. package/src/ir.ts +0 -99
  291. package/src/limits.ts +0 -20
  292. package/src/lsp/server.ts +0 -460
  293. package/src/modules.ts +0 -446
  294. package/src/typecheck.ts +0 -3876
  295. package/src/version.ts +0 -5
  296. package/std/SEMANTICS.md +0 -130
  297. package/std/settlements/advance.hsx +0 -177
  298. package/std/settlements/cancellable_booking.hsx +0 -87
  299. package/std/settlements/captured_payment.hsx +0 -144
  300. package/std/settlements/conditional_disbursement.hsx +0 -185
  301. package/std/settlements/credit_facility.hsx +0 -167
  302. package/std/settlements/held_payment.hsx +0 -578
  303. package/std/settlements/index.hsx +0 -3
  304. package/std/settlements/instant_transfer.hsx +0 -190
  305. package/std/settlements/metered.hsx +0 -67
  306. package/std/settlements/pooled_split.hsx +0 -68
  307. package/std/settlements/premium_forward.hsx +0 -257
  308. package/std/settlements/reconciled_payout.hsx +0 -77
  309. package/std/settlements/recurring_collection.hsx +0 -27
  310. package/std/settlements/rotating_pool.hsx +0 -252
  311. package/std/settlements/scheduled.hsx +0 -641
  312. package/std/settlements/security_deposit.hsx +0 -166
  313. package/std/settlements/settlement_batch.hsx +0 -122
  314. package/std/settlements/swap.hsx +0 -1114
  315. package/std/settlements/threshold_pool.hsx +0 -221
  316. package/std/settlements/weighted_distribution.hsx +0 -141
@@ -1,425 +0,0 @@
1
- {
2
- "instruments": [
3
- {
4
- "actionOrder": [
5
- "create",
6
- "fund_share_1",
7
- "distribute_share_1",
8
- "fund_share_2",
9
- "distribute_share_2"
10
- ],
11
- "actions": {
12
- "create": {
13
- "agentDescription": "Open a pool period and provision the escrow account the pool sits in. This is the first call on the period, and funding a share refuses until it lands. It moves no money.",
14
- "moves": [],
15
- "publicAction": "createPool",
16
- "steps": [
17
- {
18
- "bind": {
19
- "currency": {
20
- "from": "instance",
21
- "path": "fields.currency"
22
- },
23
- "owner.id": {
24
- "from": "instance",
25
- "path": "productId"
26
- },
27
- "owner.type": {
28
- "from": "const",
29
- "value": "product"
30
- },
31
- "productId": {
32
- "from": "instance",
33
- "path": "productId"
34
- },
35
- "role": {
36
- "from": "const",
37
- "value": "product_escrow"
38
- }
39
- },
40
- "capture": {
41
- "escrowAccountId": "accountId"
42
- },
43
- "operation": "account.escrow.provision"
44
- }
45
- ],
46
- "summary": "Open a pool period"
47
- },
48
- "distribute_share_1": {
49
- "due": {
50
- "field": "payoutDueAt"
51
- },
52
- "effects": {
53
- "moves": [
54
- {
55
- "signature": "moves.transfer.internal",
56
- "source": "moves[0]"
57
- }
58
- ],
59
- "schedules": [
60
- {
61
- "signature": "schedules.due",
62
- "source": "due"
63
- }
64
- ]
65
- },
66
- "moves": [
67
- {
68
- "bind": {
69
- "amount": {
70
- "from": "instance",
71
- "path": "fields.firstRecipientShareAmount"
72
- },
73
- "currency": {
74
- "from": "instance",
75
- "path": "fields.currency"
76
- },
77
- "destinationAccountId": {
78
- "from": "instance",
79
- "path": "fields.firstRecipientAccountId"
80
- },
81
- "metadata.instrumentId": {
82
- "from": "const",
83
- "value": "pool"
84
- },
85
- "metadata.instrumentInstanceId": {
86
- "from": "instance",
87
- "path": "instrumentInstanceId"
88
- },
89
- "metadata.phase": {
90
- "from": "const",
91
- "value": "distribute_share_1"
92
- },
93
- "productId": {
94
- "from": "instance",
95
- "path": "productId"
96
- },
97
- "sourceAccountId": {
98
- "from": "instance",
99
- "path": "refs.escrowAccountId"
100
- }
101
- },
102
- "capture": {
103
- "distributeShare1TransferTransferId": "transferId"
104
- },
105
- "key": "transfer",
106
- "operation": "internal_transfer.create"
107
- }
108
- ],
109
- "steps": [],
110
- "summary": "Distribute the first recipient's share of the pool"
111
- },
112
- "distribute_share_2": {
113
- "due": {
114
- "field": "payoutDueAt"
115
- },
116
- "effects": {
117
- "moves": [
118
- {
119
- "signature": "moves.transfer.internal",
120
- "source": "moves[0]"
121
- }
122
- ],
123
- "schedules": [
124
- {
125
- "signature": "schedules.due",
126
- "source": "due"
127
- }
128
- ]
129
- },
130
- "moves": [
131
- {
132
- "bind": {
133
- "amount": {
134
- "from": "instance",
135
- "path": "fields.secondRecipientShareAmount"
136
- },
137
- "currency": {
138
- "from": "instance",
139
- "path": "fields.currency"
140
- },
141
- "destinationAccountId": {
142
- "from": "instance",
143
- "path": "fields.secondRecipientAccountId"
144
- },
145
- "metadata.instrumentId": {
146
- "from": "const",
147
- "value": "pool"
148
- },
149
- "metadata.instrumentInstanceId": {
150
- "from": "instance",
151
- "path": "instrumentInstanceId"
152
- },
153
- "metadata.phase": {
154
- "from": "const",
155
- "value": "distribute_share_2"
156
- },
157
- "productId": {
158
- "from": "instance",
159
- "path": "productId"
160
- },
161
- "sourceAccountId": {
162
- "from": "instance",
163
- "path": "refs.escrowAccountId"
164
- }
165
- },
166
- "capture": {
167
- "distributeShare2TransferTransferId": "transferId"
168
- },
169
- "key": "transfer",
170
- "operation": "internal_transfer.create"
171
- }
172
- ],
173
- "steps": [],
174
- "summary": "Distribute the second recipient's share of the pool"
175
- },
176
- "fund_share_1": {
177
- "agentDescription": "Move share 1 of the period total, the first recipient's cut, from the payer into the pool escrow. Shares fund in order, so every earlier share must be in already. It debits the payer for real. The pool pays out from the stored payout date with no release call.",
178
- "effects": {
179
- "moves": [
180
- {
181
- "signature": "moves.collection.pay_in",
182
- "source": "moves[0]"
183
- }
184
- ]
185
- },
186
- "moves": [
187
- {
188
- "bind": {
189
- "amount": {
190
- "from": "instance",
191
- "path": "fields.firstRecipientShareAmount"
192
- },
193
- "currency": {
194
- "from": "instance",
195
- "path": "fields.currency"
196
- },
197
- "destinationAccountId": {
198
- "from": "instance",
199
- "path": "refs.escrowAccountId"
200
- },
201
- "metadata.instrumentId": {
202
- "from": "const",
203
- "value": "pool"
204
- },
205
- "metadata.instrumentInstanceId": {
206
- "from": "instance",
207
- "path": "instrumentInstanceId"
208
- },
209
- "metadata.phase": {
210
- "from": "const",
211
- "value": "fund_share_1"
212
- },
213
- "productId": {
214
- "from": "instance",
215
- "path": "productId"
216
- },
217
- "sourceAccountId": {
218
- "from": "instance",
219
- "path": "fields.payerAccountId"
220
- }
221
- },
222
- "capture": {
223
- "fundShare1TransferTransferId": "transferId"
224
- },
225
- "key": "transfer",
226
- "operation": "internal_transfer.create"
227
- }
228
- ],
229
- "publicAction": "fundShare1Pool",
230
- "steps": [],
231
- "summary": "Pool share 1 of the period total"
232
- },
233
- "fund_share_2": {
234
- "agentDescription": "Move share 2 of the period total, the second recipient's cut, from the payer into the pool escrow. Shares fund in order, so every earlier share must be in already. It debits the payer for real. The pool pays out from the stored payout date with no release call.",
235
- "effects": {
236
- "moves": [
237
- {
238
- "signature": "moves.collection.pay_in",
239
- "source": "moves[0]"
240
- }
241
- ]
242
- },
243
- "moves": [
244
- {
245
- "bind": {
246
- "amount": {
247
- "from": "instance",
248
- "path": "fields.secondRecipientShareAmount"
249
- },
250
- "currency": {
251
- "from": "instance",
252
- "path": "fields.currency"
253
- },
254
- "destinationAccountId": {
255
- "from": "instance",
256
- "path": "refs.escrowAccountId"
257
- },
258
- "metadata.instrumentId": {
259
- "from": "const",
260
- "value": "pool"
261
- },
262
- "metadata.instrumentInstanceId": {
263
- "from": "instance",
264
- "path": "instrumentInstanceId"
265
- },
266
- "metadata.phase": {
267
- "from": "const",
268
- "value": "fund_share_2"
269
- },
270
- "productId": {
271
- "from": "instance",
272
- "path": "productId"
273
- },
274
- "sourceAccountId": {
275
- "from": "instance",
276
- "path": "fields.payerAccountId"
277
- }
278
- },
279
- "capture": {
280
- "fundShare2TransferTransferId": "transferId"
281
- },
282
- "key": "transfer",
283
- "operation": "internal_transfer.create"
284
- }
285
- ],
286
- "publicAction": "fundShare2Pool",
287
- "steps": [],
288
- "summary": "Pool share 2 of the period total"
289
- }
290
- },
291
- "agentDescription": "Reach for pool when the payer funds one period total that is then split across 2 fixed recipients by stored share amounts. Callers fund the pool one share at a time. Each recipient's payout fires from the stored payout date, not from a call.",
292
- "description": "Pooled split: the payer pools the period's poolAmount share by share; the pool distributes to every recipient in full on the stored payout date",
293
- "fields": {
294
- "currency": {
295
- "description": "ISO 4217 currency code",
296
- "maxLength": 3,
297
- "minLength": 3,
298
- "pattern": "^[A-Z]{3}$",
299
- "type": "string"
300
- },
301
- "firstRecipientAccountId": {
302
- "description": "The first recipient account",
303
- "pattern": "^acct_(sandbox|live)_[a-z0-9]{8,64}$",
304
- "type": "string",
305
- "x-hyperscale-reference-filter": {
306
- "column": "role",
307
- "values": [
308
- "customer_balance"
309
- ]
310
- }
311
- },
312
- "firstRecipientShareAmount": {
313
- "description": "60% of poolAmount (carries the integer-division remainder): the first recipient's share. Computed as floor(poolAmount * 6000 / 10000) in SAR minor units",
314
- "pattern": "^[1-9][0-9]{0,17}$",
315
- "type": "string"
316
- },
317
- "payerAccountId": {
318
- "description": "The payer account",
319
- "pattern": "^acct_(sandbox|live)_[a-z0-9]{8,64}$",
320
- "type": "string",
321
- "x-hyperscale-reference-filter": {
322
- "column": "role",
323
- "values": [
324
- "customer_balance"
325
- ]
326
- }
327
- },
328
- "payoutDueAt": {
329
- "description": "The period's payout date; the pool distributes from it",
330
- "format": "hyperscale-date-time",
331
- "type": "string"
332
- },
333
- "poolAmount": {
334
- "description": "The pooled period total in SAR minor units; the share fields below partition it exactly",
335
- "pattern": "^[1-9][0-9]{0,17}$",
336
- "type": "string"
337
- },
338
- "secondRecipientAccountId": {
339
- "description": "The second recipient account",
340
- "pattern": "^acct_(sandbox|live)_[a-z0-9]{8,64}$",
341
- "type": "string",
342
- "x-hyperscale-reference-filter": {
343
- "column": "role",
344
- "values": [
345
- "customer_balance"
346
- ]
347
- }
348
- },
349
- "secondRecipientShareAmount": {
350
- "description": "40% of poolAmount: the second recipient's share. Computed as floor(poolAmount * 4000 / 10000) in SAR minor units",
351
- "pattern": "^[1-9][0-9]{0,17}$",
352
- "type": "string"
353
- }
354
- },
355
- "id": "pool",
356
- "idPrefix": "pool",
357
- "lifecycle": {
358
- "initial": "created",
359
- "states": [
360
- "created",
361
- "pooling_1",
362
- "pooled",
363
- "distributing_1",
364
- "distributed"
365
- ],
366
- "transitions": {
367
- "distribute_share_1": {
368
- "from": [
369
- "pooled"
370
- ],
371
- "to": "distributing_1"
372
- },
373
- "distribute_share_2": {
374
- "from": [
375
- "distributing_1"
376
- ],
377
- "to": "distributed"
378
- },
379
- "fund_share_1": {
380
- "from": [
381
- "created"
382
- ],
383
- "to": "pooling_1"
384
- },
385
- "fund_share_2": {
386
- "from": [
387
- "pooling_1"
388
- ],
389
- "to": "pooled"
390
- }
391
- }
392
- },
393
- "parties": {
394
- "beneficiary": "firstRecipientAccountId",
395
- "payer": "payerAccountId"
396
- },
397
- "partitions": [
398
- {
399
- "pieceFields": [
400
- "firstRecipientShareAmount",
401
- "secondRecipientShareAmount"
402
- ],
403
- "totalField": "poolAmount"
404
- }
405
- ],
406
- "required": [
407
- "payerAccountId",
408
- "firstRecipientAccountId",
409
- "secondRecipientAccountId",
410
- "poolAmount",
411
- "payoutDueAt",
412
- "firstRecipientShareAmount",
413
- "secondRecipientShareAmount",
414
- "currency"
415
- ],
416
- "summary": "Period pool from payer split 2 ways",
417
- "title": "Pool"
418
- }
419
- ],
420
- "product": "pooled_split_example",
421
- "subjects": [],
422
- "title": "Pooled split example",
423
- "udl": 1,
424
- "version": 1
425
- }
@@ -1,3 +0,0 @@
1
- # premium_forward
2
-
3
- This example applies the `premium_forward` standard-library module. Its sibling UDL file pins the canonical compiler output byte for byte. The company and parties are invented.
@@ -1,19 +0,0 @@
1
- program premium_forward_example "Premium forward example"
2
- import { premium_forward } from "std/settlements"
3
- party policyholder: person
4
- party carrier: business
5
- settlement premium = premium_forward {
6
- payer: policyholder
7
- carrier: carrier
8
- amount: premiumAmount: money(SAR)
9
- commission: 2%
10
- bind: port bind_policy
11
- policy_ref: policyReference
12
- renewal_due: renewalDueAt
13
- endorsement: port record_endorsement
14
- }
15
- port bind_policy { allowed: [policyholder, carrier] }
16
- port record_endorsement {
17
- allowed: [carrier]
18
- shape: { evidenceReference: text }
19
- }