@fgv/ts-bcp47 0.9.6 → 2.0.1-alpha.0

package/lib/packlets/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) {
+    /* c8 ignore next - hard to hit due to guards */
+    return normalizationRank[n1] > normalizationRank[n2] ? n1 : n2;
+}
+exports.mostNormalized = mostNormalized;
+//# sourceMappingURL=common.js.map

package/lib/packlets/bcp47/normalization/common.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.js","sourceRoot":"","sources":["../../../../src/packlets/bcp47/normalization/common.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;AAQH;;;;GAIG;AACH,MAAM,iBAAiB,GAAqC;IAC1D;;OAEG;IACH,OAAO,EAAE,CAAC;IACV;;OAEG;IACH,IAAI,EAAE,GAAG;IACT;;;;OAIG;IACH,SAAS,EAAE,GAAG;IACd;;;;OAIG;IACH,SAAS,EAAE,GAAG;CACf,CAAC;AAEF;;;;;;;GAOG;AACH,SAAgB,oBAAoB,CAAC,EAAoB,EAAE,EAAoB;IAC7E,IAAI,iBAAiB,CAAC,EAAE,CAAC,GAAG,iBAAiB,CAAC,EAAE,CAAC,EAAE;QACjD,OAAO,CAAC,CAAC;KACV;SAAM,IAAI,iBAAiB,CAAC,EAAE,CAAC,GAAG,iBAAiB,CAAC,EAAE,CAAC,EAAE;QACxD,OAAO,CAAC,CAAC,CAAC;KACX;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAPD,oDAOC;AAED;;;;;;GAMG;AACH,SAAgB,cAAc,CAAC,EAAoB,EAAE,EAAoB;IACvE,gDAAgD;IAChD,OAAO,iBAAiB,CAAC,EAAE,CAAC,GAAG,iBAAiB,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;AACjE,CAAC;AAHD,wCAGC","sourcesContent":["/*\n * Copyright (c) 2022 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\n/**\n * Describes the degree of normalization of a language tag.\n * @public\n */\nexport type TagNormalization = 'unknown' | 'none' | 'canonical' | 'preferred';\n\n/**\n * Ordered ranking of the degrees of normalization, from `unknown` (least\n * normalized) to `preferred` (most normalized).\n * @public\n */\nconst normalizationRank: Record<TagNormalization, number> = {\n  /**\n   * Normalization level is unknown.\n   */\n  unknown: 0,\n  /**\n   * Not normalized.\n   */\n  none: 0.1,\n  /**\n   * Tag and subtag case has been normalized to canonical\n   * letter case (e.g. lower-case language and upper-case\n   * region) but no other normalization has been applied.\n   */\n  canonical: 0.9,\n  /**\n   * All tag recommendations have been applied - e.g. suppressed\n   * script is removed, deprecated or grandfathered values are\n   * replaced with preferred values.\n   */\n  preferred: 1.0\n};\n\n/**\n * Determines which of two normalization ranks is most normalized.\n * @param n1 - The first {@link TagNormalization} to be compared.\n * @param n2 - The second {@link TagNormalization} to me compared.\n * @returns `1` if `n1` is more normalized, `-1` if `n2` is more\n * normalized, or `0` if they are identical.\n * @public\n */\nexport function compareNormalization(n1: TagNormalization, n2: TagNormalization): -1 | 0 | 1 {\n  if (normalizationRank[n1] > normalizationRank[n2]) {\n    return 1;\n  } else if (normalizationRank[n1] < normalizationRank[n2]) {\n    return -1;\n  }\n  return 0;\n}\n\n/**\n * Chooses the most normalized of two normalization ranks.\n * @param n1 - The first {@link TagNormalization} to be compared.\n * @param n2 - The second {@link TagNormalization} to me compared.\n * @returns The most normalized of `n1` or `n2`.\n * @public\n */\nexport function mostNormalized(n1: TagNormalization, n2: TagNormalization): TagNormalization {\n  /* c8 ignore next - hard to hit due to guards */\n  return normalizationRank[n1] > normalizationRank[n2] ? n1 : n2;\n}\n"]}

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/packlets/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 → lib/packlets/bcp47}/normalization/index.js

@@ -44,4 +44,4 @@ 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
+//# sourceMappingURL=index.js.map

package/lib/packlets/bcp47/normalization/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/packlets/bcp47/normalization/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,uBAAuB;;;;;;;;;;;;;;;;;AAEvB,2CAAyB;AACzB,+CAA8C;AAArC,4GAAA,YAAY,OAAA;AACrB,6DAA4D;AAAnD,0HAAA,mBAAmB,OAAA;AAC5B,mEAA+D;AAAtD,6HAAA,mBAAmB,OAAA","sourcesContent":["/*\n * Copyright (c) 2022 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n// istanbul ignore file\n\nexport * from './common';\nexport { NormalizeTag } from './normalizeTag';\nexport { CanonicalNormalizer } from './canonicalNormalizer';\nexport { PreferredNormalizer } from './preferredTagNormalizer';\n"]}

package/{bcp47 → lib/packlets/bcp47}/normalization/normalizeTag.d.ts

@@ -1,7 +1,7 @@
 import { Result } from '@fgv/ts-utils';
 import { TagNormalization } from './common';
-import { Subtags } from '../common';
-import { TagNormalizer } from './baseNormalizer';
+import { ISubtags } from '../common';
+import { ITagNormalizer } from './baseNormalizer';
 /**
  * Normalization helpers for BCP-47 language tags.
  * @public
@@ -20,7 +20,7 @@ export declare class NormalizeTag {
      * @returns `Success` with the normalized equivalent {@link Bcp47.Subtags | subtags},
      * or `Failure` with details if an error occurs.
      */
-    static toCanonical(subtags: Subtags): Result<Subtags>;
+    static toCanonical(subtags: ISubtags): Result<ISubtags>;
     /**
      * 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
@@ -33,7 +33,7 @@ export declare class NormalizeTag {
      * @returns `Success` with the normalized equivalent {@link Bcp47.Subtags | subtags},
      * or `Failure` with details if an error occurs.
      */
-    static toPreferred(subtags: Subtags): Result<Subtags>;
+    static toPreferred(subtags: ISubtags): Result<ISubtags>;
     /**
      * Chooses an appropriate default tag normalizer given desired and optional current
      * {@link Bcp47.TagNormalization | normalization level}.
@@ -43,7 +43,7 @@ export declare class NormalizeTag {
      * normalization is necessary.
      * @internal
      */
-    static chooseNormalizer(wantNormalization: TagNormalization, haveNormalization?: TagNormalization): TagNormalizer | undefined;
+    static chooseNormalizer(wantNormalization: TagNormalization, haveNormalization?: TagNormalization): ITagNormalizer | undefined;
     /**
      * Normalizes supplied {@link Bcp47.Subtags | subtags} to a requested
      * {@link Bcp47.TagNormalization | normalization level}, if necessary.  If
@@ -54,6 +54,6 @@ export declare class NormalizeTag {
      * @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>;
+    static normalizeSubtags(subtags: ISubtags, wantNormalization: TagNormalization, haveNormalization?: TagNormalization): Result<ISubtags>;
 }
 //# sourceMappingURL=normalizeTag.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"normalizeTag.d.ts","sourceRoot":"","sources":["../../../../src/packlets/bcp47/normalization/normalizeTag.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAE,MAAM,EAAW,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAwB,MAAM,UAAU,CAAC;AAElE,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAIlD;;;GAGG;AACH,qBAAa,YAAY;IACvB;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,YAAY,CAA+E;IAE1G;;;;;;;;OAQG;WACW,WAAW,CAAC,OAAO,EAAE,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;IAI9D;;;;;;;;;;;OAWG;WACW,WAAW,CAAC,OAAO,EAAE,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;IAI9D;;;;;;;;OAQG;WACW,gBAAgB,CAC5B,iBAAiB,EAAE,gBAAgB,EACnC,iBAAiB,CAAC,EAAE,gBAAgB,GACnC,cAAc,GAAG,SAAS;IAgB7B;;;;;;;;;OASG;WACW,gBAAgB,CAC5B,OAAO,EAAE,QAAQ,EACjB,iBAAiB,EAAE,gBAAgB,EACnC,iBAAiB,CAAC,EAAE,gBAAgB,GACnC,MAAM,CAAC,QAAQ,CAAC;CAIpB"}

package/lib/packlets/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=normalizeTag.js.map

package/lib/packlets/bcp47/normalization/normalizeTag.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalizeTag.js","sourceRoot":"","sources":["../../../../src/packlets/bcp47/normalization/normalizeTag.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;AAEH,4CAAgD;AAChD,qCAAkE;AAIlE,+DAA4D;AAC5D,qEAA+D;AAE/D;;;GAGG;AACH,MAAa,YAAY;IAMvB;;;;;;;;OAQG;IACI,MAAM,CAAC,WAAW,CAAC,OAAiB;QACzC,OAAO,IAAI,CAAC,gBAAgB,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;IACrD,CAAC;IAED;;;;;;;;;;;OAWG;IACI,MAAM,CAAC,WAAW,CAAC,OAAiB;QACzC,OAAO,IAAI,CAAC,gBAAgB,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;IACrD,CAAC;IAED;;;;;;;;OAQG;IACI,MAAM,CAAC,gBAAgB,CAC5B,iBAAmC,EACnC,iBAAoC;QAEpC,IAAI,iBAAiB,IAAI,IAAA,6BAAoB,EAAC,iBAAiB,EAAE,iBAAiB,CAAC,IAAI,CAAC,EAAE;YACxF,OAAO,SAAS,CAAC;SAClB;QAED,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE;YACtB,IAAI,CAAC,YAAY,GAAG;gBAClB,OAAO,EAAE,SAAS;gBAClB,IAAI,EAAE,SAAS;gBACf,SAAS,EAAE,IAAI,yCAAmB,EAAE;gBACpC,SAAS,EAAE,IAAI,4CAAmB,EAAE;aACrC,CAAC;SACH;QACD,OAAO,IAAI,CAAC,YAAa,CAAC,iBAAiB,CAAC,CAAC;IAC/C,CAAC;IAED;;;;;;;;;OASG;IACI,MAAM,CAAC,gBAAgB,CAC5B,OAAiB,EACjB,iBAAmC,EACnC,iBAAoC;;QAEpC,MAAM,UAAU,GAAG,IAAI,CAAC,gBAAgB,CAAC,iBAAiB,EAAE,iBAAiB,CAAC,CAAC;QAC/E,OAAO,MAAA,UAAU,aAAV,UAAU,uBAAV,UAAU,CAAE,cAAc,CAAC,OAAO,CAAC,mCAAI,IAAA,kBAAO,EAAC,OAAO,CAAC,CAAC;IACjE,CAAC;;AAhFH,oCAiFC;AAhFC;;GAEG;AACY,yBAAY,GAAqE,SAAS,CAAC","sourcesContent":["/*\n * Copyright (c) 2022 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\nimport { Result, succeed } from '@fgv/ts-utils';\nimport { TagNormalization, compareNormalization } from './common';\n\nimport { ISubtags } from '../common';\nimport { ITagNormalizer } from './baseNormalizer';\nimport { CanonicalNormalizer } from './canonicalNormalizer';\nimport { PreferredNormalizer } from './preferredTagNormalizer';\n\n/**\n * Normalization helpers for BCP-47 language tags.\n * @public\n */\nexport class NormalizeTag {\n  /**\n   * @internal\n   */\n  private static _normalizers: Record<TagNormalization, ITagNormalizer | undefined> | undefined = undefined;\n\n  /**\n   * Converts a BCP-47 language tag to canonical form.  Canonical form uses the recommended capitalization rules\n   * specified in {@link https://www.rfc-editor.org/rfc/rfc5646.html#section-2.1.1 | RFC 5646} but are not\n   * otherwise modified.\n   *\n   * @param subtags - The individual {@link Bcp47.Subtags | subtags} to be normalized.\n   * @returns `Success` with the normalized equivalent {@link Bcp47.Subtags | subtags},\n   * or `Failure` with details if an error occurs.\n   */\n  public static toCanonical(subtags: ISubtags): Result<ISubtags> {\n    return this.normalizeSubtags(subtags, 'canonical');\n  }\n\n  /**\n   * Converts a BCP-47 language tag to preferred form.  Preferred form uses the recommended capitalization rules\n   * specified in {@link https://www.rfc-editor.org/rfc/rfc5646.html#section-2.1.1 | RFC 5646} and also\n   * applies additional preferred values specified in the\n   * {@link https://www.iana.org/assignments/language-subtag-registry/language-subtag-registry | language subtag registry}:\n   * extraneous (suppressed) script tags are removed, deprecated language, extlang, script or region tags are replaced\n   * with up-to-date preferred values, and grandfathered or redundant tags with a defined preferred-value are replaced\n   * in their entirety with the new preferred value.\n   * @param subtags - The individual {@link Bcp47.Subtags | subtags} to be normalized.\n   * @returns `Success` with the normalized equivalent {@link Bcp47.Subtags | subtags},\n   * or `Failure` with details if an error occurs.\n   */\n  public static toPreferred(subtags: ISubtags): Result<ISubtags> {\n    return this.normalizeSubtags(subtags, 'preferred');\n  }\n\n  /**\n   * Chooses an appropriate default tag normalizer given desired and optional current\n   * {@link Bcp47.TagNormalization | normalization level}.\n   * @param wantNormalization - The desired {@link Bcp47.TagNormalization | normalization level}.\n   * @param haveNormalization - (optional) The current {@link Bcp47.TagNormalization | normalization level}.\n   * @returns An appropriate {@link Bcp47.TagNormalizer | tag normalizer} or `undefined` if no additional\n   * normalization is necessary.\n   * @internal\n   */\n  public static chooseNormalizer(\n    wantNormalization: TagNormalization,\n    haveNormalization?: TagNormalization\n  ): ITagNormalizer | undefined {\n    if (haveNormalization && compareNormalization(haveNormalization, wantNormalization) >= 0) {\n      return undefined;\n    }\n\n    if (!this._normalizers) {\n      this._normalizers = {\n        unknown: undefined,\n        none: undefined,\n        canonical: new CanonicalNormalizer(),\n        preferred: new PreferredNormalizer()\n      };\n    }\n    return this._normalizers![wantNormalization];\n  }\n\n  /**\n   * Normalizes supplied {@link Bcp47.Subtags | subtags} to a requested\n   * {@link Bcp47.TagNormalization | normalization level}, if necessary.  If\n   * no normalization is necessary, returns the supplied subtags.\n   * @param subtags - The {@link Bcp47.Subtags | subtags} to be normalized.\n   * @param wantNormalization - The desired {@link Bcp47.TagNormalization | normalization level}.\n   * @param haveNormalization - (optional) The current {@link Bcp47.TagNormalization | normalization level}.\n   * @returns `Success` with the normalized {@link Bcp47.Subtags | subtags}, or\n   * `Failure` with details if an error occurs.\n   */\n  public static normalizeSubtags(\n    subtags: ISubtags,\n    wantNormalization: TagNormalization,\n    haveNormalization?: TagNormalization\n  ): Result<ISubtags> {\n    const normalizer = this.chooseNormalizer(wantNormalization, haveNormalization);\n    return normalizer?.processSubtags(subtags) ?? succeed(subtags);\n  }\n}\n"]}

package/lib/packlets/bcp47/normalization/preferredTagNormalizer.d.ts

@@ -0,0 +1,27 @@
+import * as Iana from '../../iana';
+import * as Bcp47Subtags from '../bcp47Subtags';
+import { Result } from '@fgv/ts-utils';
+import { IExtensionSubtagValue, ISubtags } from '../common';
+import { TagNormalizerBase } from './baseNormalizer';
+import { TagNormalization } from './common';
+/**
+ * @public
+ */
+export declare class PreferredNormalizer extends TagNormalizerBase {
+    readonly normalization: TagNormalization;
+    protected _processLanguage(subtags: ISubtags): Result<Iana.LanguageSubtags.LanguageSubtag | undefined>;
+    protected _processExtlangs(subtags: ISubtags): Result<Iana.LanguageSubtags.ExtLangSubtag[] | undefined>;
+    protected _processScript(subtags: ISubtags): Result<Iana.LanguageSubtags.ScriptSubtag | undefined>;
+    protected _processRegion(subtags: ISubtags): Result<Iana.LanguageSubtags.RegionSubtag | undefined>;
+    protected _processVariants(subtags: ISubtags): 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: ISubtags): Result<IExtensionSubtagValue[] | undefined>;
+    protected _processPrivateUseTags(subtags: ISubtags): Result<Iana.LanguageSubtags.ExtendedLanguageRange[] | undefined>;
+    protected _processGrandfatheredTags(subtags: ISubtags): Result<Iana.LanguageSubtags.GrandfatheredTag | undefined>;
+    protected _postValidateGrandfatheredTag(subtags: ISubtags): Result<ISubtags>;
+    protected _postValidateRedundantTag(subtags: ISubtags): Result<ISubtags>;
+    protected _postValidateExtLangs(subtags: ISubtags): Result<ISubtags>;
+    protected _postValidate(subtags: ISubtags): Result<ISubtags>;
+}
+//# sourceMappingURL=preferredTagNormalizer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"preferredTagNormalizer.d.ts","sourceRoot":"","sources":["../../../../src/packlets/bcp47/normalization/preferredTagNormalizer.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,IAAI,MAAM,YAAY,CAAC;AACnC,OAAO,KAAK,YAAY,MAAM,iBAAiB,CAAC;AAEhD,OAAO,EAAE,MAAM,EAA6B,MAAM,eAAe,CAAC;AAClE,OAAO,EAAE,qBAAqB,EAAE,QAAQ,EAAmB,MAAM,WAAW,CAAC;AAI7E,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAE5C;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,iBAAiB;IACxD,SAAgB,aAAa,EAAE,gBAAgB,CAAe;IAE9D,SAAS,CAAC,gBAAgB,CAAC,OAAO,EAAE,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,cAAc,GAAG,SAAS,CAAC;IAWtG,SAAS,CAAC,gBAAgB,CAAC,OAAO,EAAE,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,aAAa,EAAE,GAAG,SAAS,CAAC;IAOvG,SAAS,CAAC,cAAc,CAAC,OAAO,EAAE,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,YAAY,GAAG,SAAS,CAAC;IAoBlG,SAAS,CAAC,cAAc,CAAC,OAAO,EAAE,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,YAAY,GAAG,SAAS,CAAC;IASlG,SAAS,CAAC,gBAAgB,CAAC,OAAO,EAAE,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,aAAa,EAAE,GAAG,SAAS,CAAC;IASvG,SAAS,CAAC,0BAA0B,CAClC,SAAS,EAAE,YAAY,CAAC,KAAK,CAAC,kBAAkB,GAC/C,MAAM,CAAC,YAAY,CAAC,KAAK,CAAC,kBAAkB,CAAC;IAIhD,SAAS,CAAC,4BAA4B,CACpC,KAAK,EAAE,YAAY,CAAC,KAAK,CAAC,eAAe,GACxC,MAAM,CAAC,YAAY,CAAC,KAAK,CAAC,eAAe,CAAC;IAI7C,SAAS,CAAC,kBAAkB,CAAC,OAAO,EAAE,QAAQ,GAAG,MAAM,CAAC,qBAAqB,EAAE,GAAG,SAAS,CAAC;IAM5F,SAAS,CAAC,sBAAsB,CAC9B,OAAO,EAAE,QAAQ,GAChB,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,qBAAqB,EAAE,GAAG,SAAS,CAAC;IAUnE,SAAS,CAAC,yBAAyB,CACjC,OAAO,EAAE,QAAQ,GAChB,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,gBAAgB,GAAG,SAAS,CAAC;IAO5D,SAAS,CAAC,6BAA6B,CAAC,OAAO,EAAE,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;IA2B5E,SAAS,CAAC,yBAAyB,CAAC,OAAO,EAAE,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;IASxE,SAAS,CAAC,qBAAqB,CAAC,OAAO,EAAE,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;IA6BpE,SAAS,CAAC,aAAa,CAAC,OAAO,EAAE,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;CAa7D"}

package/lib/packlets/bcp47/normalization/preferredTagNormalizer.js

@@ -0,0 +1,204 @@
+"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.PreferredNormalizer = void 0;
+const Iana = __importStar(require("../../iana"));
+const Bcp47Subtags = __importStar(require("../bcp47Subtags"));
+const ts_utils_1 = require("@fgv/ts-utils");
+const common_1 = require("../common");
+const utils_1 = require("../../utils");
+const languageTagParser_1 = require("../languageTagParser");
+const baseNormalizer_1 = require("./baseNormalizer");
+/**
+ * @public
+ */
+class PreferredNormalizer extends baseNormalizer_1.TagNormalizerBase {
+    constructor() {
+        super(...arguments);
+        this.normalization = 'preferred';
+    }
+    _processLanguage(subtags) {
+        var _a;
+        if (subtags.primaryLanguage) {
+            const language = this._iana.subtags.languages.tryGet(subtags.primaryLanguage);
+            if (!language) {
+                return (0, ts_utils_1.fail)(`invalid language subtag "${subtags.primaryLanguage}"`);
+            }
+            return (0, ts_utils_1.succeed)((_a = language.preferredValue) !== null && _a !== void 0 ? _a : language.subtag);
+        }
+        return (0, ts_utils_1.succeed)(undefined);
+    }
+    _processExtlangs(subtags) {
+        if (subtags.extlangs) {
+            return (0, ts_utils_1.mapResults)(subtags.extlangs.map((e) => this._iana.subtags.extlangs.toValidCanonical(e)));
+        }
+        return (0, ts_utils_1.succeed)(undefined);
+    }
+    _processScript(subtags) {
+        if (subtags.primaryLanguage && subtags.script) {
+            const language = this._iana.subtags.languages.tryGet(subtags.primaryLanguage);
+            /* c8 ignore next 3 - internal error difficult to test */
+            if (!language) {
+                return (0, ts_utils_1.fail)(`invalid primary language subtag "${subtags.primaryLanguage}.`);
+            }
+            const script = this._iana.subtags.scripts.toValidCanonical(subtags.script).orDefault();
+            if (!script) {
+                return (0, ts_utils_1.fail)(`invalid script subtag "${subtags.script}`);
+            }
+            if (language.suppressScript !== script) {
+                return (0, ts_utils_1.succeed)(script);
+            }
+        }
+        return (0, ts_utils_1.succeed)(undefined);
+    }
+    _processRegion(subtags) {
+        if (subtags.region) {
+            return this._iana.subtags.regions.get(subtags.region).onSuccess((region) => {
+                var _a;
+                return (0, ts_utils_1.succeed)((_a = region.preferredValue) !== null && _a !== void 0 ? _a : region.subtag);
+            });
+        }
+        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.toValidCanonical(v))).onSuccess((v) => this._verifyUnique('variant', v, (v) => v));
+        }
+        return (0, ts_utils_1.succeed)(undefined);
+    }
+    _processExtensionSingleton(singleton) {
+        return this._iana.extensions.extensions.toValidCanonical(singleton);
+    }
+    _processExtensionSubtagValue(value) {
+        return Bcp47Subtags.Validate.extensionSubtag.toCanonical(value);
+    }
+    _processExtensions(subtags) {
+        return super._processExtensions(subtags).onSuccess((extensions) => {
+            return this._verifyUnique('extensions', extensions, (e) => e.singleton);
+        });
+    }
+    _processPrivateUseTags(subtags) {
+        if (subtags.privateUse) {
+            const merged = subtags.privateUse.join('-');
+            return Iana.LanguageSubtags.Validate.extendedLanguageRange.toCanonical(merged).onSuccess((canon) => {
+                return (0, ts_utils_1.succeed)(canon.split('-'));
+            });
+        }
+        return (0, ts_utils_1.succeed)(undefined);
+    }
+    _processGrandfatheredTags(subtags) {
+        if (subtags.grandfathered) {
+            return this._iana.subtags.grandfathered.toValidCanonical(subtags.grandfathered);
+        }
+        return (0, ts_utils_1.succeed)(undefined);
+    }
+    _postValidateGrandfatheredTag(subtags) {
+        if (subtags.grandfathered) {
+            return this._iana.subtags.grandfathered.get(subtags.grandfathered).onSuccess((grandfathered) => {
+                if (grandfathered.preferredValue) {
+                    return languageTagParser_1.LanguageTagParser.parse(grandfathered.preferredValue, this._iana)
+                        .onSuccess((gfSubtags) => {
+                        /* c8 ignore next 5 - would require a registry error too hard to test */
+                        if (gfSubtags.grandfathered !== undefined) {
+                            return (0, ts_utils_1.fail)(`preferred value ${grandfathered.preferredValue} of grandfathered tag ${subtags.grandfathered} is also grandfathered.`);
+                        }
+                        return this.processSubtags(gfSubtags);
+                    })
+                        .onFailure((message) => {
+                        /* c8 ignore next 4 - would require a registry error too hard to test */
+                        return (0, ts_utils_1.fail)(`grandfathered tag "${subtags.grandfathered}" has invalid preferred value "${grandfathered.preferredValue}":\n${message}`);
+                    });
+                }
+                return (0, ts_utils_1.succeed)(subtags);
+            });
+        }
+        return (0, ts_utils_1.succeed)(subtags);
+    }
+    _postValidateRedundantTag(subtags) {
+        const tag = (0, common_1.subtagsToString)(subtags);
+        const redundant = this._iana.subtags.redundant.tryGetCanonical(tag);
+        if (redundant === null || redundant === void 0 ? void 0 : redundant.preferredValue) {
+            return languageTagParser_1.LanguageTagParser.parse(redundant.preferredValue, this._iana);
+        }
+        return (0, ts_utils_1.succeed)(subtags);
+    }
+    _postValidateExtLangs(subtags) {
+        var _a;
+        if (subtags.extlangs) {
+            if (subtags.extlangs.length > 1) {
+                return (0, ts_utils_1.fail)(`${subtags.extlangs.join('-')}: multiple extlang subtags is invalid`);
+            }
+            if (subtags.extlangs.length > 0) {
+                const registry = this._iana.subtags.extlangs.tryGet(subtags.extlangs[0]);
+                if (registry) {
+                    if (registry.preferredValue &&
+                        registry.prefix === /* c8 ignore next */ ((_a = subtags.primaryLanguage) === null || _a === void 0 ? void 0 : _a.toLowerCase())) {
+                        const preferred = this._iana.subtags.languages.tryGet(registry.preferredValue);
+                        if (preferred) {
+                            return (0, ts_utils_1.succeed)((0, utils_1.sanitizeJson)(Object.assign(Object.assign({}, subtags), { primaryLanguage: preferred.subtag, extlangs: undefined })));
+                        }
+                    }
+                }
+            }
+        }
+        return (0, ts_utils_1.succeed)(subtags);
+    }
+    _postValidate(subtags) {
+        return super
+            ._postValidate(subtags)
+            .onSuccess((subtags) => {
+            return this._postValidateExtLangs(subtags);
+        })
+            .onSuccess((subtags) => {
+            return this._postValidateGrandfatheredTag(subtags);
+        })
+            .onSuccess((subtags) => {
+            return this._postValidateRedundantTag(subtags);
+        });
+    }
+}
+exports.PreferredNormalizer = PreferredNormalizer;
+//# sourceMappingURL=preferredTagNormalizer.js.map

package/lib/packlets/bcp47/normalization/preferredTagNormalizer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preferredTagNormalizer.js","sourceRoot":"","sources":["../../../../src/packlets/bcp47/normalization/preferredTagNormalizer.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * Copyright (c) 2022 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\nimport * as Iana from '../../iana';\nimport * as Bcp47Subtags from '../bcp47Subtags';\n\nimport { Result, fail, mapResults, succeed } from '@fgv/ts-utils';\nimport { IExtensionSubtagValue, ISubtags, subtagsToString } from '../common';\n\nimport { sanitizeJson } from '../../utils';\nimport { LanguageTagParser } from '../languageTagParser';\nimport { TagNormalizerBase } from './baseNormalizer';\nimport { TagNormalization } from './common';\n\n/**\n * @public\n */\nexport class PreferredNormalizer extends TagNormalizerBase {\n  public readonly normalization: TagNormalization = 'preferred';\n\n  protected _processLanguage(subtags: ISubtags): Result<Iana.LanguageSubtags.LanguageSubtag | undefined> {\n    if (subtags.primaryLanguage) {\n      const language = this._iana.subtags.languages.tryGet(subtags.primaryLanguage);\n      if (!language) {\n        return fail(`invalid language subtag \"${subtags.primaryLanguage}\"`);\n      }\n      return succeed(language.preferredValue ?? language.subtag);\n    }\n    return succeed(undefined);\n  }\n\n  protected _processExtlangs(subtags: ISubtags): Result<Iana.LanguageSubtags.ExtLangSubtag[] | undefined> {\n    if (subtags.extlangs) {\n      return mapResults(subtags.extlangs.map((e) => this._iana.subtags.extlangs.toValidCanonical(e)));\n    }\n    return succeed(undefined);\n  }\n\n  protected _processScript(subtags: ISubtags): Result<Iana.LanguageSubtags.ScriptSubtag | undefined> {\n    if (subtags.primaryLanguage && subtags.script) {\n      const language = this._iana.subtags.languages.tryGet(subtags.primaryLanguage);\n      /* c8 ignore next 3 - internal error difficult to test */\n      if (!language) {\n        return fail(`invalid primary language subtag \"${subtags.primaryLanguage}.`);\n      }\n\n      const script = this._iana.subtags.scripts.toValidCanonical(subtags.script).orDefault();\n      if (!script) {\n        return fail(`invalid script subtag \"${subtags.script}`);\n      }\n\n      if (language.suppressScript !== script) {\n        return succeed(script);\n      }\n    }\n    return succeed(undefined);\n  }\n\n  protected _processRegion(subtags: ISubtags): Result<Iana.LanguageSubtags.RegionSubtag | undefined> {\n    if (subtags.region) {\n      return this._iana.subtags.regions.get(subtags.region).onSuccess((region) => {\n        return succeed(region.preferredValue ?? region.subtag);\n      });\n    }\n    return succeed(undefined);\n  }\n\n  protected _processVariants(subtags: ISubtags): Result<Iana.LanguageSubtags.VariantSubtag[] | undefined> {\n    if (subtags.variants) {\n      return mapResults(\n        subtags.variants.map((v) => this._iana.subtags.variants.toValidCanonical(v))\n      ).onSuccess((v) => this._verifyUnique('variant', v, (v) => v));\n    }\n    return succeed(undefined);\n  }\n\n  protected _processExtensionSingleton(\n    singleton: Bcp47Subtags.Model.ExtensionSingleton\n  ): Result<Bcp47Subtags.Model.ExtensionSingleton> {\n    return this._iana.extensions.extensions.toValidCanonical(singleton);\n  }\n\n  protected _processExtensionSubtagValue(\n    value: Bcp47Subtags.Model.ExtensionSubtag\n  ): Result<Bcp47Subtags.Model.ExtensionSubtag> {\n    return Bcp47Subtags.Validate.extensionSubtag.toCanonical(value);\n  }\n\n  protected _processExtensions(subtags: ISubtags): Result<IExtensionSubtagValue[] | undefined> {\n    return super._processExtensions(subtags).onSuccess((extensions) => {\n      return this._verifyUnique('extensions', extensions, (e) => e.singleton);\n    });\n  }\n\n  protected _processPrivateUseTags(\n    subtags: ISubtags\n  ): Result<Iana.LanguageSubtags.ExtendedLanguageRange[] | undefined> {\n    if (subtags.privateUse) {\n      const merged = subtags.privateUse.join('-');\n      return Iana.LanguageSubtags.Validate.extendedLanguageRange.toCanonical(merged).onSuccess((canon) => {\n        return succeed(canon.split('-') as Iana.LanguageSubtags.ExtendedLanguageRange[]);\n      });\n    }\n    return succeed(undefined);\n  }\n\n  protected _processGrandfatheredTags(\n    subtags: ISubtags\n  ): Result<Iana.LanguageSubtags.GrandfatheredTag | undefined> {\n    if (subtags.grandfathered) {\n      return this._iana.subtags.grandfathered.toValidCanonical(subtags.grandfathered);\n    }\n    return succeed(undefined);\n  }\n\n  protected _postValidateGrandfatheredTag(subtags: ISubtags): Result<ISubtags> {\n    if (subtags.grandfathered) {\n      return this._iana.subtags.grandfathered.get(subtags.grandfathered).onSuccess((grandfathered) => {\n        if (grandfathered.preferredValue) {\n          return LanguageTagParser.parse(grandfathered.preferredValue, this._iana)\n            .onSuccess((gfSubtags) => {\n              /* c8 ignore next 5 - would require a registry error too hard to test */\n              if (gfSubtags.grandfathered !== undefined) {\n                return fail<ISubtags>(\n                  `preferred value ${grandfathered.preferredValue} of grandfathered tag ${subtags.grandfathered} is also grandfathered.`\n                );\n              }\n              return this.processSubtags(gfSubtags);\n            })\n            .onFailure((message) => {\n              /* c8 ignore next 4 - would require a registry error too hard to test */\n              return fail(\n                `grandfathered tag \"${subtags.grandfathered}\" has invalid preferred value \"${grandfathered.preferredValue}\":\\n${message}`\n              );\n            });\n        }\n        return succeed(subtags);\n      });\n    }\n    return succeed(subtags);\n  }\n\n  protected _postValidateRedundantTag(subtags: ISubtags): Result<ISubtags> {\n    const tag = subtagsToString(subtags);\n    const redundant = this._iana.subtags.redundant.tryGetCanonical(tag);\n    if (redundant?.preferredValue) {\n      return LanguageTagParser.parse(redundant.preferredValue, this._iana);\n    }\n    return succeed(subtags);\n  }\n\n  protected _postValidateExtLangs(subtags: ISubtags): Result<ISubtags> {\n    if (subtags.extlangs) {\n      if (subtags.extlangs.length > 1) {\n        return fail(`${subtags.extlangs.join('-')}: multiple extlang subtags is invalid`);\n      }\n      if (subtags.extlangs.length > 0) {\n        const registry = this._iana.subtags.extlangs.tryGet(subtags.extlangs[0]);\n        if (registry) {\n          if (\n            registry.preferredValue &&\n            registry.prefix === /* c8 ignore next */ subtags.primaryLanguage?.toLowerCase()\n          ) {\n            const preferred = this._iana.subtags.languages.tryGet(registry.preferredValue);\n            if (preferred) {\n              return succeed(\n                sanitizeJson({\n                  ...subtags,\n                  primaryLanguage: preferred.subtag,\n                  extlangs: undefined\n                })\n              );\n            }\n          }\n        }\n      }\n    }\n    return succeed(subtags);\n  }\n\n  protected _postValidate(subtags: ISubtags): Result<ISubtags> {\n    return super\n      ._postValidate(subtags)\n      .onSuccess((subtags) => {\n        return this._postValidateExtLangs(subtags);\n      })\n      .onSuccess((subtags) => {\n        return this._postValidateGrandfatheredTag(subtags);\n      })\n      .onSuccess((subtags) => {\n        return this._postValidateRedundantTag(subtags);\n      });\n  }\n}\n"]}

package/lib/packlets/bcp47/overrides/converters.d.ts

@@ -0,0 +1,19 @@
+import * as Model from './model';
+import { Converter, Result } from '@fgv/ts-utils';
+/**
+ * @internal
+ */
+export declare const languageOverrideRecord: Converter<Model.ILanguageOverrideRecord, unknown>;
+/**
+ * @internal
+ */
+export declare const languageOverridesFile: Converter<Model.ILanguageOverrideRecord[], unknown>;
+/**
+ * Loads a language overrides JSON file.
+ * @internal
+ * @param path - Path from which overrides should be loaded.
+ * @returns `Success` with the loaded overrides or `Failure` with details if an
+ * error occurs.
+ */
+export declare function loadLanguageOverridesFileSync(path: string): Result<Model.ILanguageOverrideRecord[]>;
+//# sourceMappingURL=converters.d.ts.map

package/lib/packlets/bcp47/overrides/converters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"converters.d.ts","sourceRoot":"","sources":["../../../../src/packlets/bcp47/overrides/converters.ts"],"names":[],"mappings":"AAwBA,OAAO,KAAK,KAAK,MAAM,SAAS,CAAC;AAGjC,OAAO,EAAE,SAAS,EAAc,MAAM,EAAE,MAAM,eAAe,CAAC;AAE9D;;GAEG;AACH,eAAO,MAAM,sBAAsB,EAAE,SAAS,CAAC,KAAK,CAAC,uBAAuB,EAAE,OAAO,CASlF,CAAC;AAEJ;;GAEG;AACH,eAAO,MAAM,qBAAqB,qDAA6C,CAAC;AAEhF;;;;;;GAMG;AACH,wBAAgB,6BAA6B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,uBAAuB,EAAE,CAAC,CAEnG"}