@fgv/ts-bcp47 0.5.0

package/bcp47/normalization/canonicalNormalizer.js

@@ -0,0 +1,110 @@
+"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.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CanonicalNormalizer = void 0;
+const Bcp47Subtags = __importStar(require("../bcp47Subtags"));
+const Iana = __importStar(require("../../iana"));
+const ts_utils_1 = require("@fgv/ts-utils");
+const baseNormalizer_1 = require("./baseNormalizer");
+/**
+ * @internal
+ */
+class CanonicalNormalizer extends baseNormalizer_1.TagNormalizerBase {
+    constructor() {
+        super(...arguments);
+        this.normalization = 'canonical';
+    }
+    _processLanguage(subtags) {
+        if (subtags.primaryLanguage) {
+            return this._iana.subtags.languages.toCanonical(subtags.primaryLanguage);
+        }
+        return (0, ts_utils_1.succeed)(subtags.primaryLanguage);
+    }
+    _processExtlangs(subtags) {
+        if (subtags.extlangs) {
+            return (0, ts_utils_1.mapResults)(subtags.extlangs.map((e) => this._iana.subtags.extlangs.toCanonical(e)));
+        }
+        return (0, ts_utils_1.succeed)(undefined);
+    }
+    _processScript(subtags) {
+        if (subtags.script) {
+            return this._iana.subtags.scripts.toCanonical(subtags.script);
+        }
+        return (0, ts_utils_1.succeed)(undefined);
+    }
+    _processRegion(subtags) {
+        if (subtags.region) {
+            return this._iana.subtags.regions.toCanonical(subtags.region);
+        }
+        return (0, ts_utils_1.succeed)(undefined);
+    }
+    _processVariants(subtags) {
+        if (subtags.variants) {
+            return (0, ts_utils_1.mapResults)(subtags.variants.map((v) => this._iana.subtags.variants.toCanonical(v)));
+        }
+        return (0, ts_utils_1.succeed)(undefined);
+    }
+    _processExtensionSingleton(singleton) {
+        return this._iana.extensions.extensions.toCanonical(singleton);
+    }
+    _processExtensionSubtagValue(value) {
+        return Bcp47Subtags.Validate.extensionSubtag.toCanonical(value);
+    }
+    _processPrivateUseTags(subtags) {
+        if (subtags.privateUse) {
+            return (0, ts_utils_1.mapResults)(subtags.privateUse.map((pu) => Iana.LanguageSubtags.Validate.extendedLanguageRange.toCanonical(pu)));
+        }
+        return (0, ts_utils_1.succeed)(subtags.privateUse);
+    }
+    _processGrandfatheredTags(subtags) {
+        if (subtags.grandfathered) {
+            return this._iana.subtags.grandfathered.toCanonical(subtags.grandfathered);
+        }
+        return (0, ts_utils_1.succeed)(undefined);
+    }
+}
+exports.CanonicalNormalizer = CanonicalNormalizer;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2Fub25pY2FsTm9ybWFsaXplci5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uL3NyYy9iY3A0Ny9ub3JtYWxpemF0aW9uL2Nhbm9uaWNhbE5vcm1hbGl6ZXIudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IjtBQUFBOzs7Ozs7Ozs7Ozs7Ozs7Ozs7OztHQW9CRzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7QUFFSCw4REFBZ0Q7QUFDaEQsaURBQW1DO0FBWW5DLDRDQUE0RDtBQUc1RCxxREFBcUQ7QUFFckQ7O0dBRUc7QUFDSCxNQUFhLG1CQUFvQixTQUFRLGtDQUFpQjtJQUExRDs7UUFDb0Isa0JBQWEsR0FBcUIsV0FBVyxDQUFDO0lBMERsRSxDQUFDO0lBeERhLGdCQUFnQixDQUFDLE9BQWdCO1FBQ3ZDLElBQUksT0FBTyxDQUFDLGVBQWUsRUFBRTtZQUN6QixPQUFPLElBQUksQ0FBQyxLQUFLLENBQUMsT0FBTyxDQUFDLFNBQVMsQ0FBQyxXQUFXLENBQUMsT0FBTyxDQUFDLGVBQWUsQ0FBQyxDQUFDO1NBQzVFO1FBQ0QsT0FBTyxJQUFBLGtCQUFPLEVBQUMsT0FBTyxDQUFDLGVBQWUsQ0FBQyxDQUFDO0lBQzVDLENBQUM7SUFFUyxnQkFBZ0IsQ0FBQyxPQUFnQjtRQUN2QyxJQUFJLE9BQU8sQ0FBQyxRQUFRLEVBQUU7WUFDbEIsT0FBTyxJQUFBLHFCQUFVLEVBQUMsT0FBTyxDQUFDLFFBQVEsQ0FBQyxHQUFHLENBQUMsQ0FBQyxDQUFDLEVBQUUsRUFBRSxDQUFDLElBQUksQ0FBQyxLQUFLLENBQUMsT0FBTyxDQUFDLFFBQVEsQ0FBQyxXQUFXLENBQUMsQ0FBQyxDQUFDLENBQUMsQ0FBQyxDQUFDO1NBQzlGO1FBQ0QsT0FBTyxJQUFBLGtCQUFPLEVBQUMsU0FBUyxDQUFDLENBQUM7SUFDOUIsQ0FBQztJQUVTLGNBQWMsQ0FBQyxPQUFnQjtRQUNyQyxJQUFJLE9BQU8sQ0FBQyxNQUFNLEVBQUU7WUFDaEIsT0FBTyxJQUFJLENBQUMsS0FBSyxDQUFDLE9BQU8sQ0FBQyxPQUFPLENBQUMsV0FBVyxDQUFDLE9BQU8sQ0FBQyxNQUFNLENBQUMsQ0FBQztTQUNqRTtRQUNELE9BQU8sSUFBQSxrQkFBTyxFQUFDLFNBQVMsQ0FBQyxDQUFDO0lBQzlCLENBQUM7SUFFUyxjQUFjLENBQUMsT0FBZ0I7UUFDckMsSUFBSSxPQUFPLENBQUMsTUFBTSxFQUFFO1lBQ2hCLE9BQU8sSUFBSSxDQUFDLEtBQUssQ0FBQyxPQUFPLENBQUMsT0FBTyxDQUFDLFdBQVcsQ0FBQyxPQUFPLENBQUMsTUFBTSxDQUFDLENBQUM7U0FDakU7UUFDRCxPQUFPLElBQUEsa0JBQU8sRUFBQyxTQUFTLENBQUMsQ0FBQztJQUM5QixDQUFDO0lBRVMsZ0JBQWdCLENBQUMsT0FBZ0I7UUFDdkMsSUFBSSxPQUFPLENBQUMsUUFBUSxFQUFFO1lBQ2xCLE9BQU8sSUFBQSxxQkFBVSxFQUFDLE9BQU8sQ0FBQyxRQUFRLENBQUMsR0FBRyxDQUFDLENBQUMsQ0FBQyxFQUFFLEVBQUUsQ0FBQyxJQUFJLENBQUMsS0FBSyxDQUFDLE9BQU8sQ0FBQyxRQUFRLENBQUMsV0FBVyxDQUFDLENBQUMsQ0FBQyxDQUFDLENBQUMsQ0FBQztTQUM5RjtRQUNELE9BQU8sSUFBQSxrQkFBTyxFQUFDLFNBQVMsQ0FBQyxDQUFDO0lBQzlCLENBQUM7SUFFUywwQkFBMEIsQ0FBQyxTQUE2QjtRQUM5RCxPQUFPLElBQUksQ0FBQyxLQUFLLENBQUMsVUFBVSxDQUFDLFVBQVUsQ0FBQyxXQUFXLENBQUMsU0FBUyxDQUFDLENBQUM7SUFDbkUsQ0FBQztJQUVTLDRCQUE0QixDQUFDLEtBQXNCO1FBQ3pELE9BQU8sWUFBWSxDQUFDLFFBQVEsQ0FBQyxlQUFlLENBQUMsV0FBVyxDQUFDLEtBQUssQ0FBQyxDQUFDO0lBQ3BFLENBQUM7SUFFUyxzQkFBc0IsQ0FBQyxPQUFnQjtRQUM3QyxJQUFJLE9BQU8sQ0FBQyxVQUFVLEVBQUU7WUFDcEIsT0FBTyxJQUFBLHFCQUFVLEVBQUMsT0FBTyxDQUFDLFVBQVUsQ0FBQyxHQUFHLENBQUMsQ0FBQyxFQUFFLEVBQUUsRUFBRSxDQUFDLElBQUksQ0FBQyxlQUFlLENBQUMsUUFBUSxDQUFDLHFCQUFxQixDQUFDLFdBQVcsQ0FBQyxFQUFFLENBQUMsQ0FBQyxDQUFDLENBQUM7U0FDMUg7UUFDRCxPQUFPLElBQUEsa0JBQU8sRUFBQyxPQUFPLENBQUMsVUFBVSxDQUFDLENBQUM7SUFDdkMsQ0FBQztJQUVTLHlCQUF5QixDQUFDLE9BQWdCO1FBQ2hELElBQUksT0FBTyxDQUFDLGFBQWEsRUFBRTtZQUN2QixPQUFPLElBQUksQ0FBQyxLQUFLLENBQUMsT0FBTyxDQUFDLGFBQWEsQ0FBQyxXQUFXLENBQUMsT0FBTyxDQUFDLGFBQWEsQ0FBQyxDQUFDO1NBQzlFO1FBQ0QsT0FBTyxJQUFBLGtCQUFPLEVBQUMsU0FBUyxDQUFDLENBQUM7SUFDOUIsQ0FBQztDQUNKO0FBM0RELGtEQTJEQyIsInNvdXJjZXNDb250ZW50IjpbIi8qXG4gKiBDb3B5cmlnaHQgKGMpIDIwMjIgRXJpayBGb3J0dW5lXG4gKlxuICogUGVybWlzc2lvbiBpcyBoZXJlYnkgZ3JhbnRlZCwgZnJlZSBvZiBjaGFyZ2UsIHRvIGFueSBwZXJzb24gb2J0YWluaW5nIGEgY29weVxuICogb2YgdGhpcyBzb2Z0d2FyZSBhbmQgYXNzb2NpYXRlZCBkb2N1bWVudGF0aW9uIGZpbGVzICh0aGUgXCJTb2Z0d2FyZVwiKSwgdG8gZGVhbFxuICogaW4gdGhlIFNvZnR3YXJlIHdpdGhvdXQgcmVzdHJpY3Rpb24sIGluY2x1ZGluZyB3aXRob3V0IGxpbWl0YXRpb24gdGhlIHJpZ2h0c1xuICogdG8gdXNlLCBjb3B5LCBtb2RpZnksIG1lcmdlLCBwdWJsaXNoLCBkaXN0cmlidXRlLCBzdWJsaWNlbnNlLCBhbmQvb3Igc2VsbFxuICogY29waWVzIG9mIHRoZSBTb2Z0d2FyZSwgYW5kIHRvIHBlcm1pdCBwZXJzb25zIHRvIHdob20gdGhlIFNvZnR3YXJlIGlzXG4gKiBmdXJuaXNoZWQgdG8gZG8gc28sIHN1YmplY3QgdG8gdGhlIGZvbGxvd2luZyBjb25kaXRpb25zOlxuICpcbiAqIFRoZSBhYm92ZSBjb3B5cmlnaHQgbm90aWNlIGFuZCB0aGlzIHBlcm1pc3Npb24gbm90aWNlIHNoYWxsIGJlIGluY2x1ZGVkIGluIGFsbFxuICogY29waWVzIG9yIHN1YnN0YW50aWFsIHBvcnRpb25zIG9mIHRoZSBTb2Z0d2FyZS5cbiAqXG4gKiBUSEUgU09GVFdBUkUgSVMgUFJPVklERUQgXCJBUyBJU1wiLCBXSVRIT1VUIFdBUlJBTlRZIE9GIEFOWSBLSU5ELCBFWFBSRVNTIE9SXG4gKiBJTVBMSUVELCBJTkNMVURJTkcgQlVUIE5PVCBMSU1JVEVEIFRPIFRIRSBXQVJSQU5USUVTIE9GIE1FUkNIQU5UQUJJTElUWSxcbiAqIEZJVE5FU1MgRk9SIEEgUEFSVElDVUxBUiBQVVJQT1NFIEFORCBOT05JTkZSSU5HRU1FTlQuIElOIE5PIEVWRU5UIFNIQUxMIFRIRVxuICogQVVUSE9SUyBPUiBDT1BZUklHSFQgSE9MREVSUyBCRSBMSUFCTEUgRk9SIEFOWSBDTEFJTSwgREFNQUdFUyBPUiBPVEhFUlxuICogTElBQklMSVRZLCBXSEVUSEVSIElOIEFOIEFDVElPTiBPRiBDT05UUkFDVCwgVE9SVCBPUiBPVEhFUldJU0UsIEFSSVNJTkcgRlJPTSxcbiAqIE9VVCBPRiBPUiBJTiBDT05ORUNUSU9OIFdJVEggVEhFIFNPRlRXQVJFIE9SIFRIRSBVU0UgT1IgT1RIRVIgREVBTElOR1MgSU4gVEhFXG4gKiBTT0ZUV0FSRS5cbiAqL1xuXG5pbXBvcnQgKiBhcyBCY3A0N1N1YnRhZ3MgZnJvbSAnLi4vYmNwNDdTdWJ0YWdzJztcbmltcG9ydCAqIGFzIElhbmEgZnJvbSAnLi4vLi4vaWFuYSc7XG5cbmltcG9ydCB7XG4gICAgRXh0TGFuZ1N1YnRhZyxcbiAgICBFeHRlbmRlZExhbmd1YWdlUmFuZ2UsXG4gICAgR3JhbmRmYXRoZXJlZFRhZyxcbiAgICBMYW5ndWFnZVN1YnRhZyxcbiAgICBSZWdpb25TdWJ0YWcsXG4gICAgU2NyaXB0U3VidGFnLFxuICAgIFZhcmlhbnRTdWJ0YWcsXG59IGZyb20gJy4uLy4uL2lhbmEvbGFuZ3VhZ2Utc3VidGFncyc7XG5pbXBvcnQgeyBFeHRlbnNpb25TaW5nbGV0b24sIEV4dGVuc2lvblN1YnRhZyB9IGZyb20gJy4uL2JjcDQ3U3VidGFncy9tb2RlbCc7XG5pbXBvcnQgeyBSZXN1bHQsIG1hcFJlc3VsdHMsIHN1Y2NlZWQgfSBmcm9tICdAZmd2L3RzLXV0aWxzJztcbmltcG9ydCB7IFN1YnRhZ3MgfSBmcm9tICcuLi9jb21tb24nO1xuaW1wb3J0IHsgVGFnTm9ybWFsaXphdGlvbiB9IGZyb20gJy4vY29tbW9uJztcbmltcG9ydCB7IFRhZ05vcm1hbGl6ZXJCYXNlIH0gZnJvbSAnLi9iYXNlTm9ybWFsaXplcic7XG5cbi8qKlxuICogQGludGVybmFsXG4gKi9cbmV4cG9ydCBjbGFzcyBDYW5vbmljYWxOb3JtYWxpemVyIGV4dGVuZHMgVGFnTm9ybWFsaXplckJhc2Uge1xuICAgIHB1YmxpYyByZWFkb25seSBub3JtYWxpemF0aW9uOiBUYWdOb3JtYWxpemF0aW9uID0gJ2Nhbm9uaWNhbCc7XG5cbiAgICBwcm90ZWN0ZWQgX3Byb2Nlc3NMYW5ndWFnZShzdWJ0YWdzOiBTdWJ0YWdzKTogUmVzdWx0PExhbmd1YWdlU3VidGFnIHwgdW5kZWZpbmVkPiB7XG4gICAgICAgIGlmIChzdWJ0YWdzLnByaW1hcnlMYW5ndWFnZSkge1xuICAgICAgICAgICAgcmV0dXJuIHRoaXMuX2lhbmEuc3VidGFncy5sYW5ndWFnZXMudG9DYW5vbmljYWwoc3VidGFncy5wcmltYXJ5TGFuZ3VhZ2UpO1xuICAgICAgICB9XG4gICAgICAgIHJldHVybiBzdWNjZWVkKHN1YnRhZ3MucHJpbWFyeUxhbmd1YWdlKTtcbiAgICB9XG5cbiAgICBwcm90ZWN0ZWQgX3Byb2Nlc3NFeHRsYW5ncyhzdWJ0YWdzOiBTdWJ0YWdzKTogUmVzdWx0PEV4dExhbmdTdWJ0YWdbXSB8IHVuZGVmaW5lZD4ge1xuICAgICAgICBpZiAoc3VidGFncy5leHRsYW5ncykge1xuICAgICAgICAgICAgcmV0dXJuIG1hcFJlc3VsdHMoc3VidGFncy5leHRsYW5ncy5tYXAoKGUpID0+IHRoaXMuX2lhbmEuc3VidGFncy5leHRsYW5ncy50b0Nhbm9uaWNhbChlKSkpO1xuICAgICAgICB9XG4gICAgICAgIHJldHVybiBzdWNjZWVkKHVuZGVmaW5lZCk7XG4gICAgfVxuXG4gICAgcHJvdGVjdGVkIF9wcm9jZXNzU2NyaXB0KHN1YnRhZ3M6IFN1YnRhZ3MpOiBSZXN1bHQ8U2NyaXB0U3VidGFnIHwgdW5kZWZpbmVkPiB7XG4gICAgICAgIGlmIChzdWJ0YWdzLnNjcmlwdCkge1xuICAgICAgICAgICAgcmV0dXJuIHRoaXMuX2lhbmEuc3VidGFncy5zY3JpcHRzLnRvQ2Fub25pY2FsKHN1YnRhZ3Muc2NyaXB0KTtcbiAgICAgICAgfVxuICAgICAgICByZXR1cm4gc3VjY2VlZCh1bmRlZmluZWQpO1xuICAgIH1cblxuICAgIHByb3RlY3RlZCBfcHJvY2Vzc1JlZ2lvbihzdWJ0YWdzOiBTdWJ0YWdzKTogUmVzdWx0PFJlZ2lvblN1YnRhZyB8IHVuZGVmaW5lZD4ge1xuICAgICAgICBpZiAoc3VidGFncy5yZWdpb24pIHtcbiAgICAgICAgICAgIHJldHVybiB0aGlzLl9pYW5hLnN1YnRhZ3MucmVnaW9ucy50b0Nhbm9uaWNhbChzdWJ0YWdzLnJlZ2lvbik7XG4gICAgICAgIH1cbiAgICAgICAgcmV0dXJuIHN1Y2NlZWQodW5kZWZpbmVkKTtcbiAgICB9XG5cbiAgICBwcm90ZWN0ZWQgX3Byb2Nlc3NWYXJpYW50cyhzdWJ0YWdzOiBTdWJ0YWdzKTogUmVzdWx0PFZhcmlhbnRTdWJ0YWdbXSB8IHVuZGVmaW5lZD4ge1xuICAgICAgICBpZiAoc3VidGFncy52YXJpYW50cykge1xuICAgICAgICAgICAgcmV0dXJuIG1hcFJlc3VsdHMoc3VidGFncy52YXJpYW50cy5tYXAoKHYpID0+IHRoaXMuX2lhbmEuc3VidGFncy52YXJpYW50cy50b0Nhbm9uaWNhbCh2KSkpO1xuICAgICAgICB9XG4gICAgICAgIHJldHVybiBzdWNjZWVkKHVuZGVmaW5lZCk7XG4gICAgfVxuXG4gICAgcHJvdGVjdGVkIF9wcm9jZXNzRXh0ZW5zaW9uU2luZ2xldG9uKHNpbmdsZXRvbjogRXh0ZW5zaW9uU2luZ2xldG9uKTogUmVzdWx0PEV4dGVuc2lvblNpbmdsZXRvbj4ge1xuICAgICAgICByZXR1cm4gdGhpcy5faWFuYS5leHRlbnNpb25zLmV4dGVuc2lvbnMudG9DYW5vbmljYWwoc2luZ2xldG9uKTtcbiAgICB9XG5cbiAgICBwcm90ZWN0ZWQgX3Byb2Nlc3NFeHRlbnNpb25TdWJ0YWdWYWx1ZSh2YWx1ZTogRXh0ZW5zaW9uU3VidGFnKTogUmVzdWx0PEV4dGVuc2lvblN1YnRhZz4ge1xuICAgICAgICByZXR1cm4gQmNwNDdTdWJ0YWdzLlZhbGlkYXRlLmV4dGVuc2lvblN1YnRhZy50b0Nhbm9uaWNhbCh2YWx1ZSk7XG4gICAgfVxuXG4gICAgcHJvdGVjdGVkIF9wcm9jZXNzUHJpdmF0ZVVzZVRhZ3Moc3VidGFnczogU3VidGFncyk6IFJlc3VsdDxFeHRlbmRlZExhbmd1YWdlUmFuZ2VbXSB8IHVuZGVmaW5lZD4ge1xuICAgICAgICBpZiAoc3VidGFncy5wcml2YXRlVXNlKSB7XG4gICAgICAgICAgICByZXR1cm4gbWFwUmVzdWx0cyhzdWJ0YWdzLnByaXZhdGVVc2UubWFwKChwdSkgPT4gSWFuYS5MYW5ndWFnZVN1YnRhZ3MuVmFsaWRhdGUuZXh0ZW5kZWRMYW5ndWFnZVJhbmdlLnRvQ2Fub25pY2FsKHB1KSkpO1xuICAgICAgICB9XG4gICAgICAgIHJldHVybiBzdWNjZWVkKHN1YnRhZ3MucHJpdmF0ZVVzZSk7XG4gICAgfVxuXG4gICAgcHJvdGVjdGVkIF9wcm9jZXNzR3JhbmRmYXRoZXJlZFRhZ3Moc3VidGFnczogU3VidGFncyk6IFJlc3VsdDxHcmFuZGZhdGhlcmVkVGFnIHwgdW5kZWZpbmVkPiB7XG4gICAgICAgIGlmIChzdWJ0YWdzLmdyYW5kZmF0aGVyZWQpIHtcbiAgICAgICAgICAgIHJldHVybiB0aGlzLl9pYW5hLnN1YnRhZ3MuZ3JhbmRmYXRoZXJlZC50b0Nhbm9uaWNhbChzdWJ0YWdzLmdyYW5kZmF0aGVyZWQpO1xuICAgICAgICB9XG4gICAgICAgIHJldHVybiBzdWNjZWVkKHVuZGVmaW5lZCk7XG4gICAgfVxufVxuIl19

package/bcp47/normalization/common.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Describes the degree of normalization of a language tag.
+ * @public
+ */
+export type TagNormalization = 'unknown' | 'none' | 'canonical' | 'preferred';
+/**
+ * Determines which of two normalization ranks is most normalized.
+ * @param n1 - The first {@link TagNormalization} to be compared.
+ * @param n2 - The second {@link TagNormalization} to me compared.
+ * @returns `1' if `n1` is more normalized, `-1` if `n2` is more
+ * normalized, or `0` if they are identical.
+ * @public
+ */
+export declare function compareNormalization(n1: TagNormalization, n2: TagNormalization): -1 | 0 | 1;
+/**
+ * Chooses the most normalized of two normalization ranks.
+ * @param n1 - The first {@link TagNormalization} to be compared.
+ * @param n2 - The second {@link TagNormalization} to me compared.
+ * @returns The most normalized of `n1` or `n2`.
+ * @public
+ */
+export declare function mostNormalized(n1: TagNormalization, n2: TagNormalization): TagNormalization;
+//# sourceMappingURL=common.d.ts.map

package/bcp47/normalization/common.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../../src/bcp47/normalization/common.ts"],"names":[],"mappings":"AAsBA;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,MAAM,GAAG,WAAW,GAAG,WAAW,CAAC;AA8B9E;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,gBAAgB,EAAE,EAAE,EAAE,gBAAgB,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAO3F;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,gBAAgB,EAAE,EAAE,EAAE,gBAAgB,GAAG,gBAAgB,CAG3F"}

package/bcp47/normalization/common.js

@@ -0,0 +1,82 @@
+"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.mostNormalized = exports.compareNormalization = void 0;
+/**
+ * Ordered ranking of the degrees of normalization, from `unknown` (least
+ * normalized) to `preferred` (most normalized).
+ * @public
+ */
+const normalizationRank = {
+    /**
+     * Normalization level is unknown.
+     */
+    unknown: 0,
+    /**
+     * Not normalized.
+     */
+    none: 0.1,
+    /**
+     * Tag and subtag case has been normalized to canonical
+     * letter case (e.g. lower-case language and upper-case
+     * region) but no other normalization has been applied.
+     */
+    canonical: 0.9,
+    /**
+     * All tag recommendations have been applied - e.g. suppressed
+     * script is removed, deprecated or grandfathered values are
+     * replaced with preferred values.
+     */
+    preferred: 1.0,
+};
+/**
+ * Determines which of two normalization ranks is most normalized.
+ * @param n1 - The first {@link TagNormalization} to be compared.
+ * @param n2 - The second {@link TagNormalization} to me compared.
+ * @returns `1' if `n1` is more normalized, `-1` if `n2` is more
+ * normalized, or `0` if they are identical.
+ * @public
+ */
+function compareNormalization(n1, n2) {
+    if (normalizationRank[n1] > normalizationRank[n2]) {
+        return 1;
+    }
+    else if (normalizationRank[n1] < normalizationRank[n2]) {
+        return -1;
+    }
+    return 0;
+}
+exports.compareNormalization = compareNormalization;
+/**
+ * Chooses the most normalized of two normalization ranks.
+ * @param n1 - The first {@link TagNormalization} to be compared.
+ * @param n2 - The second {@link TagNormalization} to me compared.
+ * @returns The most normalized of `n1` or `n2`.
+ * @public
+ */
+function mostNormalized(n1, n2) {
+    // istanbul ignore next - hard to hit due to guards
+    return normalizationRank[n1] > normalizationRank[n2] ? n1 : n2;
+}
+exports.mostNormalized = mostNormalized;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY29tbW9uLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vc3JjL2JjcDQ3L25vcm1hbGl6YXRpb24vY29tbW9uLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7QUFBQTs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7R0FvQkc7OztBQVFIOzs7O0dBSUc7QUFDSCxNQUFNLGlCQUFpQixHQUFxQztJQUN4RDs7T0FFRztJQUNILE9BQU8sRUFBRSxDQUFDO0lBQ1Y7O09BRUc7SUFDSCxJQUFJLEVBQUUsR0FBRztJQUNUOzs7O09BSUc7SUFDSCxTQUFTLEVBQUUsR0FBRztJQUNkOzs7O09BSUc7SUFDSCxTQUFTLEVBQUUsR0FBRztDQUNqQixDQUFDO0FBRUY7Ozs7Ozs7R0FPRztBQUNILFNBQWdCLG9CQUFvQixDQUFDLEVBQW9CLEVBQUUsRUFBb0I7SUFDM0UsSUFBSSxpQkFBaUIsQ0FBQyxFQUFFLENBQUMsR0FBRyxpQkFBaUIsQ0FBQyxFQUFFLENBQUMsRUFBRTtRQUMvQyxPQUFPLENBQUMsQ0FBQztLQUNaO1NBQU0sSUFBSSxpQkFBaUIsQ0FBQyxFQUFFLENBQUMsR0FBRyxpQkFBaUIsQ0FBQyxFQUFFLENBQUMsRUFBRTtRQUN0RCxPQUFPLENBQUMsQ0FBQyxDQUFDO0tBQ2I7SUFDRCxPQUFPLENBQUMsQ0FBQztBQUNiLENBQUM7QUFQRCxvREFPQztBQUVEOzs7Ozs7R0FNRztBQUNILFNBQWdCLGNBQWMsQ0FBQyxFQUFvQixFQUFFLEVBQW9CO0lBQ3JFLG1EQUFtRDtJQUNuRCxPQUFPLGlCQUFpQixDQUFDLEVBQUUsQ0FBQyxHQUFHLGlCQUFpQixDQUFDLEVBQUUsQ0FBQyxDQUFDLENBQUMsQ0FBQyxFQUFFLENBQUMsQ0FBQyxDQUFDLEVBQUUsQ0FBQztBQUNuRSxDQUFDO0FBSEQsd0NBR0MiLCJzb3VyY2VzQ29udGVudCI6WyIvKlxuICogQ29weXJpZ2h0IChjKSAyMDIyIEVyaWsgRm9ydHVuZVxuICpcbiAqIFBlcm1pc3Npb24gaXMgaGVyZWJ5IGdyYW50ZWQsIGZyZWUgb2YgY2hhcmdlLCB0byBhbnkgcGVyc29uIG9idGFpbmluZyBhIGNvcHlcbiAqIG9mIHRoaXMgc29mdHdhcmUgYW5kIGFzc29jaWF0ZWQgZG9jdW1lbnRhdGlvbiBmaWxlcyAodGhlIFwiU29mdHdhcmVcIiksIHRvIGRlYWxcbiAqIGluIHRoZSBTb2Z0d2FyZSB3aXRob3V0IHJlc3RyaWN0aW9uLCBpbmNsdWRpbmcgd2l0aG91dCBsaW1pdGF0aW9uIHRoZSByaWdodHNcbiAqIHRvIHVzZSwgY29weSwgbW9kaWZ5LCBtZXJnZSwgcHVibGlzaCwgZGlzdHJpYnV0ZSwgc3VibGljZW5zZSwgYW5kL29yIHNlbGxcbiAqIGNvcGllcyBvZiB0aGUgU29mdHdhcmUsIGFuZCB0byBwZXJtaXQgcGVyc29ucyB0byB3aG9tIHRoZSBTb2Z0d2FyZSBpc1xuICogZnVybmlzaGVkIHRvIGRvIHNvLCBzdWJqZWN0IHRvIHRoZSBmb2xsb3dpbmcgY29uZGl0aW9uczpcbiAqXG4gKiBUaGUgYWJvdmUgY29weXJpZ2h0IG5vdGljZSBhbmQgdGhpcyBwZXJtaXNzaW9uIG5vdGljZSBzaGFsbCBiZSBpbmNsdWRlZCBpbiBhbGxcbiAqIGNvcGllcyBvciBzdWJzdGFudGlhbCBwb3J0aW9ucyBvZiB0aGUgU29mdHdhcmUuXG4gKlxuICogVEhFIFNPRlRXQVJFIElTIFBST1ZJREVEIFwiQVMgSVNcIiwgV0lUSE9VVCBXQVJSQU5UWSBPRiBBTlkgS0lORCwgRVhQUkVTUyBPUlxuICogSU1QTElFRCwgSU5DTFVESU5HIEJVVCBOT1QgTElNSVRFRCBUTyBUSEUgV0FSUkFOVElFUyBPRiBNRVJDSEFOVEFCSUxJVFksXG4gKiBGSVRORVNTIEZPUiBBIFBBUlRJQ1VMQVIgUFVSUE9TRSBBTkQgTk9OSU5GUklOR0VNRU5ULiBJTiBOTyBFVkVOVCBTSEFMTCBUSEVcbiAqIEFVVEhPUlMgT1IgQ09QWVJJR0hUIEhPTERFUlMgQkUgTElBQkxFIEZPUiBBTlkgQ0xBSU0sIERBTUFHRVMgT1IgT1RIRVJcbiAqIExJQUJJTElUWSwgV0hFVEhFUiBJTiBBTiBBQ1RJT04gT0YgQ09OVFJBQ1QsIFRPUlQgT1IgT1RIRVJXSVNFLCBBUklTSU5HIEZST00sXG4gKiBPVVQgT0YgT1IgSU4gQ09OTkVDVElPTiBXSVRIIFRIRSBTT0ZUV0FSRSBPUiBUSEUgVVNFIE9SIE9USEVSIERFQUxJTkdTIElOIFRIRVxuICogU09GVFdBUkUuXG4gKi9cblxuLyoqXG4gKiBEZXNjcmliZXMgdGhlIGRlZ3JlZSBvZiBub3JtYWxpemF0aW9uIG9mIGEgbGFuZ3VhZ2UgdGFnLlxuICogQHB1YmxpY1xuICovXG5leHBvcnQgdHlwZSBUYWdOb3JtYWxpemF0aW9uID0gJ3Vua25vd24nIHwgJ25vbmUnIHwgJ2Nhbm9uaWNhbCcgfCAncHJlZmVycmVkJztcblxuLyoqXG4gKiBPcmRlcmVkIHJhbmtpbmcgb2YgdGhlIGRlZ3JlZXMgb2Ygbm9ybWFsaXphdGlvbiwgZnJvbSBgdW5rbm93bmAgKGxlYXN0XG4gKiBub3JtYWxpemVkKSB0byBgcHJlZmVycmVkYCAobW9zdCBub3JtYWxpemVkKS5cbiAqIEBwdWJsaWNcbiAqL1xuY29uc3Qgbm9ybWFsaXphdGlvblJhbms6IFJlY29yZDxUYWdOb3JtYWxpemF0aW9uLCBudW1iZXI+ID0ge1xuICAgIC8qKlxuICAgICAqIE5vcm1hbGl6YXRpb24gbGV2ZWwgaXMgdW5rbm93bi5cbiAgICAgKi9cbiAgICB1bmtub3duOiAwLFxuICAgIC8qKlxuICAgICAqIE5vdCBub3JtYWxpemVkLlxuICAgICAqL1xuICAgIG5vbmU6IDAuMSxcbiAgICAvKipcbiAgICAgKiBUYWcgYW5kIHN1YnRhZyBjYXNlIGhhcyBiZWVuIG5vcm1hbGl6ZWQgdG8gY2Fub25pY2FsXG4gICAgICogbGV0dGVyIGNhc2UgKGUuZy4gbG93ZXItY2FzZSBsYW5ndWFnZSBhbmQgdXBwZXItY2FzZVxuICAgICAqIHJlZ2lvbikgYnV0IG5vIG90aGVyIG5vcm1hbGl6YXRpb24gaGFzIGJlZW4gYXBwbGllZC5cbiAgICAgKi9cbiAgICBjYW5vbmljYWw6IDAuOSxcbiAgICAvKipcbiAgICAgKiBBbGwgdGFnIHJlY29tbWVuZGF0aW9ucyBoYXZlIGJlZW4gYXBwbGllZCAtIGUuZy4gc3VwcHJlc3NlZFxuICAgICAqIHNjcmlwdCBpcyByZW1vdmVkLCBkZXByZWNhdGVkIG9yIGdyYW5kZmF0aGVyZWQgdmFsdWVzIGFyZVxuICAgICAqIHJlcGxhY2VkIHdpdGggcHJlZmVycmVkIHZhbHVlcy5cbiAgICAgKi9cbiAgICBwcmVmZXJyZWQ6IDEuMCxcbn07XG5cbi8qKlxuICogRGV0ZXJtaW5lcyB3aGljaCBvZiB0d28gbm9ybWFsaXphdGlvbiByYW5rcyBpcyBtb3N0IG5vcm1hbGl6ZWQuXG4gKiBAcGFyYW0gbjEgLSBUaGUgZmlyc3Qge0BsaW5rIFRhZ05vcm1hbGl6YXRpb259IHRvIGJlIGNvbXBhcmVkLlxuICogQHBhcmFtIG4yIC0gVGhlIHNlY29uZCB7QGxpbmsgVGFnTm9ybWFsaXphdGlvbn0gdG8gbWUgY29tcGFyZWQuXG4gKiBAcmV0dXJucyBgMScgaWYgYG4xYCBpcyBtb3JlIG5vcm1hbGl6ZWQsIGAtMWAgaWYgYG4yYCBpcyBtb3JlXG4gKiBub3JtYWxpemVkLCBvciBgMGAgaWYgdGhleSBhcmUgaWRlbnRpY2FsLlxuICogQHB1YmxpY1xuICovXG5leHBvcnQgZnVuY3Rpb24gY29tcGFyZU5vcm1hbGl6YXRpb24objE6IFRhZ05vcm1hbGl6YXRpb24sIG4yOiBUYWdOb3JtYWxpemF0aW9uKTogLTEgfCAwIHwgMSB7XG4gICAgaWYgKG5vcm1hbGl6YXRpb25SYW5rW24xXSA+IG5vcm1hbGl6YXRpb25SYW5rW24yXSkge1xuICAgICAgICByZXR1cm4gMTtcbiAgICB9IGVsc2UgaWYgKG5vcm1hbGl6YXRpb25SYW5rW24xXSA8IG5vcm1hbGl6YXRpb25SYW5rW24yXSkge1xuICAgICAgICByZXR1cm4gLTE7XG4gICAgfVxuICAgIHJldHVybiAwO1xufVxuXG4vKipcbiAqIENob29zZXMgdGhlIG1vc3Qgbm9ybWFsaXplZCBvZiB0d28gbm9ybWFsaXphdGlvbiByYW5rcy5cbiAqIEBwYXJhbSBuMSAtIFRoZSBmaXJzdCB7QGxpbmsgVGFnTm9ybWFsaXphdGlvbn0gdG8gYmUgY29tcGFyZWQuXG4gKiBAcGFyYW0gbjIgLSBUaGUgc2Vjb25kIHtAbGluayBUYWdOb3JtYWxpemF0aW9ufSB0byBtZSBjb21wYXJlZC5cbiAqIEByZXR1cm5zIFRoZSBtb3N0IG5vcm1hbGl6ZWQgb2YgYG4xYCBvciBgbjJgLlxuICogQHB1YmxpY1xuICovXG5leHBvcnQgZnVuY3Rpb24gbW9zdE5vcm1hbGl6ZWQobjE6IFRhZ05vcm1hbGl6YXRpb24sIG4yOiBUYWdOb3JtYWxpemF0aW9uKTogVGFnTm9ybWFsaXphdGlvbiB7XG4gICAgLy8gaXN0YW5idWwgaWdub3JlIG5leHQgLSBoYXJkIHRvIGhpdCBkdWUgdG8gZ3VhcmRzXG4gICAgcmV0dXJuIG5vcm1hbGl6YXRpb25SYW5rW24xXSA+IG5vcm1hbGl6YXRpb25SYW5rW24yXSA/IG4xIDogbjI7XG59XG4iXX0=

package/bcp47/normalization/index.d.ts

@@ -0,0 +1,5 @@
+export * from './common';
+export { NormalizeTag } from './normalizeTag';
+export { CanonicalNormalizer } from './canonicalNormalizer';
+export { PreferredNormalizer } from './preferredTagNormalizer';
+//# sourceMappingURL=index.d.ts.map

package/bcp47/normalization/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/bcp47/normalization/index.ts"],"names":[],"mappings":"AAuBA,cAAc,UAAU,CAAC;AACzB,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC"}

package/bcp47/normalization/index.js

@@ -0,0 +1,47 @@
+"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.
+ */
+// istanbul ignore file
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PreferredNormalizer = exports.CanonicalNormalizer = exports.NormalizeTag = void 0;
+__exportStar(require("./common"), exports);
+var normalizeTag_1 = require("./normalizeTag");
+Object.defineProperty(exports, "NormalizeTag", { enumerable: true, get: function () { return normalizeTag_1.NormalizeTag; } });
+var canonicalNormalizer_1 = require("./canonicalNormalizer");
+Object.defineProperty(exports, "CanonicalNormalizer", { enumerable: true, get: function () { return canonicalNormalizer_1.CanonicalNormalizer; } });
+var preferredTagNormalizer_1 = require("./preferredTagNormalizer");
+Object.defineProperty(exports, "PreferredNormalizer", { enumerable: true, get: function () { return preferredTagNormalizer_1.PreferredNormalizer; } });
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi9zcmMvYmNwNDcvbm9ybWFsaXphdGlvbi9pbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiO0FBQUE7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7O0dBb0JHO0FBQ0gsdUJBQXVCOzs7Ozs7Ozs7Ozs7Ozs7OztBQUV2QiwyQ0FBeUI7QUFDekIsK0NBQThDO0FBQXJDLDRHQUFBLFlBQVksT0FBQTtBQUNyQiw2REFBNEQ7QUFBbkQsMEhBQUEsbUJBQW1CLE9BQUE7QUFDNUIsbUVBQStEO0FBQXRELDZIQUFBLG1CQUFtQixPQUFBIiwic291cmNlc0NvbnRlbnQiOlsiLypcbiAqIENvcHlyaWdodCAoYykgMjAyMiBFcmlrIEZvcnR1bmVcbiAqXG4gKiBQZXJtaXNzaW9uIGlzIGhlcmVieSBncmFudGVkLCBmcmVlIG9mIGNoYXJnZSwgdG8gYW55IHBlcnNvbiBvYnRhaW5pbmcgYSBjb3B5XG4gKiBvZiB0aGlzIHNvZnR3YXJlIGFuZCBhc3NvY2lhdGVkIGRvY3VtZW50YXRpb24gZmlsZXMgKHRoZSBcIlNvZnR3YXJlXCIpLCB0byBkZWFsXG4gKiBpbiB0aGUgU29mdHdhcmUgd2l0aG91dCByZXN0cmljdGlvbiwgaW5jbHVkaW5nIHdpdGhvdXQgbGltaXRhdGlvbiB0aGUgcmlnaHRzXG4gKiB0byB1c2UsIGNvcHksIG1vZGlmeSwgbWVyZ2UsIHB1Ymxpc2gsIGRpc3RyaWJ1dGUsIHN1YmxpY2Vuc2UsIGFuZC9vciBzZWxsXG4gKiBjb3BpZXMgb2YgdGhlIFNvZnR3YXJlLCBhbmQgdG8gcGVybWl0IHBlcnNvbnMgdG8gd2hvbSB0aGUgU29mdHdhcmUgaXNcbiAqIGZ1cm5pc2hlZCB0byBkbyBzbywgc3ViamVjdCB0byB0aGUgZm9sbG93aW5nIGNvbmRpdGlvbnM6XG4gKlxuICogVGhlIGFib3ZlIGNvcHlyaWdodCBub3RpY2UgYW5kIHRoaXMgcGVybWlzc2lvbiBub3RpY2Ugc2hhbGwgYmUgaW5jbHVkZWQgaW4gYWxsXG4gKiBjb3BpZXMgb3Igc3Vic3RhbnRpYWwgcG9ydGlvbnMgb2YgdGhlIFNvZnR3YXJlLlxuICpcbiAqIFRIRSBTT0ZUV0FSRSBJUyBQUk9WSURFRCBcIkFTIElTXCIsIFdJVEhPVVQgV0FSUkFOVFkgT0YgQU5ZIEtJTkQsIEVYUFJFU1MgT1JcbiAqIElNUExJRUQsIElOQ0xVRElORyBCVVQgTk9UIExJTUlURUQgVE8gVEhFIFdBUlJBTlRJRVMgT0YgTUVSQ0hBTlRBQklMSVRZLFxuICogRklUTkVTUyBGT1IgQSBQQVJUSUNVTEFSIFBVUlBPU0UgQU5EIE5PTklORlJJTkdFTUVOVC4gSU4gTk8gRVZFTlQgU0hBTEwgVEhFXG4gKiBBVVRIT1JTIE9SIENPUFlSSUdIVCBIT0xERVJTIEJFIExJQUJMRSBGT1IgQU5ZIENMQUlNLCBEQU1BR0VTIE9SIE9USEVSXG4gKiBMSUFCSUxJVFksIFdIRVRIRVIgSU4gQU4gQUNUSU9OIE9GIENPTlRSQUNULCBUT1JUIE9SIE9USEVSV0lTRSwgQVJJU0lORyBGUk9NLFxuICogT1VUIE9GIE9SIElOIENPTk5FQ1RJT04gV0lUSCBUSEUgU09GVFdBUkUgT1IgVEhFIFVTRSBPUiBPVEhFUiBERUFMSU5HUyBJTiBUSEVcbiAqIFNPRlRXQVJFLlxuICovXG4vLyBpc3RhbmJ1bCBpZ25vcmUgZmlsZVxuXG5leHBvcnQgKiBmcm9tICcuL2NvbW1vbic7XG5leHBvcnQgeyBOb3JtYWxpemVUYWcgfSBmcm9tICcuL25vcm1hbGl6ZVRhZyc7XG5leHBvcnQgeyBDYW5vbmljYWxOb3JtYWxpemVyIH0gZnJvbSAnLi9jYW5vbmljYWxOb3JtYWxpemVyJztcbmV4cG9ydCB7IFByZWZlcnJlZE5vcm1hbGl6ZXIgfSBmcm9tICcuL3ByZWZlcnJlZFRhZ05vcm1hbGl6ZXInO1xuIl19

package/bcp47/normalization/normalizeTag.d.ts

@@ -0,0 +1,59 @@
+import { Result } from '@fgv/ts-utils';
+import { TagNormalization } from './common';
+import { Subtags } from '../common';
+import { TagNormalizer } from './baseNormalizer';
+/**
+ * Normalization helpers for BCP-47 language tags.
+ * @public
+ */
+export declare class NormalizeTag {
+    /**
+     * @internal
+     */
+    private static _normalizers;
+    /**
+     * Converts a BCP-47 language tag to canonical form.  Canonical form uses the recommended capitalization rules
+     * specified in {@link https://www.rfc-editor.org/rfc/rfc5646.html#section-2.1.1 | RFC 5646} but are not
+     * otherwise modified.
+     *
+     * @param subtags - The individual {@link Bcp47.Subtags | subtags} to be normalized.
+     * @returns `Success` with the normalized equivalent {@link Bcp47.Subtags | subtags},
+     * or `Failure` with details if an error occurs.
+     */
+    static toCanonical(subtags: Subtags): Result<Subtags>;
+    /**
+     * Converts a BCP-47 language tag to preferred form.  Preferred form uses the recommended capitalization rules
+     * specified in {@link https://www.rfc-editor.org/rfc/rfc5646.html#section-2.1.1 | RFC 5646} and also
+     * applies additional preferred values specified in the
+     * {@link https://www.iana.org/assignments/language-subtag-registry/language-subtag-registry | language subtag registry}:
+     * extraneous (suppressed) script tags are removed, deprecated language, extlang, script or region tags are replaced
+     * with up-to-date preferred values, and grandfathered or redundant tags with a defined preferred-value are replaced
+     * in their entirety with the new preferred value.
+     * @param subtags - The individual {@link Bcp47.Subtags | subtags} to be normalized.
+     * @returns `Success` with the normalized equivalent {@link Bcp47.Subtags | subtags},
+     * or `Failure` with details if an error occurs.
+     */
+    static toPreferred(subtags: Subtags): Result<Subtags>;
+    /**
+     * Chooses an appropriate default tag normalizer given desired and optional current
+     * {@link Bcp47.TagNormalization | normalization level}.
+     * @param wantNormalization - The desired {@link Bcp47.TagNormalization | normalization level}.
+     * @param haveNormalization - (optional) The current {@link Bcp47.TagNormalization | normalization level}.
+     * @returns An appropriate {@link Bcp47.TagNormalizer | tag normalizer} or `undefined` if no additional
+     * normalization is necessary.
+     * @internal
+     */
+    static chooseNormalizer(wantNormalization: TagNormalization, haveNormalization?: TagNormalization): TagNormalizer | undefined;
+    /**
+     * Normalizes supplied {@link Bcp47.Subtags | subtags} to a requested
+     * {@link Bcp47.TagNormalization | normalization level}, if necessary.  If
+     * no normalization is necessary, returns the supplied subtags.
+     * @param subtags - The {@link Bcp47.Subtags | subtags} to be normalized.
+     * @param wantNormalization - The desired {@link Bcp47.TagNormalization | normalization level}.
+     * @param haveNormalization - (optional) The current {@link Bcp47.TagNormalization | normalization level}.
+     * @returns `Success` with the normalized {@link Bcp47.Subtags | subtags}, or
+     * `Failure` with details if an error occurs.
+     */
+    static normalizeSubtags(subtags: Subtags, wantNormalization: TagNormalization, haveNormalization?: TagNormalization): Result<Subtags>;
+}
+//# sourceMappingURL=normalizeTag.d.ts.map

package/bcp47/normalization/normalizeTag.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalizeTag.d.ts","sourceRoot":"","sources":["../../../src/bcp47/normalization/normalizeTag.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAE,MAAM,EAAW,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAwB,MAAM,UAAU,CAAC;AAIlE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD;;;GAGG;AACH,qBAAa,YAAY;IACrB;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,YAAY,CAA8E;IAEzG;;;;;;;;OAQG;WACW,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;IAI5D;;;;;;;;;;;OAWG;WACW,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;IAI5D;;;;;;;;OAQG;WACW,gBAAgB,CAAC,iBAAiB,EAAE,gBAAgB,EAAE,iBAAiB,CAAC,EAAE,gBAAgB,GAAG,aAAa,GAAG,SAAS;IAgBpI;;;;;;;;;OASG;WACW,gBAAgB,CAC1B,OAAO,EAAE,OAAO,EAChB,iBAAiB,EAAE,gBAAgB,EACnC,iBAAiB,CAAC,EAAE,gBAAgB,GACrC,MAAM,CAAC,OAAO,CAAC;CAIrB"}

package/bcp47/normalization/normalizeTag.js

@@ -0,0 +1,105 @@
+"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.NormalizeTag = void 0;
+const ts_utils_1 = require("@fgv/ts-utils");
+const common_1 = require("./common");
+const canonicalNormalizer_1 = require("./canonicalNormalizer");
+const preferredTagNormalizer_1 = require("./preferredTagNormalizer");
+/**
+ * Normalization helpers for BCP-47 language tags.
+ * @public
+ */
+class NormalizeTag {
+    /**
+     * Converts a BCP-47 language tag to canonical form.  Canonical form uses the recommended capitalization rules
+     * specified in {@link https://www.rfc-editor.org/rfc/rfc5646.html#section-2.1.1 | RFC 5646} but are not
+     * otherwise modified.
+     *
+     * @param subtags - The individual {@link Bcp47.Subtags | subtags} to be normalized.
+     * @returns `Success` with the normalized equivalent {@link Bcp47.Subtags | subtags},
+     * or `Failure` with details if an error occurs.
+     */
+    static toCanonical(subtags) {
+        return this.normalizeSubtags(subtags, 'canonical');
+    }
+    /**
+     * Converts a BCP-47 language tag to preferred form.  Preferred form uses the recommended capitalization rules
+     * specified in {@link https://www.rfc-editor.org/rfc/rfc5646.html#section-2.1.1 | RFC 5646} and also
+     * applies additional preferred values specified in the
+     * {@link https://www.iana.org/assignments/language-subtag-registry/language-subtag-registry | language subtag registry}:
+     * extraneous (suppressed) script tags are removed, deprecated language, extlang, script or region tags are replaced
+     * with up-to-date preferred values, and grandfathered or redundant tags with a defined preferred-value are replaced
+     * in their entirety with the new preferred value.
+     * @param subtags - The individual {@link Bcp47.Subtags | subtags} to be normalized.
+     * @returns `Success` with the normalized equivalent {@link Bcp47.Subtags | subtags},
+     * or `Failure` with details if an error occurs.
+     */
+    static toPreferred(subtags) {
+        return this.normalizeSubtags(subtags, 'preferred');
+    }
+    /**
+     * Chooses an appropriate default tag normalizer given desired and optional current
+     * {@link Bcp47.TagNormalization | normalization level}.
+     * @param wantNormalization - The desired {@link Bcp47.TagNormalization | normalization level}.
+     * @param haveNormalization - (optional) The current {@link Bcp47.TagNormalization | normalization level}.
+     * @returns An appropriate {@link Bcp47.TagNormalizer | tag normalizer} or `undefined` if no additional
+     * normalization is necessary.
+     * @internal
+     */
+    static chooseNormalizer(wantNormalization, haveNormalization) {
+        if (haveNormalization && (0, common_1.compareNormalization)(haveNormalization, wantNormalization) >= 0) {
+            return undefined;
+        }
+        if (!this._normalizers) {
+            this._normalizers = {
+                unknown: undefined,
+                none: undefined,
+                canonical: new canonicalNormalizer_1.CanonicalNormalizer(),
+                preferred: new preferredTagNormalizer_1.PreferredNormalizer(),
+            };
+        }
+        return this._normalizers[wantNormalization];
+    }
+    /**
+     * Normalizes supplied {@link Bcp47.Subtags | subtags} to a requested
+     * {@link Bcp47.TagNormalization | normalization level}, if necessary.  If
+     * no normalization is necessary, returns the supplied subtags.
+     * @param subtags - The {@link Bcp47.Subtags | subtags} to be normalized.
+     * @param wantNormalization - The desired {@link Bcp47.TagNormalization | normalization level}.
+     * @param haveNormalization - (optional) The current {@link Bcp47.TagNormalization | normalization level}.
+     * @returns `Success` with the normalized {@link Bcp47.Subtags | subtags}, or
+     * `Failure` with details if an error occurs.
+     */
+    static normalizeSubtags(subtags, wantNormalization, haveNormalization) {
+        var _a;
+        const normalizer = this.chooseNormalizer(wantNormalization, haveNormalization);
+        return (_a = normalizer === null || normalizer === void 0 ? void 0 : normalizer.processSubtags(subtags)) !== null && _a !== void 0 ? _a : (0, ts_utils_1.succeed)(subtags);
+    }
+}
+exports.NormalizeTag = NormalizeTag;
+/**
+ * @internal
+ */
+NormalizeTag._normalizers = undefined;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibm9ybWFsaXplVGFnLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vc3JjL2JjcDQ3L25vcm1hbGl6YXRpb24vbm9ybWFsaXplVGFnLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7QUFBQTs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7R0FvQkc7OztBQUVILDRDQUFnRDtBQUNoRCxxQ0FBa0U7QUFFbEUsK0RBQTREO0FBQzVELHFFQUErRDtBQUkvRDs7O0dBR0c7QUFDSCxNQUFhLFlBQVk7SUFNckI7Ozs7Ozs7O09BUUc7SUFDSSxNQUFNLENBQUMsV0FBVyxDQUFDLE9BQWdCO1FBQ3RDLE9BQU8sSUFBSSxDQUFDLGdCQUFnQixDQUFDLE9BQU8sRUFBRSxXQUFXLENBQUMsQ0FBQztJQUN2RCxDQUFDO0lBRUQ7Ozs7Ozs7Ozs7O09BV0c7SUFDSSxNQUFNLENBQUMsV0FBVyxDQUFDLE9BQWdCO1FBQ3RDLE9BQU8sSUFBSSxDQUFDLGdCQUFnQixDQUFDLE9BQU8sRUFBRSxXQUFXLENBQUMsQ0FBQztJQUN2RCxDQUFDO0lBRUQ7Ozs7Ozs7O09BUUc7SUFDSSxNQUFNLENBQUMsZ0JBQWdCLENBQUMsaUJBQW1DLEVBQUUsaUJBQW9DO1FBQ3BHLElBQUksaUJBQWlCLElBQUksSUFBQSw2QkFBb0IsRUFBQyxpQkFBaUIsRUFBRSxpQkFBaUIsQ0FBQyxJQUFJLENBQUMsRUFBRTtZQUN0RixPQUFPLFNBQVMsQ0FBQztTQUNwQjtRQUVELElBQUksQ0FBQyxJQUFJLENBQUMsWUFBWSxFQUFFO1lBQ3BCLElBQUksQ0FBQyxZQUFZLEdBQUc7Z0JBQ2hCLE9BQU8sRUFBRSxTQUFTO2dCQUNsQixJQUFJLEVBQUUsU0FBUztnQkFDZixTQUFTLEVBQUUsSUFBSSx5Q0FBbUIsRUFBRTtnQkFDcEMsU0FBUyxFQUFFLElBQUksNENBQW1CLEVBQUU7YUFDdkMsQ0FBQztTQUNMO1FBQ0QsT0FBTyxJQUFJLENBQUMsWUFBYSxDQUFDLGlCQUFpQixDQUFDLENBQUM7SUFDakQsQ0FBQztJQUVEOzs7Ozs7Ozs7T0FTRztJQUNJLE1BQU0sQ0FBQyxnQkFBZ0IsQ0FDMUIsT0FBZ0IsRUFDaEIsaUJBQW1DLEVBQ25DLGlCQUFvQzs7UUFFcEMsTUFBTSxVQUFVLEdBQUcsSUFBSSxDQUFDLGdCQUFnQixDQUFDLGlCQUFpQixFQUFFLGlCQUFpQixDQUFDLENBQUM7UUFDL0UsT0FBTyxNQUFBLFVBQVUsYUFBVixVQUFVLHVCQUFWLFVBQVUsQ0FBRSxjQUFjLENBQUMsT0FBTyxDQUFDLG1DQUFJLElBQUEsa0JBQU8sRUFBQyxPQUFPLENBQUMsQ0FBQztJQUNuRSxDQUFDOztBQTdFTCxvQ0E4RUM7QUE3RUc7O0dBRUc7QUFDWSx5QkFBWSxHQUFvRSxTQUFTLENBQUMiLCJzb3VyY2VzQ29udGVudCI6WyIvKlxuICogQ29weXJpZ2h0IChjKSAyMDIyIEVyaWsgRm9ydHVuZVxuICpcbiAqIFBlcm1pc3Npb24gaXMgaGVyZWJ5IGdyYW50ZWQsIGZyZWUgb2YgY2hhcmdlLCB0byBhbnkgcGVyc29uIG9idGFpbmluZyBhIGNvcHlcbiAqIG9mIHRoaXMgc29mdHdhcmUgYW5kIGFzc29jaWF0ZWQgZG9jdW1lbnRhdGlvbiBmaWxlcyAodGhlIFwiU29mdHdhcmVcIiksIHRvIGRlYWxcbiAqIGluIHRoZSBTb2Z0d2FyZSB3aXRob3V0IHJlc3RyaWN0aW9uLCBpbmNsdWRpbmcgd2l0aG91dCBsaW1pdGF0aW9uIHRoZSByaWdodHNcbiAqIHRvIHVzZSwgY29weSwgbW9kaWZ5LCBtZXJnZSwgcHVibGlzaCwgZGlzdHJpYnV0ZSwgc3VibGljZW5zZSwgYW5kL29yIHNlbGxcbiAqIGNvcGllcyBvZiB0aGUgU29mdHdhcmUsIGFuZCB0byBwZXJtaXQgcGVyc29ucyB0byB3aG9tIHRoZSBTb2Z0d2FyZSBpc1xuICogZnVybmlzaGVkIHRvIGRvIHNvLCBzdWJqZWN0IHRvIHRoZSBmb2xsb3dpbmcgY29uZGl0aW9uczpcbiAqXG4gKiBUaGUgYWJvdmUgY29weXJpZ2h0IG5vdGljZSBhbmQgdGhpcyBwZXJtaXNzaW9uIG5vdGljZSBzaGFsbCBiZSBpbmNsdWRlZCBpbiBhbGxcbiAqIGNvcGllcyBvciBzdWJzdGFudGlhbCBwb3J0aW9ucyBvZiB0aGUgU29mdHdhcmUuXG4gKlxuICogVEhFIFNPRlRXQVJFIElTIFBST1ZJREVEIFwiQVMgSVNcIiwgV0lUSE9VVCBXQVJSQU5UWSBPRiBBTlkgS0lORCwgRVhQUkVTUyBPUlxuICogSU1QTElFRCwgSU5DTFVESU5HIEJVVCBOT1QgTElNSVRFRCBUTyBUSEUgV0FSUkFOVElFUyBPRiBNRVJDSEFOVEFCSUxJVFksXG4gKiBGSVRORVNTIEZPUiBBIFBBUlRJQ1VMQVIgUFVSUE9TRSBBTkQgTk9OSU5GUklOR0VNRU5ULiBJTiBOTyBFVkVOVCBTSEFMTCBUSEVcbiAqIEFVVEhPUlMgT1IgQ09QWVJJR0hUIEhPTERFUlMgQkUgTElBQkxFIEZPUiBBTlkgQ0xBSU0sIERBTUFHRVMgT1IgT1RIRVJcbiAqIExJQUJJTElUWSwgV0hFVEhFUiBJTiBBTiBBQ1RJT04gT0YgQ09OVFJBQ1QsIFRPUlQgT1IgT1RIRVJXSVNFLCBBUklTSU5HIEZST00sXG4gKiBPVVQgT0YgT1IgSU4gQ09OTkVDVElPTiBXSVRIIFRIRSBTT0ZUV0FSRSBPUiBUSEUgVVNFIE9SIE9USEVSIERFQUxJTkdTIElOIFRIRVxuICogU09GVFdBUkUuXG4gKi9cblxuaW1wb3J0IHsgUmVzdWx0LCBzdWNjZWVkIH0gZnJvbSAnQGZndi90cy11dGlscyc7XG5pbXBvcnQgeyBUYWdOb3JtYWxpemF0aW9uLCBjb21wYXJlTm9ybWFsaXphdGlvbiB9IGZyb20gJy4vY29tbW9uJztcblxuaW1wb3J0IHsgQ2Fub25pY2FsTm9ybWFsaXplciB9IGZyb20gJy4vY2Fub25pY2FsTm9ybWFsaXplcic7XG5pbXBvcnQgeyBQcmVmZXJyZWROb3JtYWxpemVyIH0gZnJvbSAnLi9wcmVmZXJyZWRUYWdOb3JtYWxpemVyJztcbmltcG9ydCB7IFN1YnRhZ3MgfSBmcm9tICcuLi9jb21tb24nO1xuaW1wb3J0IHsgVGFnTm9ybWFsaXplciB9IGZyb20gJy4vYmFzZU5vcm1hbGl6ZXInO1xuXG4vKipcbiAqIE5vcm1hbGl6YXRpb24gaGVscGVycyBmb3IgQkNQLTQ3IGxhbmd1YWdlIHRhZ3MuXG4gKiBAcHVibGljXG4gKi9cbmV4cG9ydCBjbGFzcyBOb3JtYWxpemVUYWcge1xuICAgIC8qKlxuICAgICAqIEBpbnRlcm5hbFxuICAgICAqL1xuICAgIHByaXZhdGUgc3RhdGljIF9ub3JtYWxpemVyczogUmVjb3JkPFRhZ05vcm1hbGl6YXRpb24sIFRhZ05vcm1hbGl6ZXIgfCB1bmRlZmluZWQ+IHwgdW5kZWZpbmVkID0gdW5kZWZpbmVkO1xuXG4gICAgLyoqXG4gICAgICogQ29udmVydHMgYSBCQ1AtNDcgbGFuZ3VhZ2UgdGFnIHRvIGNhbm9uaWNhbCBmb3JtLiAgQ2Fub25pY2FsIGZvcm0gdXNlcyB0aGUgcmVjb21tZW5kZWQgY2FwaXRhbGl6YXRpb24gcnVsZXNcbiAgICAgKiBzcGVjaWZpZWQgaW4ge0BsaW5rIGh0dHBzOi8vd3d3LnJmYy1lZGl0b3Iub3JnL3JmYy9yZmM1NjQ2Lmh0bWwjc2VjdGlvbi0yLjEuMSB8IFJGQyA1NjQ2fSBidXQgYXJlIG5vdFxuICAgICAqIG90aGVyd2lzZSBtb2RpZmllZC5cbiAgICAgKlxuICAgICAqIEBwYXJhbSBzdWJ0YWdzIC0gVGhlIGluZGl2aWR1YWwge0BsaW5rIEJjcDQ3LlN1YnRhZ3MgfCBzdWJ0YWdzfSB0byBiZSBub3JtYWxpemVkLlxuICAgICAqIEByZXR1cm5zIGBTdWNjZXNzYCB3aXRoIHRoZSBub3JtYWxpemVkIGVxdWl2YWxlbnQge0BsaW5rIEJjcDQ3LlN1YnRhZ3MgfCBzdWJ0YWdzfSxcbiAgICAgKiBvciBgRmFpbHVyZWAgd2l0aCBkZXRhaWxzIGlmIGFuIGVycm9yIG9jY3Vycy5cbiAgICAgKi9cbiAgICBwdWJsaWMgc3RhdGljIHRvQ2Fub25pY2FsKHN1YnRhZ3M6IFN1YnRhZ3MpOiBSZXN1bHQ8U3VidGFncz4ge1xuICAgICAgICByZXR1cm4gdGhpcy5ub3JtYWxpemVTdWJ0YWdzKHN1YnRhZ3MsICdjYW5vbmljYWwnKTtcbiAgICB9XG5cbiAgICAvKipcbiAgICAgKiBDb252ZXJ0cyBhIEJDUC00NyBsYW5ndWFnZSB0YWcgdG8gcHJlZmVycmVkIGZvcm0uICBQcmVmZXJyZWQgZm9ybSB1c2VzIHRoZSByZWNvbW1lbmRlZCBjYXBpdGFsaXphdGlvbiBydWxlc1xuICAgICAqIHNwZWNpZmllZCBpbiB7QGxpbmsgaHR0cHM6Ly93d3cucmZjLWVkaXRvci5vcmcvcmZjL3JmYzU2NDYuaHRtbCNzZWN0aW9uLTIuMS4xIHwgUkZDIDU2NDZ9IGFuZCBhbHNvXG4gICAgICogYXBwbGllcyBhZGRpdGlvbmFsIHByZWZlcnJlZCB2YWx1ZXMgc3BlY2lmaWVkIGluIHRoZVxuICAgICAqIHtAbGluayBodHRwczovL3d3dy5pYW5hLm9yZy9hc3NpZ25tZW50cy9sYW5ndWFnZS1zdWJ0YWctcmVnaXN0cnkvbGFuZ3VhZ2Utc3VidGFnLXJlZ2lzdHJ5IHwgbGFuZ3VhZ2Ugc3VidGFnIHJlZ2lzdHJ5fTpcbiAgICAgKiBleHRyYW5lb3VzIChzdXBwcmVzc2VkKSBzY3JpcHQgdGFncyBhcmUgcmVtb3ZlZCwgZGVwcmVjYXRlZCBsYW5ndWFnZSwgZXh0bGFuZywgc2NyaXB0IG9yIHJlZ2lvbiB0YWdzIGFyZSByZXBsYWNlZFxuICAgICAqIHdpdGggdXAtdG8tZGF0ZSBwcmVmZXJyZWQgdmFsdWVzLCBhbmQgZ3JhbmRmYXRoZXJlZCBvciByZWR1bmRhbnQgdGFncyB3aXRoIGEgZGVmaW5lZCBwcmVmZXJyZWQtdmFsdWUgYXJlIHJlcGxhY2VkXG4gICAgICogaW4gdGhlaXIgZW50aXJldHkgd2l0aCB0aGUgbmV3IHByZWZlcnJlZCB2YWx1ZS5cbiAgICAgKiBAcGFyYW0gc3VidGFncyAtIFRoZSBpbmRpdmlkdWFsIHtAbGluayBCY3A0Ny5TdWJ0YWdzIHwgc3VidGFnc30gdG8gYmUgbm9ybWFsaXplZC5cbiAgICAgKiBAcmV0dXJucyBgU3VjY2Vzc2Agd2l0aCB0aGUgbm9ybWFsaXplZCBlcXVpdmFsZW50IHtAbGluayBCY3A0Ny5TdWJ0YWdzIHwgc3VidGFnc30sXG4gICAgICogb3IgYEZhaWx1cmVgIHdpdGggZGV0YWlscyBpZiBhbiBlcnJvciBvY2N1cnMuXG4gICAgICovXG4gICAgcHVibGljIHN0YXRpYyB0b1ByZWZlcnJlZChzdWJ0YWdzOiBTdWJ0YWdzKTogUmVzdWx0PFN1YnRhZ3M+IHtcbiAgICAgICAgcmV0dXJuIHRoaXMubm9ybWFsaXplU3VidGFncyhzdWJ0YWdzLCAncHJlZmVycmVkJyk7XG4gICAgfVxuXG4gICAgLyoqXG4gICAgICogQ2hvb3NlcyBhbiBhcHByb3ByaWF0ZSBkZWZhdWx0IHRhZyBub3JtYWxpemVyIGdpdmVuIGRlc2lyZWQgYW5kIG9wdGlvbmFsIGN1cnJlbnRcbiAgICAgKiB7QGxpbmsgQmNwNDcuVGFnTm9ybWFsaXphdGlvbiB8IG5vcm1hbGl6YXRpb24gbGV2ZWx9LlxuICAgICAqIEBwYXJhbSB3YW50Tm9ybWFsaXphdGlvbiAtIFRoZSBkZXNpcmVkIHtAbGluayBCY3A0Ny5UYWdOb3JtYWxpemF0aW9uIHwgbm9ybWFsaXphdGlvbiBsZXZlbH0uXG4gICAgICogQHBhcmFtIGhhdmVOb3JtYWxpemF0aW9uIC0gKG9wdGlvbmFsKSBUaGUgY3VycmVudCB7QGxpbmsgQmNwNDcuVGFnTm9ybWFsaXphdGlvbiB8IG5vcm1hbGl6YXRpb24gbGV2ZWx9LlxuICAgICAqIEByZXR1cm5zIEFuIGFwcHJvcHJpYXRlIHtAbGluayBCY3A0Ny5UYWdOb3JtYWxpemVyIHwgdGFnIG5vcm1hbGl6ZXJ9IG9yIGB1bmRlZmluZWRgIGlmIG5vIGFkZGl0aW9uYWxcbiAgICAgKiBub3JtYWxpemF0aW9uIGlzIG5lY2Vzc2FyeS5cbiAgICAgKiBAaW50ZXJuYWxcbiAgICAgKi9cbiAgICBwdWJsaWMgc3RhdGljIGNob29zZU5vcm1hbGl6ZXIod2FudE5vcm1hbGl6YXRpb246IFRhZ05vcm1hbGl6YXRpb24sIGhhdmVOb3JtYWxpemF0aW9uPzogVGFnTm9ybWFsaXphdGlvbik6IFRhZ05vcm1hbGl6ZXIgfCB1bmRlZmluZWQge1xuICAgICAgICBpZiAoaGF2ZU5vcm1hbGl6YXRpb24gJiYgY29tcGFyZU5vcm1hbGl6YXRpb24oaGF2ZU5vcm1hbGl6YXRpb24sIHdhbnROb3JtYWxpemF0aW9uKSA+PSAwKSB7XG4gICAgICAgICAgICByZXR1cm4gdW5kZWZpbmVkO1xuICAgICAgICB9XG5cbiAgICAgICAgaWYgKCF0aGlzLl9ub3JtYWxpemVycykge1xuICAgICAgICAgICAgdGhpcy5fbm9ybWFsaXplcnMgPSB7XG4gICAgICAgICAgICAgICAgdW5rbm93bjogdW5kZWZpbmVkLFxuICAgICAgICAgICAgICAgIG5vbmU6IHVuZGVmaW5lZCxcbiAgICAgICAgICAgICAgICBjYW5vbmljYWw6IG5ldyBDYW5vbmljYWxOb3JtYWxpemVyKCksXG4gICAgICAgICAgICAgICAgcHJlZmVycmVkOiBuZXcgUHJlZmVycmVkTm9ybWFsaXplcigpLFxuICAgICAgICAgICAgfTtcbiAgICAgICAgfVxuICAgICAgICByZXR1cm4gdGhpcy5fbm9ybWFsaXplcnMhW3dhbnROb3JtYWxpemF0aW9uXTtcbiAgICB9XG5cbiAgICAvKipcbiAgICAgKiBOb3JtYWxpemVzIHN1cHBsaWVkIHtAbGluayBCY3A0Ny5TdWJ0YWdzIHwgc3VidGFnc30gdG8gYSByZXF1ZXN0ZWRcbiAgICAgKiB7QGxpbmsgQmNwNDcuVGFnTm9ybWFsaXphdGlvbiB8IG5vcm1hbGl6YXRpb24gbGV2ZWx9LCBpZiBuZWNlc3NhcnkuICBJZlxuICAgICAqIG5vIG5vcm1hbGl6YXRpb24gaXMgbmVjZXNzYXJ5LCByZXR1cm5zIHRoZSBzdXBwbGllZCBzdWJ0YWdzLlxuICAgICAqIEBwYXJhbSBzdWJ0YWdzIC0gVGhlIHtAbGluayBCY3A0Ny5TdWJ0YWdzIHwgc3VidGFnc30gdG8gYmUgbm9ybWFsaXplZC5cbiAgICAgKiBAcGFyYW0gd2FudE5vcm1hbGl6YXRpb24gLSBUaGUgZGVzaXJlZCB7QGxpbmsgQmNwNDcuVGFnTm9ybWFsaXphdGlvbiB8IG5vcm1hbGl6YXRpb24gbGV2ZWx9LlxuICAgICAqIEBwYXJhbSBoYXZlTm9ybWFsaXphdGlvbiAtIChvcHRpb25hbCkgVGhlIGN1cnJlbnQge0BsaW5rIEJjcDQ3LlRhZ05vcm1hbGl6YXRpb24gfCBub3JtYWxpemF0aW9uIGxldmVsfS5cbiAgICAgKiBAcmV0dXJucyBgU3VjY2Vzc2Agd2l0aCB0aGUgbm9ybWFsaXplZCB7QGxpbmsgQmNwNDcuU3VidGFncyB8IHN1YnRhZ3N9LCBvclxuICAgICAqIGBGYWlsdXJlYCB3aXRoIGRldGFpbHMgaWYgYW4gZXJyb3Igb2NjdXJzLlxuICAgICAqL1xuICAgIHB1YmxpYyBzdGF0aWMgbm9ybWFsaXplU3VidGFncyhcbiAgICAgICAgc3VidGFnczogU3VidGFncyxcbiAgICAgICAgd2FudE5vcm1hbGl6YXRpb246IFRhZ05vcm1hbGl6YXRpb24sXG4gICAgICAgIGhhdmVOb3JtYWxpemF0aW9uPzogVGFnTm9ybWFsaXphdGlvblxuICAgICk6IFJlc3VsdDxTdWJ0YWdzPiB7XG4gICAgICAgIGNvbnN0IG5vcm1hbGl6ZXIgPSB0aGlzLmNob29zZU5vcm1hbGl6ZXIod2FudE5vcm1hbGl6YXRpb24sIGhhdmVOb3JtYWxpemF0aW9uKTtcbiAgICAgICAgcmV0dXJuIG5vcm1hbGl6ZXI/LnByb2Nlc3NTdWJ0YWdzKHN1YnRhZ3MpID8/IHN1Y2NlZWQoc3VidGFncyk7XG4gICAgfVxufVxuIl19

package/bcp47/normalization/preferredTagNormalizer.d.ts

@@ -0,0 +1,26 @@
+import * as Bcp47Subtags from '../bcp47Subtags';
+import * as Iana from '../../iana';
+import { ExtensionSubtagValue, Subtags } from '../common';
+import { Result } from '@fgv/ts-utils';
+import { TagNormalization } from './common';
+import { TagNormalizerBase } from './baseNormalizer';
+/**
+ * @public
+ */
+export declare class PreferredNormalizer extends TagNormalizerBase {
+    readonly normalization: TagNormalization;
+    protected _processLanguage(subtags: Subtags): Result<Iana.LanguageSubtags.LanguageSubtag | undefined>;
+    protected _processExtlangs(subtags: Subtags): Result<Iana.LanguageSubtags.ExtLangSubtag[] | undefined>;
+    protected _processScript(subtags: Subtags): Result<Iana.LanguageSubtags.ScriptSubtag | undefined>;
+    protected _processRegion(subtags: Subtags): Result<Iana.LanguageSubtags.RegionSubtag | undefined>;
+    protected _processVariants(subtags: Subtags): Result<Iana.LanguageSubtags.VariantSubtag[] | undefined>;
+    protected _processExtensionSingleton(singleton: Bcp47Subtags.Model.ExtensionSingleton): Result<Bcp47Subtags.Model.ExtensionSingleton>;
+    protected _processExtensionSubtagValue(value: Bcp47Subtags.Model.ExtensionSubtag): Result<Bcp47Subtags.Model.ExtensionSubtag>;
+    protected _processExtensions(subtags: Subtags): Result<ExtensionSubtagValue[] | undefined>;
+    protected _processPrivateUseTags(subtags: Subtags): Result<Iana.LanguageSubtags.ExtendedLanguageRange[] | undefined>;
+    protected _processGrandfatheredTags(subtags: Subtags): Result<Iana.LanguageSubtags.GrandfatheredTag | undefined>;
+    protected _postValidateGrandfatheredTag(subtags: Subtags): Result<Subtags>;
+    protected _postValidateRedundantTag(subtags: Subtags): Result<Subtags>;
+    protected _postValidate(subtags: Subtags): Result<Subtags>;
+}
+//# sourceMappingURL=preferredTagNormalizer.d.ts.map

package/bcp47/normalization/preferredTagNormalizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preferredTagNormalizer.d.ts","sourceRoot":"","sources":["../../../src/bcp47/normalization/preferredTagNormalizer.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,YAAY,MAAM,iBAAiB,CAAC;AAChD,OAAO,KAAK,IAAI,MAAM,YAAY,CAAC;AAEnC,OAAO,EAAE,oBAAoB,EAAE,OAAO,EAAmB,MAAM,WAAW,CAAC;AAC3E,OAAO,EAAE,MAAM,EAA6B,MAAM,eAAe,CAAC;AAGlE,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAErD;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,iBAAiB;IACtD,SAAgB,aAAa,EAAE,gBAAgB,CAAe;IAE9D,SAAS,CAAC,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,cAAc,GAAG,SAAS,CAAC;IAWrG,SAAS,CAAC,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,aAAa,EAAE,GAAG,SAAS,CAAC;IAOtG,SAAS,CAAC,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,YAAY,GAAG,SAAS,CAAC;IAoBjG,SAAS,CAAC,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,YAAY,GAAG,SAAS,CAAC;IASjG,SAAS,CAAC,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,aAAa,EAAE,GAAG,SAAS,CAAC;IAStG,SAAS,CAAC,0BAA0B,CAAC,SAAS,EAAE,YAAY,CAAC,KAAK,CAAC,kBAAkB,GAAG,MAAM,CAAC,YAAY,CAAC,KAAK,CAAC,kBAAkB,CAAC;IAIrI,SAAS,CAAC,4BAA4B,CAAC,KAAK,EAAE,YAAY,CAAC,KAAK,CAAC,eAAe,GAAG,MAAM,CAAC,YAAY,CAAC,KAAK,CAAC,eAAe,CAAC;IAI7H,SAAS,CAAC,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAAC,oBAAoB,EAAE,GAAG,SAAS,CAAC;IAM1F,SAAS,CAAC,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,qBAAqB,EAAE,GAAG,SAAS,CAAC;IAOpH,SAAS,CAAC,yBAAyB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,gBAAgB,GAAG,SAAS,CAAC;IAOhH,SAAS,CAAC,6BAA6B,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;IA8B1E,SAAS,CAAC,yBAAyB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;IAStE,SAAS,CAAC,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;CAU7D"}