build(i18n): generate compiled Lingui catalogs instead of committing them

.gitignore

@@ -101,3 +101,11 @@ plans/local/
 # Plugin build output is committed: a release is the plugin's tree at its
 # `<plugin>@<version>` tag, so the bundle users install has to be in it. The
 # build stamp travels with it so `plugins check` can verify it against src/.
+
+# Compiled Lingui catalogs. Generated from messages.po by `lingui compile`
+# (packages/i18n `build`), which every dependent's build/typecheck/test runs
+# via turbo `^build`. Committing them is what Lingui's docs warn against, and
+# it cost us a guaranteed conflict on all 17 files whenever two branches added
+# a string: compile emits one minified line per locale, and git cannot
+# three-way merge a single-line file.
+packages/i18n/locales/*/messages.ts

apps/admin/package.json

@@ -6,6 +6,7 @@
 	"scripts": {
 		"build": "next build",
 		"clean": "git clean -xdf .cache .next .turbo node_modules",
+		"predev": "bun run --filter=@superset/i18n build",
 		"dev": "dotenv -e ../../.env -- sh -c 'exec next dev --port ${ADMIN_PORT:-3003}'",
 		"start": "next start",
 		"typecheck": "tsc --noEmit"

apps/desktop/package.json

@@ -18,7 +18,7 @@
 		"start": "electron-vite preview",
 		"generate:icons": "bun run scripts/generate-file-icons.ts",
 		"bundle:cli": "bun run scripts/build-bundled-cli.ts",
-		"predev": "cross-env NODE_ENV=development bun run clean:dev && bun run generate:icons && bun run bundle:cli && cross-env NODE_ENV=development bun run scripts/clean-launch-services.ts && cross-env NODE_ENV=development bun run scripts/patch-dev-protocol.ts",
+		"predev": "bun run --filter=@superset/i18n build && cross-env NODE_ENV=development bun run clean:dev && bun run generate:icons && bun run bundle:cli && cross-env NODE_ENV=development bun run scripts/clean-launch-services.ts && cross-env NODE_ENV=development bun run scripts/patch-dev-protocol.ts",
 		"dev": "bun scripts/dev.ts",
 		"compile:app": "cross-env NODE_OPTIONS=--max-old-space-size=8192 electron-vite build && bun run bundle:cli && bun run scripts/check-pty-daemon-bundle.ts",
 		"check:pty-daemon-bundle": "bun run scripts/check-pty-daemon-bundle.ts",

apps/docs/package.json

@@ -5,6 +5,7 @@
 	"type": "module",
 	"scripts": {
 		"build": "fumadocs-mdx && next build",
+		"predev": "bun run --filter=@superset/i18n build",
 		"dev": "dotenv -e ../../.env -- sh -c 'exec next dev --port ${DOCS_PORT:-3004}'",
 		"start": "next start",
 		"typecheck": "next typegen && fumadocs-mdx && tsc --noEmit",

apps/marketing/package.json

@@ -6,6 +6,7 @@
 	"scripts": {
 		"build": "next build",
 		"clean": "git clean -xdf .cache .next .turbo node_modules",
+		"predev": "bun run --filter=@superset/i18n build",
 		"dev": "dotenv -e ../../.env -- sh -c 'exec next dev --port ${MARKETING_PORT:-3002}'",
 		"lint:prose": "vale --config=vale.ini content \"src/app/[lang]/layout.tsx\" src/components/JsonLd/JsonLd.tsx src/lib/product-facts.ts src/lib/llms.ts \"src/app/[lang]/components/Header/constants.tsx\" \"src/app/[lang]/components/HeroSection/HeroSection.tsx\" \"src/app/[lang]/components/HowItWorksSection\" \"src/app/[lang]/components/FeaturesSection/constants.ts\" \"src/app/[lang]/components/FAQSection/constants.ts\" \"src/app/[lang]/components/CTASection/CTASection.tsx\" \"src/app/[lang]/components/SecuritySection/SecuritySection.tsx\"",
 		"start": "next start",

apps/mobile/package.json

@@ -3,6 +3,7 @@
 	"version": "1.0.0",
 	"main": "expo-router/entry",
 	"scripts": {
+		"predev": "bun run --filter=@superset/i18n build",
 		"dev": "EXPO_UNSTABLE_MCP_SERVER=1 expo start",
 		"android": "expo run:android",
 		"ios": "expo run:ios",

apps/web/package.json

@@ -7,6 +7,7 @@
 		"test": "bun test src",
 		"build": "next build",
 		"clean": "git clean -xdf .cache .next .turbo node_modules",
+		"predev": "bun run --filter=@superset/i18n build",
 		"dev": "dotenv -e ../../.env -- sh -c 'exec next dev --port ${WEB_PORT:-3000}'",
 		"start": "next start",
 		"typecheck": "tsc --noEmit"

packages/cli/package.json

@@ -9,6 +9,7 @@
 		"build:darwin-arm64": "cli-framework build --target=bun-darwin-arm64 --outfile=./dist/superset-darwin-arm64",
 		"build:linux-x64": "cli-framework build --target=bun-linux-x64 --outfile=./dist/superset-linux-x64",
 		"build:all": "bun run build:darwin-arm64 && bun run build:linux-x64",
+		"prebuild:dist": "bun run --filter=@superset/i18n build",
 		"build:dist": "bun run scripts/build-dist.ts",
 		"typecheck": "tsc --noEmit",
 		"test": "bun test"

packages/i18n/package.json

@@ -38,6 +38,7 @@
 		}
 	},
 	"scripts": {
+		"build": "bun run compile",
 		"extract": "bunx --bun lingui extract --clean --overwrite --workers 1",
 		"compile": "bunx --bun lingui compile --strict --verbose --workers 1",
 		"check": "bun run extract && bun run compile",

packages/i18n/turbo.json

@@ -0,0 +1,20 @@
+{
+	"$schema": "https://turbo.build/schema.json",
+	"extends": ["//"],
+	"tasks": {
+		// `lingui compile` turns the committed messages.po sources into the
+		// runtime catalogs src/index.ts imports. Dependents pick this up through
+		// the root pipeline's `^build`; i18n's own typecheck and test need it
+		// too, hence the self-dependency below.
+		"build": {
+			"inputs": ["locales/*/messages.po", "lingui.config.ts", "package.json"],
+			"outputs": ["locales/*/messages.ts"]
+		},
+		"typecheck": {
+			"dependsOn": ["^build", "^build:types", "build"]
+		},
+		"test": {
+			"dependsOn": ["^build", "build"]
+		}
+	}
+}

scripts/postinstall.sh

@@ -12,6 +12,15 @@ export SUPERSET_POSTINSTALL_RUNNING=1
 # Run sherif for workspace validation
 sherif
 
+# Materialize the compiled Lingui catalogs. They are generated, not committed,
+# and turbo builds them for any task that goes through the graph — but a direct
+# `bun run --filter=<pkg> typecheck` bypasses turbo, so a fresh clone would hit
+# "Cannot find module '../locales/en/messages'". Non-fatal: a missing
+# translation must fail a real build, not an install.
+if ! bun run --filter=@superset/i18n build; then
+  echo "postinstall: lingui compile failed; run 'bun run check:i18n' for details" >&2
+fi
+
 # GitHub CI runs multiple Bun install jobs that do not need desktop native rebuilds.
 # Running electron-builder here can trigger nested Bun installs while the main
 # install is still materializing packages, which has been flaky with native deps.

turbo.jsonc

@@ -44,6 +44,10 @@
 			]
 		},
 		"dev": {
+			// Compiled Lingui catalogs are generated, not committed, so dev has to
+			// build them before anything imports @superset/i18n. Scoped to that one
+			// package so starting dev doesn't drag in every other build.
+			"dependsOn": ["@superset/i18n#build"],
 			"cache": false,
 			"persistent": true
 		},
@@ -52,6 +56,10 @@
 			"outputs": ["coverage/**"]
 		},
 		"build:types": {
+			// Emits declarations from source, so it needs the same upstream
+			// generated inputs a build does — the compiled Lingui catalogs in
+			// particular, which host-service reaches through @superset/i18n.
+			"dependsOn": ["^build"],
 			"outputs": ["dist-types/**"]
 		},
 		"typecheck": {