Merge branch 'main' into abalmus/feat/react-renderer

Author: abalmush

.gemini/GEMINI.md

@@ -25,6 +25,7 @@ The A2UI repository is organized into several key directories:
     -   `java/`: Java implementation of the A2UI agent library.
 -   `renderers/`: Contains renderer libraries.
     -   `lit/`: The shared Lit renderer library used by the Lit clients.
+    -   `web_core/`: The shared core library used by Lit and Angular renderers.
 -   `tools/`: Helper tools for development.
     -   `editor/`: A web-based editor for generating and visualizing A2UI.
     -   `inspector/`: A web-based inspector for A2UI responses.
@@ -69,9 +70,13 @@ Ensure you have your environment variables set up (create a `.env` file if neces
 The Lit clients are located in `samples/client/lit/`.
 
 1.  **Build the Renderer**:
-    First, ensure the shared renderer is built:
+    First, ensure the shared renderers are built:
     ```bash
-    cd renderers/lit
+    cd renderers/web_core
+    npm install
+    npm run build
+
+    cd ../lit
     npm install
     npm run build
     ```
@@ -88,6 +93,18 @@ The Lit clients are located in `samples/client/lit/`.
 
 The Angular clients are located in `samples/client/angular/`.
 
+First, ensure the shared renderers are built (if not already done):
+```bash
+cd renderers/web_core
+npm install
+npm run build
+
+cd ../lit
+npm install
+npm run build
+```
+
+Then run the Angular client:
 ```bash
 cd samples/client/angular
 npm install

.github/workflows/editor_build.yml

@@ -19,11 +19,13 @@ on:
     paths:
       - 'tools/editor/**'
       - 'renderers/lit/**'
+      - 'renderers/web_core/**'
       - '.github/workflows/editor_build.yml'
   pull_request:
     paths:
       - 'tools/editor/**'
       - 'renderers/lit/**'
+      - 'renderers/web_core/**'
       - '.github/workflows/editor_build.yml'
 
 jobs:
@@ -38,6 +40,14 @@ jobs:
         with:
           node-version: '20'
 
+      - name: Install web_core deps
+        working-directory: ./renderers/web_core
+        run: npm ci
+
+      - name: Build web_core
+        working-directory: ./renderers/web_core
+        run: npm run build
+
       - name: Install lib's deps
         working-directory: ./renderers/lit
         run: npm ci

.github/workflows/inspector_build.yml

@@ -20,11 +20,13 @@ on:
     paths:
       - 'tools/inspector/**'
       - 'renderers/lit/**'
+      - 'renderers/web_core/**'
       - '.github/workflows/inspector_build.yml'
   pull_request:
     paths:
       - 'tools/inspector/**'
       - 'renderers/lit/**'
+      - 'renderers/web_core/**'
       - '.github/workflows/inspector_build.yml'
 
 jobs:
@@ -39,6 +41,14 @@ jobs:
         with:
           node-version: '20'
 
+      - name: Install web_core deps
+        working-directory: ./renderers/web_core
+        run: npm ci
+
+      - name: Build web_core
+        working-directory: ./renderers/web_core
+        run: npm run build
+
       - name: Install lib's deps
         working-directory: ./renderers/lit
         run: npm ci

.github/workflows/lit_samples_build.yml

@@ -35,6 +35,14 @@ jobs:
         with:
           node-version: '20'
 
+      - name: Install web_core deps
+        working-directory: ./renderers/web_core
+        run: npm ci
+
+      - name: Build web_core
+        working-directory: ./renderers/web_core
+        run: npm run build
+
       - name: Install lib's deps
         working-directory: ./renderers/lit
         run: npm i

.github/workflows/ng_build_and_test.yml

@@ -35,6 +35,14 @@ jobs:
         with:
           node-version: '20'
 
+      - name: Install web_core dependencies
+        working-directory: ./renderers/web_core
+        run: npm i
+
+      - name: Build web_core
+        working-directory: ./renderers/web_core
+        run: npm run build
+
       - name: Install web lib deps
         working-directory: ./renderers/lit
         run: npm i

.github/workflows/web_build_and_test.yml

@@ -19,10 +19,12 @@ on:
     branches: [ main ]
     paths:
       - 'renderers/lit/**'
+      - 'renderers/web_core/**'
       - '.github/workflows/web_build_and_test.yml'
   pull_request:
     paths:
       - 'renderers/lit/**'
+      - 'renderers/web_core/**'
       - '.github/workflows/web_build_and_test.yml'
 
 jobs:
@@ -37,6 +39,14 @@ jobs:
         with:
           node-version: '20'
 
+      - name: Install web_core dependencies
+        working-directory: ./renderers/web_core
+        run: npm i
+
+      - name: Build web_core
+        working-directory: ./renderers/web_core
+        run: npm run build
+
       - name: Install Lit renderer dependencies
         working-directory: ./renderers/lit
         run: npm i

.gitignore

@@ -5,6 +5,7 @@ dist
 .env
 .idx
 .vscode
+.idea
 __pycache__
 *.pyc
 .angular

README.md

@@ -134,8 +134,13 @@ The best way to understand A2UI is to run the samples.
     Open a new terminal window:
 
     ```bash
+    # Install and build the Web Core library
+    cd renderers/web_core
+    npm install
+    npm run build
+
     # Install and build the Lit renderer
-    cd renderers/lit
+    cd ../lit
     npm install
     npm run build
 

renderers/angular/ng-package.json

@@ -4,5 +4,5 @@
   "lib": {
     "entryFile": "src/public-api.ts"
   },
-  "allowedNonPeerDependencies": ["markdown-it", "@a2ui/lit"]
+  "allowedNonPeerDependencies": ["markdown-it", "@a2ui/web_core"]
 }