2 files changed, 73 insertions, 0 deletions
diff --git a/devtools/client/shared/fluent-l10n/fluent-l10n.js b/devtools/client/shared/fluent-l10n/fluent-l10n.js
new file mode 100644
index 0000000000..d3a5c33408
--- /dev/null
+++ b/devtools/client/shared/fluent-l10n/fluent-l10n.js
@@ -0,0 +1,64 @@
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/. */
+
+"use strict";
+
+const FluentReact = require("resource://devtools/client/shared/vendor/fluent-react.js");
+
+/**
+ * Wrapper over FluentReact. It encapsulates instantiation of the localization
+ * bundles, and offers a simpler way of accessing `getString`.
+ */
+class FluentL10n {
+  /**
+   * Initializes the wrapper, generating the bundles for the given resource ids.
+   * It can optionally add the right attributes to the document element.
+   * @param {Array} resourceIds
+   * @param {Object} [options]
+   * @param {boolean} [options.setAttributesOnDocument]
+   */
+  async init(resourceIds, { setAttributesOnDocument } = {}) {
+    if (setAttributesOnDocument) {
+      const primaryLocale = Services.locale.appLocalesAsBCP47[0];
+      document.documentElement.setAttribute("lang", primaryLocale);
+      const direction = Services.locale.isAppLocaleRTL ? "rtl" : "ltr";
+      document.documentElement.setAttribute("dir", direction);
+    }
+
+    const locales = Services.locale.appLocalesAsBCP47;
+    const generator = L10nRegistry.getInstance().generateBundles(
+      locales,
+      resourceIds
+    );
+
+    this._bundles = [];
+    for await (const bundle of generator) {
+      this._bundles.push(bundle);
+    }
+    this._reactLocalization = new FluentReact.ReactLocalization(this._bundles);
+  }
+
+  /**
+   * Returns the fluent bundles generated.
+   */
+  getBundles() {
+    return this._bundles;
+  }
+
+  /**
+   * Returns the localized string for the provided id, formatted using args.
+   */
+  getString(id, args, fallback) {
+    // Forward arguments via .apply() so that the original method can:
+    // - perform asserts based on the number of arguments
+    // - add new arguments
+    return this._reactLocalization.getString.apply(
+      this._reactLocalization,
+      arguments
+    );
+  }
+}
+
+// Export the class
+exports.FluentL10n = FluentL10n;
diff --git a/devtools/client/shared/fluent-l10n/moz.build b/devtools/client/shared/fluent-l10n/moz.build
new file mode 100644
index 0000000000..654348ea26
--- /dev/null
+++ b/devtools/client/shared/fluent-l10n/moz.build
@@ -0,0 +1,9 @@
+# -*- Mode: python; indent-tabs-mode: nil; tab-width: 40 -*-
+# vim: set filetype=python:
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+
+DevToolsModules(
+    "fluent-l10n.js",
+)