initial version

Author: krusche

.github/workflows/build.yml

@@ -0,0 +1,64 @@
+name: Build and Publish
+
+on:
+  push:
+    branches: [ main, develop ]
+    tags: [ 'v*' ]
+  pull_request:
+    branches: [ main ]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    
+    steps:
+    - uses: actions/checkout@v4
+    
+    - name: Set up JDK 25
+      uses: actions/setup-java@v4
+      with:
+        java-version: '25'
+        distribution: 'temurin'
+        cache: gradle
+    
+    - name: Grant execute permission for gradlew
+      run: chmod +x gradlew
+    
+    - name: Build with Gradle
+      run: ./gradlew build
+    
+    - name: Upload build artifacts
+      uses: actions/upload-artifact@v4
+      with:
+        name: jar
+        path: build/libs/*.jar
+
+  publish:
+    needs: build
+    runs-on: ubuntu-latest
+    if: startsWith(github.ref, 'refs/tags/v')
+    
+    steps:
+    - uses: actions/checkout@v4
+    
+    - name: Set up JDK 25
+      uses: actions/setup-java@v4
+      with:
+        java-version: '25'
+        distribution: 'temurin'
+        cache: gradle
+    
+    - name: Grant execute permission for gradlew
+      run: chmod +x gradlew
+    
+    - name: Publish to GitHub Packages
+      run: ./gradlew publish
+      env:
+        GITHUB_ACTOR: ${{ github.actor }}
+        GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+    
+    - name: Create GitHub Release
+      uses: softprops/action-gh-release@v1
+      with:
+        files: build/libs/*.jar
+        generate_release_notes: true

.gitignore

@@ -22,3 +22,7 @@
 # virtual machine crash logs, see http://www.java.com/en/download/help/error_hotspot.xml
 hs_err_pid*
 replay_pid*
+.DS_Store
+/.gradle
+/.idea
+/build

AGENTS.md

@@ -0,0 +1,39 @@
+# Repository Guidelines
+
+## Project Structure & Module Organization
+- `src/main/java/de/tum/cit/aet/openapi/` contains the generator implementation (entry point: `Angular21Generator.java`).
+- `src/main/resources/angular21/` holds Mustache templates used for generated Angular output (`model.mustache`, `api-service.mustache`, `api-resource.mustache`, etc.).
+- `src/main/resources/META-INF/services/` registers the generator for the OpenAPI SPI.
+- `example/` includes a sample OpenAPI spec (`example/example-openapi.yaml`) for manual checks.
+- `build/` is Gradle output (ignore for source edits).
+
+## Build, Test, and Development Commands
+- `./gradlew build` — compiles, runs tests, and produces JARs.
+- `./gradlew test` — runs JUnit tests (if present).
+- `./gradlew publishToMavenLocal` — publishes the generator to your local Maven repo for quick integration testing.
+- `./gradlew publish` — publishes to GitHub Packages (requires `GITHUB_ACTOR`/`GITHUB_TOKEN`).
+
+## Coding Style & Naming Conventions
+- Java 25 source; follow standard Java style (4-space indentation, braces on the same line).
+- Keep generator options as `UPPER_SNAKE_CASE` constants in `Angular21Generator.java`.
+- Template outputs follow naming patterns defined in the generator: models use `.ts`, APIs use `*-api.ts`, resources use `*-resources.ts`.
+- Mustache templates should stay minimal; prefer code in Java when logic is complex.
+
+## Testing Guidelines
+- JUnit Jupiter is configured in Gradle. There are currently no test sources in `src/test/java`.
+- If you add tests, name classes `*Test.java` and keep them under `src/test/java`.
+- Run `./gradlew test` before submitting changes that affect code generation.
+
+## Commit & Pull Request Guidelines
+- The Git history currently contains only an “Initial commit,” so no formal commit convention exists yet.
+- Use concise, imperative commit messages (e.g., “Add template option for X”).
+- PRs should include a short description, the rationale, and how you validated changes (commands or manual checks). If generated output changes, mention the impacted files or templates.
+
+## Architecture Overview
+- `Angular21Generator` extends the OpenAPI TypeScript Angular generator and swaps template mappings to the files in `src/main/resources/angular21/`.
+- CLI config options are wired through `processOpts()` and then exposed to templates via `additionalProperties`.
+- Generation outputs are routed to `generated-code/angular21/` by default and follow the naming patterns set in the generator.
+
+## Configuration Tips
+- The generator is registered via `src/main/resources/META-INF/services/org.openapitools.codegen.CodegenConfig`—update it only if the main class name changes.
+- Publishing to GitHub Packages requires environment credentials; avoid hardcoding tokens in Gradle.