Upload 173 files

vendor/a2ui/.gemini/GEMINI.md

@@ -0,0 +1,94 @@
+# A2UI Gemini Agent Guide
+
+This document serves as a guide for using the Gemini agent within the A2UI repository. It outlines the repository's structure, explains the core concepts of the A2UI protocol, and provides instructions for running the various demos and keeping this guide up-to-date.
+
+## Repository Structure
+
+The A2UI repository is organized into several key directories:
+
+-   `specification/0.8/docs/`: Contains the primary human-readable documentation for the A2UI protocol.
+    -   `a2ui_protocol.md`: The foundational specification document. This is the best place to start to understand the protocol's fundamental goals.
+-   `specification/0.8/json/`: Contains the formal JSON schema definitions for the protocol.
+    -   `server_to_client.json`: Defines the schema for messages sent from the server to the client.
+    -   `client_to_server.json`: Defines the schema for event messages sent from the client to the server.
+-   `a2a_agents/python/`: Contains Python code relating to server-side integration of A2UI
+    -   `a2ui_extension/`: Python implementation of the A2UI A2A extension.
+    -   `adk/samples/`: Contains demo applications that showcase the A2UI protocol in action using the ADK framework.
+-   `web/`: Contains the web-based client implementations (using Lit and Vite) for the samples, including a shared library (`renderers/lit`).
+-   `angular/`: Contains an alternative web-based client implementation using Angular.
+-   `eval/`: Contains a Genkit-based framework for evaluating LLM performance in generating A2UI responses.
+
+## A2UI Specification Overview
+
+The A2UI protocol is a JSONL-based, streaming UI protocol designed to be easily generated by Large Language Models (LLMs). It enables a server to stream a platform-agnostic, abstract UI definition to a client, which then renders it progressively using a native widget set.
+
+### Core Concepts
+
+The core concepts of the A2UI protocol are detailed in the main specification document. Rather than duplicating the content here, you should refer to the authoritative source:
+
+-   **A2UI Protocol Specification**: `@docs/a2ui_protocol.md`
+
+This document covers the design philosophy, architecture, data flow, and core concepts of the protocol.
+
+### Schemas
+
+The formal, machine-readable definitions of the protocol are maintained as JSON schemas:
+
+-   **Server-to-Client Schema**: `@specification/0.8/json/server_to_client.json`
+-   **Server-to-Client Schema, with standard catalog**: `@specification/0.8/json/server_to_client_with_standard_catalog.json`
+-   **Client-to-Server Schema**: `@specification/0.8/json/client_to_server.json`
+
+## Running the Demos
+
+There are three demos available in the `a2a_samples/` directory. Each demo has a corresponding web client in the `web/` and `angular/` directories. To run a demo, you will need to start both the server and the client.
+
+### Running a Demo Server
+
+To run a demo server, navigate to the demo's directory and run the `__main__.py` script. For example, to run the contact lookup demo:
+
+```bash
+cd a2a_samples/a2ui_contact_lookup
+python -m __main__
+```
+
+### Running a Demo Client (Lit)
+
+To run a demo client, navigate to the corresponding client directory in `web/` and start the development server. For example, to run the contact lookup client:
+
+```bash
+cd web/contact
+npm install
+npm run dev
+```
+
+### Running a Demo Client (Angular)
+
+To run a demo client, navigate to the `angular/` directory and start the development server with the project name. For example, to run the contact lookup client:
+
+```bash
+cd angular
+npm install
+npm start -- contact
+```
+
+## Renderers
+
+There are three renderers available for A2UI:
+
+-   **Web (Lit)**: Located in `renderers/lit`, this is the primary web renderer used by the demos in `web/`.
+-   **Angular**: Located in `angular/projects/lib`, this is an alternative web renderer for Angular applications.
+-   **Flutter**: The Flutter renderer is in a separate repository: [https://github.com/flutter/genui](https://github.com/flutter/genui)
+
+## Keeping This Guide Updated
+
+This document is intended to be a living guide for the repository. As the repository evolves, it's important to keep this file up-to-date. When making changes to the repository, please consider the following:
+
+-   **New Demos or Clients**: If you add a new demo or client, add it to the "Running the Demos" section.
+-   **Specification Changes**: If you make significant changes to the A2UI protocol, ensure that the "A2UI Specification Overview" section is updated to reflect the changes, and that any linked documents are also updated.
+-   **Repository Structure Changes**: If you change the directory structure of the repository, update the "Repository Structure" section.
+
+To get this file back in sync, you can run the following commands:
+
+1. List all the files in the entire repo with `git ls-tree main --name-only -r`
+2. Read the ~50 most important files in the list, potentially in batches.
+3. Update this file.

vendor/a2ui/.github/workflows/docs.yml

@@ -0,0 +1,79 @@
+# Copyright 2025 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#      https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+name: Docs Build and Deploy
+
+on:
+  push:
+    branches:
+      - main
+    paths:
+      - ".github/workflows/docs.yml"
+      - "requirements-docs.txt"
+      - "mkdocs.yml"
+      - "docs/**"
+  pull_request:
+    branches:
+      - main
+    paths:
+      - ".github/workflows/docs.yml"
+      - "requirements-docs.txt"
+      - "mkdocs.yml"
+      - "docs/**"
+
+jobs:
+  build_and_deploy:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      actions: read
+
+    if: github.repository == 'google/A2UI'
+
+    steps:
+      - name: Checkout Code
+        uses: actions/checkout@v5
+        with:
+          token: ${{ secrets.GITHUB_TOKEN }}
+          fetch-depth: 0
+
+      - name: Configure Git Credentials
+        run: |
+          git config --global user.name github-actions[bot]
+          git config --global user.email 41898282+github-actions[bot]@users.noreply.github.com
+
+      - name: Setup Python
+        uses: actions/setup-python@v6
+        with:
+          python-version: 3.13
+
+      - name: Restore pip cache
+        uses: actions/cache@v4
+        with:
+          key: ${{ runner.os }}-pip-${{ hashFiles('**/requirements-docs.txt') }}
+          path: ~/.cache/pip
+          restore-keys: |
+            ${{ runner.os }}-pip-
+
+      - name: Install documentation dependencies
+        run: pip install -r requirements-docs.txt
+
+      - name: Build Documentation (PR Check)
+        if: github.event_name == 'pull_request'
+        run: mkdocs build
+
+      - name: Deploy development version from main branch
+        if: github.event_name == 'push' && github.ref == 'refs/heads/main'
+        run: |
+          mkdocs gh-deploy

vendor/a2ui/.github/workflows/editor_build.yml

@@ -0,0 +1,55 @@
+# Copyright 2025 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#      https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+name: Editor build
+
+on:
+  push:
+    paths:
+      - 'tools/editor/**'
+      - 'renderers/lit/**'
+      - '.github/workflows/editor_build.yml'
+  pull_request:
+    paths:
+      - 'tools/editor/**'
+      - 'renderers/lit/**'
+      - '.github/workflows/editor_build.yml'
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+
+      - name: Install lib's deps
+        working-directory: ./renderers/lit
+        run: npm ci
+
+      - name: Build lib
+        working-directory: ./renderers/lit
+        run: npm run build
+
+      - name: Install editor deps
+        working-directory: ./tools/editor
+        run: npm install
+
+      - name: Build editor
+        working-directory: ./tools/editor
+        run: npm run build

vendor/a2ui/.github/workflows/inspector_build.yml

@@ -0,0 +1,56 @@
+# Copyright 2025 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#      https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+name: Inspector build
+
+on:
+  push:
+    branches: [ main ]
+    paths:
+      - 'tools/inspector/**'
+      - 'renderers/lit/**'
+      - '.github/workflows/inspector_build.yml'
+  pull_request:
+    paths:
+      - 'tools/inspector/**'
+      - 'renderers/lit/**'
+      - '.github/workflows/inspector_build.yml'
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+
+      - name: Install lib's deps
+        working-directory: ./renderers/lit
+        run: npm ci
+
+      - name: Build lib
+        working-directory: ./renderers/lit
+        run: npm run build
+
+      - name: Install inspector deps
+        working-directory: ./tools/inspector
+        run: npm install
+
+      - name: Build inspector
+        working-directory: ./tools/inspector
+        run: npm run build

vendor/a2ui/.github/workflows/java_build_and_test.yml

@@ -0,0 +1,48 @@
+# Copyright 2025 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#      https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+name: Java sample build and test
+
+on:
+  push:
+    branches:
+      - main
+    paths:
+      - 'a2a_agents/java/**'
+  pull_request:
+    paths:
+      - 'a2a_agents/java/**'
+
+jobs:
+  build-and-test:
+    name: Build and test Java agent sample
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v3
+
+      - name: Set up JDK
+        uses: actions/setup-java@v3
+        with:
+          java-version: '21'
+          distribution: 'temurin'
+
+      - name: Build with Maven
+        working-directory: a2a_agents/java
+        run: mvn clean install
+
+      - name: Run Tests
+        working-directory: a2a_agents/java
+        run: mvn test

vendor/a2ui/.github/workflows/lit_samples_build.yml

@@ -0,0 +1,54 @@
+# Copyright 2025 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#      https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+name: Lit samples build
+
+on:
+  push:
+    branches: [ main ]
+    paths-ignore:
+      - 'samples/agent/adk/**'
+  pull_request:
+    paths-ignore:
+      - 'samples/agent/adk/**'
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+
+      - name: Install lib's deps
+        working-directory: ./renderers/lit
+        run: npm i
+
+      - name: Build lib
+        working-directory: ./renderers/lit
+        run: npm run build
+
+      - name: Install all lit samples workspaces' dependencies
+        working-directory: ./samples/client/lit
+        run: npm install --workspaces
+
+      - name: Build all lit samples workspaces
+        working-directory: ./samples/client/lit
+        run: npm run build --workspaces
+
+

vendor/a2ui/.github/workflows/ng_build_and_test.yml

@@ -0,0 +1,72 @@
+# Copyright 2025 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#      https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+name: Angular build and test
+
+on:
+  push:
+    branches: [ main ]
+    paths-ignore:
+      - 'samples/agent/adk/**'
+  pull_request:
+    paths-ignore:
+      - 'samples/agent/adk/**'
+
+jobs:
+  build-and-test:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+
+      - name: Install web lib deps
+        working-directory: ./renderers/lit
+        run: npm i
+
+      - name: Build web lib
+        working-directory: ./renderers/lit
+        run: npm run build
+
+      - name: Install renderer deps
+        working-directory: ./renderers/angular
+        run: npm i
+
+      - name: Build Angular renderer
+        working-directory: ./renderers/angular
+        run: npm run build
+
+      - name: Install top-level deps
+        working-directory: ./samples/client/angular
+        run: npm i
+
+      - name: Build contact sample
+        working-directory: ./samples/client/angular
+        run: npm run build contact
+
+      - name: Build restaurant sample
+        working-directory: ./samples/client/angular
+        run: npm run build restaurant
+
+      - name: Build Rizzchart sample
+        working-directory: ./samples/client/angular
+        run: npm run build rizzcharts
+
+      - name: Build Orchestrator
+        working-directory: ./samples/client/angular
+        run: npm run build orchestrator

vendor/a2ui/.github/workflows/python_samples_build.yml

@@ -0,0 +1,62 @@
+# Copyright 2025 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#      https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+name: Build python samples
+
+on:
+  push:
+    branches:
+      - main
+    paths:
+      - 'samples/agent/adk/**'
+      - 'a2a_agents/python/a2ui_extension/**'
+  pull_request:
+    paths:
+      - 'samples/agent/adk/**'
+      - 'a2a_agents/python/a2ui_extension/**'
+
+jobs:
+  build:
+    name: Build samples
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v3
+
+      - name: Set up Python
+        uses: actions/setup-python@v4
+        with:
+          python-version: '3.x'
+
+      - name: Install `uv` globally
+        run: |
+          python -m pip install --upgrade pip
+          pip install uv
+
+      - name: Build contact_lookup
+        working-directory: samples/agent/adk/contact_lookup
+        run: uv build .
+
+      - name: Build orchestrator
+        working-directory: samples/agent/adk/orchestrator
+        run: uv build .
+
+      - name: Build restaurant_finder
+        working-directory: samples/agent/adk/restaurant_finder
+        run: uv build .
+
+      - name: Build rizzcharts
+        working-directory: samples/agent/adk/rizzcharts
+        run: uv build .

vendor/a2ui/.github/workflows/web_build_and_test.yml

@@ -0,0 +1,50 @@
+# Copyright 2025 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#      https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+name: Lit renderer build and test
+
+on:
+  push:
+    branches: [ main ]
+    paths:
+      - 'renderers/lit/**'
+      - '.github/workflows/web_build_and_test.yml'
+  pull_request:
+    paths:
+      - 'renderers/lit/**'
+      - '.github/workflows/web_build_and_test.yml'
+
+jobs:
+  build-and-test:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+
+      - name: Install Lit renderer dependencies
+        working-directory: ./renderers/lit
+        run: npm i
+
+      - name: Build Lit renderer
+        working-directory: ./renderers/lit
+        run: npm run build
+
+      - name: Run Lit renderer tests
+        working-directory: ./renderers/lit
+        run: npm test

vendor/a2ui/.gitignore

@@ -0,0 +1,16 @@
+node_modules
+.DS_Store
+.wireit
+dist
+.env
+.idx
+.vscode
+__pycache__
+*.pyc
+.angular
+
+# MkDocs build output
+site/
+
+# Python virtual environment
+.venv/

vendor/a2ui/CONTRIBUTING.md

@@ -0,0 +1,49 @@
+# How to contribute to A2UI
+
+We'd love to accept your patches and contributions to this project.
+
+## Before you begin
+
+### Sign our Contributor License Agreement
+
+Contributions to this project must be accompanied by a
+[Contributor License Agreement](https://cla.developers.google.com/about) (CLA).
+You (or your employer) retain the copyright to your contribution; this simply
+gives us permission to use and redistribute your contributions as part of the
+project.
+
+If you or your current employer have already signed the Google CLA (even if it
+was for a different project), you probably don't need to do it again.
+
+Visit <https://cla.developers.google.com/> to see your current agreements or to
+sign a new one.
+
+### Review our community guidelines
+
+This project follows
+[Google's Open Source Community Guidelines](https://opensource.google/conduct/).
+
+## Contribution process
+
+### Code reviews
+
+All submissions, including submissions by project members, require review. We
+use GitHub pull requests for this purpose. Consult
+[GitHub Help](https://help.github.com/articles/about-pull-requests/) for more
+information on using pull requests.
+
+### Contributor Guide
+
+You may follow these steps to contribute:
+
+1. **Fork the official repository.** This will create a copy of the official repository in your own account.
+2. **Sync the branches.** This will ensure that your copy of the repository is up-to-date with the latest changes from the official repository.
+3. **Work on your forked repository's feature branch.** This is where you will make your changes to the code.
+4. **Commit your updates on your forked repository's feature branch.** This will save your changes to your copy of the repository.
+5. **Submit a pull request to the official repository's main branch.** This will request that your changes be merged into the official repository.
+6. **Resolve any linting errors.** This will ensure that your changes are formatted correctly.
+
+Here are some additional things to keep in mind during the process:
+
+- **Test your changes.** Before you submit a pull request, make sure that your changes work as expected.
+- **Be patient.** It may take some time for your pull request to be reviewed and merged.

vendor/a2ui/LICENSE

@@ -0,0 +1,203 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
+   

vendor/a2ui/README.md

@@ -0,0 +1,162 @@
+# A2UI: Agent-to-User Interface
+
+A2UI is an open-source project, complete with a format
+optimized for representing updateable agent-generated
+UIs and an initial set of renderers, that allows agents
+to generate or populate rich user interfaces.
+
+<img src="docs/assets/a2ui_gallery_examples.png" alt="Gallery of A2UI components" height="400">
+
+*A gallery of A2UI rendered cards, showing a variety of UI compositions that A2UI can achieve.*
+
+## ⚠️ Status: Early Stage Public Preview
+
+> **Note:** A2UI is currently in **v0.8 (Public Preview)**. The specification and
+implementations are functional but are still evolving. We are opening the project to
+foster collaboration, gather feedback, and solicit contributions (e.g., on client renderers).
+Expect changes.
+
+## Summary
+
+Generative AI excels at creating text and code, but agents can struggle to
+present rich, interactive interfaces to users, especially when those agents
+are remote or running across trust boundaries.
+
+**A2UI** is an open standard and set of libraries that allows agents to
+"speak UI." Agents send a declarative JSON format describing the *intent* of
+the UI. The client application then renders this using its own native
+component library (Flutter, Angular, Lit, etc.).
+
+This approach ensures that agent-generated UIs are
+**safe like data, but expressive like code**.
+
+## High-Level Philosophy
+
+A2UI was designed to address the specific challenges of interoperable,
+cross-platform, generative or template-based UI responses from agents.
+
+The project's core philosophies:
+
+* **Security first**: Running arbitrary code generated by an LLM may present a
+security risk. A2UI is a declarative data format, not executable
+code. Your client application maintains a "catalog" of trusted, pre-approved
+UI components (e.g., Card, Button, TextField), and the agent can only request
+to render components from that catalog.
+* **LLM-friendly and incrementally updateable**: The UI is represented as a flat
+list of components with ID references which is easy for LLMs to generate
+incrementally, allowing for progressive rendering and a responsive user
+experience. An agent can efficiently make incremental changes to the UI based
+on new user requests as the conversation progresses.
+* **Framework-agnostic and portable**: A2UI separates the UI structure from
+the UI implementation. The agent sends a description of the component tree
+and its associated data model. Your client application is responsible for
+mapping these abstract descriptions to its native widgets—be it web components,
+Flutter widgets, React components, SwiftUI views or something else entirely.
+The same A2UI JSON payload from an agent can be rendered on multiple different
+clients built on top of different frameworks.
+* **Flexibility**: A2UI also features an open registry pattern that allows
+developers to map server-side types to custom client implementations, from
+native mobile widgets to React components. By registering a "Smart Wrapper,"
+you can connect any existing UI component—including secure iframe containers
+for legacy content—to A2UI's data binding and event system.  Crucially, this
+places security firmly in the developer's hands, enabling them to enforce
+strict sandboxing policies and "trust ladders" directly within their custom
+component logic rather than relying solely on the core system.
+
+## Use Cases
+
+Some of the use cases include:
+
+* **Dynamic Data Collection:** An agent generates a bespoke form (date pickers,
+sliders, inputs) based on the specific context of a conversation (e.g.,
+booking a specialized reservation).
+* **Remote Sub-Agents:** An orchestrator agent delegates a task to a
+remote specialized agent (e.g., a travel booking agent) which returns a
+UI payload to be rendered inside the main chat window.
+* **Adaptive Workflows:** Enterprise agents that generate approval
+dashboards or data visualizations on the fly based on the user's query.
+
+## Architecture
+
+The A2UI flow disconnects the generation of UI from the execution of UI:
+
+1. **Generation:** An Agent (using Gemini or another LLM) generates or uses
+a pre-generated `A2UI Response`, a JSON payload describing the composition
+of UI components and their properties.
+2. **Transport:** This message is sent to the client application
+(via A2A, AG UI, etc.).
+3. **Resolution:** The Client's **A2UI Renderer** parses the JSON.
+4. **Rendering:** The Renderer maps the abstract components
+(e.g., `type: 'text-field'`) to the concrete implementation in the client's codebase.
+
+## Dependencies
+
+A2UI is designed to be a lightweight format, but it fits into a larger ecosystem:
+
+* **Transports:** Compatible with **A2A Protocol** and **AG UI**.
+* **LLMs:** Can be generated by any model capable of generating JSON output.
+* **Host Frameworks:** Requires a host application built in a supported framework
+(currently: Web or Flutter).
+
+## Getting Started
+
+The best way to understand A2UI is to run the samples.
+
+### Prerequisites
+
+* Node.js (for web clients)
+* Python (for agent samples)
+* A valid [Gemini API Key](https://aistudio.google.com/) is required for the samples.
+
+### Running the Restaurant Finder Demo
+
+1. **Clone the repository:**
+
+    ```bash
+    git clone https://github.com/google/A2UI.git
+    cd A2UI
+    ```
+
+2. **Set your API Key:**
+
+    ```bash
+    export GEMINI_API_KEY="your_gemini_api_key"
+    ```
+
+3. **Run the Agent (Backend):**
+
+    ```bash
+    cd samples/agent/adk/restaurant_finder
+    uv run .
+    ```
+
+4. **Run the Client (Frontend):**
+    Open a new terminal window:
+
+    ```bash
+    cd samples/client/lit/shell
+    npm install
+    npm run dev
+    ```
+
+For Flutter developers, check out the [GenUI SDK](https://github.com/flutter/genui),
+which uses A2UI under the hood.
+
+CopilotKit has a public [A2UI Widget Builder](https://go.copilotkit.ai/A2UI-widget-builder)
+to try out as well.
+
+## Roadmap
+
+We hope to work with the community on the following:
+
+* **Spec Stabilization:** Moving towards a v1.0 specification.
+* **More Renderers:** Adding official support for React, Jetpack Compose, iOS (SwiftUI), and more.
+* **Additional Transports:** Support for REST and more.
+* **Additional Agent Frameworks:** Genkit, LangGraph, and more.
+
+## Contribute
+
+A2UI is an **Apache 2.0** licensed project. We believe the future of UI is agentic,
+and we want to work with you to help build it.
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for details on how to get started.

vendor/a2ui/mkdocs.yaml

@@ -0,0 +1,184 @@
+# Copyright 2025 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#      https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+site_name: A2UI
+site_url: https://a2ui.org/
+site_description: A2UI, a streaming protocol for Agent-Driven User Interfaces
+site_author: Google
+site_dir: site
+
+extra:
+  analytics:
+    provider: google
+    property: G-YX9TPV8DCC
+  consent:
+      title: Cookie consent
+      description: >-
+        We use cookies to recognize repeated visits and preferences,
+        as well as to measure the effectiveness of our documentation and
+        whether users find the information they need. With your consent,
+        you're helping us to make our documentation better.
+
+# Navigation
+nav:
+  - Home: index.md
+  - Introduction & FAQ:
+      - What is A2UI?: introduction/what-is-a2ui.md
+      - Who is it For?: introduction/who-is-it-for.md
+      - How Can I Use It?: introduction/how-to-use.md
+      - Where is it Used?: introduction/where-is-it-used.md
+      - Agent UI Ecosystem: introduction/agent-ui-ecosystem.md
+  - Quickstart: quickstart.md
+  - A2UI Composer ⭐: composer.md
+  - Developer Guides:
+      - Client Setup: guides/client-setup.md
+      - Agent Development: guides/agent-development.md
+      - Custom Components: guides/custom-components.md
+      - Theming & Styling: guides/theming.md
+  - Core Concepts:
+      - Overview: concepts/overview.md
+      - Data Flow: concepts/data-flow.md
+      - Components & Structure: concepts/components.md
+      - Data Binding: concepts/data-binding.md
+  - Specifications:
+      - v0.8 (Stable):
+          - A2UI Specification: specification/v0.8-a2ui.md
+          - A2A Extension: specification/v0.8-a2a-extension.md
+      - v0.9 (Draft):
+          - A2UI Specification: specification/v0.9-a2ui.md
+          - Evolution Guide: specification/v0.9-evolution-guide.md
+  - Renderers (Clients): renderers.md
+  - Transports (Message Passing): transports.md
+  - Agents (Server-side): agents.md
+  - Community: community.md
+  - Roadmap: roadmap.md
+  - Reference:
+      - Component Reference: reference/components.md
+      - Message Reference: reference/messages.md
+
+# Repository
+repo_name: google/A2UI
+repo_url: https://github.com/google/A2UI
+
+# Copyright
+copyright: Copyright Google 2025&nbsp;&nbsp;|&nbsp;&nbsp;<a href="//policies.google.com/terms">Terms</a>&nbsp;&nbsp;|&nbsp;&nbsp;<a href="//policies.google.com/privacy">Privacy</a>&nbsp;&nbsp;|&nbsp;&nbsp;<a href="#__consent">Manage cookies</a>
+
+# Custom CSS
+extra_css:
+  - stylesheets/custom.css
+
+
+# Configuration
+theme:
+  name: material
+  font:
+    text: Google Sans
+    code: Roboto Mono
+  logo: assets/A2UI_light.svg
+  favicon: assets/A2UI_dark.svg
+  icon:
+    repo: fontawesome/brands/github
+    # view: material/pencil-box-multiple
+    admonition:
+      note: fontawesome/solid/note-sticky
+      abstract: fontawesome/solid/book
+      info: fontawesome/solid/circle-info
+      tip: fontawesome/solid/bullhorn
+      success: fontawesome/solid/check
+      question: fontawesome/solid/circle-question
+      warning: fontawesome/solid/triangle-exclamation
+      failure: fontawesome/solid/bomb
+      danger: fontawesome/solid/skull
+      bug: fontawesome/solid/robot
+      example: fontawesome/solid/flask
+      quote: fontawesome/solid/quote-left
+  palette:
+    - scheme: default
+      primary: teal
+      accent: light blue
+      toggle:
+        icon: material/brightness-7
+        name: Switch to dark mode
+
+    - scheme: slate
+      primary: teal
+      accent: light blue
+      toggle:
+        icon: material/brightness-4
+        name: Switch to light mode
+
+  features:
+    - announce.dismiss
+    - content.action.view
+    - content.code.annotate
+    - content.code.copy
+    - content.code.select
+    - content.tabs.link
+    - navigation.footer
+    - navigation.indexes
+    - navigation.instant
+    - navigation.instant.progress
+    - navigation.path
+    - navigation.top
+    - navigation.tracking
+    - toc.follow
+
+# Extensions
+markdown_extensions:
+  - meta
+  - footnotes
+  - admonition
+  - attr_list
+  - md_in_html
+  - pymdownx.details
+  - pymdownx.emoji:
+      emoji_index: !!python/name:material.extensions.emoji.twemoji
+      emoji_generator: !!python/name:material.extensions.emoji.to_svg
+  - pymdownx.highlight:
+      anchor_linenums: true
+      line_spans: __span
+      pygments_lang_class: true
+  - pymdownx.inlinehilite
+  - pymdownx.snippets:
+      url_download: true
+      dedent_subsections: true
+  - pymdownx.superfences:
+      custom_fences:
+        - name: mermaid
+          class: mermaid
+          format: !!python/name:mermaid2.fence_mermaid
+  - pymdownx.tabbed:
+      alternate_style: true
+      slugify: !!python/object/apply:pymdownx.slugs.slugify
+        kwds:
+          case: lower
+  - pymdownx.tasklist:
+      custom_checkbox: true
+  - toc:
+      permalink: true
+
+# Plugins
+plugins:
+  - search
+  - macros
+  # - include-markdown
+  # - mermaid2
+  # - llmstxt:
+  #     full_output: llms-full.txt
+  #     sections:
+  #       "Specification":
+  #         - a2ui_protocol.md
+  # - redirects:
+  #     redirect_maps:
+  #       "index.md": "a2ui_protocol.md"

vendor/a2ui/renderers/angular/.npmrc

@@ -0,0 +1,2 @@
+@a2ui:registry=https://us-npm.pkg.dev/oss-exit-gate-prod/a2ui--npm/
+//us-npm.pkg.dev/oss-exit-gate-prod/a2ui--npm/:always-auth=true

vendor/a2ui/renderers/angular/README.md

@@ -0,0 +1,9 @@
+Angular implementation of A2UI.
+
+Important: The sample code provided is for demonstration purposes and illustrates the mechanics of A2UI and the Agent-to-Agent (A2A) protocol. When building production applications, it is critical to treat any agent operating outside of your direct control as a potentially untrusted entity.
+
+All operational data received from an external agent—including its AgentCard, messages, artifacts, and task statuses—should be handled as untrusted input. For example, a malicious agent could provide crafted data in its fields (e.g., name, skills.description) that, if used without sanitization to construct prompts for a Large Language Model (LLM), could expose your application to prompt injection attacks.
+
+Similarly, any UI definition or data stream received must be treated as untrusted. Malicious agents could attempt to spoof legitimate interfaces to deceive users (phishing), inject malicious scripts via property values (XSS), or generate excessive layout complexity to degrade client performance (DoS). If your application supports optional embedded content (such as iframes or web views), additional care must be taken to prevent exposure to malicious external sites.
+
+Developer Responsibility: Failure to properly validate data and strictly sandbox rendered content can introduce severe vulnerabilities. Developers are responsible for implementing appropriate security measures—such as input sanitization, Content Security Policies (CSP), strict isolation for optional embedded content, and secure credential handling—to protect their systems and users.

vendor/a2ui/renderers/angular/angular.json

@@ -0,0 +1,35 @@
+{
+  "$schema": "./node_modules/@angular/cli/lib/config/schema.json",
+  "version": 1,
+  "projects": {
+    "lib": {
+      "projectType": "library",
+      "root": ".",
+      "sourceRoot": "./src",
+      "prefix": "lib",
+      "architect": {
+        "build": {
+          "builder": "@angular/build:ng-packagr",
+          "configurations": {
+            "production": {
+              "tsConfig": "./tsconfig.lib.prod.json"
+            },
+            "development": {
+              "tsConfig": "./tsconfig.lib.json"
+            }
+          },
+          "defaultConfiguration": "production"
+        },
+        "test": {
+          "builder": "@angular/build:karma",
+          "options": {
+            "tsConfig": "./tsconfig.spec.json"
+          }
+        }
+      }
+    }
+  },
+  "cli": {
+    "analytics": false
+  }
+}

vendor/a2ui/renderers/angular/ng-package.json

@@ -0,0 +1,8 @@
+{
+  "$schema": "../../node_modules/ng-packagr/ng-package.schema.json",
+  "dest": "./dist",
+  "lib": {
+    "entryFile": "src/public-api.ts"
+  },
+  "allowedNonPeerDependencies": ["markdown-it", "@a2ui/lit"]
+}

vendor/a2ui/renderers/angular/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "@a2ui/angular",
+  "version": "0.8.1",
+  "scripts": {
+    "build": "ng build"
+  },
+  "dependencies": {
+    "@a2ui/lit": "file:../lit",
+    "markdown-it": "^14.1.0",
+    "tslib": "^2.3.0"
+  },
+  "peerDependencies": {
+    "@angular/common": "^21.0.0",
+    "@angular/core": "^21.0.0",
+    "@angular/platform-browser": "^21.0.0"
+  },
+  "devDependencies": {
+    "@angular/build": "^21.0.2",
+    "@angular/cli": "^21.0.2",
+    "@angular/compiler": "^21.0.0",
+    "@angular/compiler-cli": "^21.0.3",
+    "@angular/core": "^21.0.0",
+    "@types/express": "^5.0.1",
+    "@types/jasmine": "~5.1.0",
+    "@types/markdown-it": "^14.1.2",
+    "@types/node": "^20.17.19",
+    "@types/uuid": "^10.0.0",
+    "@vitest/browser": "^4.0.15",
+    "cypress": "^15.6.0",
+    "google-artifactregistry-auth": "^3.5.0",
+    "jasmine-core": "~5.9.0",
+    "jsdom": "^27.2.0",
+    "karma": "^6.4.4",
+    "karma-chrome-launcher": "^3.2.0",
+    "karma-coverage": "^2.2.1",
+    "karma-jasmine": "^5.1.0",
+    "karma-jasmine-html-reporter": "^2.1.0",
+    "ng-packagr": "^21.0.0",
+    "playwright": "^1.56.1",
+    "prettier": "^3.6.2",
+    "sass": "^1.93.2",
+    "tslib": "^2.8.1",
+    "typescript": "~5.9.2",
+    "vitest": "^4.0.15"
+  },
+  "sideEffects": false,
+  "prettier": {
+    "printWidth": 100,
+    "singleQuote": true,
+    "overrides": [
+      {
+        "files": "*.html",
+        "options": {
+          "parser": "angular"
+        }
+      }
+    ]
+  }
+}

vendor/a2ui/renderers/angular/src/lib/catalog/audio.ts

@@ -0,0 +1,50 @@
+/*
+ Copyright 2025 Google LLC
+
+ Licensed under the Apache License, Version 2.0 (the "License");
+ you may not use this file except in compliance with the License.
+ You may obtain a copy of the License at
+
+      https://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+ */
+
+import { Component, computed, input } from '@angular/core';
+import { DynamicComponent } from '../rendering/dynamic-component';
+import { Primitives } from '@a2ui/lit/0.8';
+
+@Component({
+  selector: 'a2ui-audio',
+  template: `
+    @let resolvedUrl = this.resolvedUrl();
+
+    @if (resolvedUrl) {
+      <section [class]="theme.components.AudioPlayer" [style]="theme.additionalStyles?.AudioPlayer">
+        <audio controls [src]="resolvedUrl"></audio>
+      </section>
+    }
+  `,
+  styles: `
+    :host {
+      display: block;
+      flex: var(--weight);
+      min-height: 0;
+      overflow: auto;
+    }
+
+    audio {
+      display: block;
+      width: 100%;
+      box-sizing: border-box;
+    }
+  `
+})
+export class Audio extends DynamicComponent {
+  readonly url = input.required<Primitives.StringValue | null>();
+  protected readonly resolvedUrl = computed(() => this.resolvePrimitive(this.url()));
+}

vendor/a2ui/renderers/angular/src/lib/catalog/button.ts

@@ -0,0 +1,56 @@
+/*
+ Copyright 2025 Google LLC
+
+ Licensed under the Apache License, Version 2.0 (the "License");
+ you may not use this file except in compliance with the License.
+ You may obtain a copy of the License at
+
+      https://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+ */
+
+import { Component, input } from '@angular/core';
+import { Types } from '@a2ui/lit/0.8';
+import { DynamicComponent } from '../rendering/dynamic-component';
+import { Renderer } from '../rendering/renderer';
+
+@Component({
+  selector: 'a2ui-button',
+  imports: [Renderer],
+  template: `
+    <button
+      [class]="theme.components.Button"
+      [style]="theme.additionalStyles?.Button"
+      (click)="handleClick()"
+    >
+      <ng-container
+        a2ui-renderer
+        [surfaceId]="surfaceId()!"
+        [component]="component().properties.child"
+      />
+    </button>
+  `,
+  styles: `
+    :host {
+      display: block;
+      flex: var(--weight);
+      min-height: 0;
+    }
+  `,
+})
+export class Button extends DynamicComponent<Types.ButtonNode> {
+  readonly action = input.required<Types.Action | null>();
+
+  protected handleClick() {
+    const action = this.action();
+
+    if (action) {
+      super.sendAction(action);
+    }
+  }
+}

vendor/a2ui/renderers/angular/src/lib/catalog/card.ts

@@ -0,0 +1,57 @@
+/*
+ Copyright 2025 Google LLC
+
+ Licensed under the Apache License, Version 2.0 (the "License");
+ you may not use this file except in compliance with the License.
+ You may obtain a copy of the License at
+
+      https://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+ */
+
+import { Component, ViewEncapsulation } from '@angular/core';
+import { DynamicComponent } from '../rendering/dynamic-component';
+import { Renderer } from '../rendering/renderer';
+import { Types } from '@a2ui/lit/0.8';
+
+@Component({
+  selector: 'a2ui-card',
+  imports: [Renderer],
+  encapsulation: ViewEncapsulation.None,
+  styles: `
+    a2ui-card {
+      display: block;
+      flex: var(--weight);
+      min-height: 0;
+      overflow: auto;
+    }
+
+    a2ui-card > section {
+      height: 100%;
+      width: 100%;
+      min-height: 0;
+      overflow: auto;
+    }
+
+    a2ui-card > section > * {
+      height: 100%;
+      width: 100%;
+    }
+  `,
+  template: `
+    @let properties = component().properties;
+    @let children = properties.children || [properties.child];
+
+    <section [class]="theme.components.Card" [style]="theme.additionalStyles?.Card">
+      @for (child of children; track child) {
+        <ng-container a2ui-renderer [surfaceId]="surfaceId()!" [component]="child" />
+      }
+    </section>
+  `,
+})
+export class Card extends DynamicComponent<Types.CardNode> { }

vendor/a2ui/renderers/angular/src/lib/catalog/checkbox.ts

@@ -0,0 +1,73 @@
+/*
+ Copyright 2025 Google LLC
+
+ Licensed under the Apache License, Version 2.0 (the "License");
+ you may not use this file except in compliance with the License.
+ You may obtain a copy of the License at
+
+      https://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+ */
+
+import { Component, computed, input } from '@angular/core';
+import { DynamicComponent } from '../rendering/dynamic-component';
+import { Primitives } from '@a2ui/lit/0.8';
+
+@Component({
+  selector: 'a2ui-checkbox',
+  template: `
+    <section
+      [class]="theme.components.CheckBox.container"
+      [style]="theme.additionalStyles?.CheckBox"
+    >
+      <input
+        autocomplete="off"
+        type="checkbox"
+        [id]="inputId"
+        [checked]="inputChecked()"
+        [class]="theme.components.CheckBox.element"
+        (change)="handleChange($event)"
+      />
+
+      <label [htmlFor]="inputId" [class]="theme.components.CheckBox.label">{{
+        resolvedLabel()
+      }}</label>
+    </section>
+  `,
+  styles: `
+    :host {
+      display: block;
+      flex: var(--weight);
+      min-height: 0;
+      overflow: auto;
+    }
+
+    input {
+      display: block;
+      width: 100%;
+    }
+  `,
+})
+export class Checkbox extends DynamicComponent {
+  readonly value = input.required<Primitives.BooleanValue | null>();
+  readonly label = input.required<Primitives.StringValue | null>();
+
+  protected inputChecked = computed(() => super.resolvePrimitive(this.value()) ?? false);
+  protected resolvedLabel = computed(() => super.resolvePrimitive(this.label()));
+  protected inputId = super.getUniqueId('a2ui-checkbox');
+
+  protected handleChange(event: Event) {
+    const path = this.value()?.path;
+
+    if (!(event.target instanceof HTMLInputElement) || !path) {
+      return;
+    }
+
+    this.processor.setData(this.component(), path, event.target.checked, this.surfaceId());
+  }
+}

vendor/a2ui/renderers/angular/src/lib/catalog/column.ts

@@ -0,0 +1,96 @@
+/*
+ Copyright 2025 Google LLC
+
+ Licensed under the Apache License, Version 2.0 (the "License");
+ you may not use this file except in compliance with the License.
+ You may obtain a copy of the License at
+
+      https://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+ */
+
+import { Component, computed, input } from '@angular/core';
+import { Types } from '@a2ui/lit/0.8';
+import { DynamicComponent } from '../rendering/dynamic-component';
+import { Renderer } from '../rendering/renderer';
+
+@Component({
+  selector: 'a2ui-column',
+  imports: [Renderer],
+  styles: `
+    :host {
+      display: flex;
+      flex: var(--weight);
+    }
+
+    section {
+      display: flex;
+      flex-direction: column;
+      min-width: 100%;
+      height: 100%;
+      box-sizing: border-box;
+    }
+
+    .align-start {
+      align-items: start;
+    }
+
+    .align-center {
+      align-items: center;
+    }
+
+    .align-end {
+      align-items: end;
+    }
+
+    .align-stretch {
+      align-items: stretch;
+    }
+
+    .distribute-start {
+      justify-content: start;
+    }
+
+    .distribute-center {
+      justify-content: center;
+    }
+
+    .distribute-end {
+      justify-content: end;
+    }
+
+    .distribute-spaceBetween {
+      justify-content: space-between;
+    }
+
+    .distribute-spaceAround {
+      justify-content: space-around;
+    }
+
+    .distribute-spaceEvenly {
+      justify-content: space-evenly;
+    }
+  `,
+  template: `
+    <section [class]="classes()" [style]="theme.additionalStyles?.Column">
+      @for (child of component().properties.children; track child) {
+        <ng-container a2ui-renderer [surfaceId]="surfaceId()!" [component]="child" />
+      }
+    </section>
+  `,
+})
+export class Column extends DynamicComponent<Types.ColumnNode> {
+  readonly alignment = input<Types.ResolvedColumn['alignment']>('stretch');
+  readonly distribution = input<Types.ResolvedColumn['distribution']>('start');
+
+  protected readonly classes = computed(() => ({
+    ...this.theme.components.Column,
+    [`align-${this.alignment()}`]: true,
+    [`distribute-${this.distribution()}`]: true,
+  }));
+}

vendor/a2ui/renderers/angular/src/lib/catalog/datetime-input.ts

@@ -0,0 +1,127 @@
+/*
+ Copyright 2025 Google LLC
+
+ Licensed under the Apache License, Version 2.0 (the "License");
+ you may not use this file except in compliance with the License.
+ You may obtain a copy of the License at
+
+      https://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+ */
+
+import { computed, Component, input } from '@angular/core';
+import { DynamicComponent } from '../rendering/dynamic-component';
+import { Primitives } from '@a2ui/lit/0.8';
+
+@Component({
+  selector: 'a2ui-datetime-input',
+  template: `
+    <section [class]="theme.components.DateTimeInput.container">
+      <label [for]="inputId" [class]="theme.components.DateTimeInput.label">{{ label() }}</label>
+
+      <input
+        autocomplete="off"
+        [attr.type]="inputType()"
+        [id]="inputId"
+        [class]="theme.components.DateTimeInput.element"
+        [style]="theme.additionalStyles?.DateTimeInput"
+        [value]="inputValue()"
+        (input)="handleInput($event)"
+      />
+    </section>
+  `,
+  styles: `
+    :host {
+      display: block;
+      flex: var(--weight);
+      min-height: 0;
+      overflow: auto;
+    }
+
+    input {
+      display: block;
+      width: 100%;
+      box-sizing: border-box;
+    }
+  `,
+})
+export class DatetimeInput extends DynamicComponent {
+  readonly value = input.required<Primitives.StringValue | null>();
+  readonly enableDate = input.required<boolean>();
+  readonly enableTime = input.required<boolean>();
+  protected readonly inputId = super.getUniqueId('a2ui-datetime-input');
+
+  protected inputType = computed(() => {
+    const enableDate = this.enableDate();
+    const enableTime = this.enableTime();
+
+    if (enableDate && enableTime) {
+      return 'datetime-local';
+    } else if (enableDate) {
+      return 'date';
+    } else if (enableTime) {
+      return 'time';
+    }
+
+    return 'datetime-local';
+  });
+
+  protected label = computed(() => {
+    // TODO: this should likely be passed from the model.
+    const inputType = this.inputType();
+
+    if (inputType === 'date') {
+      return 'Date';
+    } else if (inputType === 'time') {
+      return 'Time';
+    }
+
+    return 'Date & Time';
+  });
+
+  protected inputValue = computed(() => {
+    const inputType = this.inputType();
+    const parsed = super.resolvePrimitive(this.value()) || '';
+    const date = parsed ? new Date(parsed) : null;
+
+    if (!date || isNaN(date.getTime())) {
+      return '';
+    }
+
+    const year = this.padNumber(date.getFullYear());
+    const month = this.padNumber(date.getMonth());
+    const day = this.padNumber(date.getDate());
+    const hours = this.padNumber(date.getHours());
+    const minutes = this.padNumber(date.getMinutes());
+
+    // Browsers are picky with what format they allow for the `value` attribute of date/time inputs.
+    // We need to parse it out of the provided value. Note that we don't use `toISOString`,
+    // because the resulting value is relative to UTC.
+    if (inputType === 'date') {
+      return `${year}-${month}-${day}`;
+    } else if (inputType === 'time') {
+      return `${hours}:${minutes}`;
+    }
+
+    return `${year}-${month}-${day}T${hours}:${minutes}`;
+  });
+
+  protected handleInput(event: Event) {
+    const path = this.value()?.path;
+
+    if (!(event.target instanceof HTMLInputElement) || !path) {
+      return;
+    }
+
+    this.processor.setData(this.component(), path, event.target.value, this.surfaceId());
+  }
+
+  private padNumber(value: number) {
+    return value.toString().padStart(2, '0');
+  }
+}

vendor/a2ui/renderers/angular/src/lib/catalog/default.ts

@@ -0,0 +1,185 @@
+/*
+ Copyright 2025 Google LLC
+
+ Licensed under the Apache License, Version 2.0 (the "License");
+ you may not use this file except in compliance with the License.
+ You may obtain a copy of the License at
+
+      https://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+ */
+
+import { inputBinding } from '@angular/core';
+import { Types } from '@a2ui/lit/0.8';
+import { Catalog } from '../rendering/catalog';
+import { Row } from './row';
+import { Column } from './column';
+import { Text } from './text';
+
+export const DEFAULT_CATALOG: Catalog = {
+  Row: {
+    type: () => Row,
+    bindings: (node) => {
+      const properties = (node as Types.RowNode).properties;
+      return [
+        inputBinding('alignment', () => properties.alignment ?? 'stretch'),
+        inputBinding('distribution', () => properties.distribution ?? 'start'),
+      ];
+    },
+  },
+
+  Column: {
+    type: () => Column,
+    bindings: (node) => {
+      const properties = (node as Types.ColumnNode).properties;
+      return [
+        inputBinding('alignment', () => properties.alignment ?? 'stretch'),
+        inputBinding('distribution', () => properties.distribution ?? 'start'),
+      ];
+    },
+  },
+
+  List: {
+    type: () => import('./list').then((r) => r.List),
+    bindings: (node) => {
+      const properties = (node as Types.ListNode).properties;
+      return [inputBinding('direction', () => properties.direction ?? 'vertical')];
+    },
+  },
+
+  Card: () => import('./card').then((r) => r.Card),
+
+  Image: {
+    type: () => import('./image').then((r) => r.Image),
+    bindings: (node) => {
+      const properties = (node as Types.ImageNode).properties;
+      return [
+        inputBinding('url', () => properties.url),
+        inputBinding('usageHint', () => properties.usageHint),
+      ];
+    },
+  },
+
+  Icon: {
+    type: () => import('./icon').then((r) => r.Icon),
+    bindings: (node) => {
+      const properties = (node as Types.IconNode).properties;
+      return [inputBinding('name', () => properties.name)];
+    },
+  },
+
+  Video: {
+    type: () => import('./video').then((r) => r.Video),
+    bindings: (node) => {
+      const properties = (node as Types.VideoNode).properties;
+      return [inputBinding('url', () => properties.url)];
+    },
+  },
+
+  AudioPlayer: {
+    type: () => import('./audio').then((r) => r.Audio),
+    bindings: (node) => {
+      const properties = (node as Types.AudioPlayerNode).properties;
+      return [inputBinding('url', () => properties.url)];
+    },
+  },
+
+  Text: {
+    type: () => Text,
+    bindings: (node) => {
+      const properties = (node as Types.TextNode).properties;
+      return [
+        inputBinding('text', () => properties.text),
+        inputBinding('usageHint', () => properties.usageHint || null),
+      ];
+    },
+  },
+
+  Button: {
+    type: () => import('./button').then((r) => r.Button),
+    bindings: (node) => {
+      const properties = (node as Types.ButtonNode).properties;
+      return [inputBinding('action', () => properties.action)];
+    },
+  },
+
+  Divider: () => import('./divider').then((r) => r.Divider),
+
+  MultipleChoice: {
+    type: () => import('./multiple-choice').then((r) => r.MultipleChoice),
+    bindings: (node) => {
+      const properties = (node as Types.MultipleChoiceNode).properties;
+      return [
+        inputBinding('options', () => properties.options || []),
+        inputBinding('value', () => properties.selections),
+        inputBinding('description', () => 'Select an item'), // TODO: this should be defined in the properties
+      ];
+    },
+  },
+
+  TextField: {
+    type: () => import('./text-field').then((r) => r.TextField),
+    bindings: (node) => {
+      const properties = (node as Types.TextFieldNode).properties;
+      return [
+        inputBinding('text', () => properties.text ?? null),
+        inputBinding('label', () => properties.label),
+        inputBinding('inputType', () => properties.type),
+      ];
+    },
+  },
+
+  DateTimeInput: {
+    type: () => import('./datetime-input').then((r) => r.DatetimeInput),
+    bindings: (node) => {
+      const properties = (node as Types.DateTimeInputNode).properties;
+      return [
+        inputBinding('enableDate', () => properties.enableDate),
+        inputBinding('enableTime', () => properties.enableTime),
+        inputBinding('value', () => properties.value),
+      ];
+    },
+  },
+
+  CheckBox: {
+    type: () => import('./checkbox').then((r) => r.Checkbox),
+    bindings: (node) => {
+      const properties = (node as Types.CheckboxNode).properties;
+      return [
+        inputBinding('label', () => properties.label),
+        inputBinding('value', () => properties.value),
+      ];
+    },
+  },
+
+  Slider: {
+    type: () => import('./slider').then((r) => r.Slider),
+    bindings: (node) => {
+      const properties = (node as Types.SliderNode).properties;
+      return [
+        inputBinding('value', () => properties.value),
+        inputBinding('minValue', () => properties.minValue),
+        inputBinding('maxValue', () => properties.maxValue),
+        inputBinding('label', () => ''), // TODO: this should be defined in the properties
+      ];
+    },
+  },
+
+  Tabs: {
+    type: () => import('./tabs').then((r) => r.Tabs),
+    bindings: (node) => {
+      const properties = (node as Types.TabsNode).properties;
+      return [inputBinding('tabs', () => properties.tabItems)];
+    },
+  },
+
+  Modal: {
+    type: () => import('./modal').then((r) => r.Modal),
+    bindings: () => [],
+  },
+};

vendor/a2ui/renderers/angular/src/lib/catalog/divider.ts

@@ -0,0 +1,37 @@
+/*
+ Copyright 2025 Google LLC
+
+ Licensed under the Apache License, Version 2.0 (the "License");
+ you may not use this file except in compliance with the License.
+ You may obtain a copy of the License at
+
+      https://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+ */
+
+import { Component } from '@angular/core';
+import { DynamicComponent } from '../rendering/dynamic-component';
+
+@Component({
+  selector: 'a2ui-divider',
+  template: '<hr [class]="theme.components.Divider" [style]="theme.additionalStyles?.Divider"/>',
+  styles: `
+    :host {
+      display: block;
+      min-height: 0;
+      overflow: auto;
+    }
+
+    hr {
+      height: 1px;
+      background: #ccc;
+      border: none;
+    }
+  `,
+})
+export class Divider extends DynamicComponent {}

vendor/a2ui/renderers/angular/src/lib/catalog/icon.ts

@@ -0,0 +1,44 @@
+/*
+ Copyright 2025 Google LLC
+
+ Licensed under the Apache License, Version 2.0 (the "License");
+ you may not use this file except in compliance with the License.
+ You may obtain a copy of the License at
+
+      https://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+ */
+
+import { Component, computed, input } from '@angular/core';
+import { DynamicComponent } from '../rendering/dynamic-component';
+import { Primitives } from '@a2ui/lit/0.8';
+
+@Component({
+  selector: 'a2ui-icon',
+  styles: `
+    :host {
+      display: block;
+      flex: var(--weight);
+      min-height: 0;
+      overflow: auto;
+    }
+  `,
+  template: `
+    @let resolvedName = this.resolvedName();
+
+    @if (resolvedName) {
+      <section [class]="theme.components.Icon" [style]="theme.additionalStyles?.Icon">
+        <span class="g-icon">{{ resolvedName }}</span>
+      </section>
+    }
+  `,
+})
+export class Icon extends DynamicComponent {
+  readonly name = input.required<Primitives.StringValue | null>();
+  protected readonly resolvedName = computed(() => this.resolvePrimitive(this.name()));
+}

vendor/a2ui/renderers/angular/src/lib/catalog/image.ts

@@ -0,0 +1,62 @@
+/*
+ Copyright 2025 Google LLC
+
+ Licensed under the Apache License, Version 2.0 (the "License");
+ you may not use this file except in compliance with the License.
+ You may obtain a copy of the License at
+
+      https://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+ */
+
+import { Component, computed, input } from '@angular/core';
+import { Primitives, Styles, Types } from '@a2ui/lit/0.8';
+import { DynamicComponent } from '../rendering/dynamic-component';
+
+@Component({
+  selector: 'a2ui-image',
+  styles: `
+    :host {
+      display: block;
+      flex: var(--weight);
+      min-height: 0;
+      overflow: auto;
+    }
+
+    img {
+      display: block;
+      width: 100%;
+      height: 100%;
+      box-sizing: border-box;
+    }
+  `,
+  template: `
+    @let resolvedUrl = this.resolvedUrl();
+
+    @if (resolvedUrl) {
+      <section [class]="classes()" [style]="theme.additionalStyles?.Image">
+        <img [src]="resolvedUrl" />
+      </section>
+    }
+  `,
+})
+export class Image extends DynamicComponent {
+  readonly url = input.required<Primitives.StringValue | null>();
+  readonly usageHint = input.required<Types.ResolvedImage['usageHint'] | null>();
+
+  protected readonly resolvedUrl = computed(() => this.resolvePrimitive(this.url()));
+
+  protected classes = computed(() => {
+    const usageHint = this.usageHint();
+
+    return Styles.merge(
+      this.theme.components.Image.all,
+      usageHint ? this.theme.components.Image[usageHint] : {},
+    );
+  });
+}

vendor/a2ui/renderers/angular/src/lib/catalog/list.ts

@@ -0,0 +1,63 @@
+/*
+ Copyright 2025 Google LLC
+
+ Licensed under the Apache License, Version 2.0 (the "License");
+ you may not use this file except in compliance with the License.
+ You may obtain a copy of the License at
+
+      https://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+ */
+
+import { Component, input } from '@angular/core';
+import { Types } from '@a2ui/lit/0.8';
+import { DynamicComponent } from '../rendering/dynamic-component';
+import { Renderer } from '../rendering/renderer';
+
+@Component({
+  selector: 'a2ui-list',
+  imports: [Renderer],
+  host: {
+    '[attr.direction]': 'direction()',
+  },
+  styles: `
+    :host {
+      display: block;
+      flex: var(--weight);
+      min-height: 0;
+      overflow: auto;
+    }
+
+    :host([direction='vertical']) section {
+      display: grid;
+    }
+
+    :host([direction='horizontal']) section {
+      display: flex;
+      max-width: 100%;
+      overflow-x: scroll;
+      overflow-y: hidden;
+      scrollbar-width: none;
+
+      > ::slotted(*) {
+        flex: 1 0 fit-content;
+        max-width: min(80%, 400px);
+      }
+    }
+  `,
+  template: `
+    <section [class]="theme.components.List" [style]="theme.additionalStyles?.List">
+      @for (child of component().properties.children; track child) {
+        <ng-container a2ui-renderer [surfaceId]="surfaceId()!" [component]="child" />
+      }
+    </section>
+  `,
+})
+export class List extends DynamicComponent<Types.ListNode> {
+  readonly direction = input<'vertical' | 'horizontal'>('vertical');
+}

vendor/a2ui/renderers/angular/src/lib/catalog/modal.ts

@@ -0,0 +1,113 @@
+/*
+ Copyright 2025 Google LLC
+
+ Licensed under the Apache License, Version 2.0 (the "License");
+ you may not use this file except in compliance with the License.
+ You may obtain a copy of the License at
+
+      https://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+ */
+
+import { Component, signal, viewChild, ElementRef, effect } from '@angular/core';
+import { DynamicComponent } from '../rendering/dynamic-component';
+import { Types } from '@a2ui/lit/0.8';
+import { Renderer } from '../rendering';
+
+@Component({
+  selector: 'a2ui-modal',
+  imports: [Renderer],
+  template: `
+    @if (showDialog()) {
+      <dialog #dialog [class]="theme.components.Modal.backdrop" (click)="handleDialogClick($event)">
+        <section [class]="theme.components.Modal.element" [style]="theme.additionalStyles?.Modal">
+          <div class="controls">
+            <button (click)="closeDialog()">
+              <span class="g-icon">close</span>
+            </button>
+          </div>
+
+          <ng-container
+            a2ui-renderer
+            [surfaceId]="surfaceId()!"
+            [component]="component().properties.contentChild"
+          />
+        </section>
+      </dialog>
+    } @else {
+      <section (click)="showDialog.set(true)">
+        <ng-container
+          a2ui-renderer
+          [surfaceId]="surfaceId()!"
+          [component]="component().properties.entryPointChild"
+        />
+      </section>
+    }
+  `,
+  styles: `
+    dialog {
+      padding: 0;
+      border: none;
+      background: none;
+
+      & section {
+        & .controls {
+          display: flex;
+          justify-content: end;
+          margin-bottom: 4px;
+
+          & button {
+            padding: 0;
+            background: none;
+            width: 20px;
+            height: 20px;
+            pointer: cursor;
+            border: none;
+            cursor: pointer;
+          }
+        }
+      }
+    }
+  `,
+})
+export class Modal extends DynamicComponent<Types.ModalNode> {
+  protected readonly showDialog = signal(false);
+  protected readonly dialog = viewChild<ElementRef<HTMLDialogElement>>('dialog');
+
+  constructor() {
+    super();
+
+    effect(() => {
+      const dialog = this.dialog();
+
+      if (dialog && !dialog.nativeElement.open) {
+        dialog.nativeElement.showModal();
+      }
+    });
+  }
+
+  protected handleDialogClick(event: MouseEvent) {
+    if (event.target instanceof HTMLDialogElement) {
+      this.closeDialog();
+    }
+  }
+
+  protected closeDialog() {
+    const dialog = this.dialog();
+
+    if (!dialog) {
+      return;
+    }
+
+    if (!dialog.nativeElement.open) {
+      dialog.nativeElement.close();
+    }
+
+    this.showDialog.set(false);
+  }
+}

vendor/a2ui/renderers/angular/src/lib/catalog/multiple-choice.ts

@@ -0,0 +1,77 @@
+/*
+ Copyright 2025 Google LLC
+
+ Licensed under the Apache License, Version 2.0 (the "License");
+ you may not use this file except in compliance with the License.
+ You may obtain a copy of the License at
+
+      https://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+ */
+
+import { Component, computed, input } from '@angular/core';
+import { DynamicComponent } from '../rendering/dynamic-component';
+import { Primitives } from '@a2ui/lit/0.8';
+
+@Component({
+  selector: 'a2ui-multiple-choice',
+  template: `
+    <section [class]="theme.components.MultipleChoice.container">
+      <label [class]="theme.components.MultipleChoice.label" [for]="selectId">{{
+        description()
+      }}</label>
+
+      <select
+        (change)="handleChange($event)"
+        [id]="selectId"
+        [value]="selectValue()"
+        [class]="theme.components.MultipleChoice.element"
+        [style]="theme.additionalStyles?.MultipleChoice"
+      >
+        @for (option of options(); track option.value) {
+          <option [value]="option.value">{{ resolvePrimitive(option.label) }}</option>
+        }
+      </select>
+    </section>
+  `,
+  styles: `
+    :host {
+      display: block;
+      flex: var(--weight);
+      min-height: 0;
+      overflow: auto;
+    }
+
+    select {
+      width: 100%;
+      box-sizing: border-box;
+    }
+  `,
+})
+export class MultipleChoice extends DynamicComponent {
+  readonly options = input.required<{ label: Primitives.StringValue; value: string }[]>();
+  readonly value = input.required<Primitives.StringValue | null>();
+  readonly description = input.required<string>();
+
+  protected readonly selectId = super.getUniqueId('a2ui-multiple-choice');
+  protected selectValue = computed(() => super.resolvePrimitive(this.value()));
+
+  protected handleChange(event: Event) {
+    const path = this.value()?.path;
+
+    if (!(event.target instanceof HTMLSelectElement) || !event.target.value || !path) {
+      return;
+    }
+
+    this.processor.setData(
+      this.component(),
+      this.processor.resolvePath(path, this.component().dataContextPath),
+      event.target.value,
+    );
+  }
+}

vendor/a2ui/renderers/angular/src/lib/catalog/row.ts

@@ -0,0 +1,100 @@
+/*
+ Copyright 2025 Google LLC
+
+ Licensed under the Apache License, Version 2.0 (the "License");
+ you may not use this file except in compliance with the License.
+ You may obtain a copy of the License at
+
+      https://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+ */
+
+import { Component, computed, input } from '@angular/core';
+import { DynamicComponent } from '../rendering/dynamic-component';
+import { Renderer } from '../rendering/renderer';
+import { Types } from '@a2ui/lit/0.8';
+
+@Component({
+  selector: 'a2ui-row',
+  imports: [Renderer],
+  host: {
+    '[attr.alignment]': 'alignment()',
+    '[attr.distribution]': 'distribution()',
+  },
+  styles: `
+    :host {
+      display: flex;
+      flex: var(--weight);
+    }
+
+    section {
+      display: flex;
+      flex-direction: row;
+      width: 100%;
+      min-height: 100%;
+      box-sizing: border-box;
+    }
+
+    .align-start {
+      align-items: start;
+    }
+
+    .align-center {
+      align-items: center;
+    }
+
+    .align-end {
+      align-items: end;
+    }
+
+    .align-stretch {
+      align-items: stretch;
+    }
+
+    .distribute-start {
+      justify-content: start;
+    }
+
+    .distribute-center {
+      justify-content: center;
+    }
+
+    .distribute-end {
+      justify-content: end;
+    }
+
+    .distribute-spaceBetween {
+      justify-content: space-between;
+    }
+
+    .distribute-spaceAround {
+      justify-content: space-around;
+    }
+
+    .distribute-spaceEvenly {
+      justify-content: space-evenly;
+    }
+  `,
+  template: `
+    <section [class]="classes()" [style]="theme.additionalStyles?.Row">
+      @for (child of component().properties.children; track child) {
+        <ng-container a2ui-renderer [surfaceId]="surfaceId()!" [component]="child" />
+      }
+    </section>
+  `,
+})
+export class Row extends DynamicComponent<Types.RowNode> {
+  readonly alignment = input<Types.ResolvedRow['alignment']>('stretch');
+  readonly distribution = input<Types.ResolvedRow['distribution']>('start');
+
+  protected readonly classes = computed(() => ({
+    ...this.theme.components.Row,
+    [`align-${this.alignment()}`]: true,
+    [`distribute-${this.distribution()}`]: true,
+  }));
+}

vendor/a2ui/renderers/angular/src/lib/catalog/slider.ts

@@ -0,0 +1,73 @@
+/*
+ Copyright 2025 Google LLC
+
+ Licensed under the Apache License, Version 2.0 (the "License");
+ you may not use this file except in compliance with the License.
+ You may obtain a copy of the License at
+
+      https://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+ */
+
+import { Component, computed, input } from '@angular/core';
+import { Primitives } from '@a2ui/lit/0.8';
+import { DynamicComponent } from '../rendering/dynamic-component';
+
+@Component({
+  selector: '[a2ui-slider]',
+  template: `
+    <section [class]="theme.components.Slider.container">
+      <label [class]="theme.components.Slider.label" [for]="inputId">
+        {{ label() }}
+      </label>
+
+      <input
+        autocomplete="off"
+        type="range"
+        [value]="resolvedValue()"
+        [min]="minValue()"
+        [max]="maxValue()"
+        [id]="inputId"
+        (input)="handleInput($event)"
+        [class]="theme.components.Slider.element"
+        [style]="theme.additionalStyles?.Slider"
+      />
+    </section>
+  `,
+  styles: `
+    :host {
+      display: block;
+      flex: var(--weight);
+    }
+
+    input {
+      display: block;
+      width: 100%;
+      box-sizing: border-box;
+    }
+  `,
+})
+export class Slider extends DynamicComponent {
+  readonly value = input.required<Primitives.NumberValue | null>();
+  readonly label = input('');
+  readonly minValue = input.required<number | undefined>();
+  readonly maxValue = input.required<number | undefined>();
+
+  protected readonly inputId = super.getUniqueId('a2ui-slider');
+  protected resolvedValue = computed(() => super.resolvePrimitive(this.value()) ?? 0);
+
+  protected handleInput(event: Event) {
+    const path = this.value()?.path;
+
+    if (!(event.target instanceof HTMLInputElement) || !path) {
+      return;
+    }
+
+    this.processor.setData(this.component(), path, event.target.valueAsNumber, this.surfaceId());
+  }
+}

vendor/a2ui/renderers/angular/src/lib/catalog/surface.ts

@@ -0,0 +1,99 @@
+/*
+ Copyright 2025 Google LLC
+
+ Licensed under the Apache License, Version 2.0 (the "License");
+ you may not use this file except in compliance with the License.
+ You may obtain a copy of the License at
+
+      https://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+ */
+
+import { Component, computed, input } from '@angular/core';
+import { Types } from '@a2ui/lit/0.8';
+import { Renderer } from '../rendering/renderer';
+
+@Component({
+  selector: 'a2ui-surface',
+  imports: [Renderer],
+  template: `
+    @let surfaceId = this.surfaceId();
+    @let surface = this.surface();
+
+    @if (surfaceId && surface) {
+      <ng-container a2ui-renderer [surfaceId]="surfaceId" [component]="surface.componentTree!" />
+    }
+  `,
+  styles: `
+    :host {
+      display: flex;
+      min-height: 0;
+      max-height: 100%;
+      flex-direction: column;
+      gap: 16px;
+    }
+  `,
+  host: {
+    '[style]': 'styles()',
+  },
+})
+export class Surface {
+  readonly surfaceId = input.required<Types.SurfaceID | null>();
+  readonly surface = input.required<Types.Surface | null>();
+
+  protected readonly styles = computed(() => {
+    const surface = this.surface();
+    const styles: Record<string, string> = {};
+
+    if (surface?.styles) {
+      for (const [key, value] of Object.entries(surface.styles)) {
+        switch (key) {
+          // Here we generate a palette from the singular primary color received
+          // from the surface data. We will want the values to range from
+          // 0 <= x <= 100, where 0 = back, 100 = white, and 50 = the primary
+          // color itself. As such we use a color-mix to create the intermediate
+          // values.
+          //
+          // Note: since we use half the range for black to the primary color,
+          // and half the range for primary color to white the mixed values have
+          // to go up double the amount, i.e., a range from black to primary
+          // color needs to fit in 0 -> 50 rather than 0 -> 100.
+          case 'primaryColor': {
+            styles['--p-100'] = '#ffffff';
+            styles['--p-99'] = `color-mix(in srgb, ${value} 2%, white 98%)`;
+            styles['--p-98'] = `color-mix(in srgb, ${value} 4%, white 96%)`;
+            styles['--p-95'] = `color-mix(in srgb, ${value} 10%, white 90%)`;
+            styles['--p-90'] = `color-mix(in srgb, ${value} 20%, white 80%)`;
+            styles['--p-80'] = `color-mix(in srgb, ${value} 40%, white 60%)`;
+            styles['--p-70'] = `color-mix(in srgb, ${value} 60%, white 40%)`;
+            styles['--p-60'] = `color-mix(in srgb, ${value} 80%, white 20%)`;
+            styles['--p-50'] = value;
+            styles['--p-40'] = `color-mix(in srgb, ${value} 80%, black 20%)`;
+            styles['--p-35'] = `color-mix(in srgb, ${value} 70%, black 30%)`;
+            styles['--p-30'] = `color-mix(in srgb, ${value} 60%, black 40%)`;
+            styles['--p-25'] = `color-mix(in srgb, ${value} 50%, black 50%)`;
+            styles['--p-20'] = `color-mix(in srgb, ${value} 40%, black 60%)`;
+            styles['--p-15'] = `color-mix(in srgb, ${value} 30%, black 70%)`;
+            styles['--p-10'] = `color-mix(in srgb, ${value} 20%, black 80%)`;
+            styles['--p-5'] = `color-mix(in srgb, ${value} 10%, black 90%)`;
+            styles['--0'] = '#00000';
+            break;
+          }
+
+          case 'font': {
+            styles['--font-family'] = value;
+            styles['--font-family-flex'] = value;
+            break;
+          }
+        }
+      }
+    }
+
+    return styles;
+  });
+}

vendor/a2ui/renderers/angular/src/lib/catalog/tabs.ts

@@ -0,0 +1,72 @@
+/*
+ Copyright 2025 Google LLC
+
+ Licensed under the Apache License, Version 2.0 (the "License");
+ you may not use this file except in compliance with the License.
+ You may obtain a copy of the License at
+
+      https://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+ */
+
+import { Component, computed, input, signal } from '@angular/core';
+import { DynamicComponent } from '../rendering/dynamic-component';
+import { Renderer } from '../rendering/renderer';
+import { Styles, Types } from '@a2ui/lit/0.8';
+
+@Component({
+  selector: 'a2ui-tabs',
+  imports: [Renderer],
+  template: `
+    @let tabs = this.tabs();
+    @let selectedIndex = this.selectedIndex();
+
+    <section [class]="theme.components.Tabs.container" [style]="theme.additionalStyles?.Tabs">
+      <div [class]="theme.components.Tabs.element">
+        @for (tab of tabs; track tab) {
+          <button
+            (click)="this.selectedIndex.set($index)"
+            [disabled]="selectedIndex === $index"
+            [class]="buttonClasses()[selectedIndex]"
+          >
+            {{ resolvePrimitive(tab.title) }}
+          </button>
+        }
+      </div>
+
+      <ng-container
+        a2ui-renderer
+        [surfaceId]="surfaceId()!"
+        [component]="tabs[selectedIndex].child"
+      />
+    </section>
+  `,
+  styles: `
+    :host {
+      display: block;
+      flex: var(--weight);
+    }
+  `,
+})
+export class Tabs extends DynamicComponent {
+  protected selectedIndex = signal(0);
+  readonly tabs = input.required<Types.ResolvedTabItem[]>();
+
+  protected readonly buttonClasses = computed(() => {
+    const selectedIndex = this.selectedIndex();
+
+    return this.tabs().map((_, index) => {
+      return index === selectedIndex
+        ? Styles.merge(
+          this.theme.components.Tabs.controls.all,
+          this.theme.components.Tabs.controls.selected,
+        )
+        : this.theme.components.Tabs.controls.all;
+    });
+  });
+}

vendor/a2ui/renderers/angular/src/lib/catalog/text-field.ts

@@ -0,0 +1,86 @@
+/*
+ Copyright 2025 Google LLC
+
+ Licensed under the Apache License, Version 2.0 (the "License");
+ you may not use this file except in compliance with the License.
+ You may obtain a copy of the License at
+
+      https://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+ */
+
+import { computed, Component, input } from '@angular/core';
+import { Primitives, Types } from '@a2ui/lit/0.8';
+import { DynamicComponent } from '../rendering/dynamic-component';
+
+@Component({
+  selector: 'a2ui-text-field',
+  styles: `
+    :host {
+      display: flex;
+      flex: var(--weight);
+    }
+
+    section,
+    input,
+    label {
+      box-sizing: border-box;
+    }
+
+    input {
+      display: block;
+      width: 100%;
+    }
+
+    label {
+      display: block;
+      margin-bottom: 4px;
+    }
+  `,
+  template: `
+    @let resolvedLabel = this.resolvedLabel();
+
+    <section [class]="theme.components.TextField.container">
+      @if (resolvedLabel) {
+        <label [for]="inputId" [class]="theme.components.TextField.label">{{
+          resolvedLabel
+        }}</label>
+      }
+
+      <input
+        autocomplete="off"
+        [class]="theme.components.TextField.element"
+        [style]="theme.additionalStyles?.TextField"
+        (input)="handleInput($event)"
+        [id]="inputId"
+        [value]="inputValue()"
+        placeholder="Please enter a value"
+        [type]="inputType() === 'number' ? 'number' : 'text'"
+      />
+    </section>
+  `,
+})
+export class TextField extends DynamicComponent {
+  readonly text = input.required<Primitives.StringValue | null>();
+  readonly label = input.required<Primitives.StringValue | null>();
+  readonly inputType = input.required<Types.ResolvedTextField['type'] | null>();
+
+  protected inputValue = computed(() => super.resolvePrimitive(this.text()) || '');
+  protected resolvedLabel = computed(() => super.resolvePrimitive(this.label()));
+  protected inputId = super.getUniqueId('a2ui-input');
+
+  protected handleInput(event: Event) {
+    const path = this.text()?.path;
+
+    if (!(event.target instanceof HTMLInputElement) || !path) {
+      return;
+    }
+
+    this.processor.setData(this.component(), path, event.target.value, this.surfaceId());
+  }
+}

vendor/a2ui/renderers/angular/src/lib/catalog/text.ts

@@ -0,0 +1,137 @@
+/*
+ Copyright 2025 Google LLC
+
+ Licensed under the Apache License, Version 2.0 (the "License");
+ you may not use this file except in compliance with the License.
+ You may obtain a copy of the License at
+
+      https://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+ */
+
+import { Component, computed, inject, input, ViewEncapsulation } from '@angular/core';
+import { DynamicComponent } from '../rendering/dynamic-component';
+import { Primitives, Styles, Types } from '@a2ui/lit/0.8';
+import { MarkdownRenderer } from '../data/markdown';
+
+interface HintedStyles {
+  h1: Record<string, string>;
+  h2: Record<string, string>;
+  h3: Record<string, string>;
+  h4: Record<string, string>;
+  h5: Record<string, string>;
+  body: Record<string, string>;
+  caption: Record<string, string>;
+}
+
+@Component({
+  selector: 'a2ui-text',
+  template: `
+    <section
+      [class]="classes()"
+      [style]="additionalStyles()"
+      [innerHTML]="resolvedText()"
+    ></section>
+  `,
+  encapsulation: ViewEncapsulation.None,
+  styles: `
+    a2ui-text {
+      display: block;
+      flex: var(--weight);
+    }
+
+    a2ui-text h1,
+    a2ui-text h2,
+    a2ui-text h3,
+    a2ui-text h4,
+    a2ui-text h5 {
+      line-height: inherit;
+      font: inherit;
+    }
+  `,
+})
+export class Text extends DynamicComponent {
+  private markdownRenderer = inject(MarkdownRenderer);
+  readonly text = input.required<Primitives.StringValue | null>();
+  readonly usageHint = input.required<Types.ResolvedText['usageHint'] | null>();
+
+  protected resolvedText = computed(() => {
+    const usageHint = this.usageHint();
+    let value = super.resolvePrimitive(this.text());
+
+    if (value == null) {
+      return '(empty)';
+    }
+
+    switch (usageHint) {
+      case 'h1':
+        value = `# ${value}`;
+        break;
+      case 'h2':
+        value = `## ${value}`;
+        break;
+      case 'h3':
+        value = `### ${value}`;
+        break;
+      case 'h4':
+        value = `#### ${value}`;
+        break;
+      case 'h5':
+        value = `##### ${value}`;
+        break;
+      case 'caption':
+        value = `*${value}*`;
+        break;
+      default:
+        value = String(value);
+        break;
+    }
+
+    return this.markdownRenderer.render(
+      value,
+      Styles.appendToAll(this.theme.markdown, ['ol', 'ul', 'li'], {}),
+    );
+  });
+
+  protected classes = computed(() => {
+    const usageHint = this.usageHint();
+
+    return Styles.merge(
+      this.theme.components.Text.all,
+      usageHint ? this.theme.components.Text[usageHint] : {},
+    );
+  });
+
+  protected additionalStyles = computed(() => {
+    const usageHint = this.usageHint();
+    const styles = this.theme.additionalStyles?.Text;
+
+    if (!styles) {
+      return null;
+    }
+
+    let additionalStyles: Record<string, string> = {};
+
+    if (this.areHintedStyles(styles)) {
+      additionalStyles = styles[usageHint ?? 'body'];
+    } else {
+      additionalStyles = styles;
+    }
+
+    return additionalStyles;
+  });
+
+  private areHintedStyles(styles: unknown): styles is HintedStyles {
+    if (typeof styles !== 'object' || !styles || Array.isArray(styles)) {
+      return false;
+    }
+
+    const expected = ['h1', 'h2', 'h3', 'h4', 'h5', 'h6', 'caption', 'body'];
+    return expected.every((v) => v in styles);
+  }
+}

vendor/a2ui/renderers/angular/src/lib/catalog/video.ts

@@ -0,0 +1,50 @@
+/*
+ Copyright 2025 Google LLC
+
+ Licensed under the Apache License, Version 2.0 (the "License");
+ you may not use this file except in compliance with the License.
+ You may obtain a copy of the License at
+
+      https://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+ */
+
+import { Component, computed, input } from '@angular/core';
+import { DynamicComponent } from '../rendering/dynamic-component';
+import { Primitives } from '@a2ui/lit/0.8';
+
+@Component({
+  selector: 'a2ui-video',
+  template: `
+    @let resolvedUrl = this.resolvedUrl();
+
+    @if (resolvedUrl) {
+      <section [class]="theme.components.Video" [style]="theme.additionalStyles?.Video">
+        <video controls [src]="resolvedUrl"></video>
+      </section>
+    }
+  `,
+  styles: `
+    :host {
+      display: block;
+      flex: var(--weight);
+      min-height: 0;
+      overflow: auto;
+    }
+
+    video {
+      display: block;
+      width: 100%;
+      box-sizing: border-box;
+    }
+  `,
+})
+export class Video extends DynamicComponent {
+  readonly url = input.required<Primitives.StringValue | null>();
+  protected readonly resolvedUrl = computed(() => this.resolvePrimitive(this.url()));
+}

vendor/a2ui/renderers/angular/src/lib/config.ts

@@ -0,0 +1,25 @@
+/*
+ Copyright 2025 Google LLC
+
+ Licensed under the Apache License, Version 2.0 (the "License");
+ you may not use this file except in compliance with the License.
+ You may obtain a copy of the License at
+
+      https://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+ */
+
+import { EnvironmentProviders, makeEnvironmentProviders } from '@angular/core';
+import { Catalog, Theme } from './rendering';
+
+export function provideA2UI(config: { catalog: Catalog; theme: Theme }): EnvironmentProviders {
+  return makeEnvironmentProviders([
+    { provide: Catalog, useValue: config.catalog },
+    { provide: Theme, useValue: config.theme },
+  ]);
+}

vendor/a2ui/renderers/angular/src/lib/data/index.ts

@@ -0,0 +1,18 @@
+/*
+ Copyright 2025 Google LLC
+
+ Licensed under the Apache License, Version 2.0 (the "License");
+ you may not use this file except in compliance with the License.
+ You may obtain a copy of the License at
+
+      https://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+ */
+
+export * from './processor';
+export * from './types';

vendor/a2ui/renderers/angular/src/lib/data/markdown.ts

@@ -0,0 +1,114 @@
+/*
+ Copyright 2025 Google LLC
+
+ Licensed under the Apache License, Version 2.0 (the "License");
+ you may not use this file except in compliance with the License.
+ You may obtain a copy of the License at
+
+      https://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+ */
+
+import { inject, Injectable, SecurityContext } from '@angular/core';
+import { DomSanitizer } from '@angular/platform-browser';
+import MarkdownIt from 'markdown-it';
+
+@Injectable({ providedIn: 'root' })
+export class MarkdownRenderer {
+  private originalClassMap = new Map<string, any>();
+  private sanitizer = inject(DomSanitizer);
+
+  private markdownIt = MarkdownIt({
+    highlight: (str, lang) => {
+      if (lang === 'html') {
+        const iframe = document.createElement('iframe');
+        iframe.classList.add('html-view');
+        iframe.srcdoc = str;
+        iframe.sandbox = '';
+        return iframe.innerHTML;
+      }
+
+      return str;
+    },
+  });
+
+  render(value: string, tagClassMap?: Record<string, string[]>) {
+    if (tagClassMap) {
+      this.applyTagClassMap(tagClassMap);
+    }
+    const htmlString = this.markdownIt.render(value);
+    this.unapplyTagClassMap();
+    return this.sanitizer.sanitize(SecurityContext.HTML, htmlString);
+  }
+
+  private applyTagClassMap(tagClassMap: Record<string, string[]>) {
+    Object.entries(tagClassMap).forEach(([tag, classes]) => {
+      let tokenName;
+      switch (tag) {
+        case 'p':
+          tokenName = 'paragraph';
+          break;
+        case 'h1':
+        case 'h2':
+        case 'h3':
+        case 'h4':
+        case 'h5':
+        case 'h6':
+          tokenName = 'heading';
+          break;
+        case 'ul':
+          tokenName = 'bullet_list';
+          break;
+        case 'ol':
+          tokenName = 'ordered_list';
+          break;
+        case 'li':
+          tokenName = 'list_item';
+          break;
+        case 'a':
+          tokenName = 'link';
+          break;
+        case 'strong':
+          tokenName = 'strong';
+          break;
+        case 'em':
+          tokenName = 'em';
+          break;
+      }
+
+      if (!tokenName) {
+        return;
+      }
+
+      const key = `${tokenName}_open`;
+      const original = this.markdownIt.renderer.rules[key];
+      this.originalClassMap.set(key, original);
+
+      this.markdownIt.renderer.rules[key] = (tokens, idx, options, env, self) => {
+        const token = tokens[idx];
+        for (const clazz of classes) {
+          token.attrJoin('class', clazz);
+        }
+
+        if (original) {
+          return original.call(this, tokens, idx, options, env, self);
+        } else {
+          return self.renderToken(tokens, idx, options);
+        }
+      };
+    });
+  }
+
+  private unapplyTagClassMap() {
+    for (const [key, original] of this.originalClassMap) {
+      this.markdownIt.renderer.rules[key] = original;
+    }
+
+    this.originalClassMap.clear();
+  }
+}

vendor/a2ui/renderers/angular/src/lib/data/processor.ts

@@ -0,0 +1,47 @@
+/*
+ Copyright 2025 Google LLC
+
+ Licensed under the Apache License, Version 2.0 (the "License");
+ you may not use this file except in compliance with the License.
+ You may obtain a copy of the License at
+
+      https://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+ */
+
+import { Data, Types } from '@a2ui/lit/0.8';
+import { Injectable } from '@angular/core';
+import { firstValueFrom, Subject } from 'rxjs';
+
+export interface DispatchedEvent {
+  message: Types.A2UIClientEventMessage;
+  completion: Subject<Types.ServerToClientMessage[]>;
+}
+
+@Injectable({ providedIn: 'root' })
+export class MessageProcessor extends Data.A2uiMessageProcessor {
+  readonly events = new Subject<DispatchedEvent>();
+
+  override setData(
+    node: Types.AnyComponentNode,
+    relativePath: string,
+    value: Types.DataValue,
+    surfaceId?: Types.SurfaceID | null,
+  ) {
+    // Override setData to convert from optional inputs (which can be null)
+    // to undefined so that this correctly falls back to the default value for
+    // surfaceId.
+    return super.setData(node, relativePath, value, surfaceId ?? undefined);
+  }
+
+  dispatch(message: Types.A2UIClientEventMessage): Promise<Types.ServerToClientMessage[]> {
+    const completion = new Subject<Types.ServerToClientMessage[]>();
+    this.events.next({ message, completion });
+    return firstValueFrom(completion);
+  }
+}

vendor/a2ui/renderers/angular/src/lib/data/types.ts

@@ -0,0 +1,29 @@
+/*
+ Copyright 2025 Google LLC
+
+ Licensed under the Apache License, Version 2.0 (the "License");
+ you may not use this file except in compliance with the License.
+ You may obtain a copy of the License at
+
+      https://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+ */
+
+import { Types } from '@a2ui/lit/0.8';
+
+export interface A2TextPayload {
+  kind: 'text';
+  text: string;
+}
+
+export interface A2DataPayload {
+  kind: 'data';
+  data: Types.ServerToClientMessage;
+}
+
+export type A2AServerPayload = Array<A2DataPayload | A2TextPayload> | { error: string };

vendor/a2ui/renderers/angular/src/lib/rendering/catalog.ts

@@ -0,0 +1,36 @@
+/*
+ Copyright 2025 Google LLC
+
+ Licensed under the Apache License, Version 2.0 (the "License");
+ you may not use this file except in compliance with the License.
+ You may obtain a copy of the License at
+
+      https://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+ */
+
+import { Binding, InjectionToken, Type } from '@angular/core';
+import { DynamicComponent } from './dynamic-component';
+import { Types } from '@a2ui/lit/0.8';
+
+export type CatalogLoader = () =>
+  | Promise<Type<DynamicComponent<any>>>
+  | Type<DynamicComponent<any>>;
+
+export type CatalogEntry<T extends Types.AnyComponentNode> =
+  | CatalogLoader
+  | {
+    type: CatalogLoader;
+    bindings: (data: T) => Binding[];
+  };
+
+export interface Catalog {
+  [key: string]: CatalogEntry<Types.AnyComponentNode>;
+}
+
+export const Catalog = new InjectionToken<Catalog>('Catalog');

vendor/a2ui/renderers/angular/src/lib/rendering/dynamic-component.ts

@@ -0,0 +1,100 @@
+/*
+ Copyright 2025 Google LLC
+
+ Licensed under the Apache License, Version 2.0 (the "License");
+ you may not use this file except in compliance with the License.
+ You may obtain a copy of the License at
+
+      https://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+ */
+
+import { Types, Primitives } from '@a2ui/lit/0.8';
+import { Directive, inject, input } from '@angular/core';
+import { MessageProcessor } from '../data';
+import { Theme } from './theming';
+
+let idCounter = 0;
+
+@Directive({
+  host: {
+    '[style.--weight]': 'weight()',
+  },
+})
+export abstract class DynamicComponent<T extends Types.AnyComponentNode = Types.AnyComponentNode> {
+  protected readonly processor = inject(MessageProcessor);
+  protected readonly theme = inject(Theme);
+
+  readonly surfaceId = input.required<Types.SurfaceID | null>();
+  readonly component = input.required<T>();
+  readonly weight = input.required<string | number>();
+
+  protected sendAction(action: Types.Action): Promise<Types.ServerToClientMessage[]> {
+    const component = this.component();
+    const surfaceId = this.surfaceId() ?? undefined;
+    const context: Record<string, unknown> = {};
+
+    if (action.context) {
+      for (const item of action.context) {
+        if (item.value.literalBoolean) {
+          context[item.key] = item.value.literalBoolean;
+        } else if (item.value.literalNumber) {
+          context[item.key] = item.value.literalNumber;
+        } else if (item.value.literalString) {
+          context[item.key] = item.value.literalString;
+        } else if (item.value.path) {
+          const path = this.processor.resolvePath(item.value.path, component.dataContextPath);
+          const value = this.processor.getData(component, path, surfaceId);
+          context[item.key] = value;
+        }
+      }
+    }
+
+    const message: Types.A2UIClientEventMessage = {
+      userAction: {
+        name: action.name,
+        sourceComponentId: component.id,
+        surfaceId: surfaceId!,
+        timestamp: new Date().toISOString(),
+        context,
+      },
+    };
+
+    return this.processor.dispatch(message);
+  }
+
+  protected resolvePrimitive(value: Primitives.StringValue | null): string | null;
+  protected resolvePrimitive(value: Primitives.BooleanValue | null): boolean | null;
+  protected resolvePrimitive(value: Primitives.NumberValue | null): number | null;
+  protected resolvePrimitive(
+    value: Primitives.StringValue | Primitives.BooleanValue | Primitives.NumberValue | null,
+  ) {
+    const component = this.component();
+    const surfaceId = this.surfaceId();
+
+    if (!value || typeof value !== 'object') {
+      return null;
+    } else if (value.literal != null) {
+      return value.literal;
+    } else if (value.path) {
+      return this.processor.getData(component, value.path, surfaceId ?? undefined);
+    } else if ('literalString' in value) {
+      return value.literalString;
+    } else if ('literalNumber' in value) {
+      return value.literalNumber;
+    } else if ('literalBoolean' in value) {
+      return value.literalBoolean;
+    }
+
+    return null;
+  }
+
+  protected getUniqueId(prefix: string) {
+    return `${prefix}-${idCounter++}`;
+  }
+}

vendor/a2ui/renderers/angular/src/lib/rendering/index.ts

@@ -0,0 +1,20 @@
+/*
+ Copyright 2025 Google LLC
+
+ Licensed under the Apache License, Version 2.0 (the "License");
+ you may not use this file except in compliance with the License.
+ You may obtain a copy of the License at
+
+      https://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+ */
+
+export * from './catalog';
+export * from './dynamic-component';
+export * from './renderer';
+export * from './theming';

vendor/a2ui/renderers/angular/src/lib/rendering/renderer.ts

@@ -0,0 +1,109 @@
+/*
+ Copyright 2025 Google LLC
+
+ Licensed under the Apache License, Version 2.0 (the "License");
+ you may not use this file except in compliance with the License.
+ You may obtain a copy of the License at
+
+      https://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+ */
+
+import {
+  Binding,
+  ComponentRef,
+  Directive,
+  DOCUMENT,
+  effect,
+  inject,
+  input,
+  inputBinding,
+  OnDestroy,
+  PLATFORM_ID,
+  Type,
+  untracked,
+  ViewContainerRef,
+} from '@angular/core';
+import { Types, Styles } from '@a2ui/lit/0.8';
+import { Catalog } from './catalog';
+import { isPlatformBrowser } from '@angular/common';
+
+@Directive({
+  selector: 'ng-container[a2ui-renderer]',
+})
+export class Renderer implements OnDestroy {
+  private viewContainerRef = inject(ViewContainerRef);
+  private catalog = inject(Catalog);
+  private static hasInsertedStyles = false;
+
+  private currentRef: ComponentRef<unknown> | null = null;
+  private isDestroyed = false;
+
+  readonly surfaceId = input.required<Types.SurfaceID>();
+  readonly component = input.required<Types.AnyComponentNode>();
+
+  constructor() {
+    effect(() => {
+      const surfaceId = this.surfaceId();
+      const component = this.component();
+      untracked(() => this.render(surfaceId, component));
+    });
+
+    const platformId = inject(PLATFORM_ID);
+    const document = inject(DOCUMENT);
+
+    if (!Renderer.hasInsertedStyles && isPlatformBrowser(platformId)) {
+      const styles = document.createElement('style');
+      styles.textContent = Styles.structuralStyles;
+      document.head.appendChild(styles);
+      Renderer.hasInsertedStyles = true;
+    }
+  }
+
+  ngOnDestroy(): void {
+    this.isDestroyed = true;
+    this.clear();
+  }
+
+  private async render(surfaceId: Types.SurfaceID, component: Types.AnyComponentNode) {
+    const config = this.catalog[component.type];
+    let newComponent: Type<unknown> | null = null;
+    let componentBindings: Binding[] | null = null;
+
+    if (typeof config === 'function') {
+      newComponent = await config();
+    } else if (typeof config === 'object') {
+      newComponent = await config.type();
+      componentBindings = config.bindings(component as any);
+    }
+
+    this.clear();
+
+    if (newComponent && !this.isDestroyed) {
+      const bindings = [
+        inputBinding('surfaceId', () => surfaceId),
+        inputBinding('component', () => component),
+        inputBinding('weight', () => component.weight ?? 'initial'),
+      ];
+
+      if (componentBindings) {
+        bindings.push(...componentBindings);
+      }
+
+      this.currentRef = this.viewContainerRef.createComponent(newComponent, {
+        bindings,
+        injector: this.viewContainerRef.injector,
+      });
+    }
+  }
+
+  private clear() {
+    this.currentRef?.destroy();
+    this.currentRef = null;
+  }
+}

vendor/a2ui/renderers/angular/src/lib/rendering/theming.ts

@@ -0,0 +1,22 @@
+/*
+ Copyright 2025 Google LLC
+
+ Licensed under the Apache License, Version 2.0 (the "License");
+ you may not use this file except in compliance with the License.
+ You may obtain a copy of the License at
+
+      https://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+ */
+
+import { Types } from '@a2ui/lit/0.8';
+import { InjectionToken } from '@angular/core';
+
+export const Theme = new InjectionToken<Theme>('Theme');
+
+export type Theme = Types.Theme;