Lara dsl deprecation

.github/copilot-instructions.md

@@ -0,0 +1,100 @@
+# Copilot Instructions for the Clava Repository
+
+## Project Overview
+
+Clava is a modular source-to-source compiler for C, C++, CUDA, and OpenCL, supporting advanced code analysis and transformation. It is implemented using a combination of TypeScript/JavaScript (Node.js), Java, and C++. Clava is designed for composability and reusability, and integrates with the LARA DSL for custom code transformations.
+
+## Development Environment & Setup
+
+- **Node.js Version:** 20 or 22 (required for Clava-JS)
+- **Java Version:** 17+ (required for Java components)
+- **Build System:** Gradle for Java modules, npm for TypeScript/JavaScript
+- **IDE:** VSCode is recommended for development
+
+## Architecture
+
+- **Frontend (C++):**  
+  The `ClangAstDumper` component extracts AST information from Clang-based codebases.
+- **Middle-end (Java):**  
+  Components like `ClangAstParser` and `ClavaWeaver` process ASTs and apply transformations.
+- **API Layer (TypeScript/JavaScript):**  
+  The `Clava-JS` module provides the main user-facing API and runtime, exposing Clava's features to Node.js environments.
+- **Build Integration:**  
+  The `CMake` package enables integration with CMake-based build systems.
+
+### Related Projects
+- **lara-framework**: Core framework providing weaver infrastructure and JavaScript APIs
+- **specs-java-libs**: Java utility libraries used throughout the project
+
+## Key Directories
+
+- `Clava-JS/`: TypeScript/JavaScript API and runtime.
+- `ClavaWeaver/`: Java-based weaving engine.
+- `ClangAstDumper/`: C++ AST dumper using Clang.
+- `ClangAstParser/`: Java AST parser.
+- `ClavaAst/`, `ClavaHls/`, `ClavaLaraApi/`, `AntarexClavaApi/`: Supporting modules for AST, HLS, LARA API, and Antarex integration.
+- `CMake/`: CMake integration scripts and utilities.
+- `docs/`: Documentation, tutorials, and common issues.
+
+## Build and Development
+
+- **Java Components:** Use Gradle (`gradle installDist`) to build Java modules (e.g., ClavaWeaver).
+- **TypeScript/JavaScript:** Use npm scripts (`npm install`, `npm run build`) in `Clava-JS`.
+- **C++ Components:** Use CMake for building and integrating the Clang AST dumper.
+- **Integration:** Copy built Java binaries into `Clava-JS/java-binaries` for full functionality.
+
+## Usage
+
+- **NPM Package:**  
+  Install globally or as a project dependency:  
+  `npm install -g @specs-feup/clava`
+- **CLI:**  
+  Run transformations via `npx clava classic <scriptfile.js> -p "<source files>"`
+- **CMake Integration:**  
+  Use the `clava_weave` CMake command to apply LARA scripts to targets.
+
+## Code Patterns and Conventions
+
+- **Visitor Patterns:**  
+  Used extensively in AST processing (see `ClangAstDumper.h`).
+- **TypeScript API:**  
+  Modular, with clear separation between API (`src-api/`) and code (`src-code/`).
+- **Java:**  
+  Follows standard Gradle project structure.
+- **C++:**  
+  Integrates with Clang/LLVM for AST extraction.
+
+## Common Development Tasks
+
+- Add new AST node support in `ClangAstDumper` and propagate through Java and JS layers.
+- Extend the TypeScript API in `Clava-JS/src-api/`.
+- Create new code transformations as LARA scripts or TypeScript modules.
+- Use provided test scripts and npm/Gradle test commands.
+
+## Dependencies
+
+- **Node.js 20 or 22** and **Java 17+** required.
+- **Clang/LLVM** for AST extraction.
+- **NPM** for JS/TS dependencies.
+- **Gradle** for Java builds.
+- **CMake** for build system integration.
+
+## Troubleshooting
+
+- See `docs/common_issues.md` for frequently encountered problems.
+- Use the GitHub issue tracker for unresolved issues.
+
+## References
+
+- [Clava Documentation](https://specs-feup.github.io/modules/_specs_feup_clava.html)
+- [Clava Project Template](https://github.com/specs-feup/clava-project-template)
+- [Online Demo](https://specs.fe.up.pt/tools/clava/)
+- [Main Repository](https://github.com/specs-feup/clava)
+
+---
+
+**For LLMs:**  
+- Respect the modular structure and language boundaries.
+- When adding features, ensure changes propagate through C++, Java, and JS layers as needed.
+- Follow existing patterns for AST traversal and transformation.
+- Use the provided build and test scripts for validation.

.github/workflows/copilot-setup-steps.yml

@@ -0,0 +1,106 @@
+name: "Copilot Setup Steps"
+
+# Automatically run the setup steps when they are changed
+# Allows for streamlined validation,
+# and allow manual testing through the repository's "Actions" tab
+
+on:
+  workflow_dispatch:
+  push:
+    paths:
+      - .github/workflows/copilot-setup-steps.yml
+  pull_request:
+    paths:
+      - .github/workflows/copilot-setup-steps.yml
+
+env:
+  CLAVA_BRANCH: ${{ github.head_ref || github.ref_name }}
+
+jobs:
+  # The job MUST be called `copilot-setup-steps`
+  # otherwise it will not be picked up by Copilot.
+  copilot-setup-steps:
+    runs-on: ubuntu-latest
+
+    # Permissions set just for the setup steps
+    # Copilot has permissions to its branch
+
+    permissions:
+      # To allow us to clone the repo for setup
+      contents: read
+
+    # The setup steps - install our dependencies
+    steps:
+      - name: Setup Java
+        uses: actions/setup-java@v4
+        with:
+          distribution: 'temurin'
+          java-version: '21'
+
+      - name: Setup Gradle
+        uses: gradle/actions/setup-gradle@v4
+        with:
+          gradle-version: current
+          dependency-graph: generate-and-submit
+
+      - name: Checkout clava
+        uses: actions/checkout@v4
+        with:
+          path: clava
+
+      - name: Determine repository refs
+        id: repo-refs
+        shell: bash
+        env:
+          BRANCH_NAME: ${{ env.CLAVA_BRANCH }}
+        run: |
+          set -euo pipefail
+
+          determine_ref() {
+            local prefix=$1
+            local repo=$2
+            local url="https://github.com/${repo}.git"
+
+            local default_branch
+            default_branch=$(git ls-remote --symref "$url" HEAD | awk '/^ref:/ {print $2}' | sed 's@refs/heads/@@')
+            echo "${prefix}_default=${default_branch}" >> "$GITHUB_OUTPUT"
+            echo "Default branch for ${repo} is '${default_branch}'"
+
+            if git ls-remote --heads "$url" "refs/heads/${BRANCH_NAME}" >/dev/null; then
+              echo "${prefix}_match=true" >> "$GITHUB_OUTPUT"
+              echo "${prefix}_ref=${BRANCH_NAME}" >> "$GITHUB_OUTPUT"
+              echo "Branch '${BRANCH_NAME}' exists in ${repo}"
+            else
+              echo "${prefix}_match=false" >> "$GITHUB_OUTPUT"
+              echo "${prefix}_ref=${default_branch}" >> "$GITHUB_OUTPUT"
+              echo "Branch '${BRANCH_NAME}' not found in ${repo}. Falling back to '${default_branch}'."
+            fi
+          }
+
+          determine_ref "lara" "specs-feup/lara-framework"
+          determine_ref "specs" "specs-feup/specs-java-libs"
+
+      - name: Echo checks
+        run: |
+          echo "Clava branch: ${{ env.CLAVA_BRANCH }}"
+          echo "Matching branch found (lara-framework): ${{ steps.repo-refs.outputs.lara_match }}"
+          echo "Matching branch found (specs-java-libs): ${{ steps.repo-refs.outputs.specs_match }}"
+          echo "Lara framework ref: ${{ steps.repo-refs.outputs.lara_ref }}"
+          echo "Specs-java-libs ref: ${{ steps.repo-refs.outputs.specs_ref }}"
+          echo "Lara framework default fallback: ${{ steps.repo-refs.outputs.lara_default }}"
+          echo "Specs-java-libs default fallback: ${{ steps.repo-refs.outputs.specs_default }}"
+          echo "Pull request base_ref (if any): ${{ github.base_ref }}"
+
+      - name: Checkout lara-framework
+        uses: actions/checkout@v4
+        with:
+          repository: specs-feup/lara-framework
+          path: lara-framework
+          ref: ${{ steps.repo-refs.outputs.lara_ref }}
+
+      - name: Checkout specs-java-libs
+        uses: actions/checkout@v4
+        with:
+          repository: specs-feup/specs-java-libs
+          path: specs-java-libs
+          ref: ${{ steps.repo-refs.outputs.specs_ref }}

.github/workflows/nightly.yml

@@ -7,7 +7,6 @@ name: nightly
 
 on:
   push:
-  pull_request:
 
   # Daily at midnight
   schedule:
@@ -81,8 +80,7 @@ jobs:
         with:
           repository: specs-feup/specs-java-libs
           path: specs-java-libs
-          # This is causing problems in PRs, for now it will always be the default branch
-          #ref: ${{ steps.Branch-specs-java-libs.outputs.value == '1' && env.BRANCH_NAME || env.DEFAULT_BRANCH }}
+          ref: ${{ steps.Branch-specs-java-libs.outputs.value == '1' && env.BRANCH_NAME || env.DEFAULT_BRANCH }}
 
       - name: Build with Gradle
         run: |
@@ -92,13 +90,11 @@ jobs:
       - name: Test ClangAstParser
         run: |
           cd clava/ClangAstParser
-          #touch debug
           gradle test
 
       - name: Test ClavaWeaver
         run: |
           cd clava/ClavaWeaver
-          #touch debug
           gradle test
         env:
           GITHUB_DEPENDENCY_GRAPH_ENABLED: false
@@ -123,10 +119,10 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        #node-version: ['latest', '20.x', '18.x']
-        node-version: ['22.x', '20.x']        
+        #node-version: ['latest', '22.x', '20.x']
+        node-version: ['22.x', '20.x']
         os: [ubuntu-latest, windows-latest, macos-latest]
-        
+
     runs-on: ${{ matrix.os }}
 
     steps:
@@ -142,6 +138,15 @@ jobs:
           node-version: ${{ matrix.node-version }}
           registry-url: 'https://registry.npmjs.org/'
 
+      # Install Xcode Command-Line Tools and GCC on macOS
+      - name: Install C SDK and GCC
+        if: matrix.os == 'macos-latest'
+        run: |
+          sudo xcode-select --install || true
+          sudo xcode-select -s /Library/Developer/CommandLineTools
+          brew install gcc
+          echo 'export PATH="$(brew --prefix gcc)/bin:$PATH"' >> $GITHUB_ENV
+
       - name: Checkout Clava
         uses: actions/checkout@v4
         with:
@@ -204,4 +209,4 @@ jobs:
                 echo "Not a push event, skipping publish."
             fi
         env:
-          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }} 
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

.gitignore

@@ -20,15 +20,16 @@ RemoteSystemsTempFiles/
 ##################
 
 .vscode
-deps/temp
-**/.settings/org.eclipse.buildship.core.prefs
 
 tomJava/
 .svn/
 sf.eclipse.javacc.prefs
 MatisseOptions.lara
 Matisse.lara
 
+# Eclipse settings folder
+**/.settings/**
+
 #output/
 .idea/
 .gradle/

.vscode/extensions.json

@@ -0,0 +1,13 @@
+{
+    "recommendations": [
+        "sonarsource.sonarlint-vscode",
+        "ms-vscode.cpptools",
+        "ms-vscode.cmake-tools",
+        "orta.vscode-jest",
+        "esbenp.prettier-vscode",
+        "dbaeumer.vscode-eslint",
+        "redhat.java",
+        "vscjava.vscode-gradle",
+        "vscjava.vscode-java-debug"
+    ]
+}

.vscode/settings.json

@@ -0,0 +1,8 @@
+{
+    "cmake.ignoreCMakeListsMissing": true,
+    "java.compile.nullAnalysis.mode": "automatic",
+    "java.configuration.updateBuildConfiguration": "automatic",
+    "jest.runMode": {
+        "type": "on-demand"
+    },
+}