voidzero-dev / voidzero-dev/oxc-angular-compiler

Angular 21.2.0 + @oxc-angular/vite 0.0.7 SSR: AngularNodeAppEngine is unusable (missing app-engine manifest)

Ouverte
#60 4 commentaires 0 réactions 1 personne assignée Voir sur GitHub

@Brooooooklyn y travaille déjà.

Depuis le 4/3/2026.

Langage dominant
Rust
Étoiles
228
Forks
20
Merge moyen
1 j 15 h
PR mergées (30 j)
36

Description

Summary

With Angular 21.2.0 and @oxc-angular/vite 0.0.7, OXC SSR build artifacts can be generated, but SSR cannot use AngularNodeAppEngine from @angular/ssr/node because Angular app-engine manifest data is missing in the OXC output.

This makes OXC SSR currently dependent on CommonEngine fallback in our app.

Environment

  • OS: macOS 15.7.4 (Darwin 24.6.0)
  • Arch: x86_64 (darwin-x64)
  • Node: v22.20.0
  • npm: 10.9.3

Versions

  • @angular/core: ^21.2.0
  • @angular/ssr: ^21.2.0
  • @angular/cli: ^21.2.0
  • @angular-devkit/build-angular: ^21.2.0
  • @oxc-angular/vite: ^0.0.7
  • vite: ^8.0.0-beta.16
  • typescript: ~5.9

Reproduction (project-level)

  1. Build OXC browser + server bundles:
    npm run build:oxc:ssr
    

Start SSR server with AngularNodeAppEngine path enabled.
Error observed from Angular SSR internals:
txt

Error: Angular app engine manifest is not set. Please ensure you are using the '@angular/build:application' builder to build your server application.
at getAngularAppEngineManifest (...)
at new AngularAppEngine (...)
at new AngularNodeAppEngine (...)
Actual behavior
OXC SSR build completes successfully.
Runtime AngularNodeAppEngine path fails due to missing Angular app-engine manifest.
We had to switch to CommonEngine for OXC SSR runtime.
Expected behavior
Either:
OXC SSR output should include/manually register the manifest required by AngularNodeAppEngine, or
official guidance should clearly state that AngularNodeAppEngine is not currently supported for OXC SSR and CommonEngine is the intended runtime path.
Dist output observation
From OXC SSR artifacts, we get entries like:

dist/.../browser/src/index.oxc.html
dist/.../server/server.mjs
But no Angular app-engine manifest setup compatible with AngularNodeAppEngine.

What we already tried
Upgraded to @oxc-angular/vite@0.0.7 (darwin-x64 binding issue appears resolved).
Kept separate client/server OXC Vite configs.
Forced AngularNodeAppEngine path for verification.
Added fallback to CommonEngine with explicit document resolution.
Added host allowlist handling for SSR to rule out host validation noise.
Verified runtime routes work under CommonEngine (including SSR login callback path).
Additional SSR parity notes (secondary)
Before our app-side shims, we also saw OXC SSR runtime DI/parity issues around:

RouterLinkActive
Forms (NgControlStatus / FormControlName) on SSR route rendering
We can open a separate issue for these if you prefer one issue per problem.

Request
Please confirm:

Is AngularNodeAppEngine support expected with @oxc-angular/vite@0.0.7 + Angular 21.2.0?
If yes, can you share the expected manifest contract/output and recommended config?
If not, please document current SSR support scope and preferred runtime path (CommonEngine only) with known limitations.

Guide de contribution

Aucun guide de contribution indexé pour ce dépôt

Par où commencer

  1. Lisez l'issue en entier, puis le guide de contribution du projet.
  2. Signalez en commentaire que vous la prenez — cela évite que deux personnes fassent le même travail.
  3. Forkez le dépôt et travaillez sur une branche.
  4. Ouvrez une pull request qui référence le numéro de l'issue.

Évaluation

Cette issue n'a pas encore été évaluée.

Recevez les nouvelles issues par e-mail

Un résumé court des issues GitHub adaptées aux débutants.