tla-ts 0.0.1 → 0.0.3-dev.2032e26

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 (71) hide show
  1. package/README.md +95 -40
  2. package/dist/index.cjs +1 -1
  3. package/dist/index.d.cts +216 -30
  4. package/dist/index.d.ts +216 -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 +20 -1
  11. package/dist/run-cli.js +20 -1
  12. package/dist/transfer.cjs +392 -39
  13. package/dist/transfer.js +392 -39
  14. package/package.json +6 -2
  15. package/src/ast.ts +122 -5
  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 +950 -238
  20. package/src/cli-options.ts +58 -0
  21. package/src/codegen.ts +52 -18
  22. package/src/config.ts +39 -11
  23. package/src/environment.ts +485 -140
  24. package/src/errors.ts +64 -1
  25. package/src/evaluate.ts +492 -138
  26. package/src/exit-codes.ts +75 -0
  27. package/src/fingerprints.ts +48 -13
  28. package/src/index.ts +9 -4
  29. package/src/instances.ts +221 -66
  30. package/src/java-overrides.ts +241 -0
  31. package/src/json.ts +153 -72
  32. package/src/levels.ts +850 -0
  33. package/src/lexer.ts +108 -29
  34. package/src/liveness.ts +47 -91
  35. package/src/obligation-action.ts +384 -0
  36. package/src/obligation-anon.ts +575 -0
  37. package/src/obligation-deref.ts +637 -0
  38. package/src/obligation-expression.ts +1060 -0
  39. package/src/obligation-format.ts +406 -0
  40. package/src/obligation-generate.ts +1074 -0
  41. package/src/obligation-levels.ts +329 -0
  42. package/src/obligation-module.ts +1042 -0
  43. package/src/obligation-printer.ts +889 -0
  44. package/src/obligation-proof.ts +76 -0
  45. package/src/obligation-source.ts +1084 -0
  46. package/src/obligation-tuples.ts +184 -0
  47. package/src/obligations.ts +316 -0
  48. package/src/parallel-worker.ts +186 -201
  49. package/src/parallel.ts +176 -84
  50. package/src/parser.ts +970 -206
  51. package/src/pretty-print.ts +259 -0
  52. package/src/randomization.ts +24 -113
  53. package/src/resolve.ts +472 -41
  54. package/src/run-cli.ts +427 -61
  55. package/src/runtime.ts +63 -28
  56. package/src/spec-description.ts +509 -0
  57. package/src/standard-levels.ts +105 -0
  58. package/src/standard-modules.ts +223 -92
  59. package/src/subexpressions.ts +21 -35
  60. package/src/substitution-levels.ts +184 -0
  61. package/src/successors.ts +266 -48
  62. package/src/symmetry.ts +79 -23
  63. package/src/tableau.ts +43 -37
  64. package/src/tlc-ext.ts +120 -33
  65. package/src/tlc-module.ts +71 -47
  66. package/src/tlc-modules.ts +1022 -0
  67. package/src/tlc-order.ts +511 -0
  68. package/src/tlc-random.ts +411 -0
  69. package/src/tlc-summary.ts +109 -0
  70. package/src/transfer.ts +26 -5
  71. package/src/values.ts +1234 -176
package/src/errors.ts CHANGED
@@ -1,3 +1,10 @@
1
+ import { EXIT_STATUS, getExitCode, setModuleExitCode } 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,55 @@ 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
+ constructor(message: string, exitCode: number = EXIT_STATUS.error) {
50
+ super(message);
51
+ this.name = "TlaEvaluationError";
52
+ setModuleExitCode(this, exitCode);
53
+ }
54
+ }
55
+
56
+ export interface TlapmReport {
57
+ failure?: string;
58
+ exception?: string;
59
+ }
60
+
61
+ export class TlaProofError extends TlaError {
62
+ failure: string | undefined;
63
+ exception: string;
64
+
65
+ constructor(message: string, report: TlapmReport = {}) {
66
+ super(message);
67
+ this.name = "TlaProofError";
68
+ this.failure = report.exception === undefined ? (report.failure ?? message) : undefined;
69
+ this.exception = report.exception ?? `Failure(${JSON.stringify(this.failure)})`;
70
+ }
71
+ }
72
+
73
+ // tlapm fails one of its own assertions, which it reports as a bug in itself. It keeps the name
74
+ // TlaProofError, and index.ts doesn't export it.
75
+ export class TlapmBugError extends TlaProofError {
76
+ constructor(exception = "Assert_failure") {
77
+ super("Oops, this seems to be a bug in TLAPM.", { exception });
78
+ this.name = "TlaProofError";
79
+ }
80
+ }
81
+
29
82
  export class TlaUnsupportedError extends TlaError {
30
83
  constructor(message: string, cause?: unknown) {
31
84
  super(message, cause);
32
85
  this.name = "TlaUnsupportedError";
33
86
  }
34
87
  }
88
+
89
+ export const getErrorExitCode = (error: TlaError) =>
90
+ getExitCode(error) ??
91
+ (error instanceof TlaSyntaxError
92
+ ? EXIT_STATUS.specParseError
93
+ : error instanceof TlaConfigError
94
+ ? EXIT_STATUS.configParseError
95
+ : error instanceof TlaEvaluationError
96
+ ? EXIT_STATUS.specEvaluationFailure
97
+ : EXIT_STATUS.error);