Add JsOptions test, use 3.14 as min required cabal version

Author: Swordlash

Cabal-syntax/src/Distribution/PackageDescription/FieldGrammar.hs

@@ -622,6 +622,7 @@ buildInfoFieldGrammar =
     <*> monoidalFieldAla "cxx-options" (alaList' NoCommaFSep Token') L.cxxOptions
       ^^^ availableSince CabalSpecV2_2 []
     <*> monoidalFieldAla "js-options" (alaList' NoCommaFSep Token') L.jsOptions
+      ^^^ availableSince CabalSpecV3_14 []
     <*> monoidalFieldAla "ld-options" (alaList' NoCommaFSep Token') L.ldOptions
     <*> monoidalFieldAla "hsc2hs-options" (alaList' NoCommaFSep Token') L.hsc2hsOptions
       ^^^ availableSince CabalSpecV3_6 []

cabal-testsuite/PackageTests/JS/JsOptions/cabal.project

@@ -0,0 +1 @@
+packages: .

cabal-testsuite/PackageTests/JS/JsOptions/demo/Main.hs

@@ -0,0 +1,6 @@
+module Main where
+
+import Lib
+
+main :: IO ()
+main = foo

cabal-testsuite/PackageTests/JS/JsOptions/js.test.hs

@@ -0,0 +1,9 @@
+import Test.Cabal.Prelude
+
+main = do
+    skipUnlessJavaScript
+    skipIfWindows ""
+    setupAndCabalTest $ do
+        skipUnlessGhcVersion ">= 9.12"
+        res <- cabal' "v2-run" ["demo"]
+        assertOutputContains "Hello definition!" res

cabal-testsuite/PackageTests/JS/JsOptions/jsbits/lib.js

@@ -0,0 +1,9 @@
+//#OPTIONS: CPP
+
+function foo() {
+#ifdef PRINT_DEF
+  console.log("Hello definition!");
+#else
+  console.log("Hello!");
+#endif
+}

cabal-testsuite/PackageTests/JS/JsOptions/jsoptions.cabal

@@ -0,0 +1,19 @@
+cabal-version: 3.14
+name: jsoptions
+version: 0
+build-type: Simple
+
+library
+  default-language: Haskell2010
+  exposed-modules: Lib
+  build-depends: base
+
+  if impl(javascript)
+    js-sources: jsbits/lib.js
+    js-options: -optJSP-DPRINT_DEF
+
+executable demo
+  default-language: Haskell2010
+  main-is: Main.hs
+  hs-source-dirs: demo
+  build-depends: base, jsoptions

cabal-testsuite/PackageTests/JS/JsOptions/other-arch.out

@@ -0,0 +1,14 @@
+# cabal v2-run
+Configuration is affected by the following files:
+- cabal.project
+Resolving dependencies...
+Build profile: -w ghc-<GHCVER> -O1
+In order, the following will be built:
+ - jsoptions-exe-0 (lib) (first run)
+ - jsoptions-exe-0 (exe:demo) (first run)
+Configuring library for jsoptions-exe-0...
+Preprocessing library for jsoptions-exe-0...
+Building library for jsoptions-exe-0...
+Configuring executable 'demo' for jsoptions-exe-0...
+Preprocessing executable 'demo' for jsoptions-exe-0...
+Building executable 'demo' for jsoptions-exe-0...

cabal-testsuite/PackageTests/JS/JsOptions/other-arch.test.hs

@@ -0,0 +1,8 @@
+import Test.Cabal.Prelude
+
+main = do
+    skipIfJavaScript
+    cabalTest $ do
+        -- Ensure the field `js-options` does not raise issues
+        res <- cabal' "v2-run" ["demo"]
+        assertOutputContains "foo_fallback" res

cabal-testsuite/PackageTests/JS/JsOptions/src/Lib.hs

@@ -0,0 +1,9 @@
+{-# LANGUAGE CPP #-}
+module Lib where
+
+#if defined(javascript_HOST_ARCH)
+foreign import javascript foo :: IO ()
+#else
+foo :: IO ()
+foo = putStrLn "foo_fallback"
+#endif

doc/buildinfo-fields-reference.rst

@@ -271,6 +271,14 @@ cxx-options
     .. math::
         {\left\{ \mathop{\mathit{hs\text{-}string}}\mid{{[\mathop{\mathord{``}\mathtt{\ }\mathord{"}}]^c}}^+_{} \right\}}^\ast_{\bullet}
 
+js-options
+    * Monoidal field
+    * Available since ``cabal-version: 3.14``.
+    * Documentation of :pkg-field:`library:js-options`
+
+    .. math::
+        {\left\{ \mathop{\mathit{hs\text{-}string}}\mid{{[\mathop{\mathord{``}\mathtt{\ }\mathord{"}}]^c}}^+_{} \right\}}^\ast_{\bullet}
+
 cxx-sources
     * Monoidal field
     * Available since ``cabal-version: 2.2``.

editors/vim/syntax/cabal.vim

@@ -67,6 +67,7 @@ syn keyword cabalFieldName contained
   \ copyright
   \ cpp-options
   \ cxx-options
+  \ js-options
   \ cxx-sources
   \ data-dir
   \ data-files