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

package/dist/packlets/bcp47/languageRegistryData.js

@@ -0,0 +1,202 @@
+/*
+ * 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 { subtagsToString } from './common';
+/**
+ * Returns all of the data in the IANA language subtags registry for
+ * a set of supplied {@link Bcp47.Subtags | subtags}.
+ * @public
+ */
+export class LanguageRegistryData {
+    /**
+     * Constructs a new {@link Bcp47.LanguageTagRegistryData | Bcp47.LanguageTagRegistryData}
+     * from a supplied {@link Bcp47.Subtags | subtags} and {@link Iana.LanguageRegistries | language registries}.
+     * @public
+     */
+    constructor(subtags, iana) {
+        this._iana = iana;
+        this._subtags = subtags;
+    }
+    /**
+     * Registry data associated with the primary language subtag of the language tag from
+     * which this {@link Bcp47.LanguageTagRegistryData | Bcp47.LanguageTagRegistryData}
+     * was constructed, or `undefined` if the primary language is missing or invalid.
+     * @public
+     */
+    get primaryLanguage() {
+        var _a;
+        if (this._primaryLanguage === undefined) {
+            this._primaryLanguage = (_a = this._iana.subtags.languages.tryGet(this._subtags.primaryLanguage)) !== null && _a !== void 0 ? _a : false;
+        }
+        return this._primaryLanguage ? this._primaryLanguage : undefined;
+    }
+    /**
+     * Registry data associated with the extlang subtag of the language tag from
+     * which this {@link Bcp47.LanguageTagRegistryData | Bcp47.LanguageTagRegistryData}
+     * was constructed, or `undefined` if extlang is missing or invalid.
+     * @public
+     */
+    get extlangs() {
+        if (this._extlangs === undefined) {
+            if (this._subtags.extlangs !== undefined) {
+                this._extlangs = this._subtags.extlangs.map((e) => {
+                    return {
+                        subtag: e,
+                        registry: this._iana.subtags.extlangs.tryGet(e)
+                    };
+                });
+            }
+            if (!this._subtags.extlangs || this._subtags.extlangs.length === 0) {
+                this._extlangs = false;
+            }
+        }
+        return this._extlangs ? this._extlangs : undefined;
+    }
+    /**
+     * Registry data associated with the script of the language tag from
+     * which this {@link Bcp47.LanguageTagRegistryData | Bcp47.LanguageTagRegistryData}
+     * was constructed, or `undefined` if the script cannot be determined.
+     *
+     * @public
+     */
+    get script() {
+        if (this._script === undefined) {
+            if (this._subtags.script) {
+                this._script = this._iana.subtags.scripts.tryGet(this._subtags.script);
+            }
+            if (!this._script) {
+                this._script = false;
+            }
+        }
+        return this._script ? this._script : undefined;
+    }
+    /**
+     * Registry data associated with the script of the language tag from
+     * which this {@link Bcp47.LanguageTagRegistryData | Bcp47.LanguageTagRegistryData}
+     * was constructed, or `undefined` if the script cannot be determined.
+     *
+     * Note that effectiveScript will default to the registry `Suppress-Script` value of the
+     * primary language if no script subtag is present.
+     * @public
+     */
+    get effectiveScript() {
+        var _a;
+        if (this._effectiveScript === undefined) {
+            if (this._subtags.script) {
+                this._effectiveScript = this._iana.subtags.scripts.tryGet(this._subtags.script);
+            }
+            else if (!this._effectiveScript) {
+                const suppressed = (_a = this.primaryLanguage) === null || _a === void 0 ? void 0 : _a.suppressScript;
+                if (suppressed) {
+                    this._effectiveScript = this._iana.subtags.scripts.tryGet(suppressed);
+                }
+            }
+            if (!this._effectiveScript) {
+                this._effectiveScript = false;
+            }
+        }
+        return this._effectiveScript ? this._effectiveScript : undefined;
+    }
+    /**
+     * Registry data associated with the region subtag of the language tag from
+     * which this {@link Bcp47.LanguageTagRegistryData | Bcp47.LanguageTagRegistryData}
+     * was constructed, or `undefined` if the region is missing or invalid.
+     * @public
+     */
+    get region() {
+        if (this._region === undefined) {
+            if (this._subtags.region) {
+                this._region = this._iana.subtags.regions.tryGet(this._subtags.region);
+            }
+            if (!this._region) {
+                this._region = false;
+            }
+        }
+        return this._region ? this._region : undefined;
+    }
+    /**
+     * Registry data associated with the variant subtags of the language tag from
+     * which this {@link Bcp47.LanguageTagRegistryData | Bcp47.LanguageTagRegistryData}
+     * was constructed, or `undefined` if variant subtags are missing or invalid.
+     * @public
+     */
+    get variants() {
+        if (this._variants === undefined) {
+            if (this._subtags.variants !== undefined) {
+                this._variants = this._subtags.variants.map((v) => {
+                    return {
+                        subtag: v,
+                        registry: this._iana.subtags.variants.tryGet(v)
+                    };
+                });
+            }
+            if (!this._subtags.variants || this._subtags.variants.length === 0) {
+                this._variants = false;
+            }
+        }
+        return this._variants ? this._variants : undefined;
+    }
+    /**
+     * Registry data associated with the extension subtags of the language tag from
+     * which this {@link Bcp47.LanguageTagRegistryData | Bcp47.LanguageTagRegistryData}
+     * was constructed, or `undefined` if extension subtags are missing or invalid.
+     * @public
+     */
+    get extensions() {
+        if (this._extensions === undefined) {
+            if (this._subtags.extensions !== undefined) {
+                this._extensions = this._subtags.extensions.map((e) => {
+                    return Object.assign(Object.assign({}, e), { registry: this._iana.extensions.extensions.tryGet(e.singleton) });
+                });
+            }
+            if (!this._subtags.variants || this._subtags.variants.length === 0) {
+                this._variants = false;
+            }
+        }
+        return this._extensions ? this._extensions : undefined;
+    }
+    /**
+     * Registry data for grandfathered tags, or `undefined` if the tag is not recognized
+     * as a grandfathered tag.
+     * @public
+     */
+    get grandfathered() {
+        if (this._grandfathered === undefined) {
+            if (this._subtags.grandfathered) {
+                this._grandfathered = this._iana.subtags.grandfathered.tryGet(this._subtags.grandfathered);
+            }
+            if (!this._grandfathered) {
+                this._grandfathered = false;
+            }
+        }
+        return this._grandfathered ? this._grandfathered : undefined;
+    }
+    /**
+     * @returns A string representation of the subtags from which this
+     * {@link Bcp47.LanguageTagRegistryData | Bcp47.LanguageTagRegistryData}
+     * was created.
+     * @public
+     */
+    toString() {
+        return subtagsToString(this._subtags);
+    }
+}
+//# sourceMappingURL=languageRegistryData.js.map

package/dist/packlets/bcp47/languageRegistryData.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"languageRegistryData.js","sourceRoot":"","sources":["../../../src/packlets/bcp47/languageRegistryData.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';\n\nimport { IExtensionSubtagValue, ISubtags, subtagsToString } from './common';\n\n/**\n * Represents a single extlang subtag with corresponding registry data,\n * if present.\n * @public\n */\nexport interface IRegisteredExtLangValue {\n  /**\n   * A {@link Iana.LanguageSubtags.ExtLangSubtag | extlang subtag} from\n   * the original language tag.\n   */\n  subtag: Iana.LanguageSubtags.ExtLangSubtag;\n  /**\n   * The {@link Iana.LanguageSubtag.Model.RegisteredExtLang | IANA subtag registry entry}\n   * for this subtag, or `undefined` if the subtag is not registered.\n   */\n  registry?: Iana.LanguageSubtags.Model.IRegisteredExtLang;\n}\n\n/**\n * Represents a single variant subtag with corresponding registry data,\n * if present.\n * @public\n */\nexport interface IRegisteredVariantValue {\n  /**\n   * A {@link Iana.LanguageSubtags.VariantSubtag | variant subtag} from\n   * the original language tag.\n   */\n  subtag: Iana.LanguageSubtags.VariantSubtag;\n  /**\n   * The {@link Iana.LanguageSubtag.Model.RegisteredVariant | IANA subtag registry entry}\n   * for this subtag, or `undefined` if the subtag is not registered.\n   */\n  registry?: Iana.LanguageSubtags.Model.IRegisteredVariant;\n}\n\n/**\n * Represents a single extension subtag with corresponding registry data,\n * if present.\n * @public\n */\nexport interface IRegisteredExtensionValue extends IExtensionSubtagValue {\n  /**\n   * The language extensions registry entry for the associated subtag,\n   * or `undefined` if the extension is not registered.\n   */\n  registry?: Iana.LanguageTagExtensions.Model.ILanguageTagExtension;\n}\n\n/**\n * Returns all of the data in the IANA language subtags registry for\n * a set of supplied {@link Bcp47.Subtags | subtags}.\n * @public\n */\nexport class LanguageRegistryData {\n  /**\n   * @internal\n   */\n  protected _iana: Iana.LanguageRegistries;\n  /**\n   * @internal\n   */\n  protected _subtags: ISubtags;\n  /**\n   * @internal\n   */\n  protected _primaryLanguage?: Iana.LanguageSubtags.Model.IRegisteredLanguage | false;\n  /**\n   * @internal\n   */\n  protected _extlangs?: IRegisteredExtLangValue[] | false;\n  /**\n   * @internal\n   */\n  protected _script?: Iana.LanguageSubtags.Model.IRegisteredScript | false;\n  /**\n   * @internal\n   */\n  protected _effectiveScript?: Iana.LanguageSubtags.Model.IRegisteredScript | false;\n  /**\n   * @internal\n   */\n  protected _region?: Iana.LanguageSubtags.Model.IRegisteredRegion | false;\n  /**\n   * @internal\n   */\n  protected _variants?: IRegisteredVariantValue[] | false;\n  /**\n   * @internal\n   */\n  protected _extensions?: IRegisteredExtensionValue[] | false;\n  /**\n   * @internal\n   */\n  protected _grandfathered?: Iana.LanguageSubtags.Model.IRegisteredGrandfatheredTag | false;\n\n  /**\n   * Constructs a new {@link Bcp47.LanguageTagRegistryData | Bcp47.LanguageTagRegistryData}\n   * from a supplied {@link Bcp47.Subtags | subtags} and {@link Iana.LanguageRegistries | language registries}.\n   * @public\n   */\n  public constructor(subtags: ISubtags, iana: Iana.LanguageRegistries) {\n    this._iana = iana;\n    this._subtags = subtags;\n  }\n\n  /**\n   * Registry data associated with the primary language subtag of the language tag from\n   * which this {@link Bcp47.LanguageTagRegistryData | Bcp47.LanguageTagRegistryData}\n   * was constructed, or `undefined` if the primary language is missing or invalid.\n   * @public\n   */\n  public get primaryLanguage(): Iana.LanguageSubtags.Model.IRegisteredLanguage | undefined {\n    if (this._primaryLanguage === undefined) {\n      this._primaryLanguage = this._iana.subtags.languages.tryGet(this._subtags.primaryLanguage) ?? false;\n    }\n    return this._primaryLanguage ? this._primaryLanguage : undefined;\n  }\n\n  /**\n   * Registry data associated with the extlang subtag of the language tag from\n   * which this {@link Bcp47.LanguageTagRegistryData | Bcp47.LanguageTagRegistryData}\n   * was constructed, or `undefined` if extlang is missing or invalid.\n   * @public\n   */\n  public get extlangs(): IRegisteredExtLangValue[] | undefined {\n    if (this._extlangs === undefined) {\n      if (this._subtags.extlangs !== undefined) {\n        this._extlangs = this._subtags.extlangs.map((e) => {\n          return {\n            subtag: e,\n            registry: this._iana.subtags.extlangs.tryGet(e)\n          };\n        });\n      }\n      if (!this._subtags.extlangs || this._subtags.extlangs.length === 0) {\n        this._extlangs = false;\n      }\n    }\n    return this._extlangs ? this._extlangs : undefined;\n  }\n\n  /**\n   * Registry data associated with the script of the language tag from\n   * which this {@link Bcp47.LanguageTagRegistryData | Bcp47.LanguageTagRegistryData}\n   * was constructed, or `undefined` if the script cannot be determined.\n   *\n   * @public\n   */\n  public get script(): Iana.LanguageSubtags.Model.IRegisteredScript | undefined {\n    if (this._script === undefined) {\n      if (this._subtags.script) {\n        this._script = this._iana.subtags.scripts.tryGet(this._subtags.script);\n      }\n      if (!this._script) {\n        this._script = false;\n      }\n    }\n    return this._script ? this._script : undefined;\n  }\n\n  /**\n   * Registry data associated with the script of the language tag from\n   * which this {@link Bcp47.LanguageTagRegistryData | Bcp47.LanguageTagRegistryData}\n   * was constructed, or `undefined` if the script cannot be determined.\n   *\n   * Note that effectiveScript will default to the registry `Suppress-Script` value of the\n   * primary language if no script subtag is present.\n   * @public\n   */\n  public get effectiveScript(): Iana.LanguageSubtags.Model.IRegisteredScript | undefined {\n    if (this._effectiveScript === undefined) {\n      if (this._subtags.script) {\n        this._effectiveScript = this._iana.subtags.scripts.tryGet(this._subtags.script);\n      } else if (!this._effectiveScript) {\n        const suppressed = this.primaryLanguage?.suppressScript;\n        if (suppressed) {\n          this._effectiveScript = this._iana.subtags.scripts.tryGet(suppressed);\n        }\n      }\n      if (!this._effectiveScript) {\n        this._effectiveScript = false;\n      }\n    }\n    return this._effectiveScript ? this._effectiveScript : undefined;\n  }\n\n  /**\n   * Registry data associated with the region subtag of the language tag from\n   * which this {@link Bcp47.LanguageTagRegistryData | Bcp47.LanguageTagRegistryData}\n   * was constructed, or `undefined` if the region is missing or invalid.\n   * @public\n   */\n  public get region(): Iana.LanguageSubtags.Model.IRegisteredRegion | undefined {\n    if (this._region === undefined) {\n      if (this._subtags.region) {\n        this._region = this._iana.subtags.regions.tryGet(this._subtags.region);\n      }\n      if (!this._region) {\n        this._region = false;\n      }\n    }\n    return this._region ? this._region : undefined;\n  }\n\n  /**\n   * Registry data associated with the variant subtags of the language tag from\n   * which this {@link Bcp47.LanguageTagRegistryData | Bcp47.LanguageTagRegistryData}\n   * was constructed, or `undefined` if variant subtags are missing or invalid.\n   * @public\n   */\n  public get variants(): IRegisteredVariantValue[] | undefined {\n    if (this._variants === undefined) {\n      if (this._subtags.variants !== undefined) {\n        this._variants = this._subtags.variants.map((v) => {\n          return {\n            subtag: v,\n            registry: this._iana.subtags.variants.tryGet(v)\n          };\n        });\n      }\n      if (!this._subtags.variants || this._subtags.variants.length === 0) {\n        this._variants = false;\n      }\n    }\n    return this._variants ? this._variants : undefined;\n  }\n\n  /**\n   * Registry data associated with the extension subtags of the language tag from\n   * which this {@link Bcp47.LanguageTagRegistryData | Bcp47.LanguageTagRegistryData}\n   * was constructed, or `undefined` if extension subtags are missing or invalid.\n   * @public\n   */\n  public get extensions(): IRegisteredExtensionValue[] | undefined {\n    if (this._extensions === undefined) {\n      if (this._subtags.extensions !== undefined) {\n        this._extensions = this._subtags.extensions.map((e) => {\n          return {\n            ...e,\n            registry: this._iana.extensions.extensions.tryGet(e.singleton)\n          };\n        });\n      }\n      if (!this._subtags.variants || this._subtags.variants.length === 0) {\n        this._variants = false;\n      }\n    }\n    return this._extensions ? this._extensions : undefined;\n  }\n\n  /**\n   * Registry data for grandfathered tags, or `undefined` if the tag is not recognized\n   * as a grandfathered tag.\n   * @public\n   */\n  public get grandfathered(): Iana.LanguageSubtags.Model.IRegisteredGrandfatheredTag | undefined {\n    if (this._grandfathered === undefined) {\n      if (this._subtags.grandfathered) {\n        this._grandfathered = this._iana.subtags.grandfathered.tryGet(this._subtags.grandfathered);\n      }\n      if (!this._grandfathered) {\n        this._grandfathered = false;\n      }\n    }\n    return this._grandfathered ? this._grandfathered : undefined;\n  }\n\n  /**\n   * @returns A string representation of the subtags from which this\n   * {@link Bcp47.LanguageTagRegistryData | Bcp47.LanguageTagRegistryData}\n   * was created.\n   * @public\n   */\n  public toString(): string {\n    return subtagsToString(this._subtags);\n  }\n}\n"]}

package/dist/packlets/bcp47/languageTag.js

@@ -0,0 +1,363 @@
+/*
+ * 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 { captureResult, succeed } from '@fgv/ts-utils';
+import { UndeterminedLanguage, subtagsToString } from './common';
+import { mostNormalized } from './normalization/common';
+import { mostValid } from './validation/common';
+import { LanguageRegistryData } from './languageRegistryData';
+import { LanguageTagParser } from './languageTagParser';
+import { NormalizeTag } from './normalization';
+import { ValidateTag } from './validation';
+/**
+ * Represents a single BCP-47 language tag.
+ * @public
+ */
+export class LanguageTag {
+    /**
+     * Constructs a {@link Bcp47.LanguageTag | LanguageTag }.
+     * @param subtags - The {@link Bcp47.Subtags | subtags } from
+     * which the tag is constructed.
+     * @param validity - Known {@link Bcp47.TagValidity | validation level} of the
+     * supplied subtags.
+     * @param normalization - Known {@link Bcp47.TagNormalization | normalization level}
+     * of the supplied subtags.
+     * @param iana - The {@link Iana.LanguageRegistries} used to validate and normalize
+     * this tag.
+     * @internal
+     */
+    constructor(subtags, validity, normalization, iana) {
+        this.subtags = Object.freeze(Object.assign({}, subtags));
+        this._normalization = normalization;
+        this._validity = validity;
+        this.tag = subtagsToString(subtags);
+        this._iana = iana;
+        this.registry = new LanguageRegistryData(this.subtags, iana);
+        if (validity === 'strictly-valid') {
+            this._isStrictlyValid = true;
+            this._isValid = true;
+        }
+        else if (validity === 'valid') {
+            this._isValid = true;
+        }
+        if (normalization === 'preferred') {
+            this._isPreferred = true;
+            this._isCanonical = true;
+        }
+        else if (normalization === 'canonical') {
+            this._isCanonical = true;
+        }
+    }
+    /**
+     * The effective script of this language tag, if known.
+     * The effective script is the script subtag in the tag itself,
+     * if present, or the `Suppress-Script` defined in the
+     * {@link https://www.iana.org/assignments/language-subtag-registry/language-subtag-registry | IANA subtag registry}
+     * for the primary language of this tag.  Can be `undefined`
+     * if neither the tag nor the IANA registry define a script.
+     */
+    get effectiveScript() {
+        var _a;
+        return (_a = this.subtags.script) !== null && _a !== void 0 ? _a : this.getSuppressedScript();
+    }
+    /**
+     * Determines if this tag represents the special `undetermined` language.
+     */
+    get isUndetermined() {
+        var _a;
+        /* c8 ignore next */
+        return ((_a = this.subtags.primaryLanguage) === null || _a === void 0 ? void 0 : _a.toLowerCase()) === UndeterminedLanguage;
+    }
+    /**
+     * Whether this language tag is valid.
+     */
+    get isValid() {
+        if (this._isValid === undefined) {
+            this._isValid = ValidateTag.isValid(this.subtags);
+            if (this._isValid) {
+                this._validity = 'valid';
+            }
+        }
+        return this._isValid === true;
+    }
+    /**
+     * Whether if this language tag is strictly valid.
+     */
+    get isStrictlyValid() {
+        if (this._isStrictlyValid === undefined) {
+            this._isStrictlyValid = ValidateTag.isStrictlyValid(this.subtags);
+            if (this._isStrictlyValid) {
+                this._validity = 'strictly-valid';
+            }
+        }
+        return this._isStrictlyValid === true;
+    }
+    /**
+     * Whether this language tag is in canonical form.
+     */
+    get isCanonical() {
+        if (this._isCanonical === undefined) {
+            this._isCanonical = ValidateTag.isCanonical(this.subtags);
+            if (this._isCanonical) {
+                this._normalization = 'canonical';
+            }
+        }
+        return this._isCanonical === true;
+    }
+    /**
+     * Whether this language tag is in preferred form.
+     */
+    get isPreferred() {
+        if (this._isPreferred === undefined) {
+            this._isPreferred = ValidateTag.isInPreferredForm(this.subtags);
+            if (this._isPreferred) {
+                this._normalization = 'preferred';
+            }
+        }
+        return this._isPreferred === true;
+    }
+    /**
+     * Whether this language tag is a grandfathered tag.
+     */
+    get isGrandfathered() {
+        return this.subtags.grandfathered !== undefined;
+    }
+    /**
+     * Gets a text description of this tag.
+     */
+    get description() {
+        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m;
+        const parts = [];
+        if (!this.subtags.grandfathered) {
+            if (this.registry.primaryLanguage || this.subtags.primaryLanguage) {
+                parts.push(((_b = (_a = this.registry.primaryLanguage) === null || _a === void 0 ? void 0 : _a.description[0]) !== null && _b !== void 0 ? _b : this.subtags.primaryLanguage));
+            }
+            if (this.registry.extlangs) {
+                for (const e of this.registry.extlangs) {
+                    parts.push(`/ ${(_d = (_c = e.registry) === null || _c === void 0 ? void 0 : _c.description[0]) !== null && _d !== void 0 ? _d : e.subtag}`);
+                }
+            }
+            if (this.subtags.script) {
+                parts.push(`in ${(_f = (_e = this.registry.script) === null || _e === void 0 ? void 0 : _e.description[0]) !== null && _f !== void 0 ? _f : this.subtags.script} script`);
+            }
+            if (this.subtags.region) {
+                parts.push(`as spoken in ${(_h = (_g = this.registry.region) === null || _g === void 0 ? void 0 : _g.description[0]) !== null && _h !== void 0 ? _h : this.subtags.region}`);
+            }
+            if (this.registry.variants && this.registry.variants.length > 0) {
+                for (const e of this.registry.variants) {
+                    parts.push(`(${(_k = (_j = e.registry) === null || _j === void 0 ? void 0 : _j.description[0]) !== null && _k !== void 0 ? _k : e.subtag})`);
+                }
+            }
+            if (this.registry.extensions && this.registry.extensions.length > 0) {
+                for (const e of this.registry.extensions) {
+                    parts.push(`(${(_m = (_l = e.registry) === null || _l === void 0 ? void 0 : _l.description[0]) !== null && _m !== void 0 ? _m : `-${e.singleton}`} "${e.value}")`);
+                }
+            }
+            if (this.subtags.privateUse && this.subtags.privateUse.length > 0) {
+                parts.push(`(-x "${this.subtags.privateUse.join('-')}")`);
+            }
+        }
+        else {
+            parts.push(`${this.tag} (grandfathered)`);
+        }
+        return parts.join(' ');
+    }
+    /**
+     * Creates a new {@link Bcp47.LanguageTag | language tag} from a supplied `string` tag
+     * using optional configuration, if supplied.
+     * @param tag - The `string` tag from which the {@link Bcp47.LanguageTag | language tag}
+     * is te be constructed.
+     * @param options - (optional) set of {@link Bcp47.ILanguageTagInitOptions | init options}
+     * to guide the validation and normalization of this tag.
+     * @returns `Success` with the new {@link Bcp47.LanguageTag | language tag} or `Failure`
+     * with details if an error occurs.
+     */
+    static createFromTag(tag, options) {
+        options = this._getOptions(options);
+        return LanguageTagParser.parse(tag, options.iana).onSuccess((subtags) => {
+            return this._createTransformed(subtags, 'unknown', 'unknown', options);
+        });
+    }
+    /**
+     * Creates a new {@link Bcp47.LanguageTag | language tag} from a supplied
+     * {@link Bcp47.Subtags | subtags} using optional configuration,
+     * if supplied.
+     * @param subtags - The {@link Bcp47.Subtags | subtags} from which the
+     * {@link Bcp47.LanguageTag | language tag} is te be constructed.
+     * @param options - (optional) set of {@link Bcp47.ILanguageTagInitOptions | init options}
+     * to guide the validation and normalization of this tag.
+     * @returns `Success` with the new {@link Bcp47.LanguageTag | language tag} or `Failure`
+     * with details if an error occurs.
+     */
+    static createFromSubtags(subtags, options) {
+        return this._createTransformed(subtags, 'unknown', 'unknown', options);
+    }
+    /**
+     * Creates a new {@link Bcp47.LanguageTag | language tag} from a supplied `string`
+     * tag or {@link Bcp47.Subtags | subtags} using optional configuration,
+     * if supplied.
+     * @param from - The `string` tag or {@link Bcp47.Subtags | subtags} from
+     * which the {@link Bcp47.LanguageTag | language tag} is te be constructed.
+     * @param options - (optional) set of {@link Bcp47.ILanguageTagInitOptions | init options}
+     * to guide the validation and normalization of this tag.
+     * @returns `Success` with the new {@link Bcp47.LanguageTag | language tag} or `Failure`
+     * with details if an error occurs.
+     */
+    static create(from, options) {
+        if (typeof from === 'string') {
+            return this.createFromTag(from, options);
+        }
+        else {
+            return this.createFromSubtags(from, options);
+        }
+    }
+    /**
+     * Constructs a new {@link Bcp47.LanguageTag | language tag} by applying appropriate transformations
+     * to as supplied {@link Bcp47.Subtags | Bcp47.Subtags}.
+     * @param subtags - The {@link Bcp47.Subtags | subtags} which represent the tag.
+     * @param fromValidity - The {@link Bcp47.TagValidity | validation level} of the supplied subtags.
+     * @param fromNormalization - The {@link Bcp47.TagNormalization | normalization level} fo the
+     * supplied subtags.
+     * @param partialOptions - Any {@link Bcp47.ILanguageTagInitOptions | initialization options}.
+     * @returns `Success` with the corresponding {@link Bcp47.LanguageTag | language tag} or `Failure`
+     * with details if an error occurs.
+     * @internal
+     */
+    static _createTransformed(subtags, fromValidity, fromNormalization, partialOptions) {
+        const options = this._getOptions(partialOptions);
+        return ValidateTag.validateSubtags(subtags, options.validity, fromValidity)
+            .onSuccess(() => {
+            return NormalizeTag.normalizeSubtags(subtags, options.normalization, fromNormalization);
+        })
+            .onSuccess((normalized) => {
+            const validity = mostValid(fromValidity, options.validity);
+            const normalization = mostNormalized(fromNormalization, options.normalization);
+            return captureResult(() => new LanguageTag(normalized, validity, normalization, options.iana));
+        });
+    }
+    /**
+     * Gets a fully-specified {@link Bcp47.ILanguageTagInitOptions} from partial or undefined
+     * options, substituting defaults as appropriate.
+     * @param options - The {@link Bcp47.ILanguageTagInitOptions} to be expanded, or `undefined`
+     * for default options.
+     * @returns Fully-specified {@link Bcp47.ILanguageTagInitOptions | init options}.
+     * @internal
+     */
+    static _getOptions(options) {
+        var _a, _b, _c;
+        return {
+            iana: (_a = options === null || options === void 0 ? void 0 : options.iana) !== null && _a !== void 0 ? _a : Iana.DefaultRegistries.languageRegistries,
+            validity: (_b = options === null || options === void 0 ? void 0 : options.validity) !== null && _b !== void 0 ? _b : 'well-formed',
+            normalization: (_c = options === null || options === void 0 ? void 0 : options.normalization) !== null && _c !== void 0 ? _c : 'none'
+        };
+    }
+    /**
+     * Returns the `Suppress-Script` value defined for the primary language of this tag,
+     * regardless of whether a different script is defined in this subtag.
+     * @returns The suppress-script defined for the primary language, or undefined if
+     * the primary language is invalid or has no defined suppressed script.
+     */
+    getSuppressedScript() {
+        if (this._suppressedScript === undefined) {
+            this._suppressedScript = false;
+            if (this.subtags.primaryLanguage) {
+                const language = this._iana.subtags.languages.tryGet(this.subtags.primaryLanguage);
+                if ((language === null || language === void 0 ? void 0 : language.suppressScript) !== undefined) {
+                    this._suppressedScript = language.suppressScript;
+                }
+            }
+        }
+        return this._suppressedScript ? this._suppressedScript : undefined;
+    }
+    /**
+     * Gets a confirmed valid representation of this language tag.
+     * @returns `Success` with a valid representation of this {@link Bcp47.LanguageTag | language tag},
+     * or `Failure` with details if the tag cannot be validated.
+     */
+    toValid() {
+        if (this.isValid) {
+            return succeed(this);
+        }
+        const options = {
+            iana: this._iana,
+            validity: 'valid',
+            normalization: this._normalization
+        };
+        return LanguageTag._createTransformed(this.subtags, this._validity, this._normalization, options);
+    }
+    /**
+     * Gets a confirmed strictly valid representation of this language tag.
+     * @returns `Success` with a strictly valid representation of this {@link Bcp47.LanguageTag | language tag},
+     * or `Failure` with details if the tag cannot be strictly validated.
+     */
+    toStrictlyValid() {
+        if (this.isStrictlyValid) {
+            return succeed(this);
+        }
+        const options = {
+            iana: this._iana,
+            validity: 'strictly-valid',
+            normalization: this._normalization
+        };
+        return LanguageTag._createTransformed(this.subtags, this._validity, this._normalization, options);
+    }
+    /**
+     * Gets a confirmed canonical representation of this language tag.
+     * @returns `Success` with a canonical representation of this {@link Bcp47.LanguageTag | language tag},
+     * or `Failure` with details if the tag cannot be normalized to canonical form.
+     */
+    toCanonical() {
+        if (this.isCanonical) {
+            return succeed(this);
+        }
+        const options = {
+            iana: this._iana,
+            validity: this._validity,
+            normalization: 'canonical'
+        };
+        return LanguageTag._createTransformed(this.subtags, this._validity, this._normalization, options);
+    }
+    /**
+     * Gets a confirmed preferred representation of this language tag.
+     * @returns `Success` with a preferred representation of this {@link Bcp47.LanguageTag | language tag},
+     * or `Failure` with details if the tag cannot be normalized to preferred form.
+     */
+    toPreferred() {
+        if (this.isPreferred) {
+            return succeed(this);
+        }
+        const options = {
+            iana: this._iana,
+            validity: 'valid', // preferred requires validity
+            normalization: 'preferred'
+        };
+        return LanguageTag._createTransformed(this.subtags, this._validity, this._normalization, options);
+    }
+    /**
+     * Gets a string representation of this language tag.
+     * @returns A string representation of this language tag.
+     */
+    toString() {
+        return this.tag;
+    }
+}
+//# sourceMappingURL=languageTag.js.map

package/dist/packlets/bcp47/languageTag.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"languageTag.js","sourceRoot":"","sources":["../../../src/packlets/bcp47/languageTag.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';\n\nimport { Result, captureResult, succeed } from '@fgv/ts-utils';\nimport { ISubtags, UndeterminedLanguage, subtagsToString } from './common';\nimport { TagNormalization, mostNormalized } from './normalization/common';\nimport { TagValidity, mostValid } from './validation/common';\n\nimport { LanguageRegistryData } from './languageRegistryData';\nimport { LanguageTagParser } from './languageTagParser';\nimport { NormalizeTag } from './normalization';\nimport { ValidateTag } from './validation';\n\n/**\n * Initialization options for parsing or creation of {@link Bcp47.LanguageTag | language tag} objects.\n * @public\n */\nexport interface ILanguageTagInitOptions {\n  /**\n   * Desired {@link Bcp47.TagValidity | validity level} (optional).\n   */\n  validity?: TagValidity;\n  /**\n   * Desired {@link Bcp47.TagNormalization | normalization level} (optional).\n   */\n  normalization?: TagNormalization;\n  /**\n   * The {@link Iana.LanguageRegistries | IANA language subtag and extension registries} to\n   * be used for the request (optional).\n   */\n  iana?: Iana.LanguageRegistries;\n}\n\n/**\n * Represents a single BCP-47 language tag.\n * @public\n */\nexport class LanguageTag {\n  /**\n   * The individual {@link Bcp47.Subtags | subtags} for\n   * this language tag.\n   */\n  public readonly subtags: Readonly<ISubtags>;\n\n  /**\n   * A string representation of this language tag.\n   */\n  public readonly tag: string;\n\n  /**\n   * Details about this language tag from the IANA language\n   * registries.\n   */\n  public readonly registry: LanguageRegistryData;\n\n  /**\n   * @internal\n   */\n  protected readonly _iana: Iana.LanguageRegistries;\n\n  /**\n   * @internal\n   */\n  protected _validity: TagValidity;\n\n  /**\n   * @internal\n   */\n  protected _normalization: TagNormalization;\n\n  /**\n   * @internal\n   */\n  protected _isValid: undefined | boolean;\n\n  /**\n   * @internal\n   */\n  protected _isStrictlyValid: undefined | boolean;\n\n  /**\n   * @internal\n   */\n  protected _isCanonical: undefined | boolean;\n\n  /**\n   * @internal\n   */\n  protected _isPreferred: undefined | boolean;\n\n  /**\n   * @internal\n   */\n  protected _suppressedScript: undefined | Iana.LanguageSubtags.ScriptSubtag | false;\n\n  /**\n   * Constructs a {@link Bcp47.LanguageTag | LanguageTag }.\n   * @param subtags - The {@link Bcp47.Subtags | subtags } from\n   * which the tag is constructed.\n   * @param validity - Known {@link Bcp47.TagValidity | validation level} of the\n   * supplied subtags.\n   * @param normalization - Known {@link Bcp47.TagNormalization | normalization level}\n   * of the supplied subtags.\n   * @param iana - The {@link Iana.LanguageRegistries} used to validate and normalize\n   * this tag.\n   * @internal\n   */\n  protected constructor(\n    subtags: ISubtags,\n    validity: TagValidity,\n    normalization: TagNormalization,\n    iana: Iana.LanguageRegistries\n  ) {\n    this.subtags = Object.freeze({ ...subtags });\n    this._normalization = normalization;\n    this._validity = validity;\n    this.tag = subtagsToString(subtags);\n    this._iana = iana;\n    this.registry = new LanguageRegistryData(this.subtags, iana);\n\n    if (validity === 'strictly-valid') {\n      this._isStrictlyValid = true;\n      this._isValid = true;\n    } else if (validity === 'valid') {\n      this._isValid = true;\n    }\n\n    if (normalization === 'preferred') {\n      this._isPreferred = true;\n      this._isCanonical = true;\n    } else if (normalization === 'canonical') {\n      this._isCanonical = true;\n    }\n  }\n\n  /**\n   * The effective script of this language tag, if known.\n   * The effective script is the script subtag in the tag itself,\n   * if present, or the `Suppress-Script` defined in the\n   * {@link https://www.iana.org/assignments/language-subtag-registry/language-subtag-registry | IANA subtag registry}\n   * for the primary language of this tag.  Can be `undefined`\n   * if neither the tag nor the IANA registry define a script.\n   */\n  public get effectiveScript(): Iana.LanguageSubtags.ScriptSubtag | undefined {\n    return this.subtags.script ?? this.getSuppressedScript();\n  }\n\n  /**\n   * Determines if this tag represents the special `undetermined` language.\n   */\n  public get isUndetermined(): boolean {\n    /* c8 ignore next */\n    return this.subtags.primaryLanguage?.toLowerCase() === UndeterminedLanguage;\n  }\n\n  /**\n   * Whether this language tag is valid.\n   */\n  public get isValid(): boolean {\n    if (this._isValid === undefined) {\n      this._isValid = ValidateTag.isValid(this.subtags);\n      if (this._isValid) {\n        this._validity = 'valid';\n      }\n    }\n    return this._isValid === true;\n  }\n\n  /**\n   * Whether if this language tag is strictly valid.\n   */\n  public get isStrictlyValid(): boolean {\n    if (this._isStrictlyValid === undefined) {\n      this._isStrictlyValid = ValidateTag.isStrictlyValid(this.subtags);\n      if (this._isStrictlyValid) {\n        this._validity = 'strictly-valid';\n      }\n    }\n    return this._isStrictlyValid === true;\n  }\n\n  /**\n   * Whether this language tag is in canonical form.\n   */\n  public get isCanonical(): boolean {\n    if (this._isCanonical === undefined) {\n      this._isCanonical = ValidateTag.isCanonical(this.subtags);\n      if (this._isCanonical) {\n        this._normalization = 'canonical';\n      }\n    }\n    return this._isCanonical === true;\n  }\n\n  /**\n   * Whether this language tag is in preferred form.\n   */\n  public get isPreferred(): boolean {\n    if (this._isPreferred === undefined) {\n      this._isPreferred = ValidateTag.isInPreferredForm(this.subtags);\n      if (this._isPreferred) {\n        this._normalization = 'preferred';\n      }\n    }\n    return this._isPreferred === true;\n  }\n\n  /**\n   * Whether this language tag is a grandfathered tag.\n   */\n  public get isGrandfathered(): boolean {\n    return this.subtags.grandfathered !== undefined;\n  }\n\n  /**\n   * Gets a text description of this tag.\n   */\n  public get description(): string {\n    const parts: string[] = [];\n    if (!this.subtags.grandfathered) {\n      if (this.registry.primaryLanguage || this.subtags.primaryLanguage) {\n        parts.push((this.registry.primaryLanguage?.description[0] ?? this.subtags.primaryLanguage)!);\n      }\n      if (this.registry.extlangs) {\n        for (const e of this.registry.extlangs) {\n          parts.push(`/ ${e.registry?.description[0] ?? e.subtag}`);\n        }\n      }\n      if (this.subtags.script) {\n        parts.push(`in ${this.registry.script?.description[0] ?? this.subtags.script} script`);\n      }\n      if (this.subtags.region) {\n        parts.push(`as spoken in ${this.registry.region?.description[0] ?? this.subtags.region}`);\n      }\n      if (this.registry.variants && this.registry.variants.length > 0) {\n        for (const e of this.registry.variants) {\n          parts.push(`(${e.registry?.description[0] ?? e.subtag})`);\n        }\n      }\n      if (this.registry.extensions && this.registry.extensions.length > 0) {\n        for (const e of this.registry.extensions) {\n          parts.push(`(${e.registry?.description[0] ?? `-${e.singleton}`} \"${e.value}\")`);\n        }\n      }\n      if (this.subtags.privateUse && this.subtags.privateUse.length > 0) {\n        parts.push(`(-x \"${this.subtags.privateUse.join('-')}\")`);\n      }\n    } else {\n      parts.push(`${this.tag} (grandfathered)`);\n    }\n    return parts.join(' ');\n  }\n\n  /**\n   * Creates a new {@link Bcp47.LanguageTag | language tag} from a supplied `string` tag\n   * using optional configuration, if supplied.\n   * @param tag - The `string` tag from which the {@link Bcp47.LanguageTag | language tag}\n   * is te be constructed.\n   * @param options - (optional) set of {@link Bcp47.ILanguageTagInitOptions | init options}\n   * to guide the validation and normalization of this tag.\n   * @returns `Success` with the new {@link Bcp47.LanguageTag | language tag} or `Failure`\n   * with details if an error occurs.\n   */\n  public static createFromTag(tag: string, options?: ILanguageTagInitOptions): Result<LanguageTag> {\n    options = this._getOptions(options);\n\n    return LanguageTagParser.parse(tag, options.iana).onSuccess((subtags) => {\n      return this._createTransformed(subtags, 'unknown', 'unknown', options);\n    });\n  }\n\n  /**\n   * Creates a new {@link Bcp47.LanguageTag | language tag} from a supplied\n   * {@link Bcp47.Subtags | subtags} using optional configuration,\n   * if supplied.\n   * @param subtags - The {@link Bcp47.Subtags | subtags} from which the\n   * {@link Bcp47.LanguageTag | language tag} is te be constructed.\n   * @param options - (optional) set of {@link Bcp47.ILanguageTagInitOptions | init options}\n   * to guide the validation and normalization of this tag.\n   * @returns `Success` with the new {@link Bcp47.LanguageTag | language tag} or `Failure`\n   * with details if an error occurs.\n   */\n  public static createFromSubtags(subtags: ISubtags, options?: ILanguageTagInitOptions): Result<LanguageTag> {\n    return this._createTransformed(subtags, 'unknown', 'unknown', options);\n  }\n\n  /**\n   * Creates a new {@link Bcp47.LanguageTag | language tag} from a supplied `string`\n   * tag or {@link Bcp47.Subtags | subtags} using optional configuration,\n   * if supplied.\n   * @param from - The `string` tag or {@link Bcp47.Subtags | subtags} from\n   * which the {@link Bcp47.LanguageTag | language tag} is te be constructed.\n   * @param options - (optional) set of {@link Bcp47.ILanguageTagInitOptions | init options}\n   * to guide the validation and normalization of this tag.\n   * @returns `Success` with the new {@link Bcp47.LanguageTag | language tag} or `Failure`\n   * with details if an error occurs.\n   */\n  public static create(from: string | ISubtags, options?: ILanguageTagInitOptions): Result<LanguageTag> {\n    if (typeof from === 'string') {\n      return this.createFromTag(from, options);\n    } else {\n      return this.createFromSubtags(from, options);\n    }\n  }\n\n  /**\n   * Constructs a new {@link Bcp47.LanguageTag | language tag} by applying appropriate transformations\n   * to as supplied {@link Bcp47.Subtags | Bcp47.Subtags}.\n   * @param subtags - The {@link Bcp47.Subtags | subtags} which represent the tag.\n   * @param fromValidity - The {@link Bcp47.TagValidity | validation level} of the supplied subtags.\n   * @param fromNormalization - The {@link Bcp47.TagNormalization | normalization level} fo the\n   * supplied subtags.\n   * @param partialOptions - Any {@link Bcp47.ILanguageTagInitOptions | initialization options}.\n   * @returns `Success` with the corresponding {@link Bcp47.LanguageTag | language tag} or `Failure`\n   * with details if an error occurs.\n   * @internal\n   */\n  protected static _createTransformed(\n    subtags: ISubtags,\n    fromValidity: TagValidity,\n    fromNormalization: TagNormalization,\n    partialOptions?: ILanguageTagInitOptions\n  ): Result<LanguageTag> {\n    const options = this._getOptions(partialOptions);\n    return ValidateTag.validateSubtags(subtags, options.validity, fromValidity)\n      .onSuccess(() => {\n        return NormalizeTag.normalizeSubtags(subtags, options.normalization, fromNormalization);\n      })\n      .onSuccess((normalized) => {\n        const validity = mostValid(fromValidity, options.validity);\n        const normalization = mostNormalized(fromNormalization, options.normalization);\n        return captureResult(() => new LanguageTag(normalized, validity, normalization, options.iana));\n      });\n  }\n\n  /**\n   * Gets a fully-specified {@link Bcp47.ILanguageTagInitOptions} from partial or undefined\n   * options, substituting defaults as appropriate.\n   * @param options - The {@link Bcp47.ILanguageTagInitOptions} to be expanded, or `undefined`\n   * for default options.\n   * @returns Fully-specified {@link Bcp47.ILanguageTagInitOptions | init options}.\n   * @internal\n   */\n  protected static _getOptions(options?: ILanguageTagInitOptions): Required<ILanguageTagInitOptions> {\n    return {\n      iana: options?.iana ?? Iana.DefaultRegistries.languageRegistries,\n      validity: options?.validity ?? 'well-formed',\n      normalization: options?.normalization ?? 'none'\n    };\n  }\n\n  /**\n   * Returns the `Suppress-Script` value defined for the primary language of this tag,\n   * regardless of whether a different script is defined in this subtag.\n   * @returns The suppress-script defined for the primary language, or undefined if\n   * the primary language is invalid or has no defined suppressed script.\n   */\n  public getSuppressedScript(): Iana.LanguageSubtags.ScriptSubtag | undefined {\n    if (this._suppressedScript === undefined) {\n      this._suppressedScript = false;\n      if (this.subtags.primaryLanguage) {\n        const language = this._iana.subtags.languages.tryGet(this.subtags.primaryLanguage);\n        if (language?.suppressScript !== undefined) {\n          this._suppressedScript = language.suppressScript;\n        }\n      }\n    }\n    return this._suppressedScript ? this._suppressedScript : undefined;\n  }\n\n  /**\n   * Gets a confirmed valid representation of this language tag.\n   * @returns `Success` with a valid representation of this {@link Bcp47.LanguageTag | language tag},\n   * or `Failure` with details if the tag cannot be validated.\n   */\n  public toValid(): Result<LanguageTag> {\n    if (this.isValid) {\n      return succeed(this);\n    }\n    const options: ILanguageTagInitOptions = {\n      iana: this._iana,\n      validity: 'valid',\n      normalization: this._normalization\n    };\n    return LanguageTag._createTransformed(this.subtags, this._validity, this._normalization, options);\n  }\n\n  /**\n   * Gets a confirmed strictly valid representation of this language tag.\n   * @returns `Success` with a strictly valid representation of this {@link Bcp47.LanguageTag | language tag},\n   * or `Failure` with details if the tag cannot be strictly validated.\n   */\n  public toStrictlyValid(): Result<LanguageTag> {\n    if (this.isStrictlyValid) {\n      return succeed(this);\n    }\n    const options: ILanguageTagInitOptions = {\n      iana: this._iana,\n      validity: 'strictly-valid',\n      normalization: this._normalization\n    };\n    return LanguageTag._createTransformed(this.subtags, this._validity, this._normalization, options);\n  }\n\n  /**\n   * Gets a confirmed canonical representation of this language tag.\n   * @returns `Success` with a canonical representation of this {@link Bcp47.LanguageTag | language tag},\n   * or `Failure` with details if the tag cannot be normalized to canonical form.\n   */\n  public toCanonical(): Result<LanguageTag> {\n    if (this.isCanonical) {\n      return succeed(this);\n    }\n    const options: ILanguageTagInitOptions = {\n      iana: this._iana,\n      validity: this._validity,\n      normalization: 'canonical'\n    };\n    return LanguageTag._createTransformed(this.subtags, this._validity, this._normalization, options);\n  }\n\n  /**\n   * Gets a confirmed preferred representation of this language tag.\n   * @returns `Success` with a preferred representation of this {@link Bcp47.LanguageTag | language tag},\n   * or `Failure` with details if the tag cannot be normalized to preferred form.\n   */\n  public toPreferred(): Result<LanguageTag> {\n    if (this.isPreferred) {\n      return succeed(this);\n    }\n    const options: ILanguageTagInitOptions = {\n      iana: this._iana,\n      validity: 'valid', // preferred requires validity\n      normalization: 'preferred'\n    };\n    return LanguageTag._createTransformed(this.subtags, this._validity, this._normalization, options);\n  }\n\n  /**\n   * Gets a string representation of this language tag.\n   * @returns A string representation of this language tag.\n   */\n  public toString(): string {\n    return this.tag;\n  }\n}\n"]}