refactor(benches): restructure file layout (#3247)

Author: skywardboundd

dev-docs/CONTRIBUTING.md

@@ -359,7 +359,7 @@ The code generator lives in the [`src/generator`](../src/generator) sub-folder w
 The implementation that we have right now is being refactored to produce FunC ASTs and then pretty-print those ASTs as strings instead of producing source FunC code in one step. Here is the relevant pull request: <https://github.com/tact-lang/tact/pull/559>.
 
 One can find the end-to-end codegen test spec files in the [`src/test/e2e-emulated`](../src/test/e2e-emulated) folder. The test contracts are located in the subfolders of the [`src/test/e2e-emulated`](../src/test/e2e-emulated) folder. Many of those spec files test various language features in relative isolation.
-An important spec file that tests argument passing semantics for functions and assignment semantics for variables is here: [`src/test/e2e-emulated/semantics.spec.ts`](../src/test/e2e-emulated/functions/semantics.spec.ts).
+An important spec file that tests argument passing semantics for functions and assignment semantics for variables is here: [`src/test/e2e-emulated/functions/semantics.spec.ts`](../src/test/e2e-emulated/functions/semantics.spec.ts).
 
 Contracts with `inline` in the name of the file set `experimental.inline` config option to `true`.
 Contracts with `external` in the name of the file set the `external` config option to `true`.
@@ -380,13 +380,14 @@ Benchmarks are located inside `src/benchmarks/`, one directory per benchmark:
 
 #### File & folder roles
 
-| Path / file              | Purpose                                                  |
-| ------------------------ | -------------------------------------------------------- |
-| `tact/`                  | Tact project that is being benchmarked                   |
-| `func/`                  | Equivalent FunC project that we compare against          |
-| `<benchmark>.spec.ts`    | Jest test spec that prepares and runs the benchmark      |
-| `results_gas.json`       | Aggregated gas‑consumption results, updated by the CLI   |
-| `results_code_size.json` | Contract byte‑code size history, also updated by the CLI |
+| Path / file     | Purpose                                                  |
+| --------------- | -------------------------------------------------------- |
+| `tact/`         | Tact project that is being benchmarked                   |
+| `func/`         | Equivalent FunC project that we compare against          |
+| `test.spec.ts`  | Jest test spec for contract functionality testing        |
+| `bench.spec.ts` | Jest test spec for performance benchmarking              |
+| `gas.json`      | Aggregated gas‑consumption results, updated by the CLI   |
+| `size.json`     | Contract byte‑code size history, also updated by the CLI |
 
 > **CLI support** – All commands for creating, updating, or comparing benchmarks are documented in the [Updating Benchmarks](#benchmarks) section.
 

package.json

@@ -44,8 +44,9 @@
     "test": "jest",
     "test:fast": "jest --config=./jest-fast.config.js",
     "test:allure": "rimraf ./allure-results && yarn test && allure serve allure-results",
-    "bench": "yarn gen:contracts:benchmarks && cross-env PRINT_TABLE=true jest ./src/benchmarks",
-    "bench:ci": "yarn gen:contracts:benchmarks && cross-env PRINT_TABLE=false jest ./src/benchmarks",
+    "bench": "yarn gen:contracts:benchmarks && cross-env PRINT_TABLE=true jest --testMatch=\"**/src/benchmarks/**/bench.spec.ts\"",
+    "bench:test": "yarn gen:contracts:benchmarks && cross-env PRINT_TABLE=false jest --testMatch=\"**/src/benchmarks/**/test.spec.ts\"",
+    "bench:ci": "yarn gen:contracts:benchmarks && cross-env PRINT_TABLE=true jest --testMatch=\"**/src/benchmarks/**/bench.spec.ts\" && cross-env PRINT_TABLE=false jest --testMatch=\"**/src/benchmarks/**/test.spec.ts\"",
     "bench:update": "yarn gen:contracts:benchmarks && cross-env PRINT_TABLE=true ts-node src/benchmarks/update.build.ts",
     "bench:add": "ts-node src/benchmarks/prompt.build.ts && yarn gen:contracts:benchmarks && cross-env PRINT_TABLE=true ADD=true ts-node src/benchmarks/update.build.ts",
     "coverage": "cross-env COVERAGE=true NODE_OPTIONS=--max_old_space_size=5120 jest --config=./jest-ci.config.js",

src/benchmarks/escrow/escrow.spec.ts renamed to src/benchmarks/escrow/bench.spec.ts

@@ -24,8 +24,8 @@ import type {
     Cancel,
 } from "@/benchmarks/escrow/tact/output/escrow_Escrow";
 
-import benchmarkResults from "@/benchmarks/escrow/results_gas.json";
-import benchmarkCodeSizeResults from "@/benchmarks/escrow/results_code_size.json";
+import benchmarkResults from "@/benchmarks/escrow/gas.json";
+import benchmarkCodeSizeResults from "@/benchmarks/escrow/size.json";
 
 const loadFunCEscrowBoc = () => {
     const bocEscrow = readFileSync(

src/benchmarks/escrow/results_gas.json renamed to src/benchmarks/escrow/gas.json

@@ -34,8 +34,8 @@ import {
     type JettonBurn,
 } from "@/benchmarks/jetton/tact/output/minter_JettonWallet";
 
-import benchmarkResults from "@/benchmarks/jetton/results_gas.json";
-import benchmarkCodeSizeResults from "@/benchmarks/jetton/results_code_size.json";
+import benchmarkResults from "@/benchmarks/jetton/gas.json";
+import benchmarkCodeSizeResults from "@/benchmarks/jetton/size.json";
 import { step, parameter } from "@/test/allure/allure";
 
 const loadFunCJettonsBoc = () => {

src/benchmarks/escrow/results_code_size.json renamed to src/benchmarks/escrow/size.json

@@ -42,8 +42,8 @@ import {
     storeInitNFTBody,
 } from "@/benchmarks/nft/tact/output/collection_NFTItem";
 
-import benchmarkResults from "@/benchmarks/nft/results_gas.json";
-import benchmarkCodeSizeResults from "@/benchmarks/nft/results_code_size.json";
+import benchmarkResults from "@/benchmarks/nft/gas.json";
+import benchmarkCodeSizeResults from "@/benchmarks/nft/size.json";
 
 type dictDeployNFT = {
     amount: bigint;