tla-ts 0.0.3-dev.4c8c06c → 0.0.3-dev.4fdd845
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/README.md +16 -2
- package/dist/cli.cjs +1 -1
- package/dist/cli.js +1 -1
- package/dist/index.cjs +1 -1
- package/dist/index.d.cts +157 -8
- package/dist/index.d.ts +157 -8
- package/dist/index.js +1 -1
- package/dist/parallel-worker.cjs +1 -1
- package/dist/parallel-worker.js +2 -2
- package/dist/parallel.cjs +1 -1
- package/dist/parallel.js +2 -2
- package/dist/run-cli.cjs +1351 -19
- package/dist/run-cli.js +1351 -19
- package/dist/transfer.cjs +86 -16
- package/dist/transfer.js +86 -16
- package/package.json +5 -1
- package/src/ast.ts +142 -6
- package/src/bags.ts +4 -7
- package/src/builtins.ts +29 -11
- package/src/bundled-modules.ts +3 -3
- package/src/canonical.ts +4 -3
- package/src/check.ts +1539 -235
- package/src/cli-options.ts +11 -5
- package/src/cli.ts +8 -1
- package/src/codegen.ts +77 -37
- package/src/config.ts +252 -179
- package/src/dependencies.ts +2 -2
- package/src/environment.ts +518 -137
- package/src/errors.ts +224 -3
- package/src/evaluate.ts +796 -246
- package/src/exit-codes.ts +22 -43
- package/src/index.ts +1 -0
- package/src/instances.ts +19 -16
- package/src/java-overrides.ts +104 -25
- package/src/levels.ts +191 -45
- package/src/lexer.ts +32 -4
- package/src/live-check.ts +828 -0
- package/src/liveness.ts +218 -572
- package/src/obligation-expression.ts +2 -2
- package/src/obligation-source.ts +2 -0
- package/src/parallel-worker.ts +13 -4
- package/src/parallel.ts +73 -6
- package/src/parser.ts +447 -128
- package/src/pcal-ast.ts +770 -0
- package/src/pcal-parse.ts +1523 -0
- package/src/pcal-tokenize.ts +516 -0
- package/src/pcal-translate.ts +1230 -0
- package/src/pcal-validate.ts +454 -0
- package/src/randomization.ts +24 -7
- package/src/resolve.ts +1380 -420
- package/src/run-cli.ts +1200 -143
- package/src/runtime.ts +19 -1
- package/src/sany-builtins.ts +147 -0
- package/src/sany-generator.ts +3112 -0
- package/src/sany-levels.ts +1208 -0
- package/src/sany-lexer.ts +545 -0
- package/src/sany-linter.ts +122 -0
- package/src/sany-modules.ts +1398 -0
- package/src/sany-nodes.ts +463 -0
- package/src/sany-parse-error.ts +2161 -0
- package/src/sany-report.ts +354 -0
- package/src/sany-selectors.ts +738 -0
- package/src/sany-source.ts +248 -0
- package/src/sany-xml.ts +1017 -0
- package/src/spec-description.ts +42 -11
- package/src/standard-modules.ts +200 -148
- package/src/standard-ranges.ts +116 -0
- package/src/state-graph.ts +180 -0
- package/src/subexpressions.ts +231 -171
- package/src/substitution-levels.ts +38 -17
- package/src/successors.ts +219 -107
- package/src/symmetry.ts +180 -52
- package/src/tableau.ts +54 -25
- package/src/tlc-ext.ts +42 -29
- package/src/tlc-messages.ts +329 -0
- package/src/tlc-module.ts +52 -43
- package/src/tlc-order.ts +73 -9
- package/src/tlc-random.ts +37 -9
- package/src/tlc-replay.ts +655 -0
- package/src/tlc-summary.ts +20 -5
- package/src/tlc-version.ts +18 -0
- package/src/transfer.ts +15 -3
- package/src/value-sources.ts +29 -0
- package/src/values.ts +708 -180
package/README.md
CHANGED
|
@@ -50,6 +50,7 @@ The options are:
|
|
|
50
50
|
|
|
51
51
|
- `-config <Spec.cfg>`: read the configuration from this file. You can use it only when you check one spec.
|
|
52
52
|
- `-deadlock`: don't report deadlocks.
|
|
53
|
+
- `-dump [dot[,colorize][,actionlabels][,snapshot]] <file>`: write every reachable state to `<file>.dump`, or with `dot`, the state graph to `<file>.dot`. The output matches TLC run with `-fp 0`. tla-ts doesn't support the `constrained`, `stuttering`, or `strict` formats.
|
|
53
54
|
- `-lncheck final`: check liveness once, after the search ends.
|
|
54
55
|
- `-seed <num>`: seed `RandomElement` and the `Randomization` module. The default is 0.
|
|
55
56
|
- `-workers <count|auto>`: search with this number of worker threads. `auto` uses one thread per core. The default is 1.
|
|
@@ -115,9 +116,12 @@ const result = await check({
|
|
|
115
116
|
| `loadClass` | Returns a compiled Java class that overrides a module's operators with constants |
|
|
116
117
|
| `onPrint` | Receives the output of `Print` and `PrintT`. Defaults to `console.log` |
|
|
117
118
|
| `onPause` | Runs when `TLCSet("pause", TRUE)` pauses checking, which resumes when it returns |
|
|
118
|
-
| `readFile`, `writeFile` | Read and write files for the Json module
|
|
119
|
+
| `readFile`, `writeFile` | Read and write files for the Json module and `dump` |
|
|
119
120
|
| `seed` | A `bigint` seed. Defaults to `0n`, and matches TLC run with the same `-seed` and `-fp 0` |
|
|
120
121
|
| `workers` | The number of worker threads. Defaults to 1 |
|
|
122
|
+
| `dump` | Writes the reachable states or the state graph, as TLC's `-dump` does |
|
|
123
|
+
|
|
124
|
+
`dump` takes the `path` that `check` passes to `writeFile` before it returns. Set `dot` to write the state graph in the DOT language of Graphviz, and `colorize`, `actionLabels`, or `snapshot` for TLC's formats of the same names. A dump checks the spec on the calling thread, as one TLC worker does.
|
|
121
125
|
|
|
122
126
|
The result has these fields:
|
|
123
127
|
|
|
@@ -131,8 +135,9 @@ Workers run in Node, Bun, Deno, and cross-origin isolated pages in the browser.
|
|
|
131
135
|
- `SharedArrayBuffer` is unavailable, as on a page without cross-origin isolation.
|
|
132
136
|
- The spec has liveness properties.
|
|
133
137
|
- The spec uses impure operators such as `Print`.
|
|
138
|
+
- The configuration has `VIEW`, `POSTCONDITION`, or `_POSSIBLE`.
|
|
134
139
|
|
|
135
|
-
After a violation, `check` reruns on the calling thread to return
|
|
140
|
+
After a violation or an error, `check` reruns on the calling thread to return TLC's exact trace.
|
|
136
141
|
|
|
137
142
|
`check` supports:
|
|
138
143
|
|
|
@@ -196,6 +201,15 @@ Wall time on one worker, including JVM and Node startup. Both checkers report th
|
|
|
196
201
|
| [Bounded queue](packages/tla-ts/benchmarks/queue) | 44,044 | 0.37 s | 0.17 s | 2.2× |
|
|
197
202
|
| 542 conformance models | | 986.6 s | 403.3 s | 2.4× |
|
|
198
203
|
|
|
204
|
+
Wall time on 8 workers, also including startup. Each time is the median of 3 runs on an Apple M4 Pro.
|
|
205
|
+
|
|
206
|
+
| Spec | Distinct states | TLC | tla-ts | Speedup |
|
|
207
|
+
| --------------------------------------------------------------------------------------------------------------------- | --------------: | ------: | -----: | ------: |
|
|
208
|
+
| [Raft with reconfiguration](https://github.com/will62794/tla-web/blob/8193eb0/specs/RaftWithReconfigSingleServer.tla) | 298,493 | 10.50 s | 8.96 s | 1.2× |
|
|
209
|
+
| [Sailfish](https://github.com/tlaplus/Examples/tree/0cab2b3/specifications/dag-consensus) | 109,604 | 4.34 s | 4.07 s | 1.1× |
|
|
210
|
+
| [Fast Paxos](https://github.com/tlaplus/Examples/tree/0cab2b3/specifications/SimplifiedFastPaxos) | 25,617 | 3.91 s | 2.57 s | 1.5× |
|
|
211
|
+
| [Buffered random access file](https://github.com/tlaplus/Examples/tree/0cab2b3/specifications/braf) | 3,316 | 4.70 s | 3.61 s | 1.3× |
|
|
212
|
+
|
|
199
213
|
## Development
|
|
200
214
|
|
|
201
215
|
```shell
|
package/dist/cli.cjs
CHANGED
|
@@ -7,4 +7,4 @@
|
|
|
7
7
|
* This source code is licensed under the MIT license found in the
|
|
8
8
|
* LICENSE file in the root directory of this source tree.
|
|
9
9
|
*/
|
|
10
|
-
require("node:module").enableCompileCache?.(),Promise.resolve().then(()=>require("./run-cli.cjs")).then(e=>e.runCli());
|
|
10
|
+
let e=require("node:module"),t=require("node:path");const n=process.argv.find(e=>e.startsWith(`-Djava.io.tmpdir=`))?.slice(17);e.enableCompileCache?.(n&&(0,t.join)(n,`node-compile-cache`)),Promise.resolve().then(()=>require("./run-cli.cjs")).then(e=>e.runCli());
|
package/dist/cli.js
CHANGED
|
@@ -7,4 +7,4 @@
|
|
|
7
7
|
* This source code is licensed under the MIT license found in the
|
|
8
8
|
* LICENSE file in the root directory of this source tree.
|
|
9
9
|
*/
|
|
10
|
-
import{enableCompileCache as e}from"node:module";e?.(),import(`./run-cli.js`).then(e=>e.runCli());
|
|
10
|
+
import{enableCompileCache as e}from"node:module";import{join as t}from"node:path";const n=process.argv.find(e=>e.startsWith(`-Djava.io.tmpdir=`))?.slice(17);e?.(n&&t(n,`node-compile-cache`)),import(`./run-cli.js`).then(e=>e.runCli());
|
package/dist/index.cjs
CHANGED
|
@@ -6,4 +6,4 @@
|
|
|
6
6
|
* This source code is licensed under the MIT license found in the
|
|
7
7
|
* LICENSE file in the root directory of this source tree.
|
|
8
8
|
*/
|
|
9
|
-
Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./transfer.cjs"),t=require("./parallel.cjs");exports.TlaConfigError=e.
|
|
9
|
+
Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./transfer.cjs"),t=require("./parallel.cjs");exports.TlaConfigError=e.at,exports.TlaError=e.ot,exports.TlaEvaluationError=e.st,exports.TlaSyntaxError=e.ft,exports.TlaUnsupportedError=e.pt,exports.check=t.t,exports.formatValue=e.q,exports.parseConfig=e.Z,exports.parseModule=e.w;
|
package/dist/index.d.cts
CHANGED
|
@@ -38,25 +38,32 @@ interface StringExpression {
|
|
|
38
38
|
interface IdentifierExpression {
|
|
39
39
|
kind: "Identifier";
|
|
40
40
|
name: string;
|
|
41
|
+
selectorRanges?: SourceRange[];
|
|
41
42
|
location: SourceLocation;
|
|
42
43
|
resolution?: LocalResolution;
|
|
43
44
|
}
|
|
44
45
|
interface ApplyExpression {
|
|
45
46
|
kind: "Apply";
|
|
46
47
|
operator: string;
|
|
48
|
+
spelling?: string;
|
|
47
49
|
args: Expression[];
|
|
48
50
|
argumentCounts?: number[];
|
|
51
|
+
argumentsRange?: SourceRange;
|
|
52
|
+
selectorRanges?: SourceRange[];
|
|
53
|
+
argumentRanges?: (SourceRange | undefined)[];
|
|
49
54
|
location: SourceLocation;
|
|
50
55
|
resolution?: LocalResolution;
|
|
51
56
|
}
|
|
52
57
|
interface OperatorReferenceExpression {
|
|
53
58
|
kind: "OperatorReference";
|
|
54
59
|
operator: string;
|
|
60
|
+
spelling?: string;
|
|
55
61
|
location: SourceLocation;
|
|
56
62
|
}
|
|
57
63
|
interface LambdaExpression {
|
|
58
64
|
kind: "Lambda";
|
|
59
65
|
params: string[];
|
|
66
|
+
paramRanges?: SourceRange[];
|
|
60
67
|
body: Expression;
|
|
61
68
|
location: SourceLocation;
|
|
62
69
|
}
|
|
@@ -64,6 +71,7 @@ interface JunctionExpression {
|
|
|
64
71
|
kind: "And" | "Or";
|
|
65
72
|
operands: Expression[];
|
|
66
73
|
isBulleted?: boolean;
|
|
74
|
+
prefixEnds?: SourceLocation[];
|
|
67
75
|
location: SourceLocation;
|
|
68
76
|
}
|
|
69
77
|
interface PrimeExpression {
|
|
@@ -108,9 +116,11 @@ interface LetExpression {
|
|
|
108
116
|
type BoundPattern = {
|
|
109
117
|
kind: "Name";
|
|
110
118
|
name: string;
|
|
119
|
+
ranges?: SourceRange[];
|
|
111
120
|
} | {
|
|
112
121
|
kind: "Tuple";
|
|
113
122
|
names: string[];
|
|
123
|
+
ranges?: SourceRange[];
|
|
114
124
|
};
|
|
115
125
|
interface Bound {
|
|
116
126
|
pattern: BoundPattern;
|
|
@@ -126,6 +136,7 @@ interface UnboundedQuantifierExpression {
|
|
|
126
136
|
kind: "UnboundedQuantifier";
|
|
127
137
|
quantifier: "Forall" | "Exists";
|
|
128
138
|
names: string[];
|
|
139
|
+
nameRanges?: SourceRange[];
|
|
129
140
|
isTemporal?: boolean;
|
|
130
141
|
body: Expression;
|
|
131
142
|
location: SourceLocation;
|
|
@@ -175,6 +186,7 @@ interface FunctionSetExpression {
|
|
|
175
186
|
interface RecordField {
|
|
176
187
|
name: string;
|
|
177
188
|
value: Expression;
|
|
189
|
+
location: SourceLocation;
|
|
178
190
|
}
|
|
179
191
|
interface RecordExpression {
|
|
180
192
|
kind: "Record" | "RecordSet";
|
|
@@ -208,6 +220,11 @@ interface FunctionApplicationExpression {
|
|
|
208
220
|
args: Expression[];
|
|
209
221
|
location: SourceLocation;
|
|
210
222
|
}
|
|
223
|
+
interface BracketExpression {
|
|
224
|
+
kind: "Bracket";
|
|
225
|
+
args: Expression[];
|
|
226
|
+
location: SourceLocation;
|
|
227
|
+
}
|
|
211
228
|
interface FieldAccessExpression {
|
|
212
229
|
kind: "FieldAccess";
|
|
213
230
|
record: Expression;
|
|
@@ -241,6 +258,7 @@ interface LabelExpression {
|
|
|
241
258
|
kind: "Label";
|
|
242
259
|
name: string;
|
|
243
260
|
params: string[];
|
|
261
|
+
paramRanges?: SourceRange[];
|
|
244
262
|
body: Expression;
|
|
245
263
|
location: SourceLocation;
|
|
246
264
|
}
|
|
@@ -262,9 +280,11 @@ type Selector = {
|
|
|
262
280
|
interface SubexpressionExpression {
|
|
263
281
|
kind: "Subexpression";
|
|
264
282
|
selectors: Selector[];
|
|
283
|
+
selectorRanges?: SourceRange[];
|
|
284
|
+
argumentRanges?: (SourceRange | undefined)[];
|
|
265
285
|
location: SourceLocation;
|
|
266
286
|
}
|
|
267
|
-
type Expression = NumberExpression | DecimalExpression | StringExpression | IdentifierExpression | ApplyExpression | OperatorReferenceExpression | LambdaExpression | JunctionExpression | PrimeExpression | UnchangedExpression | EnabledExpression | IfExpression | CaseExpression | LetExpression | QuantifierExpression | UnboundedQuantifierExpression | ChooseExpression | SetEnumerationExpression | SetFilterExpression | SetMapExpression | TupleExpression | FunctionConstructionExpression | FunctionSetExpression | RecordExpression | ExceptExpression | ExceptAtExpression | FunctionApplicationExpression | FieldAccessExpression | ProductExpression | TemporalExpression | ActionExpression | FairnessExpression | LabelExpression | SubexpressionExpression;
|
|
287
|
+
type Expression = NumberExpression | DecimalExpression | StringExpression | IdentifierExpression | ApplyExpression | OperatorReferenceExpression | LambdaExpression | JunctionExpression | PrimeExpression | UnchangedExpression | EnabledExpression | IfExpression | CaseExpression | LetExpression | QuantifierExpression | UnboundedQuantifierExpression | ChooseExpression | SetEnumerationExpression | SetFilterExpression | SetMapExpression | TupleExpression | FunctionConstructionExpression | FunctionSetExpression | RecordExpression | ExceptExpression | ExceptAtExpression | FunctionApplicationExpression | BracketExpression | FieldAccessExpression | ProductExpression | TemporalExpression | ActionExpression | FairnessExpression | LabelExpression | SubexpressionExpression;
|
|
268
288
|
interface OperatorParam {
|
|
269
289
|
name: string;
|
|
270
290
|
arity: number;
|
|
@@ -287,6 +307,7 @@ interface FunctionDefinition {
|
|
|
287
307
|
body: Expression;
|
|
288
308
|
isLocal: boolean;
|
|
289
309
|
isRecursive: boolean;
|
|
310
|
+
isSelfReferential?: boolean;
|
|
290
311
|
location: SourceLocation;
|
|
291
312
|
}
|
|
292
313
|
type Definition = OperatorDefinition | FunctionDefinition;
|
|
@@ -303,6 +324,7 @@ interface Assumption {
|
|
|
303
324
|
}
|
|
304
325
|
interface InstanceSubstitution {
|
|
305
326
|
name: string;
|
|
327
|
+
nameRange: SourceRange;
|
|
306
328
|
expression: Expression;
|
|
307
329
|
}
|
|
308
330
|
interface Instance {
|
|
@@ -322,6 +344,7 @@ interface NewSymbol {
|
|
|
322
344
|
arity: number;
|
|
323
345
|
level: "Constant" | "Variable" | "State" | "Action" | "Temporal";
|
|
324
346
|
set: Expression | undefined;
|
|
347
|
+
nameRange?: SourceRange;
|
|
325
348
|
location: SourceLocation;
|
|
326
349
|
}
|
|
327
350
|
interface AssumeProve {
|
|
@@ -371,6 +394,7 @@ type StepBody = UseOrHide | Instance | DefineStep | {
|
|
|
371
394
|
} | {
|
|
372
395
|
kind: "Take";
|
|
373
396
|
names: string[];
|
|
397
|
+
nameRanges?: SourceRange[];
|
|
374
398
|
bounds: Bound[];
|
|
375
399
|
} | {
|
|
376
400
|
kind: "Witness";
|
|
@@ -378,6 +402,7 @@ type StepBody = UseOrHide | Instance | DefineStep | {
|
|
|
378
402
|
} | {
|
|
379
403
|
kind: "Pick";
|
|
380
404
|
names: string[];
|
|
405
|
+
nameRanges?: SourceRange[];
|
|
381
406
|
bounds: Bound[];
|
|
382
407
|
body: Expression;
|
|
383
408
|
} | {
|
|
@@ -395,6 +420,7 @@ interface ProofStep {
|
|
|
395
420
|
token: string;
|
|
396
421
|
body: StepBody;
|
|
397
422
|
head: SourceRange;
|
|
423
|
+
statement: SourceRange;
|
|
398
424
|
proof: Proof | undefined;
|
|
399
425
|
location: SourceLocation;
|
|
400
426
|
}
|
|
@@ -405,11 +431,9 @@ interface Theorem {
|
|
|
405
431
|
location: SourceLocation;
|
|
406
432
|
}
|
|
407
433
|
type ModuleUnit = {
|
|
408
|
-
kind: "Constants";
|
|
409
|
-
declarations: Declaration[];
|
|
410
|
-
} | {
|
|
411
|
-
kind: "Variables";
|
|
434
|
+
kind: "Constants" | "Variables";
|
|
412
435
|
declarations: Declaration[];
|
|
436
|
+
location: SourceLocation;
|
|
413
437
|
} | {
|
|
414
438
|
kind: "Recursive";
|
|
415
439
|
declarations: Declaration[];
|
|
@@ -447,6 +471,7 @@ interface Module {
|
|
|
447
471
|
uses: UseOrHide[];
|
|
448
472
|
units: ModuleUnit[];
|
|
449
473
|
}
|
|
474
|
+
type TlcVersion = "1.7.4" | "master";
|
|
450
475
|
type ConfigValue = {
|
|
451
476
|
kind: "Number";
|
|
452
477
|
value: number;
|
|
@@ -493,7 +518,13 @@ interface ModelConfig {
|
|
|
493
518
|
periodic: string | undefined;
|
|
494
519
|
rlReward: string | undefined;
|
|
495
520
|
}
|
|
496
|
-
export declare const parseConfig: (source: string) => ModelConfig;
|
|
521
|
+
export declare const parseConfig: (source: string, version?: TlcVersion) => ModelConfig;
|
|
522
|
+
interface JavaOverride {
|
|
523
|
+
module: string;
|
|
524
|
+
operator: string;
|
|
525
|
+
signature: string;
|
|
526
|
+
isMatched: boolean;
|
|
527
|
+
}
|
|
497
528
|
export declare class TlaError extends Error {
|
|
498
529
|
constructor(message: string, cause?: unknown);
|
|
499
530
|
}
|
|
@@ -503,9 +534,20 @@ interface SyntaxFailure {
|
|
|
503
534
|
column: number;
|
|
504
535
|
isEnd: boolean;
|
|
505
536
|
}
|
|
537
|
+
interface SanyError {
|
|
538
|
+
location: string;
|
|
539
|
+
message: string;
|
|
540
|
+
}
|
|
541
|
+
interface SanyReport {
|
|
542
|
+
errors: SanyError[];
|
|
543
|
+
warnings: SanyError[];
|
|
544
|
+
isFatal: boolean;
|
|
545
|
+
parseError?: string;
|
|
546
|
+
}
|
|
506
547
|
export declare class TlaSyntaxError extends TlaError {
|
|
507
548
|
failure: SyntaxFailure | undefined;
|
|
508
|
-
|
|
549
|
+
sany: SanyReport | undefined;
|
|
550
|
+
constructor(message: string, cause?: unknown, failure?: SyntaxFailure, sany?: SanyReport);
|
|
509
551
|
}
|
|
510
552
|
export declare class TlaConfigError extends TlaError {
|
|
511
553
|
constructor(message: string, cause?: unknown);
|
|
@@ -539,6 +581,7 @@ interface FunctionValue {
|
|
|
539
581
|
hash: number;
|
|
540
582
|
fingerprint: number;
|
|
541
583
|
writtenKeys: Value[] | undefined;
|
|
584
|
+
functionClass: FunctionClass | undefined;
|
|
542
585
|
}
|
|
543
586
|
interface IntervalValue {
|
|
544
587
|
kind: "Interval";
|
|
@@ -577,10 +620,15 @@ interface SetOperationValue {
|
|
|
577
620
|
left: Value;
|
|
578
621
|
right: Value;
|
|
579
622
|
}
|
|
623
|
+
interface FilteredSetSource {
|
|
624
|
+
names: string;
|
|
625
|
+
predicate: string;
|
|
626
|
+
}
|
|
580
627
|
interface FilteredSetValue {
|
|
581
628
|
kind: "FilteredSet";
|
|
582
629
|
base: Value;
|
|
583
630
|
test: (element: Value) => boolean;
|
|
631
|
+
source?: FilteredSetSource;
|
|
584
632
|
}
|
|
585
633
|
interface UnionValue {
|
|
586
634
|
kind: "Union";
|
|
@@ -599,9 +647,22 @@ interface LazyFunctionValue {
|
|
|
599
647
|
domain: Value;
|
|
600
648
|
apply: (argument: Value) => Value;
|
|
601
649
|
source?: LazyFunctionSource;
|
|
650
|
+
functionClass?: FunctionClass;
|
|
602
651
|
}
|
|
603
652
|
type Value = boolean | number | string | ModelValue | SetValue | MixedSetValue | FunctionValue | IntervalValue | InfiniteSetValue | SubsetValue | FunctionSetValue | RecordSetValue | ProductSetValue | SequenceSetValue | SetOperationValue | FilteredSetValue | UnionValue | LazyFunctionValue;
|
|
653
|
+
type FunctionClass = "lambda" | "tuple" | "record";
|
|
604
654
|
export declare const formatValue: (value: Value, isStrict?: boolean, isNormalized?: boolean) => string;
|
|
655
|
+
interface FingerprintFailure {
|
|
656
|
+
sources: Expression[];
|
|
657
|
+
reason: string;
|
|
658
|
+
}
|
|
659
|
+
interface StateDump {
|
|
660
|
+
path: string;
|
|
661
|
+
dot?: boolean;
|
|
662
|
+
colorize?: boolean;
|
|
663
|
+
actionLabels?: boolean;
|
|
664
|
+
snapshot?: boolean;
|
|
665
|
+
}
|
|
605
666
|
interface CheckOptions {
|
|
606
667
|
source: string;
|
|
607
668
|
config: string | ModelConfig;
|
|
@@ -614,32 +675,111 @@ interface CheckOptions {
|
|
|
614
675
|
seed?: bigint;
|
|
615
676
|
workers?: number;
|
|
616
677
|
livenessCheck?: "default" | "final";
|
|
678
|
+
dump?: StateDump;
|
|
679
|
+
isTool?: boolean;
|
|
680
|
+
isTraceRecorded?: boolean;
|
|
681
|
+
isSanyReported?: boolean;
|
|
682
|
+
isWarningEnabled?: boolean;
|
|
683
|
+
version?: TlcVersion;
|
|
684
|
+
onProgress?: (progress: CheckProgress) => void;
|
|
685
|
+
}
|
|
686
|
+
interface InitialStatesProgress {
|
|
687
|
+
kind: "initial-states-progress";
|
|
688
|
+
count: number;
|
|
689
|
+
}
|
|
690
|
+
interface InitialStateViolation {
|
|
691
|
+
kind: "initial-state-violation";
|
|
692
|
+
status: "invariant-violation" | "liveness-violation";
|
|
693
|
+
name: string;
|
|
694
|
+
state: Record<string, Value>;
|
|
617
695
|
}
|
|
696
|
+
type OutputLine = string | InitialStatesProgress | InitialStateViolation;
|
|
697
|
+
type CheckProgress = {
|
|
698
|
+
kind: "parsed";
|
|
699
|
+
} | {
|
|
700
|
+
kind: "constant-level-invariant";
|
|
701
|
+
name: string;
|
|
702
|
+
} | {
|
|
703
|
+
kind: "state-level-property";
|
|
704
|
+
name: string;
|
|
705
|
+
} | {
|
|
706
|
+
kind: "liveness-initializing";
|
|
707
|
+
isSymmetric: boolean;
|
|
708
|
+
isConstrained: boolean;
|
|
709
|
+
} | {
|
|
710
|
+
kind: "liveness-prepared";
|
|
711
|
+
branches: number;
|
|
712
|
+
} | {
|
|
713
|
+
kind: "initial-states-started";
|
|
714
|
+
} | InitialStatesProgress | {
|
|
715
|
+
kind: "initial-states-computed";
|
|
716
|
+
initialStates: InitialStates;
|
|
717
|
+
} | {
|
|
718
|
+
kind: "progress";
|
|
719
|
+
statistics: SearchStatistics;
|
|
720
|
+
} | {
|
|
721
|
+
kind: "liveness-started";
|
|
722
|
+
branches: number;
|
|
723
|
+
isComplete: boolean;
|
|
724
|
+
states: number;
|
|
725
|
+
statistics: SearchStatistics;
|
|
726
|
+
} | {
|
|
727
|
+
kind: "liveness-finished";
|
|
728
|
+
} | {
|
|
729
|
+
kind: "warning";
|
|
730
|
+
code: number;
|
|
731
|
+
text: string;
|
|
732
|
+
} | ({
|
|
733
|
+
kind: "java-override";
|
|
734
|
+
} & JavaOverride);
|
|
735
|
+
interface SearchStatistics extends Pick<CheckResult, "generatedStates" | "distinctStates" | "queuedStates" | "depth"> {}
|
|
618
736
|
type CheckStatus = "success" | "assumption-violation" | "invariant-violation" | "property-violation" | "liveness-violation" | "postcondition-violation" | "deadlock" | "error";
|
|
619
737
|
interface TraceStep {
|
|
620
738
|
action: string | undefined;
|
|
621
739
|
label: string | undefined;
|
|
622
740
|
state: Record<string, Value>;
|
|
741
|
+
output?: OutputLine[];
|
|
623
742
|
}
|
|
624
743
|
interface Violation {
|
|
625
744
|
name: string;
|
|
745
|
+
properties?: string[];
|
|
626
746
|
trace: TraceStep[];
|
|
747
|
+
traceOutput?: OutputLine[];
|
|
627
748
|
loopStart: number | undefined;
|
|
628
749
|
loopLabel?: string;
|
|
629
750
|
message?: string;
|
|
630
751
|
counts?: string;
|
|
631
752
|
unwitnessed?: Postcondition;
|
|
753
|
+
postcondition?: Postcondition;
|
|
754
|
+
warning?: {
|
|
755
|
+
code: number;
|
|
756
|
+
text: string;
|
|
757
|
+
};
|
|
632
758
|
}
|
|
633
759
|
interface Postcondition {
|
|
634
760
|
name: string;
|
|
761
|
+
code: number;
|
|
635
762
|
message: string;
|
|
636
763
|
counts?: string;
|
|
637
764
|
}
|
|
638
765
|
interface EvaluationFailure {
|
|
766
|
+
code: number;
|
|
639
767
|
message: string;
|
|
768
|
+
toolMessage: string;
|
|
640
769
|
trace: TraceStep[];
|
|
770
|
+
traceOutput?: OutputLine[];
|
|
641
771
|
initialState: Record<string, Value> | undefined;
|
|
642
772
|
exitCode: number;
|
|
773
|
+
callStack: Expression[] | undefined;
|
|
774
|
+
isCallStackFirst?: boolean;
|
|
775
|
+
fingerprint?: FingerprintFailure;
|
|
776
|
+
traceFailure?: FailureMessage;
|
|
777
|
+
postcondition?: Postcondition;
|
|
778
|
+
isWithoutStatistics?: boolean;
|
|
779
|
+
}
|
|
780
|
+
interface InitialStates {
|
|
781
|
+
generated: number;
|
|
782
|
+
distinct: number;
|
|
643
783
|
}
|
|
644
784
|
interface CheckResult {
|
|
645
785
|
status: CheckStatus;
|
|
@@ -649,9 +789,18 @@ interface CheckResult {
|
|
|
649
789
|
distinctStates: number;
|
|
650
790
|
queuedStates: number;
|
|
651
791
|
depth: number;
|
|
792
|
+
initialStates: InitialStates | undefined;
|
|
652
793
|
outDegrees: number[] | undefined;
|
|
653
794
|
fingerprintDistance: bigint | undefined;
|
|
795
|
+
additionalViolation?: Violation;
|
|
796
|
+
liveCallStack?: Expression[];
|
|
797
|
+
violationOutDegrees?: number[];
|
|
798
|
+
}
|
|
799
|
+
interface FailureMessage {
|
|
800
|
+
code: number;
|
|
801
|
+
message: string;
|
|
802
|
+
toolMessage: string;
|
|
654
803
|
}
|
|
655
804
|
export declare const check: (options: CheckOptions) => Promise<CheckResult>;
|
|
656
805
|
export declare const parseModule: (source: string) => Module;
|
|
657
|
-
export type { CheckOptions, CheckResult, CheckStatus, ConfigValue, ConstantAssignment, EvaluationFailure, ModelConfig, Module, Substitution, TraceStep, Value, Violation };
|
|
806
|
+
export type { CheckOptions, CheckProgress, CheckResult, CheckStatus, ConfigValue, ConstantAssignment, EvaluationFailure, ModelConfig, Module, Substitution, TraceStep, Value, Violation };
|