chore: changeset + test isolation for v2 translations manager

Adds a minor changeset for @blinkk/root and @blinkk/root-cms (noting
the TranslationsDoc export removal), runs the admin-SDK emulator tests
against a separate emulator project id so security.test.ts's
clearFirestore() can't race them, and applies lint formatting.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Pw4Wrj1oL9DuVbKoXasBTE

Author: claude

.changeset/lucky-poems-drive.md

@@ -0,0 +1,23 @@
+---
+'@blinkk/root': minor
+'@blinkk/root-cms': minor
+---
+
+feat: v2 translations manager (behind `experiments.v2TranslationsManager`)
+
+Wires up the v2 `TranslationsManager` end to end: a new `i18n.fallbacks`
+config for locale fallback chains, a translations manager UI at
+`/cms/translations` (list + editor) that replaces the v1 pages when the flag
+is on, publishing content docs now publishes their translations in the same
+write batch (plus a standalone per-doc Publish action), runtime reads in
+`createRoute()` and the missing-translations check use the v2 per-locale
+docs, and v1 translations are automatically copy-migrated (and published) on
+dev/build boot, leaving v1 data untouched as a backup.
+
+BREAKING (experimental surface, no known callers): the unused
+`TranslationsDoc` interface and `RootCMSClient.dbTranslationsPath()`/
+`dbTranslationsRef()` helpers were removed, and `BatchRequest`/
+`BatchResponse.translations` now uses the per-locale doc schema
+(`Record<id, Record<locale, TranslationsLocaleDoc>>`).
+`BatchResponse.getTranslations()` accepts a locale or an explicit fallback
+chain and resolves `i18n.fallbacks`.

packages/root-cms/core/batch-request.test.ts

@@ -9,7 +9,7 @@ import {Timestamp, getFirestore} from 'firebase-admin/firestore';
 import {beforeEach, describe, expect, it} from 'vitest';
 import {RootCMSClient} from './client.js';
 
-const FIREBASE_PROJECT_ID = 'rootjs-cms';
+const FIREBASE_PROJECT_ID = 'rootjs-cms-admin-tests';
 
 function getTestApp() {
   const existing = getApps().find((app) => app.name === 'batch-test');

packages/root-cms/core/plugin.ts

@@ -786,9 +786,8 @@ export function cmsPlugin(options: CMSPluginOptions): CMSPlugin {
         // translations before the build (SSG reads translations at build
         // time). A failure fails the build.
         if (options.experiments?.v2TranslationsManager) {
-          const {migrateV1TranslationsIfNeeded} = await import(
-            './translations-migration.js'
-          );
+          const {migrateV1TranslationsIfNeeded} =
+            await import('./translations-migration.js');
           const cmsClient = new RootCMSClient(rootConfig);
           try {
             await migrateV1TranslationsIfNeeded(cmsClient, {

packages/root-cms/core/publish-translations.test.ts

@@ -10,7 +10,7 @@ import {beforeEach, describe, expect, it} from 'vitest';
 import {RootCMSClient} from './client.js';
 import {TranslationsLocaleDoc} from './translations-manager.js';
 
-const FIREBASE_PROJECT_ID = 'rootjs-cms';
+const FIREBASE_PROJECT_ID = 'rootjs-cms-admin-tests';
 
 function getTestApp() {
   const existing = getApps().find((app) => app.name === 'publish-test');

packages/root-cms/core/translations-manager.test.ts

@@ -16,7 +16,7 @@ import {
   translationsForLocaleV2,
 } from './translations-manager.js';
 
-const FIREBASE_PROJECT_ID = 'rootjs-cms';
+const FIREBASE_PROJECT_ID = 'rootjs-cms-admin-tests';
 
 function getTestApp() {
   const existing = getApps().find((app) => app.name === 'tm-test');
@@ -97,9 +97,7 @@ describe.skipIf(!process.env.FIRESTORE_EMULATOR_HOST)(
 
       const dbPath = `Projects/${cmsClient.projectId}/TranslationsManager/draft/Translations`;
       // Slashes in the translations id are normalized to `--` in doc keys.
-      const esDoc = await cmsClient.db
-        .doc(`${dbPath}/Pages--index:es`)
-        .get();
+      const esDoc = await cmsClient.db.doc(`${dbPath}/Pages--index:es`).get();
       expect(esDoc.exists).toBe(true);
       const esData = esDoc.data() as TranslationsLocaleDoc;
       expect(esData.id).toBe('Pages/index');
@@ -115,9 +113,7 @@ describe.skipIf(!process.env.FIRESTORE_EMULATOR_HOST)(
       });
       expect(esData.sys.modifiedAt).toBeDefined();
 
-      const frDoc = await cmsClient.db
-        .doc(`${dbPath}/Pages--index:fr`)
-        .get();
+      const frDoc = await cmsClient.db.doc(`${dbPath}/Pages--index:fr`).get();
       expect(frDoc.exists).toBe(true);
       expect((frDoc.data() as TranslationsLocaleDoc).strings).toEqual({
         [hashStr('one')]: {source: 'one', translation: 'un'},
@@ -160,12 +156,20 @@ describe.skipIf(!process.env.FIRESTORE_EMULATOR_HOST)(
 
     it('loads translations by tags using array-contains-any', async () => {
       const tm = cmsClient.getTranslationsManager();
-      await tm.saveTranslations('common', {hello: {es: 'hola'}}, {
-        tags: ['common'],
-      });
-      await tm.saveTranslations('Pages/foo', {bye: {es: 'adios'}}, {
-        tags: ['Pages/foo'],
-      });
+      await tm.saveTranslations(
+        'common',
+        {hello: {es: 'hola'}},
+        {
+          tags: ['common'],
+        }
+      );
+      await tm.saveTranslations(
+        'Pages/foo',
+        {bye: {es: 'adios'}},
+        {
+          tags: ['Pages/foo'],
+        }
+      );
       const strings = await tm.loadTranslations({
         tags: ['common', 'other'],
         mode: 'draft',
@@ -303,9 +307,7 @@ describe.skipIf(!process.env.FIRESTORE_EMULATOR_HOST)(
       it('migrates the linked l10n sheet from the doc', async () => {
         await seedV1Translation('hello', {es: 'hola'}, ['Pages/index']);
         await cmsClient.db
-          .doc(
-            `Projects/${cmsClient.projectId}/Collections/Pages/Drafts/index`
-          )
+          .doc(`Projects/${cmsClient.projectId}/Collections/Pages/Drafts/index`)
           .set({
             id: 'Pages/index',
             collection: 'Pages',

packages/root-cms/core/translations-migration.test.ts

@@ -14,7 +14,7 @@ import {
   migrateV1TranslationsIfNeeded,
 } from './translations-migration.js';
 
-const FIREBASE_PROJECT_ID = 'rootjs-cms';
+const FIREBASE_PROJECT_ID = 'rootjs-cms-admin-tests';
 
 function getTestApp() {
   const existing = getApps().find((app) => app.name === 'migration-test');