tla-ts 0.0.9 → 0.0.10-dev.63a6693bd

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 (400) hide show
  1. package/README.md +29 -1
  2. package/dist/compile.cjs +23 -0
  3. package/dist/compile.js +23 -0
  4. package/dist/deciders.cjs +29 -29
  5. package/dist/deciders.js +42 -42
  6. package/dist/index.cjs +1 -1
  7. package/dist/index.d.cts +106 -10
  8. package/dist/index.d.ts +106 -10
  9. package/dist/index.js +1 -1
  10. package/dist/parallel-worker.cjs +1 -1
  11. package/dist/parallel-worker.js +1 -1
  12. package/dist/prove-worker.cjs +1 -1
  13. package/dist/prove-worker.js +1 -1
  14. package/dist/prove.cjs +117 -37
  15. package/dist/prove.js +116 -36
  16. package/dist/run.cjs +143 -31
  17. package/dist/run.js +143 -31
  18. package/dist/tlapm.cjs +2 -2
  19. package/dist/tlapm.js +2 -2
  20. package/dist/transfer.cjs +129 -104
  21. package/dist/transfer.js +129 -104
  22. package/dist/worker.cjs +7 -7
  23. package/dist/worker.js +7 -7
  24. package/package.json +3 -1
  25. package/src/ast.ts +48 -62
  26. package/src/bags.ts +99 -102
  27. package/src/builtins.ts +28 -75
  28. package/src/bundled-modules.ts +1 -8
  29. package/src/check-failure.ts +116 -0
  30. package/src/check-trace.ts +282 -0
  31. package/src/check.ts +599 -754
  32. package/src/cli/options.ts +12 -32
  33. package/src/cli/run.ts +0 -2
  34. package/src/cli/runtime-invariants.ts +136 -0
  35. package/src/cli/shared.ts +19 -12
  36. package/src/cli/tlapm.ts +14 -25
  37. package/src/cli/tlc-arguments.ts +652 -0
  38. package/src/cli/tlc-output.ts +687 -0
  39. package/src/cli/tlc-usage.ts +361 -0
  40. package/src/cli/tlc.ts +309 -658
  41. package/src/cli/typescript.ts +23 -0
  42. package/src/cli/xml-exporter.ts +27 -49
  43. package/src/cli.ts +0 -1
  44. package/src/codegen.ts +196 -74
  45. package/src/config.ts +140 -109
  46. package/src/coverage.ts +830 -0
  47. package/src/dependencies.ts +14 -53
  48. package/src/dfid.ts +618 -0
  49. package/src/environment-config.ts +315 -0
  50. package/src/environment.ts +169 -335
  51. package/src/errors.ts +71 -55
  52. package/src/evaluate.ts +598 -340
  53. package/src/exit-codes.ts +37 -3
  54. package/src/fingerprints.ts +75 -11
  55. package/src/index.ts +3 -0
  56. package/src/instances.ts +126 -21
  57. package/src/java-hash.ts +7 -0
  58. package/src/java-overrides.ts +4 -19
  59. package/src/json-reader.ts +455 -0
  60. package/src/json.ts +252 -139
  61. package/src/levels.ts +46 -58
  62. package/src/lexer.ts +80 -100
  63. package/src/liveness-checker.ts +103 -153
  64. package/src/liveness.ts +150 -109
  65. package/src/obligations/action.ts +8 -39
  66. package/src/obligations/anonymize.ts +88 -82
  67. package/src/obligations/equality.ts +1 -1
  68. package/src/obligations/expression.ts +20 -21
  69. package/src/obligations/format.ts +1 -9
  70. package/src/obligations/generate.ts +46 -49
  71. package/src/obligations/index.ts +2 -13
  72. package/src/obligations/levels.ts +4 -8
  73. package/src/obligations/module.ts +28 -53
  74. package/src/obligations/normalize.ts +7 -25
  75. package/src/obligations/operators.ts +1 -2
  76. package/src/obligations/pragma.ts +1 -10
  77. package/src/obligations/printer.ts +47 -46
  78. package/src/obligations/proof.ts +1 -5
  79. package/src/obligations/regroup.ts +1 -4
  80. package/src/obligations/simplify.ts +42 -58
  81. package/src/obligations/source.ts +48 -78
  82. package/src/obligations/subexpression.ts +5 -11
  83. package/src/obligations/substitution.ts +1 -3
  84. package/src/obligations/temporal.ts +13 -19
  85. package/src/obligations/tuples.ts +3 -9
  86. package/src/parallel-worker.ts +30 -60
  87. package/src/parallel.ts +57 -71
  88. package/src/parser.ts +584 -316
  89. package/src/pcal/ast.ts +53 -86
  90. package/src/pcal/parse.ts +144 -219
  91. package/src/pcal/tokenize.ts +91 -131
  92. package/src/pcal/translate.ts +83 -130
  93. package/src/pcal/validate.ts +48 -68
  94. package/src/pretty-print.ts +7 -8
  95. package/src/prover/decide-pool.ts +8 -13
  96. package/src/prover/deciders.ts +3 -7
  97. package/src/prover/first-order.ts +0 -11
  98. package/src/prover/isabelle/decide.ts +0 -6
  99. package/src/prover/isabelle/encode.ts +11 -23
  100. package/src/prover/isabelle/isar/inner-syntax.ts +114 -115
  101. package/src/prover/isabelle/isar/method.ts +29 -53
  102. package/src/prover/isabelle/isar/proof.ts +1 -10
  103. package/src/prover/isabelle/isar/statement.ts +1 -6
  104. package/src/prover/isabelle/isar/theory.ts +26 -36
  105. package/src/prover/isabelle/isar/type-check.ts +17 -31
  106. package/src/prover/isabelle/provers/blast/blast.ts +17 -104
  107. package/src/prover/isabelle/provers/blast/branch.ts +1 -32
  108. package/src/prover/isabelle/provers/blast/prove.ts +1 -35
  109. package/src/prover/isabelle/provers/blast/rules.ts +6 -44
  110. package/src/prover/isabelle/provers/blast/state.ts +2 -28
  111. package/src/prover/isabelle/provers/blast/term.ts +9 -36
  112. package/src/prover/isabelle/provers/clasimp.ts +1 -13
  113. package/src/prover/isabelle/provers/classical.ts +14 -42
  114. package/src/prover/isabelle/provers/hypsubst.ts +28 -51
  115. package/src/prover/isabelle/pure/bicompose.ts +25 -38
  116. package/src/prover/isabelle/pure/consts.ts +1 -7
  117. package/src/prover/isabelle/pure/conv.ts +3 -17
  118. package/src/prover/isabelle/pure/drule.ts +33 -42
  119. package/src/prover/isabelle/pure/envir.ts +3 -52
  120. package/src/prover/isabelle/pure/goal.ts +1 -7
  121. package/src/prover/isabelle/pure/interrupt.ts +0 -5
  122. package/src/prover/isabelle/pure/list.ts +0 -3
  123. package/src/prover/isabelle/pure/logic.ts +2 -15
  124. package/src/prover/isabelle/pure/name.ts +2 -9
  125. package/src/prover/isabelle/pure/net.ts +3 -59
  126. package/src/prover/isabelle/pure/object-logic.ts +3 -10
  127. package/src/prover/isabelle/pure/pattern.ts +2 -19
  128. package/src/prover/isabelle/pure/raw-simplifier.ts +17 -62
  129. package/src/prover/isabelle/pure/rewriter.ts +31 -67
  130. package/src/prover/isabelle/pure/search.ts +3 -10
  131. package/src/prover/isabelle/pure/seq.ts +1 -10
  132. package/src/prover/isabelle/pure/simplifier.ts +4 -12
  133. package/src/prover/isabelle/pure/table.ts +3 -32
  134. package/src/prover/isabelle/pure/tactic.ts +12 -22
  135. package/src/prover/isabelle/pure/tactical.ts +48 -47
  136. package/src/prover/isabelle/pure/term-ord.ts +2 -6
  137. package/src/prover/isabelle/pure/term.ts +2 -43
  138. package/src/prover/isabelle/pure/thm.ts +27 -47
  139. package/src/prover/isabelle/pure/type.ts +2 -15
  140. package/src/prover/isabelle/pure/unify.ts +20 -30
  141. package/src/prover/isabelle/pure/variable.ts +3 -7
  142. package/src/prover/isabelle/tla/classical-setup.ts +17 -24
  143. package/src/prover/isabelle/tla/context.ts +15 -18
  144. package/src/prover/isabelle/tla/logic.ts +14 -32
  145. package/src/prover/isabelle/tla/simpdata.ts +46 -43
  146. package/src/prover/isabelle/tools/intuitionistic.ts +1 -10
  147. package/src/prover/ocaml.ts +0 -6
  148. package/src/prover/prep/action.ts +14 -54
  149. package/src/prover/prep/enabled-axioms.ts +12 -19
  150. package/src/prover/prep/fingerprint.ts +2 -21
  151. package/src/prover/prep/level-comparison.ts +8 -12
  152. package/src/prover/prep/md5.ts +0 -2
  153. package/src/prover/prep/methods.ts +33 -39
  154. package/src/prover/prep/normalize.ts +4 -28
  155. package/src/prover/prove-worker.ts +0 -2
  156. package/src/prover/prove.ts +87 -100
  157. package/src/prover/ptl/decide.ts +7 -12
  158. package/src/prover/ptl/encode.ts +14 -36
  159. package/src/prover/ptl/sat.ts +24 -32
  160. package/src/prover/ptl/tableau.ts +12 -26
  161. package/src/prover/smt/axioms.ts +0 -7
  162. package/src/prover/smt/context.ts +20 -28
  163. package/src/prover/smt/data.ts +433 -424
  164. package/src/prover/smt/encode.ts +43 -52
  165. package/src/prover/smt/extensionality.ts +0 -10
  166. package/src/prover/smt/flatten.ts +3 -22
  167. package/src/prover/smt/format.ts +5 -10
  168. package/src/prover/smt/instances.ts +0 -10
  169. package/src/prover/smt/rewrite.ts +663 -667
  170. package/src/prover/smt/solver/act-cache.ts +0 -15
  171. package/src/prover/smt/solver/arith-rewriter.ts +3 -48
  172. package/src/prover/smt/solver/array.ts +1 -3
  173. package/src/prover/smt/solver/asserted-formulas.ts +1 -43
  174. package/src/prover/smt/solver/ast-lt.ts +1 -11
  175. package/src/prover/smt/solver/ast-util.ts +1 -6
  176. package/src/prover/smt/solver/ast.ts +1 -165
  177. package/src/prover/smt/solver/auf-solver.ts +8 -44
  178. package/src/prover/smt/solver/case-split-queue.ts +1 -9
  179. package/src/prover/smt/solver/cg-table.ts +1 -18
  180. package/src/prover/smt/solver/clause.ts +1 -27
  181. package/src/prover/smt/solver/conflict-resolution.ts +0 -9
  182. package/src/prover/smt/solver/context.ts +7 -64
  183. package/src/prover/smt/solver/ctx-simplify.ts +14 -41
  184. package/src/prover/smt/solver/der.ts +2 -21
  185. package/src/prover/smt/solver/dyn-ack.ts +1 -11
  186. package/src/prover/smt/solver/e-matching.ts +4 -35
  187. package/src/prover/smt/solver/enode.ts +1 -21
  188. package/src/prover/smt/solver/expr-ref.ts +1 -5
  189. package/src/prover/smt/solver/expr-safe-replace.ts +1 -6
  190. package/src/prover/smt/solver/fingerprints.ts +1 -12
  191. package/src/prover/smt/solver/flat-literals.ts +1 -9
  192. package/src/prover/smt/solver/goal.ts +2 -14
  193. package/src/prover/smt/solver/hash.ts +0 -8
  194. package/src/prover/smt/solver/hashtable.ts +1 -12
  195. package/src/prover/smt/solver/internalizer.ts +7 -100
  196. package/src/prover/smt/solver/lbool.ts +1 -2
  197. package/src/prover/smt/solver/literal.ts +0 -3
  198. package/src/prover/smt/solver/lp/bound-propagator.ts +8 -26
  199. package/src/prover/smt/solver/lp/constraints.ts +2 -8
  200. package/src/prover/smt/solver/lp/containers.ts +12 -30
  201. package/src/prover/smt/solver/lp/core-solver.ts +10 -31
  202. package/src/prover/smt/solver/lp/cross-nested.ts +6 -20
  203. package/src/prover/smt/solver/lp/dep-intervals.ts +7 -22
  204. package/src/prover/smt/solver/lp/dependency.ts +1 -4
  205. package/src/prover/smt/solver/lp/dioph-eq.ts +9 -102
  206. package/src/prover/smt/solver/lp/explanation.ts +1 -6
  207. package/src/prover/smt/solver/lp/gomory.ts +9 -22
  208. package/src/prover/smt/solver/lp/hnf-cutter.ts +17 -23
  209. package/src/prover/smt/solver/lp/hnf.ts +11 -26
  210. package/src/prover/smt/solver/lp/int-cube.ts +15 -36
  211. package/src/prover/smt/solver/lp/int-solver.ts +4 -34
  212. package/src/prover/smt/solver/lp/lar-solver.ts +32 -81
  213. package/src/prover/smt/solver/lp/lar-term.ts +1 -5
  214. package/src/prover/smt/solver/lp/lp-settings.ts +1 -14
  215. package/src/prover/smt/solver/lp/maximize-term.ts +20 -45
  216. package/src/prover/smt/solver/lp/nex-creator.ts +5 -28
  217. package/src/prover/smt/solver/lp/nex.ts +1 -6
  218. package/src/prover/smt/solver/lp/nla-backoff.ts +1 -4
  219. package/src/prover/smt/solver/lp/nla-basics.ts +5 -30
  220. package/src/prover/smt/solver/lp/nla-core.ts +36 -135
  221. package/src/prover/smt/solver/lp/nla-divisions.ts +32 -42
  222. package/src/prover/smt/solver/lp/nla-emonics.ts +4 -21
  223. package/src/prover/smt/solver/lp/nla-factorization.ts +1 -4
  224. package/src/prover/smt/solver/lp/nla-grobner.ts +15 -69
  225. package/src/prover/smt/solver/lp/nla-horner.ts +3 -11
  226. package/src/prover/smt/solver/lp/nla-intervals.ts +2 -12
  227. package/src/prover/smt/solver/lp/nla-monomial-bounds.ts +16 -41
  228. package/src/prover/smt/solver/lp/nla-monotone.ts +2 -6
  229. package/src/prover/smt/solver/lp/nla-order.ts +2 -13
  230. package/src/prover/smt/solver/lp/nla-patcher.ts +4 -7
  231. package/src/prover/smt/solver/lp/nla-tangents.ts +1 -9
  232. package/src/prover/smt/solver/lp/nla-throttle.ts +1 -6
  233. package/src/prover/smt/solver/lp/nla-types.ts +1 -11
  234. package/src/prover/smt/solver/lp/nla-var-eqs.ts +4 -25
  235. package/src/prover/smt/solver/lp/nra-solver.ts +5 -52
  236. package/src/prover/smt/solver/lp/numeric-pair.ts +1 -4
  237. package/src/prover/smt/solver/lp/pdd-interval.ts +1 -3
  238. package/src/prover/smt/solver/lp/pdd-simplifier.ts +2 -14
  239. package/src/prover/smt/solver/lp/pdd-solver.ts +4 -33
  240. package/src/prover/smt/solver/lp/pdd.ts +7 -70
  241. package/src/prover/smt/solver/lp/random-updater.ts +1 -8
  242. package/src/prover/smt/solver/lp/static-matrix.ts +9 -19
  243. package/src/prover/smt/solver/lp/union-find.ts +1 -6
  244. package/src/prover/smt/solver/mam-compiler.ts +18 -58
  245. package/src/prover/smt/solver/mam-interpreter.ts +1 -21
  246. package/src/prover/smt/solver/maximize-ac-sharing.ts +2 -17
  247. package/src/prover/smt/solver/model-checker.ts +3 -37
  248. package/src/prover/smt/solver/model-evaluator.ts +3 -29
  249. package/src/prover/smt/solver/model-finder.ts +15 -32
  250. package/src/prover/smt/solver/model-generator.ts +1 -12
  251. package/src/prover/smt/solver/model-macro-solver.ts +23 -88
  252. package/src/prover/smt/solver/nlsat/algebraic.ts +63 -159
  253. package/src/prover/smt/solver/nlsat/atoms.ts +25 -23
  254. package/src/prover/smt/solver/nlsat/evaluator.ts +17 -22
  255. package/src/prover/smt/solver/nlsat/explain.ts +10 -69
  256. package/src/prover/smt/solver/nlsat/interval-set.ts +9 -50
  257. package/src/prover/smt/solver/nlsat/levelwise.ts +49 -135
  258. package/src/prover/smt/solver/nlsat/mpbq.ts +3 -14
  259. package/src/prover/smt/solver/nlsat/polynomial.ts +29 -159
  260. package/src/prover/smt/solver/nlsat/solver.ts +18 -90
  261. package/src/prover/smt/solver/nlsat/types.ts +1 -8
  262. package/src/prover/smt/solver/nlsat/upolynomial-factorization.ts +2 -45
  263. package/src/prover/smt/solver/nlsat/upolynomial.ts +11 -92
  264. package/src/prover/smt/solver/nnf.ts +3 -38
  265. package/src/prover/smt/solver/pattern-inference.ts +2 -15
  266. package/src/prover/smt/solver/poly-rewriter.ts +3 -23
  267. package/src/prover/smt/solver/propagate-values.ts +1 -10
  268. package/src/prover/smt/solver/proto-model.ts +3 -52
  269. package/src/prover/smt/solver/pull-quant.ts +1 -12
  270. package/src/prover/smt/solver/qe-lite-der.ts +1 -29
  271. package/src/prover/smt/solver/qe-lite-fm.ts +2 -25
  272. package/src/prover/smt/solver/qe-lite.ts +3 -33
  273. package/src/prover/smt/solver/qi-queue.ts +1 -16
  274. package/src/prover/smt/solver/quant-tactics.ts +5 -22
  275. package/src/prover/smt/solver/quantifier-analyzer.ts +27 -47
  276. package/src/prover/smt/solver/quantifier-manager.ts +2 -13
  277. package/src/prover/smt/solver/random-gen.ts +1 -2
  278. package/src/prover/smt/solver/rational.ts +1 -8
  279. package/src/prover/smt/solver/ref-vector.ts +1 -6
  280. package/src/prover/smt/solver/relevancy.ts +2 -15
  281. package/src/prover/smt/solver/rewriter-tpl.ts +3 -147
  282. package/src/prover/smt/solver/rewriter.ts +3 -85
  283. package/src/prover/smt/solver/rlimit.ts +2 -20
  284. package/src/prover/smt/solver/smtlib-parser.ts +80 -131
  285. package/src/prover/smt/solver/solver.ts +23 -34
  286. package/src/prover/smt/solver/sort.ts +1 -5
  287. package/src/prover/smt/solver/sticky-generations.ts +0 -5
  288. package/src/prover/smt/solver/theory-lra-axioms.ts +3 -24
  289. package/src/prover/smt/solver/theory-lra-bounds.ts +1 -7
  290. package/src/prover/smt/solver/theory-lra-final-check.ts +4 -22
  291. package/src/prover/smt/solver/theory-lra-internalize.ts +6 -43
  292. package/src/prover/smt/solver/theory-lra-model.ts +4 -19
  293. package/src/prover/smt/solver/theory-lra-propagate.ts +1 -15
  294. package/src/prover/smt/solver/theory-lra-state.ts +3 -8
  295. package/src/prover/smt/solver/theory-lra.ts +1 -8
  296. package/src/prover/smt/solver/var-subst.ts +2 -26
  297. package/src/prover/smt/table.ts +0 -8
  298. package/src/prover/tlapm/cache.ts +45 -40
  299. package/src/prover/tlapm/ocaml-marshal.ts +19 -21
  300. package/src/prover/tlapm/tlapm.ts +21 -20
  301. package/src/prover/verdict.ts +7 -2
  302. package/src/prover/zenon/check/check.ts +1 -11
  303. package/src/prover/zenon/check/definitions.ts +5 -15
  304. package/src/prover/zenon/check/equality.ts +0 -8
  305. package/src/prover/zenon/check/functions.ts +0 -4
  306. package/src/prover/zenon/check/keys.ts +0 -7
  307. package/src/prover/zenon/check/propositional.ts +0 -3
  308. package/src/prover/zenon/check/records.ts +1 -6
  309. package/src/prover/zenon/check/relations.ts +2 -14
  310. package/src/prover/zenon/check/rewrites.ts +2 -21
  311. package/src/prover/zenon/check/sets.ts +40 -61
  312. package/src/prover/zenon/check/terms.ts +1 -19
  313. package/src/prover/zenon/check/tla.ts +0 -6
  314. package/src/prover/zenon/decide.ts +0 -12
  315. package/src/prover/zenon/encode.ts +1 -8
  316. package/src/prover/zenon/eqrel.ts +2 -13
  317. package/src/prover/zenon/equality-rules.ts +0 -4
  318. package/src/prover/zenon/expr.ts +8 -26
  319. package/src/prover/zenon/index-table.ts +26 -57
  320. package/src/prover/zenon/isar-case.ts +9 -19
  321. package/src/prover/zenon/isar.ts +36 -64
  322. package/src/prover/zenon/limits.ts +0 -4
  323. package/src/prover/zenon/llproof.ts +2 -20
  324. package/src/prover/zenon/mltoll.ts +66 -104
  325. package/src/prover/zenon/node.ts +1 -11
  326. package/src/prover/zenon/ocaml.ts +1 -17
  327. package/src/prover/zenon/parse.ts +4 -12
  328. package/src/prover/zenon/phrase.ts +1 -11
  329. package/src/prover/zenon/proof.ts +0 -9
  330. package/src/prover/zenon/propositional-rules.ts +0 -5
  331. package/src/prover/zenon/rules.ts +2 -6
  332. package/src/prover/zenon/search.ts +5 -31
  333. package/src/prover/zenon/tla/functions.ts +59 -31
  334. package/src/prover/zenon/tla/llproof.ts +67 -76
  335. package/src/prover/zenon/tla/records.ts +57 -33
  336. package/src/prover/zenon/tla/rewrites.ts +12 -19
  337. package/src/prover/zenon/tla/sets.ts +83 -53
  338. package/src/prover/zenon/tla/terms.ts +0 -6
  339. package/src/prover/zenon/tla/tla.ts +66 -64
  340. package/src/randomization.ts +81 -35
  341. package/src/resolve.ts +67 -184
  342. package/src/runtime.ts +22 -22
  343. package/src/sany/builtins.ts +2 -5
  344. package/src/sany/generation.ts +394 -0
  345. package/src/sany/generator-def-entries.ts +210 -0
  346. package/src/sany/generator-definitions.ts +686 -0
  347. package/src/sany/generator-expressions.ts +1100 -0
  348. package/src/sany/generator-proofs.ts +662 -0
  349. package/src/sany/generator.ts +191 -2764
  350. package/src/sany/levels.ts +6 -34
  351. package/src/sany/lexer.ts +58 -77
  352. package/src/sany/linter.ts +1 -9
  353. package/src/sany/modules.ts +1 -5
  354. package/src/sany/nodes.ts +5 -43
  355. package/src/sany/parse-error.ts +39 -117
  356. package/src/sany/report.ts +32 -69
  357. package/src/sany/selectors.ts +49 -76
  358. package/src/sany/source.ts +1 -17
  359. package/src/sany/xml.ts +35 -117
  360. package/src/search.ts +541 -163
  361. package/src/simulate.ts +709 -0
  362. package/src/spec-description.ts +192 -100
  363. package/src/standard-definitions.ts +0 -4
  364. package/src/standard-modules.ts +264 -95
  365. package/src/state-graph.ts +52 -31
  366. package/src/subexpressions.ts +69 -52
  367. package/src/substitution-levels.ts +7 -7
  368. package/src/successors.ts +266 -99
  369. package/src/symmetry.ts +33 -25
  370. package/src/tableau.ts +27 -24
  371. package/src/tlc/fingerprint.ts +183 -67
  372. package/src/tlc/jar-data.ts +112 -6
  373. package/src/tlc/messages.ts +125 -54
  374. package/src/tlc/order.ts +39 -69
  375. package/src/tlc/random.ts +37 -49
  376. package/src/tlc/replay.ts +553 -228
  377. package/src/tlc/summary.ts +36 -47
  378. package/src/tlc/tlc-operators.ts +78 -44
  379. package/src/tlc/tlcext-operators.ts +139 -122
  380. package/src/tlc/trace-spec.ts +249 -0
  381. package/src/tlc/value-stream.ts +139 -0
  382. package/src/tlc/version.ts +1 -4
  383. package/src/transfer.ts +22 -25
  384. package/src/typescript/actions.ts +479 -0
  385. package/src/typescript/collections.ts +614 -0
  386. package/src/typescript/compile.ts +63 -0
  387. package/src/typescript/context.ts +94 -0
  388. package/src/typescript/emit.ts +121 -0
  389. package/src/typescript/expressions.ts +496 -0
  390. package/src/typescript/formula.ts +154 -0
  391. package/src/typescript/functions.ts +284 -0
  392. package/src/typescript/model.ts +162 -0
  393. package/src/typescript/names.ts +114 -0
  394. package/src/typescript/program.ts +48 -0
  395. package/src/typescript/properties.ts +139 -0
  396. package/src/typescript/scope.ts +112 -0
  397. package/src/typescript/steps.ts +167 -0
  398. package/src/typescript/types.ts +171 -0
  399. package/src/values.ts +832 -484
  400. package/src/worker.ts +7 -8
@@ -0,0 +1,652 @@
1
+ import { closeSync, openSync } from "node:fs";
2
+ import { availableParallelism } from "node:os";
3
+ import type { ModuleOperator } from "../check";
4
+ import { MAXIMUM_INTEGER } from "../values";
5
+
6
+ export interface TlcArguments {
7
+ specs: string[];
8
+ configPath: string | undefined;
9
+ seed: bigint;
10
+ aril: bigint;
11
+ workers: number;
12
+ coverage: number | undefined;
13
+ livenessCheck: string;
14
+ dump: string[] | undefined;
15
+ fingerprintIndex: number;
16
+ maxSetSize: number | undefined;
17
+ isLazyValueExpanded: boolean;
18
+ isViewPrinted: boolean;
19
+ metadir: string | undefined;
20
+ recoverDirectory: string | undefined;
21
+ mode: "model-check" | "simulate" | "generate";
22
+ dfidDepth: number | undefined;
23
+ traceDepth: number;
24
+ traceCount: bigint | undefined;
25
+ scheduler: "random" | "rl" | "rlaction";
26
+ isTool: boolean;
27
+ isContinued: boolean;
28
+ isDeadlockChecked: boolean;
29
+ isWarningEnabled: boolean;
30
+ isTraceSpecForced: boolean;
31
+ isTraceSpecDisabled: boolean;
32
+ isTraceBinaryDisabled: boolean;
33
+ traceSpecPath: string | undefined;
34
+ isDiffTrace: boolean;
35
+ suppressedCodes: number[];
36
+ errorCodes: number[];
37
+ userFile: string | undefined;
38
+ invariants: RuntimeInvariant[];
39
+ moduleOperators: ModuleOperator[];
40
+ }
41
+
42
+ export interface RuntimeInvariant {
43
+ modules: string[];
44
+ expression: string;
45
+ }
46
+
47
+ export interface TlcArgumentsError {
48
+ kind: "command-line" | "uncaught";
49
+ error: string;
50
+ isTool: boolean;
51
+ }
52
+
53
+ interface MessageCodes {
54
+ tlc: number[];
55
+ sany: number[];
56
+ }
57
+
58
+ const FINGERPRINT_POLYNOMIALS = 131;
59
+
60
+ const MAXIMUM_LONG = (1n << 63n) - 1n;
61
+
62
+ const TLC_MESSAGE_CODES = [
63
+ [-123456, -123456],
64
+ [-1, 0],
65
+ [1000, 1003],
66
+ [1005, 1005],
67
+ [1101, 1102],
68
+ [2000, 2001],
69
+ [2100, 2149],
70
+ [2154, 2274],
71
+ [2279, 2287],
72
+ [2300, 2301],
73
+ [2400, 2405],
74
+ [2501, 2502],
75
+ [2772, 2780],
76
+ [3000, 3002],
77
+ [3100, 3114],
78
+ [4000, 4002],
79
+ [5001, 5007],
80
+ [7000, 7010],
81
+ [20000, 20000],
82
+ ];
83
+
84
+ const SANY_ERROR_CODES = [
85
+ [4003, 4005],
86
+ [4200, 4206],
87
+ [4220, 4224],
88
+ [4240, 4247],
89
+ [4260, 4262],
90
+ [4270, 4275],
91
+ [4290, 4294],
92
+ [4310, 4315],
93
+ [4330, 4337],
94
+ [4350, 4357],
95
+ ];
96
+
97
+ const SANY_WARNING_CODES = new Map([
98
+ [4800, "EXTENDED_MODULES_SYMBOL_UNIFICATION_AMBIGUITY"],
99
+ [4801, "INSTANCED_MODULES_SYMBOL_UNIFICATION_AMBIGUITY"],
100
+ [4802, "RECORD_CONSTRUCTOR_FIELD_NAME_CLASH"],
101
+ [4803, "PLUSCAL_ALGORITHM_AND_TRANSLATION_CHANGED_SINCE_LAST_TRANSLATION"],
102
+ [4804, "PLUSCAL_ALGORITHM_CHANGED_SINCE_LAST_TRANSLATION"],
103
+ [4805, "PLUSCAL_TRANSLATION_CHANGED_SINCE_LAST_TRANSLATION"],
104
+ ]);
105
+
106
+ interface TraceFormat {
107
+ module: string;
108
+ constant: string;
109
+ operators: Pick<ModuleOperator, "kind" | "operator">[];
110
+ }
111
+
112
+ const getDumpedTrace = (module: string, operator: string, constant: string): TraceFormat => ({
113
+ module,
114
+ constant,
115
+ operators: [{ kind: "postcondition", operator }],
116
+ });
117
+
118
+ const DUMPED_TRACES: Record<string, TraceFormat> = {
119
+ json: getDumpedTrace("_JsonTrace", "_JsonTrace", "_JsonTraceFile"),
120
+ tla: getDumpedTrace(
121
+ "_TLAPlusCounterExample",
122
+ "_TLAPlusCounterExample",
123
+ "_TLAPlusCounterExampleFile",
124
+ ),
125
+ tlc: getDumpedTrace("_TLCTrace", "_TLCTrace", "_TLCTraceFile"),
126
+ tlcplain: getDumpedTrace("_TLCTracePlain", "_TLCTrace", "_TLCTraceFile"),
127
+ tlctespec: getDumpedTrace("_TLCTESpec", "_TLCTrace", "_TLCTraceFile"),
128
+ tlcaction: getDumpedTrace("_TLCActionTrace", "_TLCTrace", "_TLCTraceFile"),
129
+ dot: getDumpedTrace("_DotTrace", "_DotTrace", "_DotTraceFile"),
130
+ };
131
+
132
+ const getLoadedTrace = (module: string, prefix: string): TraceFormat => ({
133
+ module,
134
+ constant: `${prefix}InputFile`,
135
+ operators: [
136
+ { kind: "constraint", operator: `${prefix}Constraint` },
137
+ { kind: "view", operator: `${prefix}View` },
138
+ ],
139
+ });
140
+
141
+ const LOADED_TRACES: Record<string, TraceFormat> = {
142
+ tlc: getLoadedTrace("_TLCTrace", "_TLCTrace"),
143
+ json: getLoadedTrace("_JsonTrace", "_JsonTrace"),
144
+ };
145
+
146
+ const isInRanges = (ranges: number[][], code: number) =>
147
+ ranges.some((range) => code >= range[0] && code <= range[1]);
148
+
149
+ const splitLikeJava = (text: string, separator: string) => {
150
+ if (text === "") return [text];
151
+ const parts = text.split(separator);
152
+ while (parts.at(-1) === "") parts.pop();
153
+ return parts;
154
+ };
155
+
156
+ const getOverlap = (suppressed: number[], errors: number[]) =>
157
+ [...new Set(suppressed.filter((code) => errors.includes(code)))].sort(
158
+ (left, right) => left - right,
159
+ );
160
+
161
+ const parseJavaInteger = (text: string, bits: 32 | 64) => {
162
+ if (!/^[+-]?\d+$/.test(text)) return undefined;
163
+ const value = BigInt(text);
164
+ return BigInt.asIntN(bits, value) === value ? value : undefined;
165
+ };
166
+
167
+ const parseJavaDouble = (text: string) =>
168
+ /^[+-]?(NaN|Infinity|(\d+\.?\d*|\.\d+)([eE][+-]?\d+)?[fFdD]?)$/.test(text.trim())
169
+ ? Number.parseFloat(text.trim().replace(/[fFdD]$/, ""))
170
+ : undefined;
171
+
172
+ const createDefaults = (): TlcArguments => ({
173
+ specs: [],
174
+ configPath: undefined,
175
+ seed: 0n,
176
+ aril: 0n,
177
+ workers: 1,
178
+ coverage: undefined,
179
+ livenessCheck: "default",
180
+ dump: undefined,
181
+ fingerprintIndex: 0,
182
+ maxSetSize: undefined,
183
+ isLazyValueExpanded: true,
184
+ isViewPrinted: false,
185
+ metadir: undefined,
186
+ recoverDirectory: undefined,
187
+ mode: "model-check",
188
+ dfidDepth: undefined,
189
+ traceDepth: 100,
190
+ traceCount: undefined,
191
+ scheduler: "random",
192
+ isTool: false,
193
+ isContinued: false,
194
+ isDeadlockChecked: true,
195
+ isWarningEnabled: true,
196
+ isTraceSpecForced: false,
197
+ isTraceSpecDisabled: false,
198
+ isTraceBinaryDisabled: false,
199
+ traceSpecPath: undefined,
200
+ isDiffTrace: false,
201
+ suppressedCodes: [],
202
+ errorCodes: [],
203
+ userFile: undefined,
204
+ invariants: [],
205
+ moduleOperators: [],
206
+ });
207
+
208
+ const SWITCHES: Record<string, (parsed: TlcArguments) => void> = {
209
+ "-modelcheck": () => {},
210
+ "-difftrace": (parsed) => {
211
+ parsed.isDiffTrace = true;
212
+ },
213
+ "-deadlock": (parsed) => {
214
+ parsed.isDeadlockChecked = false;
215
+ },
216
+ "-cleanup": () => {},
217
+ "-nowarning": (parsed) => {
218
+ parsed.isWarningEnabled = false;
219
+ },
220
+ "-gzip": () => {},
221
+ "-terse": (parsed) => {
222
+ parsed.isLazyValueExpanded = false;
223
+ },
224
+ "-continue": (parsed) => {
225
+ parsed.isContinued = true;
226
+ },
227
+ "-view": (parsed) => {
228
+ parsed.isViewPrinted = true;
229
+ },
230
+ "-debug": () => {},
231
+ "-tool": (parsed) => {
232
+ parsed.isTool = true;
233
+ },
234
+ };
235
+
236
+ interface ValueFlag {
237
+ missing: string;
238
+ apply: (parsed: TlcArguments, text: string) => string | undefined;
239
+ }
240
+
241
+ const applyInteger =
242
+ (
243
+ bits: 32 | 64,
244
+ malformed: string,
245
+ apply: (parsed: TlcArguments, value: bigint, text: string) => string | undefined,
246
+ ) =>
247
+ (parsed: TlcArguments, text: string) => {
248
+ const value = parseJavaInteger(text, bits);
249
+ return value === undefined
250
+ ? `${malformed} But encountered ${text}`
251
+ : apply(parsed, value, text);
252
+ };
253
+
254
+ const getIntervalFlag = (
255
+ name: string,
256
+ missing: string,
257
+ malformed: string,
258
+ assign: (parsed: TlcArguments, minutes: number) => void,
259
+ ): ValueFlag => ({
260
+ missing,
261
+ apply: applyInteger(32, malformed, (parsed, minutes) => {
262
+ // TLC multiplies the minutes into an int of milliseconds.
263
+ const milliseconds = BigInt.asIntN(32, minutes * 60_000n);
264
+ if (milliseconds < 0n) return `Error: expect a nonnegative integer for -${name} option.`;
265
+ assign(parsed, Number(milliseconds) / 60_000);
266
+ }),
267
+ });
268
+
269
+ const VALUE_FLAGS: Record<string, ValueFlag> = {
270
+ "-teSpecOutDir": {
271
+ missing: "Error: expected a path for -teSpecOutDir option.",
272
+ apply: (parsed, path) => {
273
+ parsed.traceSpecPath = path;
274
+ },
275
+ },
276
+ "-userFile": {
277
+ missing: "Error: need to specify the full qualified file.",
278
+ apply: (parsed, path) => {
279
+ try {
280
+ closeSync(openSync(path, "w"));
281
+ } catch {
282
+ return "Error: Failed to create user output log file.";
283
+ }
284
+ parsed.userFile = path;
285
+ },
286
+ },
287
+ "-lncheck": {
288
+ missing: "Error: expect a strategy such as final for -lncheck option.",
289
+ apply: (parsed, strategy) => {
290
+ parsed.livenessCheck = strategy.toLowerCase();
291
+ },
292
+ },
293
+ "-config": {
294
+ missing: "Error: expect a file name for -config option.",
295
+ apply: (parsed, path) => {
296
+ const name = path.replace(/\.cfg$/, "");
297
+ parsed.configPath = name.endsWith(".tla") ? name : `${name}.cfg`;
298
+ },
299
+ },
300
+ "-coverage": getIntervalFlag(
301
+ "coverage",
302
+ "Error: coverage report interval required.",
303
+ "Error: An integer for coverage report interval required.",
304
+ (parsed, minutes) => {
305
+ parsed.coverage = minutes;
306
+ },
307
+ ),
308
+ "-checkpoint": getIntervalFlag(
309
+ "checkpoint",
310
+ "Error: checkpoint interval required.",
311
+ "Error: An integer for checkpoint interval is required.",
312
+ () => {},
313
+ ),
314
+ "-depth": {
315
+ missing: "Error: trace length required.",
316
+ apply: applyInteger(32, "Error: An integer for trace length required.", (parsed, depth) => {
317
+ parsed.traceDepth = Number(depth);
318
+ }),
319
+ },
320
+ "-seed": {
321
+ missing: "Error: seed required.",
322
+ apply: applyInteger(64, "Error: An integer for seed required.", (parsed, seed) => {
323
+ parsed.seed = seed;
324
+ }),
325
+ },
326
+ "-aril": {
327
+ missing: "Error: aril required.",
328
+ apply: applyInteger(64, "Error: An integer for aril required.", (parsed, aril) => {
329
+ parsed.aril = aril;
330
+ }),
331
+ },
332
+ "-maxSetSize": {
333
+ missing: "Error: maxSetSize required.",
334
+ apply: applyInteger(32, "Error: An integer for maxSetSize required.", (parsed, bound, text) => {
335
+ if (bound < 1n) {
336
+ return `Error: Value in interval [0, ${MAXIMUM_INTEGER}] for maxSetSize required. But encountered ${text}`;
337
+ }
338
+ parsed.maxSetSize = Number(bound);
339
+ }),
340
+ },
341
+ "-recover": {
342
+ missing: "Error: need to specify the metadata directory for recovery.",
343
+ apply: (parsed, directory) => {
344
+ parsed.recoverDirectory = directory;
345
+ },
346
+ },
347
+ "-metadir": {
348
+ missing: "Error: need to specify the metadata directory.",
349
+ apply: (parsed, directory) => {
350
+ parsed.metadir = directory;
351
+ },
352
+ },
353
+ "-workers": {
354
+ missing: "Error: expect an integer or 'auto' for -workers option.",
355
+ apply: (parsed, text) => {
356
+ const count =
357
+ text.trim().toLowerCase() === "auto"
358
+ ? BigInt(availableParallelism())
359
+ : parseJavaInteger(text, 32);
360
+ if (count === undefined) {
361
+ return `Error: worker number or 'auto' required. But encountered ${text}`;
362
+ }
363
+ if (count < 1n) return "Error: at least one worker required.";
364
+ parsed.workers = Number(count);
365
+ },
366
+ },
367
+ "-dfid": {
368
+ missing: "Error: expect a nonnegative integer for -dfid option.",
369
+ apply: applyInteger(
370
+ 32,
371
+ "Error: expect a nonnegative integer for -dfid option.",
372
+ (parsed, depth) => {
373
+ if (depth < 0n) return "Error: expect a nonnegative integer for -dfid option.";
374
+ parsed.dfidDepth = Number(depth);
375
+ },
376
+ ),
377
+ },
378
+ "-fp": {
379
+ missing: "Error: expect an integer for -fp option.",
380
+ apply: applyInteger(32, "Error: A number for -fp is required.", (parsed, index) => {
381
+ if (index < 0n || index >= FINGERPRINT_POLYNOMIALS) {
382
+ return `Error: The number for -fp must be between 0 and ${FINGERPRINT_POLYNOMIALS - 1} (inclusive).`;
383
+ }
384
+ parsed.fingerprintIndex = Number(index);
385
+ }),
386
+ },
387
+ "-fpmem": {
388
+ missing: "Error: fpset memory size required.",
389
+ apply: (_parsed, text) => {
390
+ const size = parseJavaDouble(text);
391
+ if (size === undefined || size < 0) {
392
+ return `Error: An positive integer or a fraction for fpset memory size/percentage required. But encountered ${text}`;
393
+ }
394
+ if (size > 1) {
395
+ process.stdout.write(
396
+ "Using -fpmem with an abolute memory value has been deprecated. Please allocate memory for the TLC process via the JVM mechanisms and use -fpmem to set the fraction to be used for fingerprint storage.\n",
397
+ );
398
+ }
399
+ },
400
+ },
401
+ "-fpbits": {
402
+ missing: "Error: fpbits required.",
403
+ apply: applyInteger(32, "Error: An integer for fpbits required.", (_parsed, bits, text) =>
404
+ bits < 0n || bits > 30n
405
+ ? `Error: Value in interval [0, 30] for fpbits required. But encountered ${text}`
406
+ : undefined,
407
+ ),
408
+ },
409
+ };
410
+
411
+ interface TraceFlag {
412
+ name: string;
413
+ missing: string;
414
+ formats: Record<string, TraceFormat>;
415
+ }
416
+
417
+ const TRACE_FLAGS: Record<string, TraceFlag> = {
418
+ "-loadtrace": {
419
+ name: "-loadTrace",
420
+ missing: "Error: A format and a file name for loading traces required.",
421
+ formats: LOADED_TRACES,
422
+ },
423
+ "-dumptrace": {
424
+ name: "-dumpTrace",
425
+ missing: "Error: A format and a file name for dumping traces required.",
426
+ formats: DUMPED_TRACES,
427
+ },
428
+ };
429
+
430
+ export const parseTlcArguments = (args: string[]): TlcArguments | TlcArgumentsError | "usage" => {
431
+ const parsed = createDefaults();
432
+ let argumentIndex = 0;
433
+ const reject = (error: string): TlcArgumentsError => ({
434
+ kind: "command-line",
435
+ error,
436
+ isTool: parsed.isTool,
437
+ });
438
+ const getMissing = (): TlcArgumentsError => ({
439
+ kind: "uncaught",
440
+ error: `java.lang.ArrayIndexOutOfBoundsException: Index ${args.length} out of bounds for length ${args.length}`,
441
+ isTool: parsed.isTool,
442
+ });
443
+ const suppressedCodes: MessageCodes = { tlc: [], sany: [] };
444
+ const errorCodes: MessageCodes = { tlc: [], sany: [] };
445
+ const peek = () => args[argumentIndex];
446
+ const take = () => args[argumentIndex++];
447
+ while (argumentIndex < args.length) {
448
+ const flag = take();
449
+ if (Object.hasOwn(SWITCHES, flag)) {
450
+ SWITCHES[flag](parsed);
451
+ continue;
452
+ }
453
+ if (Object.hasOwn(VALUE_FLAGS, flag)) {
454
+ const text = take();
455
+ if (text === undefined) return reject(VALUE_FLAGS[flag].missing);
456
+ const error = VALUE_FLAGS[flag].apply(parsed, text);
457
+ if (error !== undefined) return reject(error);
458
+ continue;
459
+ }
460
+ if (flag === "-simulate" || flag === "-generate") {
461
+ parsed.mode = flag === "-generate" ? "generate" : "simulate";
462
+ const options = peek();
463
+ if (
464
+ options === undefined ||
465
+ !["stats=", "file=", "num=", "sched"].some((option) => options.includes(option))
466
+ ) {
467
+ continue;
468
+ }
469
+ argumentIndex++;
470
+ const hasFile = options.split(",").some((option) => option.startsWith("file="));
471
+ parsed.scheduler = options.split(",").includes("sched=rl")
472
+ ? "rl"
473
+ : options.split(",").includes("sched=rlaction")
474
+ ? "rlaction"
475
+ : "random";
476
+ for (const option of options.split(",").filter((item) => item.startsWith("num="))) {
477
+ const count = option.replace("num=", "");
478
+ parsed.traceCount = parseJavaInteger(count, 64);
479
+ if (parsed.traceCount === undefined) {
480
+ return {
481
+ kind: "uncaught",
482
+ error: `java.lang.NumberFormatException: For input string: "${count}"`,
483
+ isTool: parsed.isTool,
484
+ };
485
+ }
486
+ }
487
+ // TLC's default trace count is Long.MAX_VALUE, so it takes that num for a missing one.
488
+ if ((parsed.traceCount ?? MAXIMUM_LONG) === MAXIMUM_LONG && hasFile) {
489
+ return reject(
490
+ `Error: You need to specify a 'num' argument when using the 'file' argument, for example: '"num=5,file=test.txt"'.`,
491
+ );
492
+ }
493
+ continue;
494
+ }
495
+ if (flag === "-suppressMessages" || flag === "-messagesAsErrors") {
496
+ const text = take();
497
+ if (text === undefined) {
498
+ return reject(`Error: ${flag} requires a comma-separated list of message codes.`);
499
+ }
500
+ const codes = flag === "-suppressMessages" ? suppressedCodes : errorCodes;
501
+ for (const item of splitLikeJava(text, ",")) {
502
+ const trimmed = item.replace(/^[^!-\uffff]+|[^!-\uffff]+$/g, "");
503
+ const parsedCode = parseJavaInteger(trimmed, 32);
504
+ if (parsedCode === undefined) return reject(`Error: For input string: "${trimmed}"`);
505
+ const code = Number(parsedCode);
506
+ if (isInRanges(TLC_MESSAGE_CODES, code)) {
507
+ codes.tlc.push(code);
508
+ continue;
509
+ }
510
+ if (!SANY_WARNING_CODES.has(code) && !isInRanges(SANY_ERROR_CODES, code)) {
511
+ return reject(`Error: unknown message code: ${code}`);
512
+ }
513
+ if (codes === suppressedCodes && !SANY_WARNING_CODES.has(code)) {
514
+ return reject(`Error: code ${code} is an error and cannot be suppressed.`);
515
+ }
516
+ codes.sany.push(code);
517
+ }
518
+ continue;
519
+ }
520
+ if (flag === "-inv") {
521
+ const expression = take();
522
+ if (expression === undefined) return getMissing();
523
+ parsed.invariants.push({
524
+ modules: [
525
+ ...new Set([...expression.matchAll(/INSTANCE\s+(\w+)/g)].map((match) => match[1])),
526
+ ],
527
+ expression,
528
+ });
529
+ continue;
530
+ }
531
+ if (flag === "-invlevel") {
532
+ const text = take();
533
+ if (text === undefined) return getMissing();
534
+ if (parseJavaInteger(text, 32) === undefined) {
535
+ return reject(`Error: An integer for -invlevel required. But encountered ${text}`);
536
+ }
537
+ parsed.invariants.push({
538
+ modules: ["TLC", "Naturals"],
539
+ expression: `LET _T == INSTANCE TLC _N == INSTANCE Naturals IN _N!<(_T!TLCGet("level"), ${text})`,
540
+ });
541
+ continue;
542
+ }
543
+ if (flag === "-debugger") {
544
+ const options = peek();
545
+ if (
546
+ options !== undefined &&
547
+ ["port=", "nosuspend", "nohalt", "suspend", "halt"].some((option) =>
548
+ options.includes(option),
549
+ )
550
+ ) {
551
+ argumentIndex++;
552
+ }
553
+ continue;
554
+ }
555
+ if (flag === "-generateSpecTE") {
556
+ parsed.isTraceSpecForced = true;
557
+ if (peek() === "nomonolith") argumentIndex++;
558
+ continue;
559
+ }
560
+ if (flag === "-noGenerateSpecTE" || flag.toLowerCase() === "-note") {
561
+ parsed.isTraceSpecDisabled = true;
562
+ continue;
563
+ }
564
+ if (flag === "-noGenerateSpecTEBin" || flag.toLowerCase() === "-notebin") {
565
+ parsed.isTraceBinaryDisabled = true;
566
+ continue;
567
+ }
568
+ if (flag === "-help" || flag === "-h") return "usage";
569
+ if (flag === "-dump") {
570
+ const format = peek();
571
+ if (format?.startsWith("class,")) {
572
+ return reject(
573
+ `Trying to instantiate a custom IStateWriter implementation ${format.replaceAll("class,", "")}.`,
574
+ );
575
+ }
576
+ const arity = format?.startsWith("dot") && argumentIndex + 1 < args.length ? 2 : 1;
577
+ parsed.dump = args.slice(argumentIndex, argumentIndex + arity);
578
+ argumentIndex += arity;
579
+ if (parsed.dump.length === 0)
580
+ return reject("Error: A file name for dumping states required.");
581
+ continue;
582
+ }
583
+ if (Object.hasOwn(TRACE_FLAGS, flag.toLowerCase())) {
584
+ const traceFlag = TRACE_FLAGS[flag.toLowerCase()];
585
+ if (argumentIndex + 1 >= args.length) return reject(traceFlag.missing);
586
+ const format = take();
587
+ const path = take();
588
+ if (!Object.hasOwn(traceFlag.formats, format.toLowerCase())) {
589
+ return reject(`Error: Unknown format ${format} given to ${traceFlag.name}.`);
590
+ }
591
+ const trace = traceFlag.formats[format.toLowerCase()];
592
+ parsed.moduleOperators.push(
593
+ ...trace.operators.map((operator) => ({
594
+ ...operator,
595
+ module: trace.module,
596
+ constants: { [trace.constant]: path },
597
+ })),
598
+ );
599
+ continue;
600
+ }
601
+ if (flag.toLowerCase() === "-postcondition") {
602
+ const target = take();
603
+ if (target === undefined) return reject("Error: Module!Operator for postCondition required.");
604
+ if (!target.includes("!")) {
605
+ return reject(`Module!Operator for postCondition required. Encountered: ${target}`);
606
+ }
607
+ const parts = splitLikeJava(target, "!");
608
+ if (parts.length !== 2) {
609
+ return reject(
610
+ `Module!Operator for postCondition must be of the form module!operator. Encountered: ${target}`,
611
+ );
612
+ }
613
+ if (parts[0] === "") {
614
+ return reject(`Module name for postCondition required. Encountered: ${target}`);
615
+ }
616
+ if (parts[0].includes(".")) {
617
+ return reject(
618
+ `Module name for postCondition must not contain a dot. Encountered: ${parts[0]}`,
619
+ );
620
+ }
621
+ if (parts[1].includes(".")) {
622
+ return reject(
623
+ `Operator name for postCondition must not contain a dot. Encountered: ${parts[1]}`,
624
+ );
625
+ }
626
+ parsed.moduleOperators.push({ kind: "postcondition", module: parts[0], operator: parts[1] });
627
+ continue;
628
+ }
629
+ if (flag.startsWith("-")) return reject(`Error: unrecognized option: ${flag}`);
630
+ parsed.specs.push(flag);
631
+ }
632
+ if (!parsed.isWarningEnabled && suppressedCodes.tlc.length + suppressedCodes.sany.length > 0) {
633
+ return reject(
634
+ "Error: -nowarning already suppresses all warnings, making -suppressMessages redundant. Remove -nowarning to suppress only the specified messages, or remove -suppressMessages to suppress all warnings.",
635
+ );
636
+ }
637
+ const tlcOverlap = getOverlap(suppressedCodes.tlc, errorCodes.tlc);
638
+ const overlap =
639
+ tlcOverlap.length > 0
640
+ ? tlcOverlap.map(String)
641
+ : getOverlap(suppressedCodes.sany, errorCodes.sany).map(
642
+ (code) => SANY_WARNING_CODES.get(code) ?? String(code),
643
+ );
644
+ if (overlap.length > 0) {
645
+ return reject(
646
+ `Error: The following codes were set to both -suppressMessages and -messagesAsErrors: [${overlap.join(", ")}]`,
647
+ );
648
+ }
649
+ parsed.suppressedCodes = [...suppressedCodes.tlc, ...suppressedCodes.sany];
650
+ parsed.errorCodes = [...errorCodes.tlc, ...errorCodes.sany];
651
+ return parsed;
652
+ };