[mercury] The Mercury implementation is divided into the @genexus/mercury-build and @genexus/mercury-cli packages. Additionally, the @genexus/vite-plugin-mercury package has been added to facilitate configuration in Vite-based environments

.github/workflows/install-and-deploy.yml

@@ -62,7 +62,7 @@ jobs:
         uses: actions/cache@2f8e54208210a422b2efd51efaa6bd6d7ca8920f
         with:
           path: ~/.bun/install/cache
-          key: ${{ runner.os }}-bun-${{ hashFiles('''**/bun.lockb''') }}
+          key: ${{ runner.os }}-bun-${{ hashFiles('**/bun.lockb') }}
           restore-keys: |
             ${{ runner.os }}-bun-
 
@@ -76,6 +76,26 @@ jobs:
       #   if: ${{ inputs.common-tests == true }}
       #   run: bun test.common.ci
 
+      # We need to pre-build Mercury, because the mercury-build package needs it.
+      # TODO: We should eliminate this "cycle dependency" in the future.
+      - name: Prebuild Mercury
+        run: bun build.js
+        working-directory: "packages/mercury"
+
+      # Test if the @genexus/mercury-build, @genexus/mercury-cli, and @genexus/vite-plugin-mercury packages are built correctly.
+      - name: Build genexus/mercury-build
+        run: bun dev
+        working-directory: "packages/mercury-build"
+
+      - name: Build genexus/mercury-cli
+        run: bun dev
+        working-directory: "packages/mercury-cli"
+
+      - name: Build genexus/vite-plugin-mercury
+        run: bun dev
+        working-directory: "packages/mercury-plugins/vite-plugin-mercury"
+
+      # The validate.ci for Mercury needs to be run after building the three packages above.
       - name: Run tests
         run: bun validate.ci
         working-directory: ${{ inputs.package }}

.github/workflows/node.js.yml

@@ -27,6 +27,24 @@ jobs:
       publish: false
       package: "packages/mercury"
 
+  mercury-build:
+    uses: ./.github/workflows/install-and-deploy.yml
+    with:
+      node-version: "22.x"
+      cache: true
+      common-tests: false
+      publish: false
+      package: "packages/mercury-build"
+
+  mercury-cli:
+    uses: ./.github/workflows/install-and-deploy.yml
+    with:
+      node-version: "22.x"
+      cache: true
+      common-tests: false
+      publish: false
+      package: "packages/mercury-cli"
+
   svg-sass-generator:
     uses: ./.github/workflows/install-and-deploy.yml
     with:
@@ -35,3 +53,13 @@ jobs:
       common-tests: false
       publish: false
       package: "packages/svg-sass-generator"
+
+  vite-plugin-mercury:
+    uses: ./.github/workflows/install-and-deploy.yml
+    with:
+      node-version: "22.x"
+      cache: true
+      common-tests: false
+      publish: false
+      package: "packages/mercury-plugins/vite-plugin-mercury"
+

.github/workflows/npmpublish.yml

@@ -11,7 +11,10 @@
     outputs:
       unanimo-changed: ${{ steps.check-unanimo.outputs.version-changed }}
       mercury-changed: ${{ steps.check-mercury.outputs.version-changed }}
+      mercury-build-changed: ${{ steps.check-mercury-build.outputs.version-changed }}
+      mercury-cli-changed: ${{ steps.check-mercury-cli.outputs.version-changed }}
       svg-sass-generator-changed: ${{ steps.check-svg-sass-generator.outputs.version-changed }}
+      vite-plugin-mercury-changed: ${{ steps.check-vite-plugin-mercury.outputs.version-changed }}
     steps:
       # Pinning to a specific commit hash for security reasons.
       # This hash corresponds to version 4.3.0 of the actions/checkout action.
@@ -34,18 +37,42 @@
           LATEST_MERCURY_VERSION=$(curl -s https://registry.npmjs.org/$PACKAGE_NAME | jq -r '.["dist-tags"].latest')
           echo "latest_mercury_version=$LATEST_MERCURY_VERSION" >> $GITHUB_ENV
 
+      - name: Get the latest mercury-build version
+        id: get-latest-mercury-build-version
+        run: |
+          PACKAGE_NAME=@genexus/mercury-build
+          LATEST_MERCURY_BUILD_VERSION=$(curl -s https://registry.npmjs.org/$PACKAGE_NAME | jq -r '.["dist-tags"].latest')
+          echo "latest_mercury_build_version=$LATEST_MERCURY_BUILD_VERSION" >> $GITHUB_ENV
+
+      - name: Get the latest mercury-cli version
+        id: get-latest-mercury-cli-version
+        run: |
+          PACKAGE_NAME=@genexus/mercury-cli
+          LATEST_MERCURY_CLI_VERSION=$(curl -s https://registry.npmjs.org/$PACKAGE_NAME | jq -r '.["dist-tags"].latest')
+          echo "latest_mercury_cli_version=$LATEST_MERCURY_CLI_VERSION" >> $GITHUB_ENV
+
       - name: Get the latest SVG_Generator version
         id: get-latest-svg_generator-version
         run: |
           PACKAGE_NAME=@genexus/svg-sass-generator
           LATEST_SVG_GENERATOR_VERSION=$(curl -s https://registry.npmjs.org/$PACKAGE_NAME | jq -r '.["dist-tags"].latest')
           echo "latest_svg_generator_version=$LATEST_SVG_GENERATOR_VERSION" >> $GITHUB_ENV
 
+      - name: Get the latest vite-plugin-mercury version
+        id: get-latest-vite-plugin-mercury-version
+        run: |
+          PACKAGE_NAME=@genexus/vite-plugin-mercury
+          LATEST_VITE_PLUGIN_MERCURY_VERSION=$(curl -s https://registry.npmjs.org/$PACKAGE_NAME | jq -r '.["dist-tags"].latest')
+          echo "latest_vite_plugin_mercury_version=$LATEST_VITE_PLUGIN_MERCURY_VERSION" >> $GITHUB_ENV
+
       - name: Print last published versions
         run: |
           echo "The latest Unanimo version is ${{ env.latest_unanimo_version }}"
           echo "The latest Mercury version is ${{ env.latest_mercury_version }}"
+          echo "The latest mercury-build version is ${{ env.latest_mercury_build_version }}"
+          echo "The latest mercury-cli version is ${{ env.latest_mercury_cli_version }}"
           echo "The latest SVG Generator version is ${{ env.latest_svg_generator_version }}"
+          echo "The latest vite-plugin-mercury version is ${{ env.latest_vite_plugin_mercury_version }}"
 
       - name: Check if `unanimo` version changed
         id: check-unanimo
@@ -71,6 +98,30 @@
             echo "version-changed=false" >> $GITHUB_OUTPUT
           fi
 
+      - name: Check if `mercury-build` version changed
+        id: check-mercury-build
+        run: |
+          CURRENT_VERSION=$(jq -r .version packages/mercury-build/package.json)
+          PREVIOUS_VERSION=${{ env.latest_mercury_build_version }}
+          if [ "$CURRENT_VERSION" != "$PREVIOUS_VERSION" ]; then
+            echo "Version changed!"
+            echo "version-changed=true" >> $GITHUB_OUTPUT
+          else
+            echo "version-changed=false" >> $GITHUB_OUTPUT
+          fi
+
+      - name: Check if `mercury-cli` version changed
+        id: check-mercury-cli
+        run: |
+          CURRENT_VERSION=$(jq -r .version packages/mercury-cli/package.json)
+          PREVIOUS_VERSION=${{ env.latest_mercury_cli_version }}
+          if [ "$CURRENT_VERSION" != "$PREVIOUS_VERSION" ]; then
+            echo "Version changed!"
+            echo "version-changed=true" >> $GITHUB_OUTPUT
+          else
+            echo "version-changed=false" >> $GITHUB_OUTPUT
+          fi
+
       - name: Check if `svg-sass-generator` version changed
         id: check-svg-sass-generator
         run: |
@@ -83,6 +134,18 @@
             echo "version-changed=false" >> $GITHUB_OUTPUT
           fi
 
+      - name: Check if `vite-plugin-mercury` version changed
+        id: check-vite-plugin-mercury
+        run: |
+          CURRENT_VERSION=$(jq -r .version packages/mercury-plugins/vite-plugin-mercury/package.json)
+          PREVIOUS_VERSION=${{ env.latest_vite_plugin_mercury_version }}
+          if [ "$CURRENT_VERSION" != "$PREVIOUS_VERSION" ]; then
+            echo "Version changed!"
+            echo "version-changed=true" >> $GITHUB_OUTPUT
+          else
+            echo "version-changed=false" >> $GITHUB_OUTPUT
+          fi
+
   publish-unanimo:
     needs: check-version
     if: needs.check-version.outputs.unanimo-changed == 'true'
@@ -107,7 +170,31 @@
       package: "packages/mercury"
     secrets: inherit
 
+  publish-mercury-build:
+    needs: check-version
+    if: needs.check-version.outputs.mercury-build-changed == 'true'
+    uses: ./.github/workflows/install-and-deploy.yml
+    with:
+      node-version: "22.x"
+      cache: false
+      common-tests: false
+      publish: true
+      package: "packages/mercury-build"
+    secrets: inherit
+
+  publish-mercury-cli:
+    needs: check-version
+    if: needs.check-version.outputs.mercury-cli-changed == 'true'
+    uses: ./.github/workflows/install-and-deploy.yml
+    with:
+      node-version: "22.x"
+      cache: false
+      common-tests: false
+      publish: true
+      package: "packages/mercury-cli"
+    secrets: inherit
+
   publish-svg-sass-generator:
     needs: check-version
     if: needs.check-version.outputs.svg-sass-generator-changed == 'true'
     uses: ./.github/workflows/install-and-deploy.yml
@@ -118,3 +205,16 @@
       publish: true
       package: "packages/svg-sass-generator"
     secrets: inherit
+
+  publish-vite-plugin-mercury:
+    needs: check-version
+    if: needs.check-version.outputs.vite-plugin-mercury-changed == 'true'
+    uses: ./.github/workflows/install-and-deploy.yml
+    with:
+      node-version: "22.x"
+      cache: false
+      common-tests: false
+      publish: true
+      package: "packages/mercury-plugins/vite-plugin-mercury"
+    secrets: inherit
+

README.md

@@ -24,16 +24,10 @@ To see the documentation and examples of how to use Mercury, visit the [showcase
   npm i bun -g
   ```
 
-- To start the showcase, run:
+- To start the showcase which automatically rebuilds Mercury, run:
 
   ```bash
-  bun start.watch
-  ```
-
-- To automatically build Mercury, run:
-
-  ```bash
-  bun build.mer.watch
+  bun start
   ```
 
 - To automatically build Unanimo, run: