rescript-lang · cknitt · Jul 23, 2025 · Jul 22, 2025 · Jul 23, 2025
diff --git a/analysis/examples/example-project/rescript.json b/analysis/examples/example-project/rescript.json
@@ -1,11 +1,11 @@
 {
   "name": "tryit",
   "sources": "src",
-  "bsc-flags": ["-bs-super-errors", "-open Belt"],
+  "compiler-flags": ["-open Belt"],
   "warnings": {
     "number": "-32-26-27-33"
   },
-  "bs-dependencies": ["reason-react"],
+  "dependencies": ["reason-react"],
   "namespace": "my-namespace",
   "reanalyze": {
     "analysis": ["dce", "exception"]

diff --git a/analysis/examples/larger-project/rescript.json b/analysis/examples/larger-project/rescript.json
@@ -5,8 +5,8 @@
     "unsuppress": []
   },
   "name": "sample-typescript-app",
-  "bsc-flags": ["-bs-super-errors -w a"],
-  "bs-dependencies": ["@rescript/react", "@glennsl/bs-json"],
+  "compiler-flags": ["-w a"],
+  "dependencies": ["@rescript/react", "@glennsl/bs-json"],
   "sources": [
     {
       "dir": "src",

diff --git a/analysis/examples/workspace-project/app/rescript.json b/analysis/examples/workspace-project/app/rescript.json
@@ -1,7 +1,7 @@
 {
   "name": "app",
-  "bsc-flags": ["-open Common"],
-  "bs-dependencies": ["common", "myplugin"],
+  "compiler-flags": ["-open Common"],
+  "dependencies": ["common", "myplugin"],
   "sources": [
     {
       "dir": "src",

diff --git a/analysis/examples/workspace-project/rescript.json b/analysis/examples/workspace-project/rescript.json
@@ -7,5 +7,5 @@
     "in-source": true
   },
   "suffix": ".mjs",
-  "bs-dependencies": ["common", "myplugin", "app"]
+  "dependencies": ["common", "myplugin", "app"]
 }
diff --git a/compiler/bsb/bsb_build_schemas.ml b/compiler/bsb/bsb_build_schemas.ml
@@ -27,12 +27,15 @@ let name = "name"
 let ppx_flags = "ppx-flags"
 let pp_flags = "pp-flags"
 let bs_external_includes = "bs-external-includes"
+let dependencies = "dependencies"
 let bs_dependencies = "bs-dependencies"
+let dev_dependencies = "dev-dependencies"
 let bs_dev_dependencies = "bs-dev-dependencies"
 let sources = "sources"
 let dir = "dir"
 let files = "files"
 let subdirs = "subdirs"
+let compiler_flags = "compiler-flags"
 let bsc_flags = "bsc-flags"
 let excludes = "excludes"
 let slow_re = "slow-re"

diff --git a/compiler/bsb/bsb_build_util.ml b/compiler/bsb/bsb_build_util.ml
@@ -193,9 +193,12 @@ let rec walk_all_deps_aux (visited : string Hash_string.t) (paths : string list)
            )
         |> ignore
       in
+      explore_deps Bsb_build_schemas.dependencies;
       explore_deps Bsb_build_schemas.bs_dependencies;
       (match top with
-      | Expect_none -> explore_deps Bsb_build_schemas.bs_dev_dependencies
+      | Expect_none ->
+        explore_deps Bsb_build_schemas.dev_dependencies;
+        explore_deps Bsb_build_schemas.bs_dev_dependencies
       | Expect_name _ -> ());
       Queue.add {top; proj_dir = dir} queue;
       Hash_string.add visited cur_package_name dir

diff --git a/compiler/bsb/bsb_config_parse.ml b/compiler/bsb/bsb_config_parse.ml
@@ -238,13 +238,24 @@ let interpret_json ~(filename : string) ~(json : Ext_json_types.t)
                 .path)
     in
     let bs_dependencies =
-      extract_dependencies map per_proj_dir Bsb_build_schemas.bs_dependencies
+      let dependencies =
+        extract_dependencies map per_proj_dir Bsb_build_schemas.dependencies
+      in
+      if dependencies == [] then
+        extract_dependencies map per_proj_dir Bsb_build_schemas.bs_dependencies
+      else dependencies
     in
     let bs_dev_dependencies =
       match package_kind with
       | Toplevel ->
-        extract_dependencies map per_proj_dir
-          Bsb_build_schemas.bs_dev_dependencies
+        let dev_dependencies =
+          extract_dependencies map per_proj_dir
+            Bsb_build_schemas.dev_dependencies
+        in
+        if dev_dependencies == [] then
+          extract_dependencies map per_proj_dir
+            Bsb_build_schemas.bs_dev_dependencies
+        else dev_dependencies
       | Dependency _ -> []
     in
     match map.?(Bsb_build_schemas.sources) with
@@ -258,7 +269,14 @@ let interpret_json ~(filename : string) ~(json : Ext_json_types.t)
           (* ~namespace *)
           sources
       in
-      let bsc_flags = extract_string_list map Bsb_build_schemas.bsc_flags in
+      let bsc_flags =
+        let compiler_flags =
+          extract_string_list map Bsb_build_schemas.compiler_flags
+        in
+        if compiler_flags == [] then
+          extract_string_list map Bsb_build_schemas.bsc_flags
+        else compiler_flags
+      in
       let jsx = Bsb_jsx.from_map map in
       let jsx, bsc_flags =
         match package_kind with

diff --git a/docs/JSXV4.md b/docs/JSXV4.md
@@ -27,7 +27,7 @@ For example, suppose a V3 project uses rescript-react 0.11, which requires compa
   "version": 3,
   "v3-dependencies": ["rescript-react-native", "rescript-react-navigation"]
 },
-"bsc-flags": ["-open ReactV3"]
+"compiler-flags": ["-open ReactV3"]
 ```
 
 Another example is a V4 project that also uses `"rescript-react-native", "rescript-react-navigation"`. Then the setting will be:

diff --git a/packages/playground/rescript.json b/packages/playground/rescript.json
@@ -10,7 +10,7 @@
     "in-source": false,
     "suffix": ".res.js"
   },
-  "bs-dependencies": [
+  "dependencies": [
     "@rescript/react"
   ]
 }
diff --git a/packages/playground/scripts/generate_cmijs.mjs b/packages/playground/scripts/generate_cmijs.mjs
@@ -30,7 +30,7 @@ exec("yarn rescript legacy");
 // Otherwise we can't use them for compilation within the playground.
 buildCmij(compilerRootDir, "compiler-builtins");
 
-const packages = resConfig["bs-dependencies"];
+const packages = resConfig["dependencies"];
 for (const pkgName of packages) {
   buildCmij(
     path.join(compilerRootDir, "node_modules", pkgName),

diff --git a/rescript.json b/rescript.json
@@ -1,4 +1,4 @@
 {
   "name": "rescript",
-  "bs-dependencies": ["@tests/gentype-react-example"]
+  "dependencies": ["@tests/gentype-react-example"]
 }
diff --git a/rewatch/CompilerConfigurationSpec.md b/rewatch/CompilerConfigurationSpec.md
@@ -13,13 +13,13 @@ This document contains a list of all bsconfig parameters with remarks, and wheth
 | sources              | Source                  |        |     [x]      |
 | sources              | array of Source         |        |     [x]      |
 | ignored-dirs         | array of string         |        |     [_]      |
-| bs-dependencies      | array of string         |        |     [x]      |
-| bs-dev-dependencies  | array of string         |        |     [x]      |
+| dependencies         | array of string         |        |     [x]      |
+| dev-dependencies     | array of string         |        |     [x]      |
 | generators           | array of Rule-Generator |        |     [_]      |
 | cut-generators       | boolean                 |        |     [_]      |
 | jsx                  | JSX                     |        |     [x]      |
 | gentypeconfig        | Gentype                 |        |     [_]      |
-| bsc-flags            | array of string         |        |     [x]      |
+| compiler-flags       | array of string         |        |     [x]      |
 | warnings             | Warnings                |        |     [x]      |
 | ppx-flags            | array of string         |        |     [x]      |
 | pp-flags             | array of string         |        |     [_]      |

diff --git a/rewatch/src/config.rs b/rewatch/src/config.rs
@@ -655,7 +655,7 @@ pub mod tests {
             "sources": [ { "dir": "src/", "subdirs": true } ],
             "package-specs": [ { "module": "es6", "in-source": true } ],
             "suffix": ".mjs",
-            "bs-dependencies": [ "@teamwalnut/app" ]
+            "dependencies": [ "@teamwalnut/app" ]
         }
         "#;
 
@@ -683,7 +683,7 @@ pub mod tests {
             "module": "esmodule",
             "in-source": true
           },
-          "bs-dev-dependencies": ["@rescript/tools"],
+          "dev-dependencies": ["@rescript/tools"],
           "warnings": {
             "error": "+101"
           }
@@ -714,7 +714,7 @@ pub mod tests {
               "module": "esmodule",
               "in-source": true
             },
-            "bs-dev-dependencies": ["@rescript/tools"],
+            "dev-dependencies": ["@rescript/tools"],
             "suffix": ".mjs",
             "warnings": {
               "error": "+101"
@@ -742,7 +742,7 @@ pub mod tests {
             "sources": [ { "dir": "src/", "subdirs": true } ],
             "package-specs": [ { "module": "es6", "in-source": true } ],
             "suffix": ".mjs",
-            "bs-dependencies": [ "@teamwalnut/app" ],
+            "dependencies": [ "@teamwalnut/app" ],
             "gentypeconfig": {
                 "module": "esmodule",
                 "generatedFileExtension": ".gen.tsx"
@@ -763,7 +763,7 @@ pub mod tests {
             "sources": [ { "dir": "src/", "subdirs": true } ],
             "package-specs": [ { "module": "es6", "in-source": true } ],
             "suffix": ".mjs",
-            "bs-dependencies": [ "@teamwalnut/app" ],
+            "dependencies": [ "@teamwalnut/app" ],
             "jsx": {
                 "module": "Voby.JSX"
             }
@@ -792,7 +792,7 @@ pub mod tests {
             "sources": [ { "dir": "src/", "subdirs": true } ],
             "package-specs": [ { "module": "es6", "in-source": true } ],
             "suffix": ".mjs",
-            "bs-dependencies": [ "@teamwalnut/app" ],
+            "dependencies": [ "@teamwalnut/app" ],
             "jsx": { "version": 4, "preserve": true }
         }
         "#;

diff --git a/rewatch/testrepo/packages/file-casing/rescript.json b/rewatch/testrepo/packages/file-casing/rescript.json
@@ -14,7 +14,7 @@
   ],
   "suffix": ".mjs",
   "dependencies": [],
-  "bsc-flags": [],
+  "compiler-flags": [],
   "jsx": {
     "version": 4
   }

diff --git a/rewatch/tests/compile.sh b/rewatch/tests/compile.sh
@@ -78,7 +78,7 @@ rewatch build --snapshot-output &> ../tests/snapshots/dependency-cycle.txt
 normalize_paths ../tests/snapshots/dependency-cycle.txt
 git checkout -- packages/new-namespace/src/NS_alias.res
 
-# this should not compile because  "@rescript/webapi" is part of bs-dev-dependencies
+# this should not compile because  "@rescript/webapi" is part of dev-dependencies
 # and FileToTest.res is not listed as "type":"dev"
 echo 'open WebAPI' >> packages/with-dev-deps/src/FileToTest.res
 rewatch build --snapshot-output &> ../tests/snapshots/bs-dev-dependency-used-by-non-dev-source.txt

diff --git a/runtime/Belt.res b/runtime/Belt.res
@@ -52,7 +52,7 @@ If you want to open Belt globally for all files in your project instead, you can
 
 ```json
 {
-  "bsc-flags": ["-open Belt"]
+  "compiler-flags": ["-open Belt"]
 }
 ```
 

diff --git a/runtime/rescript.json b/runtime/rescript.json
@@ -15,7 +15,7 @@
       "in-source": false
     }
   ],
-  "bsc-flags": [
+  "compiler-flags": [
     "-make-runtime",
     "-nostdlib",
     "-nopervasives",

diff --git a/scripts/res/rescript.json b/scripts/res/rescript.json
@@ -6,7 +6,7 @@
       "dir": "./"
     }
   ],
-  "bs-dependencies": ["@tests/docstring-tests"],
+  "dependencies": ["@tests/docstring-tests"],
   "package-specs": {
     "module": "esmodule",
     "in-source": true

diff --git a/tests/analysis_tests/tests-generic-jsx-transform/rescript.json b/tests/analysis_tests/tests-generic-jsx-transform/rescript.json
@@ -6,6 +6,6 @@
       "subdirs": true
     }
   ],
-  "bsc-flags": ["-w -33-44-8"],
+  "compiler-flags": ["-w -33-44-8"],
   "jsx": { "module": "GenericJsx" }
 }
diff --git a/tests/analysis_tests/tests-incremental-typechecking/rescript.json b/tests/analysis_tests/tests-incremental-typechecking/rescript.json
@@ -6,6 +6,6 @@
       "subdirs": true
     }
   ],
-  "bsc-flags": ["-w -33-44-8"],
+  "compiler-flags": ["-w -33-44-8"],
   "jsx": { "module": "GenericJsx" }
 }
diff --git a/tests/analysis_tests/tests-reanalyze/deadcode/rescript.json b/tests/analysis_tests/tests-reanalyze/deadcode/rescript.json
@@ -7,7 +7,7 @@
   },
   "name": "sample-typescript-app",
   "jsx": { "version": 4 },
-  "bs-dependencies": ["@rescript/react"],
+  "dependencies": ["@rescript/react"],
   "sources": [
     {
       "dir": "src",

diff --git a/tests/analysis_tests/tests-reanalyze/termination/rescript.json b/tests/analysis_tests/tests-reanalyze/termination/rescript.json
@@ -5,7 +5,7 @@
     "unsuppress": []
   },
   "name": "arnold",
-  "bs-dependencies": [],
+  "dependencies": [],
   "sources": [
     {
       "dir": "src",

diff --git a/tests/analysis_tests/tests/rescript.json b/tests/analysis_tests/tests/rescript.json
@@ -9,8 +9,8 @@
       "subdirs": true
     }
   ],
-  "bsc-flags": ["-w -33-44-8"],
-  "bs-dependencies": ["@rescript/react"],
+  "compiler-flags": ["-w -33-44-8"],
+  "dependencies": ["@rescript/react"],
   "jsx": { "version": 4 },
   "suffix": ".res.js",
   "editor": {

diff --git a/tests/build_tests/case/rescript.json b/tests/build_tests/case/rescript.json
@@ -2,5 +2,5 @@
   "name": "case",
   "version": "0.1.0",
   "sources": ["src"],
-  "bs-dependencies": []
+  "dependencies": []
 }
diff --git a/tests/build_tests/case2/rescript.json b/tests/build_tests/case2/rescript.json
@@ -2,5 +2,5 @@
   "name": "case2",
   "version": "0.1.0",
   "sources": ["src"],
-  "bs-dependencies": []
+  "dependencies": []
 }
diff --git a/tests/build_tests/case3/rescript.json b/tests/build_tests/case3/rescript.json
@@ -10,6 +10,6 @@
     "in-source": true
   },
   "suffix": ".res.js",
-  "bs-dependencies": [],
+  "dependencies": [],
   "warnings": { "error": "+101" }
 }
diff --git a/tests/build_tests/custom_namespace/rescript.json b/tests/build_tests/custom_namespace/rescript.json
@@ -11,7 +11,7 @@
     "in-source": true,
     "suffix": ".res.js"
   },
-  "bsc-flags": ["-bs-no-version-header"],
+  "compiler-flags": ["-bs-no-version-header"],
   "warnings": {
     "number": "-40+6+7",
     "error": true

diff --git a/tests/build_tests/cycle/rescript.json b/tests/build_tests/cycle/rescript.json
@@ -10,6 +10,6 @@
     "in-source": true,
     "suffix": ".res.js"
   },
-  "bs-dependencies": [],
+  "dependencies": [],
   "warnings": { "error": "+101" }
 }
diff --git a/tests/build_tests/duplicated_symlinked_packages/a/rescript.json b/tests/build_tests/duplicated_symlinked_packages/a/rescript.json
@@ -10,7 +10,7 @@
     "in-source": true,
     "suffix": ".res.js"
   },
-  "bs-dependencies": ["c", "z"],
+  "dependencies": ["c", "z"],
   "warnings": { "error": "+101" },
   "namespace": true
 }
diff --git a/tests/build_tests/duplicated_symlinked_packages/b/rescript.json b/tests/build_tests/duplicated_symlinked_packages/b/rescript.json
@@ -10,7 +10,7 @@
     "in-source": true,
     "suffix": ".res.js"
   },
-  "bs-dependencies": ["c"],
+  "dependencies": ["c"],
   "warnings": { "error": "+101" },
   "namespace": true
 }
diff --git a/tests/build_tests/duplicated_symlinked_packages/rescript.json b/tests/build_tests/duplicated_symlinked_packages/rescript.json
@@ -2,5 +2,5 @@
   "name": "duplicated-symlinked-packages",
   "version": "0.1.0",
   "sources": ["src"],
-  "bs-dependencies": ["a", "b", "z"]
+  "dependencies": ["a", "b", "z"]
 }
diff --git a/tests/build_tests/install/rescript.json b/tests/build_tests/install/rescript.json
@@ -10,6 +10,6 @@
     "in-source": true,
     "suffix": ".res.js"
   },
-  "bs-dependencies": [],
+  "dependencies": [],
   "warnings": { "error": "+101" }
 }
diff --git a/tests/build_tests/jsx_settings_inheritance/rescript.json b/tests/build_tests/jsx_settings_inheritance/rescript.json
@@ -14,5 +14,5 @@
     "suffix": ".res.js"
   },
   "namespace": true,
-  "bs-dependencies": ["@rescript/react", "a", "b"]
+  "dependencies": ["@rescript/react", "a", "b"]
 }
diff --git a/tests/build_tests/rerror/rescript.json b/tests/build_tests/rerror/rescript.json
@@ -2,5 +2,5 @@
   "name": "rerror",
   "version": "0.1.0",
   "sources": ["src"],
-  "bs-dependencies": []
+  "dependencies": []
 }
-Original file line number
+Diff line change
@@ Expand Up @@
     ```json
     {
-      "bsc-flags": ["-open Belt"]
+      "compiler-flags": ["-open Belt"]
     }
     ```
@@ Expand Down @@