build: migrate monorepo to Yarn v4 workspaces by gspencergoog · Pull Request #1054 · google/A2UI

gspencergoog · 2026-04-02T00:35:26Z

Description

This pull request modernizes the repository's build infrastructure by adopting Yarn v4 workspaces. The primary goal is to simplify dependency management and streamline build processes across the monorepo. By centralizing configuration and adopting workspace-aware commands, the change improves maintainability and consistency in CI/CD pipelines and local development environments.

Highlights

Monorepo Migration: Migrated the project from independent npm workspaces to a centralized Yarn v4+ workspace configuration, enabling topological builds and unified dependency management.
Build System Refactoring: Updated CI workflows and local scripts to use Yarn commands (yarn build, yarn test) and added root-level workspace scripts for bulk operations.
Dependency Management: Replaced file-based local dependencies with workspace:* protocol and unified the lockfile at the repository root.
Bug Fixes and UI Improvements: Fixed an AST destructuring crash in a2a-chat-canvas via corrected tsconfig paths and replaced static SSR imports with dynamic imports in widget-builder to resolve hydration issues.

workspace configuration. Key changes: - Adds root package.json and .yarnrc.yml for topological builds using `yarn workspaces foreach`. - Unifies `yarn.lock` at the repository root and removes localized package-lock.json and .npmrc files. - Refactors `npm run` steps in CI workflows to use `yarn build` and `yarn test`. - Fixes `a2a-chat-canvas` internal AST destructuring crash caused by incorrect tsconfig path mapping. Sets `paths` to the built `dist` folder. - Replaces static SSR imports in `widget-builder` shell with dynamic imports to prevent CustomElementRegistry hydration collisions. - Moves `@a2ui/angular` and `@a2ui/web_core` to peerDependencies in Angular sample projects.

ditman

Removing the .npmrcs will be a problem to release the packages using the Exit Gate, it seems? How does publishing through yarn work?

ditman · 2026-04-02T19:55:38Z

renderers/angular/.npmrc

-@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


This is needed to be able to publish the package through go/oss-exit-gate-release-npm. What is the equivalent in yarn?

Maybe related? yarnpkg/berry#6191

Okay, I think I updated the .yarnrc.yml to configure the registry this way. I don't think we'll know if it works until we try to publish.

Turns out we can only update the registry when we actually publish. If I put it into the .yarnrc.yml, then CI will fail because it doesn't have a token.

ditman · 2026-04-02T19:57:23Z

renderers/angular/package-lock.json

Lock files seem to be also required by go/oss-exit-gate-release-npm, are we ignoring the yarn locks?

There's a global yarn.lock, github didn't render the huge diff!

Yes, I was hoping we didn't need them. I'll rethink that and see.

I didn't see any mention of lock files in the docs. I don't think we need to include them. But no, we aren't ignoring yarn locks, but it's set up as a monorepo, so there's only one.

ditman · 2026-04-02T19:59:40Z

.yarnrc.yml

+
+nodeLinker: node-modules
+
+yarnPath: .yarn/releases/yarn-4.13.0.cjs


This is odd, are we shrink-wrapping the whole yarn executable? Should this be a devDependency somewhere?

Turns out this is redundant with packageManager, so I removed it and the .yarn/releases directory.

Oh. Actually not. It means that you have to enable corepack on your machine (every dev would have to). I went back to keeping the yarn executable.

The reason you don't put it in dev dependencies is the chicken-and-egg problem: You need a package manager to install your devDependencies. If Yarn is a devDependency, you would need Yarn to install Yarn.

- Update Angular projects to use 'yarn workspace' instead of relative paths. - Scope Lit samples build CI workflow. - Remove unsupported '--ignore-missing' flag from root scripts. - Standardize all packages to TypeScript 5.9.3.

…king ci config

… recursive flag and excluding parent

gspencergoog · 2026-04-02T21:16:49Z

I think I've resolved all the issues. I updated the publishing doc for yarn-based instructions but crucially, I haven't tried them. They look reasonable, but we would need to vet them at the next publish time to make sure they work.

- Hoist wireit to workspace root - Convert package-level build scripts to wireit (renderers, tools, specification, samples) - Fix wireit output path restrictions for Angular sub-projects by removing output tracking - Fix relative paths for wireit dependencies in sample packages - Update root scripts to run topologically without unsupported flags

…ult and remove test:ci

…ths and run_tests.py fallback

…s and lockfiles.

- Fix SSR crash in tools/composer by dynamically importing A2UIViewer with ssr: false. - Fix TypeError: Invalid URL errors in Angular samples by adding isPlatformBrowser checks before relative fetch calls. - Standardize peerDependencies in renderers/angular and renderers/lit to use workspace patterns (removing file: prefixes).

Add wireit explicitly to devDependencies in packages that use it for build scripts to ensure stability in strict environments.

… and samples to stabilize CI

… wireit caching

github-project-automation bot added this to A2UI Apr 2, 2026

github-project-automation bot moved this to Todo in A2UI Apr 2, 2026

This comment was marked as resolved.

Sign in to view

google deleted a comment from gemini-code-assist bot Apr 2, 2026

gspencergoog force-pushed the yarn branch from 8c4e010 to 39240d6 Compare April 2, 2026 19:33

gspencergoog marked this pull request as ready for review April 2, 2026 19:33

gspencergoog requested a review from ditman April 2, 2026 19:44

ditman reviewed Apr 2, 2026

View reviewed changes

gspencergoog added 5 commits April 2, 2026 13:13

Add exit gate registry server

7968170

Add exit gate auth helper to dependencies

3f6d3c3

docs: update web publishing guide for yarn workspaces and revert brea…

5773d78

…king ci config

ci: fix yarn workspaces foreach command in lit samples build by using…

48f55b0

… recursive flag and excluding parent

gspencergoog added 7 commits April 2, 2026 15:04

fix(testing): run angular tests in non-watching headless mode by defa…

e59ea73

…ult and remove test:ci

fix(testing): stabilize web_core and specification tests by fixing pa…

53ee88b

…ths and run_tests.py fallback

Merge branch 'main' into yarn. Resolve conflicts in package.json file…

e246c6f

…s and lockfiles.

fix: add missing wireit dependencies to workspace packages

3d7154a

Add wireit explicitly to devDependencies in packages that use it for build scripts to ensure stability in strict environments.

fix(deps): explicitly add wireit to devDependencies in react renderer…

31cb9c8

… and samples to stabilize CI

This comment was marked as resolved.

Sign in to view

gspencergoog added 4 commits April 2, 2026 16:33

fix(angular): move build outputs inside project directories to enable…

874a2fe

… wireit caching

fix(angular): align specified angular versions to ^21.2.0

fa64a78

fix(angular): standardize angular versions to ^21.2.5

b51f9d5

fix(markdown-it): remove broken path mapping for web_core

5c76696

google deleted a comment from gemini-code-assist bot Apr 2, 2026

gspencergoog added 2 commits April 2, 2026 16:51

fix(angular): add missing workspace dependencies to sample apps

14c87dd

ci: enable yarn caching in github workflows

8ccf55c

Merge branch 'main' into yarn

a1ed37b

		@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


		nodeLinker: node-modules

		yarnPath: .yarn/releases/yarn-4.13.0.cjs

Conversation

gspencergoog commented Apr 2, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Description

Highlights

Uh oh!

This comment was marked as resolved.

Uh oh!

ditman left a comment

Choose a reason for hiding this comment

Uh oh!

ditman Apr 2, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

ditman Apr 2, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

gspencergoog commented Apr 2, 2026

Uh oh!

This comment was marked as resolved.

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

gspencergoog commented Apr 2, 2026 •

edited

Loading

ditman Apr 2, 2026 •

edited

Loading

ditman Apr 2, 2026 •

edited

Loading