@rushstack/webpack5-localization-plugin 0.1.0

package/lib/loaders/resx-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resx-loader.js","sourceRoot":"","sources":["../../src/loaders/resx-loader.ts"],"names":[],"mappings":";AAAA,4FAA4F;AAC5F,2DAA2D;;AAG3D,oEAAwD;AACxD,8EAA8D;AAG9D,mDAA+C;AAC/C,gFAA6E;AAE7E,MAAM,MAAM,GAAoD,IAAA,4BAAY,EAC1E,CAAC,OAAe,EAAE,QAAgB,EAAE,OAA6C,EAAE,EAAE;IACnF,MAAM,OAAO,GAA0B,OAAO,CAAC,UAAU,EAAE,CAAC;IAC5D,MAAM,QAAQ,GAAa,IAAI,4BAAQ,CAAC,+CAAsB,CAAC,4BAA4B,CAAC,OAAO,CAAC,CAAC,CAAC;IAEtG,OAAO,IAAA,kCAAS,EAAC;QACf,OAAO;QACP,QAAQ;QACR,QAAQ;QACR,wBAAwB,EAAE,OAAO,CAAC,wBAAwB;QAC1D,yBAAyB,EAAE,CAAC,OAAO,CAAC,yBAAyB;KAC9D,CAAC,CAAC;AACL,CAAC,CACF,CAAC;AAEF,kBAAe,MAAM,CAAC","sourcesContent":["// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.\n// See LICENSE in the project root for license information.\n\nimport type { LoaderContext, LoaderDefinitionFunction } from 'webpack';\nimport { Terminal } from '@rushstack/node-core-library';\nimport { parseResx } from '@rushstack/localization-utilities';\nimport type { IResxLocLoaderOptions } from './IResxLoaderOptions';\n\nimport { createLoader } from './LoaderFactory';\nimport { LoaderTerminalProvider } from '../utilities/LoaderTerminalProvider';\n\nconst loader: LoaderDefinitionFunction<IResxLocLoaderOptions> = createLoader(\n  (content: string, filePath: string, context: LoaderContext<IResxLocLoaderOptions>) => {\n    const options: IResxLocLoaderOptions = context.getOptions();\n    const terminal: Terminal = new Terminal(LoaderTerminalProvider.getTerminalProviderForLoader(context));\n\n    return parseResx({\n      content,\n      filePath,\n      terminal,\n      resxNewlineNormalization: options.resxNewlineNormalization,\n      ignoreMissingResxComments: !options.ignoreMissingResxComments\n    });\n  }\n);\n\nexport default loader;\n"]}

package/lib/utilities/Constants.d.ts

@@ -0,0 +1,12 @@
+export declare const LOCALE_FILENAME_TOKEN: '[locale]';
+export declare const LOCALE_FILENAME_TOKEN_REGEX: RegExp;
+export declare const NO_LOCALE_SOURCE_MAP_FILENAME_TOKEN: '[no-locale-file]';
+export declare const NO_LOCALE_SOURCE_MAP_FILENAME_TOKEN_REGEX: RegExp;
+export declare const STRING_PLACEHOLDER_PREFIX: '_LOCALIZED_STRING_f12dy0i7_n4bo_dqwj_39gf_sasqehjmihz9';
+export declare const RESOURCE_FILE_NAME_REGEXP: RegExp;
+export declare const STRING_PLACEHOLDER_LABEL: 'A';
+export declare const LOCALE_NAME_PLACEHOLDER_LABEL: 'B';
+export declare const JSONP_PLACEHOLDER_LABEL: 'C';
+export declare const LOCALE_NAME_PLACEHOLDER: `${typeof STRING_PLACEHOLDER_PREFIX}__${typeof LOCALE_NAME_PLACEHOLDER_LABEL}_0`;
+export declare const JSONP_PLACEHOLDER: `${typeof STRING_PLACEHOLDER_PREFIX}__${typeof JSONP_PLACEHOLDER_LABEL}_0`;
+//# sourceMappingURL=Constants.d.ts.map

package/lib/utilities/Constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Constants.d.ts","sourceRoot":"","sources":["../../src/utilities/Constants.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,qBAAqB,EAAE,UAAuB,CAAC;AAC5D,eAAO,MAAM,2BAA2B,EAAE,MAAuB,CAAC;AAClE,eAAO,MAAM,mCAAmC,EAAE,kBAAuC,CAAC;AAC1F,eAAO,MAAM,yCAAyC,EAAE,MAA+B,CAAC;AACxF,eAAO,MAAM,yBAAyB,EAAE,wDACkB,CAAC;AAE3D,eAAO,MAAM,yBAAyB,EAAE,MAAkD,CAAC;AAE3F,eAAO,MAAM,wBAAwB,EAAE,GAAS,CAAC;AACjD,eAAO,MAAM,6BAA6B,EAAE,GAAS,CAAC;AACtD,eAAO,MAAM,uBAAuB,EAAE,GAAS,CAAC;AAEhD,eAAO,MAAM,uBAAuB,EAAE,GAAG,OAAO,yBAAyB,KAAK,OAAO,6BAA6B,IAAyE,CAAC;AAC5L,eAAO,MAAM,iBAAiB,EAAE,GAAG,OAAO,yBAAyB,KAAK,OAAO,uBAAuB,IAAmE,CAAC"}

package/lib/utilities/Constants.js

@@ -0,0 +1,17 @@
+"use strict";
+// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
+// See LICENSE in the project root for license information.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JSONP_PLACEHOLDER = exports.LOCALE_NAME_PLACEHOLDER = exports.JSONP_PLACEHOLDER_LABEL = exports.LOCALE_NAME_PLACEHOLDER_LABEL = exports.STRING_PLACEHOLDER_LABEL = exports.RESOURCE_FILE_NAME_REGEXP = exports.STRING_PLACEHOLDER_PREFIX = exports.NO_LOCALE_SOURCE_MAP_FILENAME_TOKEN_REGEX = exports.NO_LOCALE_SOURCE_MAP_FILENAME_TOKEN = exports.LOCALE_FILENAME_TOKEN_REGEX = exports.LOCALE_FILENAME_TOKEN = void 0;
+exports.LOCALE_FILENAME_TOKEN = '[locale]';
+exports.LOCALE_FILENAME_TOKEN_REGEX = /\[locale\]/gi;
+exports.NO_LOCALE_SOURCE_MAP_FILENAME_TOKEN = '[no-locale-file]';
+exports.NO_LOCALE_SOURCE_MAP_FILENAME_TOKEN_REGEX = /\[no-locale-file\]/gi;
+exports.STRING_PLACEHOLDER_PREFIX = '_LOCALIZED_STRING_f12dy0i7_n4bo_dqwj_39gf_sasqehjmihz9';
+exports.RESOURCE_FILE_NAME_REGEXP = /\.(resx|resx\.json|loc\.json|resjson)$/i;
+exports.STRING_PLACEHOLDER_LABEL = 'A';
+exports.LOCALE_NAME_PLACEHOLDER_LABEL = 'B';
+exports.JSONP_PLACEHOLDER_LABEL = 'C';
+exports.LOCALE_NAME_PLACEHOLDER = `${exports.STRING_PLACEHOLDER_PREFIX}__${exports.LOCALE_NAME_PLACEHOLDER_LABEL}_0`;
+exports.JSONP_PLACEHOLDER = `${exports.STRING_PLACEHOLDER_PREFIX}__${exports.JSONP_PLACEHOLDER_LABEL}_0`;
+//# sourceMappingURL=Constants.js.map

package/lib/utilities/Constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Constants.js","sourceRoot":"","sources":["../../src/utilities/Constants.ts"],"names":[],"mappings":";AAAA,4FAA4F;AAC5F,2DAA2D;;;AAE9C,QAAA,qBAAqB,GAAe,UAAU,CAAC;AAC/C,QAAA,2BAA2B,GAAW,cAAc,CAAC;AACrD,QAAA,mCAAmC,GAAuB,kBAAkB,CAAC;AAC7E,QAAA,yCAAyC,GAAW,sBAAsB,CAAC;AAC3E,QAAA,yBAAyB,GACpC,wDAAwD,CAAC;AAE9C,QAAA,yBAAyB,GAAW,yCAAyC,CAAC;AAE9E,QAAA,wBAAwB,GAAQ,GAAG,CAAC;AACpC,QAAA,6BAA6B,GAAQ,GAAG,CAAC;AACzC,QAAA,uBAAuB,GAAQ,GAAG,CAAC;AAEnC,QAAA,uBAAuB,GAAqF,GAAG,iCAAyB,KAAK,qCAA6B,IAAI,CAAC;AAC/K,QAAA,iBAAiB,GAA+E,GAAG,iCAAyB,KAAK,+BAAuB,IAAI,CAAC","sourcesContent":["// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.\n// See LICENSE in the project root for license information.\n\nexport const LOCALE_FILENAME_TOKEN: '[locale]' = '[locale]';\nexport const LOCALE_FILENAME_TOKEN_REGEX: RegExp = /\\[locale\\]/gi;\nexport const NO_LOCALE_SOURCE_MAP_FILENAME_TOKEN: '[no-locale-file]' = '[no-locale-file]';\nexport const NO_LOCALE_SOURCE_MAP_FILENAME_TOKEN_REGEX: RegExp = /\\[no-locale-file\\]/gi;\nexport const STRING_PLACEHOLDER_PREFIX: '_LOCALIZED_STRING_f12dy0i7_n4bo_dqwj_39gf_sasqehjmihz9' =\n  '_LOCALIZED_STRING_f12dy0i7_n4bo_dqwj_39gf_sasqehjmihz9';\n\nexport const RESOURCE_FILE_NAME_REGEXP: RegExp = /\\.(resx|resx\\.json|loc\\.json|resjson)$/i;\n\nexport const STRING_PLACEHOLDER_LABEL: 'A' = 'A';\nexport const LOCALE_NAME_PLACEHOLDER_LABEL: 'B' = 'B';\nexport const JSONP_PLACEHOLDER_LABEL: 'C' = 'C';\n\nexport const LOCALE_NAME_PLACEHOLDER: `${typeof STRING_PLACEHOLDER_PREFIX}__${typeof LOCALE_NAME_PLACEHOLDER_LABEL}_0` = `${STRING_PLACEHOLDER_PREFIX}__${LOCALE_NAME_PLACEHOLDER_LABEL}_0`;\nexport const JSONP_PLACEHOLDER: `${typeof STRING_PLACEHOLDER_PREFIX}__${typeof JSONP_PLACEHOLDER_LABEL}_0` = `${STRING_PLACEHOLDER_PREFIX}__${JSONP_PLACEHOLDER_LABEL}_0`;\n"]}

package/lib/utilities/EntityMarker.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Marks a webpack entity as containing or not containing localized resources.
+ */
+export declare function markEntity(entity: object, value: boolean): void;
+/**
+ * Read the cache marker for whether or not the entity contains localized resources.
+ */
+export declare function getMark(entity: object): boolean | undefined;
+//# sourceMappingURL=EntityMarker.d.ts.map

package/lib/utilities/EntityMarker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EntityMarker.d.ts","sourceRoot":"","sources":["../../src/utilities/EntityMarker.ts"],"names":[],"mappings":"AAKA;;GAEG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAE/D;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAE3D"}

package/lib/utilities/EntityMarker.js

@@ -0,0 +1,21 @@
+"use strict";
+// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
+// See LICENSE in the project root for license information.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getMark = exports.markEntity = void 0;
+const MARKS = new WeakMap();
+/**
+ * Marks a webpack entity as containing or not containing localized resources.
+ */
+function markEntity(entity, value) {
+    MARKS.set(entity, value);
+}
+exports.markEntity = markEntity;
+/**
+ * Read the cache marker for whether or not the entity contains localized resources.
+ */
+function getMark(entity) {
+    return MARKS.get(entity);
+}
+exports.getMark = getMark;
+//# sourceMappingURL=EntityMarker.js.map

package/lib/utilities/EntityMarker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EntityMarker.js","sourceRoot":"","sources":["../../src/utilities/EntityMarker.ts"],"names":[],"mappings":";AAAA,4FAA4F;AAC5F,2DAA2D;;;AAE3D,MAAM,KAAK,GAA6B,IAAI,OAAO,EAAE,CAAC;AAEtD;;GAEG;AACH,SAAgB,UAAU,CAAC,MAAc,EAAE,KAAc;IACvD,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;AAC3B,CAAC;AAFD,gCAEC;AAED;;GAEG;AACH,SAAgB,OAAO,CAAC,MAAc;IACpC,OAAO,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;AAC3B,CAAC;AAFD,0BAEC","sourcesContent":["// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.\n// See LICENSE in the project root for license information.\n\nconst MARKS: WeakMap<object, boolean> = new WeakMap();\n\n/**\n * Marks a webpack entity as containing or not containing localized resources.\n */\nexport function markEntity(entity: object, value: boolean): void {\n  MARKS.set(entity, value);\n}\n\n/**\n * Read the cache marker for whether or not the entity contains localized resources.\n */\nexport function getMark(entity: object): boolean | undefined {\n  return MARKS.get(entity);\n}\n"]}

package/lib/utilities/LoaderTerminalProvider.d.ts

@@ -0,0 +1,6 @@
+import type { LoaderContext } from 'webpack';
+import { ITerminalProvider } from '@rushstack/node-core-library';
+export declare class LoaderTerminalProvider {
+    static getTerminalProviderForLoader(loaderContext: LoaderContext<{}>): ITerminalProvider;
+}
+//# sourceMappingURL=LoaderTerminalProvider.d.ts.map

package/lib/utilities/LoaderTerminalProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LoaderTerminalProvider.d.ts","sourceRoot":"","sources":["../../src/utilities/LoaderTerminalProvider.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7C,OAAO,EAAE,iBAAiB,EAA4B,MAAM,8BAA8B,CAAC;AAE3F,qBAAa,sBAAsB;WACnB,4BAA4B,CAAC,aAAa,EAAE,aAAa,CAAC,EAAE,CAAC,GAAG,iBAAiB;CAmBhG"}

package/lib/utilities/LoaderTerminalProvider.js

@@ -0,0 +1,28 @@
+"use strict";
+// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
+// See LICENSE in the project root for license information.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LoaderTerminalProvider = void 0;
+const node_core_library_1 = require("@rushstack/node-core-library");
+class LoaderTerminalProvider {
+    static getTerminalProviderForLoader(loaderContext) {
+        return {
+            supportsColor: false,
+            eolCharacter: '\n',
+            write: (data, severity) => {
+                switch (severity) {
+                    case node_core_library_1.TerminalProviderSeverity.error: {
+                        loaderContext.emitError(new Error(data));
+                        break;
+                    }
+                    case node_core_library_1.TerminalProviderSeverity.warning: {
+                        loaderContext.emitWarning(new Error(data));
+                        break;
+                    }
+                }
+            }
+        };
+    }
+}
+exports.LoaderTerminalProvider = LoaderTerminalProvider;
+//# sourceMappingURL=LoaderTerminalProvider.js.map

package/lib/utilities/LoaderTerminalProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LoaderTerminalProvider.js","sourceRoot":"","sources":["../../src/utilities/LoaderTerminalProvider.ts"],"names":[],"mappings":";AAAA,4FAA4F;AAC5F,2DAA2D;;;AAG3D,oEAA2F;AAE3F,MAAa,sBAAsB;IAC1B,MAAM,CAAC,4BAA4B,CAAC,aAAgC;QACzE,OAAO;YACL,aAAa,EAAE,KAAK;YACpB,YAAY,EAAE,IAAI;YAClB,KAAK,EAAE,CAAC,IAAY,EAAE,QAAkC,EAAE,EAAE;gBAC1D,QAAQ,QAAQ,EAAE;oBAChB,KAAK,4CAAwB,CAAC,KAAK,CAAC,CAAC;wBACnC,aAAa,CAAC,SAAS,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;wBACzC,MAAM;qBACP;oBAED,KAAK,4CAAwB,CAAC,OAAO,CAAC,CAAC;wBACrC,aAAa,CAAC,WAAW,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;wBAC3C,MAAM;qBACP;iBACF;YACH,CAAC;SACF,CAAC;IACJ,CAAC;CACF;AApBD,wDAoBC","sourcesContent":["// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.\n// See LICENSE in the project root for license information.\n\nimport type { LoaderContext } from 'webpack';\nimport { ITerminalProvider, TerminalProviderSeverity } from '@rushstack/node-core-library';\n\nexport class LoaderTerminalProvider {\n  public static getTerminalProviderForLoader(loaderContext: LoaderContext<{}>): ITerminalProvider {\n    return {\n      supportsColor: false,\n      eolCharacter: '\\n',\n      write: (data: string, severity: TerminalProviderSeverity) => {\n        switch (severity) {\n          case TerminalProviderSeverity.error: {\n            loaderContext.emitError(new Error(data));\n            break;\n          }\n\n          case TerminalProviderSeverity.warning: {\n            loaderContext.emitWarning(new Error(data));\n            break;\n          }\n        }\n      }\n    };\n  }\n}\n"]}

package/lib/webpackInterfaces.d.ts

@@ -0,0 +1,13 @@
+import type { Chunk, Compilation } from 'webpack';
+/**
+ * @public
+ */
+export interface ILocalizedWebpackChunk extends Chunk {
+    localizedFiles?: {
+        [locale: string]: string;
+    };
+}
+export declare type IAssetPathOptions = Parameters<typeof Compilation.prototype.getPath>[1] & {
+    locale?: string;
+};
+//# sourceMappingURL=webpackInterfaces.d.ts.map

package/lib/webpackInterfaces.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webpackInterfaces.d.ts","sourceRoot":"","sources":["../src/webpackInterfaces.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAElD;;GAEG;AACH,MAAM,WAAW,sBAAuB,SAAQ,KAAK;IACnD,cAAc,CAAC,EAAE;QAAE,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC;CAC/C;AAED,oBAAY,iBAAiB,GAAG,UAAU,CAAC,OAAO,WAAW,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG;IACpF,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC"}

package/lib/webpackInterfaces.js

@@ -0,0 +1,5 @@
+"use strict";
+// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
+// See LICENSE in the project root for license information.
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=webpackInterfaces.js.map

package/lib/webpackInterfaces.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webpackInterfaces.js","sourceRoot":"","sources":["../src/webpackInterfaces.ts"],"names":[],"mappings":";AAAA,4FAA4F;AAC5F,2DAA2D","sourcesContent":["// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.\n// See LICENSE in the project root for license information.\n\nimport type { Chunk, Compilation } from 'webpack';\n\n/**\n * @public\n */\nexport interface ILocalizedWebpackChunk extends Chunk {\n  localizedFiles?: { [locale: string]: string };\n}\n\nexport type IAssetPathOptions = Parameters<typeof Compilation.prototype.getPath>[1] & {\n  locale?: string;\n};\n"]}

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@rushstack/webpack5-localization-plugin",
+  "version": "0.1.0",
+  "description": "This plugin facilitates localization with Webpack.",
+  "main": "lib/index.js",
+  "typings": "dist/webpack5-localization-plugin.d.ts",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/microsoft/rushstack.git",
+    "directory": "webpack/localization-plugin-5"
+  },
+  "peerDependencies": {
+    "webpack": "^5.68.0"
+  },
+  "dependencies": {
+    "@rushstack/localization-utilities": "0.7.2",
+    "@rushstack/node-core-library": "3.45.7",
+    "@types/node": "12.20.24"
+  },
+  "devDependencies": {
+    "@rushstack/eslint-config": "2.6.1",
+    "@rushstack/heft": "0.45.9",
+    "@rushstack/heft-node-rig": "1.9.10",
+    "@types/heft-jest": "1.0.1",
+    "memfs": "3.4.3",
+    "webpack": "~5.68.0"
+  },
+  "scripts": {
+    "build": "heft build --clean",
+    "_phase:build": "heft build --clean",
+    "_phase:test": "heft test --no-build"
+  },
+  "readme": "# @rushstack/webpack5-localization-plugin\n\n## Installation\n\n`npm install @rushstack/webpack5-localization-plugin --save-dev`\n\n## Overview\n\nThis Webpack plugin produces bundles that have multiple locales' variants of strings embedded. It also\nhas out-of-box support for RESX files in addition to JSON strings files (with the extensions `.loc.json` or `.resjson`).\n\nThe loaders can also be chained with other loaders that convert the content to one of the known formats.\n\n# Plugin\n\nTo use the plugin, add it to the `plugins` array of your Webpack config, and specify one or more loaders. For example:\n\n```JavaScript\nimport { LocalizationPlugin } from '@rushstack/webpack5-localization-plugin';\n\n{\n  plugins: [\n    new LocalizationPlugin( /* options */ )\n  ],\n  module: {\n    rules: [{\n      test: /\\.resjson$/,\n      use: {\n        // All loaders are available in `@rushstack/webpack5-localization-plugin/lib/loaders/`\n        // Loaders for specific formats: `resjson-loader`, `locjson-loader`, `resx-loader`\n        // Loader that switches on file extension: `loc-loader`\n        // Loader that switches on file extension and skips localization: `default-locale-loader`\n        loader: require.resolve('@rushstack/webpack5-localization-plugin/lib/loaders/resjson-loader')\n      },\n      // Can be one of `javascript/esm`, `javascript/dynamic`, or `json`\n      // `javascript/esm` will produce the smallest bundle sizes, while `json` will produce faster code for large string tables\n      type: 'javascript/esm',\n      sideEffects: false\n    }]\n  }\n}\n```\n\n***A note about the dev server:*** When Webpack is being run by the Webpack dev server, this plugin pipes\nthe strings in the loc files in the source (the `.loc.json` and the `.resx` files) to the output without\nany translations.\n\n## Options\n\n### `localizedData = { }`\n\n#### `localizedData.defaultLocale = { }`\n\nThis option has a required property (`localeName`), to specify the name of the locale used in the\n`.resx` and `.loc.json` files in the source.\n\n##### `localizedData.defaultLocale.fillMissingTranslationStrings = true | false`\n\nIf this option is set to `true`, strings that are missing from `localizedData.translatedStrings` will be\nprovided by the default locale (the strings in the `.resx` and `.loc.json` files in the source). If\nthis option is unset or set to `false`, an error will be emitted if a string is missing from\n`localizedData.translatedStrings`.\n\n#### `localizedData.translatedStrings = { }`\n\nThis option is used to specify the localization data to be used in the build. This object has the following\nstructure:\n\n- Locale name\n  - Compilation context-relative or absolute localization file path\n    - Translated strings\n\nFor example:\n\n```JavaScript\ntranslatedStrings: {\n  \"en-us\": {\n    \"./src/strings1.loc.json\": {\n      \"string1\": \"the first string\"\n    }\n  },\n  \"es-es\": {\n    \"./src/strings1.loc.json\": {\n      \"string1\": \"la primera cadena\"\n    }\n  }\n}\n```\n\nAlternatively, instead of directly specifying the translations, a path to a translated resource file can be\nspecified. For example:\n\n```JavaScript\ntranslatedStrings: {\n  \"en-us\": {\n    \"./src/strings1.loc.json\": \"./localization/en-us/strings1.loc.json\"\n  },\n  \"es-es\": {\n    \"./src/strings1.loc.json\": \"./localization/es-es/strings1.loc.json\"\n  }\n}\n```\n\n#### `localizedData.resolveMissingTranslatedStrings = (locales: string[], filePath: string, context: LoaderContext<{}>) => { ... }`\n\nThis optional option can be used to resolve translated data that is missing from data that is provided\nin the `localizedData.translatedStrings` option. Set this option with a function expecting two parameters:\nthe first, an array of locale names, and second, a fully-qualified path to the localized file in source. The\nfunction should synchronously or asynchronously (as a promise) return an object (or map) with locale names as keys and localized\ndata as values. The localized data value should be one of:\n\n- a string: The absolute path to the translated data in `.resx`, `.loc.json`, or `.resjson` format\n- an object: An object containing the translated data\n- a map: A map containing the translated data\n\nNote that these values are the same as the values that can be specified for translations for a localized\nresource in `localizedData.translatedStrings`.\n\nIf the function returns data that is missing locales or individual strings, the plugin will fall back to the\ndefault locale if `localizedData.defaultLocale.fillMissingTranslationStrings` is set to `true`. If\n`localizedData.defaultLocale.fillMissingTranslationStrings` is set to `false`, an error will result.\n\n#### `localizedData.passthroughLocale = { }`\n\nThis option is used to specify how and if a passthrough locale should be generated. A passthrough locale\nis a generated locale in which each string's value is its name. This is useful for debugging and for identifying\ncases where a locale is missing.\n\nThis option takes two optional properties:\n\n##### `localizedData.passthroughLocale.usePassthroughLocale = true | false`\n\nIf `passthroughLocale.usePassthroughLocale` is set to `true`, a passthrough locale will be included in the output.\nBy default, the passthrough locale's name is \"passthrough.\"\n\n##### `localizedData.passthroughLocale.passthroughLocaleName = '...'`\n\nIf `passthroughLocale.usePassthroughLocale` is set to `true`, the \"passthrough\" locale name can be overridden\nby setting a value on `passthroughLocale.passthroughLocaleName`.\n\n#### `localizedData.pseudolocales = { }`\n\nThis option allows pseudolocales to be generated from the strings in the default locale. This option takes\nan option with pseudolocales as keys and options for the\n[pseudolocale package](https://www.npmjs.com/package/pseudolocale) as values.\n\n### `noStringsLocaleName = '...'`\n\nThe value to replace the `[locale]` token with for chunks without localized strings. Defaults to \"none\"\n\n### `runtimeLocaleExpression = '...'`\n\nA chunk of raw ECMAScript to inject into the webpack runtime to resolve the current locale at execution time. Allows\nmultiple locales to share the same runtime chunk if it does not directly contain localized strings.\n\n### `localizationStats = { }`\n\n#### `localizationStats.dropPath = '...'`\n\nThis option is used to designate a path at which a JSON file describing the localized assets produced should be\nwritten. If this property is omitted, the stats file won't be written.\n\nThe file has the following format:\n\n```JSON\n{\n  \"entrypoints\": {\n    \"<BUNDLE NAME>\": {\n      \"localizedAssets\": {\n        \"<LOCALE NAME>\": \"<ASSET NAME>\",\n        \"<LOCALE NAME>\": \"<ASSET NAME>\"\n      }\n    },\n    \"<BUNDLE NAME>\": {\n      \"localizedAssets\": {\n        \"<LOCALE NAME>\": \"<ASSET NAME>\",\n        \"<LOCALE NAME>\": \"<ASSET NAME>\"\n      }\n    }\n  },\n  \"namedChunkGroups\": {\n    \"<CHUNK NAME>\": {\n      \"localizedAssets\": {\n        \"<LOCALE NAME>\": \"<ASSET NAME>\",\n        \"<LOCALE NAME>\": \"<ASSET NAME>\"\n      }\n    },\n    \"<CHUNK NAME>\": {\n      \"localizedAssets\": {\n        \"<LOCALE NAME>\": \"<ASSET NAME>\",\n        \"<LOCALE NAME>\": \"<ASSET NAME>\"\n      }\n    }\n  }\n}\n\n```\n\n#### `localizationStats.callback = (stats) => { ... }`\n\nThis option is used to specify a callback to be called with the stats data that would be dropped at\n[`localizationStats.dropPath`](#localizationStats.DropPath--) after compilation completes.\n\n## Links\n\n- [CHANGELOG.md](https://github.com/microsoft/rushstack/blob/main/webpack/localization-plugin/CHANGELOG.md) - Find\n  out what's new in the latest version\n\n`@rushstack/webpack5-localization-plugin` is part of the [Rush Stack](https://rushstack.io/) family of projects.\n"
+}