Hacktoberfest 2026: những issue maintainer đã đánh dấu cho tháng Mười, đang mở và phù hợp người mới. Xem issue Hacktoberfest

bug(ui): child core UIs that don't import the i18n runtime ship no @lingui/* share-scope entries — host auth plugin fails SSR composition with RUNTIME-012

Đang mở
  • Có gì không ổn?
#496 0 bình luận 0 reaction 0 người được giao Xem trên GitHub

Maintainer thường phản hồi trong vòng 1 ngày

Chưa có ai nhận issue này.

Đánh giá

Độ khó
5/5
Thời gian dự kiến
Hơn một tuần
Mức phù hợp với người mới
35/100
Loại issue
Lỗi
Độ rõ ràng
Khá rõ ràng
Mức độ hoạt động
Sôi nổi
Công nghệ
react, typescript
Lĩnh vực
devtools, frontend, internationalization

Hướng nghiên cứu

Start by reading the shared-deps spec at every-plugin/shared-deps-spec and the platform UI's ui/src/i18n/catalogs.ts, ui/src/i18n/runtime.tsx, and __root.tsx pattern. Compare those with the generated stubs and child UI build manifests described in the report to choose where the missing provider should be supplied. Done means a child core UI without its own i18n imports can compose the auth plugin during SSR without RUNTIME-012; the issue leaves the implementation choice open.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Mô tả

bug needs-triage
Summary

A child app that overrides app.ui with its own core UI replaces the platform's UI as the core-ui provider in its federation graph — but it only emits shared-scope entries for UI deps it actually imports. The platform's auth plugin (pinned child-side via the extends chain) consumes shared @lingui/core, @lingui/react, and everything-dev/ui/i18n with import: false (consumer role per every-plugin/shared-deps-spec UI_SHARED_DEPS). A child UI authored before the i18n adoption never imports everything-dev/ui/i18n at runtime (e.g. appLocale is only read via type imports / passed to createServerRouterModule, which uses it for cookie/Accept-Language negotiation only) — so the child's bundles ship no @lingui/* share-scope entries, and boot fails:

Boot SSR composition FAILED — health stays degraded: UnknownError
(cause: Error: The getter for the shared module is not a function. This may be
caused by setting "shared.import: false" without the host providing the
corresponding lib. #RUNTIME-012
args: {"shareKey":"@lingui/core"})

The failure only surfaces at runtime, on every boot, and pins the child's health to degraded even when the api and all other plugins load.

Evidence (manifests fetched from the CDN)
  • Parent platform's own UI (gitSha b63f0b5, the canonical core-ui provider) shares the full UI dep set: @lingui/core 5.9.0, @lingui/react 5.9.0, everything-dev/ui/i18n 2.0.0-rc.12, plus react/react-dom/@tanstack/@orpc.
  • Child UI built with every-plugin 3.0.0-rc.8 + everything-dev 2.0.0-rc.12 shares react, react-dom, @tanstack/*, @orpc/*, everything-dev/ui/auth — no @lingui/*, no everything-dev/ui/i18n (web and ssr manifests identical).
  • The pinned auth bundle's chunks request shareKey: "@lingui/core" / "@lingui/react"; the parent's host bundle's mf-manifest lists only the core shared deps (no UI deps), so nothing else in the graph can satisfy the request.

The parent's own app wires the canonical seam: app-owned ui/src/i18n/catalogs.ts + ui/src/i18n/runtime.tsx (createLocaleRuntime → AppI18nProvider), mounted in the root route (__root.tsx imports @/i18n/runtime). Child apps scaffolded before that pattern existed don't have it, and neither init/sync nor the build flags the gap.

Fix options (maintainer's pick)
  1. Scaffold the seam in init/sync: write ui/src/i18n/{catalogs,runtime}.tsx (derived from the app's appLocale bootstrap export) and mount AppI18nProvider in the root route — matches the canonical pattern, keeps the strict-singleton version checks meaningful.
  2. Emit the full UI_SHARED_DEPS in the core-ui build regardless of imports, so the share scope is always complete — and/or fail the build when a UI_SHARED_DEPS entry has no provider in the graph (build-time failure instead of runtime boot failure).
  3. Wire the provider in the generated stubs (entry.gen.ts/router.server.gen.tsx already read appLocale), so the framework owns the mount.
Local mitigation

The affected child app added an i18n-seam check + maintenance step to its scripts/v2-upgrade/ (pnpm i18n-seam): detects "appLocale declared but no runtime everything-dev/ui/i18n import / provider unmounted", scaffolds the canonical seam, and mounts the provider.

Ngôn ngữ chính
TypeScript
Star
5
Fork
3
Merge trung bình
10 giờ 12 phút
Pull request đã merge (30 ngày)
102

Chuẩn bị môi trường

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Issue khác của NEARBuilders/everything-dev

Tất cả issue của NEARBuilders/everything-dev

Issue tương tự

Thêm issue về TypeScript

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.