lawspec 0.29.2 → 0.31.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.
- package/CHANGELOG.md +407 -1
- package/README.md +9 -3
- package/api.mjs +1 -0
- package/beam-doctor.mjs +2 -2
- package/bin/lawspec.mjs +100 -102
- package/build.json +503 -411
- package/component-packages.mjs +339 -0
- package/component.d.ts +46 -0
- package/component.mjs +208 -0
- package/core.wasm +2 -2
- package/core_jsffi.js +5 -5
- package/examples/native-payments/clojure/lawspec.edn +48 -0
- package/examples/native-payments/clojure/src/domain/payments.clj +1 -1
- package/examples/native-payments/clojure/test/domain/payment_generators.clj +1 -1
- package/examples/native-payments/csharp/lawspec.edn +48 -0
- package/examples/native-payments/elixir/lawspec.edn +123 -0
- package/examples/native-payments/erlang/lawspec.edn +128 -0
- package/examples/native-payments/fsharp/lawspec.edn +123 -0
- package/examples/native-payments/gleam/lawspec.edn +123 -0
- package/examples/native-payments/go/lawspec.edn +123 -0
- package/examples/native-payments/groovy/lawspec.edn +123 -0
- package/examples/native-payments/haskell/lawspec.edn +123 -0
- package/examples/native-payments/java/lawspec.edn +123 -0
- package/examples/native-payments/javascript/lawspec.edn +123 -0
- package/examples/native-payments/kotlin/lawspec.edn +123 -0
- package/examples/native-payments/prolog/lawspec.edn +48 -0
- package/examples/native-payments/python/lawspec.edn +123 -0
- package/examples/native-payments/rust/lawspec.edn +124 -0
- package/examples/native-payments/scala/lawspec.edn +123 -0
- package/examples/native-payments/swift/lawspec.edn +123 -0
- package/examples/native-payments/typescript/lawspec.edn +123 -0
- package/examples/packages/orders/lawspec.edn +25 -0
- package/examples/packages/shop-domain/lawspec.edn +13 -0
- package/examples/packages/shop-tax-1/lawspec.edn +9 -0
- package/examples/packages/shop-tax-2/lawspec.edn +9 -0
- package/examples/specs/handler_bindings.lawspec +2 -2
- package/examples/specs/harness_testing.lawspec +1 -1
- package/files.mjs +2 -1
- package/go.mod +4 -0
- package/index.d.ts +145 -8
- package/input-files.mjs +47 -0
- package/launcher.mjs +33 -13
- package/lsp.mjs +10 -5
- package/native-evidence.mjs +58 -19
- package/native-examples.mjs +8 -7
- package/native-host.mjs +71 -0
- package/package.json +8 -3
- package/proof.d.ts +8 -2
- package/proof.mjs +186 -34
- package/scala-build-state.mjs +59 -0
- package/templates.mjs +242 -2
- package/test-command.mjs +193 -61
- package/builtin-data-names.mjs +0 -73
- package/examples/native-payments/clojure/lawspec.json +0 -62
- package/examples/native-payments/csharp/lawspec.json +0 -62
- package/examples/native-payments/elixir/lawspec.json +0 -160
- package/examples/native-payments/erlang/lawspec.json +0 -159
- package/examples/native-payments/fsharp/lawspec.json +0 -178
- package/examples/native-payments/gleam/lawspec.json +0 -160
- package/examples/native-payments/go/lawspec.json +0 -147
- package/examples/native-payments/groovy/lawspec.json +0 -176
- package/examples/native-payments/haskell/lawspec.json +0 -160
- package/examples/native-payments/java/lawspec.json +0 -176
- package/examples/native-payments/javascript/lawspec.json +0 -160
- package/examples/native-payments/kotlin/lawspec.json +0 -176
- package/examples/native-payments/prolog/lawspec.json +0 -20
- package/examples/native-payments/python/lawspec.json +0 -160
- package/examples/native-payments/rust/lawspec.json +0 -178
- package/examples/native-payments/scala/lawspec.json +0 -176
- package/examples/native-payments/swift/lawspec.json +0 -165
- package/examples/native-payments/typescript/lawspec.json +0 -160
- package/examples/packages/orders/lawspec.json +0 -27
- package/examples/packages/shop-domain/lawspec-package.json +0 -7
- package/examples/packages/shop-tax-1/lawspec-package.json +0 -5
- package/examples/packages/shop-tax-2/lawspec-package.json +0 -5
- package/explain.mjs +0 -114
- package/expression-presentation.mjs +0 -333
- package/positional-fields.mjs +0 -13
- package/typed-presentation.mjs +0 -165
|
@@ -1,176 +0,0 @@
|
|
|
1
|
-
{
|
|
2
|
-
"version": 2,
|
|
3
|
-
"sources": [
|
|
4
|
-
"laws"
|
|
5
|
-
],
|
|
6
|
-
"machineBits": 64,
|
|
7
|
-
"targets": [
|
|
8
|
-
{
|
|
9
|
-
"language": "scala",
|
|
10
|
-
"root": ".",
|
|
11
|
-
"nativeBindings": {
|
|
12
|
-
"types": [
|
|
13
|
-
{
|
|
14
|
-
"type": "example.payments::type::Currency",
|
|
15
|
-
"native": [
|
|
16
|
-
"domain",
|
|
17
|
-
"PaymentsDomain",
|
|
18
|
-
"CurrencyCode"
|
|
19
|
-
],
|
|
20
|
-
"constructors": [
|
|
21
|
-
{
|
|
22
|
-
"constructor": "USD",
|
|
23
|
-
"native": [
|
|
24
|
-
"domain",
|
|
25
|
-
"PaymentsDomain",
|
|
26
|
-
"CurrencyCode",
|
|
27
|
-
"Dollars"
|
|
28
|
-
],
|
|
29
|
-
"style": "unit",
|
|
30
|
-
"fields": []
|
|
31
|
-
},
|
|
32
|
-
{
|
|
33
|
-
"constructor": "EUR",
|
|
34
|
-
"native": [
|
|
35
|
-
"domain",
|
|
36
|
-
"PaymentsDomain",
|
|
37
|
-
"CurrencyCode",
|
|
38
|
-
"Euros"
|
|
39
|
-
],
|
|
40
|
-
"style": "unit",
|
|
41
|
-
"fields": []
|
|
42
|
-
},
|
|
43
|
-
{
|
|
44
|
-
"constructor": "GBP",
|
|
45
|
-
"native": [
|
|
46
|
-
"domain",
|
|
47
|
-
"PaymentsDomain",
|
|
48
|
-
"CurrencyCode",
|
|
49
|
-
"Pounds"
|
|
50
|
-
],
|
|
51
|
-
"style": "unit",
|
|
52
|
-
"fields": []
|
|
53
|
-
}
|
|
54
|
-
]
|
|
55
|
-
},
|
|
56
|
-
{
|
|
57
|
-
"type": "example.payments::type::Money",
|
|
58
|
-
"native": [
|
|
59
|
-
"domain",
|
|
60
|
-
"PaymentsDomain",
|
|
61
|
-
"Price"
|
|
62
|
-
],
|
|
63
|
-
"constructors": [
|
|
64
|
-
{
|
|
65
|
-
"constructor": "Money",
|
|
66
|
-
"native": [
|
|
67
|
-
"domain",
|
|
68
|
-
"PaymentsDomain",
|
|
69
|
-
"Price"
|
|
70
|
-
],
|
|
71
|
-
"style": "record",
|
|
72
|
-
"fields": [
|
|
73
|
-
{
|
|
74
|
-
"field": "amount",
|
|
75
|
-
"native": "major"
|
|
76
|
-
},
|
|
77
|
-
{
|
|
78
|
-
"field": "currency",
|
|
79
|
-
"native": "unit"
|
|
80
|
-
}
|
|
81
|
-
]
|
|
82
|
-
}
|
|
83
|
-
]
|
|
84
|
-
},
|
|
85
|
-
{
|
|
86
|
-
"type": "example.payments::type::Payment",
|
|
87
|
-
"native": [
|
|
88
|
-
"domain",
|
|
89
|
-
"PaymentsDomain",
|
|
90
|
-
"PaymentStatus"
|
|
91
|
-
],
|
|
92
|
-
"constructors": [
|
|
93
|
-
{
|
|
94
|
-
"constructor": "Paid",
|
|
95
|
-
"native": [
|
|
96
|
-
"domain",
|
|
97
|
-
"PaymentsDomain",
|
|
98
|
-
"Settled"
|
|
99
|
-
],
|
|
100
|
-
"style": "variant",
|
|
101
|
-
"fields": [
|
|
102
|
-
{
|
|
103
|
-
"field": "value",
|
|
104
|
-
"native": "price"
|
|
105
|
-
}
|
|
106
|
-
]
|
|
107
|
-
},
|
|
108
|
-
{
|
|
109
|
-
"constructor": "Declined",
|
|
110
|
-
"native": [
|
|
111
|
-
"domain",
|
|
112
|
-
"PaymentsDomain",
|
|
113
|
-
"Rejected"
|
|
114
|
-
],
|
|
115
|
-
"style": "variant",
|
|
116
|
-
"fields": [
|
|
117
|
-
{
|
|
118
|
-
"field": "value",
|
|
119
|
-
"native": "explanation"
|
|
120
|
-
}
|
|
121
|
-
]
|
|
122
|
-
}
|
|
123
|
-
]
|
|
124
|
-
}
|
|
125
|
-
],
|
|
126
|
-
"functions": [
|
|
127
|
-
{
|
|
128
|
-
"declaration": "example.payments::addFee",
|
|
129
|
-
"native": [
|
|
130
|
-
"domain",
|
|
131
|
-
"PaymentsDomain",
|
|
132
|
-
"apply_fee"
|
|
133
|
-
]
|
|
134
|
-
},
|
|
135
|
-
{
|
|
136
|
-
"declaration": "example.payments::roundTrip",
|
|
137
|
-
"native": [
|
|
138
|
-
"domain",
|
|
139
|
-
"PaymentsDomain",
|
|
140
|
-
"restore"
|
|
141
|
-
]
|
|
142
|
-
},
|
|
143
|
-
{
|
|
144
|
-
"declaration": "example.payments::archive",
|
|
145
|
-
"native": [
|
|
146
|
-
"domain",
|
|
147
|
-
"PaymentsDomain",
|
|
148
|
-
"store"
|
|
149
|
-
]
|
|
150
|
-
}
|
|
151
|
-
],
|
|
152
|
-
"generators": [
|
|
153
|
-
{
|
|
154
|
-
"type": "example.payments::type::Money",
|
|
155
|
-
"factory": [
|
|
156
|
-
"domain",
|
|
157
|
-
"PaymentGenerators",
|
|
158
|
-
"prices"
|
|
159
|
-
]
|
|
160
|
-
}
|
|
161
|
-
]
|
|
162
|
-
}
|
|
163
|
-
}
|
|
164
|
-
],
|
|
165
|
-
"languageProfile": "1.0-rc.2",
|
|
166
|
-
"verification": {
|
|
167
|
-
"layers": [
|
|
168
|
-
"proof",
|
|
169
|
-
"exhaustive",
|
|
170
|
-
"property",
|
|
171
|
-
"examples",
|
|
172
|
-
"runtime",
|
|
173
|
-
"model"
|
|
174
|
-
]
|
|
175
|
-
}
|
|
176
|
-
}
|
|
@@ -1,165 +0,0 @@
|
|
|
1
|
-
{
|
|
2
|
-
"version": 2,
|
|
3
|
-
"sources": [
|
|
4
|
-
"laws"
|
|
5
|
-
],
|
|
6
|
-
"machineBits": 64,
|
|
7
|
-
"targets": [
|
|
8
|
-
{
|
|
9
|
-
"language": "swift",
|
|
10
|
-
"root": ".",
|
|
11
|
-
"nativeBindings": {
|
|
12
|
-
"types": [
|
|
13
|
-
{
|
|
14
|
-
"type": "example.payments::type::Currency",
|
|
15
|
-
"native": [
|
|
16
|
-
"PaymentsDomain",
|
|
17
|
-
"CurrencyCode"
|
|
18
|
-
],
|
|
19
|
-
"constructors": [
|
|
20
|
-
{
|
|
21
|
-
"constructor": "USD",
|
|
22
|
-
"native": [
|
|
23
|
-
"PaymentsDomain",
|
|
24
|
-
"CurrencyCode",
|
|
25
|
-
"dollars"
|
|
26
|
-
],
|
|
27
|
-
"style": "unit",
|
|
28
|
-
"fields": []
|
|
29
|
-
},
|
|
30
|
-
{
|
|
31
|
-
"constructor": "EUR",
|
|
32
|
-
"native": [
|
|
33
|
-
"PaymentsDomain",
|
|
34
|
-
"CurrencyCode",
|
|
35
|
-
"euros"
|
|
36
|
-
],
|
|
37
|
-
"style": "unit",
|
|
38
|
-
"fields": []
|
|
39
|
-
},
|
|
40
|
-
{
|
|
41
|
-
"constructor": "GBP",
|
|
42
|
-
"native": [
|
|
43
|
-
"PaymentsDomain",
|
|
44
|
-
"CurrencyCode",
|
|
45
|
-
"pounds"
|
|
46
|
-
],
|
|
47
|
-
"style": "unit",
|
|
48
|
-
"fields": []
|
|
49
|
-
}
|
|
50
|
-
]
|
|
51
|
-
},
|
|
52
|
-
{
|
|
53
|
-
"type": "example.payments::type::Money",
|
|
54
|
-
"native": [
|
|
55
|
-
"PaymentsDomain",
|
|
56
|
-
"Price"
|
|
57
|
-
],
|
|
58
|
-
"constructors": [
|
|
59
|
-
{
|
|
60
|
-
"constructor": "Money",
|
|
61
|
-
"native": [
|
|
62
|
-
"PaymentsDomain",
|
|
63
|
-
"Price"
|
|
64
|
-
],
|
|
65
|
-
"style": "record",
|
|
66
|
-
"fields": [
|
|
67
|
-
{
|
|
68
|
-
"field": "amount",
|
|
69
|
-
"native": "major"
|
|
70
|
-
},
|
|
71
|
-
{
|
|
72
|
-
"field": "currency",
|
|
73
|
-
"native": "unit"
|
|
74
|
-
}
|
|
75
|
-
]
|
|
76
|
-
}
|
|
77
|
-
]
|
|
78
|
-
},
|
|
79
|
-
{
|
|
80
|
-
"type": "example.payments::type::Payment",
|
|
81
|
-
"native": [
|
|
82
|
-
"PaymentsDomain",
|
|
83
|
-
"PaymentStatus"
|
|
84
|
-
],
|
|
85
|
-
"constructors": [
|
|
86
|
-
{
|
|
87
|
-
"constructor": "Paid",
|
|
88
|
-
"native": [
|
|
89
|
-
"PaymentsDomain",
|
|
90
|
-
"PaymentStatus",
|
|
91
|
-
"settled"
|
|
92
|
-
],
|
|
93
|
-
"style": "variant",
|
|
94
|
-
"fields": [
|
|
95
|
-
{
|
|
96
|
-
"field": "value",
|
|
97
|
-
"native": "price"
|
|
98
|
-
}
|
|
99
|
-
]
|
|
100
|
-
},
|
|
101
|
-
{
|
|
102
|
-
"constructor": "Declined",
|
|
103
|
-
"native": [
|
|
104
|
-
"PaymentsDomain",
|
|
105
|
-
"PaymentStatus",
|
|
106
|
-
"rejected"
|
|
107
|
-
],
|
|
108
|
-
"style": "variant",
|
|
109
|
-
"fields": [
|
|
110
|
-
{
|
|
111
|
-
"field": "value",
|
|
112
|
-
"native": "explanation"
|
|
113
|
-
}
|
|
114
|
-
]
|
|
115
|
-
}
|
|
116
|
-
]
|
|
117
|
-
}
|
|
118
|
-
],
|
|
119
|
-
"functions": [
|
|
120
|
-
{
|
|
121
|
-
"declaration": "example.payments::addFee",
|
|
122
|
-
"native": [
|
|
123
|
-
"PaymentsDomain",
|
|
124
|
-
"applyFee"
|
|
125
|
-
]
|
|
126
|
-
},
|
|
127
|
-
{
|
|
128
|
-
"declaration": "example.payments::roundTrip",
|
|
129
|
-
"native": [
|
|
130
|
-
"PaymentsDomain",
|
|
131
|
-
"restore"
|
|
132
|
-
]
|
|
133
|
-
},
|
|
134
|
-
{
|
|
135
|
-
"declaration": "example.payments::archive",
|
|
136
|
-
"native": [
|
|
137
|
-
"PaymentsDomain",
|
|
138
|
-
"store"
|
|
139
|
-
]
|
|
140
|
-
}
|
|
141
|
-
],
|
|
142
|
-
"generators": [
|
|
143
|
-
{
|
|
144
|
-
"type": "example.payments::type::Money",
|
|
145
|
-
"factory": [
|
|
146
|
-
"PaymentGenerators",
|
|
147
|
-
"prices"
|
|
148
|
-
]
|
|
149
|
-
}
|
|
150
|
-
]
|
|
151
|
-
}
|
|
152
|
-
}
|
|
153
|
-
],
|
|
154
|
-
"languageProfile": "1.0-rc.2",
|
|
155
|
-
"verification": {
|
|
156
|
-
"layers": [
|
|
157
|
-
"proof",
|
|
158
|
-
"exhaustive",
|
|
159
|
-
"property",
|
|
160
|
-
"examples",
|
|
161
|
-
"runtime",
|
|
162
|
-
"model"
|
|
163
|
-
]
|
|
164
|
-
}
|
|
165
|
-
}
|
|
@@ -1,160 +0,0 @@
|
|
|
1
|
-
{
|
|
2
|
-
"version": 2,
|
|
3
|
-
"sources": [
|
|
4
|
-
"laws"
|
|
5
|
-
],
|
|
6
|
-
"machineBits": 64,
|
|
7
|
-
"targets": [
|
|
8
|
-
{
|
|
9
|
-
"language": "typescript",
|
|
10
|
-
"root": ".",
|
|
11
|
-
"nativeBindings": {
|
|
12
|
-
"types": [
|
|
13
|
-
{
|
|
14
|
-
"type": "example.payments::type::Currency",
|
|
15
|
-
"native": [
|
|
16
|
-
"payments_domain",
|
|
17
|
-
"CurrencyCode"
|
|
18
|
-
],
|
|
19
|
-
"constructors": [
|
|
20
|
-
{
|
|
21
|
-
"constructor": "USD",
|
|
22
|
-
"native": [
|
|
23
|
-
"payments_domain",
|
|
24
|
-
"Dollars"
|
|
25
|
-
],
|
|
26
|
-
"style": "unit",
|
|
27
|
-
"fields": []
|
|
28
|
-
},
|
|
29
|
-
{
|
|
30
|
-
"constructor": "EUR",
|
|
31
|
-
"native": [
|
|
32
|
-
"payments_domain",
|
|
33
|
-
"Euros"
|
|
34
|
-
],
|
|
35
|
-
"style": "unit",
|
|
36
|
-
"fields": []
|
|
37
|
-
},
|
|
38
|
-
{
|
|
39
|
-
"constructor": "GBP",
|
|
40
|
-
"native": [
|
|
41
|
-
"payments_domain",
|
|
42
|
-
"Pounds"
|
|
43
|
-
],
|
|
44
|
-
"style": "unit",
|
|
45
|
-
"fields": []
|
|
46
|
-
}
|
|
47
|
-
]
|
|
48
|
-
},
|
|
49
|
-
{
|
|
50
|
-
"type": "example.payments::type::Money",
|
|
51
|
-
"native": [
|
|
52
|
-
"payments_domain",
|
|
53
|
-
"Price"
|
|
54
|
-
],
|
|
55
|
-
"constructors": [
|
|
56
|
-
{
|
|
57
|
-
"constructor": "Money",
|
|
58
|
-
"native": [
|
|
59
|
-
"payments_domain",
|
|
60
|
-
"Price"
|
|
61
|
-
],
|
|
62
|
-
"style": "record",
|
|
63
|
-
"fields": [
|
|
64
|
-
{
|
|
65
|
-
"field": "amount",
|
|
66
|
-
"native": "major"
|
|
67
|
-
},
|
|
68
|
-
{
|
|
69
|
-
"field": "currency",
|
|
70
|
-
"native": "unit"
|
|
71
|
-
}
|
|
72
|
-
]
|
|
73
|
-
}
|
|
74
|
-
]
|
|
75
|
-
},
|
|
76
|
-
{
|
|
77
|
-
"type": "example.payments::type::Payment",
|
|
78
|
-
"native": [
|
|
79
|
-
"payments_domain",
|
|
80
|
-
"PaymentStatus"
|
|
81
|
-
],
|
|
82
|
-
"constructors": [
|
|
83
|
-
{
|
|
84
|
-
"constructor": "Paid",
|
|
85
|
-
"native": [
|
|
86
|
-
"payments_domain",
|
|
87
|
-
"Settled"
|
|
88
|
-
],
|
|
89
|
-
"style": "variant",
|
|
90
|
-
"fields": [
|
|
91
|
-
{
|
|
92
|
-
"field": "value",
|
|
93
|
-
"native": "price"
|
|
94
|
-
}
|
|
95
|
-
]
|
|
96
|
-
},
|
|
97
|
-
{
|
|
98
|
-
"constructor": "Declined",
|
|
99
|
-
"native": [
|
|
100
|
-
"payments_domain",
|
|
101
|
-
"Rejected"
|
|
102
|
-
],
|
|
103
|
-
"style": "variant",
|
|
104
|
-
"fields": [
|
|
105
|
-
{
|
|
106
|
-
"field": "value",
|
|
107
|
-
"native": "explanation"
|
|
108
|
-
}
|
|
109
|
-
]
|
|
110
|
-
}
|
|
111
|
-
]
|
|
112
|
-
}
|
|
113
|
-
],
|
|
114
|
-
"functions": [
|
|
115
|
-
{
|
|
116
|
-
"declaration": "example.payments::addFee",
|
|
117
|
-
"native": [
|
|
118
|
-
"payments_domain",
|
|
119
|
-
"apply_fee"
|
|
120
|
-
]
|
|
121
|
-
},
|
|
122
|
-
{
|
|
123
|
-
"declaration": "example.payments::roundTrip",
|
|
124
|
-
"native": [
|
|
125
|
-
"payments_domain",
|
|
126
|
-
"restore"
|
|
127
|
-
]
|
|
128
|
-
},
|
|
129
|
-
{
|
|
130
|
-
"declaration": "example.payments::archive",
|
|
131
|
-
"native": [
|
|
132
|
-
"payments_domain",
|
|
133
|
-
"store"
|
|
134
|
-
]
|
|
135
|
-
}
|
|
136
|
-
],
|
|
137
|
-
"generators": [
|
|
138
|
-
{
|
|
139
|
-
"type": "example.payments::type::Money",
|
|
140
|
-
"factory": [
|
|
141
|
-
"lawspec_generators",
|
|
142
|
-
"prices"
|
|
143
|
-
]
|
|
144
|
-
}
|
|
145
|
-
]
|
|
146
|
-
}
|
|
147
|
-
}
|
|
148
|
-
],
|
|
149
|
-
"languageProfile": "1.0-rc.2",
|
|
150
|
-
"verification": {
|
|
151
|
-
"layers": [
|
|
152
|
-
"proof",
|
|
153
|
-
"exhaustive",
|
|
154
|
-
"property",
|
|
155
|
-
"examples",
|
|
156
|
-
"runtime",
|
|
157
|
-
"model"
|
|
158
|
-
]
|
|
159
|
-
}
|
|
160
|
-
}
|
|
@@ -1,27 +0,0 @@
|
|
|
1
|
-
{
|
|
2
|
-
"version": 2,
|
|
3
|
-
"sources": [
|
|
4
|
-
"orders.lawspec"
|
|
5
|
-
],
|
|
6
|
-
"dependencies": {
|
|
7
|
-
"shop.domain": "^1.0.0",
|
|
8
|
-
"shop.tax": "^2.0.0"
|
|
9
|
-
},
|
|
10
|
-
"packages": [
|
|
11
|
-
"../shop-domain",
|
|
12
|
-
"../shop-tax-1",
|
|
13
|
-
"../shop-tax-2"
|
|
14
|
-
],
|
|
15
|
-
"targets": [],
|
|
16
|
-
"languageProfile": "1.0-rc.2",
|
|
17
|
-
"verification": {
|
|
18
|
-
"layers": [
|
|
19
|
-
"proof",
|
|
20
|
-
"exhaustive",
|
|
21
|
-
"property",
|
|
22
|
-
"examples",
|
|
23
|
-
"runtime",
|
|
24
|
-
"model"
|
|
25
|
-
]
|
|
26
|
-
}
|
|
27
|
-
}
|
package/explain.mjs
DELETED
|
@@ -1,114 +0,0 @@
|
|
|
1
|
-
// Generated from templates/npm/explain.mjs by lawspec-dev generate. Do not edit.
|
|
2
|
-
// All presentations read the same typed law and its evidence. No view parses
|
|
3
|
-
// business wording or changes an obligation.
|
|
4
|
-
import { createTypePresentation } from './typed-presentation.mjs';
|
|
5
|
-
|
|
6
|
-
export const explanationViews = ['developer', 'business', 'formal', 'evidence'];
|
|
7
|
-
const exampleName = name => name.startsWith('"|') && name.endsWith('|') ? name
|
|
8
|
-
: '"|' + name.replace(/\\/gu, '\\\\').replace(/\|/gu, '\\|') + '|';
|
|
9
|
-
const presentationProposition = ({ typeName, expressionText }, inputs) => function proposition(assertion, business = false, scope = inputs) {
|
|
10
|
-
const term = expression => expressionText(expression, scope);
|
|
11
|
-
const recurse = (body, wording = business) => proposition(body, wording, scope);
|
|
12
|
-
switch (assertion.kind) {
|
|
13
|
-
case 'equal': return `${term(assertion.left)} ${business ? 'must be' : '='} ${term(assertion.right)}`;
|
|
14
|
-
case 'implies': return business
|
|
15
|
-
? `If ${term(assertion.guard)}, then ${recurse(assertion.body, true)}`
|
|
16
|
-
: `(${term(assertion.guard)}) implies (${recurse(assertion.body)})`;
|
|
17
|
-
case 'all': return assertion.items.map(a => `(${recurse(a)})`).join(' and ');
|
|
18
|
-
case 'not': {
|
|
19
|
-
// The compiler's ordinary negation/conjunction representation also
|
|
20
|
-
// expresses disjunction and implications with proposition premises.
|
|
21
|
-
const items = assertion.body.kind === 'all' ? assertion.body.items : [];
|
|
22
|
-
if (items.length > 1 && items.every(item => item.kind === 'not'))
|
|
23
|
-
return items.map(item => `(${recurse(item.body)})`).join(' or ');
|
|
24
|
-
if (items.length === 2 && items[1].kind === 'not') return business
|
|
25
|
-
? `If (${recurse(items[0], true)}), then (${recurse(items[1].body, true)})`
|
|
26
|
-
: `(${recurse(items[0])}) implies (${recurse(items[1].body)})`;
|
|
27
|
-
return business && assertion.body.kind === 'exists'
|
|
28
|
-
? recurse(assertion.body, true).replace(/^There must exist/, 'There must not exist')
|
|
29
|
-
: `${business ? 'Must not' : 'not'} (${recurse(assertion.body, false)})`;
|
|
30
|
-
}
|
|
31
|
-
case 'forall':
|
|
32
|
-
case 'exists': {
|
|
33
|
-
const universal = assertion.kind === 'forall';
|
|
34
|
-
const binder = `${assertion.binder.name} of type ${typeName(assertion.binder.type)}`;
|
|
35
|
-
const nested = new Map([...scope, [assertion.binder.id, assertion.binder.name]]);
|
|
36
|
-
const restrictions = assertion.predicates.map(p => expressionText(p, nested));
|
|
37
|
-
const restricted = restrictions.length ? ` where ${restrictions.join(' and ')}` : '';
|
|
38
|
-
if (business) return `${universal ? 'For every' : 'There must exist'} ${binder}${restricted}, ${proposition(assertion.body, true, nested)}`;
|
|
39
|
-
return `${universal ? 'for all' : 'there exists'} (${binder}${restricted}) ${universal ? '=>' : 'such that'}\n${proposition(assertion.body, false, nested)}\nend ${universal ? 'for all' : 'exists'}`;
|
|
40
|
-
}
|
|
41
|
-
default: throw new Error(`Unsupported typed assertion ${assertion.kind}`);
|
|
42
|
-
}
|
|
43
|
-
};
|
|
44
|
-
export function explainLaw(law, result, view = 'developer') {
|
|
45
|
-
if (!explanationViews.includes(view)) throw new Error(`Choose --view ${explanationViews.join('|')}`);
|
|
46
|
-
const presentation = createTypePresentation(result);
|
|
47
|
-
const { typeName, expressionText, valueText } = presentation;
|
|
48
|
-
const examples = law.examples ?? [];
|
|
49
|
-
const scope = new Map(law.inputs.map(input => [input.id, input.name]));
|
|
50
|
-
const proposition = presentationProposition(presentation, scope);
|
|
51
|
-
const evidence = (result.evidence ?? []).filter(e => e.declaration === law.id);
|
|
52
|
-
const quantifiers = law.inputs.map(input => `${input.name} of type ${typeName(input.type)}`);
|
|
53
|
-
const restrictions = law.inputs.flatMap(input => input.predicates.map(p => expressionText(p, scope)));
|
|
54
|
-
const metadata = law.metadata ?? {};
|
|
55
|
-
const references = law.references ?? [];
|
|
56
|
-
const witnesses = law.harness?.witnesses ?? [];
|
|
57
|
-
const searches = law.harness?.searches ?? [];
|
|
58
|
-
const strategies = [
|
|
59
|
-
...witnesses.map(witness => `Configured witness (not completed evidence): definition.${witness.path.join('.')} = ${expressionText(witness.expression, scope)}`),
|
|
60
|
-
...searches.map(search => `Configured search (not completed evidence): definition.${search.path.join('.')} uses ${search.strategy}`),
|
|
61
|
-
];
|
|
62
|
-
const documentary = [metadata.id === undefined ? '' : `Requirement: ${metadata.id}`,
|
|
63
|
-
metadata.owner === undefined ? '' : `Owner: ${metadata.owner}`,
|
|
64
|
-
...references.map(reference => `Reference: ${referenceText(reference)}`)].filter(Boolean);
|
|
65
|
-
let text;
|
|
66
|
-
if (view === 'evidence') text = evidence.length
|
|
67
|
-
? evidence.map(e => `${e.status.toUpperCase()}: ${e.reason}`+(e.nativeEvidence?'\n'+nativeEvidenceText(e):'')).join('\n')
|
|
68
|
-
: 'No completed evidence has been supplied for this law.';
|
|
69
|
-
else if (view === 'business') text = [...documentary, law.description,
|
|
70
|
-
quantifiers.length ? `For every ${quantifiers.join(' and ')}` : '',
|
|
71
|
-
restrictions.length ? `When ${restrictions.join(' and ')}` : '',
|
|
72
|
-
proposition(law.assertion, true), law.rationale ? `Reason: ${law.rationale}` : ''].filter(Boolean).join('\n');
|
|
73
|
-
else if (view === 'formal') text = [quantifiers.length ? `for all (${quantifiers.join(') (')}) =>` : '',
|
|
74
|
-
restrictions.length ? `(${restrictions.join(' and ')}) implies` : '',
|
|
75
|
-
proposition(law.assertion), ...(quantifiers.length ? ['end for all'] : [])].filter(Boolean).join('\n');
|
|
76
|
-
else text = [law.id, ...documentary, ...law.trace, ...strategies,
|
|
77
|
-
...(quantifiers.length ? [`Inputs: ${quantifiers.join('; ')}`] : []),
|
|
78
|
-
...(restrictions.length ? [`Restrictions: ${restrictions.join(' and ')}`] : []), proposition(law.assertion),
|
|
79
|
-
`Source: ${law.location.file}:${law.location.line}:${law.location.column}`,
|
|
80
|
-
`Examples: ${examples.length}`,
|
|
81
|
-
...examples.flatMap(example => {
|
|
82
|
-
const locals = new Map([...scope, ...example.bindings.map(binding => [binding.id, binding.name])]);
|
|
83
|
-
return [`example ${exampleName(example.name)}:`,
|
|
84
|
-
...example.bindings.map(binding => ` ${binding.name} = ${valueText(binding.value, locals)}`),
|
|
85
|
-
...example.expectations.map(expectation => ` expect ${proposition(expectation, false, locals)}`), 'end example'];
|
|
86
|
-
})].join('\n');
|
|
87
|
-
if(view==='developer')for(const item of evidence)if(item.nativeEvidence)text+='\n'+nativeEvidenceText(item);
|
|
88
|
-
if (view === 'evidence' && strategies.length) text += '\n' + strategies.join('\n');
|
|
89
|
-
return { view, law: law.id, metadata, references, witnesses, searches, examples, inputs: law.inputs, assertion: law.assertion, evidence, text };
|
|
90
|
-
}
|
|
91
|
-
function referenceText(reference) {
|
|
92
|
-
if (typeof reference === 'string') return reference;
|
|
93
|
-
if (reference.kind === 'external') return `${reference.name ? `${reference.name}: ` : ''}${reference.resource}`;
|
|
94
|
-
const selector = reference.selector;
|
|
95
|
-
const section = selector?.kind === 'named-reference' ? ` references.${selector.name}` : selector ? ` ${selector.kind}` : '';
|
|
96
|
-
const raw = reference.target.name;
|
|
97
|
-
// Built-in laws retain legacy source names internally; present their
|
|
98
|
-
// canonical phrase spelling just as ordinary authored names are presented.
|
|
99
|
-
const name = raw.startsWith('"|') || /^\p{L}[\p{L}\p{N}_]*$/u.test(raw)
|
|
100
|
-
? raw : `"|${raw.replace(/[\\|]/g, '\\$&')}|`;
|
|
101
|
-
return `ref ${reference.kind} ${reference.target.unit}.${name}${section}`;
|
|
102
|
-
}
|
|
103
|
-
|
|
104
|
-
export function nativeEvidenceText(item){
|
|
105
|
-
if(!item.nativeEvidence)return '';
|
|
106
|
-
const summary=item.nativeEvidence;
|
|
107
|
-
return [`Native conformance: ${summary.status}; search completeness: ${summary.searchCompleteness}`,
|
|
108
|
-
...summary.observations.map(row=>`${row.target} (${row.root}): ${row.outcome}; ${row.freshness}`+
|
|
109
|
-
(row.attempt?`; seed ${row.attempt.seed}; ${row.attempt.at}`:'')+`; ${row.reason}`),
|
|
110
|
-
...summary.observations.flatMap(row=>(row.attempt?.tests??[]).filter(test=>test.status==='failed')
|
|
111
|
-
.map(test=>`${test.name}: ${test.reason??test.failure??test.message??'native test failed'}`)),
|
|
112
|
-
...summary.observations.filter(row=>row.attempt?.invocation.output)
|
|
113
|
-
.map(row=>'Native invocation output (scoped to that invocation):\n'+row.attempt.invocation.output)].join('\n');
|
|
114
|
-
}
|