@fgv/ts-bcp47 5.1.0-2 → 5.1.0-21

package/dist/packlets/bcp47/normalization/normalizeTag.js

@@ -0,0 +1,101 @@
+/*
+ * 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.
+ */
+import { succeed } from '@fgv/ts-utils';
+import { compareNormalization } from './common';
+import { CanonicalNormalizer } from './canonicalNormalizer';
+import { PreferredNormalizer } from './preferredTagNormalizer';
+/**
+ * Normalization helpers for BCP-47 language tags.
+ * @public
+ */
+export 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 && compareNormalization(haveNormalization, wantNormalization) >= 0) {
+            return undefined;
+        }
+        if (!this._normalizers) {
+            this._normalizers = {
+                unknown: undefined,
+                none: undefined,
+                canonical: new CanonicalNormalizer(),
+                preferred: new 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 : succeed(subtags);
+    }
+}
+/**
+ * @internal
+ */
+NormalizeTag._normalizers = undefined;
+//# sourceMappingURL=normalizeTag.js.map

package/dist/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,OAAO,EAAU,OAAO,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAoB,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAIlE,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAE/D;;;GAGG;AACH,MAAM,OAAO,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,oBAAoB,CAAC,iBAAiB,EAAE,iBAAiB,CAAC,IAAI,CAAC,EAAE,CAAC;YACzF,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC;YACvB,IAAI,CAAC,YAAY,GAAG;gBAClB,OAAO,EAAE,SAAS;gBAClB,IAAI,EAAE,SAAS;gBACf,SAAS,EAAE,IAAI,mBAAmB,EAAE;gBACpC,SAAS,EAAE,IAAI,mBAAmB,EAAE;aACrC,CAAC;QACJ,CAAC;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,OAAO,CAAC,OAAO,CAAC,CAAC;IACjE,CAAC;;AA/ED;;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/dist/packlets/bcp47/normalization/preferredTagNormalizer.js

@@ -0,0 +1,177 @@
+/*
+ * 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.
+ */
+import * as Iana from '../../iana';
+import * as Bcp47Subtags from '../bcp47Subtags';
+import { fail, mapResults, succeed } from '@fgv/ts-utils';
+import { subtagsToString } from '../common';
+import { sanitizeJson } from '../../utils';
+import { LanguageTagParser } from '../languageTagParser';
+import { TagNormalizerBase } from './baseNormalizer';
+/**
+ * @public
+ */
+export class PreferredNormalizer extends 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 fail(`invalid language subtag "${subtags.primaryLanguage}"`);
+            }
+            return succeed((_a = language.preferredValue) !== null && _a !== void 0 ? _a : language.subtag);
+        }
+        return succeed(undefined);
+    }
+    _processExtlangs(subtags) {
+        if (subtags.extlangs) {
+            return mapResults(subtags.extlangs.map((e) => this._iana.subtags.extlangs.toValidCanonical(e)));
+        }
+        return 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 fail(`invalid primary language subtag "${subtags.primaryLanguage}.`);
+            }
+            const script = this._iana.subtags.scripts.toValidCanonical(subtags.script).orDefault();
+            if (!script) {
+                return fail(`invalid script subtag "${subtags.script}`);
+            }
+            if (language.suppressScript !== script) {
+                return succeed(script);
+            }
+        }
+        return succeed(undefined);
+    }
+    _processRegion(subtags) {
+        if (subtags.region) {
+            return this._iana.subtags.regions.get(subtags.region).onSuccess((region) => {
+                var _a;
+                return succeed((_a = region.preferredValue) !== null && _a !== void 0 ? _a : region.subtag);
+            });
+        }
+        return succeed(undefined);
+    }
+    _processVariants(subtags) {
+        if (subtags.variants) {
+            return mapResults(subtags.variants.map((v) => this._iana.subtags.variants.toValidCanonical(v))).onSuccess((v) => this._verifyUnique('variant', v, (v) => v));
+        }
+        return 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 succeed(canon.split('-'));
+            });
+        }
+        return succeed(undefined);
+    }
+    _processGrandfatheredTags(subtags) {
+        if (subtags.grandfathered) {
+            return this._iana.subtags.grandfathered.toValidCanonical(subtags.grandfathered);
+        }
+        return succeed(undefined);
+    }
+    _postValidateGrandfatheredTag(subtags) {
+        if (subtags.grandfathered) {
+            return this._iana.subtags.grandfathered.get(subtags.grandfathered).onSuccess((grandfathered) => {
+                if (grandfathered.preferredValue) {
+                    return 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 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 fail(`grandfathered tag "${subtags.grandfathered}" has invalid preferred value "${grandfathered.preferredValue}":\n${message}`);
+                    });
+                }
+                return succeed(subtags);
+            });
+        }
+        return succeed(subtags);
+    }
+    _postValidateRedundantTag(subtags) {
+        const tag = subtagsToString(subtags);
+        const redundant = this._iana.subtags.redundant.tryGetCanonical(tag);
+        if (redundant === null || redundant === void 0 ? void 0 : redundant.preferredValue) {
+            return LanguageTagParser.parse(redundant.preferredValue, this._iana);
+        }
+        return succeed(subtags);
+    }
+    _postValidateExtLangs(subtags) {
+        var _a;
+        if (subtags.extlangs) {
+            if (subtags.extlangs.length > 1) {
+                return 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 succeed(sanitizeJson(Object.assign(Object.assign({}, subtags), { primaryLanguage: preferred.subtag, extlangs: undefined })));
+                        }
+                    }
+                }
+            }
+        }
+        return 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);
+        });
+    }
+}
+//# sourceMappingURL=preferredTagNormalizer.js.map

package/dist/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/dist/packlets/bcp47/overrides/converters.js

@@ -0,0 +1,49 @@
+/*
+ * 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.
+ */
+/* eslint-disable @rushstack/typedef-var */
+import * as Iana from '../../iana';
+import { JsonFile } from '@fgv/ts-json-base';
+import { Converters } from '@fgv/ts-utils';
+/**
+ * @internal
+ */
+export const languageOverrideRecord = Converters.strictObject({
+    language: Iana.LanguageSubtags.Converters.Tags.languageSubtag,
+    preferredRegion: Iana.LanguageSubtags.Converters.Tags.regionSubtag,
+    defaultAffinity: Converters.string,
+    affinity: Converters.recordOf(Converters.arrayOf(Iana.LanguageSubtags.Converters.Tags.regionSubtag))
+}, { optionalFields: ['affinity', 'defaultAffinity', 'preferredRegion'] });
+/**
+ * @internal
+ */
+export const languageOverridesFile = Converters.arrayOf(languageOverrideRecord);
+/**
+ * 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 function loadLanguageOverridesFileSync(path) {
+    return JsonFile.convertJsonFileSync(path, languageOverridesFile);
+}
+//# sourceMappingURL=converters.js.map

package/dist/packlets/bcp47/overrides/converters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"converters.js","sourceRoot":"","sources":["../../../../src/packlets/bcp47/overrides/converters.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,2CAA2C;AAE3C,OAAO,KAAK,IAAI,MAAM,YAAY,CAAC;AAGnC,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAa,UAAU,EAAU,MAAM,eAAe,CAAC;AAE9D;;GAEG;AACH,MAAM,CAAC,MAAM,sBAAsB,GACjC,UAAU,CAAC,YAAY,CACrB;IACE,QAAQ,EAAE,IAAI,CAAC,eAAe,CAAC,UAAU,CAAC,IAAI,CAAC,cAAc;IAC7D,eAAe,EAAE,IAAI,CAAC,eAAe,CAAC,UAAU,CAAC,IAAI,CAAC,YAAY;IAClE,eAAe,EAAE,UAAU,CAAC,MAAM;IAClC,QAAQ,EAAE,UAAU,CAAC,QAAQ,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,eAAe,CAAC,UAAU,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;CACrG,EACD,EAAE,cAAc,EAAE,CAAC,UAAU,EAAE,iBAAiB,EAAE,iBAAiB,CAAC,EAAE,CACvE,CAAC;AAEJ;;GAEG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,UAAU,CAAC,OAAO,CAAC,sBAAsB,CAAC,CAAC;AAEhF;;;;;;GAMG;AACH,MAAM,UAAU,6BAA6B,CAAC,IAAY;IACxD,OAAO,QAAQ,CAAC,mBAAmB,CAAC,IAAI,EAAE,qBAAqB,CAAC,CAAC;AACnE,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/* eslint-disable @rushstack/typedef-var */\n\nimport * as Iana from '../../iana';\nimport * as Model from './model';\n\nimport { JsonFile } from '@fgv/ts-json-base';\nimport { Converter, Converters, Result } from '@fgv/ts-utils';\n\n/**\n * @internal\n */\nexport const languageOverrideRecord: Converter<Model.ILanguageOverrideRecord, unknown> =\n  Converters.strictObject<Model.ILanguageOverrideRecord>(\n    {\n      language: Iana.LanguageSubtags.Converters.Tags.languageSubtag,\n      preferredRegion: Iana.LanguageSubtags.Converters.Tags.regionSubtag,\n      defaultAffinity: Converters.string,\n      affinity: Converters.recordOf(Converters.arrayOf(Iana.LanguageSubtags.Converters.Tags.regionSubtag))\n    },\n    { optionalFields: ['affinity', 'defaultAffinity', 'preferredRegion'] }\n  );\n\n/**\n * @internal\n */\nexport const languageOverridesFile = Converters.arrayOf(languageOverrideRecord);\n\n/**\n * Loads a language overrides JSON file.\n * @internal\n * @param path - Path from which overrides should be loaded.\n * @returns `Success` with the loaded overrides or `Failure` with details if an\n * error occurs.\n */\nexport function loadLanguageOverridesFileSync(path: string): Result<Model.ILanguageOverrideRecord[]> {\n  return JsonFile.convertJsonFileSync(path, languageOverridesFile);\n}\n"]}

package/dist/packlets/bcp47/overrides/defaultRegistries.js

@@ -0,0 +1,38 @@
+/*
+ * 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.
+ */
+import { OverridesRegistry } from './overridesRegistry';
+/**
+ * @public
+ */
+export class DefaultRegistries {
+    static get overridesRegistry() {
+        if (!this._overridesRegistry) {
+            this._overridesRegistry = OverridesRegistry.loadDefault().orThrow();
+        }
+        return this._overridesRegistry;
+    }
+}
+/**
+ * @internal
+ */
+DefaultRegistries._overridesRegistry = undefined;
+//# sourceMappingURL=defaultRegistries.js.map

package/dist/packlets/bcp47/overrides/defaultRegistries.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaultRegistries.js","sourceRoot":"","sources":["../../../../src/packlets/bcp47/overrides/defaultRegistries.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAExD;;GAEG;AACH,MAAM,OAAO,iBAAiB;IAMrB,MAAM,KAAK,iBAAiB;QACjC,IAAI,CAAC,IAAI,CAAC,kBAAkB,EAAE,CAAC;YAC7B,IAAI,CAAC,kBAAkB,GAAG,iBAAiB,CAAC,WAAW,EAAE,CAAC,OAAO,EAAE,CAAC;QACtE,CAAC;QACD,OAAO,IAAI,CAAC,kBAAkB,CAAC;IACjC,CAAC;;AAVD;;GAEG;AACY,oCAAkB,GAAuB,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 { OverridesRegistry } from './overridesRegistry';\n\n/**\n * @public\n */\nexport class DefaultRegistries {\n  /**\n   * @internal\n   */\n  private static _overridesRegistry?: OverridesRegistry = undefined;\n\n  public static get overridesRegistry(): OverridesRegistry {\n    if (!this._overridesRegistry) {\n      this._overridesRegistry = OverridesRegistry.loadDefault().orThrow();\n    }\n    return this._overridesRegistry;\n  }\n}\n"]}

package/dist/packlets/bcp47/overrides/index.js

@@ -0,0 +1,25 @@
+/*
+ * 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
+export { OverridesRegistry } from './overridesRegistry';
+export { DefaultRegistries } from './defaultRegistries';
+//# sourceMappingURL=index.js.map

package/dist/packlets/bcp47/overrides/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/packlets/bcp47/overrides/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,uBAAuB;AAEvB,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,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// istanbul ignore file\n\nexport { OverridesRegistry } from './overridesRegistry';\nexport { DefaultRegistries } from './defaultRegistries';\n"]}

package/dist/packlets/bcp47/overrides/model.js

@@ -0,0 +1,23 @@
+/*
+ * 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.
+ */
+export {};
+//# sourceMappingURL=model.js.map

package/dist/packlets/bcp47/overrides/model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.js","sourceRoot":"","sources":["../../../../src/packlets/bcp47/overrides/model.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG","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';\n\n/**\n * @internal\n */\nexport interface ILanguageOverrideRecord {\n  language: Iana.LanguageSubtags.LanguageSubtag;\n  preferredRegion?: Iana.LanguageSubtags.RegionSubtag;\n  defaultAffinity?: string;\n  affinity?: Record<string, Iana.LanguageSubtags.RegionSubtag[]>;\n}\n"]}

package/dist/packlets/bcp47/overrides/overridesRegistry.js

@@ -0,0 +1,83 @@
+/*
+ * 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.
+ */
+import * as Converters from './converters';
+import { mapResults, succeed } from '@fgv/ts-utils';
+// eslint-disable-next-line @rushstack/packlets/mechanics
+import defaultOverrides from '../../../data/bcp/overrides.json';
+/**
+ * @public
+ */
+export class OverridesRegistry {
+    constructor() {
+        this.overrides = new Map();
+    }
+    static create(overrides) {
+        const registry = new OverridesRegistry();
+        overrides.forEach((o) => registry.overrides.set(o.language, o));
+        return succeed(registry);
+    }
+    static createFromJson(from) {
+        return Converters.languageOverridesFile
+            .convert(from)
+            .onSuccess((records) => {
+            return mapResults(records.map(OverridesRegistry._overrideFromRecord));
+        })
+            .onSuccess((overrides) => {
+            return OverridesRegistry.create(overrides);
+        });
+    }
+    static loadDefault() {
+        return this.createFromJson(defaultOverrides);
+    }
+    static loadJson(path) {
+        return Converters.loadLanguageOverridesFileSync(path).onSuccess(OverridesRegistry.createFromJson);
+    }
+    /**
+     * Converts a file {@link Bcp47.Overrides.Model.LanguageOverrideRecord | LanguageOverrideRecord }
+     * to a runtime {@link Bcp47.Overrides.LanguageOverride | LanguageOverride}.
+     * @param record - The {@link Bcp47.Overrides.Model.LanguageOverrideRecord | LanguageOverrideRecord } to
+     * be converted.
+     * @returns `Success` with the resulting {@link Bcp47.Overrides.LanguageOverride | LanguageOverride}
+     * or `Error` with details if an error occurs.
+     * @internal
+     */
+    static _overrideFromRecord(record) {
+        const override = { language: record.language };
+        if (record.preferredRegion) {
+            override.preferredRegion = record.preferredRegion;
+        }
+        if (record.defaultAffinity) {
+            override.defaultAffinity = record.defaultAffinity;
+        }
+        if (record.affinity) {
+            const affinity = new Map();
+            for (const kvp of Object.entries(record.affinity)) {
+                for (const region of kvp[1]) {
+                    affinity.set(region, kvp[0]);
+                }
+            }
+            override.affinity = affinity;
+        }
+        return succeed(override);
+    }
+}
+//# sourceMappingURL=overridesRegistry.js.map

package/dist/packlets/bcp47/overrides/overridesRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"overridesRegistry.js","sourceRoot":"","sources":["../../../../src/packlets/bcp47/overrides/overridesRegistry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAGH,OAAO,KAAK,UAAU,MAAM,cAAc,CAAC;AAG3C,OAAO,EAAU,UAAU,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAC5D,yDAAyD;AACzD,OAAO,gBAAgB,MAAM,kCAAkC,CAAC;AAYhE;;GAEG;AACH,MAAM,OAAO,iBAAiB;IAG5B;QACE,IAAI,CAAC,SAAS,GAAG,IAAI,GAAG,EAAE,CAAC;IAC7B,CAAC;IAEM,MAAM,CAAC,MAAM,CAAC,SAA8B;QACjD,MAAM,QAAQ,GAAG,IAAI,iBAAiB,EAAE,CAAC;QACzC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAC;QAChE,OAAO,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC3B,CAAC;IAEM,MAAM,CAAC,cAAc,CAAC,IAAa;QACxC,OAAO,UAAU,CAAC,qBAAqB;aACpC,OAAO,CAAC,IAAI,CAAC;aACb,SAAS,CAAC,CAAC,OAAO,EAAE,EAAE;YACrB,OAAO,UAAU,CAAC,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,mBAAmB,CAAC,CAAC,CAAC;QACxE,CAAC,CAAC;aACD,SAAS,CAAC,CAAC,SAAS,EAAE,EAAE;YACvB,OAAO,iBAAiB,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAC7C,CAAC,CAAC,CAAC;IACP,CAAC;IAEM,MAAM,CAAC,WAAW;QACvB,OAAO,IAAI,CAAC,cAAc,CAAC,gBAAgB,CAAC,CAAC;IAC/C,CAAC;IAEM,MAAM,CAAC,QAAQ,CAAC,IAAY;QACjC,OAAO,UAAU,CAAC,6BAA6B,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,iBAAiB,CAAC,cAAc,CAAC,CAAC;IACpG,CAAC;IAED;;;;;;;;OAQG;IACO,MAAM,CAAC,mBAAmB,CAAC,MAAqC;QACxE,MAAM,QAAQ,GAAsB,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC;QAClE,IAAI,MAAM,CAAC,eAAe,EAAE,CAAC;YAC3B,QAAQ,CAAC,eAAe,GAAG,MAAM,CAAC,eAAe,CAAC;QACpD,CAAC;QACD,IAAI,MAAM,CAAC,eAAe,EAAE,CAAC;YAC3B,QAAQ,CAAC,eAAe,GAAG,MAAM,CAAC,eAAe,CAAC;QACpD,CAAC;QACD,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;YACpB,MAAM,QAAQ,GAAG,IAAI,GAAG,EAA6C,CAAC;YACtE,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAClD,KAAK,MAAM,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;oBAC5B,QAAQ,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;gBAC/B,CAAC;YACH,CAAC;YACD,QAAQ,CAAC,QAAQ,GAAG,QAAQ,CAAC;QAC/B,CAAC;QACD,OAAO,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC3B,CAAC;CACF","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 Converters from './converters';\nimport * as Model from './model';\n\nimport { Result, mapResults, succeed } from '@fgv/ts-utils';\n// eslint-disable-next-line @rushstack/packlets/mechanics\nimport defaultOverrides from '../../../data/bcp/overrides.json';\n\n/**\n * @public\n */\nexport interface ILanguageOverride {\n  language: Iana.LanguageSubtags.LanguageSubtag;\n  preferredRegion?: Iana.LanguageSubtags.RegionSubtag;\n  defaultAffinity?: string;\n  affinity?: Map<Iana.LanguageSubtags.RegionSubtag, string>;\n}\n\n/**\n * @public\n */\nexport class OverridesRegistry {\n  public readonly overrides: Map<Iana.LanguageSubtags.LanguageSubtag, ILanguageOverride>;\n\n  protected constructor() {\n    this.overrides = new Map();\n  }\n\n  public static create(overrides: ILanguageOverride[]): Result<OverridesRegistry> {\n    const registry = new OverridesRegistry();\n    overrides.forEach((o) => registry.overrides.set(o.language, o));\n    return succeed(registry);\n  }\n\n  public static createFromJson(from: unknown): Result<OverridesRegistry> {\n    return Converters.languageOverridesFile\n      .convert(from)\n      .onSuccess((records) => {\n        return mapResults(records.map(OverridesRegistry._overrideFromRecord));\n      })\n      .onSuccess((overrides) => {\n        return OverridesRegistry.create(overrides);\n      });\n  }\n\n  public static loadDefault(): Result<OverridesRegistry> {\n    return this.createFromJson(defaultOverrides);\n  }\n\n  public static loadJson(path: string): Result<OverridesRegistry> {\n    return Converters.loadLanguageOverridesFileSync(path).onSuccess(OverridesRegistry.createFromJson);\n  }\n\n  /**\n   * Converts a file {@link Bcp47.Overrides.Model.LanguageOverrideRecord | LanguageOverrideRecord }\n   * to a runtime {@link Bcp47.Overrides.LanguageOverride | LanguageOverride}.\n   * @param record - The {@link Bcp47.Overrides.Model.LanguageOverrideRecord | LanguageOverrideRecord } to\n   * be converted.\n   * @returns `Success` with the resulting {@link Bcp47.Overrides.LanguageOverride | LanguageOverride}\n   * or `Error` with details if an error occurs.\n   * @internal\n   */\n  protected static _overrideFromRecord(record: Model.ILanguageOverrideRecord): Result<ILanguageOverride> {\n    const override: ILanguageOverride = { language: record.language };\n    if (record.preferredRegion) {\n      override.preferredRegion = record.preferredRegion;\n    }\n    if (record.defaultAffinity) {\n      override.defaultAffinity = record.defaultAffinity;\n    }\n    if (record.affinity) {\n      const affinity = new Map<Iana.LanguageSubtags.RegionSubtag, string>();\n      for (const kvp of Object.entries(record.affinity)) {\n        for (const region of kvp[1]) {\n          affinity.set(region, kvp[0]);\n        }\n      }\n      override.affinity = affinity;\n    }\n    return succeed(override);\n  }\n}\n"]}