@discord/intl-loader-core 0.7.1 → 0.8.0-rc.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@discord/intl-loader-core",
-  "version": "0.7.1",
+  "version": "0.8.0-rc.1",
   "license": "MIT",
   "description": "Core utilities for writing loaders and transformers using @discord/intl",
   "author": "Jon Egeland",
@@ -22,7 +22,7 @@
     "chokidar": "^3.6.0",
     "debug": "^4.3.6",
     "fast-glob": "^3.3.2",
-    "@discord/intl-message-database": "0.7.1"
+    "@discord/intl-message-database": "0.8.0-rc.1"
   },
   "devDependencies": {
     "@types/debug": "^4.1.12"

package/src/transformer.js

@@ -110,6 +110,25 @@ class MessageDefinitionsTransformer {
     ];
   }
 
+  /**
+   * Return the lines to export fields from this module, as determined by the `exportMode` on this
+   * transformer.
+   */
+  exportFields() {
+    switch (this.options.exportMode ?? 'esm') {
+      case 'esm':
+        return [`export {${this.loaderName}};`, `export default binds;`];
+      case 'commonjs':
+        return [`module.exports = { messagesLoader: ${this.loaderName}, default: binds };`];
+      case 'transpiledEsModule':
+        return [
+          `Object.defineProperty(exports, "__esModule", { value: true });`,
+          `exports["messageLoader"] = ${this.loaderName};`,
+          `exports["default"] = binds;`,
+        ];
+    }
+  }
+
   /**
    * Returns the reduced, transformed output for this file. Currently not
    * configurable, but could be told to include default messages or preserve
@@ -124,9 +143,10 @@ class MessageDefinitionsTransformer {
       `const _keys = ${JSON.stringify(this.options.messageKeys)};`,
       `const _locales = ${this.getLocaleRequireMap()};`,
       `const _defaultLocale = ${JSON.stringify(this.options.defaultLocale)};`,
-      `export const ${this.loaderName} = createLoader(_keys, _locales, _defaultLocale);`,
+      `const ${this.loaderName} = createLoader(_keys, _locales, _defaultLocale);`,
       ...this.debugModeSetup(),
-      `export default ${this.loaderName}.getBinds();`,
+      `const binds = ${this.loaderName}.getBinds();`,
+      ...this.exportFields(),
     ].join('\n');
   }
 }

package/src/types.d.ts

@@ -40,6 +40,17 @@ export interface MessageDefinitionsTransformerOptions {
    * code to provide context for debugging in errors and warning messages.
    */
   debug?: boolean;
+  /**
+   * Control how value exports are written in the transformed file to match what any downstream
+   * transformer or interpreter may expect. `esm` will leave exports as `export default` and other
+   * module features supported in ES6 and onward. `commonjs` will explicitly use `module.exports`
+   * with a single object containing `default` as the key for a default export. `transpiledEsModule`
+   * does the same, but includes the compatibility field `__esModule` to indicate that the module
+   * "was transpiled" to this syntax.
+   *
+   * @default esm
+   */
+  exportMode?: 'esm' | 'commonjs' | 'transpiledEsModule';
 }
 
 /**