feat: add TranslationsManager from v2 branch (#541)

Author: stevenle

.changeset/afraid-meals-smash.md

@@ -0,0 +1,5 @@
+---
+'@blinkk/root-cms': patch
+---
+
+feat: add TranslationsManager from `v2` branch (#541)

.gitignore

@@ -7,3 +7,4 @@ out/
 *.log
 .env
 .turbo/
+*.code-workspace

packages/root-cms/core/client.ts

@@ -9,6 +9,7 @@ import {
   WriteBatch,
 } from 'firebase-admin/firestore';
 import {CMSPlugin} from './plugin.js';
+import {TranslationsManager} from './translations-manager.js';
 
 export interface Doc<Fields = any> {
   /** The id of the doc, e.g. "Pages/foo-bar". */
@@ -602,6 +603,30 @@ export class RootCMSClient {
     return false;
   }
 
+  /**
+   * Returns a `TranslationsManager` object for managing translations.
+   *
+   * To get translations:
+   * ```
+   * await tm.loadTranslations({
+   *   ids: ['Global/strings', 'Pages/index'],
+   *   locales: ['es'],
+   * });
+   * ```
+   *
+   * NOTE: The `TranslationsManager` is a v2 feature that will eventually
+   * replace the v1 translations system.
+   */
+  getTranslationsManager(): TranslationsManager {
+    const cmsPluginOptions = this.cmsPlugin.getConfig();
+    if (cmsPluginOptions.experiments?.v2TranslationsManager) {
+      throw new Error(
+        '`v2TranslationsManager` is not enabled. update root.config.ts and add: `{experiments: {v2TranslationsManager: true}}`'
+      );
+    }
+    return new TranslationsManager(this);
+  }
+
   /**
    * Loads translations saved in the translations collection, optionally
    * filtered by tag.

packages/root-cms/core/core.ts

@@ -1,3 +1,4 @@
 export * from './client.js';
 export * from './runtime.js';
 export * as schema from './schema.js';
+export * from './translations-manager.js';

packages/root-cms/core/plugin.ts

@@ -162,7 +162,15 @@ export type CMSPluginOptions = {
    * Experimental config options. Note: these are subject to change at any time.
    */
   experiments?: {
+    /**
+     * Enables the Root CMS AI page.
+     */
     ai?: boolean | CMSAIConfig;
+
+    /**
+     * Enables the v2 `TranslationsManager`.
+     */
+    v2TranslationsManager?: boolean;
   };
 
   /**