tla-ts 0.0.1 → 0.0.3-dev.19c763f

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 (74) hide show
  1. package/README.md +98 -39
  2. package/dist/index.cjs +1 -1
  3. package/dist/index.d.cts +225 -30
  4. package/dist/index.d.ts +225 -30
  5. package/dist/index.js +1 -1
  6. package/dist/parallel-worker.cjs +2 -2
  7. package/dist/parallel-worker.js +2 -2
  8. package/dist/parallel.cjs +1 -1
  9. package/dist/parallel.js +2 -2
  10. package/dist/run-cli.cjs +21 -1
  11. package/dist/run-cli.js +21 -1
  12. package/dist/transfer.cjs +400 -39
  13. package/dist/transfer.js +400 -39
  14. package/package.json +6 -2
  15. package/src/ast.ts +213 -6
  16. package/src/bags.ts +161 -71
  17. package/src/builtins.ts +203 -23
  18. package/src/bundled-modules.ts +63 -32
  19. package/src/check.ts +1086 -244
  20. package/src/cli-options.ts +64 -0
  21. package/src/codegen.ts +58 -34
  22. package/src/config.ts +39 -11
  23. package/src/dependencies.ts +2 -2
  24. package/src/environment.ts +557 -153
  25. package/src/errors.ts +66 -1
  26. package/src/evaluate.ts +547 -255
  27. package/src/exit-codes.ts +53 -0
  28. package/src/fingerprints.ts +48 -13
  29. package/src/index.ts +9 -4
  30. package/src/instances.ts +235 -79
  31. package/src/java-overrides.ts +241 -0
  32. package/src/json.ts +153 -72
  33. package/src/levels.ts +850 -0
  34. package/src/lexer.ts +108 -29
  35. package/src/live-check.ts +710 -0
  36. package/src/liveness.ts +37 -599
  37. package/src/obligation-action.ts +384 -0
  38. package/src/obligation-anon.ts +575 -0
  39. package/src/obligation-deref.ts +637 -0
  40. package/src/obligation-expression.ts +1060 -0
  41. package/src/obligation-format.ts +406 -0
  42. package/src/obligation-generate.ts +1074 -0
  43. package/src/obligation-levels.ts +329 -0
  44. package/src/obligation-module.ts +1042 -0
  45. package/src/obligation-printer.ts +889 -0
  46. package/src/obligation-proof.ts +76 -0
  47. package/src/obligation-source.ts +1084 -0
  48. package/src/obligation-tuples.ts +184 -0
  49. package/src/obligations.ts +316 -0
  50. package/src/parallel-worker.ts +186 -201
  51. package/src/parallel.ts +179 -84
  52. package/src/parser.ts +970 -206
  53. package/src/pretty-print.ts +259 -0
  54. package/src/randomization.ts +24 -113
  55. package/src/resolve.ts +483 -51
  56. package/src/run-cli.ts +473 -62
  57. package/src/runtime.ts +65 -28
  58. package/src/spec-description.ts +521 -0
  59. package/src/standard-levels.ts +105 -0
  60. package/src/standard-modules.ts +223 -92
  61. package/src/state-graph.ts +157 -0
  62. package/src/subexpressions.ts +31 -45
  63. package/src/substitution-levels.ts +184 -0
  64. package/src/successors.ts +276 -53
  65. package/src/symmetry.ts +79 -23
  66. package/src/tableau.ts +43 -37
  67. package/src/tlc-ext.ts +148 -44
  68. package/src/tlc-module.ts +71 -66
  69. package/src/tlc-modules.ts +1022 -0
  70. package/src/tlc-order.ts +511 -0
  71. package/src/tlc-random.ts +411 -0
  72. package/src/tlc-summary.ts +109 -0
  73. package/src/transfer.ts +26 -5
  74. package/src/values.ts +1245 -176
package/src/errors.ts CHANGED
@@ -1,3 +1,10 @@
1
+ import { EXIT_STATUS, getExitCode } from "./exit-codes";
2
+
3
+ // How TLC reports a RuntimeException it did not expect, such as one raised while computing next
4
+ // states.
5
+ export const UNEXPECTED_EXCEPTION =
6
+ "TLC threw an unexpected exception.\nThis was probably caused by an error in the spec or model.\nSee the User Output or TLC Console for clues to what happened.\nThe exception was a java.lang.RuntimeException\n: ";
7
+
1
8
  export class TlaError extends Error {
2
9
  constructor(message: string, cause?: unknown) {
3
10
  super(message, { cause });
@@ -5,10 +12,20 @@ export class TlaError extends Error {
5
12
  }
6
13
  }
7
14
 
15
+ export interface SyntaxFailure {
16
+ reason: string;
17
+ line: number;
18
+ column: number;
19
+ isEnd: boolean;
20
+ }
21
+
8
22
  export class TlaSyntaxError extends TlaError {
9
- constructor(message: string, cause?: unknown) {
23
+ failure: SyntaxFailure | undefined;
24
+
25
+ constructor(message: string, cause?: unknown, failure?: SyntaxFailure) {
10
26
  super(message, cause);
11
27
  this.name = "TlaSyntaxError";
28
+ this.failure = failure;
12
29
  }
13
30
  }
14
31
 
@@ -26,9 +43,57 @@ export class TlaEvaluationError extends TlaError {
26
43
  }
27
44
  }
28
45
 
46
+ // An evaluation error that TLC raises as an EvalException from a standard module's Java code. It
47
+ // keeps the name TlaEvaluationError, and index.ts doesn't export it.
48
+ export class TlaModuleError extends TlaEvaluationError {
49
+ exitCode: number;
50
+
51
+ constructor(message: string, exitCode: number = EXIT_STATUS.error) {
52
+ super(message);
53
+ this.name = "TlaEvaluationError";
54
+ this.exitCode = exitCode;
55
+ }
56
+ }
57
+
58
+ export interface TlapmReport {
59
+ failure?: string;
60
+ exception?: string;
61
+ }
62
+
63
+ export class TlaProofError extends TlaError {
64
+ failure: string | undefined;
65
+ exception: string;
66
+
67
+ constructor(message: string, report: TlapmReport = {}) {
68
+ super(message);
69
+ this.name = "TlaProofError";
70
+ this.failure = report.exception === undefined ? (report.failure ?? message) : undefined;
71
+ this.exception = report.exception ?? `Failure(${JSON.stringify(this.failure)})`;
72
+ }
73
+ }
74
+
75
+ // tlapm fails one of its own assertions, which it reports as a bug in itself. It keeps the name
76
+ // TlaProofError, and index.ts doesn't export it.
77
+ export class TlapmBugError extends TlaProofError {
78
+ constructor(exception = "Assert_failure") {
79
+ super("Oops, this seems to be a bug in TLAPM.", { exception });
80
+ this.name = "TlaProofError";
81
+ }
82
+ }
83
+
29
84
  export class TlaUnsupportedError extends TlaError {
30
85
  constructor(message: string, cause?: unknown) {
31
86
  super(message, cause);
32
87
  this.name = "TlaUnsupportedError";
33
88
  }
34
89
  }
90
+
91
+ export const getErrorExitCode = (error: TlaError) =>
92
+ getExitCode(error) ??
93
+ (error instanceof TlaSyntaxError
94
+ ? EXIT_STATUS.specParseError
95
+ : error instanceof TlaConfigError
96
+ ? EXIT_STATUS.configParseError
97
+ : error instanceof TlaEvaluationError
98
+ ? EXIT_STATUS.specEvaluationFailure
99
+ : EXIT_STATUS.error);