@fgv/ts-bcp47 0.5.0

package/bcp47/validation/validateTag.js

@@ -0,0 +1,159 @@
+"use strict";
+/*
+ * Copyright (c) 2022 Erik Fortune
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ValidateTag = void 0;
+const ts_utils_1 = require("@fgv/ts-utils");
+const common_1 = require("./common");
+const isCanonical_1 = require("./isCanonical");
+const isInPreferredForm_1 = require("./isInPreferredForm");
+const isStrictlyValid_1 = require("./isStrictlyValid");
+const isValid_1 = require("./isValid");
+const isWellFormed_1 = require("./isWellFormed");
+/**
+ * Validation helpers for BCP-47 language tags.
+ * @public
+ */
+class ValidateTag {
+    /**
+     * Determines if supplied {@link Bcp47.Subtags | subtags } are in canonical form,
+     * meaning that they are at least well-formed as specified by
+     * {@link https://www.rfc-editor.org/rfc/rfc5646.html#section-2.2.9 | RFC 5646}, and
+     * all subtags are also
+     * {@link https://www.rfc-editor.org/rfc/rfc5646.html#section-2.1.1 | capitalized as recommended}.
+     * @param subtags - The {@link Bcp47.Subtags | subtags } to test.
+     * @returns `true` if the {@link Bcp47.Subtags | subtags } represent
+     * a language tag in canonical, false otherwise.
+     * @example `en-US` is in canonical form, `en-us` is not.
+     * @example `eng-US` is in canonical form, `eng-us` is not.
+     */
+    static isCanonical(subtags) {
+        if (!this._isCanonical) {
+            this._isCanonical = new isCanonical_1.IsCanonicalValidator();
+        }
+        return this._isCanonical.validateSubtags(subtags).isSuccess();
+    }
+    /**
+     * Determines if supplied {@link Bcp47.Subtags | subtags } are
+     * in preferred form. Preferred form is valid as specified by
+     * {@link  https://www.rfc-editor.org/rfc/rfc5646.html#section-2.2.9 | RFC 5646} and
+     * also meets additional preferences specified in the
+     * {@link https://www.iana.org/assignments/language-subtag-registry/language-subtag-registry | language subtag registry} -
+     * extraneous (suppressed) script tags, deprecated language, extlang, script or region tags or
+     * deprecated grandfathered or redundant tags (with a defined preferred-value) are not allowed.
+     * @param subtags - The {@link Bcp47.Subtags | subtags } to test.
+     * @returns `true` if the {@link Bcp47.Subtags | subtags } represent
+     * a valid language tag in preferred form, false otherwise.
+     * @example `en-US` is in preferred form, `en-Latn-US` is not.
+     * @example `cmn` is in preferred form, `zh-cmn-Hans` is not.
+     */
+    static isInPreferredForm(subtags) {
+        if (!this._isInPreferredForm) {
+            this._isInPreferredForm = new isInPreferredForm_1.IsInPreferredFromValidator();
+        }
+        return this._isInPreferredForm.validateSubtags(subtags).isSuccess();
+    }
+    /**
+     * Determines if supplied {@link Bcp47.Subtags | subtags } are
+     * strictly valid.  A strictly valid tag is both
+     * {@link https://www.rfc-editor.org/rfc/rfc5646.html#section-2.2.9 | valid as defined in the RFC}
+     * and meets any other requirements such as
+     * {@link https://www.rfc-editor.org/rfc/rfc5646.html#section-3.1.8 | prefix validity}.
+     * @param subtags - The {@link Bcp47.Subtags | subtags } to test.
+     * @returns `true` if the {@link Bcp47.Subtags | subtags } represent
+     * a strictly valid language tag, false otherwise.
+     * @example `ca-valencia` is strictly valid, `es-valencia` is not.
+     */
+    static isStrictlyValid(subtags) {
+        return this.validateSubtags(subtags, 'strictly-valid').isSuccess();
+    }
+    /**
+     * Determines if supplied {@link Bcp47.Subtags | subtags } are
+     * valid as specified by {@link https://www.rfc-editor.org/rfc/rfc5646.html#section-2.2.9 | RFC 5646},
+     * meaning that all subtags, or the tag itself for grandfathered tags, are defined in the
+     * {@link https://www.iana.org/assignments/language-subtag-registry/language-subtag-registry | IANA language subtag registry}.
+     * @param subtags - The {@link Bcp47.Subtags | subtags } to test.
+     * @returns `true` if the {@link Bcp47.Subtags | subtags } represent
+     * a valid language tag, false otherwise.
+     * @example `en-US` is valid, `eng-US` is not.
+     */
+    static isValid(subtags) {
+        return this.validateSubtags(subtags, 'valid').isSuccess();
+    }
+    /**
+     * Determines if supplied {@link Bcp47.Subtags | subtags } are
+     * well-formed as specified by {@link https://www.rfc-editor.org/rfc/rfc5646.html#section-2.2.9 | RFC 5646},
+     * meaning that all subtags meet the grammar defined in the specification.
+     * @param subtags - The {@link Bcp47.Subtags | subtags } to test.
+     * @returns `true` if the {@link Bcp47.Subtags | subtags } represent
+     * a well-formed language tag, false otherwise.
+     * @example `en-US` is valid, `english-US` is not.
+     * @public
+     */
+    static isWellFormed(subtags) {
+        return this.validateSubtags(subtags, 'well-formed').isSuccess();
+    }
+    /**
+     * Chooses an appropriate default tag validator given desired and optional current
+     * {@link Bcp47.TagValidity | validation level}.
+     * @param wantValidity - The desired {@link Bcp47.TagValidity | validity level}.
+     * @param haveValidity - (optional) The current {@link Bcp47.TagValidity | validity level}.
+     * @returns An appropriate {@link Bcp47.TagValidator | tag validator} or `undefined` if no
+     * additional validation is necessary.
+     * @internal
+     */
+    static chooseValidator(wantValidity, haveValidity) {
+        if (haveValidity && (0, common_1.compareValidity)(haveValidity, wantValidity) >= 0) {
+            return undefined;
+        }
+        if (!this._validators) {
+            this._validators = {
+                /* eslint-disable @typescript-eslint/naming-convention */
+                unknown: new isWellFormed_1.IsWellFormedValidator(),
+                'well-formed': new isWellFormed_1.IsWellFormedValidator(),
+                valid: new isValid_1.IsValidValidator(),
+                'strictly-valid': new isStrictlyValid_1.IsStrictlyValidValidator(),
+                /* eslint-enable @typescript-eslint/naming-convention */
+            };
+        }
+        return this._validators[wantValidity];
+    }
+    /**
+     * Validates supplied {@link Bcp47.Subtags | subtags } to a requested
+     * {@link Bcp47.TagValidity | validity level}, if necessary.
+     * @param subtags - The {@link Bcp47.Subtags | subtags } to be validated.
+     * @param wantValidity - The desired {@link Bcp47.TagValidity | validity level}.
+     * @param haveValidity - (optional) The current {@link Bcp47.TagValidity | validity level}.
+     * @returns `Success` with the validated {@link Bcp47.Subtags | subtags }, or
+     * `Failure` with details if an error occurs.
+     * @public
+     */
+    static validateSubtags(subtags, wantValidity, haveValidity) {
+        var _a;
+        const validator = this.chooseValidator(wantValidity, haveValidity);
+        // istanbul ignore next - a pain to test
+        return (_a = validator === null || validator === void 0 ? void 0 : validator.validateSubtags(subtags)) !== null && _a !== void 0 ? _a : (0, ts_utils_1.succeed)(true);
+    }
+}
+exports.ValidateTag = ValidateTag;
+ValidateTag._validators = undefined;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidmFsaWRhdGVUYWcuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi9zcmMvYmNwNDcvdmFsaWRhdGlvbi92YWxpZGF0ZVRhZy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiO0FBQUE7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7O0dBb0JHOzs7QUFFSCw0Q0FBZ0Q7QUFDaEQscUNBQXdEO0FBRXhELCtDQUFxRDtBQUNyRCwyREFBaUU7QUFDakUsdURBQTZEO0FBQzdELHVDQUE2QztBQUM3QyxpREFBdUQ7QUFJdkQ7OztHQUdHO0FBQ0gsTUFBYSxXQUFXO0lBS3BCOzs7Ozs7Ozs7OztPQVdHO0lBQ0ksTUFBTSxDQUFDLFdBQVcsQ0FBQyxPQUFnQjtRQUN0QyxJQUFJLENBQUMsSUFBSSxDQUFDLFlBQVksRUFBRTtZQUNwQixJQUFJLENBQUMsWUFBWSxHQUFHLElBQUksa0NBQW9CLEVBQUUsQ0FBQztTQUNsRDtRQUNELE9BQU8sSUFBSSxDQUFDLFlBQVksQ0FBQyxlQUFlLENBQUMsT0FBTyxDQUFDLENBQUMsU0FBUyxFQUFFLENBQUM7SUFDbEUsQ0FBQztJQUVEOzs7Ozs7Ozs7Ozs7O09BYUc7SUFDSSxNQUFNLENBQUMsaUJBQWlCLENBQUMsT0FBZ0I7UUFDNUMsSUFBSSxDQUFDLElBQUksQ0FBQyxrQkFBa0IsRUFBRTtZQUMxQixJQUFJLENBQUMsa0JBQWtCLEdBQUcsSUFBSSw4Q0FBMEIsRUFBRSxDQUFDO1NBQzlEO1FBQ0QsT0FBTyxJQUFJLENBQUMsa0JBQWtCLENBQUMsZUFBZSxDQUFDLE9BQU8sQ0FBQyxDQUFDLFNBQVMsRUFBRSxDQUFDO0lBQ3hFLENBQUM7SUFFRDs7Ozs7Ozs7OztPQVVHO0lBQ0ksTUFBTSxDQUFDLGVBQWUsQ0FBQyxPQUFnQjtRQUMxQyxPQUFPLElBQUksQ0FBQyxlQUFlLENBQUMsT0FBTyxFQUFFLGdCQUFnQixDQUFDLENBQUMsU0FBUyxFQUFFLENBQUM7SUFDdkUsQ0FBQztJQUVEOzs7Ozs7Ozs7T0FTRztJQUNJLE1BQU0sQ0FBQyxPQUFPLENBQUMsT0FBZ0I7UUFDbEMsT0FBTyxJQUFJLENBQUMsZUFBZSxDQUFDLE9BQU8sRUFBRSxPQUFPLENBQUMsQ0FBQyxTQUFTLEVBQUUsQ0FBQztJQUM5RCxDQUFDO0lBRUQ7Ozs7Ozs7OztPQVNHO0lBQ0ksTUFBTSxDQUFDLFlBQVksQ0FBQyxPQUFnQjtRQUN2QyxPQUFPLElBQUksQ0FBQyxlQUFlLENBQUMsT0FBTyxFQUFFLGFBQWEsQ0FBQyxDQUFDLFNBQVMsRUFBRSxDQUFDO0lBQ3BFLENBQUM7SUFFRDs7Ozs7Ozs7T0FRRztJQUNJLE1BQU0sQ0FBQyxlQUFlLENBQUMsWUFBeUIsRUFBRSxZQUEwQjtRQUMvRSxJQUFJLFlBQVksSUFBSSxJQUFBLHdCQUFlLEVBQUMsWUFBWSxFQUFFLFlBQVksQ0FBQyxJQUFJLENBQUMsRUFBRTtZQUNsRSxPQUFPLFNBQVMsQ0FBQztTQUNwQjtRQUVELElBQUksQ0FBQyxJQUFJLENBQUMsV0FBVyxFQUFFO1lBQ25CLElBQUksQ0FBQyxXQUFXLEdBQUc7Z0JBQ2YseURBQXlEO2dCQUN6RCxPQUFPLEVBQUUsSUFBSSxvQ0FBcUIsRUFBRTtnQkFDcEMsYUFBYSxFQUFFLElBQUksb0NBQXFCLEVBQUU7Z0JBQzFDLEtBQUssRUFBRSxJQUFJLDBCQUFnQixFQUFFO2dCQUM3QixnQkFBZ0IsRUFBRSxJQUFJLDBDQUF3QixFQUFFO2dCQUNoRCx3REFBd0Q7YUFDM0QsQ0FBQztTQUNMO1FBQ0QsT0FBTyxJQUFJLENBQUMsV0FBWSxDQUFDLFlBQVksQ0FBQyxDQUFDO0lBQzNDLENBQUM7SUFFRDs7Ozs7Ozs7O09BU0c7SUFDSSxNQUFNLENBQUMsZUFBZSxDQUFDLE9BQWdCLEVBQUUsWUFBeUIsRUFBRSxZQUEwQjs7UUFDakcsTUFBTSxTQUFTLEdBQUcsSUFBSSxDQUFDLGVBQWUsQ0FBQyxZQUFZLEVBQUUsWUFBWSxDQUFDLENBQUM7UUFDbkUsd0NBQXdDO1FBQ3hDLE9BQU8sTUFBQSxTQUFTLGFBQVQsU0FBUyx1QkFBVCxTQUFTLENBQUUsZUFBZSxDQUFDLE9BQU8sQ0FBQyxtQ0FBSSxJQUFBLGtCQUFPLEVBQUMsSUFBSSxDQUFDLENBQUM7SUFDaEUsQ0FBQzs7QUFqSUwsa0NBa0lDO0FBL0hrQix1QkFBVyxHQUFrRCxTQUFTLENBQUMiLCJzb3VyY2VzQ29udGVudCI6WyIvKlxuICogQ29weXJpZ2h0IChjKSAyMDIyIEVyaWsgRm9ydHVuZVxuICpcbiAqIFBlcm1pc3Npb24gaXMgaGVyZWJ5IGdyYW50ZWQsIGZyZWUgb2YgY2hhcmdlLCB0byBhbnkgcGVyc29uIG9idGFpbmluZyBhIGNvcHlcbiAqIG9mIHRoaXMgc29mdHdhcmUgYW5kIGFzc29jaWF0ZWQgZG9jdW1lbnRhdGlvbiBmaWxlcyAodGhlIFwiU29mdHdhcmVcIiksIHRvIGRlYWxcbiAqIGluIHRoZSBTb2Z0d2FyZSB3aXRob3V0IHJlc3RyaWN0aW9uLCBpbmNsdWRpbmcgd2l0aG91dCBsaW1pdGF0aW9uIHRoZSByaWdodHNcbiAqIHRvIHVzZSwgY29weSwgbW9kaWZ5LCBtZXJnZSwgcHVibGlzaCwgZGlzdHJpYnV0ZSwgc3VibGljZW5zZSwgYW5kL29yIHNlbGxcbiAqIGNvcGllcyBvZiB0aGUgU29mdHdhcmUsIGFuZCB0byBwZXJtaXQgcGVyc29ucyB0byB3aG9tIHRoZSBTb2Z0d2FyZSBpc1xuICogZnVybmlzaGVkIHRvIGRvIHNvLCBzdWJqZWN0IHRvIHRoZSBmb2xsb3dpbmcgY29uZGl0aW9uczpcbiAqXG4gKiBUaGUgYWJvdmUgY29weXJpZ2h0IG5vdGljZSBhbmQgdGhpcyBwZXJtaXNzaW9uIG5vdGljZSBzaGFsbCBiZSBpbmNsdWRlZCBpbiBhbGxcbiAqIGNvcGllcyBvciBzdWJzdGFudGlhbCBwb3J0aW9ucyBvZiB0aGUgU29mdHdhcmUuXG4gKlxuICogVEhFIFNPRlRXQVJFIElTIFBST1ZJREVEIFwiQVMgSVNcIiwgV0lUSE9VVCBXQVJSQU5UWSBPRiBBTlkgS0lORCwgRVhQUkVTUyBPUlxuICogSU1QTElFRCwgSU5DTFVESU5HIEJVVCBOT1QgTElNSVRFRCBUTyBUSEUgV0FSUkFOVElFUyBPRiBNRVJDSEFOVEFCSUxJVFksXG4gKiBGSVRORVNTIEZPUiBBIFBBUlRJQ1VMQVIgUFVSUE9TRSBBTkQgTk9OSU5GUklOR0VNRU5ULiBJTiBOTyBFVkVOVCBTSEFMTCBUSEVcbiAqIEFVVEhPUlMgT1IgQ09QWVJJR0hUIEhPTERFUlMgQkUgTElBQkxFIEZPUiBBTlkgQ0xBSU0sIERBTUFHRVMgT1IgT1RIRVJcbiAqIExJQUJJTElUWSwgV0hFVEhFUiBJTiBBTiBBQ1RJT04gT0YgQ09OVFJBQ1QsIFRPUlQgT1IgT1RIRVJXSVNFLCBBUklTSU5HIEZST00sXG4gKiBPVVQgT0YgT1IgSU4gQ09OTkVDVElPTiBXSVRIIFRIRSBTT0ZUV0FSRSBPUiBUSEUgVVNFIE9SIE9USEVSIERFQUxJTkdTIElOIFRIRVxuICogU09GVFdBUkUuXG4gKi9cblxuaW1wb3J0IHsgUmVzdWx0LCBzdWNjZWVkIH0gZnJvbSAnQGZndi90cy11dGlscyc7XG5pbXBvcnQgeyBUYWdWYWxpZGl0eSwgY29tcGFyZVZhbGlkaXR5IH0gZnJvbSAnLi9jb21tb24nO1xuXG5pbXBvcnQgeyBJc0Nhbm9uaWNhbFZhbGlkYXRvciB9IGZyb20gJy4vaXNDYW5vbmljYWwnO1xuaW1wb3J0IHsgSXNJblByZWZlcnJlZEZyb21WYWxpZGF0b3IgfSBmcm9tICcuL2lzSW5QcmVmZXJyZWRGb3JtJztcbmltcG9ydCB7IElzU3RyaWN0bHlWYWxpZFZhbGlkYXRvciB9IGZyb20gJy4vaXNTdHJpY3RseVZhbGlkJztcbmltcG9ydCB7IElzVmFsaWRWYWxpZGF0b3IgfSBmcm9tICcuL2lzVmFsaWQnO1xuaW1wb3J0IHsgSXNXZWxsRm9ybWVkVmFsaWRhdG9yIH0gZnJvbSAnLi9pc1dlbGxGb3JtZWQnO1xuaW1wb3J0IHsgU3VidGFncyB9IGZyb20gJy4uL2NvbW1vbic7XG5pbXBvcnQgeyBUYWdWYWxpZGF0b3IgfSBmcm9tICcuL2Jhc2VWYWxpZGF0b3InO1xuXG4vKipcbiAqIFZhbGlkYXRpb24gaGVscGVycyBmb3IgQkNQLTQ3IGxhbmd1YWdlIHRhZ3MuXG4gKiBAcHVibGljXG4gKi9cbmV4cG9ydCBjbGFzcyBWYWxpZGF0ZVRhZyB7XG4gICAgcHJpdmF0ZSBzdGF0aWMgX2lzQ2Fub25pY2FsPzogVGFnVmFsaWRhdG9yO1xuICAgIHByaXZhdGUgc3RhdGljIF9pc0luUHJlZmVycmVkRm9ybT86IFRhZ1ZhbGlkYXRvcjtcbiAgICBwcml2YXRlIHN0YXRpYyBfdmFsaWRhdG9yczogUmVjb3JkPFRhZ1ZhbGlkaXR5LCBUYWdWYWxpZGF0b3I+IHwgdW5kZWZpbmVkID0gdW5kZWZpbmVkO1xuXG4gICAgLyoqXG4gICAgICogRGV0ZXJtaW5lcyBpZiBzdXBwbGllZCB7QGxpbmsgQmNwNDcuU3VidGFncyB8IHN1YnRhZ3MgfSBhcmUgaW4gY2Fub25pY2FsIGZvcm0sXG4gICAgICogbWVhbmluZyB0aGF0IHRoZXkgYXJlIGF0IGxlYXN0IHdlbGwtZm9ybWVkIGFzIHNwZWNpZmllZCBieVxuICAgICAqIHtAbGluayBodHRwczovL3d3dy5yZmMtZWRpdG9yLm9yZy9yZmMvcmZjNTY0Ni5odG1sI3NlY3Rpb24tMi4yLjkgfCBSRkMgNTY0Nn0sIGFuZFxuICAgICAqIGFsbCBzdWJ0YWdzIGFyZSBhbHNvXG4gICAgICoge0BsaW5rIGh0dHBzOi8vd3d3LnJmYy1lZGl0b3Iub3JnL3JmYy9yZmM1NjQ2Lmh0bWwjc2VjdGlvbi0yLjEuMSB8IGNhcGl0YWxpemVkIGFzIHJlY29tbWVuZGVkfS5cbiAgICAgKiBAcGFyYW0gc3VidGFncyAtIFRoZSB7QGxpbmsgQmNwNDcuU3VidGFncyB8IHN1YnRhZ3MgfSB0byB0ZXN0LlxuICAgICAqIEByZXR1cm5zIGB0cnVlYCBpZiB0aGUge0BsaW5rIEJjcDQ3LlN1YnRhZ3MgfCBzdWJ0YWdzIH0gcmVwcmVzZW50XG4gICAgICogYSBsYW5ndWFnZSB0YWcgaW4gY2Fub25pY2FsLCBmYWxzZSBvdGhlcndpc2UuXG4gICAgICogQGV4YW1wbGUgYGVuLVVTYCBpcyBpbiBjYW5vbmljYWwgZm9ybSwgYGVuLXVzYCBpcyBub3QuXG4gICAgICogQGV4YW1wbGUgYGVuZy1VU2AgaXMgaW4gY2Fub25pY2FsIGZvcm0sIGBlbmctdXNgIGlzIG5vdC5cbiAgICAgKi9cbiAgICBwdWJsaWMgc3RhdGljIGlzQ2Fub25pY2FsKHN1YnRhZ3M6IFN1YnRhZ3MpOiBib29sZWFuIHtcbiAgICAgICAgaWYgKCF0aGlzLl9pc0Nhbm9uaWNhbCkge1xuICAgICAgICAgICAgdGhpcy5faXNDYW5vbmljYWwgPSBuZXcgSXNDYW5vbmljYWxWYWxpZGF0b3IoKTtcbiAgICAgICAgfVxuICAgICAgICByZXR1cm4gdGhpcy5faXNDYW5vbmljYWwudmFsaWRhdGVTdWJ0YWdzKHN1YnRhZ3MpLmlzU3VjY2VzcygpO1xuICAgIH1cblxuICAgIC8qKlxuICAgICAqIERldGVybWluZXMgaWYgc3VwcGxpZWQge0BsaW5rIEJjcDQ3LlN1YnRhZ3MgfCBzdWJ0YWdzIH0gYXJlXG4gICAgICogaW4gcHJlZmVycmVkIGZvcm0uIFByZWZlcnJlZCBmb3JtIGlzIHZhbGlkIGFzIHNwZWNpZmllZCBieVxuICAgICAqIHtAbGluayAgaHR0cHM6Ly93d3cucmZjLWVkaXRvci5vcmcvcmZjL3JmYzU2NDYuaHRtbCNzZWN0aW9uLTIuMi45IHwgUkZDIDU2NDZ9IGFuZFxuICAgICAqIGFsc28gbWVldHMgYWRkaXRpb25hbCBwcmVmZXJlbmNlcyBzcGVjaWZpZWQgaW4gdGhlXG4gICAgICoge0BsaW5rIGh0dHBzOi8vd3d3LmlhbmEub3JnL2Fzc2lnbm1lbnRzL2xhbmd1YWdlLXN1YnRhZy1yZWdpc3RyeS9sYW5ndWFnZS1zdWJ0YWctcmVnaXN0cnkgfCBsYW5ndWFnZSBzdWJ0YWcgcmVnaXN0cnl9IC1cbiAgICAgKiBleHRyYW5lb3VzIChzdXBwcmVzc2VkKSBzY3JpcHQgdGFncywgZGVwcmVjYXRlZCBsYW5ndWFnZSwgZXh0bGFuZywgc2NyaXB0IG9yIHJlZ2lvbiB0YWdzIG9yXG4gICAgICogZGVwcmVjYXRlZCBncmFuZGZhdGhlcmVkIG9yIHJlZHVuZGFudCB0YWdzICh3aXRoIGEgZGVmaW5lZCBwcmVmZXJyZWQtdmFsdWUpIGFyZSBub3QgYWxsb3dlZC5cbiAgICAgKiBAcGFyYW0gc3VidGFncyAtIFRoZSB7QGxpbmsgQmNwNDcuU3VidGFncyB8IHN1YnRhZ3MgfSB0byB0ZXN0LlxuICAgICAqIEByZXR1cm5zIGB0cnVlYCBpZiB0aGUge0BsaW5rIEJjcDQ3LlN1YnRhZ3MgfCBzdWJ0YWdzIH0gcmVwcmVzZW50XG4gICAgICogYSB2YWxpZCBsYW5ndWFnZSB0YWcgaW4gcHJlZmVycmVkIGZvcm0sIGZhbHNlIG90aGVyd2lzZS5cbiAgICAgKiBAZXhhbXBsZSBgZW4tVVNgIGlzIGluIHByZWZlcnJlZCBmb3JtLCBgZW4tTGF0bi1VU2AgaXMgbm90LlxuICAgICAqIEBleGFtcGxlIGBjbW5gIGlzIGluIHByZWZlcnJlZCBmb3JtLCBgemgtY21uLUhhbnNgIGlzIG5vdC5cbiAgICAgKi9cbiAgICBwdWJsaWMgc3RhdGljIGlzSW5QcmVmZXJyZWRGb3JtKHN1YnRhZ3M6IFN1YnRhZ3MpOiBib29sZWFuIHtcbiAgICAgICAgaWYgKCF0aGlzLl9pc0luUHJlZmVycmVkRm9ybSkge1xuICAgICAgICAgICAgdGhpcy5faXNJblByZWZlcnJlZEZvcm0gPSBuZXcgSXNJblByZWZlcnJlZEZyb21WYWxpZGF0b3IoKTtcbiAgICAgICAgfVxuICAgICAgICByZXR1cm4gdGhpcy5faXNJblByZWZlcnJlZEZvcm0udmFsaWRhdGVTdWJ0YWdzKHN1YnRhZ3MpLmlzU3VjY2VzcygpO1xuICAgIH1cblxuICAgIC8qKlxuICAgICAqIERldGVybWluZXMgaWYgc3VwcGxpZWQge0BsaW5rIEJjcDQ3LlN1YnRhZ3MgfCBzdWJ0YWdzIH0gYXJlXG4gICAgICogc3RyaWN0bHkgdmFsaWQuICBBIHN0cmljdGx5IHZhbGlkIHRhZyBpcyBib3RoXG4gICAgICoge0BsaW5rIGh0dHBzOi8vd3d3LnJmYy1lZGl0b3Iub3JnL3JmYy9yZmM1NjQ2Lmh0bWwjc2VjdGlvbi0yLjIuOSB8IHZhbGlkIGFzIGRlZmluZWQgaW4gdGhlIFJGQ31cbiAgICAgKiBhbmQgbWVldHMgYW55IG90aGVyIHJlcXVpcmVtZW50cyBzdWNoIGFzXG4gICAgICoge0BsaW5rIGh0dHBzOi8vd3d3LnJmYy1lZGl0b3Iub3JnL3JmYy9yZmM1NjQ2Lmh0bWwjc2VjdGlvbi0zLjEuOCB8IHByZWZpeCB2YWxpZGl0eX0uXG4gICAgICogQHBhcmFtIHN1YnRhZ3MgLSBUaGUge0BsaW5rIEJjcDQ3LlN1YnRhZ3MgfCBzdWJ0YWdzIH0gdG8gdGVzdC5cbiAgICAgKiBAcmV0dXJucyBgdHJ1ZWAgaWYgdGhlIHtAbGluayBCY3A0Ny5TdWJ0YWdzIHwgc3VidGFncyB9IHJlcHJlc2VudFxuICAgICAqIGEgc3RyaWN0bHkgdmFsaWQgbGFuZ3VhZ2UgdGFnLCBmYWxzZSBvdGhlcndpc2UuXG4gICAgICogQGV4YW1wbGUgYGNhLXZhbGVuY2lhYCBpcyBzdHJpY3RseSB2YWxpZCwgYGVzLXZhbGVuY2lhYCBpcyBub3QuXG4gICAgICovXG4gICAgcHVibGljIHN0YXRpYyBpc1N0cmljdGx5VmFsaWQoc3VidGFnczogU3VidGFncyk6IGJvb2xlYW4ge1xuICAgICAgICByZXR1cm4gdGhpcy52YWxpZGF0ZVN1YnRhZ3Moc3VidGFncywgJ3N0cmljdGx5LXZhbGlkJykuaXNTdWNjZXNzKCk7XG4gICAgfVxuXG4gICAgLyoqXG4gICAgICogRGV0ZXJtaW5lcyBpZiBzdXBwbGllZCB7QGxpbmsgQmNwNDcuU3VidGFncyB8IHN1YnRhZ3MgfSBhcmVcbiAgICAgKiB2YWxpZCBhcyBzcGVjaWZpZWQgYnkge0BsaW5rIGh0dHBzOi8vd3d3LnJmYy1lZGl0b3Iub3JnL3JmYy9yZmM1NjQ2Lmh0bWwjc2VjdGlvbi0yLjIuOSB8IFJGQyA1NjQ2fSxcbiAgICAgKiBtZWFuaW5nIHRoYXQgYWxsIHN1YnRhZ3MsIG9yIHRoZSB0YWcgaXRzZWxmIGZvciBncmFuZGZhdGhlcmVkIHRhZ3MsIGFyZSBkZWZpbmVkIGluIHRoZVxuICAgICAqIHtAbGluayBodHRwczovL3d3dy5pYW5hLm9yZy9hc3NpZ25tZW50cy9sYW5ndWFnZS1zdWJ0YWctcmVnaXN0cnkvbGFuZ3VhZ2Utc3VidGFnLXJlZ2lzdHJ5IHwgSUFOQSBsYW5ndWFnZSBzdWJ0YWcgcmVnaXN0cnl9LlxuICAgICAqIEBwYXJhbSBzdWJ0YWdzIC0gVGhlIHtAbGluayBCY3A0Ny5TdWJ0YWdzIHwgc3VidGFncyB9IHRvIHRlc3QuXG4gICAgICogQHJldHVybnMgYHRydWVgIGlmIHRoZSB7QGxpbmsgQmNwNDcuU3VidGFncyB8IHN1YnRhZ3MgfSByZXByZXNlbnRcbiAgICAgKiBhIHZhbGlkIGxhbmd1YWdlIHRhZywgZmFsc2Ugb3RoZXJ3aXNlLlxuICAgICAqIEBleGFtcGxlIGBlbi1VU2AgaXMgdmFsaWQsIGBlbmctVVNgIGlzIG5vdC5cbiAgICAgKi9cbiAgICBwdWJsaWMgc3RhdGljIGlzVmFsaWQoc3VidGFnczogU3VidGFncyk6IGJvb2xlYW4ge1xuICAgICAgICByZXR1cm4gdGhpcy52YWxpZGF0ZVN1YnRhZ3Moc3VidGFncywgJ3ZhbGlkJykuaXNTdWNjZXNzKCk7XG4gICAgfVxuXG4gICAgLyoqXG4gICAgICogRGV0ZXJtaW5lcyBpZiBzdXBwbGllZCB7QGxpbmsgQmNwNDcuU3VidGFncyB8IHN1YnRhZ3MgfSBhcmVcbiAgICAgKiB3ZWxsLWZvcm1lZCBhcyBzcGVjaWZpZWQgYnkge0BsaW5rIGh0dHBzOi8vd3d3LnJmYy1lZGl0b3Iub3JnL3JmYy9yZmM1NjQ2Lmh0bWwjc2VjdGlvbi0yLjIuOSB8IFJGQyA1NjQ2fSxcbiAgICAgKiBtZWFuaW5nIHRoYXQgYWxsIHN1YnRhZ3MgbWVldCB0aGUgZ3JhbW1hciBkZWZpbmVkIGluIHRoZSBzcGVjaWZpY2F0aW9uLlxuICAgICAqIEBwYXJhbSBzdWJ0YWdzIC0gVGhlIHtAbGluayBCY3A0Ny5TdWJ0YWdzIHwgc3VidGFncyB9IHRvIHRlc3QuXG4gICAgICogQHJldHVybnMgYHRydWVgIGlmIHRoZSB7QGxpbmsgQmNwNDcuU3VidGFncyB8IHN1YnRhZ3MgfSByZXByZXNlbnRcbiAgICAgKiBhIHdlbGwtZm9ybWVkIGxhbmd1YWdlIHRhZywgZmFsc2Ugb3RoZXJ3aXNlLlxuICAgICAqIEBleGFtcGxlIGBlbi1VU2AgaXMgdmFsaWQsIGBlbmdsaXNoLVVTYCBpcyBub3QuXG4gICAgICogQHB1YmxpY1xuICAgICAqL1xuICAgIHB1YmxpYyBzdGF0aWMgaXNXZWxsRm9ybWVkKHN1YnRhZ3M6IFN1YnRhZ3MpOiBib29sZWFuIHtcbiAgICAgICAgcmV0dXJuIHRoaXMudmFsaWRhdGVTdWJ0YWdzKHN1YnRhZ3MsICd3ZWxsLWZvcm1lZCcpLmlzU3VjY2VzcygpO1xuICAgIH1cblxuICAgIC8qKlxuICAgICAqIENob29zZXMgYW4gYXBwcm9wcmlhdGUgZGVmYXVsdCB0YWcgdmFsaWRhdG9yIGdpdmVuIGRlc2lyZWQgYW5kIG9wdGlvbmFsIGN1cnJlbnRcbiAgICAgKiB7QGxpbmsgQmNwNDcuVGFnVmFsaWRpdHkgfCB2YWxpZGF0aW9uIGxldmVsfS5cbiAgICAgKiBAcGFyYW0gd2FudFZhbGlkaXR5IC0gVGhlIGRlc2lyZWQge0BsaW5rIEJjcDQ3LlRhZ1ZhbGlkaXR5IHwgdmFsaWRpdHkgbGV2ZWx9LlxuICAgICAqIEBwYXJhbSBoYXZlVmFsaWRpdHkgLSAob3B0aW9uYWwpIFRoZSBjdXJyZW50IHtAbGluayBCY3A0Ny5UYWdWYWxpZGl0eSB8IHZhbGlkaXR5IGxldmVsfS5cbiAgICAgKiBAcmV0dXJucyBBbiBhcHByb3ByaWF0ZSB7QGxpbmsgQmNwNDcuVGFnVmFsaWRhdG9yIHwgdGFnIHZhbGlkYXRvcn0gb3IgYHVuZGVmaW5lZGAgaWYgbm9cbiAgICAgKiBhZGRpdGlvbmFsIHZhbGlkYXRpb24gaXMgbmVjZXNzYXJ5LlxuICAgICAqIEBpbnRlcm5hbFxuICAgICAqL1xuICAgIHB1YmxpYyBzdGF0aWMgY2hvb3NlVmFsaWRhdG9yKHdhbnRWYWxpZGl0eTogVGFnVmFsaWRpdHksIGhhdmVWYWxpZGl0eT86IFRhZ1ZhbGlkaXR5KTogVGFnVmFsaWRhdG9yIHwgdW5kZWZpbmVkIHtcbiAgICAgICAgaWYgKGhhdmVWYWxpZGl0eSAmJiBjb21wYXJlVmFsaWRpdHkoaGF2ZVZhbGlkaXR5LCB3YW50VmFsaWRpdHkpID49IDApIHtcbiAgICAgICAgICAgIHJldHVybiB1bmRlZmluZWQ7XG4gICAgICAgIH1cblxuICAgICAgICBpZiAoIXRoaXMuX3ZhbGlkYXRvcnMpIHtcbiAgICAgICAgICAgIHRoaXMuX3ZhbGlkYXRvcnMgPSB7XG4gICAgICAgICAgICAgICAgLyogZXNsaW50LWRpc2FibGUgQHR5cGVzY3JpcHQtZXNsaW50L25hbWluZy1jb252ZW50aW9uICovXG4gICAgICAgICAgICAgICAgdW5rbm93bjogbmV3IElzV2VsbEZvcm1lZFZhbGlkYXRvcigpLFxuICAgICAgICAgICAgICAgICd3ZWxsLWZvcm1lZCc6IG5ldyBJc1dlbGxGb3JtZWRWYWxpZGF0b3IoKSxcbiAgICAgICAgICAgICAgICB2YWxpZDogbmV3IElzVmFsaWRWYWxpZGF0b3IoKSxcbiAgICAgICAgICAgICAgICAnc3RyaWN0bHktdmFsaWQnOiBuZXcgSXNTdHJpY3RseVZhbGlkVmFsaWRhdG9yKCksXG4gICAgICAgICAgICAgICAgLyogZXNsaW50LWVuYWJsZSBAdHlwZXNjcmlwdC1lc2xpbnQvbmFtaW5nLWNvbnZlbnRpb24gKi9cbiAgICAgICAgICAgIH07XG4gICAgICAgIH1cbiAgICAgICAgcmV0dXJuIHRoaXMuX3ZhbGlkYXRvcnMhW3dhbnRWYWxpZGl0eV07XG4gICAgfVxuXG4gICAgLyoqXG4gICAgICogVmFsaWRhdGVzIHN1cHBsaWVkIHtAbGluayBCY3A0Ny5TdWJ0YWdzIHwgc3VidGFncyB9IHRvIGEgcmVxdWVzdGVkXG4gICAgICoge0BsaW5rIEJjcDQ3LlRhZ1ZhbGlkaXR5IHwgdmFsaWRpdHkgbGV2ZWx9LCBpZiBuZWNlc3NhcnkuXG4gICAgICogQHBhcmFtIHN1YnRhZ3MgLSBUaGUge0BsaW5rIEJjcDQ3LlN1YnRhZ3MgfCBzdWJ0YWdzIH0gdG8gYmUgdmFsaWRhdGVkLlxuICAgICAqIEBwYXJhbSB3YW50VmFsaWRpdHkgLSBUaGUgZGVzaXJlZCB7QGxpbmsgQmNwNDcuVGFnVmFsaWRpdHkgfCB2YWxpZGl0eSBsZXZlbH0uXG4gICAgICogQHBhcmFtIGhhdmVWYWxpZGl0eSAtIChvcHRpb25hbCkgVGhlIGN1cnJlbnQge0BsaW5rIEJjcDQ3LlRhZ1ZhbGlkaXR5IHwgdmFsaWRpdHkgbGV2ZWx9LlxuICAgICAqIEByZXR1cm5zIGBTdWNjZXNzYCB3aXRoIHRoZSB2YWxpZGF0ZWQge0BsaW5rIEJjcDQ3LlN1YnRhZ3MgfCBzdWJ0YWdzIH0sIG9yXG4gICAgICogYEZhaWx1cmVgIHdpdGggZGV0YWlscyBpZiBhbiBlcnJvciBvY2N1cnMuXG4gICAgICogQHB1YmxpY1xuICAgICAqL1xuICAgIHB1YmxpYyBzdGF0aWMgdmFsaWRhdGVTdWJ0YWdzKHN1YnRhZ3M6IFN1YnRhZ3MsIHdhbnRWYWxpZGl0eTogVGFnVmFsaWRpdHksIGhhdmVWYWxpZGl0eT86IFRhZ1ZhbGlkaXR5KTogUmVzdWx0PGJvb2xlYW4+IHtcbiAgICAgICAgY29uc3QgdmFsaWRhdG9yID0gdGhpcy5jaG9vc2VWYWxpZGF0b3Iod2FudFZhbGlkaXR5LCBoYXZlVmFsaWRpdHkpO1xuICAgICAgICAvLyBpc3RhbmJ1bCBpZ25vcmUgbmV4dCAtIGEgcGFpbiB0byB0ZXN0XG4gICAgICAgIHJldHVybiB2YWxpZGF0b3I/LnZhbGlkYXRlU3VidGFncyhzdWJ0YWdzKSA/PyBzdWNjZWVkKHRydWUpO1xuICAgIH1cbn1cbiJdfQ==

package/data/bcp/overrides.json

@@ -0,0 +1,21 @@
+[
+    {
+        "language": "en",
+        "defaultAffinity": "GB",
+        "affinity": {
+            "us": ["GU", "PH", "PR", "UM", "US", "VI"]
+        }
+    },
+    {
+        "language": "es",
+        "defaultAffinity": "419",
+        "affinity": {
+            "es": ["ES", "GQ", "IC"]
+        }
+    },
+    {
+        "language": "fr",
+        "preferredRegion": "FR"
+    }
+]
+