Lara dsl deprecation

.github/instructions/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/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: |
@@ -121,7 +119,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        #node-version: ['latest', '20.x', '18.x']
+        #node-version: ['latest', '22.x', '20.x']
         node-version: ['22.x', '20.x']
         os: [ubuntu-latest, windows-latest, macos-latest]
 
@@ -140,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:
@@ -202,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

@@ -25,6 +25,9 @@ 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"
+    },
+}

AntarexClavaApi/build.gradle

@@ -1,43 +1,35 @@
 plugins {
- 	id 'distribution'
+    id 'distribution'
+    id 'java'
 }
 
-// Java project
-apply plugin: 'java'
-
 java {
+    withSourcesJar()
+
     sourceCompatibility = JavaVersion.VERSION_17
     targetCompatibility = JavaVersion.VERSION_17
 }
 
-
 // Repositories providers
 repositories {
     mavenCentral()
 }
 
 dependencies {
-	testImplementation "junit:junit:4.13.1"     
-	implementation ':SpecsUtils'
-	implementation ':LaraUtils'		
+    implementation ':SpecsUtils'
+    implementation ':LaraUtils'
 }
 
-java {
-	withSourcesJar()
-}
-
-
 // Project sources
 sourceSets {
-   main {
-      java {
-         srcDir 'src-java'
-      }
-
-	  resources {
-		srcDir 'src-lara'
-		srcDir 'src-js'
-	  }
-   }   
-
+    main {
+        java {
+            srcDir 'src-java'
+        }
+
+        resources {
+            srcDir 'src-lara'
+            srcDir 'src-js'
+        }
+    }
 }