Add native bridge APIs for JASP replay

.Rbuildignore

@@ -1,3 +1,15 @@
+^renv$
+^renv\.lock$
+^\.Rprofile$
 ^.*\.Rproj$
 ^\.Rproj\.user$
 ^\.travis\.yml$
+^\.github$
+^\.editorconfig$
+^demo\.R$
+^inst/libs$
+^src/Makevars$
+^src/Makevars\.win$
+^src/SyntaxInterface\.provenance$
+^src/syntaxbridge_interface\.h$
+^src/json$

.gitattributes

@@ -0,0 +1,3 @@
+configure text eol=lf
+configure.win text eol=lf
+*.sh text eol=lf

.github/workflows/build-syntaxinterface.yml

@@ -217,6 +217,8 @@ jobs:
             -DCMAKE_BUILD_TYPE=Release \
             -DCMAKE_PREFIX_PATH="${{ github.workspace }}/qt-static" \
             -DCUSTOM_R_PATH="${R_HOME}" \
+            -DREQUIRE_GITHUB_PAT=OFF \
+            -DJASP_SYNTAX_INTERFACE_ONLY=ON \
             -DINSTALL_R_MODULES=OFF \
             -DBUILD_TESTS=OFF
 
@@ -235,6 +237,7 @@ jobs:
             -DBUILD_TESTS=OFF
 
       - name: Build SyntaxInterface
+        if: runner.os != 'Windows'
         shell: bash
         run: cmake --build build --target SyntaxInterface --parallel
 
@@ -270,6 +273,25 @@ jobs:
             cp build/R-Interface/libR-InterfaceNoRInside.dll libR-InterfaceNoRInside-windows-x86_64.dll
           fi
 
+      - name: Collect SyntaxInterface source bundle
+        if: runner.os == 'Linux' && matrix.arch == 'x86_64'
+        shell: bash
+        run: |
+          mkdir -p syntaxinterface-sources/SyntaxInterface syntaxinterface-sources/Common/json
+          {
+            echo "schema=1"
+            echo "jasp_desktop_ref=${{ env.JASP_DESKTOP_REF }}"
+            echo "jasp_desktop_sha=$(git -C jasp-desktop rev-parse HEAD)"
+            echo "jasp_syntax_sha=$(git rev-parse HEAD)"
+            echo "qt_version=${{ env.QT_VERSION }}"
+            echo "qt_submodules=${{ env.QT_SUBMODULES }}"
+          } > syntaxinterface-sources/BUILD_PROVENANCE
+          cp jasp-desktop/SyntaxInterface/syntaxbridge_interface.h syntaxinterface-sources/SyntaxInterface/
+          for file in allocator.h assertions.h config.h forwards.h json.h json_features.h json_reader.cpp json_tool.h json_value.cpp json_valueiterator.inl json_writer.cpp reader.h value.h version.h writer.h; do
+            cp "jasp-desktop/Common/json/${file}" "syntaxinterface-sources/Common/json/${file}"
+          done
+          tar -czf SyntaxInterface-sources.tar.gz -C syntaxinterface-sources .
+
       - name: Upload artifact
         uses: actions/upload-artifact@v7
         with:
@@ -279,6 +301,14 @@ jobs:
             libR-InterfaceNoRInside-windows-*.dll
           if-no-files-found: error
 
+      - name: Upload SyntaxInterface source bundle
+        if: runner.os == 'Linux' && matrix.arch == 'x86_64'
+        uses: actions/upload-artifact@v7
+        with:
+          name: SyntaxInterface-sources
+          path: SyntaxInterface-sources.tar.gz
+          if-no-files-found: error
+
   # ---------------------------------------------------------------------------
   release:
     needs: build
@@ -300,18 +330,32 @@ jobs:
       - name: Show checksums
         run: cat libs/SHA256SUMS
 
+      - name: Write release notes
+        shell: bash
+        run: |
+          tar -xOf libs/SyntaxInterface-sources.tar.gz ./BUILD_PROVENANCE > BUILD_PROVENANCE
+          JASP_DESKTOP_REF=$(grep -E '^jasp_desktop_ref=' BUILD_PROVENANCE | sed -E 's/^[^=]+=//')
+          JASP_DESKTOP_SHA=$(grep -E '^jasp_desktop_sha=' BUILD_PROVENANCE | sed -E 's/^[^=]+=//')
+          JASP_SYNTAX_SHA=$(grep -E '^jasp_syntax_sha=' BUILD_PROVENANCE | sed -E 's/^[^=]+=//')
+          QT_VERSION=$(grep -E '^qt_version=' BUILD_PROVENANCE | sed -E 's/^[^=]+=//')
+          QT_SUBMODULES=$(grep -E '^qt_submodules=' BUILD_PROVENANCE | sed -E 's/^[^=]+=//')
+          cat > release-body.md <<EOF
+          Pre-built \`libSyntaxInterface\` binaries for use by \`jaspSyntax\`.
+
+          Built from [jasp-desktop@${JASP_DESKTOP_REF}](https://github.com/jasp-stats/jasp-desktop/tree/${JASP_DESKTOP_REF}).
+          Resolved jasp-desktop SHA: \`${JASP_DESKTOP_SHA}\`
+          jaspSyntax workflow SHA: \`${JASP_SYNTAX_SHA}\`
+          Qt version: ${QT_VERSION} (static, submodules: ${QT_SUBMODULES}).
+
+          These are downloaded automatically by the \`configure\` script during \`install.packages("jaspSyntax")\`.
+          EOF
+
       - name: Create or update release
         uses: softprops/action-gh-release@v2
         with:
           tag_name: ${{ env.RELEASE_TAG }}
           name: "SyntaxInterface pre-built libraries"
-          body: |
-            Pre-built `libSyntaxInterface` binaries for use by `jaspSyntax`.
-
-            Built from [jasp-desktop@${{ env.JASP_DESKTOP_REF }}](https://github.com/jasp-stats/jasp-desktop/tree/${{ env.JASP_DESKTOP_REF }}).
-            Qt version: ${{ env.QT_VERSION }} (static, submodules: ${{ env.QT_SUBMODULES }}).
-
-            These are downloaded automatically by the `configure` script during `install.packages("jaspSyntax")`.
+          body_path: release-body.md
           files: libs/*
           draft: false
           prerelease: false

.github/workflows/i18nCheck.yml

@@ -1,10 +1,10 @@
-on: 
+on:
 #  push:
 #    paths: ['**.R', '**.qml', '**.po', '**.yml']
-# 
+#
 #  pull_request:
 #    paths: ['**.R', '**.qml', '**.po', '**.yml']
-#  
+#
   workflow_dispatch:
 
 name: i18n-check

.gitignore

@@ -62,4 +62,6 @@ Thumbs.db
 src/Makevars
 src/Makevars.win
 src/syntaxbridge_interface.h
+src/SyntaxInterface.provenance
 src/json/*
+inst/libs/

DESCRIPTION

@@ -1,12 +1,23 @@
 Package: jaspSyntax
 Type: Package
 Title: Makes JASP analyses available in R
-Version: 1.2
-Date: 2020-12-01
+Version: 1.3.2
+Date: 2026-05-11
 Author: JASP Team
 Website: jasp-stats.org
 Maintainer: JASP Team <info@jasp-stats.org>
-Description: Set up the right options for the analysis by loading its QML Form, and set up the R environment so that it can run the analysis as if it was run by JASP
+Description: Exposes the native JASP SyntaxInterface bridge to R so package code can parse module descriptions, replay QML option binding, load datasets, and read saved .jasp files using the same runtime preparation path as JASP Desktop.
 License: GPL (>= 2)
-Imports: Rcpp (>= 1.0.5)
+Encoding: UTF-8
+URL: https://github.com/jasp-stats/jaspSyntax
+BugReports: https://github.com/jasp-stats/jaspSyntax/issues
+SystemRequirements: libcurl or wget (for downloading the SyntaxInterface library during installation)
+Imports:
+    callr,
+    jsonlite,
+    Rcpp (>= 1.0.5)
+Suggests:
+    pkgload,
+    testthat
 LinkingTo: Rcpp
+RoxygenNote: 7.3.3

NAMESPACE

@@ -1,3 +1,32 @@
 useDynLib(jaspSyntax, .registration=TRUE)
-exportPattern("^[[:alpha:]]+")
 importFrom(Rcpp, evalCpp)
+export(analysisOptionsFromJaspFile)
+export(analysisOptionsFromQml)
+export(clearDatasetState)
+export(clearNativeState)
+export(clearQmlForms)
+export(cleanUp)
+export(columnMapping)
+export(decodeAnalysisResults)
+export(decodeColumnNames)
+export(generateAnalysisWrapper)
+export(generateModuleWrappers)
+export(getVariableNames)
+export(loadAnalysisDataset)
+export(loadDataSet)
+export(loadDataSetFromJaspFile)
+export(loadQmlAndParseOptions)
+export(nativeBridgeProvenance)
+export(parseDescription)
+export(parseModuleDescription)
+export(parseQmlOptions)
+export(readAnalysisOptionsFromJaspFile)
+export(readAnalysisOptionsFromQml)
+export(readDatasetHeader)
+export(readDatasetFromJaspFile)
+export(readDefaultAnalysisOptions)
+export(readLoadedDataset)
+export(readModuleDescription)
+export(readRequestedDataset)
+export(resolveAnalysisQml)
+export(setParameter)

R/RcppExports.R

@@ -5,6 +5,22 @@ cleanUp <- function() {
     invisible(.Call(`_jaspSyntax_cleanUp`))
 }
 
+shutdownNative <- function() {
+    invisible(.Call(`_jaspSyntax_shutdownNative`))
+}
+
+clearQmlFormsNative <- function() {
+    invisible(.Call(`_jaspSyntax_clearQmlFormsNative`))
+}
+
+clearDatasetStateNative <- function() {
+    invisible(.Call(`_jaspSyntax_clearDatasetStateNative`))
+}
+
+clearNativeStateNative <- function() {
+    invisible(.Call(`_jaspSyntax_clearNativeStateNative`))
+}
+
 setParameter <- function(name, value) {
     .Call(`_jaspSyntax_setParameter`, name, value)
 }